Product Documentation

Manage Machine Catalogs

Feb 24, 2016

Introduction

You can add or remove machines from a Machine Catalog, as well as rename, change the description, or manage a catalog's Active Directory computer accounts.

Maintaining catalogs can also include making sure each machine has the latest OS updates, anti-virus software updates, operating system upgrades, or configuration changes.

  • For Machine Catalogs containing pooled random machines created using Machine Creation Services (MCS), you can maintain machines by updating the master image used in the catalog and then updating the machines. This enables you to efficiently update large numbers of user machines. For machines created using Provisioning Services, updates to machines are propagated through the vDisk. See the Provisioning Services documentation for details.
  • For catalogs containing static, permanently assigned machines, and for Remote PC Access Machine catalogs, you manage updates to users' machines outside of Studio, either individually or collectively using third-party software distribution tools. 

Add machines to a Machine Catalog

Before you start:

  • Make sure the virtualization host (hypervisor or cloud service provider) has sufficient processors, memory, and storage to accommodate the additional machines.
  • Make sure that you have enough unused Active Directory computer accounts. If you are using existing accounts, the number of machines you can add is limited by the number of accounts available.
  • If you use Studio to create Active Directory computer accounts for the additional machines, you must have appropriate domain administrator permission.

To add machines to a catalog:

  1. Select Machine Catalogs in the Studio navigation pane.
  2. Select a Machine Catalog and then select Add machines in the Actions pane.
  3. Select the number of virtual machines to add.
  4. If there are insufficient existing Active Directory accounts for the number of VMs you are adding, select the domain and location where the accounts will be created. Specify an account naming scheme, using hash marks to indicate where sequential numbers or letters will appear. Do not use a forward slash (/) in an OU name. A name cannot begin with a number. For example, a naming scheme of PC-Sales-## (with 0-9 selected) results in computer accounts named PC-Sales-01, PC-Sales-02 , PC-Sales-03, and so on.
  5. If you use existing Active Directory accounts, either browse to the accounts or click Import and specify a .csv file containing account names. Make sure that there are enough accounts for all the machines you’re adding. Studio manages these accounts, so either allow Studio to reset the passwords for all the accounts, or specify the account password, which must be the same for all accounts.

The machines are created as a background process, and can take a lot of time when creating a large number of machines. Machine creation continues even if you close Studio.

Delete machines from a Machine Catalog

After you delete a machine from a Machine Catalog, users can no longer access it, so before deleting a machine, ensure that:

  • User data is backed up or no longer required.
  • All users are logged off. Turning on maintenance mode will stop new connections from being made to a machine.
  • Machines are powered off.

To delete machines from a catalog:

  1. Select Machine Catalogs in the Studio navigation pane.
  2. Select a catalog and then select View Machines in the Actions pane.
  3. Select one or more machines and then select Delete in the Actions pane.

Choose whether to delete the machines being removed. If you choose to delete the machines, indicate whether the Active Directory accounts for those machines should be retained, disabled, or deleted.

Change a Machine Catalog description or change Remote PC Access settings

  1. Select Machine Catalogs in the Studio navigation pane.
  2. Select a catalog and then select Edit Machine Catalog in the Actions pane.
  3. (Remote PC Access catalogs only) On the Power Management page, you can change the power management settings and select a power management connection. On the Organizational Units page, add or remove Active Directory OUs.
  4. On the Description page, change the catalog description.

Rename a Machine Catalog

  1. Select Machine Catalogs in the Studio navigation pane.
  2. Select a catalog and then select Rename Machine Catalog in the Actions pane.
  3. Enter the new name.

Move a Machine Catalog to a different zone

If your Site has more than one zone, you can move a catalog from one zone to another. 

Caution: Moving a catalog to a different zone than the hypervisor or cloud service containing the VMs in that catalog can affect performance.

  1. Select Machine Catalogs in the Studio navigation pane.
  2. Select a catalog and then select Move in the Actions pane.
  3. Select the zone where you want to move the catalog.

Delete a Machine Catalog

Before deleting a Machine Catalog, ensure that:

  • All users are logged off and that no disconnected sessions are running.
  • Maintenance mode is turned on for all machines in the catalog so that new connections cannot be made.
  • All machines in the catalog are powered off.
  • The catalog is not associated a Delivery Group – in other words, the Delivery Group does not contain machines from the catalog.

To delete a Machine Catalog:

  1. Select Machine Catalogs in the Studio navigation pane.
  2. Select a catalog and then select Delete Machine Catalog in the Actions pane.
  3. Indicate whether the machines in the catalog should be deleted. If you choose to delete the machines, indicate whether the Active Directory computer accounts for those machines should be retained, disabled, or deleted.

Manage Active Directory computer accounts in a Machine Catalog

To manage Active Directory accounts in a Machine Catalog, you can:

  • Free unused machine accounts by removing Active Directory computer accounts from Desktop OS and Server OS Machine Catalogs. Those accounts can then be used for other machines.
  • Add accounts so that when more machines are added to the catalog, the computer accounts are already in place. Do not use a forward slash (/) in an OU name.

To manage Active Directory accounts:

  1. Select Machine Catalogs in the Studio navigation pane.
  2. Select a catalog and then select Manage AD accounts in the Actions pane.
  3. Choose whether to add or delete computer accounts. If you add accounts, specify what to do with the account passwords: either reset them all or enter a password that applies to all accounts. You might reset passwords if you do not know the current account passwords; you must have permission to perform a password reset. If you enter a password, the password will be changed on the accounts as they are imported. If you delete an account, choose whether the account in Active Directory should be kept, disabled, or deleted.

Note: You can also indicate whether Active Directory accounts should be retained, disabled, or deleted when you remove machines from a catalog or delete a catalog.

Update a Machine Catalog

Citrix recommends that you save copies or snapshots of master images before you update the machines in the catalog. The database keeps an historical record of the master images used with each Machine Catalog. You can roll back (revert) machines in a catalog to use the previous version of the master image if users encounter problems with updates you deployed to their desktops, thereby minimizing user downtime. Do not delete, move, or rename master images; otherwise, you will not be able to revert a catalog to use them.

For catalogs that use Provisioning Services, you must publish a new vDisk to apply changes to the catalog. For details, see the Provisioning Services documentation.

After a machine is updated, it restarts automatically.

Update or create a new master image

Tip: Need connection type information sources? Go here.

Before you update the Machine Catalog, either update an existing master image or create a new one on your host hypervisor.

  1. On your hypervisor or cloud service provider, take a snapshot of the current VM and give the snapshot a meaningful name. This snapshot can be used to revert (roll back) machines in the catalog, if needed.
  2. If necessary, power on the master image, and log on.
  3. Install updates or make any required changes to the master image.
  4. If the master image uses a personal vDisk, update the inventory.
  5. Review these operating system optimization guides and apply the optimizations for your environment: Windows 7 Optimization Guide and Windows 8/8.1 Virtual Desktop Optimization Guide.
  6. Power off the VM.
  7. Take a snapshot of the VM, and give the snapshot a meaningful name that will be recognized when the catalog is updated in Studio. Although Studio can create a snapshot, Citrix recommends that you create a snapshot using the hypervisor management console, and then select that snapshot in Studio. This enables you to provide a meaningful name and description rather than an automatically generated name. For GPU master images, you can change the master image only through the XenServer XenCenter console.

Update the catalog

To prepare and roll out the update to all machines in a catalog:

  1. Select Machine Catalogs in the Studio navigation pane.
  2. Select a catalog and then select Update Machines in the Actions pane.
  3. On the Master Image page, select the host and the image you want to roll out.
  4. On the Rollout Strategy page, choose when the machines in the Machine Catalog will be updated with the new master image: on the next shutdown or immediately. See below for details.
  5. Verify the information on the Summary page and then click Finish. Each machine restarts automatically after it is updated.

Tip: If you are updating a catalog using the PowerShell SDK directly, rather than Studio, you can specify a hypervisor template (VMTemplates), as an alternative to an image or a snapshot of an image.

Rollout strategy

Updating the image on the next shutdown is provided when you are using the Citrix Connector for System Center Configuration Manager.

If you choose to update the image immediately, configure a distribution time and notifications.

  • Distribution time: You can choose to update all machines at the same time, or specify the total length of time it should take to begin updating all machines in the catalog. An internal algorithm determines when each machine is updated and restarted during that interval.
  • Notification: In the left notification dropdown, choose whether to display a notification message on the machines before an update begins. By default, no message is displayed. If you choose to display a message 15 minutes before the update begins, you can choose (in the right dropdown) to repeat the message every five minutes after the initial message. By default, the message is not repeated. Unless you choose to update all machines at the same time, the notification message displays on each machine at the appropriate time before the update begins, calculated by an internal algorithm.

Roll back an update

After you roll out an updated/new master image, you can roll it back. This might be necessary if issues occur with the newly-updated machines. When you roll back, machines in the catalog are rolled back to the last working image. Any new features that require the newer image will no longer be available. As with the rollout, rolling back a machine includes a restart.

  1. Select Machine Catalogs in the Studio navigation pane.
  2. Select the catalog and then select Rollback machine update in the Actions pane.
  3. Specify when to apply the earlier master image to machines, as described above for the rollout operation.

The rollback is applied only to machines that need to be reverted. For machines that have not been updated with the new/updated master image (for example, machines with users who have not logged off), users do not receive notification messages and are not forced to log off.

Upgrade a Machine Catalog or revert an upgrade

Upgrade the Machine Catalog after you upgrade the VDAs on the machines to a newer version. Citrix recommends upgrading all VDAs to the latest version to enable access to all the newest features.

Before upgrading a Machine Catalog:

  • If you’re using Provisioning Services, upgrade the VDA version in the Provisioning Services console.
  • Start the upgraded machines so that they register with the Controller. This lets Studio determine that the machines in the Machine Catalog need upgrading.

To upgrade a Machine Catalog:

  1. Select Machine Catalogs in the Studio navigation pane.
  2. Select the catalog. The Details tab in the lower pane displays version information.
  3. Select Upgrade Catalog. If Studio detects that the Machine Catalog needs upgrading, it displays a message. Follow the prompts. If one or more machines cannot be upgraded, a message explains why. Citrix recommends you resolve machine issues before upgrading the Machine Catalog to ensure that all machines function properly.

After the catalog upgrade completes, you can revert the machines to their previous VDA versions by selecting the catalog and then selecting Undo in the Actions pane.

Note: If you have Windows XP or Windows Vista machines, they must use an earlier VDA version, and will not be able to use the latest product features. If you cannot upgrade those machines to a currently supported Windows operating system, Citrix recommends you keep them in a separate catalog.