How to Create ICA Launch Files for High Availability Mode

How to Create ICA Launch Files for High Availability Mode

book

Article ID: CTX127392

calendar_today

Updated On:

Description

This article describes how to create an ICA Launch file for use in the XenDesktop’s High Availability mode.

Requirements

  • XenDesktop Version 5.0 or later

  • A desktop with the Virtual Desktop Agent Version 5.0 installed and with the High Availability feature enabled

  • The IP address of this desktop

  • The credentials of the user allowed to connect to this desktop includes:

  • Domain name

  • User logon name

  • User password

Instructions

To create an ICA Launch file, complete the following steps:

  1. Open Notepad on the client computer and copy and paste the following ICA lauch file content:

    [Encoding]
InputEncoding=UTF8

[ApplicationServers]
Desktop=

[Desktop]
Username=USER_LOGON_NAME_HERE
Clearpassword=USER_PASSWORD_HERE
Domain=DOMAIN_NAME_HERE
Address=DESKTOP_IP_ADDRESS_HERE:1494
AutologonAllowed=ON
BrowserProtocol=HTTPonTCP
CGPAddress=*:2598
ConnectionBar=1

TransportDriver=TCP/IP

ClientAudio=On
DesiredColor=8
DesiredHRES=1024
DesiredVRES=768
DoNotUseDefaultCSL=On

FontSmoothingType=0
InitialProgram=#Desktop
LPWD=31
Launcher=WI
LocHttpBrowserAddress=!

  2. Change the following fields:

    • USER_LOGON_NAME_HERE to the actual user’s logon name

    • USER_PASSWORD_HERE to the actual user’s clear text password

    • DOMAIN_NAME_HERE to the actual domain name

    • DESKTOP_IP_ADDRESS_HERE to the desktop’s IP address

  1. Save the file with .ICA extension on the client.

Environment

Caution! Using Registry Editor incorrectly can cause serious problems that might require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

Issue/Introduction

This article describes how to create a ICA launch file for connecting to XenDesktop VDAs that have entered high availability mode

Additional Information

CTX122536 – Citrix Quick Launch

CTX331178 – Appsrv.ini Parameters Deciphered

Password= Specifies the password for the user account.

This is an optional field. The password, if used, must be encrypted. To enter an encrypted password into the ICA file, use the Citrix Program Neighborhood version 11.0 or earlier and use the Custom Connection Wizard to create a new entry. When you are prompted for the username and password, type the password that you want to use in the ICA file. Complete the wizard. Open the APPSRV.INI file in the Windows directory and locate the entry you just created. Copy the password value and paste it into your ICA file.

Caution! Refer to the Disclaimer at the end of this article before using Registry Editor.

Create the following registry key on the Virtual Desktop Agent computer to allow the connection to occur when using XenDesktop 5 if the password field is ignored in the ICA file.

Registry location
HKLM\Software\Policies\Citrix
EnforceAutoLogon REG_DWORD 0

Powered by Wolken Software