Product Documentation

Device collections

Device collections provide the ability to create and manage logical groups of target devices. Creating device collections simplifies device management by performing actions at the collection level rather than at the target-device level.

Note:

A target device can only be a member of one device collection.

A device collection could represent a physical location, a subnet range, or a logical grouping of target devices. For example, a collection could consist of all target devices that use a particular vDisk image, and that target device collection might consist of maintenance, test, and production devices. Alternatively, three device collections could exist for a particular vDisk; one consisting of production devices, one consisting of test machines, and another consisting of maintenance machines. In the proceeding examples, all of the devices in a given collection are assigned to the same vDisk.

Depending on a sites preference, another collection use case might include the consolidation of test and/or maintenance devices into a single device collection, and then managing vDisk assignments on a per device basis rather than a per collection basis. For example, create a device collection labeled Development consisting of five target devices, each one assigned to a particular vDisk.

Device collections are created and managed by farm administrators, or site administrators that have security privileges to that site, or device administrators that have security privileges to that collection.

Expanding a Device Collections folder in the Console’s tree allows you to view members of a device collection. To display or edit a device collection’s properties, right-click on an existing device collection in the Console, then select the Properties menu option. The Device Collection Properties dialog displays allowing you to view or make modifications to that collection.

You can perform actions on members of a device collection, such as rebooting all target devices members in this collection.

Importing target devices into a collection

The Import Target Devices Wizard allows you to import target device information from a file. The target device information must first be saved as a.csvfile, it can then be imported into a device collection.

Note:

The.csvtext file can be created with a.txtfile,NotePad.exe or Excel. It contains one line per target device, which is formatted as follows:

DeviceName,MAC-Address,SiteName,CollectionName,Description,Type

where:

DeviceName = Name of new target device MAC-Address = MAC address of new device; such as 001122334455, 00-11-22-33-44-55, or 00:11:22:33:44:55 Type = 0 for production, 1 for test, or 2 for maintenance

The wizard can be accessed from the farm, site, and device collection right-click menus. If accessed from the site or collection, only those target devices in the import file that match the site and collection by name, will be included in the import list.

The wizard also provides the option to automatically create the site or collection using the information in the file, if either does not already exist. There is also the option to use the default collection’s device template, if it exists for that collection.

A log file is generated with an audit trail of the import actions. The file is located in:

C:\Documents and Settings\All Users\Application Data\Citrix\Provisioning Services\log

To Import target devices into a Collection

  1. In the Console, right-click on the device collection that the target devices should be imported to, then click Target Device>Import devices. The Import Target Devices Wizard displays.
  2. Type or browse for the file to import. The target device information is read from the file and displays in the table below. Information can include the target device name, MAC address, and optionally description.
  3. Highlight one or more target devices to import. If applying the collection template to the imported target devices, select the Apply collection template device when creating devices checkbox.
  4. Click Import to import the .csv text file containing target device information, into the selected collection. The status column indicates if the import was successful.

Refreshing a collection in the Console

After making changes to a collection, it may be necessary to refresh the collection before those changes appear in the Console. To refresh, right-click on the collection in the tree, then select the Refresh menu option.

Booting target devices within a collection

To boot target devices within a collection:

  1. Right-click on the collection in the Console tree, then select the Target Device>Boot menu option. The Target Device Control dialog displays with the Boot devices menu option selected in the Settings drop-down menu. Target devices display in the Device table.
  2. Click the Boot devices button to boot target devices. The Status column displays the Boot Signal status until the target device successfully receives the signal, then status changes to success.

Restarting target devices within a collection

To restart target devices within a collection:

  1. Right-click on the collection in the Console tree, then select the Target Device>Restart devices menu option. The Target Device Control dialog displays with the Restart devices menu option selected in the Settings drop-down menu. Devices display in the Device table.
  2. Type the number of seconds to wait before restarting target devices in the Delay text box.
  3. Type a message to display on target devices in the Message text box.
  4. Click the Restart devices button to restart target devices. The Status column displays the restart signal status until the target device successfully receives the signal, then status changes to Success.

Shutting down target devices within a collection

To shut down target devices members within a collection

  1. Right-click on the collection in the Console tree, then select the Target Device>Shutdown devices menu option. The Target Device Control dialog displays with the Shutdown devices menu option selected in the Settings drop-down menu. Target devices display in the Device table.
  2. Type the number of seconds to wait before shutting down target devices in the Delay text box. Type a message to display on target devices in the Message text box.
  3. Click the Shutdown devices button to shutdown target devices. The Status column displays the shutdown signal status until the target device shuts down. As each target device successfully shuts down, the status changes to Success.

Sending messages to target devices within a collection

To send a message to target device members within a collection

  1. Right-click on the collection in the Console tree, then select the Target Device>Send message menu option. The Target Device Control dialog displays with the Message to devices menu option selected in the Settings drop-down menu. Target devices display in the Device table.
  2. Type a message to display on target devices in the Message text box.
  3. Click the Send message button. The Status column displays the message signal status until the target device successfully receives the message, then the status changes to Success.

Moving collections within a site

Target devices can be moved from one collection to another collection within the same site.

To move a collection

  1. In the Console, expand the collection, right-click on the target device, then select the Move menu option.
  2. From the drop-down menu, select the collection to move this target device into, then click OK to close the dialog.