KBEC-00211 - Agents and consuming licensed resources

Article ID:360033192571
1 minute readKnowledge base
On this page

Summary

CloudBees CD (CloudBees Flow) uses an enabled host licensing scheme. How can I determine who is using a host license?

Solution

The agent running on the Server does not count against the agent license limit, as long as the Resource addresses it by the name "localhost".

If, for some reason, you create multiple Resources that all point to the same agent, this scenario only counts as one agent use, as long as the strings that defines the hostname are all exactly the same.

As of v.4.2.0, a remote Webserver and a remote Repository server both require a local agent. Each of those need to be a fully configured resource and can use a host license if a job is run on it.

Current license usage statistics are available from:

  • The command "ectool getLicenseUsage", note the "concurrentResources" usage section

  • Under the GUI tab "Cloud" (formally "Resource") the subtab "Resource" summarizes the current usage statistics

Examples

  1. ElectricSentry, by default, runs on the local agent and therefore does not count against the agent license count.

  2. The Report Generator, by default, runs on the local agent and does not count against the agent license count.

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.