Renaming Managed controller in CloudBees CI

Article ID:360047665391
1 minute readKnowledge base

Issue

How do I rename a Managed controller in CloudBees CI. I have tried to rename a managed controller but the domain is still indicating the old name.

Environment

Resolution

There is currently no support in CloudBees CI for renaming managed controllers. While the Domain and Display Name can be changed under JENKINS_URL/cjoc/job/CONTROLLER_NAME/configure they do not result in the renaming of the managed controller.

  • Setting the Display Name only changes the name of the controller in the UI. The domain will still point to the old path.

  • Changing the Domain points the persistent volume of the controller to one with the new name. If a persistent volume with the new name does not exist, a new volume is created. This has the same effect as provisioning a new controller.

  • If you mistakenly change the domain and lost the configuration, reverting back to the old name will point the controller back to the old Persistent Volume and restore the configuration.

Workaround

The current workaround is to create a new controller and restore it using a backup from the existing controller.

  1. Backup current controller following Backup and restore

  2. Create a new controller.

  3. Restore the newly created controller from the backup taken from the old controller, following Backup and restore