Product Documentation

许可证文件格式

Jul 11, 2016

Important

修改可能会导致许可证文件无法使用。 如果使用的是 Citrix Licensing for Windows 11.6.1 或更高版本,您应该永远不需要编辑许可证文件。 您可以通过许可证管理控制台和“我的帐户”站点管理许可证及其任务。

注意:您可以更改许可证文件的名称,但它必须具有 .lic 扩展名。

Citrix 许可证文件采用以下命名约定:license_FID_XDT-PLT-UD_25-mar-2013.lic。

许可证文件由一些列出特定信息(如服务器名称 (SERVER) 或许可证数量 (INCREMENT))的行构成。 这些行以表示其用途的大写字母单词开头,如 VENDOR、SERVER、INCREMENT、USE_SERVER 等。

接下来的各部分提供有关以下许可证文件语法要素的详细信息:SERVER 行、VENDOR 行、USE_SERVER 行、INCREMENT 行和 UPGRADE 行。 虽然选项和许可证文件语法中使用了术语功能,但为清晰起见,本文档中尽可能使用术语产品许可证。

示例许可证文件带有与示例后的说明相对应的数字:


1 SERVER 行

SERVER 行。 SERVER 行指定许可证服务器的绑定标识符(也称为主机名)。
警告:不要修改 SERVER 行中的绑定标识符;否则,许可证文件将不会发挥作用。
语法
SERVER this_host ether
SERVER this_host HOSTNAME=hostname
参数 说明
ether 在其上运行许可证服务器的设备的 MAC 地址。 不要编辑该字符串。
hostname 运行许可证服务器的计算机的名称。 不要编辑该字符串。
示例
SERVER this_host HOSTNAME=license_server1

2 VENDOR 行

VENDOR 行指定了 Citrix 供应商守护程序的名称。

语法
VENDOR CITRIX [vendor_daemon_path]
字段 说明
VENDOR CITRIX Citrix 供应商守护程序的名称。 不要编辑此名称。
vendor_daemon_path Citrix 供应商守护程序可执行文件的路径。 Citrix 建议不要更改此路径。

3 INCREMENT 行

INCREMENT 行描述使用产品所需的许可证。 许可证文件 (*.lic) 包含一个或多个 INCREMENT 行。 每个 INCREMENT 行由用户指定的产品和许可证(用户、连接)计数分配构成。

每个 increment 行包含一个基于该行中数据的签名、在 SERVER 行中指定的 hostid 以及 Citrix 选择的数据。 INCREMENT 行使用反斜杠 (\) 对长文本行进行换行。
语法
INCREMENT feature vendor SA_expiry_date exp_date num_lic \   SIGN=sign [optional_attributes]
警告:不要修改 INCREMENT 行关键字后面的六个字段;它们是必需的,并且其顺序是固定的。
下表按这些字段的显示顺序对其进行说明:
字段说明
feature产品许可证。 不要编辑此行。
vendor指明此许可证用于 Citrix 供应商守护程序。 不要编辑此行。
SA_expiry_date指明一个日期;在该日期之前,您有权进行产品版本升级。 如果您没有专享升级服务成员身份,或者这并非专享升级服务许可证,则该日期表示您订购或赎回许可证的日期。 不要编辑此行。
注意:如果您续订了专享升级服务成员身份并已收到升级许可证,则该行会列出两个日期:
  • 第一个日期为最初购买专享升级服务成员身份的日期
  • 第二个日期为 SA_expiry_date

示例:

INCREMENT MPS_ENT_CCU CITRIX 2005.0311 2007.0311 permanent 1000 \

有关更多信息,请参阅 UPGRADE 行。

exp_date许可证过期日期的格式为 dd-mmm-yyyy,如 07-may-2006。 不要编辑此行。
注意:如果 exp_date 字段包含字符串“permanent”,则该许可证永不会过期。
num_lic本产品许可证的并发许可证的数量。 不要编辑此行。
SIGN=signSIGN= 用于对此 INCREMENT 行进行身份验证的签名。 不要编辑此行。
INCREMENT 行也用来确定管理控制台中许可证的分组。 这些组称为许可证池。 Citrix 供应商守护程序基于共同的属性(如产品许可证或版本)创建许可证池。 当创建新池后,控制台会独立于其他许可证池显示和跟踪此池。 如果两个或更多属性不同,则 Citrix 供应商守护程序会创建新的许可证池。
INCREMENT 行中的 Citrix 属性
INCREMENT 行中也可能包括其他 Citrix 属性。 这些属性提供有关许可证的信息,如许可证的颁发日期,或该许可证为升级许可证。
警告:不要修改或删除这些属性。
示例
在上述示例中,突出显示了重要项目:
  • 产品(许可证功能)以蓝色显示
  • Citrix 专享升级服务过期日期以红色显示(格式:YYYY.MMDD)
  • 许可证(用户、连接)计数以绿色显示
语法
keyword=value
下表描述了 Citrix 属性。 属性的字母大写表示该属性不可编辑。
属性说明
DUP_GROUP=V此属性允许许可证共享相同的客户端设备。
ISSUED=dd-mmm-yyyy颁发日期。
ISSUER="..."许可证颁发机构。
NOTICE="..."您公司的名称。
SN=serial_num用于标识 INCREMENT 行的编号。
START= dd-mmm-yyyy许可证的生效日期。 在许可证的生效日期之前,许可证服务器不能使用这些许可证。
SUPERSEDE="MPS_ADV_CCU MPS_STD_CCU ..."当您升级到更高的产品版本时,此属性会显示在升级许可证文件中。 如果显示该属性,ISSUED= 中指定的日期之前颁发的所有许可证都将被本行取代并因此失效。
VENDOR_STRING="..."Citrix 定义的字符串。
INCREMENT 行中的可选属性
INCREMENT 行中包含几个可以添加、编辑或删除的属性。 如果需要,您可以添加属性。 例如,您可以在文件中的每个许可证旁插入资产标记或采购订单号。 同样,您也可以添加属性,用于指出特定许可证组专门用于您组织的某个部门。
其中的一些属性可由 Citrix 或您的增值经销商插入。
下表中列出了可选属性。 类似于 Citrix 特定的属性,可选属性也使用 keyword=value 语法,其中 keyword 为小写形式。 您可以根据字母的大小写形式区分可选属性与必需属性:可选属性包含小写字母。
属性说明
asset_info= "..."您可以添加的其他资产管理信息
dist_info= "..."软件分销商提供的更多信息
user_info= "..."许可证管理员提供的更多信息
vendor_info= "..."Citrix 提供的更多信息

UPGRADE 行

UPGRADE 行指明专享升级服务成员身份的续订日期和到期日期。
警告:不要修改此行。
语法
UPGRADE feature CITRIX from_Subscription_Advantage_date to_Subscription_Advantage_renewal_date exp_date num_lic \ [options ... ] SIGN=sign
除添加了 from_Subscription_Advantage_date 字段外,其他所有数据与 INCREMENT 行的数据相同。 UPGRADE 行删除最多达到任意旧版本中指定的许可证数量 (>= from_Subscription_Advantage_date) 并使用相同的许可证数量创建新版本。
示例 1
例如,下列行将 ABCD 公司 1000 个 MPS_ENT_CCU 许可证的专享升级服务成员身份续订一年(到期日期为 2006 年 3 月 11 日):
INCREMENT MPS_ENT_CCU CITRIX 2005.0311 permanent 1000 \ VENDOR_STRING=;LT=Retail;GP=96;CL=ENT,ADV,STD;SA=1;ODP=0 \ DUP_GROUP=V ISSUED=12-Mar-2004 NOTICE="ABCD Corporation" \ SN=LA-0000150712-12345:123 START=11-mar-2004 SIGN="1234567"
UPGRADE MPS_ENT_CCU CITRIX 2005.0311 2006.0311 permanent 1000 \  VENDOR_STRING=;LT=Retail;GP=96;CL=ENT,ADV,STD;SA=1;ODP=0 \  DUP_GROUP=V ISSUED=12-Mar-2005 NOTICE="ABCD Corporation" \  SN=RE-0000164638-12345:123 START=11-mar-2005 SIGN="1234567"
示例 2
例如,下列行将 ABCD 公司 1000 个 MPS_ENT_CCU 许可证的专享升级服务成员身份续订一年(到期日期为 2006 年 3 月 11 日):
INCREMENT MPS_ENT_CCU CITRIX 2005.0311 permanent 1000 \ VENDOR_STRING=;LT=Retail;GP=96;CL=ENT,ADV,STD;SA=1;ODP=0 \ DUP_GROUP=V ISSUED=12-Mar-2004 NOTICE="ABCD Corporation" \ SN=LA-0000150712-12345:123 START=11-mar-2004 SIGN="1234567"
UPGRADE MPS_ENT_CCU CITRIX 2005.0311 2006.0311 permanent 1000 \  VENDOR_STRING=;LT=Retail;GP=96;CL=ENT,ADV,STD;SA=1;ODP=0 \  DUP_GROUP=V ISSUED=12-Mar-2005 NOTICE="ABCD Corporation" \  SN=RE-0000164638-12345:123 START=11-mar-2005 SIGN="1234567"
UPGRADE 使用一个晚于或等于 from_Subscription_Advantage_date,并早于 to_Subscription_Advantage_renewal_date 的专享升级服务日期应用于前面最接近的 INCREMENT 行。
UPGRADE 行使用继续符 (\) 来对长行进行换行。 使用包含 UPGRADE 行的许可证文件时,您必须将包含原始 INCREMENT 行的许可证文件保留在同一文件夹中。