Подготовка окружения для системы
Для работы приложений LOYA необходимо подготовленное окружение на операционной системе Ubuntu 20.04.6.
Для подготовки необходимого окружения нужен хост с установленной операционной системой Ubuntu 20.04.6.
Если планируется использовать отдельный диск под DB, то желательно просто подключить дополнительный диск к хосту, не проводя никаких дополнительных настроек по монтированию. Можно использовать уже настроенные разделы, но они должны быть настроены согласно следующим требованиям: раздел для DB должен быть смонтирован в /mnt/lvloyadb/, раздел для Backup должен быть смонтирован в /mnt/lvloyabackup/.
Для подготовки окружения необходимо соблюдение следующих условий:
- Наличие ОС Ubuntu 20.04, установленной на lvm-раздел. Необходимо создать пользователя с правами администратора.
- Наличие места на диске.
- Наличие SSH-подключения к подготавливаемому хосту.
- Наличие интернета (необходим для установки Java, MySQL, Telegraf, Elasticsearch).
Скрипт настройки окружения (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-{имя сервиса} необходимо:
- Скопировать архив со скриптом развертки {имя сервиса}-x.x.x.tar.gz (необходимо запросить у представителя ПО).
- Скопировать архив на целевой хост в домашний каталог пользователя 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, соответственно.