История страницы

Обобщенная архитектура ПО LOYA

...

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

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

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

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

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

• Наличие ОС Ubuntu18Ubuntu 20.04 LTS, установленной на lvm-раздел. Имя пользователя желательно установить как loya с правами sudo, но не обязательно: главное – наличие sudo. Наличие дисков при необходимости, нужно четко знать и понимать, какой диск под какие данные предполагается использоватьНеобходимо создать пользователя с правами администратора.
  
  
• Наличие места на диске.
  
  
• Наличие 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

Подарочные сертификаты:

...

...

Elasticsearch:

sudo ufw allow 9092/tcp
sudo ufw allow 9092

Инсталляция Backend

Установка

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

...

• Повысить привилегии пользователя loya:

...

• Запустить скрипт установки:

          # ./backend-X.X.X.sh

          При запросе директории для установки, следует указать директорию /home/loya/loya/.

          * Enter installation path or press ENTER to use current (/root/loya) [ENTER]:/home/loya/loya/

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

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

Настройка

После установки необходимо прописать лицензионный ключ в файл user.conf, находящийся в директории /home/loya/loya/backend/conf/user.conf.

Запуск

Команда для запуска Loya-backend, в зависимости от версии релиза ОС Ubuntu:

...

Ubuntu 16-18 $ sudo systemctl start loya-backend             Ubuntu 14 $ sudo service loya_backend start

Команда для остановки Loya-backend:

...

Ubuntu 16-18 $ sudo systemctl stop loya-backend               Ubuntu 14 $ sudo service loya_backend stop

Команда для перезапуска Loya-backend:

...

Ubuntu 16-18 $ sudo systemctl restart loya-backend            Ubuntu 14 $ sudo service loya_backend restart

Команда для получения статуса Loya-backend:

...

Ubuntu 16-18 $ sudo systemctl status loya-backend             Ubuntu 14 $ sudo service loya_backend status

Обновление

...

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

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

Установка

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

...

• Скопировать архив со скриптом развертки

...

• {имя сервиса}-x.x.x.tar.gz (необходимо запросить у представителя ПО).
  
  
• Скопировать архив на целевой хост в домашний каталог пользователя loya.

...

•  
  
  
• Разархивировать архив:
  

...

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

...

• Повысить привилегии пользователя loya:

...

• Остановить loya-backend:

           Ubuntu 16-18

           #systemctl stop loya-backend

           Ubuntu 14

...

• Запустить скрипт установки:

          # ./backend-X.X.X.sh

На этапе копирования conf файлов, отвечаем N

Инсталляция Processing

Установка

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

...

• Повысить привилегии пользователя loya:

          $ sudo su

• Запустить скрипт установки:

...

• Запустить скрипт установки с правами администратора:
  

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

          При запросе директории для установки,   следует указать директорию /home{домашний каталог пользователя}/loya/loya/.          * Enter installation path or press ENTER to use current (/root/loya)

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

...

/{домашний каталог пользователя}/loya/

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

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

...

 [ENTER]

Настройка

После установки необходимо прописать лицензионный ключ в файл user.conf, находящийся в директории /home/loya/loya/processing/conf/user.conf, за которым следует обратиться к команде технической поддержки.

Запуск

Команда для запуска Loya-processing, в зависимости от версии релиза ОС Ubuntu:

...

Ubuntu 16-18 $ sudo systemctl start loya-processing              Ubuntu 14 $ sudo service loya_processing start

Команда для остановки Loya-processing:

...

Ubuntu 16-18 $ sudo systemctl stop loya-processing               Ubuntu 14 $ sudo service loya_processing stop

Команда для перезапуска Loya-processing:

...

Ubuntu 16-18 $ sudo systemctl restart loya-processing            Ubuntu 14 $ sudo service loya_processing restart

Команда для получения статуса Loya-processing:

...

Ubuntu 16-18 $ sudo systemctl status loya-processing             Ubuntu 14 $ sudo service loya_processing status

Инсталляция сервиса API-external

Начиная с версии 1.35 LOYA, API был выделен в отдельный сервис, для того чтобы проблемы при перезагрузке или сильной загруженности loya-backend не приводили к проблемам с доступностью API.

Установка

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

...

• Повысить привилегии пользователя loya:

...

• Запустить скрипт установки:

          # ./loya-external-api-X.X.X.sh

          При запросе директории для установки, следует указать директорию /home/loya/loya/

          * Enter installation path or press ENTER to use current (/root/loya) [ENTER]:/home/loya/loya/

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

...

• После установки и запуска отдельного API необходимо указать license.client=" " в файл /home/loya/loya/api/conf/user.conf.

Настройка

После установки необходимо прописать лицензионный ключ в файл user.conf, находящийся в директории /home/loya/loya/api/conf/user.conf. Ключ надо вписать в параметр license.client="" между кавычек. Взять ключ можно из конфигурационного файла user.conf бэкенда, расположенного в директории /home/loya/loya/backend/conf/.

Для полноценной работы сервиса необходимо корректно настроить сервис Nginx. Для этого надо воспользоваться скриптом настройки Nginx. В кратком изложении, необходимо скопировать скрипт и запустить его без параметров. Инструкция по работе со скриптом:

$ chmod +x config-https.sh$ sudo su

Первый вариант запуска – когда на хосте необходимо провести либо первоначальную настройку, либо вернуть текущие настройки nginx к первоначальным:

# ./config-https.sh

Запуск

Команда для запуска API-external в зависимости от версии релиза ОС Ubuntu:

...

Ubuntu 16-18 $ sudo systemctl start loya-api             Ubuntu 14 $ sudo service loya_api start

Команда для остановки API-external:

...

Ubuntu 16-18 $ sudo systemctl stop loya-api               Ubuntu 14 $ sudo service loya_api stop

Команда для перезапуска API-external:

...

Ubuntu 16-18 $ sudo systemctl restart loya-api            Ubuntu 14 $ sudo service loya_api restart

Команда для получения статуса API-external:

...

сервиса loya-{имя сервиса}: sudo systemctl start loya-{имя сервиса}

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

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

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