Лицензирование QHB версии 1.5.2
ВНИМАНИЕ!
При отсутствии лицензии производительность СУБД ограничена.
Бинарные утилиты
Утилита qhb-serial
Утилита идентификации аппаратуры хоста qhb-serial поставляется в составе одноименного пакета qhb-serial.
При установке она размещается в общедоступном каталоге, обычно в /usr/bin/.
Утилита используется для запроса идентификаторов аппаратуры хоста или виртуальной машины, куда устанавливается QHB, для передачи их вендору или дилеру QHB. По этой информации генерируется лицензионный файл, привязанный именно к этому хосту или виртуальной машине.
Запуск утилиты:
qhb-serial
Параметры:
запуск без параметров
Вывести serial number текущего хоста, если он не является виртуальной машиной.
-u
--uuid
Вывести вместо serial number текущего хоста system-uuid виртуальной машины.
-s
--cpus
Вывести количество ядер хоста или виртуальной машины, которое будет учитываться при проверке лицензии.
-r
--report
Сформировать полный вывод параметров хоста или виртуальной машины для передачи вендору и формирования файла лицензии.
--help
Показать справку об аргументах командной строки qhb-serial и завершиться.
Пример запуска утилиты:
qhb-serial --report
Утилита qhb-license
Утилита просмотра файла лицензии qhb-license поставляется в составе пакета qhb-license-bin.
При установке она размещается в общедоступном каталоге, обычно в /usr/bin/.
Утилита используется для просмотра параметров лицензионного файла, полученного от вендора или дилера QHB.
Пример запуска утилиты:
qhb-license --license-path /var/lib/qhb/data/license
Пример вывода утилиты:
Идентификатор лицензии: fa4764bf-5fd8-4579-b8cb-d90b7259f62d
Идентификатор аппаратного обеспечения (HID): 37245DA9E484489EDD71F263E0CDF9F8
Идентификатор системы (UUID): B5AD08BC368E984DA7AD7A407D7F705D
Дата начала действия лицензии: 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 | Идентификатор аппаратного обеспечения |
| system_uuid | Универсальный уникальный идентификатор системы |
| 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) в директории местонахождения исполняемого файла.
Сообщения об ошибках загрузки и валидации лицензии выводятся в лог соответствующих утилит (в зависимости от настроек это могут быть стандартные потоки ввода/вывода либо файл журнала).
Возможность запросить лицензионные параметры для утилит во время их работы в данном релизе не предусмотрена.
В случае ошибки валидации лицензии детальная информация об ошибке доступна в виде результата валидации (каждый некорректный параметр выводится на новой строке) и краткого указания для дальнейших действий (вывод зависит от текущих настроек локали).