License Details Test

Licensing errors in a XenApp/XenDesktop environment can cause major outages or degraded service for customers. To avoid such adversities, administrators should be able to proactively identify when license problems affect your site or are about to impact user connections. This is where the License Details test helps. This test scans the application event log of the delivery controller for specific critical, error, warning, and information events pertaining to license usage, and reports the count of events captured recently. The detailed diagnosis of this test reveals the messages so captured, so as to aid troubleshooting.

Target of the test : A Citrix Delivery Controller 7.x

Agent deploying the test : An internal agent

Outputs of the test : One set of results for the Delivery Controller being monitored.

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.

Host

The host for which this test is to be configured.

Port

Refers to the port at which the specified DDC listens to.

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise suite embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

  • The eG manager license should allow the detailed diagnosis capability
  • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Delivery controller license warning

Indicates the count of warning events with the event ID 1154 that were captured in the event log during the last measurement period.

Number

Events with the ID 1154 occur only when the controller enters the licensing grace period. Use the detailed diagnosis of this measure to know when the grace period will expire - i.e., to know how much time is left before the controller stops providing desktop sessions.

Broker service license critical events

Indicates the count of critical events with the event ID 1151, 1155, 1157, and 1159, which were captured in the event log during the last measurement period.

Number

Typically, events with the ID 1151, 1155, 1157, and 1159 are triggered, if the following problems are noticed:

  • The Citrix Broker Service is not able to contact the license server:
  • The Citrix Broker Service stops providing desktop sessions, because the controller is no longer in or could not enter a licensing grace period;
  • The version of the license server is older than the version of the Citrix Broker Service;
  • The Citrix Broker Service denies a desktop connection because the maximum number of licenses for the site has exceeded

Use the detailed diagnosis of this measure to know which events occurred recently and how to resolve them.

Broker service license information events

Indicates the number of events with event ID 1150 and 1156, which were captured during the last measurement period.

Number

Typically, events with the ID 1150 and 1156 are triggered, if the following are noticed:

  • The Citrix Broker Service successfully contacted the license server;
  • The controller is no longer in the licensing grace period, as the license has been acquired. The Citrix Broker Service is successfully communicating with the license server after license acquisition.

Use the detailed diagnosis of this measure for more details about these events.

Broker service license warning

Indicates the number of events with the event ID 1153, 1158, and 1160, which were captured in the last measurement period.

Number

Typically, events with the ID 1153, 1158, and 1160 are triggered, if the following problems are noticed:

  • The XenDesktop site's license expired:
  • The Citrix Broker Service detected that you have exceeded the number of licenses available for this site on the license server for this edition. The license server granted you an overdraft license;
  • The Citrix Broker service encountered an internal error while managing licenses.

Use the detailed diagnosis of this measure to know which events occurred recently and to troubleshoot them effectively.

Site license error

Indicates the number of events with event ID 1152, that were captured during the last measurement period.

Number

Events with ID 1152 occur if the XenDesktop site being monitored does not have the required licenses present on the license server.

Use the detailed diagnosis of this measure to know more details about these events. Typically, when such events occur, you may want to use the License Administration Console to add the relevant licenses to the license server and proceed.