Issue

• We changed the Operations Center URL (for example after setting up HTTPS) and now Client controllers are disconnected
• We changed the Operations Center URL (for example after setting up HTTPS) and now Client controllers log in link takes me to the old URL.

Environment

• CloudBees CI (CloudBees Core)
• CloudBees CI (CloudBees Core) on modern cloud platforms - Managed controller
• CloudBees CI (CloudBees Core) on modern cloud platforms - Operations Center
• CloudBees CI (CloudBees Core) on traditional platforms - Client controller
• CloudBees CI (CloudBees Core) on traditional platforms - Operations Center
• CloudBees Jenkins Platform - Client controller
• CloudBees Jenkins Platform - Operations Center

Resolution

The recommended approach is to release and reconnect the Client controller.

Pre-Requisite

• If the Client controller is using Operations Center SSO, the disconnection will cause the Client controller to switch to the fallback Security Realm that should allow users to still be able to login. Please review Single sign-on fallback behavior to ensure that this is set up properly. Otherwise, the master will not be accessible when disconnected and in that case security would need to be disabled temporarily (see How do I login to Jenkins when I locked myself out?) to reconnect the master.
• If the Operations Center URL was changed from http to https, make sure that the Operations Center certificate is trusted by the Client controller. Otherwise, add the required certificate(s) to the Client controller’s truststore, see How to install a new SSL certificate on Traditional Platforms?

From the UI

This is the recommended approach:

1. [CJOC] Go to the Client controller > Manage page and Disconnect and Release the Client controller
2. [CJOC] Connect the Client controller (by either pushing connection details OR copy / pasting the connection details as documented in Setting up your new Client controller)

If Client controller is not accessible from the UI

In case you do not have access to the UI or if you cannot log in to the Client controller after disconnecting it, follow this approach:

1. [CJOC] Go to the Client controller > Manage page and Disconnect and Release the Client controller
2. [Master] Stop the Client controller
3. [Master] In the Client controller file system, delete:
4. $JENKINS_HOME/license.xml
5. $JENKINS_HOME/operations-center-cloud*
6. $JENKINS_HOME/operations-center-client*
7. $JENKINS_HOME/com.cloudbees.opscenter.client.plugin.OperationsCenterRootAction.xml
8. [Master] Disable security in the Client controller by editing $JENKINS_HOME/config.xml. Locate this line: <useSecurity>true</useSecurity> and changing it to <useSecurity>false</useSecurity>
9. [Master] Start the Client controller
10. [CJOC] Connect the Client controller (by either pushing connection details OR copy / pasting the connection details as documented in Setting up your new Client controller)

References

• How to reconnect a Client-Master Stuck on Registration?
• How do I connect a Client controller to a different Operations Center?
• Connecting a Client controller to Operations Center
• Managing Client controllers
• Centrally managing security for masters