Product Documentation

Known and fixed issues

Aug 14, 2017

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, seehttp://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.

    [#388512]

Other known issues

  • When using Internet Explorer 9 or 10, the Citrix Licensing Manager page might be blank or icons might not display. One of these items might be the reason:
    • Compatibility view mode is Off - Turn on Compatibility View mode.
    • Browser scripts are disabled - Enable browser scripts.
    • Caching of active documents is enabled - Navigate to Internet options > Advanced > Security and clear Do not save encrypted pages to disk.
  • 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

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

    Workaround: Choose the Use this Port option, fill in a free port number, and then restart the Citrix License Service.

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

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

  • The License Server VPX does not support Active Directory.

License file issues

  • Certain license types are not covered by Subscription Advantage. Therefore they 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]

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

Fixes issues

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. 
    Workaround: Use a backslash to escape the apostrophe. For example, udadmin.exe -f XDT_PLT_UD -device "jim\'s" -delete

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

    [#LIC-65]