There are two types of VDAs for Windows machines: VDA for Server OS and VDA for Desktop OS. This article describes the installation wizard sequence when installing a VDA. Command-line equivalents are provided. For details, see Install VDAs using the command line.
IMPORTANT: Before you start an installation, review Prepare to install. That article describes the available VDA installers and other considerations.
Alternatively to steps 1-3, you can download the VDA directly from the Citrix download page.
On the Environment page, specify how you plan to use the VDA. Choose one of the following:
Command-line options: /masterimage, /remotepc
If you are using the VDAWorkstationCoreSetup.exe installer, this page does not appear in the wizard and the command-line options are not valid.
The HDX 3D Pro page appears only when installing a VDA for Desktop OS.
HDX 3D Pro mode
Usually best for virtual desktops without graphics hardware acceleration, and for Remote PC Access.
Usually best for data center desktops with graphics hardware acceleration, unless more than four monitors are necessary.
Any GPU can be used for Remote PC Access, with some app compatibility limitations:
Supports GPU acceleration with any GPU. However, console blanking, non-standard screen resolutions and true multi-monitor support require NVIDIA GRID, Intel Iris Pro, or AMD RapidFire graphics.
Leverages graphics vendor's driver for broadest application compatibility:
Arbitrary monitor resolutions (limit determined by Windows OS and performance) and up to eight monitors.
Supports up to four monitors.
H.264 hardware encoding available with Intel Iris Pro graphics processors.
H.264 hardware encoding available with Intel Iris Pro graphics processors and NVIDIA cards.
Command-line option: /enable_hdx_3d_pro
On the Core components page:
Command-line options: /installdir, "/components vda" to prevent Citrix Receiver for Windows installation
The Additional Components page contains check boxes to enable or disable installation of other features and technologies with the VDA. This page does not appear if:
Citrix Personalization for App-V:
Install this component if you use applications from Microsoft App-V packages. For details, see App-V.
Command-line option: /exclude "Citrix Personalization for App-V – VDA" to prevent component installation
Citrix AppDisk / Personal vDisk:
Valid only when installing a VDA for Desktop OS on a VM. Installs components used for AppDisk and Personal vDisk.
Command-line option: /exclude "Personal vDisk" to prevent AppDisk and Personal vDisk component installation
Citrix User Profile Manager:
This component manages user personalization settings in user profiles. For details, see Profile Management.
Excluding Citrix Profile management from the installation affects the monitoring and troubleshooting of VDAs in Citrix Cloud . On the User details and EndPoint pages of the Monitor tab, the Personalization panel and the Logon Duration panel fail. On the Dashboard and Trends pages, the Average Logon Duration panel display data only for machines that have Profile management installed.
Even if you are using a third-party user profile management solution, Citrix recommends that you install and run the Citrix Profile management Service. Enabling the Citrix Profile management Service is not required.
Command-line option: /exclude "Citrix User Profile Manager" to prevent component installation
Citrix User Profile Manager WMI Plugin:
This plug-in provides Profile management runtime information in WMI (Windows Management Instrumentation) objects (for example, profile provider, profile type, size, and disk usage). WMI objects provide session information to Director.
Command-line option: /exclude "Citrix User Profile Manager WMI Plugin" to prevent component installation
Citrix Machine Identity Service:
This service prepares the master image for a MCS-provisioned catalog. The service also manages each provisioned machine's unique Active Directory identity.
Command-line option: /exclude "Machine Identity Service" to prevent component installation
Default values in the graphical interface:
On the Delivery Controller page, select Do it manually. Enter the DNS name of an installed Cloud Connector and then click Add. If you've installed additional Cloud Connectors in the resource location, add their DNS names.
Command-line option: /controllers
On the Features page, use the check boxes to enable or disable features you want to use.
Valid only when installing a VDA on a VM, not a physical machine. When this feature is enabled (default), the optimization tool is used for VDAs running in a VM on a hypervisor. VM optimization includes disabling offline files, disabling background defragmentation, and reducing event log size. For details, see CTX125874.
Command-line option: /optimize
If you are using the VDAWorkstationCoreSetup.exe installer, this feature does not appear in the wizard and the command-line option is not valid. If you are using another installer in a Remote PC Access environment, disable this feature.
Use Windows Remote Assistance:
When this feature is enabled, Windows Remote Assistance is used with the user shadowing feature of the Director component in Citrix Cloud. Windows Remote Assistance opens the dynamic ports in the firewall. (Default = disabled)
Command-line option: /enable_remote_assistance
Use Real-Time Audio Transport for audio:
Enable this feature if voice-over-IP is widely used in your network. The feature reduces latency and improves audio resilience over lossy networks. It allows audio data to be transmitted using RTP over UDP transport. (Default = disabled)
Command-line option: /enable_real_time_transport
When this feature is enabled, bidirectional UDP ports 3224-3324 are opened. (Default = disabled)
You can change the port range later with the "Framehawk display channel port range" Citrix policy setting. You must then open local firewall ports. A UDP network path must be open on any internal (VDA to Citrix Receiver or NetScaler Gateway) and external (NetScaler Gateway to Citrix Receiver) firewalls. If NetScaler Gateway is deployed, Framehawk datagrams are encrypted using DTLS (default UDP port 443). For details, see the Framehawk article.
Command-line option: /enable_framehawk_port
AppDisk / Personal vDisk:
Valid only when installing a VDA for Desktop OS on a VM. This check box is available only if the Citrix AppDisk / Personal vDisk check box is selected on the Additional Components page. When this check box is enabled, AppDisks and Personal vDisks can be used.
Command-line option: /baseimage
If you are using the VDAWorkstationCoreSetup.exe installer, this feature does not appear in the wizard and the command-line option is not valid.
The Firewall page indicates which ports the VDA and Cloud Connectors use to communicate with each other. By default, these ports are opened automatically if the Windows Firewall Service is running, even if the firewall is not enabled. This default setting is fine for most deployments. For port information, see Network ports.
Command-line option: /enable_hdx_ports
The Summary page lists what will be installed. Use the Back button to return to earlier wizard pages and change selections.
When you're ready, click Install.
If prerequisites aren't already installed/enabled, the machine may restart once or twice. See Prepare to install.
On the Smart Tools page, choose whether to participate in Citrix Call Home, which is now a part of Citrix Smart Tools. If you choose to participate (the default), click Connect. When prompted, enter your Citrix account credentials.
After your credentials are validated (or if you choose not to participate), click Next.
The Finish page contains green check marks for all prerequisites and components that installed and initialized successfully.
Click Finish. By default, the machine restarts automatically. (Although you can disable this automatic restart, the VDA cannot be used until the machine restarts.)
Repeat the steps above to install VDAs on other machines or images, if needed.
After you install all VDAs:
Later, if you want to customize an installed VDA:
In the Studio display for a Delivery Group, the "Installed VDA version" entry in the Details pane might not be the version installed on the machines. The machine's Windows Programs and Features display shows the actual VDA version.
For a video of installing a VDA using the graphical interface, see the embedded video below, or at https://www.youtube.com/watch?v=Az3SjNa8jEY.