Product Documentation

Manage machines

May 09, 2015
Use machine catalogs to efficiently manage machines as follows:
  • Update users' desktops
  • Add machines available for users
  • Modify a machine catalog
  • Delete a machine catalog
  • Manage computer accounts:
    • Active Directory accounts for Desktop OS and Server OS machines
    • Organizational Units (OU) for Remote PC Access machines
  • Manage machine catalogs whose machines have older operating systems or Virtual Desktop Agent (VDA) versions including:
    • Windows XP or Windows Vista operating systems
    • VDAs whose versions are earlier than this release

Update users' desktops

Random machine catalogs

Maintain users' desktops by applying global updates, such as Windows updates, anti-virus software updates, or configuration changes, to the Master Image. Then modify the machine catalog to use the updated master image so users receive the updated desktop at their next logon. Using this method lets you make significant changes to users' desktops, including upgrading to a new operating system, for large numbers of users in one operation.

Static and Remote PC Access machine catalogs

You must manage updates to users' desktops outside of Studio, either on an individual basis or collectively using third-party software distribution tools. For machines created through Provisioning Services, updates to users' desktops are propagated through the vDisk.

Citrix recommends that you save copies or snapshots of master images before you make any updates. The Database retains a historical record of the master images used with each machine catalog. To quickly revert a machine catalog to use the previous version, preserving the old Master Images in their original state, that is, do not delete, move, or rename the master images. You can then use the previous version of the Master Image should users encounter problems with updates that you have deployed to their desktops, thereby minimizing user downtime.

Add machines

You can deploy additional machines to an existing machine catalog as follows:

For this type of machine catalog:

You can:

Desktop OS and Server OS

Add more machines and, if required, add more Active Directory computer accounts.

Remote PC Access

Deploy the VDA component on additional office PCs that already are members of appropriate Organizational Units (OUs).

Existing and physical

Set up additional VMs or blade PCs, respectively, plus any computer accounts that are required, outside of Studio. You can then add these machines and accounts to the machine catalog.

Machines created by Provisioning Services (with Personal vDisks)

Add more machines by joining more target devices to an existing device collection using Provisioning Services. Alternatively, create additional device collections in Provisioning Services and then add the new collections to the existing machine catalog.

Change machine catalogs

  • Modify a machine catalog -— You can add or remove administrators from the list of assignment administrators permitted to use the machine catalog, edit the machine catalog name or description, and quickly view the details and status of all the machines included in the machine catalog.
  • Delete a machine catalog — When you delete a machine catalog, the machines and the associated Active Directory computer accounts or OUs are removed from Studio management. For Windows Desktop OS and Windows Server OS machine catalogs, you can optionally delete the machines and computer accounts from the host and from Active Directory.
  • Upgrade a machine catalog — If a machine catalog includes any machines running Windows XP or Vista, or includes VDA versions prior to this release, the wizard detects and notifies you that these machines reside in a separate machine catalog. You can continue to use these early version machine catalogs and their Delivery Groups. However, to take advantage of new features introduced in this release, you must upgrade as described in Upgrade a machine catalog and as follows:
    • Upgrade the machine's operating system to Windows 7 or Windows 8, which is compatible with XenDesktop 7
    • Upgrade any of the following VDA versions to XenDesktop 7:
      • 5.0 Service Pack 1
      • 5.5
      • 5.6
      • 5.6 Feature Pack 1

Add machines to a machine catalog

Updated: 2013-06-20

Prepare to add machines

Before you add machines to a machine catalog, consider the following:

  • Make sure that the virtualization infrastructure hosting the specified master image for the machine catalog has sufficient processors, memory, and storage to accommodate the additional machines you plan to create.
  • Make sure you have enough computer accounts
    • Sufficient number of unused Active Directory computer accounts for the additional machines you plan to create. If you are using existing computer accounts, note that the number of machines you can create is limited by the number of accounts that are available.
    • Access to an Active Directory domain administrator account for the domain of which the desktops are members.
    • Adequate numbers of Organizational Units (OUs) for Remote PC Access machines.
  • Remote PC Access machine catalogs — When Remote PC Access is first deployed, the system creates a machine catalog and associated Delivery Group specific for Remote PC Access. The machine catalog contains all of the Machine Accounts, which are individual accounts or Organizational Units (OUs), that contain multiple accounts. The Delivery Group contains all of the users assigned during the Remote PC Access deployment. In addition to adding machines to the catalog, you can add, change, or remove OUs to specify which additional machines are automatically added to the deployment from this point on.

To add machines to a machine catalog

  1. Log on to the computer running Studio. If you plan to use Studio to create Active Directory computer accounts for the additional machines, log on using a domain administrator account for the domain of which the desktops are members.
  2. Start Studio.
  3. Select Machine Catalogs and then select a machine catalog in the results pane, and click Add machines.
  4. On the Machines and Users page, import machines using one of the following methods:
    • Click Add Computers to select computers from the domain.
    • Select an Active Directory Account from the list.
    • If more Active Directory computer accounts are required and you want Studio to create new accounts for the machines, select Import accounts.
  5. On the Import accounts page, provide the required information.

    To create new computer accounts, specify:

    • Active Directory to which the accounts are added
    • Domain
    • OU
    • Name for the new account

    To use existing accounts, click Browse and select computer accounts in Active Directory or click Import and specify a .csv file containing a list of account names. Because Studio manages these accounts, either allow Studio to reset the passwords for all the accounts or supply the account password (which must be the same for all accounts). Make sure that you import enough accounts for all additional machines you want to create.

  6. On the Summary page, check that the details are correct.

    Studio performs machine creation as a background process so that you can continue to work. Because VMs are created sequentially, this can be a lengthy process when you add a large number of machines to a machine catalog. Machine creation continues to completion even if you close Studio.

Modify a machine catalog

You can perform the following machine catalog changes with Edit Catalog:

  • Change the machine catalog description.
  • Change the machine catalog name.
  • For Remote Access PC machine catalogs you can also:
    • Add, change, or remove Organizational Units (OUs), to modify access for the machines associated with the OU.
    • Change the machines associated with the Delivery Group, as described in Edit a Delivery Group.

To edit a machine catalog

  1. In Studio, in the Machine Catalogs node, select the machine catalog you want to change.
  2. Click Edit Machine Catalog. If this is not a Remote PC Access machine catalog, go to step 4.
  3. For a Remote PC Access machine catalog:
    • On the Power Management page, if you enable power management for the machines in this machine catalog, select a Remote PC Access power management connection. Enabling power management lets users turn on their Remote PC Access machines.
    • On the Organizational Units page, add or remove Organizational Units, which contain multiple user accounts, and then click Save.
  4. Click Description to make changes in descriptions that users and administrators see.

To rename a machine catalog

  1. In Studio, in the Machine Catalogs node, select the machine catalog you want to change, and then click Rename Machine Catalog.
  2. Enter the name you want, and then click OK.

To search for a machine catalogs

To search for machine catalogs, use the Search node as described in Find machines, sessions, machine catalogs, applications, and Delivery Groups. You cannot search within the machine catalogs node.

Delete machine catalogs and included machines

Updated: 2015-04-26

Any administrator who has permissions to use a machine catalog when allocating desktops to users can delete that machine catalog. Before deleting a machine catalog, make sure that:

  • All users are logged off from the desktops in the machine catalog (You can force log offs if users have not logged off )
  • No disconnected user sessions are still running
  • All machine catalogs machines are in maintenance mode
  • All existing machines are shut down
  • The machine catalog is not associated with a Delivery Group

To delete a machine catalog

  1. In Studio, select the Machine Catalogs node and then select the machine catalog in the results pane, and click Delete Machine Catalog.
  2. For Desktop OS and Server OS machine catalogs, specify whether to delete the machines hosting users' desktops or applications. If you delete the machines, you have the following options for the removed machines and the associated Active Directory computer accounts:
    • Leave the machines in the Active Directory
    • Disable the machines in the Active Directory
    • Delete the machines from the Active Directory
  3. On the Summary page, check that the details are correct.

To delete machines from a machine catalog

When you delete a machine, users no longer can access it, and the machine is deleted from the machine catalog. Before deleting a machine, make sure that all user data is backed up or no longer required. You can delete a machine only when no users are logged on. To temporarily stop users from connecting to a machine while you are deleting it, put the machine into maintenance mode.

  1. In Studio, use Search to locate the machine you want to delete, or select a Delivery Group and click View Machines.
  2. Select the machine, and put it in maintenance mode.
  3. Click Delete and select one of the following options:
    • Remove the virtual machines from the machine catalog without deleting the virtual machines.
    • Remove the virtual machines from the machine catalog and deleting the virtual machines. You must also select how to handle the associated Active Directory accounts:
      • Leave the accounts in the machine catalog and do not change them in Active Directory.
      • Remove the accounts from the machine catalog but do not remove them from Active Directory.
      • Remove the accounts from the machine catalog and disable them in Active Directory.
      • Remove the accounts from the machine catalog and delete them from Active Directory.