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.

    Note:

    When using MCS to create Linux VMs, do not use easy install on the template VM.

  • 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.

Offline installation of .NET Core Runtime 2.1

If your VM does not have Internet access, prepare .NET Core Runtime 2.1 before installing the Linux VDA.

  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 a .NET Core Runtime 2.1 package in the Run apps – Runtime column. For RHEL 6/CentOS 6, choose RHEL 6 x64. For other platforms, choose x64. For an example, see the following screen capture.

    image of choosing a dotnet 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.

    For RHEL6/CentOS6:

    mkdir -p /aa/bb
    tar -C /aa/bb -xvf dotnet-runtime-2.1.12-rhel.6-x64.tar.gz
    

    For other platforms:

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

    wget http://download.icu-project.org/files/icu4c/57.1/icu4c-57_1-RHEL6-x64.tgz
    tar -xf icu4c-57_1-RHEL6-x64.tgz -C /
    

Then, 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.