<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>JimMoyle.com &#187; ICA Client</title>
	<atom:link href="http://www.jimmoyle.com/category/ica-client/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.jimmoyle.com</link>
	<description>An insight into the world of desktop and application delivery</description>
	<lastBuildDate>Fri, 16 Jul 2010 15:11:13 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.9.2</generator>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
			<item>
		<title>Citrix XenApp ICA Client Installation, Tuning and Troubleshooting Guide</title>
		<link>http://www.jimmoyle.com/2009/08/citrix-xenapp-ica-client-installation-tuning-and-troubleshooting-guide/</link>
		<comments>http://www.jimmoyle.com/2009/08/citrix-xenapp-ica-client-installation-tuning-and-troubleshooting-guide/#comments</comments>
		<pubDate>Tue, 04 Aug 2009 20:43:22 +0000</pubDate>
		<dc:creator>Jim Moyle</dc:creator>
				<category><![CDATA[Citrix]]></category>
		<category><![CDATA[ICA Client]]></category>
		<category><![CDATA[Protocol]]></category>
		<category><![CDATA[Best Practice]]></category>
		<category><![CDATA[Installation]]></category>
		<category><![CDATA[Optimisation]]></category>
		<category><![CDATA[Tools]]></category>
		<category><![CDATA[Troubleshooting]]></category>
		<category><![CDATA[Tuning]]></category>

		<guid isPermaLink="false">http://www.jimmoyle.com/?p=61</guid>
		<description><![CDATA[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.]]></description>
			<content:encoded><![CDATA[<p><a href="http://jimmoyle.com/wordpress/wp-content/uploads/2009/08/CitrixReceiverIcon.jpg"><img style="border-right-width: 0px; display: inline; border-top-width: 0px; border-bottom-width: 0px; margin-left: 0px; border-left-width: 0px; margin-right: 0px" title="Citrix Receiver Icon" src="http://jimmoyle.com/wordpress/wp-content/uploads/2009/08/CitrixReceiverIcon_thumb.jpg" border="0" alt="Citrix Receiver Icon" width="131" height="132" align="left" /></a>Edit: This post is relevant up to 11.2, Citrix changed everything with 11.2 <img src='http://jimmoyle.com/wordpress/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' />  Look for an update sometime in the future.</p>
<p>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.</p>
<p>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 <strong>upgrade your clients!</strong></p>
<p>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.</p>
<p>For a complete list of the features included in the latest client have a look at the <a href="http://www.citrix.com/site/resources/dynamic/salesDocs/Citrix_Client-Feature-Matrix.pdf" target="_blank">Citrix Client Feature Matrix PDF</a>.  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.</p>
<p>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 <a href="http://support.citrix.com/article/CTX112613" target="_blank">CTX112613</a> will give you this information.</p>
<p>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:</p>
<blockquote><p>msiexec.exe /a XenAppHosted.msi</p></blockquote>
<p>This will give you all the options you need to create a silent installation package tailored to your enterprise ready for distribution.</p>
<p>If you run into issues with upgrading clients and need a clean machine for install you can use the <a href="http://gourami.eu/products/unica" target="_blank">free tool from Gourami</a> 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 <a href="http://support.citrix.com/article/CTX325140" target="_blank">CTX325140</a>.</p>
<p>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:</p>
<ul>
<li>Network routing</li>
<li>User Authentication</li>
<li>Remoting Client Devices</li>
<li>User Experience</li>
<li>Client Engine</li>
</ul>
<p>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 <a href="http://support.citrix.com/article/CTX075552" target="_blank">Troubleshooting ICA 32-bit and Web Client Connectivity CTX075552 article</a>.</p>
<p>At the time of publishing there is a <a href="http://www.citrix.com/English/ss/downloads/details.asp?downloadId=1690021">tech preview</a> 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: <a href="http://www.jimmoyle.com/2009/06/how-games-will-show-who-is-the-remote-protocol-winner/">How games will show who is the remote protocol winner</a>.</p>
<p>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.</p>
<table border="1" cellspacing="0" cellpadding="2" width="485">
<tbody>
<tr>
<td width="65" valign="top">Description</td>
<td width="217" valign="top">Key</td>
<td width="113" valign="top">Value Name</td>
<td width="89" valign="top">Value</td>
</tr>
<tr>
<td width="65" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">Automatically repair clipboard chain<br />
<a href="http://support.citrix.com/article/ctx112434">CTX112434</a></td>
</tr>
</tbody>
</table>
</td>
<td width="217" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">HKEY_LOCAL_MACHINE\SOFTWARE \Citrix\ICA Client\Engine\Configuration\Advanced \Modules\WFClient</td>
</tr>
</tbody>
</table>
</td>
<td width="113" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">CbChainInterval</td>
</tr>
</tbody>
</table>
</td>
<td width="89" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">&lt;value&gt; <em>0-2000 valid</em></td>
</tr>
</tbody>
</table>
</td>
</tr>
<tr>
<td width="65" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">Prevent long logon script time breaking session sharing</td>
</tr>
</tbody>
</table>
<p><a href="http://support.citrix.com/article/CTX114379">CTX114379</a></td>
<td width="217" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">HKEY_LOCAL_MACHINE\SOFTWARE \Citrix\ICA Client\Engine\Configuration\Advanced \Modules\WFClient\</td>
</tr>
</tbody>
</table>
</td>
<td width="113" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">ucConnTimeout</td>
</tr>
</tbody>
</table>
</td>
<td width="89" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">&lt;string value&gt; <em>needs to be &gt;20</em></td>
</tr>
</tbody>
</table>
</td>
</tr>
<tr>
<td width="65" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">Log the Launch.ica file to a Client Local File<br />
<a href="http://support.citrix.com/article/ctx115304">CTX115304</a></td>
</tr>
</tbody>
</table>
</td>
<td width="217" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">HKEY_LOCAL_MACHINE\SOFTWARE \Citrix\ICA Client\Engine\Configuration\Advanced \Modules\Logging</td>
</tr>
</tbody>
</table>
</td>
<td width="113" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">LogFile<em>=&lt;path to file to log to that you want, use following format C:\ica\ica.log&gt;</em></td>
</tr>
</tbody>
</table>
</td>
<td width="89" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">LogICAFile=true</td>
</tr>
</tbody>
</table>
</td>
</tr>
<tr>
<td width="65" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">Disable selected virtual channels from the client side<br />
<a href="http://support.citrix.com/article/CTX116890">CTX116890</a></td>
</tr>
</tbody>
</table>
</td>
<td width="217" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">HKEY_LOCAL_MACHINE\SOFTWARE \Citrix\ICA Client\Engine\Configuration\Advanced \Modules\ICA 3.0</td>
</tr>
</tbody>
</table>
</td>
<td width="113" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990"><em>Remove relevant value</em></td>
</tr>
</tbody>
</table>
</td>
<td width="89" valign="top"></td>
</tr>
<tr>
<td width="65" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">Revert to 9.x printing behaviour for a specific driver<br />
<a href="http://support.citrix.com/article/ctx115553">CTX115553</a></td>
</tr>
</tbody>
</table>
</td>
<td width="217" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">HKEY_LOCAL_MACHINE\Software \Citrix\ICA Client</td>
</tr>
</tbody>
</table>
</td>
<td width="113" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">ReprocessEMFDriverList</td>
</tr>
</tbody>
</table>
</td>
<td width="89" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990"><em>&lt;driver name&gt;</em></td>
</tr>
</tbody>
</table>
</td>
</tr>
<tr>
<td width="65" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">Allow more than 20 client files open from a client mapped drive</td>
</tr>
</tbody>
</table>
<p><a href="http://support.citrix.com/article/CTX117315">CTX117315</a></td>
<td width="217" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">HKEY_LOCAL_MACHINE\ SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced \Modules\ClientDrive</td>
</tr>
</tbody>
</table>
</td>
<td width="113" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">MaxOpenContext</td>
</tr>
</tbody>
</table>
</td>
<td width="89" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">&lt;value&gt; <em>eg 50</em></td>
</tr>
</tbody>
</table>
</td>
</tr>
<tr>
<td width="65" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">Prevent a seamless window from permanently hiding a minimized taskbar</td>
</tr>
</tbody>
</table>
<p><a href="http://support.citrix.com/article/CTX821811">CTX821811</a></td>
<td width="217" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">HKEY_LOCAL_MACHINE\ SOFTWARE\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Seamless Windows</td>
</tr>
</tbody>
</table>
</td>
<td width="113" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">TWIShrinkWorkArea</td>
</tr>
</tbody>
</table>
</td>
<td width="89" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">Value: 5</td>
</tr>
</tbody>
</table>
</td>
</tr>
<tr>
<td width="65" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">Allow Custom Virtual Channels in ICA after upgrading from an earlier client</td>
</tr>
</tbody>
</table>
<p><a href="http://support.citrix.com/article/CTX113279">CTX113279</a></td>
<td width="217" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">HKEY_LOCAL_MACHINE\ SOFTWARE\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Third Party\CustomVC</td>
</tr>
</tbody>
</table>
</td>
<td width="113" valign="top">VirtualChannels</td>
<td width="89" valign="top">“”</td>
</tr>
<tr>
<td width="65" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">How to use print screen in ICA sessions</td>
</tr>
</tbody>
</table>
<p><a href="http://support.citrix.com/article/CTX113344">CTX113344</a></td>
<td width="217" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">HKEY_LOCAL_MACHINE\ SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced \Modules\WFClient</td>
</tr>
</tbody>
</table>
</td>
<td width="113" valign="top">ICAPrntScrnKey</td>
<td width="89" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">&lt;value&gt; <em>eg F12</em></td>
</tr>
</tbody>
</table>
</td>
</tr>
<tr>
<td width="65" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">Make a seamless window the focus as soon as it activates</td>
</tr>
</tbody>
</table>
<p><a href="http://support.citrix.com/article/CTX112499">CTX112499</a></td>
<td width="217" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">HKEY_LOCAL_MACHINE\ Software\Citrix\ICA Client\Engine\Configuration\Advanced \Modules\WFClient</td>
</tr>
</tbody>
</table>
</td>
<td width="113" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td width="990">TWISeamlessFlag</td>
</tr>
</tbody>
</table>
</td>
<td width="89" valign="top">1</td>
</tr>
</tbody>
</table>
<p>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 <a href="http://support.microsoft.com/kb/949914">KB949914</a> on the server to stop your clients crashing.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.jimmoyle.com/2009/08/citrix-xenapp-ica-client-installation-tuning-and-troubleshooting-guide/feed/</wfw:commentRss>
		<slash:comments>6</slash:comments>
		</item>
	</channel>
</rss>
