Failed Machines Test

Using this test, administrator can figure out how many machines of which type are currently in a state of failure. The names of these machines and the precise failure state they are in presently can also be ascertained.

Target of the test : A Citrix Director 7.x

Agent deploying the test : An internal agent

Outputs of the test : One set of results for each delivery group configured for the XenDesktop broker site

Configurable parameters for the test
  1. Test period - How often should the test be executed
  2. Host - The host for which the test is to be configured.
  3. port– The port number at which the specified HOST listens to. By default, this is 80.
  4. controller ip address – 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.
  5. controller port – 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.
  6. USERNAME and password – 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.
  7. CONFIRM PASSWORD – Confirm the PASSWORD by retyping it here.
  8. fully qualified DOMAIN name – Here, specify the fully-qualified name of the domain to which the specified controller belongs.
  9. ssl – Indicate whether/not the controller used for metrics collection is SSL-enabled. By default, this flag is set to Yes.
  10. report by machine type – If you want the results of this test to be grouped by machine type – i.e., grouped into Desktop OS Machines and Server OS Machines – then set this flag to Yes. If not, set this flag to No.
  11. show failed machine in days - By default, this parameter is set to none. Accordingly, this test, by default, reports the count of only those machines that recently experienced failures - these failures include a failure to start, being stuck on boot, deregistration, and/or an overload. Alternatively, you can have this test report the total number of machines that experienced the failures stated above during a configured period in the past. To achieve this, specify the period (in days) here.
  12. DETAILED DIAGNOSIS - To make diagnosis more efficient and accurate, the eG Enterprise suite 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:

    • The eG manager license should allow the detailed diagnosis capability
    • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Machines that failed to start

Indicates the number of machines in this delivery group that failed to start during the last N days, where N is the number of days configured against the SHOW FAILED MACHINES IN DAYS parameter.

Number

The value of this measure refers to the number of failures that occurred due to a guest machine being unable to start as in disk is detached when attempting to boot or the hosting server reported that the VM could not be booted up.

Use the detailed diagnosis of this measure to know which machines failed to start.

This measure will not be reported if the SHOW FAILED MACHINES IN DAYS parameter is set to none.

Machines stuck on boot

Indicates the number of machines that were stuck on boot during the last N days, where N is the number of days configured against the SHOW FAILED MACHINES IN DAYS parameter.

Number

This measure refers to the number of failures that occurred due to the guest operating system being unable to boot up fully. For example, OS BSOD during boot or unable to locate the boot partition.

Use the detailed diagnosis of this measure to know which machines were stuck on boot.

This measure will not be reported if the SHOW FAILED MACHINES IN DAYS parameter is set to none.

Unregistered machines

Indicates the number of machines in this delivery group that were not registered with the broker during the last N days, where N is the number of days configured against the SHOW FAILED MACHINES IN DAYS parameter.

Number

Machine registration can fail due to loss of network connectivity between the machine and the broker, the clocks on the two being out of sync or the Desktop Service not running on the desktop.

Use the detailed diagnosis of this measure to identify the unregistered machines.

This measure will not be reported if the SHOW FAILED MACHINES IN DAYS parameter is set to none.

Machines with maximum load

Indicates the number of machines in this delivery group that violated their maximum load limit during the last N days, where N is the number of days configured against the SHOW FAILED MACHINES IN DAYS parameter.

Number

This measure applies only to Server OS Machines.

The value of this measure refers to the number of failures that occurred owing to too many sessions on the machine or because CPU or memory usage of the machines crossed the threshold specified for the delivery group.

Use the detailed diagnosis of this measure to identify the loaded machines.

This measure will not be reported if the SHOW FAILED MACHINES IN DAYS parameter is set to none.

Machines that failed to start recently

Indicates the number of machines in this delivery group that failed to start since the last measurement period.

Number

Use the detailed diagnosis of this measure to know which machines failed to start recently.

This measure will be reported only if the SHOW FAILED MACHINES IN DAYS parameter is set to none.

Machines stuck on boot recently

Indicates the number of machines in this delivery group that were stuck on boot since the last measurement period.

Number

Use the detailed diagnosis of this measure to know which machines were stuck on boot. recently.

This measure will be reported only if the SHOW FAILED MACHINES IN DAYS parameter is set to none.

Recently unregistered machines

Indicates that number of machines in this delivery group that were not registered with the broker during the last measurement period.

Number

Use the detailed diagnosis of this measure to identify the recently unregistered machines.

This measure will be reported only if the SHOW FAILED MACHINES IN DAYS parameter is set to none.

Machines that reached maximum load recently

Indicates the number of machines in this delivery group that violated their maximum load limit since the last measurement period.

Use the detailed diagnosis of this measure to identify the loaded machines.

This measure will be reported only if the SHOW FAILED MACHINES IN DAYS parameter is set to none.