Agent-based Licensing

License Errors

License error notifications display in the Controller next to Settingsthe gear icon. This table below lists possible error messages and their causes.

Error MessageCause
<Agent type String> agent on host "<host name>" is not authorized to report to application "<application name>". Reason: Missing access key.

or

Agent license request denied. Agent type: <agent type string>; Node: <node name>; Tier: <Tier name>; Application: <application name>; Host: <hostId>; Reason: Missing access key.

Access key is missing from the agent request. For example, if the Controller returns a 401 error during authentication, the agent drops the authorization header and causes this error.

Note: Node (tier) names are only provided for app agents.
Agent license request denied. Agent type <agent type string>; Node: <node name>; Tier: <Tier name>; Application: <application name>; Host : <hostId>; Reason: Access Key used is not account access key. Access key provided is not the account access key for the Database Agent.
Agent license request denied. Agent type: <agent type string>; Node: <node name>; Tier: <Tier name>; Application: <application name>; Host : <hostId>; Reason: Invalid access key.

or

<Agent type String> agent on host "<host name>" is not authorized to report to application "<application name>". Reason: Invalid access key.

The license rule that was retrieved for a specific access key provided by the agent, is incorrect. This error may also occur when there is a misconfiguration. For example, the access key was updated directly in database but the caches did not include that update, then an access key mismatch will occur.

Note: Node (tier) names are only provided for app agents.
Agent license request denied. Agent type <agent type string>; Node: <node name>; Tier: <Tier name>; Application: <application name>; Host : <hostId>; License Rule: <license rule name> ; Reason: No license available.

No licenses are available during agent registration.

Note: Node (tier) names are only provided for app agents.
<Agent type String> agent on host "<host name>" is not authorized to report to application "<application name>". The host or application is not included in the scope of license rule "<license rule name>".

or

<Agent type String> agent on host "<host name>" is not authorized to this Controller.The host or application is not included in the server scope of license rule "<license rule name>". 		Agent is configured with an access key that is restricted to particular hosts or applications.

Troubleshoot Licenses

If a licensed agent cannot register with the Controller:

  1. Check that the user account has a product license for the relevant agent type.
  2. If the user account has license rules defined, verify that the rules have the correct number of license units allocated. See Machine/Cluster Agent Prioritization. To change the number of allocated units in a rule:
    1. Click Settings Settings > License > Rules.
    2. Open a rule and click Edit.
    3. Under License Allocation, change the number of licenses and apply the change.