Progress Kemp recommends configuring your Citrix Environment using PowerShell. The Progress Kemp PowerShell script is included in the zip file downloaded from the Citrix Virtual Apps and Desktops (StoreFront) web page. The PowerShell script currently requires the use of IP addresses to identify the StoreFront and VDA/VDI servers. In most scenarios we will need the full DHCP scope allocated for your VDA/VDI servers because a specific Secure Listener will be created for each VDA/VDI IP or FQDN.

Install the Progress Kemp PowerShell Module

For further information on the PowerShell API, refer to the PowerShell Interface Description.

You can download the PowerShell wrapper from this page: LoadMaster PowerShell API Wrapper.

You can verify the Kemp.LoadBalancer.Powershell module has been properly installed using the Microsoft PowerShell command GET-Module. You should see a module named Kemp.LoadBalancer.Powershell in the list of modules returned when executing this command.

Installing a New Citrix Workload

There are two Progress Kemp PowerShell scripts. One script will initially configure a LoadMaster for Citrix Virtual Apps and Desktops. The second script adds additional VDI servers to an existing Citrix environment. Both scripts are intended to be edited before they are run. There is a section titled Configure Variables in the script that needs to be updated to match your environment.

When the PowerShell script has completed, scroll through the log file for any HTTP Error Return Codes such as, 401 or 422. The log file is located in the current working PowerShell directory.

Before running the script to create the Citrix service, edit the script and modify the variables using the comments in the script for instructions.

In addition to modifying the script, ensure the following files are in the working directory:

  • Text file called vdiservers.txt containing all VDI server IP addresses or VDI FQDNs. It is recommended to include your full DHCP scope for your Citrix Machine Catalogue

  • Text file called storefront.txt containing the IP addresses of your StoreFront servers

  • TLS certificate in “.pfx” or “.p12” format to use for the Citrix service
  • If there are additional certificates in the validation chain, you must add these manually to the LoadMaster after running the script.

  • SAML configuration requires you to have your IDP Metadata XML file and your IDP token signing certificate

When you have finished the configuration, continue to the Citrix StoreFront Settings section.