Подготовка окружения для системы

Для работы приложений LOYA необходимо подготовленное окружение на операционной системе Ubuntu 20.04.6.

Для подготовки необходимого окружения нужен хост с установленной операционной системой Ubuntu 20.04.6.

Если планируется использовать отдельный диск под DB, то желательно просто подключить дополнительный диск к хосту, не проводя никаких дополнительных настроек по монтированию. Можно использовать уже настроенные разделы, но они должны быть настроены согласно следующим требованиям: раздел для DB должен быть смонтирован в /mnt/lvloyadb/, раздел для Backup должен быть смонтирован в /mnt/lvloyabackup/.

Для подготовки окружения необходимо соблюдение следующих условий:

Скрипт настройки окружения (prepare_os.sh) необходимо запросить у представителя ПО. Его надо скопировать удобным способом на хост, на котором необходимо подготовить окружение.

Перед запуском нужно разрешить права на исполнение:

chmod +x prepare_os.sh

Также необходимо проверить доступность обновлений:

apt-get update

Далее, запускаем сам скрипт с набором необходимых параметров.

Пример запуска скрипта подготовки окружения для локальной сети нашей компании с тестовой лицензией, где все устанавливается на один диск, с названием хоста для мониторинга test_host_prepareos (имя test_host_prepareos будет также добавлено в hostname):

./prepare_os.sh 0 0 0 0 test_host_prepareos

Пример запуска скрипта подготовки окружения для хоста, на котором будет только процессинг в локальной сети нашей компании, с названием хоста для мониторинга test_host_prepareos:

./prepare_os.sh 0 3 0 0 test_host_prepareos

Параметры запуска скрипта:

./prepare_os.sh $1 $2 $3 $4 $5


$1 =

0 Все сервисы Loya на одном хосте

2 Backend, API, MySQL, Elasticsearch

3 Processing


$2 =

0 Все на одном root-разделе

1 В наличии отдельный hdd под DB

3 В наличии отдельные hdd под DB и Backup


$3 =

0 Локальная сеть нашей компании

1 сеть клиента


$4 =

0 Тестовая лицензия (тестовый сервер лицензирования)

1 Боевая лицензия (боевой сервер лицензирования)


$5 = Имя хоста для мониторинга Grafana


Самые популярные комбинации:

./prepare_os.sh 0 0 0 0 loya-full

Данная команда запустит скрипт и подготовит полное окружение на одном хосте.

./prepare_os.sh 2 3 1 1 client-backend

Данная команда запустит скрипт и подготовит полное окружение для backend с двумя хардами, один – под БД, второй – под бекапы.

./prepare_os.sh 3 0 1 1 client-processing

Данная команда запустит скрипт и подготовит полное окружение для processing.

Инсталляция Лоя

Для полноценной работы ПО необходимо установить следующие сервисы loya-backend, loya-processing, loya-api. Все сервисы устанавливаются одинаково, инструкция по установке приведена ниже

Установка

Для инсталляции сервиса loya-{имя сервиса} необходимо:

$ tar xzf {имя сервиса}-X.X.X.tar.gz
# ./{имя сервиса}-X.X.X.sh

          При запросе директории для установки, следует указать директорию /{домашний каталог пользователя}/loya/.

* Enter installation path or press ENTER to use current (/{домашний каталог пользователя}) [ENTER]:
/{домашний каталог пользователя}/loya/

          При запросе порта для работы приложения, ничего указывать не надо, необходимо подтвердить значение по умолчанию вводом Enter.

* Enter port number (1-65535) or press ENTER to use current [ENTER]

Настройка

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

Запуск

Команда для запуска сервиса loya-{имя сервиса}: sudo systemctl start loya-{имя сервиса}

Импорт товаров с касс

Выгрузка справочников товаров с касс УКМ 4 и УКМ 5 в LOYA служит для упрощения интеграции кассы с системой лояльности. При расчете скидок на товары и группы товаров, LOYA использует справочники товаров, загруженные с кассы, в связи с чем их загрузку в LOYA следует производить до начала пользования системой.

На стороне LOYA за процесс загрузки товаров с касс УКМ 4 и УКМ 5 отвечают блоки Справочники. Товары и Справочники. Категории товаров в API-документации LOYA (для версии 1.60). Настройки экспорта товаров с касс в LOYA описаны для УКМ 4 и УКМ 5, соответственно.