Installation overview

There are 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.

• Create Linux VDAs in Citrix Virtual Apps and Desktops Standard for Azure: You can create both domain-joined and non-domain-joined Linux VDAs in Citrix Virtual Apps and Desktops Standard for Azure to deliver virtual apps and desktops to any device from Microsoft Azure. For more information, see Create Linux VDAs in Citrix Virtual Apps and Desktops Standard for Azure.

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

• Use Citrix Provisioning to create Linux VMs: You can provision Linux virtual desktops directly in the Citrix Virtual Apps and Desktops environment. For more information, see Streaming Linux target devices in the Citrix Provisioning documentation.

• 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, Install Linux Virtual Delivery Agent for Ubuntu, and Install Linux Virtual Delivery Agent for Debian.

  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

You can use the Linux XDPing tool to check for common configuration issues with a Linux VDA environment. For more information, see XDPing.

Install .NET Core Runtime 3.1 as a prerequisite

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

After installing .NET Core Runtime 3.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 .NET binary path.