How to Reconnect a Client-Master Stuck on Registration

Issue

  • Client master attached to JOC but not able to obtain license, being stuck on registration screen
  • Following error occurs when trying to to enter connection details in CJE
    • Error “CloudBees Operations Center not configure to issue a license”
    • Error “Oops something went wrong”
    • Error “Invalid license”
    • Error “Invalid certificate”
    • Error “Failed to read the existing licenseERROR: Subscription has expired”

Environment

  • CloudBees Jenkins Enterprise
  • CloudBees Jenkins Operations Center

Related Issue(s)

Resolution

This s not a standard procedure and should be carried out as a last resort to connect a client master to CJOC!

You need to purge the CJOC configuration attached to your CJE instance and recreate the client master from scratch following these steps:

  1. Release and Delete client-master from CJOC

  2. Stop CJE instance

  3. Delete the following files for CJE (client master) to entirely remove the link to CJOC:

    • $JENKINS_HOME/license.xml
    • $JENKINS_HOME/operations-center-cloud*
    • $JENKINS_HOME/operations-center-client*
    • $JENKINS_HOME/com.cloudbees.opscenter.client.plugin.OperationsCenterRootAction.xml
  4. Disable Security in CJE by editing the config.xml file in the JENKINS_HOME folder.

    Locate this line:

    <useSecurity>true</useSecurity>

    And changing it to

    <useSecurity>false</useSecurity>

  5. Start the CJE instance

  6. From CJOC, create a new client master

  7. Configure the Licensing strategy that you want to use (Test License in this example)

  8. Connect the client master either by push configuration from CJOC or manually from CJE

  9. At this stage, if the connection does not work and you are still stuck on the registration screen, you need to ask support for an evaluation license to get past the registration screen.

  10. The client master may need to be restarted to complete license registration.

Operations center might be keeping values in cache that prevent provisioning of a new master. If this procedure did not get you past the registration screen, you may have to restart CJOC. Re-do the procedure, stop CJOC in step 2. and start CJOC in step 6.

Have more questions? Submit a request

1 Comments

  • 0
    Avatar
    Julien Carsique

    Step 4: there seems to be no "Licensing strategy" for Jenkins ver. 1.625.18.1 (CloudBees Jenkins Operations Center 1.8), does it?

    EDIT: after resolution of the current issue (Client-Master Stuck on Registration), that field came back.

    Edited by Julien Carsique
Please sign in to leave a comment.