Why do I receive, You have configured 1 executors (of which 0 are currently in use), above your licensed limit of 0 when adding an agent to a master

Article ID:204178350
1 minute readKnowledge base

Issue

  • When adding an agent to the controller, we get following license warning message:

"You have configured 1 executors (of which 0 are currently in use), above your licensed limit of 0. Please contact CloudBees Sales for a quote on additional executors."
  • Why is the agent on the controller considered to be an executor? We had configured the controller with 0 executors.

Resolution

If we check the licenses on the operations center and controller we see:

  • On operations center: CloudBees Jenkins Enterprise license with 40 executors, Operations center server license with sub-licensing for 3 client controllers

  • On the controller: Operations Center managed CloudBees Jenkins Enterprise license with 0 dedicated executors

If you would like to have dedicated executors then you need to change your license strategy. You can find all types in the link below:

If you have fixed dedicated executors, just select License (fixed dedicated executors).

Root Cause

If your license only have X executors, it means that you should only declare X executors in total on your agents. It is the same if you build, or not, in parallel. The important thing is the global number you have declared - even if you don’t use them.

Example:

"You have configured 42 executors (of which 0 are currently in use), above your licensed limit of 5. Please contact CloudBees Sales for a quote on additional executors."

According with the message you have declared 42, but you can only declare 5.

This article is part of our Knowledge Base and is provided for guidance-based purposes only. The solutions or workarounds described here are not officially supported by CloudBees and may not be applicable in all environments. Use at your own discretion, and test changes in a safe environment before applying them to production systems.