Лицензирование QHB версии 1.5.1
Бинарные утилиты
Утилита qhb-serial
Утилита идентификации аппаратуры хоста qhb-serial поставляется в составе одноименного пакета qhb-serial.
При установке она размещается в общедоступном каталоге, обычно в /usr/bin/.
Утилита используется для запроса идентификатора аппаратуры хоста, куда устанавливается QHB, для передачи его вендору или дилеру QHB. По этому идентификатору генерируется лицензионный файл, привязанный именно к этому хосту.
Запуск утилиты:
qhb-serial
Параметры не требуются.
Для получения краткой справки запустите утилиту с флагом --help.
qhb-serial --help
Утилита qhb-license
Утилита просмотра файла лицензии qhb-license поставляется в составе пакета qhb-license-bin.
При установке она размещается в общедоступном каталоге, обычно в /usr/bin/.
Утилита используется для просмотра параметров лицензионного файла, полученного от вендора или дилера QHB.
Пример запуска утилиты:
qhb-license --license-path /usr/local/qhb/license
Пример вывода утилиты:
Идентификатор лицензии: fa4764bf-5fd8-4579-b8cb-d90b7259f62d
Идентификатор аппаратного обеспечения (HID): 37245DA9E484489EDD71F263E0CDF9F8
Дата начала действия лицензии: 2023-03-15
Дата начала срока тех. поддержки: 2023-01-10
Дата окончания срока тех. поддержки: 2023-11-11
Имя пользователя: USERNAME
Код пользователя: USERCODE
Имя продукта: СУБД Квант-Гибрид
Код продукта: QHB-std1
Код сделки: BARGAINCODE
Номер релиза: 1.5
Редакция: FULL
Тип лицензии: TEST
Список лицензионных метрик
CONNECTIONS: 2
PROC: 8
Тип продукта: DBMS
Дата окончания действия лицензии: 2023-11-11
Для получения краткой справки запустите утилиту с флагом --help.
qhb-license --help
Получение файла лицензии
Клиент получает лицензионный файл, который необходим для использования QHB. Вместе с файлом лицензии клиент получает номер лицензии, по которому его можно идентифицировать. Данный номер также необходим для обращения в техническую поддержку.
Применение лицензионных параметров
При запуске QHB ожидает наличия лицензионного файла license в каталоге, куда он установлен, например /usr/local/qhb/license.
Для проверки лицензии требуется произвести идентификацию аппаратуры хоста пользователя, которая выполняется пакетом qhb-serial. Данная утилита также необходима для запуска QHB и утилит, использование которых предусматривает наличие лицензионного файла.
Примечание
Утилита qhb-serial может не требоваться для запуска таких утилит, как qcp и qdl, если в лицензионном файле идентификация аппаратуры хоста не заполняется.
По проверке соответствия параметров лицензирования, указанных в лицензионном файле текущего дистрибутива QHB, выводятся следующие сообщения:
- первоначально при выводе версии печатается краткая информация о сроке действия лицензии;
- далее в файл журнала упреждающей записи выводятся найденные ошибки загрузки и валидации лицензии.
Запрос лицензионных параметров во время работы
Для удобства администратора QHB предоставляется SQL-функция, которая позволяет получить детали текущей используемой лицензии.
Допустимые значения:
lid Идентификатор лицензии
hid Идентификатор аппаратного обеспечения
license_start Дата начала действия лицензии
support_start Дата начала действия техподдержки
support_stop Дата окончания действия техподдержки
valid_thru Дата окончания действия лицензии
user_name Имя пользователя
user_code Код пользователя
release Текущий релиз
product_name Название продукта
product_code Код продукта
bargain_code Код сделки
license_type Тип лицензии
edition Редакция
product_type Тип продукта
Например:
# select qhb_license_info('product_code');
-- QHB
# select qhb_license_info('release');
-- 1.3
Дополнительно предоставляется SQL-функция, которая позволяет получить сразу все детали текущей используемой лицензии в виде таблицы.
# select attname, attvalue from qhb_license();
При невозможности обработать указанный параметр функция qhb_license_info возвращает пустую строку в виде значения типа text.
Возвращаемые данные соответствуют значениям, указанным в самой лицензии (лицензионный файл), и могут отличаться от значений, соответствующих сборке QHB.
Действия клиента в случае ошибки загрузки лицензии
При обычной проверке лицензии (при запуске QHB) могут возникать два типа ошибок:
- ошибки загрузки лицензии;
- ошибки валидации лицензии относительно текущей сборки/релиза QHB.
В случае ошибки загрузки лицензии следует удостовериться, что:
- лицензия расположена по ожидаемому продуктом пути: в каталоге установки, например /usr/local/qhb/license;
- файл лицензии не был изменен после получения от коммерческого отдела (файл подписан криптографически, и любые правки делают его недействительным);
- у пользователя QHB есть права на чтение лицензионного файла.
В случае соблюдения этих условий и повторного возникновения ошибки следует обратиться в техническую поддержку.
Действия клиента в случае ошибки валидации лицензии
В случае ошибки валидации лицензии детальная информация об ошибке доступна в начале файла журнала QHB, сформированного при запуске.
Сообщение включает в себя результат валидации (каждый некорректный параметр
выводится на новой строке) и краткое указание для дальнейших действий,
локализованное для текущих настроек ОС (LC_ALL=ru/en).
Лицензирование QDL и QCP
При запуске данные утилиты ожидают наличие лицензионного файла qdl-license или qcp-license (аналогично QHB) в директории местонахождения исполняемого файла.
Сообщения об ошибках загрузки и валидации лицензии выводятся в лог соответствующих утилит (в зависимости от настроек это могут быть стандартные потоки ввода/вывода либо файл журнала).
Возможность запросить лицензионные параметры для утилит во время их работы в данном релизе не предусмотрена.
В случае ошибки валидации лицензии детальная информация об ошибке доступна в виде результата валидации (каждый некорректный параметр выводится на новой строке) и краткого указания для дальнейших действий (вывод зависит от текущих настроек локали).