home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / icav6012.zip / readme.txt < prev   
Text File  |  2001-10-24  |  13KB  |  364 lines
  1. READ ME
  2. Citrix ICA Client for IBM OS/2 Warp (ICA OS/2 Client)
  3.  
  4. Filename:             icaos2.exe
  5. Software Version:  6.012
  6. Replaces:             All versions prior to November 1, 2001
  7. Date:                   November 1, 2001
  8. Languages:           English, French and German
  9.  
  10.  
  11. (c) 2001 Citrix Systems, Inc.
  12. -----------------------------------------------------------
  13.  
  14.  
  15. Description
  16. ============
  17. The ICA OS/2 Client supports the following platforms:
  18.  
  19. *  OS/2 Warp 3
  20. *  OS/2 Warp 4
  21. *  OS/2 Warp 4.5
  22.  
  23. Important Note: We recommend upgrading your OS/2 installation with the 
  24. latest OS/2 Warp FixPak (from IBM) before you install the ICA OS/2 
  25. Client. IBM continues to issue FixPaks that fix existing problems in 
  26. OS/2 Warp platform/s. Upgrading to the latest FixPak may therefore 
  27. resolve device specific problems that could cause unexpected behavior 
  28. on the ICA OS/2 Client.
  29.  
  30.  
  31. Software Enhancements and Problems fixed in this Release
  32. =================================================
  33. This main highlights of this release of the ICA OS/2 Client are 
  34. extended hardware compatiblity, improved graphics rendering 
  35. performance, and a smaller memory footprint.  
  36.  
  37. Details of the changes implemented in this version (6.012) of the ICA 
  38. OS/2 Client software are as follows:
  39.  
  40. * Extended hardware compatibility range
  41. ----------------------------------------
  42. On some hardware/software combinations, with older FixPaks / GRADD 
  43. driver revisions, graphics corruption was observed in the form of 
  44. invisible text and/or inverted text on window title bars and controls.
  45. The issue has now been resolved. The two old parameters 
  46. (MonoBitmapInvert and GRADDAutoDetect) used to manually correct this 
  47. problem are now redundant and have been deleted. Presence of these 
  48. parameters in the ICA or INI files will be ignored.  
  49.  
  50. * Improved graphics rendering and smaller memory footprint
  51. ----------------------------------------------------------
  52. The changes made to extend the supported hardware permutations has 
  53. resulted in improved graphics rendering, as well as a slightly smaller 
  54. memory footprint at runtime.
  55.  
  56.  
  57.  
  58. * Keyboard Compatibility between Operating Systems
  59. ------------------------------------------------------
  60. In previous versions of the OS/2 Client software unpredictable 
  61. behavior was being experienced when using the Shift-Lock, the Caps 
  62. Lock or the Num Lock keys in a remote session if there was a mismatch 
  63. between the client-side and the server-side with respect to Shift-Lock 
  64. processing by the operating system. 
  65.  
  66. For example, if the OS/2 Client is configured with KEYB FR, and the 
  67. MetaFrame for Windows server is configured for French keyboard without 
  68. Shift-Lock processing (the default) unpredictable behavior may be 
  69. experienced.
  70.  
  71. This is now resolved by the implementation of the EnableShiftLock 
  72. parameter in the [WFCLIENT] section of the APPSRV.INI or in the ICA 
  73. file itself.
  74.  
  75. You can now force the client to use local keyboard settings regardless 
  76. of what the settings are on the server. To do this set: 
  77.  
  78.          [WFCLIENT]
  79.          EnableShiftLock = True
  80.  
  81. This resolves mismatches when connecting to different servers with 
  82. different default settings.
  83.  
  84.  
  85. * Issues with connecting to MetaFrame for UNIX farms resolved
  86. -------------------------------------------------------------
  87. When connecting to MetaFrame for UNIX farms, the available published 
  88. applications list is displayed correctly.
  89.  
  90.  
  91. Where to Find Documentation
  92. =============================
  93. This document contains late-breaking information about the ICA OS/2 
  94. Client software. 
  95.  
  96. For more information about the ICA OS/2 Client, refer to the Citrix 
  97. ICA Client Administrator's Guide for the ICA OS/2 Client, available in 
  98. an Adobe Portable Document Format (PDF) file (ICAOS2.PDF). 
  99.  
  100. This file is available on the Citrix Downloads page at 
  101. http://www.citrix.com/download/; click ICA Clients.
  102.  
  103. Use Adobe Acrobat Reader to view PDF files. Acrobat Reader is free 
  104. software that lets you view and print Adobe Portable Document Format 
  105. (PDF) files on all major computer platforms. You can download Acrobat 
  106. Reader from Adobe's Web site at http://www.adobe.com.   
  107.  
  108. You can also find documentation on the Web at 
  109. http://www.citrix.com/support. On the Services Portfolio page; click 
  110. the Product Documentation tab, and choose ICA Clients.
  111.  
  112.  
  113. System Requirements
  114. ====================
  115. Computers used with the ICA OS/2 Client must meet the following 
  116. requirements: 
  117. * Standard PC architecture, 80486 processor or greater
  118. * IBM OS/2 Warp 3.0 (FixPak 32 or greater), Warp 4.0 (FixPak 5 or
  119.   greater), or Warp 4.5
  120. * 8MB RAM or greater
  121. * Mouse
  122. * Keyboard
  123. * VGA or higher resolution 
  124. * 2MB free hard disk space 
  125. * Connection to a Citrix server over TCP/IP transport 
  126.  
  127.  
  128. Installation
  129. =============
  130. Download the installation package for the Citrix ICA OS/2 Client from 
  131. the Citrix Download site.
  132.  
  133. 1.  Copy the ICA OS/2 Client image (icaos2.exe) to a temporary 
  134. directory (for instance, c:\temp) on the client machine.  The file is 
  135. a self-extracting archive.
  136.  
  137. 2.  Open an OS/2 command window, and change to the directory where the 
  138. icaos2.exe file was saved:
  139.     
  140.     c:\>cd temp
  141.  
  142. 3.  Extract the contents of the archive by running icaos2.exe:
  143.     
  144.     c:\temp>icaos2
  145.  
  146. Contents of the archive are extracted to c:\temp.
  147.  
  148. 4.  To install the OS/2 Client, run install.exe:    
  149.  
  150.     c:\temp>install
  151.  
  152. The installation program will begin installing the ICA OS/2 Client. 
  153. Follow the prompts until installation is complete.
  154.  
  155.  
  156. Known Problems/Limitations (in this release):
  157. ==================================
  158.  
  159. 1.  Garbled text
  160. -------------------------
  161. Occurrence of garbled text is observed within an ICA session on some 
  162. older machines using an S3 Trio64 chipset, with FixPak5 and old GRADD 
  163. drivers. 
  164.  
  165. This has been investigated and identified as a third party bug. We 
  166. recommend that you upgrade the client device with the latest OS/2 
  167. FixPak, and/or install the latest GRADD driver versions.
  168.  
  169.  
  170. 2. Color corruption
  171. ------------------------------
  172.  
  173. On client devices using older chipsets such as Intel 810, with FixPak 
  174. 5 and old GRADD drivers, some color corruption maybe visible when 
  175. connecting to a remote session (16 or 256 colors) from a desktop using 
  176. 16 or 24 bit color
  177.  
  178. This has been investigated and identified as a third party bug. We 
  179. recommend that you upgrade the client device with the latest OS/2 
  180. FixPak, and/or install the latest GRADD driver versions.
  181.  
  182.  
  183. 3. Some client printer names are not recognized correctly at the 
  184. server
  185. ----------------------------------------------------------------------
  186.  
  187. You may experience this problem if the client printer name contains 
  188. international characters.
  189.  
  190. This issue is caused by the fact that on OS/2 extended characters have 
  191. been mapped to different character codes as compared to their Windows 
  192. counterparts, even when the same codepage is used. Therefore, their 
  193. representation will be different on the client and the server.
  194.  
  195. Please note that extended characters should not be used to exchange 
  196. information between the client and server.  The solution is to ensure 
  197. that client printer names do not contain extended characters.
  198.  
  199.  
  200. 4. Citrix server connections take longer than usual to time-out
  201. ----------------------------------------------------------------------
  202. The "Connecting to ..." message remains on the screen and the Cancel 
  203. button doesn't seem to work
  204.  
  205. This problem occurs only when an existing server (listed in the ICA 
  206. browser) is currently not functioning. OS/2 sets a default timeout 
  207. limit of 75 seconds for TCP/IP connections. This is a global setting 
  208. that cannot be changed without affecting other applications running at 
  209. the time.
  210.  
  211.  
  212. 5. Unable to cut and paste a Euro symbol from the server to a client
  213. ---------------------------------------------------------------------
  214. The Euro symbol is an extended character. On OS/2, extended characters 
  215. are mapped to different character codes as compared to their Windows 
  216. counterparts, even when the same code page is used, therefore their 
  217. representation is different on the two platforms. This is a basic 
  218. difference in the implementation of the two operating systems.
  219.  
  220.  
  221. 6. Code page requirements for Euro symbol and other extended 
  222. characters
  223. ----------------------------------------------------------------------
  224.  
  225. If you are unable to generate the euro symbol on an OS/2 client, it 
  226. may be that the code page being used is incorrect.  You should use 
  227. code page 850 to enable generation of extended characters.
  228.  
  229. To set the code page on OS/2, open an OS/2 window and type the 
  230. following command:
  231.  
  232.    c:\>chcp 850
  233.  
  234. To get the current system code page setting, type:
  235.    
  236.    c:\>chcp
  237.  
  238.  
  239. 7. Applications launched from Netscape are terminated when you quit 
  240. Netscape
  241. ----------------------------------------------------------------------
  242.  
  243. If you launch ICA sessions using the Netscape browser, or using NFuse, 
  244. and then close Netscape, all ICA sessions will be disconnected. 
  245.  
  246. This is due to the OS/2 specific implementation of Netscape, that is, 
  247. all child processes (launched ICA connections, in this case) are 
  248. terminated when the user exits the parent process (Netscape).
  249.  
  250.  
  251. 8. Problems upgrading ICA OS/2 Client software
  252. --------------------------------------------------------------------
  253.  
  254. We recommend that you always delete any previously installed versions 
  255. of the client software before installing a newer version.
  256.  
  257. To remove older versions of the client software:
  258.  
  259. a) Run the installer and proceed to the "Installation options" dialog.
  260.  
  261. b) Select the "Delete the installed product and re-install" option.
  262.  
  263. c) Proceed to the "Install" dialog and press the "Cancel" button.
  264.  
  265.  
  266. 9.  Using certain applications on a mapped client drive generates an 
  267. "Out of file handles" message.
  268. ----------------------------------------------------------------------
  269.  
  270. This problem is encountered when an application running on the server 
  271. opens too many files on a client mapped drive and causes the ICA 
  272. session to run out of file handles.
  273.  
  274. This is a third party bug in OS/2 - the operating system does not 
  275. provide the ICA Client engine sufficient file handles on request.
  276.  
  277. The fix to this problem is to increase the number of initial file 
  278. handles available to the ICA OS/2 Client by adding the MaxOpenContext 
  279. parameter to the [ClientDrive] section in the MODULE.INI file . If the 
  280. user needs to open a large number of files, increase the number of 
  281. initial file handles to 50 or greater. The default value for 
  282. MaxOpenContext is 20.
  283.  
  284.     [ClientDrive]
  285.     MaxOpenContext=n
  286.  
  287. where n is the number of initial file handles available to the client.
  288.  
  289. Specifically, this problem occurs when Lotus Notes (Version 5.0) is 
  290. one of the applications used on a client-mapped drive. The "Out of 
  291. file handles" error is a direct result of this application using up 
  292. too many file handles.  
  293.  
  294.  
  295. 10.  Problems mapping network printers, with the net use command, to 
  296. local OS/2 devices
  297. ---------------------------------------------------------------------
  298.  
  299. If you've mapped a network printer (with the net use command) to a 
  300. local OS/2 device, for example, LPT1, then the ICA OS/2 Client will be 
  301. unable to print to that printer through LPT1.
  302.  
  303. As a workaround, use the printer configuration tool on the MetaFrame 
  304. server to map network printers to local OS/2 ports.
  305.  
  306.  
  307.  
  308. Useful Tips
  309. =================
  310.  
  311. 1. Switches for passing user credentials from the command line:
  312. --------------------------------------------------------------------
  313. To pass user credentials, when launching the ICA OS/2 client from the 
  314. command line, use the following command line switches
  315.  
  316. c:\> wficaos2  /username:your_user_name
  317.                     /clearpassword:your_plain_text_password 
  318.                     /domain:your_domain
  319.  
  320.  
  321. 2. Assigning a unique client name for an OS/2 client machine using the 
  322. CLIENTNAME variable
  323. ----------------------------------------------------------------------
  324.  
  325. To manually assign a name to an ICA Client running on an OS/2 device, 
  326. you can set the CLIENTNAME environment variable from the command 
  327. prompt, or through an entry in the CONFIG.SYS file, on your OS/2 
  328. machine.
  329.  
  330.     c:\ set CLIENTNAME=YOUR_DESIRED_NAME
  331.   
  332. The order of priority in which the ICA OS/2 Client determines what the 
  333. client name should be, is as follows:
  334.  
  335.  a) Gets the CLIENTNAME environment variable, if one has been set. 
  336.  
  337.  b) Gets the client machine's host name (this is the name allocated to 
  338. the device for use with TCP/IP transport).
  339.     
  340.  c) Checks the OS/2 LAN Services configuration for a machine name. 
  341.  
  342.  d) If the above methods fail, then a random name is generated.
  343.  
  344. Please note, unlike the Windows clients, the OS/2 client does not 
  345. utilize the "wfcname.ini" file for client name determination.
  346.  
  347.  
  348.  
  349. Publications Errata
  350. =======================
  351.  
  352. 1.  Page 50, of the Administrator's Guide for the ICA OS/2 Client, 
  353. Version 6.011 describes the use of two ICA/INI file parameters, namely 
  354. GRADDAutoDetect and MonoBitmapInvert. Fixes made in this release have 
  355. rendered these settings invalid. These settings have been removed, and 
  356. will no longer have any effect if present in the ICA file.
  357.  
  358.  
  359. 2.  Page 64, of the Administrator's Guide for the ICA OS/2 Client, 
  360. Version 6.011, describes GRADD Driver Support on the ICA OS/2 Client. 
  361. This section is no longer valid. In general, graphics and color 
  362. corruption issues on the client should be resolved by installing the 
  363. latest FixPak and GRADD driver revisions available.
  364.