Описание
Сервис представляет собой API на основе JAVA. Обеспечивает управление индивидуальными конфигурациями OTT для ESR-10: создание, редактирование, прикрепление к привязке инициализации.
Сервис может запускаться на отдельном сервере. Для его запуска требуется JAVA 17. По умолчанию сервис работает на порту 50051.
Рекомендуется установка на одном сервере с EMS.
Управление сервисом
Установка сервиса
apt-get install eltex-jerry
Способы запуска/остановки
Действие | Команда | Ответ |
---|---|---|
Проверка состояния | service eltex-jerry status | Сервис запущен Active: active (running) Cервис не запущен Active: failed |
Запуск сервиса | service eltex-jerry start | Сервис успешно запущен Active: active (running) |
Остановка сервиса | service eltex-jerry stop | Сервис успешно остановлен Active: failed |
Перезапуск сервиса | service eltex-jerry restart | Сервис успешно перезапущен Active: active (running) |
Конфигурация
/etc/eltex-jerry/application.conf
Основной файл конфигурации. Содержит параметры для подключения к БД Mongo.
- Адрес для подключения в БД:
url="jdbc:mysql://localhost:3306/eltex_jerry"
- Порт, на котором работает сервис:
port = 50051
/etc/eltex-jerry/log4j2.xml
- Интервал автоматического перечитывания конфигурации логгера:
<Configuration monitorInterval="600">
- Максимально допустимый размер файла (при его превышении создается новый файл, а старый архивируется):
<Property name="maxFileSize">5 MB</Property>
- Максимальное количество архивных файлов, при его превышении наиболее старые файлы будут перезаписываться:
<Property name="maxCount" value="7"/>
- Базовая директория хранения логов:
<Property name="logDir" value="/var/log/eltex-jerry"/>
- Блок настройки перенаправления логов в Graylog (уровень логирования, адрес, порт):
<Property name="gelfHost" value="udp:lab3-test.eltex.loc" /> <Property name="gelfPort" value="12201" /> <Property name="gelfLevel" value="OFF" /
- Уровень логирования:
<Root level="INFO">
Взаимодействие с EMS
Со стороны EMS настройка взаимодействия осуществляется "Администрирование" → "Настройка сервера" → "Системные модули" → "Wireless common":
В разделе "Доступ к сервису индивидуальных конфигураций OTT (jerry)".
Обновление до версии 1.30
Начиная с версии 1.30 функционал сервиса eltex_jerry был переведен на работу с mysql. Ниже представлена инструкция по миграции данных сервиса из mongodb в mysql.
Подсказка
Если схема OTT не используется - данную миграцию выполнять не нужно.
Миграция данных сервиса Eltex-Jerry из mongoDB в mysql
Скрипт мигрирует данные из mongo в mysql для сервиса Eltex-Jerry
Алгоритм работы скрипта
- Получить все данные сервиса Eltex-Jerry из mongo
- Подсчитать количество записей в mysql на момент запуска скрипта
- Вставить все полученные данные в уже созданные таблицы mysql
- Отобразить данные о количестве перенесенных файлов и времени выполнения скрипта
Подготовка к запуску
- Скачать архив migrate_eltex_jerry_from_mongo_to_mysql.zip,
- Поместить архив на сервер, с которого будут доступны адреса mongodb и mysql,
- Извлечь файлы из архива.
Настроить файл application.conf
Данный файл содержит настройки скрипта. Можно настроить:
log
file_name
- имя файла для логированияlevel
- уровень логирования
mongodb
host
- хост, на котором установлена mongoport
- порт mongo
mysql
host
хост, на котором установлен mysqlport
порт mysqlusername
имя пользователяpassword
пароль пользователяcharset
кодировка базы данных eltex_jerry
Для запуска скрипта должен быть установлен
python3.10
Для запуска скрипта необходимо установить зависимости. Это можно сделать при помощи команды:
sudo pip3.10 install -r requirements.txt
Запуск скрипта
sudo python3.10 main.py
Пример работы скрипта
Start
Файлов было получено из mongo: 4
Файллов было в mysql: 0
Перенос файлов в mysql ...
████████████████████████████████ 100%
Файлов перенесено в mysql: 4
Время выполнения скрипта: 1.83 с.
После запуска скрипта
- После запуска и успешного выполнения скрипта, необходимо перезапустить сервис Eltex-Jerry. Сделать это можно следующей командой на хосте, где установлен сервис:
sudo service eltex-jerry restart