Product Documentation

About Citrix Licensing 11.11.1

Mar 17, 2015

What's New

Citrix Simple License Service - Enables allocation and installation of license files on a license server using a web page interface. Connect to the Simple License Service locally with the Start menu shortcut or remotely with the Simple License Service URL.

Citrix Web Services for Licensing - Replaces the Citrix Licensing Configuration Service. The enhanced Citrix Web Services for Licensing provides similar functionality for newer product consoles, as well as additional functionality.

IPv6 and IPv4 - This release supports pure IPv4, pure IPv6, and dual-stack deployments that use overlapping IPv4 and IPv6 networks.

Fixed issues

  • This release of the Simple License Service displays in English only. [#0310912]

Known issues

This section contains:

  • Installation issues
  • Other known issues
  • Simple License Service
  • License files
  • Event log viewer messages
  • Product-specific issues

Installation issues

  • If Citrix Licensing is installed in a clustered environment and Windows Firewall is enabled (the default configuration for Windows 2008), connections can fail. Connecting remotely to the console or checking out licenses works until failover occurs in the cluster. Exception rules for CITRIX.exe and lmadmin.exe are created during installation of Licensing and Simple License Service, but do not work after a cluster failover. To work around this issue, create exceptions for Licensing components on the Exceptions tab of the Windows Firewall panel. Create an exception for each of the following ports: Console Web Server port (default port is 8082); License Server Manager port (default port is 27000); Simple License Service port (default port is 8083); and Vendor Daemon port (default port is 7279). This issue occurs with Windows Server 2008 (32-bit and 64-bit), Windows Server 2008 R2, and Windows Server 2012. For more information, see [#232365]
  • At the end of installation, the "License Server Configuration" tool is presented. If you choose to cancel on this page, the license server does not start. You must reopen the License Server Configuration tool and finish the settings before the license server can start. You can open the tool from: C:\Program Files\Citrix\Licensing\LS\resource\LSPostConfigTool.exe. If the License Server Configuration tool fails for any reason, uninstall and reinstall the license server.
  • During installation, localized characters in the installation path can cause the installation to fail. Accept the default installation path or enter only ASCII alphabetic letter characters for the installation directory. [#229456]
  • When configuring the product-side setting for the license server name, do not use localhost. Though you can use the host name, IP address, or FQDN instead, Citrix recommends you use the FQDN. [#165986]
  • When you have the Citrix License Server 11.11.1 installed and then install XenDesktop 5.6, the 30-day free trial license is the only license available to you. Workaround: Accept the trial license and complete the installation. Use Desktop Studio to change the product edition and license model settings after the installation. [#0388512]
  • The user list for the License Administration Console and the Citrix Simple License Service web page does not support non-ASCII characters in user/group names. Due to this limitation, on a Russian operating system, the BUILTIN Administrators group is not added to the user list, as it is created with non-ASCII characters. This applies to both fresh installs and upgrades. Any users belonging to the BUILTIN Administrators group in an earlier release of XenDesktop and the Simple License Service will not have access to the License Administration Console or the Simple License Service after an upgrade.

    As a workaround, add ASCII-character versions of Russian users/groups names post installation using the License Administration Console interface. Alternatively, install the license server on one of the other supported operating systems. [#0395305]

Other known issues

  • If you include a backslash in a locally managed user name (for example, test\), you cannot delete the user. [#0270349]
  • Changing the licensing port after licenses are installed might cause the No such product or vendor exists: CITRIX message to appear on the Dashboard instead of the installed licenses. [#0269423]
  • When a locally managed user having an administrator role does not exist, a domain administrator can only add domain users or groups as administrators to the license server. To edit and delete domain administrators or groups on the User Configuration page in the License Administration Console, a locally managed user having the Administrator role must exist. [#0263016 and #0269719]
  • In the License Administration Console, localized characters in user names and passwords can display with unexpected results. To avoid this issue, use US-ASCII alphabetic letter characters for user names and passwords in the License Administration Console. [#0272738, #0273089, #0156833, #0156839, #0156969, #223870, #242767]
  • When you try to start the License Administration Console or the Simple License Service, a blank page might display if the Internet Explorer Enhanced Security Configuration is enabled and the License Administration Console or the Simple License Service is not in the Trusted Sites. Workaround: Disable Internet Explorer Enhanced Security Configuration. [#382429]
  • Older Desktop Studio releases (prior to XenDesktop 7 Studio) using this version of the license server do not display license usage information or manage the license server using the Licensing Node. This version of the license server is fully compatible with XenDesktop and can serve licenses for any Citrix product deployment. If you continue to use an older Desktop Studio, use the License Administration Console that ships with the license server to display license usage, manage license server users, and upload licenses. If you are using a version of XenDesktop prior to the XenDesktop 7 and you upgrade from earlier versions of Citrix License Server for Windows to version 11.11.1, you might see the following warning:

    Warning: Installing this update removes the Licensing Configuration Service. As a result, all versions prior to this release of Studio provide only limited licensing information.

Simple License Service

  • When you start the Simple License Service from the Start menu shortcut, the Chrome browser might become unresponsive. Workaround: Type the Simple License Service URL directly into the Chrome browser. [#0314254]
  • If the License Administration Console is disabled in your XenDesktop installation, only administrators can use the Simple License Service. To allow users access to the Simple License Service, enable the License Administration Console with Desktop Studio or the Set-LicLACEnabledState PowerShell cmdlet, and then configure the users. [#0311191]
  • If you configure the Simple License Service with a port that Firefox or Chrome blocks, you must add an exception to the browser settings. Note that if you start the Simple License Service from the Start menu shortcut and you have the exception set, Chrome ignores it. [#0313924]
  • The firewall rule is not removed if you uninstall the Simple License Service after uninstalling the License Server 11.6.1. Workaround: Uninstall the Simple License Service before uninstalling the License Server 11.6.1. [#0305195]
  • When doing a silent installation of the Simple License Service on a 32-bit or 64-bit Windows 2003 or Windows 2008 server with a nonadministrator account, the installation fails and an event log error might not be produced. [#0305202]

License files

  • Certain license types are not covered by Subscription Advantage and therefore appear in alerts in the Dashboard of the License Administration Console indicating that the Subscription Advantage date is expired. You can ignore such alerts for any license not covered by Subscription Advantage. This includes Evaluation licenses, Not for Resale licenses, Early Release licenses and Technology Preview licenses. These types of licenses do not need Subscription Advantage and your Citrix products do not stop working when the Subscription Advantage date is expired. You can verify the status of any license for which you receive an alert by clicking the license on the Dashboard. The license information expands to show the license type (such as Technology Preview), the license expiration date, and the Subscription Advantage date. [#231847]
  • 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 Administration Console displays the following error message: "…Error List Returned…Unknown Host."

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

  • After you replace evaluation license files on the license server with new license files, the Citrix product might continue to display the following 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 Delete license files in Citrix eDocs.)
    2. At the license server, restart the Citrix Licensing 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 documentation for information about changing these settings.)
    4. If the problem persists, restart the product server.

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 licensing client is communicating with a different version of the Citrix License Server. Ignore this message.

  • After upgrading the license server, messages such as the following example might appear in the Event Log Viewer (product may vary from this example):

    A provider, MgmtEventProv, has been registered in the Windows Management Instrumentation namespace Root\Citrix\Management to use the LocalSystem account. This account is privileged and the provider may cause a security violation if it does not correctly impersonate user requests.

    Ignore the message. The upgrade is successful. [#207927, #183919]

Product-specific issues

Access Essentials / XenApp Fundamentals

  • After installing Licensing 11.10 and starting the Quick Start tool, a .NET Framework error message indicates that “The service object for the service “CitrixLicensing” could not be acquired. Probably not installed or there is a permission problem.” This issue occurs in Access Essentials 2.0 or XenApp Fundamentals 3.0. To resolve the issue, uninstall Licensing 11.6.1 Build 10007 and install Licensing 11.6.1 Build 9020, available from the License Server Downloads page. [#232048]
  • Before installing the license server version 11.10 on systems running Access Essentials 2.0, you must install Hotfixes AEE200W2K3001 and AEE200W2K3002. Failure to do so might render Access Essentials inoperable.

Citrix Branch Repeater with Windows Server

  • If you install the same license twice, the second time may trigger a change in the Send Bandwidth Limit, which will be set to the maximum licensed speed. To solve this issue, do not install the same license twice. If you must do so, verify that the Send Bandwidth Limit is set correctly. [#53894]

Citrix MetaFrame Access Suite 3.0

  • Upgrading licensing from Citrix MetaFrame Access Suite 3.0 to a newer version of licensing. During the upgrade process of the license server, the licensing components are detected as installed but there is a prompt to remove them. You cannot upgrade licensing in a Citrix product that has licensing 1.0.0 installed as it is incompatible with the licensing that is used in Citrix products today. Uninstall the licensing components and reinstall the latest version. [#217704]

Citrix XenApp Management Pack

  • Details about the Citrix License Server are always blank on the Monitoring tab of the System Center Operations Manager for Citrix Managed Servers. There is no workaround for this issue. [#192159]