====== 2. Установка, лицензия и обновление ======

Модуль поставляется zip-архивом без инсталлятора и работает службой Windows. Веб-интерфейс встроен в ''aggregator_delivery.exe'', папка ''Static'' больше не нужна.

===== Установка =====

  - Скачать [[https://disk.yandex.ru/d/EV6ZnP9vBqb0AQ|актуальный дистрибутив]] и распаковать в отдельную папку, например ''C:\yeda\''. Не распаковывать на рабочий стол и в папку с номером версии в имени: все данные модуль хранит рядом с exe.
  - Активировать лицензию модуля: ''license.bat'' (см. ниже).
  - Запустить ''install.bat'' от имени администратора. Служба регистрируется с автозапуском и сразу запускается.
  - Открыть в браузере ''%%http://127.0.0.1:5000/%%'' и пройти мастер первичной настройки ([[external:черновик_интеграция_с_агрегаторами_доставки:03_web_wizard|страница 3]]).

Служба называется по папке установки: для ''C:\yeda\'' - "Carbis YaEda Agent (C:\yeda)" (''CarbisYAService_C_yeda_''). Если в пути есть скобки, ''+'', '','' и другие спецсимволы - просто "Carbis YaEda Agent", и такая установка на машине может быть только одна.

^ Файл ^ Для чего ^
| ''install.bat'' | установить и запустить службу (от администратора) |
| ''uninstall.bat'' | удалить службу |
| ''run_service.bat'' / ''stop_service.bat'' | запустить / остановить службу |
| ''desktop.bat'' | запустить в окне, без службы (для проверки) |
| ''license.bat'' | окно лицензирования модуля |

===== Лицензии =====

Для приема заказов нужны две лицензии одновременно:
  * **лицензия на модуль** - заявка на info@carbis.ru, активация через ''license.bat'': авторизоваться дилерской учетной записью lic.carbis.ru и выбрать созданную лицензию;
  * **лицензия XML-создания заказа от UCS** - заявка в UCS в стандартном порядке или через дилера. Поддержаны оба варианта: "XML сохранения заказов" (lifetime) и "XML-интерфейс для приложения" (SaaS). Подробнее - [[external:zz_дополнительные_материалы:xml_save_order|Как использовать платный XML-интерфейс]].

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s2_01.png |Окно лицензирования license.bat}}

Без лицензий модуль работает в режиме заполнения меню: настройку и подготовку меню можно делать заранее. Без действующей лицензии модуля заказ остается "Новым" с ошибкой "Лицензия на программное обеспечение недействительна".

Лицензию модуль подхватывает при старте и перепроверяет раз в 5 минут. Проверить сразу - кнопка "Проверить лицензию" на странице "Система". Срок лицензии виден в строке состояния внизу веб-интерфейса.

===== Обновление =====

Обновлять можно сразу на последнюю версию, минуя промежуточные. Обновление с 1.9.x и 1.11.x делается поверх старой папки без перенастройки: настройки, заказы, картинки блюд, лицензия и SaaS XML сохраняются.
  - Сделать копию папки модуля (как минимум ''dbase.db'', ''aggregator_delivery_settings.yaml'', ''saasdata'', ''Static\userimages\'').
  - Остановить службу в ''services.msc'': "Carbis YaEda Agent (<папка>)" или "Carbis YaEda Agent". ''stop_service.bat'' старых версий службу с путем в имени не находит.
  - Распаковать новую версию в ту же папку с заменой файлов.
  - Запустить службу: ''run_service.bat'' (уже из новой версии). Переустанавливать службу не нужно.

После обновления проверить: в шапке "r_keeper на связи", на странице "Система" видны лицензия и версия, в меню у блюд есть картинки, после очередного запроса Яндекса обновляется "Яндекс: меню".

Откат на 1.11.2: остановить службу (''stop_service.bat''), распаковать 1.11.2 в ту же папку, скопировать ''userimages\'' в ''Static\userimages\'', запустить службу в ''services.msc''. Данные при откате не теряются.