Administration without a console

There are several administration procedures that you can do without using the Citrix Licensing Manager or the License Administration Console. We recommend that you use the appropriate console whenever possible. This article describes the procedures required if you are unable to use a console.

  • Combine license files
  • Customer Success Services renewal files
  • Delete license files
  • Disable domain name truncation on Windows
  • Install license files
  • Reallocate license files
  • Redownload license files
  • Register the License Server with Citrix Cloud

Manage licenses with All Licensing Tools at citrix.com My Account

licensing-tools

Combine license files

  1. From a Web browser, go to http://www.citrix.com.
  2. Click Sign In > My Account and enter your user ID and password.
  3. Select All Licensing Tools.
  4. From the main menu, select Redownload.
  5. Use the By Host tab (to combine automatically all specified licenses allocated to a host ID in to single line item). Click Select All to select all items on all pages
  6. Click the Page check box to select all items on that page, or select the check boxes preceding the licenses that you want to download.
  7. Click Download and save the files to a temporary folder (remember the name of the file and location where you downloaded the file. You need this location).
  8. At a command prompt, navigate to the folder and type the following command:

    lmreread -c @localhost -all

Install license files

  1. From a web browser, go to http://www.citrix.com.
  2. Click Sign In > My Account and type your user ID and password.
  3. Select All Licensing Tools.
  4. From the main menu, select Allocate.
  5. Follow the process to allocate and generate your file.
  6. Select the licenses you want to download, choose Download, and save the file to a directory.
  7. At the License Server, copy the license file from the directory where it was saved to the myfiles directory.
    • C:\Program Files\Citrix\Licensing\MyFiles on a 32-bit computer
    • C:\Program Files (x86)\Citrix\Licensing\MyFiles on a 64-bit computer

Tip

Ensure that the license file retains the .lic (case sensitive) file name extension. Some copy processes do not recognize a file type for that extension and add a “.txt” file name extension during the copy. License files that have the wrong file name extension cannot be imported.

At a command prompt, navigate to:

  • C:\Program Files\Citrix\Licensing\LS on a 32-bit computer
  • C:\Program Files (x86)\Citrix\Licensing\LS on a 64-bit computer

And type the following command: lmreread -c @localhost -all

Reallocate license files

  1. From a web browser, go to http://www.citrix.com.
  2. Select Sign In > My Account and type your user ID and password.
  3. Select All Licensing Tools.
  4. From the main menu, select Reallocate.
  5. Select the check box preceding the licenses you want to reallocate, then click Continue.
  6. Follow the instructions to select the licenses to reallocate in to the new file (and associated with a new License Server) and download the license file.
  7. Save the file to a temporary folder (remember the file name and location where you downloaded the file; you need this location).
  8. At a command prompt, navigate to the folder and type the following command:

    lmreread -c @localhost -all

Redownload license files

  1. From a Web browser, go to http://www.citrix.com.
  2. Select Sign In > My Account and type your user ID and password.
  3. Select All Licensing Tools.
  4. From the main menu, select Redownload.
  5. Select Select All to select all items on all pages. Check the Page check box to select all items on that page, or check the check boxes preceding the licenses that you want to download.
  6. Select Download and save the file to a temporary location. Remember the file name and location where you downloaded the file. You need this location.
  7. At a command prompt, navigate to the folder and type the following command:

    lmreread -c @localhost -all

Customer Success Services

After you download your Customer Success Services renewal license file from citrix.com, you must add it to your license server. Copy the Customer Success Services renewal license files to the same directory as your existing license files and reread the license files. By default, this location is C:\Program Files\Citrix\Licensing\MyFiles on a 32-bit server and C:\Program Files (x86)\Citrix\Licensing\MyFiles on a 64-bit server. After you add the renewal license to your license server, the license automatically unlocks any subsequent versions of the product released during the Customer Success Services period.

Renewing only part of your Customer Success Services membership:

If you run products from two different releases in your environment, and you are not purchasing Customer Success Services for all your licenses, we recommend that you separate the product licenses on two separate license servers. For example, you have a mixed XenDesktop environment of versions 7.16 and 7.18. Customer Success Services is applied to the older product versions first.

Example:

You own 200 licenses for 7.16 and you renew your Customer Success Services membership for only 100 of those licenses. It is possible that connections to computers running 7.18 could consume those 100 renewal licenses, which are required for 7.16.

To separate your licenses (two different licenses on two different servers):

  1. Select a second server and install the license server software.
  2. Go to citrix.com to reallocate your original licenses, and then reallocate the licenses into two new files. These original licenses are contained in your current license file on the original license server.
    • Allocate licenses to your first License Server for your 7.16 deployment.
    • Allocate licenses to create another license file for the second License Server for your 7.18 deployment.
  3. Generate and download your Customer Success Services files and then copy them to the server to which you want them applied.
  4. Point all computers to the License Server running the version of the Citrix product you want them to use. For information about pointing your Citrix product server to the license server, see your Citrix product’s administrator guide.

Delete license files

When you upgrade your edition (for example, Standard to Advanced, or Advanced to Premium) you receive new Citrix product licenses. You can allocate these licenses to one or many Citrix License Servers through license files created at citrix.com. Rescinded licenses must be deleted from License Servers within 90 days of new license purchase. Deleting the licenses enables:

  • License asset management
  • License compliance
  • Delete unnecessary alerts from appearing in the management console

Considerations when deleting files:

  • Incorrect removal of license files might inadvertently lower the total licenses available.
  • Place any new license files on the License Server before deleting any licenses.
  • Delete a license file only when all INCREMENT lines in the file are obsolete or unnecessary. For example, every increment line has been replaced with a new license as a result of an upgrade.
  • If you used the License Administration Console to add license files, you have to update the console UI for any deleted files.

Important

Never delete the options file (citrix.opt) or startup license (citrix_startup.lic).

  1. At the License Server, open the Services panel and stop the Citrix Licensing service.
  2. Open Windows Explorer and navigate to where the license files are stored. By default license files are stored in:
    • C: \Program Files\Citrix\Licensing\MyFiles on a 32-bit server
    • C: \Program Files(x86)\Citrix\Licensing\MyFiles on a 64-bit server
  3. Back up all license (.lic) files.
  4. Using a text editor (we recommend Microsoft WordPad), open each license (.lic) file and identify one or more obsolete license feature INCREMENT lines.
  5. Ensure that all increment lines are obsolete or unnecessary. See License file format for information about increment lines.
  6. Close the file and change the file name extension from .lic to .old.
  7. In the Services panel, restart the Citrix Licensing service.

Disable domain name truncation on Windows

Warning

Editing the registry incorrectly can cause serious problems that might require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

If you host multiple domains and multiple users who have the same user name on different domains (jack@mycompany.com and jack@newplace.com), you can leave domain name truncation enabled. If you have unique users on various domains, ensure that the License Server does not truncate @domain.com.

The License Server detects Citrix Service Provider licenses and enables this functionality.

  1. Locate the registry key:

    For 32-bit machines: HKLM\Software\citrix\licenseserver

    For 64-bit machines: HKLM\Software\Wow6432Node\citrix\licenseserver

    Name: UDUseDomain

  2. Set the registry key to 1.

    Data Description
    0 The domain field is truncated. (default)
    1 The domain field is not truncated.

Register the License Server with Citrix Cloud

  1. On the machine running the License Server, run the executable RegisterLSToCloud.exe. The file is located at C:\Program Files (x86)\Citrix\Licensing\ls\resource.
  2. Provide your Citrix Cloud credentials to log on.
  3. Select Customer.