Product Documentation

License file format

Apr 08, 2013
Внимание! Внесение изменений в файлы лицензий может привести к порче файлов. При работе со службой Citrix Licensing для Windows версии 11.6.1 и выше редактировать файлы лицензий нельзя. Управлять лицензиями и их задачами можно с помощью консоли администрирования лицензий и сайта My Account.
Файлы лицензий Citrix именуются в соответствии с соглашением об именах следующим образом: license_FID_XDT-PLT-UD_25-mar-2013.lic.
Примечание. Можно изменить имя файла лицензии, сохранив при этом его расширение .lic.

Файлы лицензий состоят из строк, содержащих определенную информацию, такую как имя сервера (SERVER) или количество лицензий (INCREMENT). Строки начинаются со слов в верхнем регистре, указывающих на их назначение, например, VENDOR, SERVER, INCREMENT, USE_SERVER и т.д.

В следующих разделах приведены подробные сведения о таких элементах синтаксиса файла лицензии, как строка SERVER, строка VENDOR, строка USE_SERVER, строка INCREMENT и строка UPGRADE. В то время как в текущем документе в синтаксисе файла лицензии и его параметрах используется понятие feature, по возможности для большей ясности используется понятие product license.

Пример файла лицензии (цифры соответствуют номерам, приведенным в объяснении ниже):


1. Строка SERVER

Строка SERVER. Строка SERVER определяет связующий идентификатор (также известный как имя узла или hostname) сервера лицензий.
Внимание! Не изменяйте связующий идентификатор в строке SERVER, иначе файл лицензии не будет работать.
Синтаксис
SERVER this_host ether
или
SERVER this_host HOSTNAME=hostname
Параметры Описание
ether MAC-адрес устройства, на котором работает сервер лицензий. Не редактируйте эту строку.
hostname Имя компьютера, на котором работает сервер лицензий. Не редактируйте эту строку.
Пример
SERVER this_host HOSTNAME=license_server1

2. Строка VENDOR

Строка VENDOR определяет имя управляющей программы Citrix Vendor Daemon.

Синтаксис
VENDOR CITRIX [vendor_daemon_path]
Поле Описание
VENDOR CITRIX Имя Citrix Vendor Daemon. Не редактируйте это имя.
vendor_daemon_path Путь к исполняемому файлу Citrix Vendor Daemon. Citrix рекомендует не изменять этот путь.

3. Строка INCREMENT

Строка INCREMENT описывает лицензии, необходимые для работы с продуктом. Файлы лицензий (с расширением *.lic) содержат одну или несколько строк INCREMENT. Каждая строка INCREMENT представляет собой счетчик продуктов и лицензий (пользователей, подключений).

Каждая строка increment содержит подпись, основанную на данных в строке, идентификаторах узла, прописанных в строке или строках SERVER, и данных, выбранных Citrix. В строках INCREMENT используется обратная косая черта ( \ ) для переноса большого количества текста.
Синтаксис
INCREMENT feature vendor SA_expiry_date exp_date num_lic \   SIGN=sign [optional_attributes]
Внимание! Не изменяйте шесть полей, идущие после ключевого слова строки INCREMENT; они обязательны и имеют строгий порядок.
В приведенной ниже таблице дано объяснение этим полям в порядке их расположения.
Поле Описание
функция Лицензия на продукт. Не редактируйте эту строку.
поставщик Указывает на принадлежность лицензии к Citrix Vendor Daemon. Не редактируйте эту строку.
SA_expiry_date Указывает на дату, до которой необходимо обновить версию продукта. Если вы не участвуете в программе Subscription Advantage или лицензия не имеет отношения к Subscription Advantage, дата указывает на время заказа или получения лицензии. Не редактируйте эту строку.
Примечание. Если было возобновлено участие в программе Subscription Advantage и получена лицензия на обновление, в строке указываются две даты.
  • Первая дата — это дата первоначального оформления участия в программе Subscription Advantage.
  • Вторая дата — SA_expiry_date (дата окончания участия в программе Subscription Advantage).

Пример.

INCREMENT MPS_ENT_CCU CITRIX 2005.0311 2007.0311 permanent 1000 \

Более подробные сведения можно получить в разделе «Обновление строк».

exp_date Дата окончания лицензии в формате дд-ммм-гггг, например, 07-май-2006. Не редактируйте эту строку.
Примечание. Если поле exp_date содержит строку «permanent», лицензия не имеет срока.
num_lic Одновременное количество лицензий для данной лицензии на продукт. Не редактируйте эту строку.
SIGN=sign SIGN= подпись, заверяющая строку INCREMENT. Не редактируйте эту строку.
Строки INCREMENT определяют также группирование лицензий в консоли управления. Эти группы называются пулами лицензий. Управляющая программа Citrix Vendor Daemon создает пулы лицензий на основе общих атрибутов, таких как лицензия или версия продукта. При создании нового пула консоль отображает и отслеживает его независимо от других пулов лицензий. При отличиях по двум и более атрибутам Citrix Vendor Daemon создает новый пул лицензий.
Атрибуты Citrix в строках INCREMENT.
Строки INCREMENT могут также содержать дополнительные атрибуты Citrix. Эти атрибуты предоставляют сведения о лицензии, такие как дата ее выдачи и тип лицензии (лицензия на обновление или обычная лицензия).
Внимание! Не изменяйте и не удаляйте эти атрибуты.
Пример
Важные пункты выделены в примере выше:
  • Продукт (функция лицензии) выделен голубым
  • Дата истечения срока действия программы Citrix Subscription Advantage выделена красным (формат: ГГГГ.ММДД)
  • Счетчик лицензий (пользователей, подключений) выделен зеленым
Синтаксис
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.
Дополнительные атрибуты Citrix в строках INCREMENT.
Строки INCREMENT содержат ряд атрибутов, которые можно добавлять, редактировать или удалять. По желанию можно добавить атрибуты. Например, можно вставить метку актива или номер заказа на покупку возле номера каждой лицензии в файле. Подобным образом можно добавить атрибуты, указывающие на то, что некая группа лицензий используется определенным отделом организации.
Некоторые атрибуты могут быть добавлены компанией Citrix или продавцом, предоставляющим дополнительные услуги.
Дополнительные атрибуты приведены в таблице ниже. Как и атрибуты Citrix, дополнительные атрибуты имеют синтаксис keyword=value, где keyword пишется в нижнем регистре. Отличить обязательные и дополнительные атрибуты можно по регистру букв: дополнительные атрибуты пишутся в нижнем регистре.
Атрибут Описание
asset_info= "..." Дополнительные сведения об управлении активами
dist_info= "..." Дополнительные сведения, полученные от поставщика программного обеспечения
user_info= "..." Дополнительные сведения, полученные от администратора лицензий
vendor_info= "..." Дополнительные сведения, полученные от Citrix

Строки UPGRADE

Строка UPGRADE содержит дату обновления и окончания срока участия в программе Subscription Advantage.
Внимание! Не изменяйте эту строку.
Синтаксис
UPGRADE функция CITRIX начальная_дата_Subscription_Advantage конечная_дата_продления_Subscription_Advantage дата_окончания число_лицензий \ [параметры ... ] SIGN=подпись
Все данные аналогичны содержащимся в строке INCREMENT с добавлением поля from_Subscription_Advantage_date field. Строка UPGRADE удаляет число лицензий более старой версии (>= from_Subscription_Advantage_date) и создает новую версию с тем же числом лицензий.
Пример 1
Например, приведенные ниже строки обновляют участие в программе Subscription Advantage корпорации ABCD для 1000 лицензий MPS_ENT_CCU на один год (до 11 марта 2006 г.):
 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
Например, приведенные ниже строки обновляют участие в программе Subscription Advantage корпорации ABCD для 1000 лицензий MPS_ENT_CCU на один год (до 11 марта 2006 г.):
 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 применяется к ближайшей строке INCREMENT с датой Subscription Advantage более поздней или идентичной дате в поле from_Subscription_Advantage_date и более ранней, чем в поле to_Subscription_Advantage_renewal_date.
В строках Upgrade используется символ продолжения ( \ ) для разрыва длинных строк. При использовании файлов лицензий со строками UPGRADE необходимо хранить файлы лицензий с оригинальной строкой INCREMENT в том же каталоге.