Общая информация
Консольный режим Мастера лицензий Guardant (утилиты) используется в случаях, когда невозможно использовать графический режим или для автоматизации процесса активации/переноса/обновления лицензий.
Утилита не требует каких-либо операций для своей установки. Для ее работы необходимо запустить исполняемый файл, который по умолчанию располагается в директории:
- ...\Software Licensing Kit\redistribute\license_activation\license_wizard.exe — для ОС Windows;
- .../Software Licensing Kit/redistribute/license_activation/linux/x86_64/license_wizard — для ОС Linux.
Операции и их аргументы
Операции
| Сценарий использования операции | Доступ к сети | Операция | Описание операции |
|---|---|---|---|
- | - | --console | Использовать консольный режим Мастера лицензий |
- | - | --list | Показать список лицензий на текущем ПК |
| Активация программной лицензии | Онлайн | --activate <серийный_номер> [--host <url>] | Активировать лицензию с помощью серийного номера |
| Офлайн | --activate-request <путь_файла_запроса> | Создать запрос на активацию | |
--activate-response <серийный_номер> <путь_файла_запроса><путь_файла_лицензии> [--host <url>] | Отправить запрос на активацию | ||
--activate-offline <путь_файла_лицензии> | Активировать лицензию с помощью файла лицензии | ||
| Обновление лицензии | Онлайн | --update <ID_лицензии> [--host <url>] | Обновить указанную лицензию |
| Офлайн | --update-request <ID_лицензии> <путь_файла_запроса> | Создать запрос на обновление указанной лицензии | |
--update-response <путь_файла_запроса> <путь_файла_лицензии> [--host <url>] | Отправить запрос на обновление | ||
--update-offline <путь_файла_лицензии> | Обновить лицензию с помощью файла лицензии | ||
| Перенос лицензии | Онлайн | --rehost-extract <ID_лицензии> <путь_файла_переноса> | Извлечь лицензию для переноса |
| Офлайн | --rehost <путь_файла_переноса> [--host <url>] | Перенести указанную лицензию | |
--rehost-request <путь_файла_отпечатков> | Создать запрос на перенос лицензии | ||
--rehost-response <путь_файла_переноса> <путь_файла_отпечатков><путь_файла_лицензии> [--host <url>] | Отправить запрос на перенос лицензии | ||
--rehost-offline <путь_файла_лицензии> | Перенести лицензию с помощью файла лицензии | ||
| Запись лицензии на аппаратный ключ | Онлайн | --dongle-set-license <dongle_ID> <serial_number> [--host <url>] | Записать лицензию на указанный аппаратный ключ с помощью серийного номера |
| Проверка светодиода аппаратного ключа | - | --dongle-blink <dongle_ID> | Активировать мигание светодиода на заданном ключе |
Аргументы
| Аргумент | Описание аргумента |
|---|---|
<серийный_номер> | Серийный номер, который создается в личном кабинете Guardant Station при создании заказа |
[--host <url>] | Адрес сервера активации. Зависит от версии Guardant Station. Для облачной версии Guardant Station используется адрес https://getlicense.guardant.ru:443. Для отчуждаемой версии Guardant Station адрес зависит от настроек вендора |
<путь_файла_запроса> | Путь к файлу запроса. Файл запроса представляет собой файл с расширением .request, в котором содержится:
Директория хранения и имя файла могут быть любыми |
<путь_файла_переноса> | Путь к файлу переноса. Файл переноса представляет собой файл с расширением .rehost, в котором содержатся зашифрованные данные программного ключа и данные ПК, с которого выполняется перенос лицензии. Директория хранения и имя файла могут быть любыми |
<путь_файла_отпечатков> | Путь к файлу отпечатка. Файл отпечатка представляет собой файл с расширением .fingerprint, в котором содержится слепок оборудования текущего ПК. Директория хранения и имя файла могут быть любыми |
<путь_файла_лицензии> | Путь к файлу лицензии |
<ID_лицензии> | ID ключа |
<dongle_ID> | ID аппаратного ключа. Нанесен на корпус устройства |
<serial_number> | Серийный номер, который создается в личном кабинете Guardant Station при создании заказа |
Просмотр списка лицензий
Чтобы посмотреть список всех лицензий, активированных на данном ПК, введите команду:
<путь до исполняемого файла Мастера лицензий> --console --list
Пример.
C:\>license_wizard.exe --console --list C:\> Guardant DL #CAD6E532 лицензия (7) Основной модуль (7) Без ограничений
Активация лицензии
Поддерживается только для программных ключей Guardant DL.
Активировать лицензию можно как в режиме онлайн (ПК доступно подключение к серверу лицензирования), так и в режиме офлайн (ПК недоступно подключение к серверу лицензирования).
Онлайн активация
Чтобы активировать лицензию онлайн, введите команду:
<путь до исполняемого файла Мастера лицензий> --console --activate <серийный_номер> [--host <url>]
Пример.
C:\>license_wizard.exe --console --activate sV112L-AzxhvH-BiGeWJ-EbHe6q-487Va8 --host https://getlicense.guardant.ru:443 C:\> Активация лицензии завершен(-а/-о)
Офлайн активация
Чтобы активировать лицензию офлайн:
- Создайте запрос на активацию.
- Отправьте запрос на сервер лицензирования.
- Активируйте лицензию.
1. Создание запроса на активацию
Чтобы создать запрос на активацию лицензии, введите на ПК, которому недоступно подключение к серверу лицензирования, команду:
<путь до исполняемого файла Мастера лицензий> --console --activate-request <путь_файла_запроса>
Пример.
C:\>license_wizard.exe --console --activate-request C:\test.request C:\> Создание запроса на активацию лицензии завершен(-а/-о)
В результате на ПК в указанной директории будет сохранен файл запроса на активацию лицензии.
2. Отправка запроса на сервер лицензирования
Чтобы отправить запрос на сервер лицензирования:
- Перенесите на ПК, которому доступно подключение к серверу лицензирования, файл запроса, полученный в п.1.
- На ПК с доступным подключением введите команду:
<путь до исполняемого файла Мастера лицензий> --console --activate-response <серийный_номер> <путь_файла_запроса> <путь_файла_лицензии> [--host <url>]
Пример.
C:\>license_wizard.exe --console --activate-response nrZzsb-Rnu7wJ-e77zJG-skYjDE-ApULHX C:\test.request C:\test.response --host https://getlicense.guardant.ru:443 C:\> Отправка запроса на активацию лицензии завершен(-а/-о)
В результате на этом ПК будет сохранен файл лицензии.
3. Активация лицензии
Чтобы активировать лицензию:
- Перенесите на первоначальный ПК файл лицензии, полученный в п.2.
- На этом ПК введите команду:
<путь до исполняемого файла Мастера лицензий> --console --activate-offline <путь_файла_лицензии>
Пример.
C:\>license_wizard.exe --console --activate-offline C:\test.response C:\> Активация лицензии завершен(-а/-о)
Лицензия активирована.
Обновление лицензии
Обновить лицензию можно как в режиме онлайн (ПК доступно подключение к серверу лицензирования), так и в режиме офлайн (ПК недоступно подключение к серверу лицензирования).
Онлайн обновление
Чтобы обновить лицензию онлайн, введите команду:
<путь до исполняемого файла Мастера лицензий> --console --update <ID_лицензии> [--host <url>]
Пример.
C:\>license_wizard.exe --console --update CAD6E532 --host https://getlicense.guardant.ru:443 C:\> Обновление лицензии завершен(-а/-о)
Офлайн обновление
Для обновления аппаратных ключей в режиме офлайн версия их микропрограммы должна быть выше 1.0.4.10.
Чтобы обновить лицензию офлайн:
- Создайте запрос на обновление.
- Отправьте запрос на сервер лицензирования.
- Обновите лицензию.
1. Создание запроса на обновление
Чтобы создать запрос на обновление лицензии, введите на ПК, которому недоступно подключение к серверу лицензирования, команду:
<путь до исполняемого файла Мастера лицензий> --console --update-request <ID_лицензии> <путь_файла_запроса>
Пример.
C:\>license_wizard.exe --console --update-request CAD6E532 C:\test.request C:\> Создание запроса на обновление лицензии завершен(-а/-о)
В результате на ПК в указанной директории будет сохранен файл запроса на обновление ключа.
2. Отправка запроса на сервер лицензирования
Чтобы отправить запрос на сервер лицензирования:
- Перенесите на ПК, которому доступно подключение к серверу лицензирования, файл запроса, полученный в п.1.
- На ПК с доступным подключением введите команду:
<путь до исполняемого файла Мастера лицензий> --console --update-response <путь_файла_запроса> <путь_файла_лицензии> [--host <url>]
Пример.
C:\>license_wizard.exe --console -update-response C:\test.request C:\test.response --host https://getlicense.guardant.ru:443 C:\> Отправка запроса на обновление лицензии завершен(-а/-о)
В результате на этом ПК будет сохранен файл обновленной лицензии.
3. Обновление лицензии.
Чтобы обновить лицензию:
- Перенесите на первоначальный ПК файл обновленной лицензии, полученный в п.2.
- На этом ПК введите команду:
<путь до исполняемого файла Мастера лицензий> --console --update-offline <путь_файла_лицензии>
Пример.
C:\>license_wizard.exe --console --update-offline C:\temp\test.response C:\> Обновление лицензии завершен(-а/-о)
Лицензия обновлена.
Чтобы проверить, что лицензия успешно обновилась, введите команду:
<путь до исполняемого файла Мастера лицензий> --console --list
В списке у этой лицензий отобразятся новые лицензионные условия.
Перенос лицензии на другой ПК
Для аппаратного ключа перенос лицензии между ПК доступен по умолчанию. Для этого достаточно отключить его от одного ПК и подключить к другому.
Для программного ключа этот способ переноса лицензии не подходит, т.к. такие ключи хранятся на накопителе и привязываются к оборудованию ПК.
Для переноса лицензии программного ключа необходимо воспользоваться утилитой.
Перенести лицензию на другой ПК можно как в режиме онлайн (ПК, на который переносится лицензия, доступно подключение к серверу лицензирования), так и в режиме офлайн (ПК, на который переносится лицензия, недоступно подключение к серверу лицензирования).
Онлайн перенос
В момент переноса лицензии на сервер лицензирования отправляется информация о новом ПК, на который будет установлен ключ. В истории серийных номеров этого ключа в Guardant Station будет отображаться операция Перенос.
Чтобы перенести лицензию:
- Открепите ее от ПК, на котором она на данный момент установлена, (ПК-донора), введя команду:
<путь до исполняемого файла Мастера лицензий> --console --rehost-extract <ID_лицензии> <путь_файла_переноса>
- Перенесите полученный файл переноса на ПК, на котором будет использоваться лицензия, (ПК-приемник).
- На ПК-приемнике введите команду:
<путь до исполняемого файла Мастера лицензий> --console --rehost <путь_файла_переноса> [--host <url>]
Пример.
C:\>license_wizard.exe --console --rehost-extract F7EAC613 C:\F7EAC613.rehost C:\> Извлечение лицензии завершен(-а/-о) C:\>license_wizard.exe --console --rehost C:\F7EAC613.rehost --host https://getlicense.guardant.ru:443 C:\> Перенос лицензии завершен(-а/-о)
Офлайн перенос
Чтобы перенести офлайн лицензию с одного ПК на другой:
- Открепите лицензию с ПК-донора.
- Создайте запрос на перенос лицензии.
- Отправьте запрос на сервер лицензирования.
- Перенесите лицензию на другой ПК.
1. Открепление лицензии
Чтобы открепить лицензию, на ПК-доноре введите команду:
<путь до исполняемого файла Мастера лицензий> --console --rehost-extract <ID_лицензии> <путь_файла_переноса>
Пример.
C:\>license_wizard.exe --console --rehost-extract F7EAC613 C:\F7EAC613.rehost C:\> Извлечение лицензии завершен(-а/-о)
2. Создание запроса на перенос лицензии
Чтобы создать запрос на перенос лицензии, на ПК-приемнике введите команду:
<путь до исполняемого файла Мастера лицензий> --console --rehost-request <путь_файла_отпечатка>
Пример.
C:\>license_wizard.exe --console --rehost-request C:\fingerprint C:\> Создание запроса на перенос лицензии завершен(-а/-о)
В результате на ПК-приемнике будет сохранен файл-отпечаток текущего оборудования ПК.
3. Отправка запроса на перенос лицензии на сервер лицензирования
Чтобы отправить запрос на перенос лицензии:
- Перенесите на ПК-донор файл-отпечаток, полученный в п.2.
- Введите на ПК-доноре команду:
<путь до исполняемого файла Мастера лицензий> --console --rehost-response <путь_файла_переноса> <путь_файла_отпечатка> <путь_файла_лицензии> [--host <url>]
Пример.
C:\>license_wizard.exe --console --rehost-response C:\F7EAC613.rehost C:\fingerprint C:\F7EAC613.response --host https://getlicense.guardant.ru:443 C:\> Отправка запроса на перенос лицензии завершен(-а/-о)
В результате на ПК-доноре будет сохранен файл лицензии.
4. Перенос лицензии на другой ПК
Чтобы перенести лицензию:
- На ПК-приемник перенесите файл с лицензией, полученный в п.3.
- На ПК-приемнике введите команду:
<путь до исполняемого файла Мастера лицензий> --console --rehost-offline <путь_файла_лицензии>
Пример.
C:\>license_wizard.exe --console --rehost-offline C:\temp\F7EAC613.response C:\> Перенос лицензии завершен(-а/-о)
Запись лицензии в аппаратный ключ
Запись лицензии в аппаратный ключ возможна только на ПК, которому доступно подключение к серверу лицензирования.
Данная операция предназначена для записи лицензии в аппаратный ключ на ПК пользователя по заранее подготовленному в Guardant Station серийному номеру.
Чтобы записать лицензию в аппаратный ключ, введите команду:
<путь до исполняемого файла Мастера лицензий> --console --dongle-set-license <dongle_ID> <serial_number> [--host <url>]
Пример.
C:\>license_wizard.exe --console --dongle-set-license 43027CAF L5FVwW-SpCiax-EwTHL4-moMAXU-7WXokv --host https://getlicense.guardant.ru:443 C:\> Setting license to the dongle completed