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.

Install NET Core Runtime 2.1 on RHEL 6/CentOS 6

  1. On a machine that has Internet access, download a .NET Core Runtime 2.1 package from the Microsoft official page at https://dotnet.microsoft.com/download/dotnet-core/2.1.

    Choose the appropriate .NET Core Runtime 2.1 package in the Run apps – Runtime column. For RHEL 6/CentOS 6, choose RHEL 6 x64.

    image of choosing a .NET runtime

  2. Copy the downloaded package to your VM.
  3. On your VM, run the following commands to extract and install the package to a target path, for example, /aa/bb.

    mkdir -p /aa/bb
    tar -C /aa/bb -xvf dotnet-runtime-2.1.12-rhel.6-x64.tar.gz
    
  4. To run .NET Core Runtime 2.1 on RHEL 6/CentOS 6, run the following commands.

    wget https://github.com/unicode-org/icu/releases/download/release-57-1/icu4c-57_1-RHEL6-x64.tgz
    tar -xf icu4c-57_1-RHEL6-x64.tgz -C /
    

Later on when you run ctxinstall.sh, ctxsetup.sh, or update MCS settings through mcs.conf, specify the runtime installation path to where you installed it. In this example, /aa/bb.