Filename: PSE400SOLX062 
For: Citrix Presentation Server for UNIX® Operating Systems and XenApp for UNIX® Operating Systems. Version 4.0 for the Solaris x86/x64 Operating Environment.

Product Names

Citrix has changed the name of its product line. Citrix XenApp for UNIX® is the new name for Citrix Presentation Server for UNIX®. From the release of the new name all change references will be attributed to XenApp for UNIX®, even when that reference is also applicable to Presentation Server for UNIX®.

This readme applies to the following versions of Citrix XenApp for UNIX®:

• Citrix Presentation Server 4.0 for UNIX® Operating Systems

• Citrix Presentation Server 4.0 for UNIX® Operating Systems (September 2007 release)

• Citrix XenApp 4.0, with Feature Pack 1, for UNIX® Operating Systems

• Citrix XenApp 4.0, with Feature Pack 2, for UNIX® Operating Systems

Important Disclaimer - Limited Release Hotfix

This document describes a hotfix intended for limited distribution. Install this hotfix only if you are directly affected by the issue(s) described in this article. All hotfixes are cumulative in that this hotfix will contain all the fix(es) and enhancement(s) from previous hotfixes. The fix(es) or enhancement(s) added in this hotfix will be released in the next public hotfix release for this product. This hotfix is fully supported by Citrix Systems, Inc. However, testing of this hotfix was targeted only at the changes since the last hotfix, and regression and stress testing were minimal. Therefore, this hotfix might cause undesirable and unknown side effects. The next public hotfix differs from a limited release hotfix by the increased level of testing performed before release. Introduce this hotfix to a test environment for evaluation before deploying it to a production environment. Contact Citrix technical support to acquire the hotfix package.

Subscription Advantage Features

A Subscription Advantage Feature is a tested and supported enhancement released for use by customers that have a valid Subscription Advantage license agreement in place with Citrix. Those Features which are Subscription Advantage Features will be specifically identified as such.

Languages

All languages supported by Citrix Presentation Server for UNIX® Operating Systems and XenApp for UNIX® Operating Systems, Versions 4.0.

Free Space Requirements

15MB on the file system where the patch is downloaded

Description

There are 68 previous fixes from the base 4.0 product incorporated in the initial release of Version 4.0 for Solaris x86/x64. The first 83 fixes are also already incorporated in the September 2007 release of Version 4.0. This hotfix is installable on the initial release of Version 4.0 for Solaris x86/x64 and the September 2007 release of Version 4.0 for Solaris x86/x64.

1. Fixes an issue where in seamless mode double clicking in buttons would not produce the right result. Adding the DisableButtonGrabs to the /opt/CTXSmf/data/C/system.ctxwmrc file, activates this fix. Using this keyword when running published applications in fixed window mode is not recommended.

2. Fixes an issue where the CDM daemon could stop running.

3. Fixes an issue where the SSL Relay would not start in a Solaris global zone if an SSL Relay had been started in a Solaris local zone.

4. Fixes an issue where there was a delay when querying a server using ctxqsession, ctxquser or ctxquery. This occurred when querying a server that was not accessible from the network or was switched off. This delay also occurred when querying a farm containing such a server.

5. Fixes an issue where the ctxfm process can leak file descriptors. This can occur during LDAP authentication when any of the following Solaris patches are installed:

These are Sun recommended patches for LDAP use.

6. Fixes an issue where the ctxsecurity utility did not support the use of netgroups. You can now specify a netgroup with the -g option of ctxsecurity. To denote a netgroup, use an @ in the first character of the group name. For example, ctxsecurity reset -g @netgroup1 allow.

7. Adds the ctxcfg -k disallowicaclient=[0|1] configurable that can be used to block clients known to have some level of incompatibility with Presentation Server for UNIX from connecting. This has been introduced to block the Version 8.100 of the Client for 32-bit Windows from connecting due to its known high throughput issues. The default value is 0 which allows the client to connect.

8. Fixes an issue where the X server sometimes crashes when using certain OpenGL modes.

9. Fixes an issue where an application using OpenGL could crash the X server. This would most likely occur as soon as the application started to make use of OpenGL.

10. Adds support for Platinum licensing.

11. Adds support for changing the farm secret key and passphrase using the ctxfarm -k option.

12. Adds support for using Java 6 on Solaris.

13. Fixes an issue where the ctxshadow utility would not report the exit codes stated in the man page.

14. Adds the ability to publish an application to all current and new servers in a farm, by typing a + for the name of a server. Servers joining the farm will have the application published to them automatically.

15. Adds the ability for administrators to place a message in the file /var/CTXSmf/motd, the contents of which are displayed as text in a message box on the screen before the user logs in. Files greater than 2K in size will not be displayed. This is a Subscription Advantage Feature.

16. Adds the ability for administrators to disable any new logons to a server by using the ctxcfg -k nomorelogons=1 keyword configurable. Users can still reconnect to any disconnected sessions. At the next restart of Presentation Server for UNIX this behaviour is reverted. This is a Subscription Advantage Feature.

17. Fixes an issue where the ctxfm process can crash if an authentication time-out is enabled.

18. Fixes issues where replacing a non-retail license with another license can cause the ctxfm process to consume large amounts of CPU. This occurs if the license is changed but the Presentation Server processes are not restarted.

19. Adds the ability to disable scrollmouse support. This uses the ctxcfg -k disablescrollmouse=1 keyword configurable to make a server session not claim this capability. Add the option -noscrollmouse to the XTW_OPTS line in /opt/CTXSmf/slib/ctxXtw.sh to turn off the X server's capability to handle any scrollmouse events that the client sends.

20. Fixes an issue where errors could be generated when parsing XML Service packets under rare network-related conditions (for example congestion and misconfigured hubs or switches).

21. Fixes an issue where the X server could crash when multiple OpenGL applications are run at the same time.

22. Fixes an issue where screen corruption could occur when scrolling window contents.

23. Fixes an issue that meant users had to re-authenticate when connecting to a published application using Web Interface 4.6.

24. Fixes an issue where shadowing highly graphical applications could cause screen updates to lock up for all sessions involved. The fix introduces a small increase in an average session memory footprint and administrators should be aware of this if they operate servers near the limit of phsyical and virtual memory.

25. Fixes an issue where XenApp for UNIX was incompatible with other Citrix license sharing mechanisms. Please see the usage notes section below for more details about this option.

26. Provides the mechanism to allow administrators to configure the product as XenApp for UNIX, with Feature Pack 1. This is achieved by running the ctxlsdcfg -m FeaturePack1 command. To operate the product in this mode, valid licenses to use the Feature Pack 1 capabilities need to be available. To configure the product to provide base bugfixes only, run the command ctxlsdcfg -m Base. Further information about the capabilities of the XenApp for UNIX, with Feature Pack 1 can be found in the Administrators Guide available from the Citrix Web Site. This is a Subscription Advantage Feature.

27. Adds support to make the maximum number of clients the X server can accept configurable. Adding -maxclients xxx to the XTW_OPTS line in the file /opt/CTXSmf/slib/ctxXtw.sh specifies how many clients are to be allowed. The default is 256. Any values less than 256 are ignored. The maximum value is either 1024, or the maximum number of file descriptors the X server is allowed to have open, whichever is the lesser.

28. Adds the ctxcfg -k fullyenumerategroups=[0|1] parameter that lets you configure how groups files are processed by XenApp for UNIX servers. By default, this is set to 1 and a server reads the entire groups database before processing user logons and other actions. If you do not want a server to read the entire groups database, set the value to 0. In some cases, group authentication mechanisms such as NIS or LDAP do not always supply accurate information when processed by some standard OS facilities. This flag ensures accurate group processing is performed. It is important to note that this can result in longer authentication times.

29. The fullyenumerategroups parameter is now checked when authentication is performed for a user logging into Web Interface.

30. On AIX systems, Java versions 5 or 6 will now be used if they are installed in the default locations /usr/java5 or /usr/java6. On machines that have multiple versions installed, the latest version is given precedence.

31. Fixes a rare issue where the ctxfm process can crash if authentication or idle time-outs are enabled.

32. Addresses an issue where clients are not able to reconnect to disconnected sessions that have been established using multiple connections to the same application with different userids.

33. Addresses an issue where clients are not able to reconnect to sessions if the capitalization of the saved application name on the client is changed between disconnect and reconnect.

34. Adds additional logging when character set conversions with iconv fail.

35. Fixes an issue where the ctxlogin dialog box may not be shown when a large number of notification messages are displayed prior to logon.

36. Adds the ctxcfg -k authdialogs parameter that controls the capability to display Pluggable Authentication Module (PAM) error and warning messages during logon. By default this is disabled and set to 0. Setting it to 1 enables the display of these messages allowing, for example, password expiration messages to be displayed.

37. Fixes an issue with the Management Server Daemon that can stop a server being added to a farm with over 50 servers.

38. Fixes an issue that prevents the logon dialog box being redisplayed after an unsuccessful logon attempt in seamless mode.

39. Fixes an issue where the window manager can fail immediately after logon when a session is started in seamless mode.

40. Fixes an issue where the IconifyByUnmapping setting was ignored when minimizing windows in desktop mode using the Citrix window manager. The setting is no longer ignored if an icon manager is being used.

41. Fixes an issue where the window manager may crash when putting a seamless session into a disconnected state.

42. Adds support for HP-UX 11iv3 on PA-RISC.

43. Adds the ability to load balance a server based on actual system load as reported by the 1, 5, and 15 minute run queue averages. You can base the way the server load is calculated on a number of parameter settings; you can control the effect of those settings on the server load by assigning a series of weightings to each parameter that establish its importance compared to the other parameters. The ctxbal utility is provided to set and adjust the load balancing parameters and is described in more detail in the ctxbal man page.

44. Adds support for HDX Image Acceleration, that enables the use of lossy image compression to speed graphics updates over slow network links. This feature is controlled by the 'lossycompthreshold' and 'lossycompquality' keywords passed to the ctxcfg command. More information can be found in the Citrix XenApp for Unix Administrator's Guide. This is a Subscription Advantage feature.

45. Provides the mechanism to allow administrators to configure the product as XenApp for UNIX, with Feature Pack 2. This is achieved by running the ctxlsdcfg -m FeaturePack2 command. To operate the product in this mode, valid licenses for Feature Pack 2 capabilities must be available. Further information about the capabilities of XenApp for UNIX, with Feature Pack 2 can be found in the Citrix XenApp for Unix Administrator's Guide. This is a Subscription Advantage Feature.

46. Fixes an issue where the ctxwm window manager may crash following a session disconnect.

47. Fixes an issue where the XML service could become unresponsive after receiving a large number of improperly formed requests during periods of heavy use.

•  

  o Solaris 8 SPARC 1-21-108993-66-1

  o Solaris 9 SPARC 1-21-112960-45-1

  o Solaris 10 SPARC 1-21-120036-07-1

  o Solaris 10 x86/x64 1-21-120037-11-1

Installation Instructions

Citrix recommends that you install this hotfix on ALL of the servers running Version 4.0 in your configuration.

1. Check the free space requirements at the top of this README, then download the hotfix file to a suitable directory on the server on which you want to install the hotfix.

2. Untar and uncompress the file, by typing:-
compress -dc PSE400SOLX062.tar.Z | tar xvf -

3. Ensure there are no users logged on and stop the server, using the ctxshutdown command.

4. Log on as root.

5. In the directory containing the PSE400SOLX062 directory, install the hotfix by typing:-
patchadd -M . PSE400SOLX062
Note: If you want to uninstall this patch, make sure you perform step 3 and stop the server.

Usage Notes, Restrictions, and Known Problems

License Sharing Mechanisms.

License sharing occurs when sessions are started on multiple products from a common client device. By default, sessions from XenApp for UNIX can now share licenses with sessions from all supported XenApp and Citrix Presentation Server for Windows releases with current Hotfix Rollup Packs installed. Previously license sharing was restricted to only certain older releases of Citrix Presentation Server for Windows. To revert to historical license sharing mechanisms, run the command

ctxlsdcfg -c 4.0

and to switch back to the new license sharing mechanism, run the command

ctxlsdcfg -c post4.0

Note that changing the compatibility setting affects the way licenses are allocated by the license server. For this reason, Citrix recommends that you ensure all users are logged off before running this command. If this recommendation is not followed and it is established licenses have not been returned after these users have logged off, a restart of the license server will return them for reuse. More information can be found in XenApp for UNIX Administrators Guide, available from the Citrix website.

Files Updated

Links Updated

Contact Information

Citrix Systems, Inc.
851 West Cypress Creek Road
Fort Lauderdale, Florida 33309 USA
954-267-3000
http://www.citrix.com/

Copyright © 2010 Citrix Systems, Inc. All rights reserved.
Citrix and Citrix Presentation Server are registered trademarks and Citrix XenApp is a trademark of Citrix Systems, Inc. in the United States and other countries.
All other trademarks and registered trademarks are the property of their respective owners.