Provisioning vGPU-enabled Citrix Virtual Apps and Desktop machines

Requirements

  • NVIDIA GRID K1 or K2 cards.

Tip

Sometimes, other NVIDIA cards may function properly (for example, NVIDIA Tesla M60) as long as the XenServer/ESX hypervisor supports it. The underlying vGPU card in the XenServer host is unknown to Citrix Provisioning. Citrix Provisioning only uses the vGPU setting in the template and propagates it to the VMs provisioned by the Citrix Virtual Apps and Desktops Setup Wizard.

  • A server capable of hosting XenServer and NVIDIA GRID cards.
  • A supported hypervisor: Citrix XenServer 6.2 or newer, or vSphere 6.0 or newer.
  • The NVIDIA GRID vGPU package for your hypervisor.
  • NVIDIA drivers for Windows 7 32-bit/64-bit.
  • The Citrix Provisioning release that corresponds to the Citrix Virtual Apps and Desktop release you are using. This Wizard only works with the corresponding Citrix Virtual Apps and Desktops controller.
  • To provision machines using the Citrix Provisioning Setup Wizard, you must use Citrix Provisioning 7.7 or newer and XenDesktop 7.7 or newer. If you use earlier product versions you can only provision machines manually or by using the Citrix Provisioning Streamed Virtual Machine Setup Wizard.

Note:

Citrix Virtual Apps and Desktops supports power management for virtual machine (VM) catalogs, but not for physical machine catalogs.

Provisioning procedures

Prepare the master VM

  1. Prepare the master VM with vGPU enabled.
  2. Install the nVidia drivers.
  3. Join the machine operating system to Active Directory.
  4. Install the Citrix Provisioning Target Device software.
  5. Using the Citrix Provisioning Imaging Wizard, create a master vDisk image. If you plan to use the Citrix Virtual Apps and Desktops Setup Wizard to provision machines, select the Target Device Optimizer option, otherwise the VM fails to boot.

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.
  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 Citrix Virtual Apps and Desktops Virtual Delivery Agent

  1. Using the Provisioning Console, set the vDisk image mode to Private Image.
  2. Install the Citrix Virtual Apps and Desktops Virtual Delivery Agent (VDA) and point the VDA to the Citrix Virtual Apps and Desktops Server during the installation. Note: Alternatively, you can install both the VDA and the target device software before creating the vDisk image. Both install methods require the new template VM to 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 Citrix Virtual Apps and Desktops VMs

  1. Using the Provisioning Console, set the vDisk image mode to Standard Image.
  2. Choose the preferred write cache method.
  3. Select from the following provisioning methods:
    • Run the Citrix Provisioning Citrix Virtual Apps and Desktops Setup Wizard to provision VMs. This method is available only if you are using Citrix Provisioning 7.7 or later and XenDesktop 7.7 or later.
    • Run the Citrix Provisioning Streamed VM Setup Wizard to provision VMs.
    • 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 Citrix Virtual Apps and Desktops machine catalogs

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 Citrix Virtual Apps and Desktops management while physical machine catalogs do not.

Virtual and blade server machine catalogs Steps
Requirements: For Citrix Virtual Apps and Desktops, the host record must point to the XenServer host or pool where the vGPU VMs existed. The VM names in your hypervisor, device record names in Citrix Provisioning device collection, and the Active Directory record must all be the same. 1). Start the Citrix Virtual Apps and Desktops Machine Catalog Setup Wizard. Select Windows Desktop OS on the Operating System page. 2). On the Machine Management page, for "This Machine Catalog uses&quot, select Machines that are power managed. 3). For Deploy machines using select Citrix Provisioning. Power management is Citrix Virtual Apps and Desktops. 4). For User Experience select Users connect to a random desktop each time they log on. 5). Enter the Provisioning Server’s IP address for the device collection. 6). In the structures that appears, select the Citrix Provisioning device collection where all the vGPU devices are located, then click Next. Device records should be stored in an exclusive device collection. 7). In the structures that appears, select the Provisioning 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.
Physical machine catalogs Steps
Requirements: Device names must exist in Citrix Provisioning device collection and in Active Directory. Note: The Citrix Virtual Apps and Desktops host record is not required and the VM record names are not verified. 1). Start the Citrix Virtual Apps and Desktops Machine Catalog Setup Wizard, then select Windows Desktop OS on the Operating System page. On the Machine Management page, for This Machine Catalog uses select Machines that are not power managed (for example, physical machines). 2). On the Machine Management page, for This Machine Catalog uses select Machines that are not power managed (for example, physical machines). 3). For Deploy machines using: select Citrix Provisioning. Power management is not provided by Citrix Virtual Apps and Desktops. 4). For User Experience select Users 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 structures that appears, select the Citrix Provisioning 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 Citrix Virtual Apps and Desktops documentation.

Citrix Provisioning and Citrix Virtual Apps and Desktops cloud considerations

Within a Cloud DDC, you can create a machine catalog and choose to deploy those machines using Citrix Provisioning by pointing the catalog to a Provisioning collection. If you intend to use Citrix Provisioning with a Cloud DDC, all the machines within the Provisioning collection must be associated with Active Directory (AD) accounts.

Provisioning vGPU-enabled Citrix Virtual Apps and Desktop machines