Подготовка окружения для системы
Для работы приложений LOYA необходимо подготовленное окружение на операционной системе Ubuntu18.04.03LTS.
Для подготовки необходимого окружения нужен хост с установленной операционной системой Ubuntu18.04.03LTS.
Если планируется использовать отдельный диск под DB, то желательно просто подключить дополнительный диск к хосту, не проводя никаких дополнительных настроек по монтированию. Можно использовать уже настроенные разделы, но они должны быть настроены согласно следующим требованиям: раздел для DB должен быть смонтирован в /mnt/lvloyadb/, раздел для Backup должен быть смонтирован в /mnt/lvloyabackup/.
Для подготовки окружения необходимо соблюдение следующих условий:
- Наличие ОС Ubuntu18.04 LTS, установленной на 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, Sphinx, 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 test_host_prepareos
Данная команда запустит скрипт и подготовит полное окружение на одном хосте, а также даст для телеграфа название test_host_prepareos.
./prepare_os.sh 2 3 1 1 klient-backend
Данная команда запустит скрипт и подготовит полное окружение для backend с двумя хардами, один – под БД, второй – под бекапы.
./prepare_os.sh 3 0 1 1 klient-processing
Данная команда запустит скрипт и подготовит полное окружение для processing.
Инсталляция Backend
Установка
Для инсталляции сервиса loya-backend необходимо:
- Скопировать архив со скриптом развертки backend-x.x.x.tar.gz (необходимо запросить у представителя ПО).
- Скопировать архив на целевой хост в домашний каталог пользователя loya. При копировании архива с помощью программы Winscp выставить опцию "копировать как бинарные файлы".
- Разархивировать архив:
$ tar xzf backend-X.X.X.tar.gz
- Запустить скрипт установки с правами администратора:
# ./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 [ENTER]
Настройка
После установки необходимо прописать лицензионный ключ, его надо запросить у представителя ПО.
Запуск
Команда для запуска сервиса loya-backend: sudo systemctl start loya-backend
Обновление
Для обновления сервиса loya-backend необходимо:
- Скопировать архив со скриптом развертки backend-x.x.x.tar.gz (необходимо запросить у представителя ПО).
- Скопировать архив на целевой хост в домашний каталог пользователя loya
- Разархивировать архив:
$ tar xzf backend-X.X.X.tar.gz
- Остановить loya-backend:
sudo systemctl stop loya-backend
- Запустить скрипт установки с правами администратора:
# ./backend-X.X.X.sh
На этапе копирования conf-файлов, следует ответить N.
Инсталляция Processing
Установка
Для инсталляции сервиса loya-processing необходимо:
- Скопировать архив со скриптом развертки processing-x.x.x.tar.gz (необходимо запросить у представителя ПО).
- Скопировать архив на целевой хост в домашний каталог пользователя loya.
- Разархивировать архив:
$ tar xzf processing-X.X.X.tar.gz
- Запустить скрипт установки с правами администратора:
# ./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 [ENTER]
Настройка
После установки необходимо прописать лицензионный ключ, его надо запросить у представителя ПО.
Запуск
Команда для запуска loya-processing: sudo systemctl start loya-processing.
Обновление
Для обновления сервиса loya-processing необходимо:
- Скопировать архив со скриптом развертки processing-x.x.x.tar.gz (необходимо запросить у представителя ПО).
- Скопировать архив на целевой хост в домашний каталог пользователя loya.
- Разархивировать архив:
$ tar xzf processing-X.X.X.tar.gz
- Повысить привилегии пользователя loya:
$ sudo su
- Остановить loya-processing:
sudo systemctl stop loya-processing
- Запустить скрипт установки с правами администратора:
# ./processing-X.X.X.sh
На этапе копирования conf-файлов, следует ответить N.
Инсталляция сервиса API-external
Установка
Для инсталляции сервиса loya-api необходимо:
- Скопировать архив со скриптом развертки loya-external-api-x.x.x.tar.gz (необходимо запросить у представителя ПО).
- Скопировать архив на целевой хост в домашний каталог пользователя loya.
- Разархивировать архив:
$ tar xzf loya-external-api-X.X.X.tar.gz
- Запустить скрипт установки с правами администратора:
# ./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
* Enter port number (1-65535) or press ENTER to use current [ENTER]
Настройка
После установки необходимо прописать лицензионный ключ, его надо запросить у представителя ПО.
Для полноценной работы сервиса необходимо корректно настроить сервис Nginx. Для этого надо воспользоваться скриптом настройки Nginx по инструкции Типовая конфигурация Nginx (нужно запросить у представителя ПО). В кратком изложении, необходимо скопировать скрипт config-https.sh и запустить его без параметров.
Инструкция по работе со скриптом:
$ chmod +x config-https.sh $ sudo su
Первый вариант запуска – когда на хосте необходимо провести либо первоначальную настройку, либо вернуть текущие настройки Nginx к первоначальным:
# ./config-https.sh
Запуск
Команда для запуска loya-api-external: sudo systemctl start loya-api.
Обновление
Для обновления сервиса loya-api необходимо:
- Скопировать архив со скриптом развертки loya-external-api-x.x.x.tar.gz (необходимо запросить у представителя ПО).
- Скопировать архив на целевой хост в домашний каталог пользователя loya.
- Разархивировать архив:
$ tar xzf loya-external-api-X.X.X.tar.gz
- Остановить loya-api:
sudo systemctl stop loya-api
- Запустить скрипт установки с правами администратора:
# ./loya-external-api-X.X.X.sh
На этапе копирования conf-файлов, следует ответить N.