How to monitor Citrix Director 7.x using eG Enterprise?

eG Enterprise monitors the Citrix Director in an agent-based manner. For this purpose, an eG agent should be deployed on the target Citrix Director. To enable this agent to communicate with the target director and pull out performance metrics, a set of pre-requisites should be fulfilled. These requirements have been explained in the following section.

Pre-requisites for monitoring the Citrix Director 7.x

Typically, to monitor Citrix Director, every test that the eG agent runs on Director should be configured with the credentials of a user with the following privileges:

  • The All scope and read-only privileges
  • The Allow log on locally security privilege

To assign the aforesaid privileges to a user, do the following:

  1. Login to the Citrix Studio console and select the Administrators node in the Configuration tree structure in the left panel of the console (see Figure 1).

    Citrix Studio Console page

    Figure 1 : Citrix Studio Console

  2. To assign the monitoring rights to a user, click on the Create Administrator option under the Administrators menu in the Actions panel of the console. This will open the Administrator and Scope page in the Create Administrator window (see Figure 2).

    Create Administrator window

    Figure 2 : The Create Administrator window

  3. In the Administrator and Scope page that opens, click on the Browse button. This will invoke Figure 3, using which you can select the user from the domain. Once you selected the user, click OK button in Figure 3.

    User selection from domain

    Figure 3 : Selecting the user from the domain

  4. This will lead you to the Administrator and Scope page as shown in Figure 4, where the chosen user will be displayed. Now, select All as the scope for the chosen user, and then click Next button in Figure 4 to proceed.

    Scope selection for selected user

    Figure 4 : Selecting the scope for the chosen user

  5. Then, the Role page of the Create Administrator window appears (see Figure 5 ). In this page, select the Read Only Administrator role for the chosen user.

    Role selection for selected user

    Figure 5 : Selecting the role for the chosen user

  6. Upon clicking the Next button in the Role page, the Summary page will appear, as shown in Figure 6. This will display the summary of your settings for the chosen user.

    Summary page

    Figure 6 : The Summary page

  7. Finally, click the Finish button.

  8. Next, proceed to assign the Allow log on locally security privilege for the same user. 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 (see Figure 7).

    Selection of Allow log on locally policy option

    Figure 7 : Setting the Allow log on locally policy to the user

  9. The eGurkhaAgent service should run using the Local system account.

Once the above-said requirements are set in place, manage the Citrix Director component using the eG administrative interface to proceed the Citrix Director monitoring. The steps for achieving this are briefed in the below section.

Managing the Citrix Director 7.x

The eG Enterprise cannot automatically discover the Citrix Director 7.x. This implies that you need to manually add the component for monitoring. Remember that the eG Enterprise automatically manages the components that are added manually. To manage a Citrix Director component, do the following:

  1. Log into the eG administrative interface.

  2. eG Enterprise cannot automatically discover Citrix Director 7.x. You need to manually add the server using the Add Component page (see Figure 8) that appears when the Infrastructure -> Components -> Add/Modify menu sequence is followed. Remember that components manually added are managed automatically.

    Figure 8 : Adding a Citrix Director 7.x

  3. Specify the Host IP and the Nick name of the Citrix Director 7.x in Figure 8. Then click the Add button to register the changes.

  4. Doing so will bring you back to the Add Component page, where you can see the Citrix Director component that you recently added.

    Figure 9 : Viewing the Citrix Director component that has been added

  5. Now, proceed to configure tests for the new component. For that, click on the icon corresponding to that component.

  6. In the page that appears next, select any of the tests displayed in the Unconfigured Tests list box, and click the Configure button beneath. For instance, say you select the Desktop OS Machines test for configuration. Figure 10 will then appear.

    Figure 10 : Configuring the Desktop OS Machines test

  7. To know how to configure this test, refer to the Desktop OS Machines Test section under Monitoring the Citrix Director 7.x .
  8. Configuring one test automatically configures all the other tests for the Citrix Director component.
  9. Once the tests are configured, sign out of the eG admin interface.