Device Collections Test

Device collections provide the ability to create and manage logical groups of target devices, which are typically created and managed by a “Device Administrator” (a farm and site administrator can also perform a device administrator’s tasks).

A device collection could represent a physical location, a subnet range, or a logical grouping of target devices. Creating Device Collections simplifies device management by performing actions at the collection level rather than at the target device level.

A target device can only be a member of one Device Collection.

This test monitors each device collection in the target site, and reports the active and inactive devices in each collection.

Target of the test : Citrix Provisioning server

Agent deploying the test : An internal agent

Outputs of the test : One set of results for every device collection configured in the target 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 – Refers to the port used by the Citrix Provisioning server. By default, this is 54321.

  4. mcli path – This test executes commands using the Management Command Line Interface (MCLI) of the Provisioning server to collect the required metrics. To enable the test to execute the commands, the eG agent, by default, auto-discovers the full path MCLI.exe on the target Provisioning server. This is why, the mcli path is set to none by default. If, for some reason, the eG agent is unable to auto-discover the mcli path, then you will have to manually specify the path here using the following pointers:

    • Typically, in a 32-bit Windows system, the MCLI.exe will be available in the following location by default: <System_Root>\Program Files\Citrix\Provisioning Services Console
    • In a 64-bit Windows system on the other hand, the MCLI.exe will be available in the following location by default: <System_Root>\Program Files (x86)\Citrix\Provisioning Services Console

  5. domain name, domain user and domain password – To report farm-related metrics, this test should run using the credentials of a user who fulfills the following requirements:

    • Should belong to the Security group with 'Farm Administrator' access.
    • Should be assigned the Allow log on locally security privilege on the Citrix Provisioning Server host.

    The steps for assigning such privileges to a user are detailed in the Pre-requisites for monitoring the Citrix Provisioning Server topic.

    Once you assigned the aforesaid privileges to the user, then configure this test with the domain name, domain user, and domain password of the same user.

  6. 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:

    • 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

Total devices:

Indicates the total number of target devices in this device collection.

Number

 

Active devices:

Indicates the number of target devices in this device collection that are currently connected to a vDisk.

Number

Use the detailed diagnosis of this measure to know which target devices in the collection are currently active.

Inactive devices:

Indicates the target devices in this collection that are not connected to any vDisk.

Number

Use the detailed diagnosis of this measure to know which target devices in the collection are currently inactive.

Use the detailed diagnosis of the Inactive devices measure to know which target devices in the collection are currently inactive. For each inactive device, the detailed diagnosis will reveal the device name, the MAC address, whether the device is booting from a vDisk or not and if so which vDisk, which server is associated with the device, and whether the server IP address is down/up.

Figure 1 : The detailed diagnosis of the Inactive devices measure