Licensing and Expiration Banner Troubleshooting

Issue

  • Why does my master connected to my operations center expire today?
  • Why am I getting an expiration warning on my master when the operations center is valid?
  • Master license provisioned by JOC erroneously expires and shows “Your license expires in 0 days."
  • CJOC reads “You have configured X amount of executors (of which X are currently in use), above your licensed limit of 0. Please contact CloudBees Sales for a quote on additional executors.”

If your client master will not connect to CJOC after my license was successfully activated, please see CJOC connection issues

Environment

  • CloudBees Operations Center
  • CloudBees Jenkins Enterprise
  • Operations Center Server Plugins < 1.8.3
  • License Management

Diagnostic

  • Check the validity of your license by navigating to “Manage Jenkins” => “Manage Licenses” and scrolling down to the bottom of the page. Click “Check validity.” If you receive an error, please submit a support request with the error and a support bundle attached.

Confirm the licensing strategy.

  • Click the upside down toggle arrow next to the master and then click “Configure.” Scroll to the “Licensing” section.

license1

  • Note: If you are currently on CJP 2.X, the licensing strategy has been simplified. There are two options. “Test Instance” or “Regular Instance”

license4

  • Note: If you are currently on CJP 1.X, see how to configure your licensing strategy here. See the diagram below for the licensing strategy options in CJP 1.X

license5

Check Manage Jenkins -> Configure System to see if there are any executors set here.

license2.png

Check the “Configure” section on the client master for the On-master executors section.

license3.png

CM license does not get renew by OC - CJP-5963.

We need to check if you are suffering CJP-5963 : if not saving the Client Master config before pushing the connection details the license is not pushed.

To confirm you are suffering this bug, you just need to check on the connection logs on Operations Center that you are getting the license lines right after initiating a connection - notice the line with Checking license validity.... If you are not getting this log when connecting your OC with the CM, then it means you are suffering this bug.

[Mon Jun 19 09:39:49 UTC 2017] Incoming connection request from https://master-1.unicorn.beescloud.com/ on ip-10-0-0-28.ec2.internal/10.0.0.28:47910 with identity 32:42:81:46:85:42:75:8b:77:41:55:16:88:95:d1:52
[Mon Jun 19 09:39:49 UTC 2017] Previously approved identity: 32:42:81:46:85:42:75:8b:77:41:55:16:88:95:d1:52
[Mon Jun 19 09:39:49 UTC 2017] Accepting connection from https://master-1.unicorn.beescloud.com/ on ip-10-0-0-28.ec2.internal/10.0.0.28:47910 with identity 32:42:81:46:85:42:75:8b:77:41:55:16:88:95:d1:52 (CONFIRMED)
[Mon Jun 19 09:39:49 UTC 2017] Checking license validity...
[Mon Jun 19 09:39:49 UTC 2017]   License will expire in 1 day 0 hr (not before next check)
[Mon Jun 19 09:39:49 UTC 2017]   Current license is for 0 dedicated executors.
[Mon Jun 19 09:39:49 UTC 2017] Current license is valid
[Mon Jun 19 09:39:50 UTC 2017] Connected
ClientMaster{fullName=master-1.unicorn.beescloud.com,uid=8d79094e-657e-4404-a3c1-f9fa8a2a3287,state=Approved}

This bug happens because the CM descriptor was not saved when the CM item was created in Operations Center. To workaround this problem you just need to go to the CM item in Operations Center, then go to the Configure section and actually hit the button save. Once you save the configuration, the information will be persisted on disk and the license will be renewed.

oc-troubleshooting-license-cjp-5963.png.png

Resolution

A client master connected to an Operations Center will always show an expiration of the current date or the following day. This is expected behavior. The CloudBees Jenkins Operations Center polls the client master every hour to see if the license expires in the next 2 hours. If so, the Operations Center renews the client master’s license for another 16 hours.

  • CJOC needs to refresh the licensing details for the sub-licensed client master.

Always backup your instance before making any changes!

  • Upgrade Operations Center Server Plugins < 1.8.3.
  • The Operations Center Server Plugin v1.8.3 changes the window of time during which this expiration banner may occur- plugin release notes
  • Restart CJOC.
  • The Jenkins core version on your master is outdated. Upgrade to the most recent LTS and restart the client master. See this link on how to upgrade.

  • Plugin versions are incompatible and need to be updated. Search for installed plugins with the text “operations” on the client master and restart.

  • The license has expired and you need to contact sales@cloudbees.com to renewal your subscription.

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.