Desktop OS Machines Test
XenDesktop supports two types of Delivery Agents: one for Windows Server OS machines and one for Windows Desktop OS machines. Desktop OS Machines are VMs or physical machines based on the Windows Desktop operating system used for delivering personalized desktops to users, or applications from desktop operating systems.
Delivery groups consist of virtual desktops and applications that are pooled, pre-assigned, or assigned on first use. Each group can contain only one type of desktop or application.
To track the status of desktop OS machines in each delivery group configured in a site, use the Desktop OS Machines test.
Target of the test : A controller in a Citrix Virtual Apps/Desktops Site 7.x
Agent deploying the test : An internal agent
Outputs of the test : One set of results for each delivery group containing desktop OS machines in the site.
| Parameter | Description |
|---|---|
|
Test Period |
How often should the test be executed |
|
Host |
The IP address of the host for which the test is being configured. |
|
Port |
The port number at which the specified Host listens to. By default, this is 80. |
|
Controller IP Address |
Specify the IP address of the delivery controller in the site with which the eG agent should communicate for collecting performance metrics. |
|
Controller Port |
Specify the port number of the delivery controller in the site with which the eG agent should communicate for collecting performance metrics. |
|
Username |
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 privilege on the Citrix Virtual Apps/Desktops Site 7.x host. The steps for assigning the Allow log on locally privilege are explained in the Pre-requisites for monitoring the Citrix Virtual Apps/Desktops Site 7.x |
|
Confirm Password |
Confirm the Password by retyping it here. |
|
Fully Qualified Domain Name |
Here, specify the fully-qualified name of the domain to which the specified controller belongs. |
|
SSL |
Indicate whether/not the controller used for metrics collection is SSL-enabled. By default, this flag is set to Yes. |
|
DD Frequency |
Refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD Frequency. |
|
Detailed Diagnosis |
To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option. The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:
|
| Measurement | Description | Measurement Unit | Interpretation |
|---|---|---|---|
|
Total machines |
Indicates the total number of machines in this group. |
Number |
Use the detailed diagnosis of this measure to know which desktop OS machines are part of a delivery group. |
|
Preparing machines |
Indicates the number of machines in this group that are currently preparing sessions for users. |
Number |
|
|
Pending image update machines |
Indicates the number of machines managed by this delivery group to which updates are currently pending. |
Number |
Use the detailed diagnosis of this measure to know which machines are awaiting updates. Note that the value of this measure excludes the count of machines that are in maintenance mode while counting the machines in other states for the status of image update. |
|
Maintenance mode enabled machines |
Indicates the number of machines in this group for which maintenance mode has been enabled. |
Number |
|
|
Powered on machines |
Indicates the number of machines in this desktop group that are currently powered on. |
Number |
Use the detailed diagnosis of this measure to know which machines are currently powered on. |
|
Machines with suspended power state |
Indicates the number of machines in this delivery group that are currently in the Suspended state. |
Number |
Use the detailed diagnosis of this measure to know which machines are currently in the Suspended state. |
|
Powered off machines |
Indicates the number of machines in this delivery group that are currently powered off. |
Number |
Use the detailed diagnosis of this measure to know which machines are currently in the powered off. |
|
Machines with unknown power state |
Indicates the number of machines in the following power states:
|
Number |
A low value is desired for this measure. The detailed diagnosis of this measure will reveal the complete details of the unavailable machines, such as, the machine name, IP address, the machine type, the delivery group and catalog to which the machine belongs, the hosting server on which the machine operates, the name of the hypervisor and the controller on which the machine operates, the user who is active on the session, the location at whih the changes made by the user is stored, the provision type of the machine, and the application published on the machine, if the machine is a XenAPP server. |
|
Assigned machines |
Indicates the number of machines that are assigned to users in this delivery group. |
Number |
Use the detailed diagnosis of this measure to know which machines are assigned to users. |
|
Unassigned machines |
Indicates the number of machines in this delivery group that are not assigned to users. |
Number |
Use the detailed diagnosis of this measure to know which machines are not assigned to users. |
|
Resuming machines |
Indicates the number of machines in this group that are in the Resume state currently. |
Number |
Use the detailed diagnosis of this measure to know which machines are in the Resume state. |
|
Total sessions |
Indicates the total number of user sessions to this delivery group. |
Number |
|
|
Percentage of assigned machines |
Indicates the percentage of machines that are assigned to users in this delivery group. |
Percent |
|
|
Desktop utilization |
Indicates the percentage of desktops in this delivery group to which users are currently logged in. |
Percent |
A value close to 100% indicates that almost all desktops in the group are in use. Under such circumstances, you may want to add more desktops to the group to meet with the demand for desktops. |
|
Unregistered machines |
Indicates the number of machines that are configured in this delivery group but are in an unregistered state. |
Number |
If a machine is in an unregistered state, it means that registration has not successfully completed for that machine. The value 0 is hence desired for this measure. In case the measure reports a non-zero value, you may want to enable the detailed diagnosis for this measure, so that you can view which machines in the group are unregistered. |
|
Percentage of unregistered machines |
Indicates the percentage of machines that are configured in this delivery group but are in an unregistered state. |
Percentage |
A low value is desired for this measure. |
|
Percentage of maintenance mode enabled machines |
Indicates the percentage of machines in this group for which maintenance mode has been enabled. |
Percentage |
|
Use the detailed diagnosis of the Total machines measure to know which desktop OS machines are part of a delivery group.
Figure 1 : The detailed diagnosis of the Total machines measure
For a list of powered off machines in a delivery group, use the detailed diagnosis of the Powered off machines measure.
Figure 2 : The detailed diagnosis of the Powered off machines measure
