Product Documentation

About Citrix Licensing 11.12.1 (Builds 14008 and 14100)

Mar 13, 2017

What's new

  • Citrix Licensing Customer Experience Improvement Program (CEIP) and Call Home — Voluntary data collection programs in which Citrix products gather anonymous or identified configuration, performance, error, and usage data from your deployment and automatically send the data to Citrix. For more information, see Citrix Licensing Customer Experience Improvement Program (CEIP) and Call Home. (Build 14100) Not supported with License Server VPX.
  • License Server installation — The new enhanced License Server installer UI matches other Citrix product installers. (Build 14008 and 14100)
  • Clustering — This version of Licensing, updates and simplifies the installation for the Microsoft Failover Cluster environment. (Build 14008 and 14100) Not supported with License Server VPX.
  • Supplemental Grace Period — This feature enables users to connect to a product for a limited time even if all licenses are in use and gives administrators time to address the problem. The default Supplemental Grace Period is 15 days. (Build 14008 and 14100) Not supported with License Server VPX.
  • Licensing alerts in Citrix Studio — Studio now displays comprehensive licensing alerts when you are in the licensing node. (Build 14008 and 14100) Not supported with License Server VPX.
  • Licensing alerts in Citrix Director — Director now displays alerts making you aware of issues that might impact user connections. Director also displays a recommended action to correct the condition. (Build 14008 and 14100). Not supported with License Server VPX. Some of the conditions displayed in Director are:
    • All licenses have expired.
    • Licenses are about to expire.
    • Citrix license grace period has expired
    • The Supplemental Grace Period is active and all installed licenses are currently in use.

Fixed issues

  • This fix addresses a security vulnerability (GNU Bash Shellshock) for Licensing Server VPX. For more information, see http://support.citrix.com/article/CTX200217.
  • This fix addresses a security vulnerability (Poodle SSLv3.0) for Licensing Server VPX by disabling SSLv3.0. [#510369]
    Important: If your deployment requires SSLv3.0, you can enable it using this procedure. Be aware that enabling SSLv3.0 will make your deployment vulnerable to Poodle SSLv3.0.
    1. Stop the Citrix licensing service: >service citrixlicensing stop.
    2. Create a backup of the server.xml file by copying it to temporary location. You can then restore the backed up file if necessary. The server.xml file is at /opt/citrix/licensing/LS/conf/server.xml.
    3. Open server.xml for editing and remove the sslProtocol attribute under the configuration > webServer node. Before editing, the webserver node should look like this:
      <webServer certificateFile="conf/server.crt" certificateKeyFile="conf/server.key" documentRoot="web" logRoot="logs" maxRequestSize="4" maxThreads="10" pageSize="20" port="8082" redirectHTTP="false"  
                                                      securePort="0" 
                                                      sslProtocol="-ALL +TLSv1"> 
      
    4. Start the Citrix licensing service: >service citrixlicensing start.
  • You can specify no more than 32 characters when adding Active Directory groups from the License Administration Console. [#539493]
  • 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]
  • You cannot import licenses containing a parentheses in the pathname. [#0264908]
  • The Overwrite Vendor Daemon Log checkbox is not saved properly. [#00115207]
  • If you do use Desktop Studio to initially point XenDesktop to the License Server VPX, the following condition might occur - CtxLSPortSvc is consuming 100% CPU on VPX. If this happens, restart the licensing support service by logging onto the License Server VPX console as root. Within the shell, execute /etc/init.d/citrixlicensingsupportservice restart.
  • 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]

  • 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]

Known issues

This section contains:

  • Installation issues
  • Other known issues
  • Other known issues and considerations - License Server VPX Only
  • License files
  • Product-specific issues

Installation issues

  • To install License Server using PowerShell Remoting or deploy with Group Policy Objects, set the environment variable FORCE_NO_SERVICE=1 on the target system. [#507466]
  • 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 http://support.microsoft.com/kb/2568645. [#232365]
  • During the installation, the Configuration page is presented. If you choose not to configure the License Server, you can configure it at a later time. You must restart the License Server installer or use the configuration tool. You can open the tool from: C:\Program Files\Citrix\Licensing\LS\resource\Licensing.Configuration.Tool.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 and greater 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 installation might fail if the User Account Control (UAC) is enabled when installing on a cluster. [#0484356, #0486196]

Other known issues

  • If you enable https port redirection in the License Administration Console, udadmin might not connect to the License Server. [#543418]

    Workaround:

    1. Disable Redirect non-secure web access to secure web access.
    2. Restart Citrix Licensing service, creating a firewall rule to block incoming access to the HTTP Port the License Administration Console uses.
    3. Inform users to access the License Administration Console using the HTTPS port.
  • For Windows only — Citrix Licensing 11.12.1 for Windows might be vulnerable to the Padding Oracle On Downgraded Legacy Encryption (POODLE) vulnerability. POODLE affects older standards of encryption - Secure Socket Layer (SSL) version 3 but not the newer encryption method Transport Layer Security (TLS). The workaround to mitigate a security issue is documented at http://support.citrix.com/article/CTX200265. [#0512929]
  • If you upgrade an older, existing cluster to 11.12.1, the message, "The installation drive is not part of the selected cluster group. Select the correct cluster group or add the drive to the selected group." displays. To successfully use the new 11.12.1 clustering features, you must uninstall any License Server older than 11.12.1. The older License Servers do not conform to current Microsoft cluster guidelines.
  • 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 and 11.12.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.

  • On non-English platforms, when starting a License Service installation on a cluster node, the Cluster Group list on the Configure screen might contain the system default Cluster Group. Select one of the non-default Cluster Groups and the installation continues normally. [#0497524]

Other known issues and considerations - License Server VPX Only

  • Studio does not display license usage information or manage the License Server. Use the License Administration Console that ships with the License Server to display license usage, manage License Server users, and upload licenses.
  • When configuring XenDesktop 7.0 - 7.13 or XenApp 7.5 - 7.13, use the PowerShell Set-Configsite cmdlet to point to License Server VPX. If doing a fresh install, install and configure XenDesktop and XenApp using its installer, and then use PowerShell to reconfigure and point to License Server VPX.
    Set-ConfigSite -LicenseServerName <DNS_name/IP_of_licence_server> -LicenseServerPort <port>
    
  • Clustered License Servers are not supported for VPX. You can use the High Availability (HA) feature on XenServer 5.6 and later.
  • Ports 1-1024 are reserved by the operating system. When configuring the VPX ports, use ports above 1024. If you use SSL, use port 10443, which is open in the firewall. If you choose a different port for SSL, reconfigure the firewall in the iptables.
  • Upgrades are not supported for License Server VPX.
  • The License Server VPX does not support Active Directory.
  • When the vendor daemon CITRIX is down or stopped, a Critical Alert does not appear in the notification panel. [#450894]

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. 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.

  • 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 that needs license validation, 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 (for example, XenDesktop Controller).

Product-specific issues

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]

Finding information for your version of licensing

See the tables below for a list of license server versions and their associated documentation.

Important: Citrix does not provide hotfixes for license server components and does not support older license servers with newer products. The latest versions of the license server often contain resolutions to issues appearing in earlier versions. When you upgrade or install new Citrix products, upgrade the licensing components as well. New license servers are backward compatible and will work with older products and license files; however, new products often require the newest license server to check out licenses correctly. You can find the latest version from the Citrix Downloads site.

To find your license server version number

If you are unsure if your license server version is current, you can verify it by comparing your version with the number on the Downloads site.

On a license server with the License Administration Console:

  1. Start the License Administration Console from the programs menu: Citrix > Management Consoles > License Administration Console.
  2. Click Administration and select the System Information tab. See the release version in the information list.

On a license server without the License Administration Console:

  1. Open the Registry Editor (Start > Run > regedit).
    Note: Use Registry Editor to view the license server information only. Editing the Registry can cause serious problems that may require you to reinstall your operating system.
  2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\LicenseServer\Install.

    The version number appears in the Version key in the format: 11.12.1.0 build 14100.

    On servers running Windows 2008 Server 64-bit the registry key is

    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\LicenseServer\Install