Configuring the agent on Windows systems

Edit online

You can configure the Citrix VDI agent on Windows operating systems by using the IBM® Cloud Application Performance Management window. After you update the configuration values, you must start the agent to save the updated values.

Procedure

  1. Click Start > All Programs > IBM Monitoring agents > IBM Cloud Application Performance Management.
  2. In the IBM Performance Management window, right-click the Monitoring Agent for Citrix Virtual Desktop Infrastructure template, and then click Configure agent.
    Remember: After you configure an agent instance for the first time, the Configure agent option is disabled. To configure the agent instance again, right-click on it and then click Reconfigure.
  3. Enter a unique instance name then click OK. Use only letters, Arabic numerals, the underline character, and the minus character in the instance name. Example, vdi_inst2.
    Figure 1. The window to enter a unique instance name.
    The window for entering a unique instance name.
  4. Click Next on the agent instance name window.
    Figure 2. The agent instance name window.
    The agent instance name window.
  5. Enter the XenApp and XenDesktop Site Configuration instance template settings.
    Note: This section is not the XenApp or XenDesktop site instance configuration. It is a template section for setting what is used as the default values when you add the actual XenApp or XenDesktop site instance configurations in step 6.
    See Table 1 for an explanation of each of the configuration parameters.
    Figure 3. The window to specify XenApp or XenDesktop site instance template settings.
    The window to specify XenApp or XenDesktop site instance template settings.
  6. Press New and enter XenApp or XenDesktop site instance settings, then click Next.
    See Table 1 for an explanation of each of the configuration parameters.
    Figure 4. The window to specify XenApp or XenDesktop site instance settings.
    The window to specify XenApp or XenDesktop site instance settings.
    Note: The PowerShell User name parameter and all following PowerShell parameters are only needed when Enabling monitoring of Windows events and PowerShell metrics. These advanced environment variables are off by default because of the significant load they put on the monitored system.
    Note: Ensure the SSL Config and PowerShell Authentication Mechanism parameters are set correctly for each new XenApp or XenDesktop site instance. A defect causes the default values to be set instead of the template values.
  7. Click OK to complete the configuration.
  8. In the IBM Cloud Application Performance Management window, right-click the instance that you configured, and then click Start.