Tuesday 27 November 2007

Error: EdgeSight has detected a problem with the Licensing configuration.

Symptoms

The following message is displayed on the top of the EdgeSight Server Console:

"EdgeSight has detected a problem with the Licensing configuration. Click here for more information."

When you click the link in the error message, the Current Licensing Status is reported as In Violation. Refer to the following screen shot:

-And-

The EdgeSight server sends the following operational email:

"The EdgeSight for Presentation Server license status is EdgeSightAgentForPresentationServer, and this device (10.20.6.6) has additional violations in the payload. The payload will be deleted. Reflectent.Core.Loader HandleLicenseExceeded"

Background

The SYS_EVENT_TXT.txt agent log file is critical in determining the exact cause of the license violations. Investigating this file may help isolate the specific cause.

Cause 1

The EdgeSight License file may not be in place or is not recognized. The following message in the SYS_EVENT_TXT.txt file may indicate this is the problem:

2007-06-19 15:55:22 Ctrx Licensing No suitable licenses are present on the license server CTX-LIC-SERV:27000

Resolution 1

1. Install the EdgeSight license file on the license server.

2. If the license file has been installed on the license server but is still not recognized, try to "re-host” the license file by using your MyCitrix account to check the license back in and then re-creating the license file.

3. Double-check the name of the EdgeSight server name for case sensitivity while re-creating the license file.

Cause 2

The EdgeSight product requires version 4.5 of the Citrix license server or later. If you have an earlier version of the license server in place you may see the following messages in the SYS_EVENT_TXT.txt agent log file:

2007-08-12 21:20:04 Ctrx Alerts Saved immediate operational alert. Alert text is: Your version of the license server on CTX-LIC-SERV is older than the version of the Citrix EdgeSight for Presentation Server agent. Please upgrade your license server or specify a license server location
2007-08-12 21:20:04 Ctrx Licensing Detected incompatible license server CTX-LIC-SERV:27000

Resolution 2

Upgrade the Presentation Server production license server to version 4.5 and install the EdgeSight license file on it. By default, the EdgeSight for Presentation Server agents use the same license server that the server running Presentation Server uses.

Cause 3

A 4.5 license server has been installed to service just the EdgeSight agents but is not being used by the agents. There is a problem in the base EdgeSight 4.5 product (no service packs applied) that may prevent a new license server configuration from being deployed correctly to all agents.

Messages in the SYS_EVENT_TXT.txt file similar to the ones listed above may indicate that the agent is still trying to contact the wrong license server.

Resolution 3

1. If the production license server cannot be upgraded, install a 4.5 license server on the EdgeSight Server.

2. Create a custom Agent Configuration containing the settings (name, port, and so on) for this new license server.

3. If you are running the EdgeSight 4.5 Service Pack 1 software, navigate to Company Settings > Server > Device Management > Departments and assign the new Agent Configuration to all the departments containing servers running Presentation Server.

4. Complete the following procedure if you are running the base EdgeSight 4.5 software (no service packs applied):

Important: If you are running the base EdgeSight 4.5 server software, you must perform additional steps to force the agents to recognize the new license server. If the custom Agent Configuration is in place before an agent reports up to the server for the first time, it is not picked up properly.

For new installations:

1. Deploy all of the agents and let them all report up to the server once.
2. Navigate to Company Settings > Server > Device Management > Departments and assign the new custom Agent Configuration to the departments containing the servers running Presentation Server.

For existing installations with all agents currently deployed:

1. Navigate to Company Settings > Server > Device Management > Departments and identify the Agent Configuration assigned to the departments containing the servers running Presentation Server.
2. Navigate to Company Settings > Agent > Agent Configurations.
3. Select to edit the configuration from the drop-down menu.
4. Do not make any changes; simply click the finish button. This causes the agents to detect a change to this configuration (even though none was made), allowing it to be downloaded and applied correctly.

For existing installations with some new agents still being deployed:

After each (or a group of) new agent reports up to the server, you MUST complete the following procedure on the EdgeSight Server:

1. Identify the department that this new device belongs to.
2. Identify the agent configuration assigned to this department.
3. Navigate to the Company Settings > Agent > Agent Configurations page.
4. Select to edit the configuration from the drop-down menu.
5. Do not make any changes; simply click the finish button. This causes the agents to detect a change to this configuration (even though none was made), allowing it to be downloaded and applied correctly.

After completing this procedure, the new configuration changes should propagate to all the agents within about 24 hours. The agents can also be forced to use the new configuration by running the remote configuration worker using the Company Settings > Agent > Workers > Run Remotely page. Some license violation messages may occur until the configuration fully propagates to all agents.

Cause 4

There are no more available licenses.

Resolution 4

Using the License Management Console, check the license usage over time to determine the license utilization. If all licenses are in use on a regular basis and violations are still occurring, this means you are regularly exceeding your limit.

To resolve this issue, either acquire more EdgeSight licenses or remove the EdgeSight Agent from enough servers running Presentation Server to use fewer licenses than the license limit.

No comments: