Installation Guide Feature Release 1 and Service Pack 3 for Citrix MetaFrame for Windows Version 1.8 Citrix Systems, Inc.
Information in this document is subject to change without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Citrix Systems, Inc. © 1997-2001 Citrix Systems, Inc. All rights reserved.
Contents Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Installing Service Pack 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Installing the Feature Release 1 License. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 URL to Use for Software Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Features Included in Feature Release 1 . . .
Feature Release 1 and Service Pack 3 Installation Guide Hotfix Mx182W013. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hotfix Mx182W014. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hotfix Mx182W015. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hotfix Mx182W016. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hotfixes for MetaFrame 1.
Contents MetaFrame 1.8 for Windows NT 4.0 Server, Terminal Server Edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hotfix Mx181T001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hotfix Mx181T002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hotfix Mx181T003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hotfix Mx181T004 . . . . . . . . . .
Feature Release 1 and Service Pack 3 Installation Guide Hotfix Mx180023 Hotfix Mx180024 Hotfix Mx180025 Hotfix Mx180028 Hotfix Mx180029 Hotfix Mx180030 Hotfix Mx180031 Hotfix Mx180032 Hotfix Mx180033 Hotfix Mx180034 Hotfix Mx180036 Hotfix Mx180037 Hotfix Mx180038 ............................................. ............................................. ............................................. ............................................. ............................................. .............
Introduction Welcome to Feature Release 1 and Service Pack 3 for MetaFrame 1.8 for Windows NT 4.0, Terminal Server Edition and Windows 2000 Servers. Service Pack 3 provides fixes for known issues in MetaFrame 1.8. Feature Release 1 provides enhancements for MetaFrame 1.8. Feature Release 1 is enabled by installing and activating the Feature Release 1 license. Contact your Citrix software distributor for purchasing information about Feature Release 1.
Feature Release 1 and Service Pack 3 Installation Guide " To download the service pack 1. Using your Web browser, connect to http://citrix.com/support. Click the Software Updates tab. 2. Select either MetaFrame 1.8 for Microsoft Windows 2000 or MetaFrame 1.8 for Windows NT Terminal Server from the drop-down list and then click GO! 3. Select the appropriate language. Service Pack 3 is available in English, French, German, Spanish, and Japanese. 4. Select Service Pack 3 and download the files you require.
Introduction " 9 To install the updated ICA Clients from the service pack CD-ROM This procedure updates the ICA Client in the Client Update Database and the ICA Client disk creator database. 1. Insert the MetaFrame 1.8 Service Pack 3 CD-ROM in the CD-ROM drive. If your CD-ROM drive supports Autorun, the service pack installation splash screen automatically appears. If the splash screen does not automatically appear, from the Start menu, click Run and type d:\autorun.
Feature Release 1 and Service Pack 3 Installation Guide " To activate your Feature Release 1 license 1. Log on to your MetaFrame server as an administrator. 2. From the Start menu, point to Programs, point to MetaFrame Tools (Common), and then click Citrix Licensing. Citrix Licensing displays the license numbers for the base server license and any additional services licenses. These are the license numbers you must provide to Citrix to get activation codes. 3.
Introduction 11 ! Save ICA session starting position - Version 6.01 of the ICA Client saves the position of ICA session windows between sessions. The window for new connections is displayed in the same location where the previous connection was running. ! Multi-monitor support - Version 6.01 of the ICA Win32 Client supports the multi-monitor features of Microsoft Windows 98 and Windows 2000 clients.
Configuration and Usage Instructions The following sections contain configuration and usage instructions for the enhancements in Feature Release 1. To enable these features before configuration, you must install and activate the Feature Release 1 license. Multi-Monitor Limitations ! To run seamless ICA sessions on a multi-monitor system, the primary monitor must be the left-most and top-most monitor.
Feature Release 1 and Service Pack 3 Installation Guide Citrix XML Service The Service Pack 3 installation gives you the option to enable and configure the Citrix XML Service. The Citrix XML Service provides published application data to ICA Clients using the TCP+HTTP network protocol and to NFuseenabled Web servers. To support NFuse, the XML Service must be installed on all MetaFrame servers to which clients connect.
Configuration and Usage Instructions 15 To configure the SSL Relay, you must complete the following steps: 1. Obtain a server certificate. 2. Change the SSL Relay port number, if necessary. 3. Install a server certificate. 4. Select the ciphersuites to allow. See the application help for the SSL Relay Configuration tool for instructions. 5. Change the target address or port, or add additional addresses for redundancy. See the application help for the SSL Relay Configuration tool for instructions.
Feature Release 1 and Service Pack 3 Installation Guide " To change the SSL port for Internet Information Server Version 5.0 1. Run Internet Services Manager. 2. Click the plus sign next to the Web site in the left pane. 3. Right-click Default Web Site and then select Properties. The Default Web Site Properties dialog box appears. 4. Select the Directory Security tab. 5. Click Server Certificate. The Welcome to the Web Server Certificate Wizard appears. 6.
Configuration and Usage Instructions " 17 To install a PEM-formatted server certificate 1. Copy the file to the \certs subdirectory of the keystore directory (%SystemRoot%\sslrelay\keystore, by default). 2. On the taskbar, click the Start button and then click Programs. 3. Click MetaFrame Tools (Common) and then click Citrix SSL Relay Configuration Tool. 4. On the Relay Credentials tab, select your server certificate from the Server Certificate list. 5.
Feature Release 1 and Service Pack 3 Installation Guide Thinwire 2 Configuration Service Pack 3 includes a new version of the Thinwire protocol for displaying ICA session graphics. Service Pack 3 includes a command-line utility for tuning global Thinwire 2 settings. Syntax twconfig /query twconfig [/discard:on|off] [supercache:on|off] [/maxmem:nnn] [/degrade:res|color] [/notify:on|off] twconfig /reset twconfig /? Options /query Query current settings.
Configuration and Usage Instructions 19 Within the maxmem limit, a number of different possible session size and color depth combinations are available.
Feature Release 1 and Service Pack 3 Installation Guide Important Microsoft Windows NT Service Pack 4 or higher must be installed on the MetaFrame server for SpeedScreen latency reduction features to work. Client Update Database Because Version 6.01 of the ICA Client includes native support for all previous encryption levels, the ICA Client Update Database was modified to allow one client image to be used to update multiple client models. Version 6.
Fixes Included in Service Pack 3 This service pack includes all hotfixes that were previously released as separate patches and hotfixes, as well as any new fixes that were not previously released. Service Pack 3 includes all hotfixes included in Service Packs 1 and 2. It is not necessary to install Service Pack 1 or 2 before installing Service Pack 3. Note Although Service Pack 3 also contains MetaFrame 1.
Feature Release 1 and Service Pack 3 Installation Guide Hotfixes for MetaFrame 1.8 for Windows 2000 Servers Hotfix Mx182W001 1. Logging out from a local console session on the MetaFrame server on which the SSL Relay service was running caused the SSL Relay service to stop. 2. ICA KeepAlive functionality was not supported for Windows 2000. This hotfix adds a new “ICA KeepAlive” feature so the MetaFrame server can recognize broken sessions and take appropriate action.
Fixes Included in Service Pack 3 23 6. QSERVER /LOAD always reported zero for the LoadMemory parameter. 7. This hotfix adds new APIs to Wfapi.dll. These new APIs are used by SNMP. Hotfix Mx182W002 1. Chinese/Korean server names and application names did not display properly in various tools and utilities (such as qserver) when running MetaFrame for Windows 2000 with Service Pack 2 on a Korean or Chinese Windows 2000 Server. 2.
Feature Release 1 and Service Pack 3 Installation Guide Hotfix Mx182W004 1. The Redirector had problems tracking transmit and receive queue sizes for redirected client serial ports. Writes forwarded to the client must not exceed the size of the client's transmit queue. A related change to the ICA Win32 Client, which prevents the DTR/DTS signals from being inadvertently reset, is also required to make the scanner's upload/download software function properly.
Fixes Included in Service Pack 3 25 4. Corrects the problem where IME buttons were disabled during published application sessions. Also corrects the problem where the IME toolbar icon did not appear when it was configured to be located on the taskbar status area (system tray). 5. Detection of mouse double clicks can be performed either on the server or with most Citrix Clients.
Feature Release 1 and Service Pack 3 Installation Guide 7. After installing Service Pack 2, a MetaFrame 1.8 server could be integrated into any farm. This problem is solved with the Appcfg.exe file included in this hotfix. 8. Corrects the following printing-related problems: Client printers were not being reliably created with the information in the Printer Comment field.
Fixes Included in Service Pack 3 27 Add “DefaultComPorts” as a REG_DWORD value in the range from 0 to 99. After setting this value, you must manually remove the already defined COM port keys from the key: HKLM\HARDWARE\DEVICEMAP\SERIALCOMM Reboot your system. Hotfix Mx182W013 Program Neighborhood icons did not refresh when the password was changed. Hotfix Mx182W014 NFuse 1.5 did not recognize an alternate address when the address was entered using the following syntax: altaddr ...
Feature Release 1 and Service Pack 3 Installation Guide Hotfixes for MetaFrame 1.8 for Windows NT 4.0 Servers, Terminal Server Edition Hotfix Mx182T001 1. This hotfix adds new APIs to Wfapi.dll. These new APIs are used by SNMP. 2. The Euro symbol key (AltGr+e) did not work correctly on Linux Clients configured with German or Swiss German keyboard layouts. 3. The DOS Client sometimes experienced display corruption when switching a console application to full screen text mode. 4.
Fixes Included in Service Pack 3 29 Class exceptions for MS-IME are hard coded, but third-party vendor IMEs can specify this flag to fix their problems. Here is the setting for MS-IME98 that is needed if they are not hard coded. ClassName, Type, IMEFlag, IMEOwnerDepth MSIMECaret, 4, 3, 0 msime98cnv, 4, 3, 0 msime98mode, 4, 5, 3 msime98cand, 4, 1, 3 msime98ToolTip, 4, 1, 4 Type 8: This is used when applications using non-visible windows and the seamless engine fail to create them.
Feature Release 1 and Service Pack 3 Installation Guide [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\ Citrix\wfshell\TWI\ThunderRT6Main] “ClassName”=”ThunderRT6Main” “Type”=dword:00000030 Hotfix Mx182T002 1. The Redirector had problems tracking transmit and receive queue sizes for redirected client serial ports. This issue was found in tests with a Symbol Technologies hand-held scanner device. A related fix is in the ICA Win32 Client, Build 931 and above. 2.
Fixes Included in Service Pack 3 31 After setting this value, you must manually remove the already defined COM port keys from the key: HKLM\HARDWARE\DEVICEMAP\SERIALCOMM Reboot your system. Hotfix Mx182T004 Some Japanese UNICODE keyboard mapping files mapped to incorrect characters. This sometimes caused problems when using a 101 keyboard with the Japanese ICA UNIX Client for the Solaris/SPARC platform. To enable this fix, you must select the 101 keyboard settings from the keyboard type section.
Feature Release 1 and Service Pack 3 Installation Guide Print properties were not restored from the user profiles for autocreated client printers. The Windows spooler sometimes crashed when multiple logons simultaneously created, queried, initialized, or deleted client printers. Printer permissions and properties were sometimes corrupted during heavy usage. 5. Usernames of 20 or more characters in length caused a process exception when they logged off. 6.
Fixes Included in Service Pack 3 33 Hotfix Mx182T011 Program Neighborhood icons did not refresh when the password was changed. Hotfix Mx182T012 Running ACT! 2000 in seamless mode caused the server to blue screen when accessing the Groups function ([View] - [Groups]). Other Fixes in Service Pack 3 MetaFrame 1.8 for Windows 2000 Servers 1. When accessing a mapped client drive, users were unable to change Japanese file names that contained double byte, full width, alphabet characters. 2.
Feature Release 1 and Service Pack 3 Installation Guide If the registry key was not present, did not have a DWORD value of “fPurgeAnyWay,” or the value was not 1, the print job was not deleted. The client printer was not deleted from the server. The print job resumed printing when the user reconnected. If the autocreated client printers had the “keep printed jobs” attribute, even if the registry key was present and the DWORD value “fPurgeAnyWay was set to 1, the print jobs were not deleted.
Fixes Included in Service Pack 3 35 MetaFrame 1.8 for Windows NT 4.0 Servers, Terminal Server Edition 1. Corrects the problem where IME buttons were disabled in published application sessions. 2. When the IME toolbar was configured to be on the taskbar sys tray icon, the icon did not appear in the client sys tray. 3. When using the shadow taskbar in a seamless window, other seamless applications (when minimized) did not appear on the local operating system taskbar.
Feature Release 1 and Service Pack 3 Installation Guide 4. TCP+HTTP browsing failed with the Microsoft ISA caching proxy. 5. All local printers with similar names were autocreated even if the connection was set to create only the main client printer. 6. With some custom applications, if a modal subwindow was minimized while running in seamless mode, the minimized window sometimes lost the functionality of certain buttons; that is, the maximize and minimize window buttons. 7.
Fixes Included in Service Pack 3 Citrix Macintosh Client 1. The Mac OS 9.1 displays did not work. 2. NFuse connections did not work with SecureICA. 3. Saving files to a client drive in Word 2000 did not work. 4. Intermittent crashes occurred when using the Office Assistant. 5. Corrects crashes that occurred when selecting an area in Star Office.
Feature Release 1 and Service Pack 3 Installation Guide Fixes From Service Pack 2 MetaFrame 1.8 for Windows 2000 Servers Hotfix Mx181W001 1. A memory leak occurred each time a client connected to Pnsvc.exe. 2. Program Neighborhood Service crashed because of a faulty registry entry. 3. Servers in a server farm were not aware of other servers in the farm after reboots or connection failures. 4. If a server published more than 100 applications, applications were sometimes lost during refresh.
Fixes Included in Service Pack 3 39 Hotfix Mx181W006 1. If the client Module.ini file was misconfigured by setting the WindowSize parameter to a value greater than the MaxWindowSize parameter, client drive mapping could cause a blue screen. 2. Files with long filenames (12 or more characters) could not be seen on the client network from 16-bit applications. 3. Files with long filenames on the client’s local drive were not accessible until browsing the client’s system root.
Feature Release 1 and Service Pack 3 Installation Guide MetaFrame 1.8 for Windows NT 4.0 Server, Terminal Server Edition Hotfix Mx181T001 1. A memory leak occurred each time a client connected to Pnsvc.exe. 2. If a server published more than 100 applications, some applications could be lost during refresh. Hotfix Mx181T002 1. Asynchronous dialbacks occasionally failed to connect back to the client. 2. ICA dialback could not be prolonged.
Fixes Included in Service Pack 3 41 Hotfix Mx181T005 1. When running a seamless published application, the published application lost focus when the IME bar was clicked. This fix applies only to the Japanese platform. 2. Published applications in seamless mode did not get focus when using ALT+TAB, when selecting them on the taskbar, or when clicking on the title bar. Hotfix Mx181T006 Microsoft Word file locations were incorrect.
Feature Release 1 and Service Pack 3 Installation Guide Hotfix Mx181T011 MS-ADPCM audio files played on an ICA connection set to low quality audio caused CPU usage to jump to 100%. When this occurred, new users were unable to connect to the Terminal Server Edition/MetaFrame server. This issue was most prevalent when the start navigation sound setting on Internet Explorer 5 was configured to Start.wav. Hotfix Mx181T012 1.
Fixes Included in Service Pack 3 43 ! Session time did not show up in the Auditlog utility for English and Japanese. At a command prompt, type ctxaudit /on and then reboot to start auditing to the event log. The auditing of Windows logons and logoffs does not need to be enabled. Use ctxaudit /list and ctxaudit /time to format the logon/logoff information that is now in the event log. This fix applies to both MetaFrame for Windows NT, Terminal Server Edition and MetaFrame for Windows 2000 Servers.
Feature Release 1 and Service Pack 3 Installation Guide Fixes From Service Pack 1 Service Pack 2 includes all of the following fixes from Service Pack 1 for Windows NT 4.0 Server, Terminal Server Edition. It is not necessary to install Service Pack 1 before installing Service Pack 2. In addition to the issues that are resolved by hotfixes incorporated in Service Pack 1 (listed below), Service Pack 1 also resolves a variety of issues regarding Program Neighborhood.
Fixes Included in Service Pack 3 45 When this value is 0, ICA keep-alives are disabled. When this value is set to 1, ICA keep-alives are enabled. The IcaEnableKeepAlive is set to 1 by this hotfix installation. IcaKeepAliveInterval: REG_DWORD: If the IcaEnableKeepAlive value is 1, this value controls the frequency at which ICA keep-alives are sent to the client. This IcaKeepAliveInterval is set to 60 seconds by this hotfix installation.
Feature Release 1 and Service Pack 3 Installation Guide The Service Control Manager sends the SERVICE_CONTROL_SHUTDOWN event synchronously to all services one at a time when a system shutdown begins. A service receives the event only when all services that received the event ahead of it have finished processing the event. If the previous service does not process the event, the following services never receive the event.
Fixes Included in Service Pack 3 47 Hotfix Mx180010 1. The Rumba light pen lost its position after reconnecting to a disconnected session. 2. Certain actions that should have produced graphical feedback would not update the client until another action caused a graphics update. This problem was reproduced by clicking certain Microsoft Excel check boxes. 3. Users were unable to correctly point and select with their pointing device in an ICA session.
Feature Release 1 and Service Pack 3 Installation Guide To enable SuperCache, you need to run the following command at a command prompt at each server on which you want to have SuperCache functionality: Keysync ICAThinwireFlags /Enable:2 If you want to disable SuperCache functionality, run the following command at a command prompt at each server on which you want to disable the SuperCache functionality: Keysync ICAThinwireFlags /Disable:2 NOTE: The server must be rebooted for either change to take effec
Fixes Included in Service Pack 3 49 2. If the system administrator selected the Prompt for Password check box in the Advanced Connection Settings from the Citrix Connection Configuration utility, any anonymous published application prompted for password. Hotfix Mx180013 Sessions would intermittently hang or disconnect due to a clipboard contention problem. Hotfix Mx180014 The shadow task bar did not work with SecureICA.
Feature Release 1 and Service Pack 3 Installation Guide Hotfix Mx180020 1. Fixed the issue where Cdm.sys could cause a blue screen with a misconfigured client or a zero length write. 2. If one DOS printer had an error, all other printers stopped printing. 3. Fixes the issue where file corruption could occur when writing to a client drive.
Fixes Included in Service Pack 3 51 Hotfix Mx180024 The shadow taskbar caused a Dr. Watson. Hotfix Mx180025 1. The Win16 Client trapped when pasting a large bitmap into applications such as WordPad or Word 97. 2. Multiple logins to a Sybase SQL Published Application caused some client application logins to flicker and disconnect. Hotfix Mx180028 CSRSS (client-server runtime subsystem) did not terminate when a client logged off after being shadowed.
Feature Release 1 and Service Pack 3 Installation Guide Hotfix Mx180033 1. A MetaFrame server with a zero-user base-license failed to acquire licenses from the license pool. 2. Enhancement to allow command line parameters to be passed to published applications from the client side. 3. ICA session crashed if the user had a command prompt open in full screen mode and performed long scrolling such as typing dir in a large directory. 4. UNICODE clients (for example, the 3.
