Product Documentation

Install and configure HDX 3D Pro for Windows Desktop OS

Jul 18, 2013

Pre-requisites

  • An installed and configured XenDesktop infrastructure
  • A XenDesktop site

To install using the graphical interface

To enable users to connect to the physical machine or XenServer VM hosting the graphical application, you install the Delivery Agent (DA) for HDX 3D Pro. Then, to assign the virtual desktop or application to a user, you create a machine catalog and a delivery group containing the computer that hosts the graphical application.

  1. Prepare the VM or physical machine that will host the graphical application: Install and set up the graphical application, plus any other applications that are required.

    For more information about assigning GPUs to XenServer VMs, see the XenServer Virtual Machine Installation Guide.

    Note: By default, each virtual CPU that you allocate to a XenServer VM is assigned to a single-core socket. This means that on operating systems with socket restrictions, you can only use a limited number of the CPU cores on the host server. XenServer Advanced, Enterprise, and Platinum editions include a feature that enables you to specify the number of cores per virtual CPU in a VM. For more information, see http://support.citrix.com/article/CTX126524.
  2. For user connections to physical VDAs with physical monitors attached, verify that the user device resolution is equal to or less than the VDA resolution.

    If the resolution requested by the user device is high, the ICA session will not detect the resolution of the user device and will fall back to the minimum resolution supported by the VDA monitor.

  3. Join the host computer to the Active Directory domain containing your Delivery Controller. Make a note of the Active Directory computer account name for the host computer as you will need to know this when you create a machine catalog.
  4. Insert the XenDesktop installation media into the optical drive or mount the ISO on the host computer. If autorun is not enabled, navigate to and run AutoSelect.exe on the installation media.
  5. Select Virtual Delivery Agent for Windows Desktop OS.
  6. Select Enable Remote PC Access.
  7. Select Yes, install the VDA for HDX 3D Pro.
  8. On the Controller Location page, specify the controllers in the XenDesktop site to which the DA for HDX 3D Pro will connect, either by manually entering the locations or by selecting controllers from Active Directory. Alternatively, select Configure at a later time if you plan to specify controller locations later using Group Policy or by running the installer again.
    Important: Ensure that you specify the locations of all the controllers in the site, otherwise some user connections may be refused. For load balancing, the DA for HDX 3D Pro automatically distributes connections evenly across the controllers.
  9. If you are using a firewall other than Windows Firewall on the host computer, manually enable ports 80, 1494, 2598, and 3389 to allow XenDesktop to function correctly and open ports 16500–16509 to enable Real-time Transport for Audio. If Windows Firewall is running on the host computer, the installer gives you the option to open the ports automatically. Click Next.
  10. On the Summary page, click Install.

    Before the DA for HDX 3D Pro is installed, the following prerequisites are installed if they are not already present on the host computer.

    • Microsoft .NET Framework 3.5 SP 1
    • Microsoft Visual C++ 2005, 2008 SP 1, and 2010 Redistributable packages
  11. When the installation is complete, ensure that the Restart machine (required to complete install) check box is selected and click Close.
  12. After completing the installation of the DA for HDX 3D Pro, log on to the computer running Studio. Create an existing (if the host computer is a VM) or physical machine catalog, as appropriate, and add the computer hosting the graphical application.
  13. To make the hosted applications or desktops on Desktop OS machines available to users, create a delivery group or an application delivery group using the machine catalog containing the host computer.

To install using the command line

You can also install the DA for HDX 3D Pro from a command prompt. To install HDX 3D Pro, run XenDesktopVdaSetup.exe and include the following option in addition to any others you need to use.

  • /ENABLE_HDX_3D_PRO

For information about other options, run XenDesktopVdaSetup.exe /h or see Install using the command line.

To deploy the DA for HDX 3D Pro through Active Directory Group Policy, ensure that the transform file specifies appropriate values for the ENABLE_HDX_3D_PRO properties. For more information about deploying the DA through group policy, see Install or remove Virtual Delivery Agents using scripts in Active Directory.

To upgrade HDX 3D Pro

To upgrade HDX 3D Pro, uninstall both the separate HDX 3D for Professional Graphics component and the Delivery Agent (DA) before installing the latest DA for HDX 3D Pro. Similarly, to switch from the standard DA to the DA for HDX 3D Pro, uninstall the standard DA before installing the DA for HDX 3D Pro.