AlertMessagePool Инструкция по развёртыванию

AlertMessagePool представляет из себя Java Web SpringBoot приложение, оно является кросс платформенным и может быть запущено как на Linux так Windows системе

Этапы внедрения

0. Организовать проброс DNAT порта с внешнего интерфейса на котором присутствует реальный белый статичный IP адрес в сети Internet  

1. Установить MySQL сервер/клиент + MySQL Connector/J — ИНСТРУКЦИЯ

2. Установить Java JRE не ниже 1.8 

3. В случае установки через пакеты в ручную прописать все переменные в PATH для обеспечения запуска java из любой точки, а также проверить корректность установки компонентов MySQL, Connector/J/. Настроить начальный параметры авторизации 

4. Настроить Ferewal и открыть для доступа тот порт на котором в дальнейшем будет работать приложение

5. В случае Linux системы войти в консоль MySQL , выполнив команду  mysql -u -root -p

6. Создать пользователя последовательно выполнив команды, при этом заменив значения полей в кавычках  ‘user’ и ‘password’ на желаемые

CREATE USER 'user'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON database.* TO 'user'@'%';
FLUSH PRIVILEGES;

7. Создать базу данных для приложения

CREATE DATABASE MessageAlertPool CHARACTER SET utf8 COLLATE utf8_general_ci;

8. Загрузка jar файла приложения СКАЧАТЬ

• для Linux выполнив команду wget https://legan.by/blog/AlertPoolServer.jar

9. Загрузить конфигурационный файл application.properties, и положить его рядом в jar файлом

• Для Linux выполнив команду wget https://legan.by/blog/application.properties

10. Внести правки в конфигурационный файл приложения в соответствующие поля , согласно ранее установленным значениями порта , пользователя, пароля

server.port=80 # Порт на который осуществлён DNAT проброс
spring.datasource.username = MySQL_User
spring.datasource.password = MySQL_Password

11. Настроить автоматический запуск приложения при старте системы,   вариации запуска могут отличатся в зависимости от типа ОС. Ниже будет приведёт пример организации запуска для Linux системы с системой управления службами systemctl

а) Создайте файл будущей службы выполнив команды

cd /etc/systemd/system
sudo nano alertpool.service

б) Скопируйте ниже приведённый текст в файл, заменив путь к целевой папке с jar файлом приложение на ваш, в обязательном порядке укажите WorkingDirectory для корректного подтягивания файла настроек

[Unit]
Description=Alert Pool Server
After=syslog.target
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/home/ubuntu
ExecStart=/usr/bin/java -jar -Duser.timezone=Europe/Moscow /home/ubuntu/AlertPoolServer.jar

RestartSec=10
Restart=always

[Install]
WantedBy=multi-user.target

в) Последовательно выполните команды

sudo systemctl daemon-reload
sudo systemctl enable alertpool
sudo systemctl start alertpool

г) Для проверки статуса службы следует использовать 

sudo systemctl status alertpool

д) По умолчанию консольный вывод приложения будет транслироваться в /var/log/syslog, проанализировав его следует убедится в отсутствии ошибок запуска

ПС. Если все было сделано правильно то приложение будет доступно по следующему URL 

http://внешний_IP:порт/MessageAlertPool