Citrix® Licensing 4.5 for Windows

Readme

Note: To use the products available for this release, you must upgrade your Citrix License Server to the version available on the product CD. Your existing license files and products are compatible with the new license server. For information about upgrading your license server, see the Citrix whitepaper Licensing: Migrating, Upgrading, and Renaming (CTX108655) in the Citrix Knowledge Center.

Readme Version: 1.5

Notes:

• For the most up-to-date version of this readme file, click here
• For the latest critical updates for Citrix products, see http://support.citrix.com/criticalupdates
• For information about new features and system requirements, see the Getting Started with Citrix Licensing Guide

Contents

• Finding Documentation
• Getting Support
• Known Issues in this Release
• Product-Specific Issues
• Citrix Presentation Server 4.5 with Feature Pack 1 Issues

Finding Licensing Documentation

You can find the licensing publications documents in the Citrix Knowledge Center Licensing Information page (http://support.citrix.com/licensing/) under the "Top Licensing Resources" title. The set includes: The Getting Started with Citrix Licensing Guide, the Licensing for Windows readme, and 13 whitepapers that cover more specific licensing tasks not covered in the Getting Started with Citrix Licensing Guide.

To view, search, and print the PDF documentation, you need Adobe Reader (supported versions: Acrobat Reader 5.0.5 with Search through Adobe Reader 7.0). You can download Adobe Reader for free from the Adobe Systems Web site. Documentation is available on the Citrix Knowledge Center Web site (select Product Documentation). Updates to Citrix technical manuals are posted on the Web site.

To provide feedback about the documentation, go to www.citrix.com and click Support > Knowledge Center > Product Documentation. To access the feedback form, click the Submit Documentation Feedback link.

Getting Support

Citrix provides technical support primarily through Citrix Solutions Advisor. Contact your supplier for first-line support or use Citrix Online Technical Support to find the nearest Citrix Solutions Advisor.

Citrix offers online technical support services on the Citrix Support Web site. The Support page includes links to downloads, the Citrix Knowledge Center, Citrix Consulting Services, and other useful support pages.

For licensing issues that cannot be resolved by the Getting Started with Citrix Licensing Guide and/or the Support Forums, contact Customer Care at 1-800-4CITRIX (1-800-424-8749) Monday through Friday, 7am – 10pm EST. We will attempt to respond to all questions within 48-72 hours.

Known Issues in this Release

For the most up-to-date version of this list, click here.

The following is a list of known issues in this release. Read it carefully before installing the product.

• Installation Issues
• Other Known Issues

Installation Issues

Important: Before you install this product, make sure you consult the Pre-Installation Update Bulletin. The bulletin offers late-breaking information and links to critical updates to server operating systems and to Citrix installation files. Download and install the updates or you may not be able to install this product properly.

• When installing Citrix Licensing on a Windows operating system that is running in Japanese, Simplified Chinese, Traditional Chinese, or Korean, do not use multibyte characters in path names. [#73148]
  
• Double-clicking the CTX_licensing.msi file in the German, French, Spanish, and Japanese Server-CD folders runs the licensing setup in English. To access the licensing setup program in one of these languages, access it from Autorun or the command-line specific to the language. [#113417]
  
• To install Citrix Licensing using Active Directory, you must apply the ActiveDirectoryLicensingInstallSupport.mst transform file. [#76996]

Unattended Installation or Upgrade

Before you perform an unattended installation of Citrix Licensing you must install or upgrade to the Java Runtime Environment (JRE) version that is on your product CD. The version included on the CD may differ depending on your product. To install the JRE from the command line, type:

• If your CD contains JRE 1_5_0_06: jre-1_5_0_06-windows-i586-p.exe /L1033 /v"/qn REBOOT=ReallySuppress REBOOTPROMPT=Suppress ADDLOCAL=ALL WEBSTARTICON=0 AUTOUPDATECHECK=0 IEXPLORER=1 MOZILLA=1”
• If your CD contains JRE 1_5_0_09: jre-1_5_0_09-windows-i586-p.exe /lang=1033 /v"/qn REBOOT=ReallySuppress REBOOTPROMPT=Suppress ADDLOCAL=ALL WEBSTARTICON=0 AUTOUPDATECHECK=0 IEXPLORER=1 MOZILLA=1”

[#83379] [#150474]

Uninstalling Licensing

To remove Citrix Licensing from a computer, Citrix recommends that you uninstall it using Add/Remove Programs.

Files Remaining after You Uninstall Citrix Licensing

• C:\Program Files\Citrix\Licensing\LS\ reportlog.rl
• C:\Program Files\Citrix\Licensing\MyFiles\CITRIX.opt
• C:\Program Files\Citrix\Licensing\MyFiles\citrix_startup.lic
• C:\Program Files\Citrix\Licensing\MyFiles\ *.lic
  

Note: On a 64-bit Windows platform, the default directory is C:\Program Files (x86)\Citrix\Licensing\

Other Known Issues

Microsoft Clustering for Citrix License Server

If any of the licensing services (including CitrixLicensing, the Citrix License Management Console, or the Citrix Licensing WMI services) fail to start, the cluster detects that licensing is offline and attempts to restart the service three times (by default).

If these attempts are unsuccessful, failover to the next node is initiated and the cluster attempts to start the services on the second node. If the attempts fail on the second server, the process may enter into an infinite loop. In this case, the computers running Citrix products fall into the grace period. During the grace period, client connections are not affected.

License Management Console

• Netscape 7.0 is not supported for use with the License Management Console. If you attempt to use it, the console does not display the logon dialog box. Use Netscape 7.1 or later instead because NTLM authentication is supported as of Netscape 7.1. [#96482]
  
• When running the License Management Console in Netscape 7.1 in an Apache Web server environment, users cannot log on remotely when running Windows 95, Windows 98 Second Edition, and Windows Millennium Edition. The logon dialog box does not appear because these operating systems are not supported. [#109734]

• If you are running an English version of a Windows operating system with a Japanese, Simplified Chinese, Traditional Chinese, or Korean supplemental language pack installed, you cannot log on to the License Management Console using a user name with multibyte characters. [#82831]

License Management Console Reports

• When generating reports, do not close the License Management Console without clicking the Cancel button. If you do not click Cancel, reports continue running. To stop reports from generating after closing the console, restart the Citrix License Management Console service. [#86689]

• Generating product reports with the Percent Installed Licenses data type causes the reporting engine to lock. The License Management Console continues operating after the reporting engine locks. However, you must restart the Citrix License Management Console service before you can generate any further reports. [#107210]

Options File

The GROUPCASEINSENSITIVE command (Options file) is not supported.

License File

• License Files with multiple lines referencing HOSTNAME= are ignored by the license server.

Licenses in these files cannot be checked out. This issue is caused when you download licenses associated to different license server hostnames into the same license file. Any of the following error messages might appear in the Event Log Viewer:

• Event ID: 724 Description: (2196) Invalid license key.
• Event ID: 764 (2196) Wrong hostid on SERVER line in license file.

In addition, the License Management Console displays the following error message on the License Files page: …Error List Returned…Unknown Host.

To resolve this issue, re-download separate license files for each Citrix product tied to different license server names. See article CTX110909 in the Citrix Knowledge Center for additional information.

• When replacing evaluation license files on the license server with new license files, the Citrix product may still display the license expiration message when users log on.

Warning: The following Citrix Product is using an Evaluation license. This license will expire in…

To resolve this issue:

1. Remove the old evaluation license files from the license server. (See the Deleting License Files section in the Licensing: Migrating, Upgrading, and Renaming whitepaper (CTX108655) in the Citrix Knowledge Center for information about deleting license files.)
2. In the License Management Console, click Configure License Server, followed by Update license data. Alternatively, at the license server, restart the CitrixLicensing service.
3. At the Citrix product server, point to a fictional license server and then point the product back to the actual license server. (See your product's administrator's guide for information about changing these settings.)
4. If the problem persists, restart the product server.
   

Start-up License File

Citrix startup licenses can be checked out by one Citrix product from a particular (Citrix) server. This may be caused by a problem with the Citrix.startup.lic license file. See article CTX113090 in the Citrix Knowledge Center for a new Citrix.startup.lic file and instructions for installing the new file.

Event Log Viewer Messages

The following message appears in the Event Log Viewer:

(1224) Client/server comm version mismatch. The client and server programs are running potentially incompatible versions of FLEXnet comm software.

This is an informational message indicating that a Citrix product with a version number of 4.0 (or earlier) is communicating with a newer version of the Citrix License Server (Version 4.5). Ignore this message.

Other Messages

The following message appears in the lmgrd_debug log:

Non-activation-capable daemon activation invoked with non-client-request event type.

Ignore this message.

Product-Specific Issues

Web Interface for Presentation Server

If you install the License Management Console on a 64-bit operating system and then install Web Interface (created for 32-bit mode), opening the License Management Console causes error messages to appear, such as Service unavailable or This page cannot be found and Web Interface fails.

To prevent this problem, install Web Interface first, and then install the License Management Console.

If the problem occurs, try these workarounds:

• Install the Citrix License Server and License Management Console on a computer separate from the one running Web Interface.
• If you must install the Citrix License Server, Licensing Management Console, and Web Interface on the same computer, uninstall and reinstall the license server (after installing Web Interface).
• You might also need to disable “RPC over HTTP proxy.” To do this, from Windows > Control Panel > Add or Remove Programs, select Add/Remove Windows Components, and disable Networking Service > RPC over HTTP proxy, and restart.
  [#150659] For additional information, see article CTX111854 in the Citrix Knowledge Center.

Citrix Presentation Server

During the installation of Citrix Presentation Server, if you specify a license port number other than the default of 27000, the installation accepts the new number; however, after the installation is complete and the server is restarted, the new port number is not retained and licenses cannot be checked out. The Access Management Console displays the default port number of 27000 and the following message appears in the Windows Event Log:

Citrix Presentation Server cannot contact the license server <license_server_name>.

This issue does not appear when you perform a silent installation.

To resolve this issue:

1. Edit all the license files on the license server. (See the Changing the License Manager Daemon Port Number section in the Licensing: Firewalls and Security Considerations whitepaper, article CTX108658 in the Citrix Knowledge Center for this procedure.)
2. In the Access Management Console, in the farm's property screen, reenter the new license port.

[#159220]

Citrix Application Streaming for Presentation Server

If you are running Citrix Presentation Server 4.5, Enterprise Edition and you have a valid Subscription Advantage membership, you are entitled to use the Citrix application streaming feature, but only after you allocate and download the correct feature license file. Note that Presentation Server license files retrieved after August 1st, 2006 will already have the Citrix application streaming feature included in the file and you do not need to download a new file.

To download the license file, log on to MyCitrix and navigate to https://secureportal.citrix.com/mycitrix/launch/ASTlicensing.aspx. Download and copy the appropriate license file to your license server and reread the file. See the Getting Started with Citrix Licensing Guide for detailed information about downloading and rereading a license file.

Citrix Presentation Server 4.5 with Feature Pack 1 Issues

If you are upgrading a Citrix product from an earlier version, see the Licensing: Migrating, Upgrading, and Renaming white paper (CTX108655) in the Citrix Knowledge Center.

• In a mixed Presentation Server environment (4.5 and 4.5 with HRP 1) where load balancing is used, if a user connects to a server where HRP 1 has been applied and then connects to a server that does not have HRP applied, the users checks out two licenses. This is because the HRP 1 changes how the client ID is reported to the license server. There is no workaround. Citrix recommends that you update all servers with HRP 1.

Citrix Systems, Inc.
851 West Cypress Creek Road
Fort Lauderdale, Florida 33309 USA
954-267-3000

http://www.citrix.com/

Copyright © 2007 Citrix Systems, Inc.