...
- Наличие ОС Ubuntu18.04 LTS, установленной на lvm-раздел. Имя пользователя желательно установить как loya с правами sudo, но не обязательно: главное – наличие sudo.
Наличие дисков, при необходимости: нужно четко знать и понимать, какой диск под какие данные предполагается использоватьНеобходимо создать пользователя с правами администратора. - Наличие места на диске.
- Наличие SSH-подключения к подготавливаемому хосту.
- Наличие интернета (необходим для установки Java, MySQL, Telegraf, Elasticsearch).
Скрипт настройки окружения (prepare_os.sh) необходимо запросить у представителя ПО.Для настройки окружения нужен скрипт prepare_os.sh. Его надо скачать из репозитория и Его надо скопировать удобным способом на хост, на котором необходимо подготовить окружение.
...
Данная команда запустит скрипт и подготовит полное окружение на одном хосте, а также даст для телеграфа название test_host_prepareos (Telegraf полностью настраивается, но при настройке отключается автостарт и выключается, чтобы в базу не слать тесты).
Блок кода |
---|
./prepare_os.sh 2 3 1 1 klient-backend |
...
Данная команда запустит скрипт и подготовит полное окружение для processing.
После окончания работы скрипта необходимо открыть недостающие порты для clickhouse и цепочек:
sudo ufw allow 8123/tcp
sudo ufw allow 8123
sudo ufw allow 9900/tcp
sudo ufw allow 9900
Подарочные сертификаты:
sudo ufw allow 9092/tcp
sudo ufw allow 9092
sudo ufw allow 9003/tcp
sudo ufw allow 9003
Elasticsearch:
sudo ufw allow 9092/tcp
sudo ufw allow 9092
Инсталляция Backend
Установка
...
Блок кода |
---|
$ tar xzf backend-X.X.X.tar.gz
|
- Повысить привилегии пользователя loya:
Блок кода |
---|
$ sudo su
|
- Запустить скрипт установки с правами администратора:
Блок кода |
---|
# ./backend-X.X.X.sh |
...
Блок кода |
---|
* Enter port number (1-65535) or press ENTER to use current (9090) [ENTER] |
Настройка
После установки необходимо прописать лицензионный ключ в файл user.conf, находящийся в директории /home/loya/loya/backend/conf/user.conf, его надо запросить у представителя ПО.
Запуск
Команда для запуска Loyaзапуска сервиса loya-backend, в зависимости от версии релиза ОС Ubuntu:
...
: sudo systemctl start loya-
...
Команда для остановки 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
backend
Обновление
Для обновления сервиса loya-backend необходимо:
- Скопировать архив со скриптом развертки backend-x.x.x.tar.gz (необходимо запросить у представителя ПО).
- Скопировать архив на целевой хост в домашний каталог пользователя loya. При копировании архива с помощью программы Winscp выставить опцию "копировать как бинарные файлы".
- Разархивировать архив:
Блок кода |
---|
$ tar xzf backend-X.X.X.tar.gz
|
- Повысить привилегии пользователя loya:
$ sudo su |
- Остановить loya-backend:
Блок кода |
---|
Ubuntu 16-18 #systemctlsudo systemctl stop loya-backend Ubuntu 14 #service loya_backend stop |
- Запустить скрипт установки с правами администратора:
Блок кода |
---|
# ./backend-X.X.X.sh |
...
- Скопировать архив со скриптом развертки processing-x.x.x.tar.gz (необходимо запросить у представителя ПО).
- Скопировать архив на целевой хост в домашний каталог пользователя loya. При копировании архива с помощью программы Winscp выставить опцию "копировать как бинарные файлы".
- Разархивировать архив:
Блок кода |
---|
$ tar xzf processing-X.X.X.tar.gz
|
- Повысить привилегии пользователя loya:
Блок кода |
---|
$ sudo su
|
- Запустить скрипт установки с правами администратора:
Блок кода |
---|
# ./processing-X.X.X.sh |
...
Блок кода |
---|
* Enter port number (1-65535) or press ENTER to use current (9010) [ENTER]
|
...
Настройка
После установки необходимо прописать лицензионный ключ в файл user.conf, находящийся в директории /home/loya/loya/processing/conf/user.conf, его надо запросить у представителя ПО.
Запуск
Команда для запуска Loyaloya-processing, в зависимости от версии релиза ОС Ubuntu:
...
: sudo systemctl start loya-processing
...
Команда для остановки 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
.
Обновление
Для обновления сервиса loya-processing необходимо:
- Скопировать архив со скриптом развертки processing-x.x.x.tar.gz (необходимо запросить у представителя ПО).
- Скопировать архив на целевой хост в домашний каталог пользователя loya. При копировании архива с помощью программы Winscp выставить опцию "копировать как бинарные файлы".
- Разархивировать архив:
Блок кода |
---|
$ tar xzf processing-X.X.X.tar.gz |
...
- Остановить loya-processing:
Блок кода |
---|
Ubuntu 16-18 #systemctlsudo systemctl stop loya-processing Ubuntu 14 #service loya_processing stop |
- Запустить скрипт установки с правами администратора:
Блок кода |
---|
# ./processing-X.X.X.sh |
...
Инсталляция сервиса API-external
Начиная с версии 1.35 LOYA, API был выделен в отдельный сервис, для того чтобы проблемы при перезагрузке или сильной загруженности loya-backend не приводили к проблемам с доступностью API.
Установка
Для инсталляции сервиса loya-api необходимо:
- Скопировать архив со скриптом развертки loya-external-api-x.x.x.tar.gz (необходимо запросить у представителя ПО).
- Скопировать архив на целевой хост в домашний каталог пользователя loya. При копировании архива с помощью программы Winscp выставить опцию "копировать как бинарные файлы".
- Разархивировать архив:
Блок кода |
---|
$ tar xzf loya-external-api-X.X.X.tar.gz |
- Повысить привилегии пользователя loya:
$ sudo su |
- Запустить скрипт установки с правами администратора:
Блок кода |
---|
# ./loya-external-api-X.X.X.sh |
...
Блок кода |
---|
* Enter port number (1-65535) or press ENTER to use current (9091) [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 по инструкции
Типовая конфигурация Nginx (нужно запросить у представителя ПО). В кратком изложении, необходимо скопировать скрипт config-https.sh и запустить его без параметров. Якорь nginx nginx
...
Запуск
Команда для запуска API-external, в зависимости от версии релиза ОС Ubuntu:
...
loya-api
...
Команда для остановки 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:
...
sudo systemctl start loya-api.
Обновление
Для обновления сервиса loya-api необходимо:
- Скопировать архив со скриптом развертки loya-external-api-x.x.x.tar.gz (необходимо запросить у представителя ПО).
- Скопировать архив на целевой хост в домашний каталог пользователя loya. При копировании архива с помощью программы Winscp выставить опцию "копировать как бинарные файлы".
- Разархивировать архив:
Блок кода |
---|
$ tar xzf loya-external-api-X.X.X.tar.gz |
- Повысить привилегии пользователя loya:
Блок кода |
---|
$ sudo su |
- Остановить loya-api:
Блок кода |
---|
Ubuntu 16-18sudo # systemctl stop loya-api Ubuntu 14 # service loya_api stop |
- Запустить скрипт установкиустановки с правами администратора:
Блок кода |
---|
# ./loya-external-api-X.X.X.sh |
...