Install the Linux VDA software using:
For RHEL 6/CentOS 6:
sudo yum install -y XenDesktopVDA-1.4.0.356-1.el6.x86_64.rpm
For RHEL 7.0:
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:
sudo rpm -i XenDesktopVDA-1.4.0.356-1.el6.x86_64.rpm
For RHEL/CentOS 7:
sudo rpm -i XenDesktopVDA-1.4.0.356-1.el7.x86_64.rpm
RPM dependency list for RHEL 6:
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
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.
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:
sudo yum install -y XenDesktopVDA-1.4.0.356-1.el6.x86_64.rpm
For RHEL/CentOS 7:
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:
sudo rpm -U XenDesktopVDA-1.4.0.356-1.el6.x86_64.rpm
For RHEL/CentOS 7:
sudo rpm -U XenDesktopVDA-1.4.0.356-1.el7.x86_64.rpm
You must reboot the Linux VDA machine after upgrading.
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:
sudo /opt/Citrix/VDA/sbin/ctxsetup.sh –help
Run a manual configuration with prompted questions:
sudo /opt/Citrix/VDA/sbin/ctxsetup.sh
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:
Set the environment variable and run the configure script:
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:
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
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:
sudo /opt/Citrix/VDA/sbin/ctxcleanup.sh --help
To remove configuration changes:
sudo /opt/Citrix/VDA/sbin/ctxcleanup.sh
This script will delete all configuration data from the database and will make the Linux VDA inoperable.
The ctxsetup.sh and ctxcleanup.sh scripts display errors on the console, with additional information written to a configuration log file:
/tmp/xdl.configure.log
Restart the Linux VDA services to have the changes take effect.