########################################################################
#
#    Citrix ICA Client for Unix Version 3.0
#
#    Copyright 1996-2000 Citrix Systems, Inc. All rights reserved.
#
########################################################################

This file contains the latest information relating to the Citrix ICA Client
for Unix.

Please read this file fully before using the Citrix ICA Client for Unix.  
It contains important information that may be more up to date than other 
documentation you have available.

For online help open the file contents.htm in the help directory with
a web-based browser.

For the latest information on this, and other Citrix Systems, Inc.
products, please visit our World Wide Web site at:

http://www.citrix.com/

1. Contents
===========
  New Features
  Non-feature items addressed in this release
  Miscellaneous
  Your Comments Please

2. New Features
===============
2.1 Graphical cut/copy & paste - provides an ability for images, not
just text, to be copied and pasted.

2.2 Unix Server-side clients - provides a mechanism for X terminals that
can't install a native ICA client. Instead, users can start an ICA
session on the Unix server. From there a user can connect from the Unix
server to a Citrix server. This was previously possible, but this release
allows independent configuration files so that each user can have their own 
configuration settings or connection definitions.

2.3 Color Approximation - a new feature that prevents the display from
flashing when switching back and forth between ICA sessions and the
local Unix desktop or local applications.  This essentially provides
color palette compatibility between NT and Unix which is what caused the
flashing to occur.

2.4 Business Failover - provides a mechanism for defining redundant
groups of server IP addresses that permit connecting to back-up servers
or farms automatically in the unlikely event of the primary server or
farm going down. With this feature, no user intervention is required
nor are they aware a back-up server is in use.

2.5 This release includes official support for Slackware, Caldera and SuSE
versions of Linux in addition to Red Hat.

2.6 Data compression for improved performance, Persistent cache for improved 
performance and Auto client update.

2.7 New to Sparc Solaris, Linux, HP-UX and AIX: Audio.

2.8 New to Linux: client serial port mapping.

2.9 Shared 16 colors - Previously, each client allocated its own colorcells
in 16 color mode, even though the color entries are identical. With this
release, only the first client allocates the 16 colorcells and all additional
clients access these cells and share their entries.

There is currently no method to recover consistent color sharing data
after a client exited abnormally. Afterwards, the shared information is
inconsistent and the colors of a client will change randomly, or the
client will display an error message and exit.
If this happens frequently, the feature should be turned off with
the entry AllowShared16Colors=False in wfclient.ini.

3. Non-feature items also addressed in this release
===================================================
3.1 Adjusted for new CPIO issues introduced in Red Hat 5.2.

3.2 Systems that do not use a network card can now run the Linux client for
situations like dial-in connections.

3.3 Server/published application selection is done via a selection box,
avoiding the problem of the list being limited to the height of the
screen.

3.4 Grayscale monitors now work.

3.5 Middle mouse button is now supported.

3.6 Four plane displays now work (16-color displays).

3.7 Multi-headed displays now work.

3.8 Client printing is no longer limited to ten printers (previously
caused broken pipe error messages).

3.9 Num lock handling is improved (details contained in section 4.14).

4. Miscellaneous
================
4.1 Changing Server List
------------------------
If you find that the list of available servers in the Server field of
the Properties dialog appears to change, this is because you have access
to more than one network with a number of servers on each. Normally the
list reflects the network that the ICA Client is on, however depending
on network load and the load on the Citrix servers sometimes the other
network browser responds first and another list is displayed.

To produce a consistent list you should specify one of the servers on
the required list as the server browser in the Network/Properties
dialog.

4.2 Zooming in Adobe Photoshop
------------------------------
It should be noted that the Adobe Photoshop zoom out utility using
shift-leftmouse is not supported by the ICA Client for Unix. To use
this feature you should select the appropriate menu option instead of
using the mouse.

4.3 Resolving Names for Internet Servers
----------------------------------------
To allow you to resolve names of Internet Servers that you wish to
connect to, it is recommended that you have DNS (Domain Name System)
installed on your machine.

4.4 Attributes cannot be set for files on floppies
--------------------------------------------------
Attempting to set file attributes (e.g. using the DOS ATTRIB command or
Windows File Manager) on a locally mounted floppy drive silently fails.
The file attributes are left unchanged.

4.5 Problems moving files on DOS floppies mounted on Sun machines
-----------------------------------------------------------------
On DOS floppies mounted on Sun machines the client has to move files to
subdirectories by making a copy and deleting the original. This means
that it will fail if there is insufficient space for a second copy. The
Unix mv(1) suffers from the same limitation.

4.6 Problem copying large files to DOS floppies on SunOS
--------------------------------------------------------
On SunOS (Solaris 1.x) copying large files to a DOS floppy may fail with
a Disk Full error even when there is sufficient space.

This is because the WinFrame or MetaFrame server issues a FileChangeSize
request before writing the data, and SunOS cannot respond rapidly enough
to this request.

An entry IgnoreFileChangeSize with the value True may be set in the
[WFClient] section of wfclient.ini. This stops the timeout occurring
allowing large files to be copied. However this solution may have other
side-effects, and it should only be used if this problem is encountered.

4.7 Client Licensing and Multi-Homed Hosts
------------------------------------------
Client licensing relies on being able to determine a unique host id. On
Digital Unix and HP-UX the host id is obtained from the address of a
running network controller.

On multi-homed hosts the default is to use the first running network
controller provided it is up. This may be overridden by setting the
IdentificationController parameter in the [WFClient] section of
wfclient.ini to the name of a network device to use. For example "ln0",
"tra1", "lan2", etc.

4.8 Using 24-bit displays
-------------------------
On some 24-bit TrueColor displays the Citrix ICA Client for Unix may
fail to start, reporting an error similar to:

X Error of failed request: BadValue (integer parameter out of range for operation)
Major opcode of failed request: 91 (X_QueryColors).

This may be resolved by locating the following lines in $ICAROOT/Wfica and 
removing the comment markers in the Wfica* lines.

!
! If you are having problems with CDE on 24-bit graphics
! cards then uncomment the following 6 defaults. Note that
! the color names can be any valid color available on your
! display, but all 6 lines should be uncommented.
!
!Wfica*background:              DeepSkyBlue
!Wfica*bottomShadowColor:       DarkSlateBlue
!Wfica*foregroud:               Black
!Wfica*topShadowColor:          LightSkyBlue1
!Wfica*highlightColor:          Black
!Wfica*borderColor:             Black

4.9 Solaris (Intel Platform Edition) TrueColor support
------------------------------------------------------
The Solaris (Intel Platform Edition) client won't run on a 16 or 24-bit
TrueColor console as it relies on being able to select an 8-bit
PseudoColor visual, which Solaris (Intel Platform Edition) does not
provide in these modes.

4.10 Solaris (Intel Platform Edition) Second Mouse Button
---------------------------------------------------------
If you are running the UNIX ICA Client on a non-Solaris Intel machine
and displaying it on a Solaris Intel machine with a 2 button mouse, the
second mouse button will not work correctly.

To solve this problem add the flag "MapMouseButton2=true" to the
[WFClient] section of the file wfclient.ini.

4.11 Using UK Keyboards with WinFrame
-------------------------------------
International keyboard support for WinFrame servers is available by
applying the appropriate Unicode hotfix. However, if this hotfix cannot
be applied to your WinFrame server, UK keyboards can be supported as
follows:

i. Edit the file $ICAROOT/keyboard/keyboard.ini

ii. For Sun, HP, DEC and Silicon Graphics keyboards, uncomment the UK
keyboards in the appropriate section ([Sun], [HP], [DEC], or [SGI]) by
removing the semi-colon (;) from the start of each line.

iii. For Data General, rename the [DG] section to [DGkbd], rename the
[DG with UK] section to [DG] and in the [DGkbd] section enter a
semi-colon (;) at the start of the line "ButtonLabel = Data General" and
remove the semi-colon (;) from the start of the line "ButtonLabel =
US/International".

4.12 Error 49: cannot connect to server
---------------------------------------
This occurred sporadically in 2.0 and 2.6 clients. A workaround was to
set 'InterfaceAddress=.' in the [WFClient] section of wfclient.ini This
now believed to have been permanently fixed in the 2.7 and above client
releases.

4.13 Correct operation of Client Drive Mapping with filenames containing 
     accented characters
------------------------------------------------------------------------
Correct operation of Client Drive Mapping with filenames containing
accented characters (e.g. ) may only be obtained by setting the Citrix
Server DOS codepage to 1252.

This may be accomplished by setting the server registry entry
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage\OEMCP
to 1252. However within a console window you may then need to set the
codepage back to 850 using the CHCP command in order for DOS
applications to display correct characters and accept alt-numeric
entries from the keypad.

4.14 NumLock Operation On Linux
-------------------------------
The NumLock key operates incorrectly on some installations of Linux. To
configure Linux so that NumLock works, edit the file XF86Config (usually
located under /etc or /etc/X11). In the "keyboard" section make sure
that the following lines are either not present or are commented-out (as
shown below):

#    ServerNumLock
#    XkbDisable

4.15 Rapid Color Changes with TrueColor Displays
------------------------------------------------
When connecting to a Citrix server users are given the option of using
16 or 256 colors. The 256 color option assumes video hardware with
palette support which allows applications to rapidly change the palette
colors producing animated displays.

On a TrueColor display many colors can be displayed but there is no
facility to emulate this ability to produce animations by rapidly
changing the palette. Emulating it in software is relatively expensive
in time and in network traffic. In order to reduce this the Unix client
is configured to buffer up rapid palette changes and only update the
real palette every few seconds.

Two new entries in the [WFClient] section of the wfclient.ini file
control the operation:

PaletteChangeTimeout=1
	This determines how long to leave between palette changes. The
default is 1 second. Granularity is in seconds. Setting to 0 results
in no delay between palette changes (at the expense of network traffic
and time delays). If a palette change arrives more than
PaletteChangeTimeout seconds after a previous one it is acted upon
immediately.

RedrawAfterPaletteChange=Yes
	This determines whether the screen should be redrawn after each
palette change. Redrawing should mean the screen reflects what the
application is trying to display but can cause a flickering effect if
the application is trying to use palette animation. This is the
default value. A value of 'No' means the screen will not be redrawn
after palette changes. This means the new palette colors only take
effect when new drawing occurs.

4.16 SCO Unixware 2.1.3 - Unable to display in 16 color mode
------------------------------------------------------------
In some cases, the client session is unable to display graphics and text
properly. To compensate for these cases, the following line should be
added to the [WFClient] section of wfclient.ini:

ForcePlaneMask = True

4.17 SCO Unixware and OpenServer 5 - No audible warning check button
--------------------------------------------------------------------
The preferences dialog under menu entry Option, Settings... does not
display the check button to allow enabling/disabling of Windows alert
sounds. To disable audible warnings, make sure the following line is in
the [WFClient] section of wfclient.ini:

DisableSound = True

To enable audible warnings, use the following line:

DisableSound = False

4.18 Removing scrollbars from full screen sessions
--------------------------------------------------
Full screen sessions may be started without scrollbars by setting the
parameter NoWindowManager in the [WFClient] section of wfclient.ini to
True. The default value for this parameter is False indicating that
scrollbars will always be present in full screen sessions.

4.19 Color Approximation Limitations
------------------------------------
Color Approximation will fall back to using a private colormap if other
applications have allocated all 256 colors.

4.20 High Quality Sound on HP-UX
--------------------------------
On slower Citrix servers or HP machines High Quality Sound may sometimes
break up. Low and Medium Quality Sound are not affected.

4.21 Audio output control on AIX
--------------------------------
The Ultimedia Services (UMS) audio devices have a number of outputs, 
eg. INTERNAL_SPEAKER.  These are listed in the UMS configuration file 
(usually /usr/lpp/UMS/defaults/UMS_config). The default state of these 
can be overriden by placing an entry in the
[WFClient] section in wfclient.ini, eg.

EnableINTERNAL_SPEAKER=False

will disable the speaker,

EnableINTERNAL_SPEAKER=True

will force it to be on.

4.22 Redhat Package Manager (RPM) issues (Linux)
------------------------------------------------

Client packages distributed in RPM format have a few differences
from the normal tar file installations.

The setupwfc script is not needed and has been removed, as has the
install.txt file; references to setupwfc in the html documentation
should be disregarded.  Uninstalling the client should be performed
using "rpm -e ICAClient". Note that this may not delete the cache
directory (/usr/lib/ICAClient/cache) which then will require manual
removal.

4.23 Client Printer Auto-Creation
---------------------------------
The client can now determine the Unix system default printer and pass
this information back to the server. This printer will appear
as 'Auto Created Client Printer' in the WinFrame or MetaFrame
Printer Control Panel and should be selected as the default printer. 

The default printer can be overridden by the LPDEST or PRINTER environment 
variable on HP-UX and the PRINTER environment variable on Linux. It may 
also be overriden by the DefaultPrinter setting in the [WFClient] section 
of wfclient.ini. This will override any environment variable setting.

In order for this feature to work it is also necessary to set up a 
driver name in the form that Windows recognises. This is done by
setting DefaultPrinterDriver in the [WFClient] section of wfclient.ini
as above. For example 'HP LaserJet 4Si MX' or 'HP LaserJet 8000 Series PS'
are strings that may be used if the appropriate drivers have been
installed on WinFrame or MetaFrame.

5. Your Comments Please
=======================
The help information supplied with this package has details of how to
contact Citrix's Technical Support or Customer Service departments.
Please contact these departments if you have any problems with the
software or wish to get further product information.

If you have any comments about the Citrix ICA Client for Unix software 
or documentation, please send them by letter or fax to:

Citrix Systems, Inc.
6400 NW 6th Way
Fort Lauderdale, FL 33309
1-800-437-7503
http://www.citrix.com/

########################################################################

