Installation overview

There are three options for you to install the Linux VDA. You can do a fresh installation or upgrade an existing installation from the previous two versions and from an LTSR release.

  • Easy install. After installing the Linux VDA package on a machine, you can configure the running environment by using the ctxinstall.sh script. For more information, see Easy install.

  • MCS. You can use MCS to create Linux VMs in batches where the Linux VDA package is also installed. For more information, see Use MCS to create Linux VMs.

  • Manual installation. You can use the following general steps to install the Linux VDA. Variations and specific commands are documented by distribution. For more information, see Install Linux Virtual Delivery Agent for RHEL/CentOS, Install Linux Virtual Delivery Agent for SUSE, and Install Linux Virtual Delivery Agent for Ubuntu.

    1. Prepare for installation.
    2. Prepare the hypervisor.
    3. Add the Linux virtual machine (VM) to the Windows domain.
    4. Install the Linux VDA.
    5. Configure the Linux VDA.
    6. Create the machine catalog in Citrix Virtual Apps or Citrix Virtual Desktops.
    7. Create the delivery group in Citrix Virtual Apps or Citrix Virtual Desktops.

XDPing

We provide a command-line utility, the Linux XDPing tool, to check for common configuration issues with a Linux VDA environment. You can install the XDPing package on any machine running a supported Linux distribution. XDPing does not require the Linux VDA package to be installed on the machine. For more information about the tool, see Knowledge Center article CTX202015.

Install .NET Core Runtime 2.1 as a prerequisite

Before installing the Linux VDA, install .NET Core Runtime 2.1 according to the instructions at https://docs.microsoft.com/en-us/dotnet/core/install/linux-package-managers.

After installing .NET Core Runtime 2.1, run the which dotnet command to find your runtime path.

Based on the command output, set the .NET Core runtime binary path. For example, if the command output is /aa/bb/dotnet, use /aa/bb as the dotnet binary path.