Product Documentation

Install Linux VDA

Sep 27, 2016

Install the Linux VDA software using:

For RHEL 6/CentOS 6:

command 複製

sudo yum install -y XenDesktopVDA-1.4.0.356-1.el6.x86_64.rpm

For RHEL 7.0:

command 複製

sudo yum install -y XenDesktopVDA-1.4.0.356-1.el7.x86_64.rpm

Install the Linux VDA software using the RPM package manager; before doing so, you must resolve the following dependencies before installation:

For RHEL/CentOS 6:

command 複製

sudo rpm -i XenDesktopVDA-1.4.0.356-1.el6.x86_64.rpm

For RHEL/CentOS 7:

command 複製

sudo rpm -i XenDesktopVDA-1.4.0.356-1.el7.x86_64.rpm

RPM dependency list for RHEL 6:

command 複製

postgresql-jdbc >= 8.4

postgresql-server >= 8.4

java-1.7.0-openjdk >= 1.7.0

ImageMagick >= 6.5.4.7

GConf2 >= 2.28.0

system-config-firewall-base >= 1.2.27

policycoreutils-python >= 2.0.83

xorg-x11-server-utils >= 7.7

xorg-x11-xinit >= 1.0.9

ConsoleKit >= 0.4.1

dbus >= 1.2.24

dbus-x11 >= 1.2.24

gnome-session >= 2.28.0

libXpm >= 3.5.10

libXrandr >= 1.4.1

libXtst >= 1.2.2

openmotif >= 2.3.3

pam >= 1.1.1

util-linux-ng >= 2.17.2

bash >= 4.1

findutils >= 4.4

gawk >= 3.1

sed >= 4.2

cups >= 1.4.0

foomatic >= 4.0.0

openldap >= 2.4

cyrus-sasl >= 2.1

cyrus-sasl-gssapi >= 2.1

libxml2 >= 2.7

RPM Dependency list for RHEL 7:

postgresql-server >= 9.2

postgresql-jdbc >= 9.2

java-1.8.0-openjdk >= 1.8.0

ImageMagick >= 6.7.8.9

firewalld >= 0.3.9

policycoreutils-python >= 2.0.83

dbus >= 1.6.12

dbus-x11 >= 1.6.12

xorg-x11-server-utils >= 7.7

xorg-x11-xinit >= 1.3.2

libXpm >= 3.5.10

libXrandr >= 1.4.1

libXtst >= 1.2.2

motif >= 2.3.4

pam >= 1.1.8

util-linux >= 2.23.2

bash >= 4.2

findutils >= 4.5

gawk >= 4.0

sed >= 4.2

cups >= 1.6.0

foomatic-filters >= 4.0.9

openldap >= 2.4

cyrus-sasl >= 2.1

cyrus-sasl-gssapi >= 2.1

libxml2 >= 2.9

Important

The Linux VDA package requires a specific Xorg version.

For RHEL 6.8 and RHEL 7.2, the Linux VDA requires Xorg-x11-server-Xorg Version 1.17; do not upgrade this package.

Upgrade the Linux VDA

If you have previously installed Versions 1.1 or 1.2 of the Linux VDA, upgrade the Linux VDA software using the RPM package manager:

For RHEL 6/CentOS 6:

command 複製

sudo yum install -y XenDesktopVDA-1.4.0.356-1.el6.x86_64.rpm

For RHEL/CentOS 7:

command 複製

sudo yum install -y XenDesktopVDA-1.4.0.356-1.el7.x86_64.rpm

Upgrade the Linux VDA software using the RPM package manager:

For RHEL/CentOS 6:

command 複製

sudo rpm -U XenDesktopVDA-1.4.0.356-1.el6.x86_64.rpm

For RHEL/CentOS 7:

command 複製

sudo rpm -U XenDesktopVDA-1.4.0.356-1.el7.x86_64.rpm

Important

You must reboot the Linux VDA machine after upgrading.

Configure the Linux VDA

After installing the package, you must configure the Linux VDA by running the ctxsetup.sh script. If you have upgraded the package, you must run the ctxsetup.sh script to finalize your upgrade. Before making any changes, this script will verify the environment and ensure all dependencies are installed. If nevessary, you can rerun this script at any time to change settings.

You can run the script manually with prompting, or automatically with preconfigured responses. Review Help about this script before proceeding:

command 複製

sudo /opt/Citrix/VDA/sbin/ctxsetup.sh –help

Prompted configuration

Run a manual configuration with prompted questions:

command 複製

sudo /opt/Citrix/VDA/sbin/ctxsetup.sh

Automated configuration

For an automated install, provide the options required by the setup script with environment variables. If all required variables are present, the script does not prompt for any information.

Supported environment variables include:

  • CTX_XDL_SUPPORT_DDC_AS_CNAME = Y | N - The Linux VDA supports specifying a Delivery Controller name using a DNS CNAME record. This is typically set to N.
  • CTX_XDL_DDC_LIST = list-ddc-fqdns – The Linux VDA requires a space-separated list of Delivery Controller Fully Qualified Domain Names.
  • (FQDNs) to use for registering with a Delivery Controller. At least one FQDN or CNAME alias must be specified.
  • CTX_XDL_VDA_PORT = port-number – The Linux VDA communicates with Delivery Controllers using a TCP/IP port. This is typically port 80.
  • CTX_XDL_REGISTER_SERVICE = Y | N - The Linux Virtual Desktop services support starting during boot. This is typically set to Y.
  • CTX_XDL_ADD_FIREWALL_RULES = Y | N – The Linux Virtual Desktop services require incoming network connections to be allowed through the system firewall. You can automatically open the required ports (by default ports 80 and 1494) in the system firewall for the Linux Virtual Desktop. This is typically set to Y.
  • CTX_XDL_AD_INTEGRATION = 1 | 2 | 3 – The Linux VDA requires Kerberos configuration settings to authenticate with the Delivery Controllers. The Kerberos configuration is determined from the installed and configured Active Directory integration tool on the system. Specify the supported Active Directory integration method to use:
    • 1 - Samba Winbind
    • 2 - Quest Authentication Service
    • 3 – Centrify DirectControl
  • CTX_XDL_HDX_3D_PRO = Y | N – Linux Virtual Desktop supports HDX 3D Pro, a set of graphics acceleration technologies designed to optimize the virtualization of rich graphics applications. HDX 3D Pro requires a compatible NVIDIA Grid graphics card to be installed. If HDX 3D Pro is selected, the Virtual Delivery Agent is configured for VDI desktops (single-session) mode – (i.e. CTX_XDL_VDI_MODE=Y). This is not supported on SUSE. Ensure this value is set to N.
  • CTX_XDL_VDI_MODE = Y | N - Whether to configure the machine as a dedicated desktop delivery model (VDI) or hosted shared desktop delivery model. For HDX 3D Pro environments, set this to Y. This is typically set to N.
  • CTX_XDL_SITE_NAME = dns-name – The Linux VDA discovers LDAP servers using DNS, querying for LDAP service records. To limit the DNS search results to a local site, specify a DNS site name. This is typically empty [none].
  • CTX_XDL_LDAP_LIST = list-ldap-servers – The Linux VDA by default queries DNS to discover LDAP servers. However if DNS cannot provide LDAP service records, you can provide a space-separated list of LDAP Fully Qualified Domain Names (FQDNs) with LDAP port (e.g. ad1.mycompany.com:389). This is typically empty [none].
  • CTX_XDL_SEARCH_BASE = search-base – The Linux VDA by default queries LDAP using a search base set to the root of the Active Directory Domain (e.g. DC=mycompany,DC=com). However to improve search performance, you can specify a search base (e.g. OU=VDI,DC=mycompany,DC=com). This is typically empty [none].
  • CTX_XDL_START_SERVICE = Y | N - Whether or not the Linux VDA services are started when the Linux VDA configuration is complete. This is typically set to Y.

Set the environment variable and run the configure script:

command 複製

export CTX_XDL_SUPPORT_DDC_AS_CNAME=Y|N

export CTX_XDL_DDC_LIST=list-ddc-fqdns

export CTX_XDL_VDA_PORT=port-number

export CTX_XDL_REGISTER_SERVICE=Y|N

export CTX_XDL_ADD_FIREWALL_RULES=Y|N

export CTX_XDL_AD_INTEGRATION=1|2|3

export CTX_XDL_HDX_3D_PRO=Y|N

export CTX_XDL_VDI_MODE=Y|N

export CTX_XDL_SITE_NAME=dns-name

export CTX_XDL_LDAP_LIST=list-ldap-servers

export CTX_XDL_SEARCH_BASE=search-base

export CTX_XDL_START_SERVICE=Y|N

sudo -E /opt/Citrix/VDA/sbin/ctxsetup.sh

You must provide the -E option with sudo to pass the existing environment variables to the new shell it creates. Citrix recommends that you create a shell script file from the commands above with #!/bin/bash on the first line.

Alternatively, you can specify all parameters with a single command:

command 複製

sudo CTX_XDL_SUPPORT_DDC_AS_CNAME=Y|N \

CTX_XDL_DDC_LIST=list-ddc-fqdns \

CTX_XDL_VDA_PORT=port-number \

CTX_XDL_REGISTER_SERVICE=Y|N \

CTX_XDL_ADD_FIREWALL_RULES=Y|N \

CTX_XDL_AD_INTEGRATION=1|2|3 \

CTX_XDL_HDX_3D_PRO=Y|N \

CTX_XDL_VDI_MODE=Y|N \

CTX_XDL_SITE_NAME=dns-name \

CTX_XDL_LDAP_LIST=list-ldap-servers \

CTX_XDL_SEARCH_BASE=search-base \

CTX_XDL_START_SERVICE=Y|N \

/opt/Citrix/VDA/sbin/ctxsetup.sh

Remove configuration changes

In some scenarios, you might have to remove the configuration changes made by the ctxsetup.sh script without uninstalling the Linux VDA package.

Review Help about this script before proceeding:

command 複製

sudo /opt/Citrix/VDA/sbin/ctxcleanup.sh --help

To remove configuration changes:

command 複製

sudo /opt/Citrix/VDA/sbin/ctxcleanup.sh

Important

This script will delete all configuration data from the database and will make the Linux VDA inoperable.

Configuration logs

The ctxsetup.sh and ctxcleanup.sh scripts display errors on the console, with additional information written to a configuration log file:

command 複製

/tmp/xdl.configure.log

Restart the Linux VDA services to have the changes take effect.