Обобщенная архитектура ПО LOYA
Подготовка окружения для системы
Для работы приложений LOYA необходимо подготовленное окружение на операционной системе Ubuntu18.04 LTS.
Для подготовки необходимого окружения, нужен хост с установленной операционной системой Ubuntu18.04 LTS.
Если планируется использовать отдельный диск под DB, то желательно просто подключить дополнительный диск к хосту, не проводя никаких дополнительных настроек по монтированию. Можно использовать уже настроенные разделы, но они должны быть настроены согласно следующим требованиям: раздел для DB должен быть смонтирован в /mnt/lvloyadb/, раздел для Backup должен быть смонтирован в /mnt/lvloyabackup/.
Для подготовки окружения необходимо соблюдение следующих условий:
- Наличие ОС Ubuntu18.04 LTS, установленной на lvm-раздел. Имя пользователя желательно установить как loya с правами sudo, но не обязательно: главное – наличие sudo. Наличие дисков при необходимости, нужно четко знать и понимать, какой диск под какие данные предполагается использовать.
- Наличие SSH-подключения к подготавливаемому хосту.
- Наличие интернета (необходим для установки Java, MySQL, Telegraf, Elasticsearch, ClickHouse, htop, mc, logtop, ntp, и т.п.).
Скрипт настройки окружения необходимо запросить у представителя ПО.
Для настройки окружения нужен скрипт prepare_os.sh. Его необходимо скачать из репозитория и скопировать удобным способом на хост, на котором необходимо подготовить окружение.
Перед запуском разрешить права на исполнение:
chmod +x prepare_os.sh
Проверить доступность обновлений:
apt-get update
Параметры запуска скрипта:
./prepare_os.sh $1 $2 $3 $4 $5
$1 =
0 Все сервисы Loya на одном хосте
2 Backend, Api, MySQL, Sphinx, Elastic
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 test_host_prepareos
Данная команда запустит скрипт и подготовит полное окружение на одном хосте, а также даст для телеграфа название test_host_prepareos (Telegraf полностью настраивается, но при настройке отключается автостарт и выключается, чтобы в базу не слать тесты).
./prepare_os.sh 2 3 1 1 klient-backend
Данная команда запустит скрипт и подготовит полное окружение для backend с двумя хардами, один – под БД, второй – под бекапы.
./prepare_os.sh 3 0 1 1 klient-processing
Данная команда запустит скрипт и подготовит полное окружение для processing.
После окончания работы скрипта необходимо открыть недостающие порты для clickhouse и цепочек:
sudo ufw allow 8123/tcp
sudo ufw allow 8123
sudo ufw allow 9900/tcp
sudo ufw allow 9900
Инсталляция Backend
Установка
Для инсталляции сервиса loya-backend необходимо:
- Скопировать архив со скриптом развертки backend-x.x.x.tar.gz (необходимо запросить у представителя ПО).
- Скопировать архив на целевой хост в домашний каталог пользователя loya. При копировании архива с помощью программы Winscp выставить опцию "копировать как бинарные файлы".
- Разархивировать архив:
$ tar xzf backend-X.X.X.tar.gz
- Повысить привилегии пользователя loya:
$ sudo su
- Запустить скрипт установки:
# ./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 |
Инсталляция Processing
Установка
Для инсталляции сервиса loya-processing необходимо:
- Скопировать архив со скриптом развертки processing-x.x.x.tar.gz (необходимо запросить у представителя ПО).
- Скопировать архив на целевой хост в домашний каталог пользователя loya. При копировании архива с помощью программы Winscp выставить опцию "копировать как бинарные файлы".
- Разархивировать архив:
$ tar xzf processing-X.X.X.tar.gz
- Повысить привилегии пользователя loya:
$ sudo su
- Запустить скрипт установки:
# ./processing-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 (9010) [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 |