License files 编辑

Before you start installing product licenses, see the prerequisites to obtain your license files.

When you install the License Server, a Citrix start-up license (citrix_startup.lic) and an options file (CITRIX.opt) are installed by default. To license your Citrix products, you add one or more license files. For information about adding your product licenses, see Install licenses.

You cannot change the location of license files on the License Server. License files must reside in their default location.

Citrix Start-up license

The start-up license file (citrix_startup.lic) is a text file that Citrix products use to communicate to the License Server using a continuous open connection. Every five minutes the License Server and the product send a heartbeat message to each other to verify that they are mutually communicating. When the product and License Server exchange heartbeat messages and there is an interruption in the exchange, the product goes into a grace period. A power failure is an example of an interruption. The startup license file does not affect your license count.

Citrix License Server Diagnostics License

The License Server uses Citrix License Server Diagnostics License for internal diagnostics and alert message notifications displayed in Citrix Studio and Director. It is available by default with the startup license in the citrix\_startup.lic file.

Warning

Do not edit the startup license file, or any other license files.

License file

The license file is a text file containing the following:

• Product licensing information
• License Server name (or other binding identifier)
• Customer Success Services membership renewal date (also known as the Customer Success Services expiration date)
• License expiration date (if applicable) and other system information

• SaaS attribute, only if it’s a Hybrid Rights license

  

All this information is encrypted using a digital signature. When you purchase a Citrix product, go to the citrix.com website to download a license file. For more information, see Manage licenses on Citrix.com. You can have more than one license file per License Server. The license file resides in these directories, where the License Server references it.

• C:\Program Files\Citrix\Licensing\MyFiles directory on a 32-bit server
• C:\Program Files(x86)\Citrix\Licensing\MyFiles directory on a 64-bit server

The License Server uses this file to determine whether to grant a license to a Citrix product.

A license overdraft is included in all user/device, per user, and per device licenses. For more information on the license overdraft, see License overdraft.

Move licenses to a different host

The license file you downloaded for the old License Server cannot be moved to a server that has a different host name or MAC address. Create license files that reference the new server name by returning them and then allocating them.

For more information, see Modify licenses.

License file format

Important

Any changes to the license file can make license files unusable. If using Citrix Licensing for Windows 11.6.1 or later, editing license files is not necessary. You can manage licenses through the Citrix Licensing Manager and the My Account site at citrix.com. For more information, see Manage licenses in MyAccount on citrix.com.

You can change the name of the license file, but it must have a .lic (lower case) extension.

Citrix license files use the following naming convention:

FID_fulfillmentID.lic

For example: FID_30d0000_0000_xxxx_c800_00xxyy000zz7.lic

License files are composed of lines listing specific information, such as the server name (SERVER) or quantity of licenses (INCREMENT). These lines begin by using words denoting their purpose in uppercase letters, such as VENDOR, SERVER, INCREMENT, USE_SERVER.

The following sections provide in-depth information about the following elements of license file syntax: the SERVER line, VENDOR line, USE_SERVER line, and INCREMENT line.

The following image is an example license file:

1. SERVER line shows an identifier required for binding licenses to the License Server.

2. VENDOR line specifies the Citrix vendor daemon name.

   • SaaS attribute, only if it’s a Hybrid Rights license

     

3. INCREMENT lines specifies the license required to use a product.
4. Comments used by the License Server to translate license FEATURES (PRODUCT_EDITION_LICENSEMODEL) to Citrix product names.

SERVER Line

The SERVER line specifies the binding identifier (also known as the host name) of the License Server.

Caution:

Do not change the binding identifier on the SERVER line otherwise, the license file doesn’t work.

Syntax:

SERVER this_host ether

Or

SERVER this_host HOSTNAME=hostname

Example

SERVER this_host HOSTNAME=license_server1