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
- CloudBees CI (CloudBees Core)
- CloudBees CI (CloudBees Core) on modern cloud platforms - Managed Master
- CloudBees CI (CloudBees Core) on modern cloud platforms - Operations Center
- CloudBees CI (CloudBees Core) on traditional platforms - Client Master
- CloudBees CI (CloudBees Core) on traditional platforms - Operations Center
- CloudBees Jenkins Platform - Client Master
- CloudBees Jenkins Platform - Operations Center
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
tohttps
, 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:
- [CJOC] Go to the Client Master > Manage page and Disconnect and Release the Client Master
- [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:
- [CJOC] Go to the Client Master > Manage page and Disconnect and Release the Client Master
- [Master] Stop the Client Master
- [Master] In the Client Master file system, delete:
$JENKINS_HOME/license.xml
$JENKINS_HOME/operations-center-cloud*
$JENKINS_HOME/operations-center-client*
$JENKINS_HOME/com.cloudbees.opscenter.client.plugin.OperationsCenterRootAction.xml
- [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>
- [Master] Start the Client Master
- [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)
0 Comments