Agents Administration - Tests
 

Default Parameters for CtxXcXDDesktopsTest

To track the status of desktop OS machines in each delivery group configured in a site, use the CtxXcXDDesktopsTest test.

This page depicts the default parameters that need to be configured for the CtxXcXDDesktopsTest.

  • The TEST PERIOD list box helps the user to decide how often this test needs to be executed.

  • In the CONTROLLER IP ADDRESS text box, specify the IP address of the delivery controller (i.e., broker) in the site with which the eG agent should communicate for collecting performance metrics.

  • Specify the port number of the delivery controller (i.e., broker) in the site with which the eG agent should communicate for collecting performance metrics, in the CONTROLLER PORT text box.

  • To connect to a delivery controller and pull out metrics from it, the eG agent requires Farm Administrator rights. In order to configure the eG agent with Farm Administrator privileges, specify the credentials of the Farm Administrator in the USERNAME and PASSWORD text boxes. This user should also be assigned the Allow log on locally security privilege on the Citrix XA/XD Site 7.x host. The steps for assigning the Allow log on locally security privilege are as follows:

    • 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.

  • Confirm the PASSWORD by retyping it in the CONFIRM PASSWORD text box.

  • In the FULLY QUALIFIED DOMAIN NAME text box, specify the fully-qualified name of the domain to which the specified controller belongs.

  • Indicate whether/not the controller used for metrics collection is SSL-enabled. By default, the SSL flag is set to Yes.

  • By default, the SHOW TOTAL MACHINES DD flag is set to No. This indicates that, by default, the test will not report detailed metrics for the Total_machines measure. To enable the test to collect detailed metrics for the Total_machines measure, set this flag to Yes.

  • By default, the SHOW POWEREDOFF MACHINES DD flag is set to No. This indicates that, by default, the test will not report detailed metrics for the Powered_off_machines measure. To enable the test to collect detailed metrics for the Powered_off_machines measure, set this flag to Yes.

  • Once the necessary values have been provided, clicking on the UPDATE button will register the changes made.

When changing default configurations of tests, the values with “$” indicate variables that will be replaced by the eG system according to the specific server being managed - for instance, $hostName is the host/nickname of the target host, $port is the port number of the server being monitored. E.g., for a server xyz:80, $hostName will be changed automatically by the eG manager to “xyz” and $port will be changed to “80” when configuring a test.