# ЗАПУСК КМАЗС-ОФИС на Linux - использование ключей защиты Guardant

Для работы программы КМАЗС-ОФИС в ОС Linux требуется ключ защиты Guardant, а также драйвера к ключу защиты.
Программа КМАЗС-ОФИС поставляется с ключом защиты Guardant, однако драйвера необходимо установить отдельно.

Информацию по установке драйверов ключей защиты для "РЕД ОС", а также для других дистрибутивов, основанных на RPM-пакетах см. в файле "install-guardant-drivers-rpm.txt".

Информацию по установке драйверов ключей защиты для "Астра.Линукс", а также для других дистрибутивов, основанных на DEB-пакетах см. в файле "install-guardant-drivers-deb.txt".


## Просмотр информации о вставленном ключе

1. Запустить браузер
2. Ввести команду: 
http://localhost:3189
Откроется страница Guardant Control Center, на которой будет отображаться список подключенных ключей защиты. По умолчанию производится поиск только локальных ключей. Номера ключей защиты отображаются в 16-ричном формате.
Код вендора у ООО "АВТОМАТИКА плюс": "AVT9PLH".
Если есть сервер, в который вставлен ключ защиты с пакетом лицензий, то необходимо настроить поиск сетевых лицензий.

## Поиск сетевых лицензий

Информация о поиске сетевых лицензий (если ключ защиты находится на другом компьютере), представлена на странице:
https://dev.guardant.ru/pages/viewpage.action?pageId=124944399

## Обновление лицензий на ключе защиты

При обновлении ПО "КМАЗС-ОФИС" на новую версию (например, 4.x -> 5.x) либо при добавлении дополнительных лицензий (рабочих мест) на ключ защиты следует обновить лицензию на ключе защиты. Для этого:
1. Запустить утилиту "Мастер лицензий Guardant": /opt/guardant/grdcontrol/license_wizard
Подробная информация по работе с этой утилитой доступна по ссылкам:
https://dev.guardant.ru/pages/viewpage.action?pageId=85492642
https://dev.guardant.ru/pages/viewpage.action?pageId=124944419
https://dev.guardant.ru/pages/viewpage.action?pageId=166201028
2. При наличии ключа защиты утилита должна его обнаружить и отобразить в списке ключей;
3. Нажать кнопку "Настройки" (в нижнем левом углу окна);
4. Ввести адрес: https://key.automatikaplus.ru:8555
5. Нажать кнопку "Назад" (в верхнем левом углу окна);
6. Найти кнопку "..." справа от названия ключа защиты (убедитесь, что у этого ключа защиты есть продукт "КМАЗС-ОФИС");
7. Нажать пункт "Проверить наличие обновлений";
8. Если обновление для данного ключа имеется (заранее подготовлено специалистами "ООО АВТОМАТИКА плюс"), то появится кнопка "Установить обновление";
9. Нажать кнопку "Установить обновление". При успешной установке обновления внизу появится сообщение "Обновление применено";
10. Запустить ПО КМАЗС-ОФИС (либо другую программу из комплекта "КМАЗС-ОФИС") и убедиться, что функционал работает.

Внимание! Утилита "license_wizard" может быть установлена в папку "/opt/kmazs", тогда запускать её можно оттуда, в таком случае адрес "https://key.automatikaplus.ru:8555" будет использоваться автоматически (он берётся из файла station.ini).
Для запуска утилиты из папки "/opt/kmazs" используйте команду: "/opt/kmazs/license_wizard"

Внимание! Если обновление через пункт "Проверить наличие обновлений" не проходит (например, нет доступа к интернету из-за политики безопасности организации), то выберите другой пункт "Оффлайн обновление". Смысл заключается в том, что на текущем компьютере сначала нужно подготовить файл запрос (request-файл), далее этот файл следует передать (любым способом) на компьютер, где есть интернет (без блокировок) (вариант - отправить в "ООО АВТОМАТИКА плюс"), затем в такой же программе "Мастер лицензий Guardant" следует выполнить обработку request-файла, после  чего будет сформирован ответный файл (с новым образом ключа защиты), который нужно опять предъявить утилите "Мастер лицензий Guardant" на первом компьютере. Более подробная инструкция по Оффлайн-обновлению лицензии доступна по ссылке:
https://dev.guardant.ru/pages/viewpage.action?pageId=124944419#id-Графическийрежим-Офлайнобновление

### Офлайн-обновление лицензии

1. выполните пункты 1,2,3,4,5,6 (см. выше);
Найти кнопку "..." справа от названия ключа защиты (убедитесь, что у этого ключа защиты есть продукт "КМАЗС-ОФИС");
2. Нажать пункт "Оффлайн обновление";
3. Выбрать варианты "На этом" и "Обновление лицензии" (по умолчанию они уже включены);
4. Убедитесь, что отображается имя request-файла, а также кнопка "Сохранить";
5. Нажмите кнопку "Сохранить", выберите каталог для сохранения и нажмите "Save";
6. [далее из документации] Перенесите файл запроса на ПК, которому доступно подключение к серверу лицензирования;
7. На ПК с доступным подключением обновите лицензию:
7.1 Запустите утилиту и нажмите + Активация лицензии;
7.2 Выберите На другом и нажмите Продолжить;
7.3 Выберите файл запроса, перенесенный с другого ПК, и нажмите Обновить эту лицензию;
7.4 Сохраните файл обновленной лицензии;
8. Перенесите файл обновленной лицензии на первоначальный ПК;
9. Активируйте файл на первоначальном ПК:
9.1 Если утилита была закрыта:
9.1.1 Запустите утилиту и нажмите + Активация лицензии;
9.1.2 Выберите На этом и вкладку Файл лицензии или файл переноса;
9.1.3 Выберите перенесенный файл обновленной лицензии и нажмите Открыть;
9.2 Если утилита не была закрыта:
9.2.1 Нажмите Продолжить и Продолжить, у меня есть файл лицензии;
9.2.2 Выберите перенесенный файл обновленной лицензии и нажмите Открыть.