Product Documentation

Known and fixed issues

Feb 26, 2018

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

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

Other known issues

  • The username is case sensitive in some localized languages. To log on to Citrix Licensing Manager, set thedomain-name\username in UPPER CASE if it contains non-ASCII characters.  [#595621]

  • 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 Citrix Licensing Manager, a blank page might display if the Internet Explorer Enhanced Security Configuration is enabled and the License Administration Console or the Citrix Licensing Manager is not in the Trusted Sites. Workaround: Disable Internet Explorer Enhanced Security Configuration.  [#382429]

  • When you access Citrix Licensing Manager from the Start menu for the first time after installation, an error message might appear on Firefox and Chrome browsers.  [#LIC-195]

  • 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.  [#497524]

Other known issues and considerations - License Server VPX Only

  • After a CEIP upload failure, the log file location doesn't appear in the error message displayed on the Citrix Licensing Manager. The log file location is /opt/citrix/licensing/LS/logs/log_ctxuploader.txt.  [#LIC-396]
  • Sometimes after a few failed attempts to join Active Directory, when the Active Directory integration succeeds,  you might see an LDAP error during the initial configuration of the License Server VPX.

    Workaround: Run and reenter the details.
  • A network error might appear the first time you access the Citrix Licensing Manager from the Chrome browser.

    Workaround: Refresh the page.
  • The user name of the logged on user displayed on the Citrix Licensing Manager page is in the domain\user format. The Citrix Licensing Manager of a License Server for Windows displays the user name as user@domain.
  • When configuring XenDesktop 7.0 through 7.13 or XenApp 7.5 through 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>

  • Ports 1 through 1024 are reserved by the operating system. When configuring the VPX ports, use ports higher than 1024. By default, VPX uses port 8082 for SSL, 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.

License file issues

  • Certain license types are not covered by Citrix Subscription Advantage. Therefore, they appear in alerts in the Dashboard of the License Administration Console indicating that the Citrix Subscription Advantage date is expired. You can ignore such alerts for any license not covered by Citrix Subscription Advantage. This includes Evaluation licenses, Not for Resale licenses, Early Release licenses and Technology Preview licenses. These types of licenses do not need Citrix Subscription Advantage and your Citrix products do not stop working when the Citrix 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 Citrix Subscription Advantage date.  [#231847]

  • The License Server ignores license files with multiple lines referencing HOSTNAME=. 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 documentation.)
    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 documentation for information about changing these settings.)
    4. If the problem persists, restart the product server (for example, Delivery Controller).

Fixed issues

Fixed in VPX Build 23101:

  • Incorrect installed license information is displayed in the historical usage report. [#LIC-405]

  • Openssl upgraded from 1.0.2l to 1.0.2n to include security fixes. [#LIC-404]

Fixed in VPX Build 19800:

  • Citrix License Server VPX, Build 17000. Using https://FQDN:8082 to access the License Administration Console, might cause the CITRIX daemon to exit. To recover, restart the License Server.  [#LIC-313]
  • In License Server Configuration on the License Administration Console, don't choose Default Port for the License Server Manager and restart Citrix Licensing Service. Choosing this option results in an inaccessible License Server.  [#LIC-180]

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

  • The License Server VPX does not support Active Directory.

Fixed in Build 22103:

  • The Citrix Licensing Administration Console version 21103 incorrectly displays the version number as v11.14.1.1. The correct number is

  • When using the Citrix Licensing Manager to install another license, a distorted display of the installed licenses information might appear on the right side of the screen.  [#LIC-282]

  • In the Citrix Licensing Manager Server Configuration page, changing the language to French or German might cause an error. If this error occurs, the Historical Usage drop-down menus are empty.  [#LIC-317]

Fixed in Build 20104:

  • When you try to start the Citrix Licensing Manager and Firefox is the default browser, the Citrix Licensing Manager is inaccessible and Firefox displays a generic error message.  [#LIC-107]

  • Failed Citrix Licensing Manager upload notifications are not deleted after you disable CEIP and Call Home.  [#LIC-188]

Fixed in Build 18001:

  • This fix deletes occasional rogue characters from the Citrix License Management Console.  [#LC5354]

Fixed in Build 17005:

  • lmhostid returns blank when it is queried to return an IPv6 type of address.  [#621679]

Fixed in Build 17000:

  • The udadmin command might not delete licenses when there is an apostrophe in the device name.  [#LIC-142]

  • Assigning a busy port to the vendor daemon or License Administration Console might result in the vendor daemon going down or the Licensing Administration Console becoming inaccessible.  [#LIC-65]
    • Windows - The vendor daemon goes down if you update the vendor daemon port by using a port that is already busy followed by a service restart. Access the License Administration Console and update the vendor daemon port by using a valid free port followed by a restart to restore License Server.
    • VPX - This situation requires a support call.