Лицензирование

Owned by Sergey Myasnikov
Last updated: Apr 11, 2024
4 min read

Лицензионная политика

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

Лицензирование реализовано методом резервирования свободного лицензионного слота за конкретным пользователем. Резервирование гарантирует пользователю стабильную работу всего функционала приложения. Лицензионный слот резервируется на 1 час от момента последней активности пользователя (резервирование со сдвигом).

В случае, когда официанты берут устройство (планшет) только на время приема заказа, то на одном устройстве попеременно может работать несколько официантов.

При наличии нескольких групп станций в рамках одного сервера RMS лицензии iikoWaiter между группами перераспределяются динамически.

Ниже описаны часто встречающиеся вопросы, связанные с лицензированием и ответы на них.

Правила освобождения лицензий

Зарезервированные за сотрудниками лицензионные слоты освобождаются в следующих случаях (по убыванию оперативности срабатывания):

  1. Завершение пользователем работы в приложении через разлогин (кнопка “ЗамОк“). Свертка приложения в фон или принудительное завершение приложения не освобождает лицензию.

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

  3. Спустя один час с момента последней активности пользователя (автоматически).

  4. Рестарт iikoFront (аварийный вариант). Происходит полный сброс зарезервированных за пользователями лицензионных слотов.

Механизма (кнопки) ручного принудительного сброса зарезервированных слотов не предусмотрено.

Мониторинг активных лицензий

Информацию о фактическом текущем количестве используемых лицензий можно получить на странице Licensing в web-админке плагина с выводом списка зарезервированных слотов с именами пользователей.

 

Плагин не стартует с ошибкой лицензионного ограничения

Необходимо проверить, что RMS клиента получил необходимый для запуска плагина iikoWaiter moduleID = 19043118. Проверку можно сделать через специальный http запрос к серверу RMS:

resto/api/licence/info?moduleId=19043118

В случае отсутствия нужного moduleID рекомендуется проверить на партнерском портале наличие у данного клиента добавленных продуктов, через iikoOffice проверить наличие в списке активированных лицензий продуктов iikoWaiter, принудительно обновить лицензии.

Возможно потребуется сбросить лицензионный кэш на iikoFront путем удаления всех *.lic файлов в папке \CashServer.

Перестало хватать лицензий при подключении

Узнайте у клиента сколько активно лицензий и кто их занимает.

Варианты: 

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

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

В случае если количество доступных для использования лицензий не соответсвует количеству приобретенных, то используйте чек-лист, приведенный ниже.

Чек-лист для поиска и устранения ошибок лицензионного ограничения

Лицензионные ограничения могут проявляться двумя способами:

  1. Невозможность выполнить старт плагина.

  2. Невозможность выполнить логин пользователя в приложении.

Для устранение проблем выполните следующие шаги.

1. Проверьте в списке лицензий в iikoOffice наличие лицензий iikoWaiter и срок их действия.

image-20240411-063805.png
Пример информации из iikoOffice

В случае несоответствия количества или сроков действия обновите лицензии нажатием кнопки “Установить”. При необходимости проверьте факт заказа лицензий на портале.

При добавлении лицензий Waiter через партнерский портал для запуска плагина будет выделяться 10 лицензий WaiterPlugin (iikoFront).

Количество лицензий Waiter (Front) будет соответствовать количеству заказанных лицензий для пользователей.

2. Используйте скрипт http://ip_iikoRMS:8080/resto/service/monitoring/connections.jsp для отслеживания текущего потребления лицензий.

ModuleID 19043118 (WaiterPlugin): лицензия для старта плагина
ModuleID 19007518 (Waiter): лицензия подключения пользователей

Выявите “лишние” плагины, которые могут быть установлены и запущены на терминалах.

3. Проверьте информацию о лицензиях в логе plugin-iikoWaiter5.log

[2022-03-12 14:47:20,126] INFO [17] - IikoWaiter.Plugin.Application.UserLicensing.LicenseService[0] Active users: 1 User Абдулхамидов Шамиль015207 '7fed9d1e-d0b0-4942-929c-bfbe6bdc469e', Last active UTC: 12.03.2022 11:46:43

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

[2022-03-12 15:01:53,228] ERROR [22] - IikoWaiter.Plugin.Infrastructure.HttpHost.Pipelines.ProblemDetailsPipelineItem[0] Unhandled error on request: /api/op/authenticatebypin/0201/32772007-F88B-4DAB-AA2A-F184F16199DF Resto.Front.Api.Exceptions.InsufficientLicenseException: Cannot acquire slot for module 19007518 and client dce98aa8-64d5-4c6f-9190-7673b765771a: Exceeded.

4. Проверьте информацию о лицензиях в логе iikoFront cash-server.log

[2022-03-12 14:46:36,456] DEBUG [56] [LicenseServiceClient:GetPluralConnection] - Acquiring new connection for module 19007518 and client 25f16acb-1520-45d9-8da5-a10e1d03e36e [2022-03-12 14:46:36,961] DEBUG [56] [LicenseServiceClient:SetLicenseAndRestrictionsState] - New restrictions state obtained. Hash=990 Restrictions=[2000, MaxConnections]=2 [400, MaxConnections]=1 [101, MaxConnections]=1 [21025001, MaxConnections]=1 [100, MaxConnections]=1 [200, MaxConnections]=2 [19007518, MaxConnections]=2 [19043118, MaxConnections]=1

Запись лога Acquiring new connection for module 19007518 информирует о захвате лицензионного слота при подключении нового пользователя.

Запись лога [19007518, MaxConnections]=2 показывает текущее количество используемых лицензионных слотов.

Если имеет место сбой лицензионного кэша на терминале ГК >> выключите фронт и удалите (перенесите в Temp) все файлы *.lic из папки CashServer.

Лицензия не освобождается при разлогине в приложении?

Обратитесь к Support