Citrix Virtual Apps and Desktops

Install VDAs using Ansible

July 5, 2024

Contributed by:

Overview

This article describes how to deploy VDAs using Ansible. For more information, see the Ansible documentation.

Note:

This article describes only recommendations based on how Citrix has tested the environment. You can customize these steps according to your needs. Citrix is not responsible for any updates or tweaks needed to this to fit customer needs.

Key steps to deploy VDA using Ansible

Configure the virtual machine environment.
Install Ansible
Kerberos Configuration
1. Install Kerberos
2. Configure Kerberos
Configure Ansible

Step 1: Configure the virtual machine environment

Run the following commands on the Windows server.

Set PS RemoteSigned. Set-ExecutionPolicy RemoteSigned
Set WinRM to use unencrypted: winrm set winrm/config/service '@{AllowUnencrypted="true"}'

Note:

If an error occurs in this step, use the following command: Enable-PSRemoting -Force
Open the firewall port 5985. New-NetFirewallRule -DisplayName "Allow WinRm port 5985" -Direction Inbound -Profile Any -Action Allow -LocalPort 5985 -Protocol tcp

Step 2: Install Ansible

To install Ansible with Ubuntu 20.4 or later, run the following commands:

sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository --yes --update ppa:ansible/ansible
sudo apt install ansible
sudo apt install python3-pip

Step 2i: Install Kerberos

To install Kerberos, run the following command.

sudo apt install python3-dev libkrb5-dev krb5-user

Step 2ii: Configure Kerberos

To configure Kerberos, run the following command:

Edit /etc/krb5.conf

Configuring Kerberos

Note:

Use upper case letters for the Kerberos realm name.

Configure Kerberos2

Step 3: Configure Ansible

To configure the Ansible host, complete the following steps:

Run the following command:

Edit /etc/ansible/hosts
Configure a Delivery Controller Install.yaml file

/QUIET /NOREBOOT /NORESUME /OPTIMIZE /VERBOSELOG /COMPONENTS VDA /CONTROLLERS 'MyDDC.xd.local' /ENABLE_HDX_PORTS /ENABLE_REAL_TIME_TRANSPORT

Delivery Controller

Run the yaml file with the following command: sudo ansible-playbook install.yml -vvv (Verbose mode)
You can configure multiple hosts in the config file with other additional configurations.

Edit /etc/ansible/hosts

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Install VDAs using Ansible

July 5, 2024

Contributed by:

July 5, 2024

Contributed by:

Install VDAs using Ansible

Overview

Key steps to deploy VDA using Ansible

Step 1: Configure the virtual machine environment

Step 2: Install Ansible

Step 2i: Install Kerberos

Step 2ii: Configure Kerberos

Step 3: Configure Ansible

In this article