Citrix License Test

The Citrix server supports two types of licenses- a product license and a connection license. The product license is a license to run a particular kind of Citrix product on a server. A server farm must have a product license with one license count to run Citrix server software on each server in the server farm. The Citrix Virtual Apps servers allocates product licenses from a pool of available licenses for a Virtual Apps server farm.

A connection license is a license for client connections to Citrix servers. A server farm must have a connection license with one license count for each concurrent client connection to the Citrix servers in the farm.

This test reports the usage of both the connection and product licenses by the Citrix server.

This test is disabled by default. To enable the test, go to the enable / disable tests page using the menu sequence : Agents -> Tests -> Enable/Disable, pick the desired Component type, set Performance as the Test type, choose the test from the disabled tests list, and click on the < button to move the test to the ENABLED TESTS list. Finally, click the Update button.

Target of the test : Any Citrix server

Agent deploying the test : An internal agent

Outputs of the test : One set of results for every server being monitored

Configurable parameters for the test
  1. TEST PERIOD – How often should the test be executed
  2. Host – The host for which the test is to be configured
  3. Port – Refers to the port used by the Citrix server
  4. rereadlicense – If this flag is set to Yes, then the eG agent will check for changes in license status everytime the test runs. If this flag is set to No, then the eG agent will not check for license changes.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Pool licenses in use:

All the Citrix servers in a server farm typically share a pool of licenses. This measure reports the number of licenses from the pool used by the current server.

Number

 

Assigned licenses:

Citrix allows a number of licenses from the pool to be assigned to a specific server. No other server can re-use these assigned licenses. This measure reports the number of licenses that are assigned to the current server.

Number

 

Assigned licenses in use:

This reports the number of assigned licenses in use.

Number

If the number of assigned licenses in use is much lower than the allocated number of assigned licenses, the administrator may want to reduce the number of assigned licenses for this server.

Usage of assigned licenses:

This reports the % of assigned licenses in use.

Percent

Administrators may choose to be alerted when the assigned license usage reaches close to 100%, so that they may increase the number of assigned licenses if desired.