Оглавление |
---|
Обобщенная архитектура ПО LOYA
Отображение дочерних |
---|
Подготовка окружения для системы
Для работы приложений Loya LOYA необходимо подготовленное окружение на операционной системе Ubuntu18системе Ubuntu 20.04 LTSНапример отсюда официальный сайт Ubuntu.6.
Для подготовки необходимого окружения , нужен хост с установленной операционной системой Ubuntu18Ubuntu 20.04 LTS.6.
Если планируется использовать отдельный диск под DB, то желательно просто подключить дополнительный диск к хосту, не проводя никаких дополнительных настроек по монтированию. Можно использовать уже настроенные разделы, но они должны быть настроены согласно следующим требованиям: раздел для DB должен быть смонтирован в /mnt/lvloyadb/, раздел для Backup должен быть смонтирован в /mnt/lvloyabackup/.
Для подготовки окружения необходимо соблюдение следующих условий:
- Установленная Наличие ОС Ubuntu18Ubuntu 20.04 LTS установленная на , установленной на lvm-раздел. (Имя Необходимо создать пользователя желательно loya с правами sudo, но не обязательно, главное наличие sudo. Наличие дисков при необходимости, необходимо четко знать и понимать. какой диск под какие данные хотим использовать.)SSH подключение администратора.
- Наличие места на диске.
- Наличие SSH-подключения к подготавливаемому хосту.
- Наличие интернета (Необходим необходим для установки Java, MySQL, Telegraf, Elasticsearch, ClickHouse, htop, mc, logtop, ntp, )).
Скрипт настройки окружения (prepare_os.sh) необходимо запросить у представителя ПО
Для настройки окружения нужен скрипт 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, ApiAPI, MySQL, Sphinx, ElasticElasticsearch
3 Processing
$2 =
0 Все на одном root-разделе
1 В наличии отдельный hdd под DB
3 В наличии отдельные hdd под DB и Backup
$3 =
0 Локальная сеть С+нашей компании
1 сеть Клиентаклиента
$4 =
0 Тестовая лицензия (тестовый сервер лицензирования)
...
Самые популярные комбинации:
Блок кода |
---|
./prepare_os.sh 0 0 0 |
...
0 loya-full |
Данная команда запустит скрипт и подготовит полное окружение на одном хосте и даст для телеграфа название test_host_prepareos (Telegraf полностью настраивается, но при настройке отключается автостарт и выключается, что бы в базу не слать тесты).
Блок кода |
---|
./prepare_os.sh 2 3 1 1 |
...
client-backend |
Данная команда запустит скрипт и подготовит полное окружение для backend с двумя хардами, один – под БД, второй – под бекапы.
Блок кода |
---|
./prepare_os.sh 3 0 1 1 |
...
client-processing |
Данная команда запустит скрипт и подготовит полное окружение для processing
После окончания работы скрипта открыть недостающие порты для clickhouse и цепочек:
sudo ufw allow 8123/tcp
sudo ufw allow 8123
sudo ufw allow 9900/tcp
sudo ufw allow 9900.
Инсталляция Лоя
Для полноценной работы ПО необходимо установить следующие сервисы 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, соответственно.