Citrix Systems, Inc. Read Me ======= ICA Win32 Clients (ICA 32-bit Windows Clients) for Citrix MetaFrame Application Server product family Products: ICA Win32 Program Neighborhood Agent (Ica32a.exe, Ica32a.msi) ICA Win32 Program Neighborhood Client (Ica32.exe, Ica32.msi) ICA Win32 Web Client (Ica32t.exe) Version: 6.30 Replaces: All versions prior to May 2002 Date: May 2002 Language: English (US) Copyright 2001-2002, Citrix Systems, Inc. All rights reserved. Introduction ============ This document contains last-minute information about the ICA Win32 Clients. Where to Find Documentation =========================== For more information about the ICA Win32 Clients, see the ICA Win32 Clients Administrator's Guide (ICA_Win32_Guide.pdf), located in the ICAClientDoc folder of your Components CD. Use the Adobe Acrobat Reader or Exchange program to view PDF files. You can download Acrobat Reader for free from the Adobe Web site at http://www.adobe.com/. For the latest updates to Citrix documentation, visit the Citrix Web site at http://www.citrix.com/. Viewing or Printing this Document ================================= When viewing this document in Notepad, if the text does not wrap in the window, choose Edit > Word Wrap (Windows NT 4) or Format > Word Wrap (Windows 2000). Before printing this document, adjust the window width to fit your printer paper. To print the document, choose File > Print. Overview of the ICA Win32 Clients ================================= ICA Clients are the client-side software components of the MetaFrame Application Server product family. Combining the ease of use you expect with the security features you require, ICA Clients offer point-and-click, secure access to applications, content, and entire computer desktops published on MetaFrame servers. Each ICA Win32 Client offers a robust and easy-to-manage solution for delivering your published resources to 32-bit Windows desktops. To decide which ICA Client or ICA Clients best fits your needs, see Chapter 2 of the ICA Win32 Clients Administrator's Guide (ICA_Win32_Guide.pdf), located in the ICAClientDoc folder of your Components CD. Supported Windows Operating Systems ----------------------------------- The ICA 32-bit Windows Clients support the following platforms: Windows XP Windows 2000 Windows Me Windows 98 Windows 95 Windows NT 4.0 Windows NT 3.51 (ICA Win32 Program Neighborhood Client and Web Client only) ICA Win32 Program Neighborhood Agent ------------------------------------ If you want users to access your published resources entirely from within their familiar Windows desktop environment, use the ICA Win32 Program Neighborhood Agent: In conjunction with NFuse Classic, you can transparently integrate your published resources with users’ desktops. Users access your resources by clicking icons on their Windows desktop, in the Start menu, in the Windows System Tray, or any combination thereof. The configuration data for all Program Neighborhood Agents is defined in a single configuration file. As a result, you can dynamically manage and control your client population network-wide from a single location and in real time. ICA Win32 Web Client -------------------- If you want users to access your published resources from within their familiar Web browser, use the ICA Win32 Web Client: You can use the ICA Web Client with NFuse Classic to create an application portal on your corporate intranet or the Internet that presents users with links to your published resources. Users access your portal with a standard Web browser. The ICA Web Client provides the engine needed to launch published applications. ICA Win32 Program Neighborhood Client ------------------------------------- If you want users to access your published resources without NFuse Classic, use the ICA Win32 Program Neighborhood Client: Using the ICA Program Neighborhood Client, users browse for application sets or create custom ICA connections to MetaFrame servers or to individual published resources. Icons representing application sets and custom ICA connections appear in the ICA Client’s Program Neighborhood window. You can configure numerous settings before you deploy the client software to users. This allows users to install the client and begin using it immediately, without having to configure settings. Version 6.30 Feature Highlights =============================== Version 6.30 of the ICA Win32 Clients provides native support for MetaFrame XP 1.0 for Windows, Feature Release 2, Service Pack 2, and for the Windows 2000 and Windows XP operating systems. It introduces a wide range of new features and performance improvements, and is fully backward compatible with earlier versions of Windows and MetaFrame. New Features of Version 6.30 ---------------------------- 1. User-to-User Shadowing * 2. Smart Card Support * 3. Content Redirection * 4. Enhanced Content Publishing * 5. Support for Citrix NFuse 6. Support for TLS Encryption of ICA Traffic 7. Support for Citrix Secure Gateway 1.1 8. Enhanced Internet Proxy Support 9. Roaming User Reconnect * * Features marked with an asterisk (*) require the MetaFrame XP server to be licensed for Feature Release 2. Features not so marked require Service Pack 2 for MetaFrame XP to be installed. In addition to offering a range of new features, Version 6.30 of the ICA Win32 Clients provides you with performance enhancements in the following areas: Increased ICA Performance Enhanced printer support and management Program Neighborhood Agent usability improvements Installation Instructions for the ICA Win32 Clients =================================================== For step-by-step instructions for installing the ICA Win32 Clients, see the ICA Win32 Clients Administrator's Guide (ICA_Win32_Guide.pdf), located in the ICAClientDoc folder of your Components CD. Note: To install the ICA Client software using the Windows Installer (.Msi) package, the Windows Installer Service must be installed on the client device. This service is present by default on Windows 2000 systems. To install ICA Clients on client devices running earlier versions of the Windows operating system, you must use the self-extracting executable or install the Windows Installer 2.0 Redistributable for Windows, available for download at http://www.microsoft.com/. Limitations and Known Issues ============================ 1. Multiple monitor support limitations When running an ICA session on a computer with multiple monitors running at different color depths, moving the ICA session window between monitors corrupts the display. Workaround: Set all monitors to the same color depth. When running an application in seamless mode on a computer with multiple monitors, the application may open a desktop window that covers the entire screen area, across displays. Workaround: - The numbered displays must appear in ascending order (1-2-3) - The left-most display must be marked as the primary display - The extreme upper-left pixel of the virtual desktop must not be covered by any other display. 2. Netscape If you install a Web browser after installing the ICA Win32 Web Client, you must reinstall the ICA Win32 Web Client if you are using the Netscape Plugin. The Netscape Plugin must be registered with the browser so that when you select an ICA file in an HTML file, the browser knows what to run to invoke the ICA file. If you uninstall the ICA Win32 Client shortly after using Netscape to connect to a published application using NFuse, the Npican.dll file is not removed from the Netscape Plugin folder. As a result, the Nfuse Login page does not display the ICA Client download links. Workaround: Manually remove the Npican.dll file, or reinstall the ICA Win32 Client using a method other than the NFuse Login page. If you are using Netscape 6.x, and if you download and install the Netscape Plugin Client (Wfplug32.exe) from an ICA file or from an HTML page, the Npican.dll file installs into the wrong folder of your client device. As a result, Netscape does not recognize that the plugin was installed. Workaround: Locate and copy the file Npican.dll to the following folder: Program Files\Netscape\Netscape6\Plugins. 3. Pass-through authentication with higher than Basic encryption level in mixed version MetaFrame server/ICA Client environments If you want to use pass-through authentication along with an encryption level higher than Basic, -and- If you are connecting to a server running MetaFrame XP, Version 1.0, Feature Release 2, Service Pack 2 (the version included with this Feature Release of MetaFrame XP), using an ICA Client earlier than Version 6.30 -or- If you are connecting to a server running a version earlier than MetaFrame XP, Version 1.0, Feature Release 2, Service Pack 2, using an ICA Client Version 6.30 (the version included with this Feature Release of MetaFrame XP) You must add the following line to the Appsrv.ini file: AutoLogonAllowed=on 4. You cannot connect to a MetaFrame server using the IPX, SPX, or NetBIOS protocols after installing Version 6.30 of the ICA Win32 Client (the version included with this Feature Release of MetaFrame XP) in the following circumstances: * If you install Version 6.30 of the ICA Win32 Client on a client device and then install an earlier version of the ICA Win32 Client. Attempting to connect using the earlier version of the ICA Win32 Client fails. * If you install and then uninstall Version 6.30 of the ICA Win32 Client and then install an earlier version of the ICA Win32 Client. 5. To use Version 6.30 of the ICA Win32 Client with MetaFrame for Windows Version 1.8 on Windows 2000 servers, the server must be running Service Pack 2 for MetaFrame 1.8. If you use Version 6.30 of the ICA Win32 Client to connect to a MetaFrame 1.8 server that is at Service Pack level 1, the connection will be dropped the next time you attempt to connect. 6. If the color depth of your local desktop is set to High or True Color, running a 256-color ICA Client session causes a bold border around modified cells in Microsoft Excel 97 and Excel 2000. Workaround: Adjust the color depth of your local desktop to match that of the ICA Client. 7. You can reduce a Win32 Client session window to a minimum of 64 pixels in width. However, the Windows operating system may enforce a greater limit based on the prevailing desktop scheme, which overrides the ICA Win32 Client scaling limit. 8. On ICA Win32 client devices running Windows 9x or Windows Me, Off Screen Surface (OSS) functionality is disabled by default. OSS functionality directs the ICA Client to draw screen updates to an in- memory bitmap rather than to the screen. Because this functionality improves bandwidth efficiency, you may want to enable it if users connect to MetaFrame servers across a WAN. To enable OSS functionality before you deploy the ICA Win32 Client software to users: A. Extract the ICA Win32 Client files from the ICA Win32 Client executable (.Exe). B. Open Module.ini in any text editor. C. Change the line EnableOssOnWin9xMe= in the [Thinwire3.0] section to EnableOssOnWin9xMe=on. D. Save and close Module.ini. E. Repackage the ICA Win32 Client files for distribution to your users. 9. On low-end client devices or systems running multiple, simultaneous ICA connections, CPU utilization may run higher than expected when there is no activity between the client and the server. Workaround: Change the poll time-out value on the client device. The default poll time-out value is 1 millisecond. To enter a greater poll time-out value: A. Open the individual’s user-level Appsrv.ini file (default folder: %User Profile%\Application Data\ICAClient) in a text editor. B. Add the following parameter to the [WFCLIENT] section: IdlePollDelay=n where n is the desired polling interval, in milliseconds. C. Save and close the Appsrv.ini file. 10. If you have both the ICA Win32 Program Neighborhood Agent and the ICA Win32 Program Neighborhood Client on the same client device, and if you uninstall the ICA Win32 Program Neighborhood Agent, file type association for .ica-type files is lost. As a result, the ICA Client is unable to connect to MetaFrame servers. Workaround: To restore file type association for .ica-type files, type the following command at a command prompt: wfica32.exe /setup 11. If you want to use Citrix Extranet with the Program Neighborhood Agent on a Windows 95, Windows 98, or Windows Me system, you must use Version 2.5 of both the Extranet Client and the Extranet Server. Earlier versions of Citrix Extranet installed on a client device running Windows 9x can cause the Program Neighborhood Agent to hang, even if you are not using Extranet when you are running the Program Neighborhood Agent. 12. When you double-click a file whose filename contains spaces, the extended parameter passing feature may open the associated published application, but not the file itself. Workaround: Open the file by browsing to it from within the application's File > Open... dialog. 13. For users of NFuse Version 1.5: If you have populated the Client Update Database with the ICA Clients from the Components CD included in your MetaFrame XP media pack, users may receive unnecessary update notifications. The client detection code of an NFuse 1.5 Web site (either a site produced by the NFuse 1.5 Web Site wizard or an example Web site provided by Citrix) may incorrectly notify the user that the client device does not have the latest ICA Client installed, and prompt the user to update the ICA Client. Workaround: Select the Do not show this window at login option in the update message box to prevent the message from appearing again. The client detection process was corrected with the release of Nfuse Version 1.51. You can also download NFuse Classic from the Citrix Web site at http://www.citrix.com/download/. 14. Roaming User Reconnect does not work in multiple-server MetaFrame XPs deployments. 15. If you cannot use Citrix Secure Gateway or otherwise connect to a MetaFrame server through a Secure proxy using SSL, particularly Microsoft ISA Server 2000, you will most likely need to change your proxy server or firewall configurations to allow non-SSL tunneled connections to the targeted MetaFrame server(s) and port(s). Consult your proxy server or firewall documentation for details. 16. "Seamless within seamless" (that is, seamless windows via pass-through mode) is not a supported configuration for the ICA Win32 Clients. Because the ICA Win32 Clients support seamless windows natively, it is not necessary to use pass-through mode. Pass-through mode is intended to facilitate seamless windows for ICA Clients that do not support seamless windows natively, and should only be used from a fixed-size window session on the client device. 17. The Program Neighborhood Agent cannot connect to the NFuse Classic server through a proxy server if the proxy server has authentication turned on. Workaround: Turn authentication off on the proxy server. 18. On Windows 98 systems using Microsoft Internet Explorer, server-to-client content redirection requires Internet Explorer Version 5.5 with Service Pack 2. 19. If you are logged on using pass-through authentication (with credentials set A), and then want to log on with a different set of credentials (set B), you must log off the ICA Client and log on again for the client to pass credentials set B to the server. CONTACT INFORMATION =================== Citrix Systems, Inc. 6400 NW 6th Way Fort Lauderdale, Florida 33309 USA 954-267-3000 http://www.citrix.com