Product Documentation

License administration commands

Mar 16, 2015

Хотя с помощью консоли License Administration Console можно легко воспользоваться многими функциями лицензирования, операции с лицензиями можно также выполнять с использованием команд. Команды администрирования лицензий можно использовать при выполнении расширенных операций с сервером лицензий, которые недоступны в консоли. К таким операциям относится диагностика неполадок при извлечении лицензий, выполняемая с помощью утилиты lmdiag.

Команды администрирования лицензий хранятся в папках:

  • C:\Program Files\Citrix\Licensing\LS на 32-разрядном компьютере;
  • C:\Program Files (x86)\CCitrix\Licensing\LS на 64-разрядном компьютере
  • /opt/citrix/licensing/LS для License Server VPX.

Таблица команд

Утилита Описание
lmadmin Предоставляет конфигурацию лицензирования. Для настройки лицензирования и административных задач используйте License Administration Console. Не используйте утилиту lmadmin.
lmdiag Диагностика неполадок при извлечении лицензий.
lmdown Безопасное завершение работы управляющих программ «Диспетчер лицензий» и Citrix Vendor Daemon (отключена по умолчанию).
lmhostid Отображение идентификатора узла сервера, на котором запущена служба Citrix Licensing.
lmreread Вынуждает управляющую программу «Диспетчер лицензий» повторно считать файл лицензии и запустить Citrix Vendor Daemon.
lmstat Отображение состояния сервера лицензий.
lmutil Отображение списка утилит лицензирования или выполнение других команд.
lmver Отображение информации о версии для двоичных файлов лицензий. См. lmver.
udadmin Выводит на дисплей список всех пользователей и устройств, имеющих лицензии, и предоставляет возможность удаления определенных пользователей и устройств, имеющих лицензии. Эта команда применима только для лицензий на пользователя/устройство.

Форматирование команд управления лицензиями

Обозначения, принятые при форматировании команд администрирования лицензий:
Обозначение Описание
Полужирный шрифт Команда или параметр, например lmstat.
Курсив Вместо переменных необходимо указать значения. Например, в выражении:

lmstat -clicense_file_list

Прежде чем выполнить команду, необходимо заменить license_file_list перечнем имен файлов лицензий.

[квадратные скобки] Квадратные скобки вокруг текста указывают на параметры, которые можно добавить в команду, или на то, что текст в скобках необходимо заменить.

Универсальные аргументы

Допустимые аргументы для большей части команд администрирования лицензий.
Аргумент Описание
-all Применение команды ко всем серверам лицензий в сети.
-c Позволяет указать файлы лицензий или порт сервера лицензий и имя узла.

Если указать путь без имени файла лицензии, команда будет применена ко всем файлам лицензий в указанном каталоге.

Для локального хоста: -c @localhost

Для удаленного сервера лицензий: -c @servername

Для сервера лицензий в кластере: -c @clientaccesspointname

Для заданного пути: -c path

Для имен одного или нескольких файлов лицензий: -c license_file_list

Можно ввести несколько путей к файлам лицензий, разделяя их точкой с запятой.

Пути, содержащие пробелы, необходимо заключать в двойные прямые кавычки.

-h Дескриптор лицензии, согласно выводу команды lmstat -a. Дескриптор лицензии — это номер, используемый для идентификации конкретной извлеченной лицензии.
-help Отображение информации об использовании и завершение работы утилиты.
-s [server] Отображение состояния всех файлов лицензий на сервере лицензий или на всех серверах лицензий, если сервер не указан.
-verbose Отображение более подробного описания всех обнаруженных ошибок.

Диагностика ошибок при извлечении лицензий (lmdiag)

Утилита lmdiag дает возможность диагностировать неполадки, если продукту не удается получить лицензию. Обычно можно проверить, действительны ли лицензии и запущен ли сервер лицензий. Сразу после запуска утилита осуществляет попытку получить лицензию.

Также с помощью утилиты lmdiag можно узнать, используется ли особый тип лицензии. Например, можно запустить lmdiag на сервере Citrix XenApp, чтобы проверить только лицензии на редакцию Advanced Edition, указав аргумент MPS_ADV_CCU.

Синтаксис

lmdiag -c список_файлов_лицензий [-n] [функция[:ключевое_слово=значение]]
Аргумент Описание

-c license_file_list

Диагностика указанных файлов. Также можно использовать: -c @localhost или -c @server-name
-n Запуск в неинтерактивном режиме; в этом режиме lmdiag не предлагает ввести данные.
функция Ограничивает вывод информацией об указанной функции.
keyword=value Если файл лицензии содержит несколько строк для определенной функции, то в результат войдут только те из них, которые содержат указанное текстовое значение. Например:
lmdiag –c @localhost MPS_ENT_CCU:HOSTID=LICSERV01

выполняет попытку извлечения лицензии из строки с идентификатором сервера «LICSERV01».

В качестве ключевого слова можно использовать одно из следующих: VERSION, HOSTID, EXPDATE, KEY, VENDOR_STRING, ISSUER

Если ни одна функция не указана, утилита lmdiag работает со всеми функциями в файлах лицензий вашего списка. Утилита lmdiag отображает информацию о лицензии, а затем пробует извлечь каждую лицензию. Если лицензия успешно получена, lmdiag отображает информацию об успешном получении. Если извлечение заканчивается сбоем, lmdiag отображает сообщение со сведениями о причине сбоя. Утилита lmdiag пробует подключиться к TCP/IP-порту на сервере лицензий. Она определяет, правильно ли указан номер порта в файле лицензии. Утилита lmdiag выводит список всех прослушиваемых портов TCP/IP, и, если указан аргумент -c license_file_list, диагностирует указанные файлы.

При попытке извлечения лицензий утилита lmdiag не связывается с компьютером, на котором запущена программа Citrix. lmdiag сообщает только о проблемах на сервере лицензий. То есть, если установленному продукту не удалось получить лицензии из-за того, что указан неверный сервер лицензий (например, сервер лицензий без лицензий на данный продукт), lmdiag не выявит такую неполадку. lmdiag сообщит, что лицензии доступны для получения, даже если продукт Citrix ссылается на неверный сервер лицензий.

Остановка управляющих программ (lmdown)

Утилита lmdown завершает работу управляющих программ «Диспетчер лицензий» и Citrix Vendor Daemon на вашем сервере лицензий или на всех серверах лицензий в вашей сети. По умолчанию эта утилита отключена. Чтобы включить ее, выполните следующие действия.

  1. Остановите сервер лицензий.
  2. Запустите команду lmadmin - allowStopServer и/или -allowRemoteStop Server.
  3. Перезапустите сервер лицензий.

Синтаксис

lmdown -c список_файлов_лицензий [-vendor CITRIX] [-q] [-all]
Аргумент Описание

-c @localhost 
или
-c@server
или
-c license_file_list

Позволяет указать конкретные файлы лицензий. Обратите внимание, что использовать утилиту lmdown рекомендуется всегда с аргументом -c license_file_list. Также можно использовать: -c @localhost или -c @server-name
-vendor CITRIX Завершение работы только программы Citrix Vendor Daemon. Управляющая программа License Manager Daemon продолжит работать.
-q Режим без запроса и без вывода заголовка. Иначе утилита lmdown отобразит запрос: «Вы уверены? [д/н]: ».
-all Если указано несколько серверов, их работа будет автоматически завершена. Вместе с аргументом -all неявно предполагается присутствующим аргумент -q.

Утилита lmdown должна быть запущена на сервере лицензий. Аргумент -all можно использовать для завершения работы всех серверов лицензий в сети.

Если утилита lmdown обнаружит несколько серверов (например, если с помощью аргумента -c был указан каталог со множеством файлов с расширением .lic), при этом не был указан аргумент -all, пользователю будет предложено указать серверы лицензий, работу которых следует завершить. Чтобы завершить работу удаленного сервера лицензий, необходимо использовать аргумент -c и указать имя сервера лицензий.

Примечание. Если для завершения работы управляющей программы License Manager Daemon (служба Citrix Licensing) используется диспетчер задач, необходимо сначала завершить работу процесса lmgrd, а затем процесса Citrix Vendor Daemon.

Чтобы завершить работу и перезапустить только программу Citrix Vendor Daemon, выполните команду lmdown -c @localhost -vendor CITRIX, а затем с помощью команды lmreread -c @localhost -vendor CITRIX перезапустите управляющую программу Vendor Daemon.

Проверка имен хостов (lmhostid)

Утилита lmhostid возвращает идентификатор хоста сервера лицензий. Можно использовать данную команду для проверки имени узла сервера лицензий. Можно открыть файл лицензии и сравнить имя узла в файле лицензии с именем сервера лицензий.

Примечание. Citrix Licensing версии 11.5 и выше под Windows позволяет отображать несколько идентификаторов при наличии нескольких хостов.

Синтаксис

lmhostid –bindingidentifier
Аргумент (bindingidentifier) Описание
-ether Используется для лицензий продуктов, связанных с MAC-адресом устройства.
-internet Используется для лицензий программного обеспечения продуктов Citrix под Windows с TCP/IP адресом.
-hostname Используется для лицензий на программные продукты Citrix под Windows, привязанных к имени хоста (hostname) сервера лицензий.
Примечание. Параметр hostname чувствителен к регистру и должен в точности соответствовать имени сервера лицензий.

Повторное считывание файлов лицензий и параметров (lmreread)

Утилита lmreread заставляет управляющую программу Citrix Vendor Daemon повторно считывать изменения файла лицензии и файла параметров. После повторного считывания управляющая программа Citrix Vendor Daemon впредь будет использовать новые настройки и/или лицензии.

Утилиту lmreread нельзя использовать удаленно; запускайте ее локально на сервере лицензий.

Синтаксис

lmreread -c список_файлов_лицензий [-all] [-vendor CITRIX]
Аргумент Описание

-c @localhost или -c список_файлов_лицензий

Позволяет указать конкретные файлы лицензий.
-all Если задано несколько команд lmgrd, указывает выполнить повторное считывание всем управляющим программам диспетчера лицензий.
-vendor CITRIX Указывает управляющей программе Citrix Vendor Daemon перезапуститься.

Примеры

  • lmreread -c @localhost [-all]
  • lmreread -c @client_access_point_name
  • lmreread -c /opt/citrix/licensing/myfiles/CITRIX.lic -vendor CITRIX

Отображение списка утилит лицензирования (lmutil)

При автономном использовании список утилит лицензирования можно отобразить с помощью утилиты lmutil. Когда вы назначаете утилите lmutil другую команду, оно выполняет эту команду.

Синтаксис

lmutil
lmutil other_command

Примеры

  • lmutil

    Отображение всех утилит лицензирования.

  • lmutil lmstat -c @localhost

    Выполнение команды утилиты lmstat.

Определение статуса лицензирования (lmstat)

Утилита lmstat помогает отслеживать статус всех сетевых действий по лицензированию и предоставляет сведения об извлечении лицензий, включая:
  • Продукт, которому была извлечена одна или несколько лицензий
  • Данные об извлечении
  • Версия файла лицензии
  • Имя и порт сервера лицензий
  • Дата извлечения лицензии
  • Сведения о статусе управляющей программы Citrix Vendor Daemon и файлах лицензий

Утилита lmstat отображает информацию, которую она получает от сервера лицензий. Утилита lmstat отображает сведения только об одном использовании лицензии, даже если установлено несколько соединений, каждое из которых использует эту лицензию.

Синтаксис

lmstat [-a] [-c список_файлов_лицензий] [-f [функция]] [-i [функция] [-s[сервер] [-S [CITRIX]] [-t время_ожидания]
Аргумент Описание
-a Отображает все сведения.
-c @localhost или -c@server или -c license_file_list Использует указанные файлы лицензий.
-f [feature] Отображает продукты, использующие ту или иную функцию (лицензию на продукт). Если функция не указана, отображаются сведения об использовании всех функций.
-i [feature] Отображает сведения из строки INCREMENT для указанной функции (лицензии на продукт) или всех функций, если функция не указана.
-s [server] Отображает статус всех файлов лицензий, перечисленных на определенном сервере лицензий или на всех серверах лицензий, если параметр сервер не указан.
-S [CITRIX] Выводит список всех серверов продуктов, использующих функции (лицензии на продукты), обслуживаемые управляющей программой Citrix Vendor Daemon.
-t timeout_value Устанавливает timeout_value в качестве значения времени ожидания подключения. Это ограничивает продолжительность времени, которое утилита lmstat проводит в попытке подключиться к серверу лицензий.
Вывод команды lmstat -c@localhost -a выглядит подобно следующему:
License server status: 27000@license_server1 License files on license_server1: C:\Program Files\Citrix\Licensing\MyFiles\citrix_startup.lic: C:\Program Files\Citrix\Licensing\MyFiles\citrixlic_20031001094430.lic: license_server1: license server UP (MASTER) v9.2 Vendor daemon status (on license_server1): CITRIX: UP v9.2 Feature usage info: Users of CITRIX: (Total of 5000 licenses issued; Total of 1 license in use) "CITRIX" v2002.0101, vendor: CITRIX floating license MPS mps_server1 MPS MPS_ENT_2004.0227 (v1.0) (license_server1/27000 101), start Tue 3/16 16:59 Users of MPS_ENT_CCU: (Total of 30 licenses issued; Total of 1 license in use) "MPS_ENT_CCU" v2004.1201, vendor: CITRIX floating license MPS mps_server1 MPS 25fb337e:MPSCLIENT (v2004.0227) (license_server1/27000 203), start Wed 3/17 11:56
Следующая строка обозначает разрыв в сведениях, содержащихся в строке MPS_ENT_CCU вывода команды lmstat:
MPS citrix_product_name Имя продукта Citrix, для которого извлечена лицензия.
mps_server1 hostname Компьютер, на котором запускается продукт Citrix.
MPS display

Имя продукта Citrix, для которого извлечена лицензия.

license_server1 server_host Компьютер, на котором запускается сервер лицензий.
27000 port Порт TCP/IP, по которому доступен сервер лицензий.
203 handle Дескриптор лицензии. Дескриптор лицензии — это номер, используемый для идентификации конкретной извлеченной лицензии.
start Wed 3/17 11:56 checkout_time Время первого извлечения лицензии.
Примечание. Команда lmstat -c@localhost -a потенциально может создавать значительную сетевую активность в системах со множеством извлеченных лицензий.

Для проверки данных о получении лицензий можно воспользоваться командой lmstat -a.

Отображение версий двоичных файлов (lmver)

Утилита lmver отображает сведения о версиях для лицензирования двоичных файлов, например командных утилит. Одним исключением является утилита lmadmin. Чтобы отобразить сведения о версии утилиты lmadmin, воспользуйтесь командой lmadmin -version.

Синтаксис

lmver двоичный_файл

Пример

lmver lmdiag

Отображение или освобождение лицензий на пользователей или устройства (udadmin)

udadmin отображает пользователей и устройства, имеющие лицензии, и позволяет освободить лицензии, назначенные определенным пользователям и устройствам.

Лицензию на пользователя можно освободить только, если сотрудник больше не связан с компанией или находится в длительном отпуске. Лицензии на устройства можно освободить только, если устройства выходят из строя.

Внимание! Учтите, что массовый выпуск лицензий до 90-дневного периода автоматической лицензии и по причинам, не указанным выше, может нарушать лицензионное соглашение Citrix (EULA). Прежде чем делать это, свяжитесь с компанией Citrix.

Командная строка udadmin позволяет отображать информацию об использовании только на английском языке, но вы также можете использовать эту команду и в неанглоязычных системах.

Синтаксис

udadmin [-options] [-delete | -list ]  
«Options» Описание
-f featurename При использовании с командами -list или -delete эта команда отображает или освобождает только лицензии на пользователей или устройства с указанным названием функции.
-user username Освобождает только лицензии на пользователей с указанным именем пользователя.
-device devicename Освобождает только лицензии на пользователей с указанным названием устройства.
-a Перечисляет все функции и версии, установленные на сервере лицензий.
Аргумент Описание
-delete Освобождает одну лицензию на пользователя, функцию или устройство.
-list Отображает пользователей и устройства с лицензиями и время, прошедшее с момента последнего обновления. Время до следующего обновления отображается, если в течение 15 минут после последнего отчета были произведены существенные действия.
нет аргумента или? Отображает информацию об использовании для команды udadmin.

Примеры

  • udadmin -list

    Отображает всех пользователей и устройства.

  • udadmin -list -a

    Перечисляет все функции, версии, количество лицензий, пользователей и устройства для каждой функции.

  • udadmin -f XDT_ENT_UD -user u8.08 -delete

    Освобождает использование одним пользователем одной функции.

  • udadmin -f XDT_ENT_UD -device dn01.88 -delete

    Освобождает использование одним устройством одной функции.