What is a CloudBees Jenkins Enterprise Instance ID and How do I find it?

Issue

  • What is my instance id
  • How do I find my instance id
  • How do I register my CloudBees Jenkins Enterprise 

Environment

  • CloudBees Jenkins Enterprise
  • CloudBees Jenkins Operations Center

Resolution

Instance IDs are required to generate evaluation and paid licenses for CloudBees Jenkins Enterprise and CloudBees Jenkins Operations Center.

Here are the instructions for fetching an instance ID from a Jenkins master in the following scenarios:

Scenario 1 - a fresh installation (CJE or CJOC)

  1. Go to your master’s UI:
  • For CloudBees Jenkins Enterprise, the default location is localhost:8080
  • For CloudBees Jenkins Operations Center, the default is localhost:8888 

Since this is a fresh installation, you’ll see the following registration screen:

register.png

  1. Click on the “Use a license ey” option (as shown above). The top-most field will contain your master’s instance ID. Copy this value, and paste it into your onboarding case. 

Please also include information as to what kind of master this instance ID will be (CloudBees Jenkins Enterprise or CloudBees Jenkins Operations Center), and how many executors that master should be licensed for.

Scenario 2 - upgrading from Jenkins (CloudBees Jenkins Enterprise only)

It’s best practice to upgrade your Jenkins core to the last LTS branch CloudBees Jenkins Enterprise distribution is available for. (Note that you should not upgrade to the last LTS OSS version, but the last LTS matching CloudBees Jenkins Enterprise branch). Failure to do so can result in your instance becoming unresponsive due to missing core dependencies for the Enterprise plugins.

  1. Install the “Enterprise by CloudBees” plugin from the OSS update center by clicking on the “Manage Jenkins” link in the lefthand menu, then clicking the “Manage Plugins” link. The “Enterprise by CloudBees” plugin can be found under the “Available” tab:

ScreenShot2014-07-15at11.23.28AM.png

This plugin will install all of the CloudBees Enterprise plugins, which will convert an Jenkins master into a CloudBees Jenkins Enterprise master.

  1. As with the first scenario, you’ll now need to go to your master’s web UI:
  • For CloudBees Jenkins Enterprise, the default location is localhost:8080
  • For CloudBees Jenkins Operations Center, the default is localhost:8888 

Since this is a fresh installation, you’ll see the following registration screen:

register.png

  1. Click on the “Use a license key” option (as shown above). The top-most field will contain your master’s instance ID. Copy this value, and paste it into your onboarding case. 

Please also include information about how many executors that master should be licensed for so that the Solutions Architect can license your instance accordingly.

Scenario 3 - You’re renewing your license

If you’re an existing customer you’re likely here to simply provide us with an instance id for your renewal!

Simply got to http://$JENKINS\_URL/license to find your instance id.

 

 

 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.