Edit: This post is relevant up to 11.2, Citrix changed everything with 11.2
Look for an update sometime in the future.
Generally the ICA client doesn’t get much attention, undeservedly so in my opinion. So I decided to make this guide as a quick reference sheet for all you need to know about the Windows client for Citrix XenApp.
Most people install the client when they set up their first farm and forget about it, maybe upgrading with a major server refresh. The people who leave old clients on their desktop estate are missing out on a whole lot of functionality. So my first and most basic bit of advice is to upgrade your clients!
As the first bit of advice is to upgrade I’ll show you how to best do that below. The rest of this post will only be relevant for clients from 10.2 onwards, if you have an earlier client, I’m sorry, but this post isn’t for you.
For a complete list of the features included in the latest client have a look at the Citrix Client Feature Matrix PDF. Hopefully the new cool stuff (and the weird errors from supporting a mess of clients) has persuaded you to upgrade your desktop estate to the latest client which at the time of writing is the ‘XenApp Plugin for Hosted Apps’ 11.000.
A lot of administrators don’t even know which client versions they have out there, and unfortunately Citrix doesn’t help you very much in this regard, as it only shows the build numbers for connected clients and not the version numbers i.e. version 10.2 shows up as 02650. In XenApp 5.0 and later, this client build number can be seen by selecting the user session in the Access Management Console and selecting the Client Build Number column. So now you need to know what the build numbers mean. The knowledge base article CTX112613 will give you this information.
Obviously once you have decided to upgrade your clients you need a way to distribute them. To do this your standard software distribution method will be fine. To create a silent installation download the latest client to your local drive and run the following command:
msiexec.exe /a XenAppHosted.msi
This will give you all the options you need to create a silent installation package tailored to your enterprise ready for distribution.
If you run into issues with upgrading clients and need a clean machine for install you can use the free tool from Gourami to remove all traces of the client from 2000/XP/Vista or Windows 7 machines. If you aren’t comfortable with the tool you can use CTX325140.
So, now you have an estate of updated clients, but you need more granular control over the client behaviour. You can get this by using a GPO, first you need to import the handy icaclient.adm administrative template. You can usually find it in “C:\Program Files\Citrix\ICA Client\Configuration”. With this template you can control almost all aspects of the client behaviour, with the one weird exception being that you cannot manage the pnagent url. The main topics in the template are:
- Network routing
- User Authentication
- Remoting Client Devices
- User Experience
- Client Engine
In most cases this should be enough to sort out most of your problems, if you have any niggling connectivity issues you should use the Troubleshooting ICA 32-bit and Web Client Connectivity CTX075552 article.
At the time of publishing there is a tech preview of flash remoting available on Citrix’s website, all I can say is it works superbly given the restrictions of the fact it is beta code. Stick it in your test environment and have a go. For more information on the future of protocols see my previous post: How games will show who is the remote protocol winner.
Finally, I have some tuning tips for your environment, I think most of these should probably be in the icaclient.adm file, but we’ll see if they make it into a future release. If anybody has any more client side tips, please let me know in the comments and I’ll add them to the table.
| Description |
Key |
Value Name |
Value |
Automatically repair clipboard chain
CTX112434 |
|
| HKEY_LOCAL_MACHINE\SOFTWARE \Citrix\ICA Client\Engine\Configuration\Advanced \Modules\WFClient |
|
|
|
| Prevent long logon script time breaking session sharing |
CTX114379 |
| HKEY_LOCAL_MACHINE\SOFTWARE \Citrix\ICA Client\Engine\Configuration\Advanced \Modules\WFClient\ |
|
|
| <string value> needs to be >20 |
|
Log the Launch.ica file to a Client Local File
CTX115304 |
|
| HKEY_LOCAL_MACHINE\SOFTWARE \Citrix\ICA Client\Engine\Configuration\Advanced \Modules\Logging |
|
| LogFile=<path to file to log to that you want, use following format C:\ica\ica.log> |
|
|
Disable selected virtual channels from the client side
CTX116890 |
|
| HKEY_LOCAL_MACHINE\SOFTWARE \Citrix\ICA Client\Engine\Configuration\Advanced \Modules\ICA 3.0 |
|
|
|
Revert to 9.x printing behaviour for a specific driver
CTX115553 |
|
| HKEY_LOCAL_MACHINE\Software \Citrix\ICA Client |
|
|
|
| Allow more than 20 client files open from a client mapped drive |
CTX117315 |
| HKEY_LOCAL_MACHINE\ SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced \Modules\ClientDrive |
|
|
|
| Prevent a seamless window from permanently hiding a minimized taskbar |
CTX821811 |
| HKEY_LOCAL_MACHINE\ SOFTWARE\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Seamless Windows |
|
|
|
| Allow Custom Virtual Channels in ICA after upgrading from an earlier client |
CTX113279 |
| HKEY_LOCAL_MACHINE\ SOFTWARE\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Third Party\CustomVC |
|
VirtualChannels |
“” |
| How to use print screen in ICA sessions |
CTX113344 |
| HKEY_LOCAL_MACHINE\ SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced \Modules\WFClient |
|
ICAPrntScrnKey |
|
| Make a seamless window the focus as soon as it activates |
CTX112499 |
| HKEY_LOCAL_MACHINE\ Software\Citrix\ICA Client\Engine\Configuration\Advanced \Modules\WFClient |
|
|
1 |
Lastly, although this is not strictly a client side change, if you are accessing a XenApp Server on Windows 2008 with a client version less than 11.0 you will need to install KB949914 on the server to stop your clients crashing.
August 20th, 2009 at 10:41 pm
[...] Moyle has written a nice guide to deploying, tuning and troubleshooting ICA [...]
August 27th, 2009 at 12:57 pm
The UNICA tool from Gourami really rocks!, I saved me hours removing old versions of ICA clients installed. We didn’t know what versions we had, some clients even had 2 or 3 ICA clients installed!
August 28th, 2009 at 2:42 pm
Glad you found it useful
December 17th, 2009 at 11:44 am
Jim, great Article however most admins are still struggling which client to use with which product because name changes of citrix products recently, when it comes to downloading and installing clients for earlier version products on windows 7.
March 6th, 2010 at 12:15 pm
This is a really useful article, which I can certainly use for our own project – many thanks for this!
I do need to restrict the priveleges under which the ica client runs, perhaps by running the wfica.exe under an less priveleged account. Do you have any tips for achieving this or a similar lockdown of the Citrix client?
Thanks
May 20th, 2010 at 10:27 am
Hey Jim, This is useful info, you might want to update the client feature matrix link to http://www.citrix.com/clientfeaturematrix it’s moved again! Cheers A.