How do I reconnect a master to Operations Center after changing Operations Center URL?

Issue

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

Environment

Resolution

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

Pre-Requisite

  • If the Client Master is using Operations Center SSO, the disconnection will cause the Client Master 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 Master. Otherwise, add the required certificate(s) to the Client Master’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 Master > Manage page and Disconnect and Release the Client Master
  2. [CJOC] Connect the Client Master (by either pushing connection details OR copy / pasting the connection details as documented in Setting up your new Client Master)

If Client Master 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 Master after disconnecting it, follow this approach:

  1. [CJOC] Go to the Client Master > Manage page and Disconnect and Release the Client Master
  2. [Master] Stop the Client Master
  3. [Master] In the Client Master 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 Master by editing $JENKINS_HOME/config.xml. Locate this line: <useSecurity>true</useSecurity> and changing it to <useSecurity>false</useSecurity>
  9. [Master] Start the Client Master
  10. [CJOC] Connect the Client Master (by either pushing connection details OR copy / pasting the connection details as documented in Setting up your new Client Master)

References

Have more questions?

0 Comments

Article is closed for comments.