Product Documentation

Provisioning vGPU enabled XenDesktop machines

Sep 28, 2016

Requirements

Note: XenDesktop supports power management for virtual machines (VMs) catalogs, but not for physical machine catalogs.
  • NVIDIA GRID K1 or K2 cards.
  • A server capable of hosting XenServer and NVIDIA GRID cards. For details on recommended hardware, refer to the vGPU Release Notes (http://www.citrix.com/go/vgpu.com).
  • Citrix XenServer 6.2 or newer.
  • The NVIDIA GRID vGPU software package for Citrix XenServer, consisting of the GRID Virtual GPU.
  • Citrix XenCenter for XenServer, and NVIDIA drivers for Windows 7 32-bit/64-bit (available from http://www.nvidia.com/vGPU).
  • XenDesktop 7.6. Although it is not required for this process, Citrix recommends that you use the corresponding Provisioning Services release to XenDesktop release. The Provisioning Services XenDesktop Setup Wizard only works with the corresponding XenDesktop controller.
  • For details on configuring vGPU for XenServer, refer to at http://www.citrix.com/content/dam/citrix/en_us/documents/go/configuring-xenserver-to-use-nvidia-grid.pdf.

Procedures

You cannot create vGPU enabled XenDesktop machines using the 7.1 and 7.6 versions of the XenDesktop Setup Wizard. To provision GPU enabled XenDesktop machines manually, or using the Provisioning Services Streamed Virtual Machine Setup Wizard, complete the procedures that follow.

Prepare the master VM

  1. Prepare the master VM with vGPU enabled. For details, refer to "Prepare a master image for GPU-capable machines on XenServer " in the XenDesktop eDocs topic titled "Create a machine catalog".
  2. Install the nVidia drivers.
  3. Join the machine operating system to Active Directory.
  4. Install the Provisioning Services Target Device software.
  5. Using the Provisioning Services Imaging Wizard, create a new master vDisk image.

Prepare the template VM

  1. Create a template VM with the same properties as the master VM. Assign a hard drive to the template VM to use for write cache. For write cache recommendations, refer to Provisioning Services documentation in eDocs.
  2. Create a device record in the Provisioning Services database with the MAC address of the template VM.
  3. Assign the vDisk to the template VM, and then set the device to boot from vDisk.
  4. PXE boot the VM.
  5. Format the write-cache disk.

Install the XenDesktop Virtual Delivery Agent

  1. Using the Provisioning Services Console, set the vDisk image mode to Private Image.
  2. Install the XenDesktop Virtual Delivery Agent (VDA) and point the VDA to the XenDesktop Server during the installation. .
    Note: Alternatively, you can chose to install both the VDA and the target device software prior to creating the vDisk image. Both install methods require that the new template VM have a formatted write-cache hard drive.
  3. Reboot the VM, and then shut the VM down.
  4. Convert the VM to a template.

Create XenDesktop VMs

  1. Using the Provisioning Services Console, set the vDisk image mode to Standard Image.
  2. Choose the preferred write cache method. For details about write cache methods, refer to the Provisioning Services documentation in eDocs.
  3. Select from the following provisioning methods:
    1. Run the Provisioning Services Streamed VM Setup Wizard to provision VMs.
    2. Manually create VMs by creating target device records using device MAC addresses, assign the vDisk to the VMs, and then add the target devices to Active Directory.

Create XenDesktop machine catalogs

Note: For XenDesktop 7.1 and 7.5, you cannot choose a VDA version on the Device Collection page when creating a machine catalog.

When choosing between creating physical or virtual/blade server machine catalogs, it is important to consider the different advantages and requirements. For example, VM machine catalogs allow for power XenDesktop management while physical machine catalogs do not.

Virtual and blade server machine catalogs Physical machine catalogs
Requirements:
  • For XenDesktop, the host record must point to the XenServer host or pool where the vGPU VMs existed.
  • Special check. The VM names in XenServer, device record names in Provisioning Services device collection, and the Active Directory record must all be the same. Using the Provisioning Services Streamed VM Setup Wizard is recommended because it accomplishes all three tasks.
Requirements:

Special checks - Device names must exist in the Provisioning Services device collection and in Active Directory. Note: The XenDesktop host record is not required and the VM record names are not checked.

Steps:
  1. Start the XenDesktop Machine Catalog Setup Wizard, then select Windows Desktop OS on the Operating System page.
  2. On the Machine Management page, for "This Machine Catalog will use" select Machines that are power managed .
  3. For "Deploy machines using:" select Citrix Provisioning Services (PVS). Power management will be provided by XenDesktop.
  4. For "User Experience, " select Users will connect to a random desktop each time they log on.
  5. Enter the Provisioning Server's IP address for the device collection.
  6. Identify the domain where all device Active Directory records are stored and the VDA version level, then click Connect.
  7. In the Provisioning Services structure that displays, select the Provisioning Services device collection where all the vGPU devices are located, then click Next. Device records should be stored in an exclusive device collection.
  8. Enter a machine catalog name and description, then click Finish.
Steps:
  1. Start the XenDesktop Machine Catalog Setup Wizard, then select Windows Desktop OS on the Operating System page.
  2. On the Machine Management page, for "This Machine Catalog will use" select Machines that are not power managed (for example, physical machines).
  3. For "Deploy machines using: " select Citrix Provisioning Services (PVS). Power management will not be provided by XenDesktop.
  4. For "User Experience, " select Users will connect to a random desktop each time they log on.
  5. Enter the Provisioning Server's IP address for the device collection.
  6. Identify the domain where all device Active Directory records are stored and the VDA version level, then click Connect.
  7. In the Provisioning Services structure that displays, select the Provisioning Services device collection where all the vGPU devices are located, and then click Next. Device records should be stored in an exclusive device collection.
  8. Enter a machine catalog name and description, and then click Finish.

Create a Delivery Group and associate it with the machine catalog

For details on creating a Delivery Group, refer to the XenDesktop documentation in eDocs.