How to monitor the Citrix XA/XD Site 7.x using eG Enterprise?

eG Enterprise monitors the Citrix XA/XD Site in an agent-based manner. For this purpose, an eG agent should be deployed on any broker in the site. This agent then leverages the Citrix ODATA API and runs Citrix Powershell SDK commands on the broker to report on site composition and to monitor the connectivity between the monitored broker and key site components such as the license server, database server, hypervisors, etc. In the process, breaks in connectivity between the broker and a hypervisor and unavailability of the license server/database server can be promptly detected. In addition, delivery groups managed by all the brokers in the site are monitored, and state of server/desktop OS machines in each group is reported, so that powered-off/unavailable machines can be isolated. Before you start site monitoring, you need to set certain pre-requisites to enable the eG agent to use Citrix ODATA API and run Citrix Powershell SDK commands. These requirements have been explained in the following section.

Pre-requisites for monitoring the Citrix XA/XD Site 7.x

Typically, to enable the eG agent to pull out the status metrics from the Site and report anomalies, the following pre-requisites should be fulfilled:

  1. The Domain, Username, and Password parameters of every test that the eG agent executes for the Citrix XA/XD Site 7.x component should be configured with the domain name and credentials (as the case may be) of a user with Farm Administrator rights.
  2. The user should also be assigned the Allow log on locally security privilege on the Citrix XA/XD Site 7.x host. To achieve this do the following;

    • Go to the Control Panel in the host.
    • From the list of control panel items, click the Administrative Tools to view the set of tools available for system administrators and advanced users.
    • Upon selecting the Local Security Policy tool in the Administrative Tools location, the Local Security Policy settings console will appear.
    • Next, navigate to the User Rights Assignment node in the Local Policies tree in the left panel of the settings console. This will display the security policies corresponding to the user rights in the right panel.
    • Now, select the Allow log on locally policy to assign the security privilege to the user.
  3. The eGurkhaAgent service should run using the Local System account.

Once the above-said requirements are set in place, add the Citrix XA/XD Site 7.x component using the eG administrative interface to proceed the site monitoring. The steps for achieving this are briefed in the below section.

Managing the Citrix XA/XD Site 7.x

  1. Log into the eG administrative interface.
  2. eG Enterprise cannot automatically discover Citrix XA/XD site 7.x. You need to manually add the server using the COMPONENTS page (see Figure 1) that appears when the Infrastructure -> Components -> Add/Modify menu sequence is followed. Remember that components manually added are managed automatically.

    Figure 1 : Adding a Citrix XA/XD site server

  3. Specify the Host IP and the Nick name of the Citrix XA/XD site 7.x in Figure 1. Then click the Add button to register the changes.
  4. When you attempt to sign out, a list of unconfigured tests will appear as shown in Figure 2.

    Figure 2 : List of Unconfigured tests to be configured for the Citrix XA/XD site server

  5. Click on the Desktop OS machines test to configure it. To know how to configure the test, click here.
  6. Once all the tests are configured, signout of the eG administrative interface.