Connecting a client controller to operations center

3 minute read

Prerequisites

The following instructions assume you have completed the steps for Installing the operations center and Installing the client controller, and have an operations center and client controller instance accessible via a web browser at the following URLs:

  • Operations center: http://<server-name>:8888

  • Client controller: http://<server-name>:8080

Prior to beginning the following instructions, the operations center and client controller should be waiting to be unlocked with an initial admin password.

Setting up your new operations center

To set up your new operations center:

  1. Navigate to your new operations center.

    For example, http://<operations center name>:8888

  2. Copy the file location of the initial admin password on the Getting Started window.

  3. Enter the following command in your terminal:

    sudo cat + the file location you copied from step 2

  4. Copy the password value outputted from your terminal command.

  5. Paste the password value into the Administrator password box in the Getting Started window.

  6. Select Continue.

  7. Select Use a license key.

    If you have not yet purchased a CloudBees license, copy the Jenkins Instance ID and send it in an email to csm-help@cloudbees.com requesting a trial. Afterwards, a CloudBees Customer Success Manager (CSM) will create a license key and certificate for you to apply. The expected return is within 24 hours.
  8. Copy and paste the operations center License Key and Certificate into the respective boxes in the Enter your license key window.

    You must include the -----BEGIN RSA PRIVATE KEY----- and -----END RSA PRIVATE KEY----- sections.
    You must include the -----BEGIN CERTIFICATE----- and -----END CERTIFICATE----- sections.
  9. Check the box next to I accept the evaluation or standard license.

  10. Select Submit.

  11. Select Install suggested plugins.

    You must install the suggested plugins. Do NOT choose Select plugins to install.
  12. Enter details for Create First Admin User.

  13. Select Save and Continue.

  14. Examine the Instance Configuration and if it looks right, select Save and Finish.

  15. Select Start using CloudBees CI Operations Center.

  16. Restart the CloudBees CI client controller. Example URL: http://<Operations Center name>:8888/restart

  17. Select Yes.

  18. Sign in using the Admin Credentials you entered.

Creating a Folder item to organize your client controllers

It is considered a best practice to organize your client controllers in a Folder item because it helps align your controllers with teams or organizations and it can keep the operations center screen from becoming too crowded, requiring a lot of unnecessary scrolling.

To create a Folder item to hold your client controller objects:
  1. Select New Item.

  2. Select Folder and name the folder.

    This folder will be used to organize all of the client controller objects connected to your operations center.
  3. Select OK.

  4. Select the Restrict the kind of children in this folder checkbox under Properties.

  5. Select the Client controller checkbox.

  6. Select Save.

Creating a Folder to hold your client controller objects is not a requirement, but CloudBees highly recommends it as a best practice.

Creating a new client controller object

To create a client controller:
  1. From the Folder you created to hold your client controller objects, select New Client controller.

  2. Enter a name for your client controller.

  3. Select Client controller.

  4. Select OK.

  5. Select Save.

Setting up your new client controller

To set up your new client controller:
  1. Navigate to your new client controller in a new tab or window. For example, http://<server-name>.local:8080/

  2. Copy the file location of the initial admin password on the Getting Started window.

  3. Open a terminal and enter the following command:

    sudo cat + the file location you copied from step 2.

  4. Copy the password value outputted from your terminal command.

  5. Paste the password value into the Administrator password box in the Getting Started window.

  6. Select Continue.

  7. Select Join a CloudBees Jenkins operations center controller.

  8. Navigate to your CloudBees CI operations center dashboard and select the client controller you recently created and want to connect.

  9. Copy the Connection Details.

    You must include the ----- BEGIN CONNECTION DETAILS ----- and ----- END CONNECTION DETAILS ----- sections.
  10. Paste the Connection Details into the Connection details box in the Joining a CloudBees Jenkins operations center is easy window.

  11. Select Submit.

  12. Select Install suggested plugins.

    You must install the suggested plugins. Do NOT choose Select plugins to install.
  13. Enter details for Create First Admin User.

  14. Select Save and Continue.

  15. Select Start using CloudBees CI client controller.

  16. Restart the CloudBees CI client controller. Example URL: http://<server-name>.local:8080/restart

  17. Select Yes.

  18. Sign in using the Admin credentials you entered.

To verify, return to the browser tab or window of your operations center. You should see your new controller under the folder name that was previously created. If you select the name of the client controller, you should be redirected to the console of that client controller. From one console you can now navigate between your operations center and client controller.