Эксплуатация SMP и Tomcat

Запуск SMP

Запуск приложения осуществляется посредством запуска сервиса tomcat. Если приложение установлено согласно рекомендациям в данном руководстве, то при загрузке сервера происходит автоматический запуск указанного сервиса. При необходимости ручного запуска выполните следующую команду:

sudo systemctl start tomcat

Отслеживать процесс запуска приложения можно по логу /opt/naumen/nausd4/logs/sdng.log

Если приложение подключено к внешнему брокеру очередей Artemis (см. Подключение внешнего брокера очередей), то его запуск необходимо выполнять после старта Artemis.

Остановка SMP

Остановка приложения осуществляется посредством остановки сервиса tomcat. Для этого выполните следующую команду:

sudo systemctl stop tomcat

Проверка наличия процесса приложения на сервере

При администрировании системы зачастую приходится проверять статус работы сервиса, процесса на сервере.

Для того, чтобы узнать статус сервиса tomcat выполните следующую команду:

sudo systemctl status tomcat

Для того, чтобы проверить наличие процесса на сервере выполните:

ps aux | grep tomcat | grep -v grep

Сбор логов для передачи службе технической поддержки

В процессе диагностики проблем работы приложения могут потребоваться логи приложения. Собрать их будет удобно следующим способом:

  1. Создайте каталог для сбора диагностической информации:

    mkdir -p /opt/naumen/mon/$(date +'%F') && cd $_

  2. Скопируйте в него следующие логи:

    • Текущий лог приложения

      cp /opt/naumen/nausd4/logs/sdng.log ./

    • Текущий лог Garbage Collector-a

      cp $(ls -t /opt/naumen/nausd4/tomcat/logs/gc* | head -n 1) ./

    • Текущий лог catalina.out

      cp /opt/naumen/nausd4/tomcat/logs/catalina.out ./

    • Текущий лог localhost

      cp /opt/naumen/nausd4/tomcat/logs/localhost.$(date +'%F').log ./

    • Текущий лог localhost_access_log

      cp /opt/naumen/nausd4/tomcat/logs/localhost_access_log.$(date +'%F').txt ./

Создание резервной копии SMP

Наиболее важными с точки зрения корректности функционирования системы являются файлы конфигурации приложения, оперативные данные приложения.

Резервное копирование необходимо выполнять при обновлении, а также периодически на случай восстановления при сбоях.

Объект Путь Правило резервирования
Каталог с конфигурационными файлами приложения /opt/naumen/nausd4/conf При изменении настроек, при обновлении приложения
War-файл /opt/naumen/nausd4/tomcat/webapps/sd.war При обновлении приложения
Конфигурация Tomcat /opt/naumen/nausd4/tomcat/conf/server.xml При изменении настроек, при обновлении Tomcat
Конфигурация JVM /opt/naumen/nausd4/tomcat/bin/setenv.sh При изменении настроек, при обновлении Tomcat

Резервные копии, создаваемые при изменениях конфигурации и при обновлениях, рекомендуется размещать в фиксированном месте, чтобы удобнее было выполнять операции резервирования, обновления, отката версий. Размещать эти файлы рекомендуем в каталоге /opt/naumen/deploy.

Перед началом работ в этом каталоге создайте подкаталоги <текущая дата>/{update,backup}:

  • update - для новых версий;
  • backup - для резервных копий.

Процедура создания резервной копии приложения состоит из следующих шагов:

  1. Создайте каталог для сохранения резервной копии

    mkdir -p /opt/naumen/deploy/$(date +'%F')/{update,backup}

  2. Сделайте резервную копию файла sd.war

    cp /opt/naumen/nausd4/tomcat/webapps/sd.war /opt/naumen/deploy/$(date +'%F')/backup/

  3. Сделайте резервную копию файлов конфигурации

    SMP:

    cp -r /opt/naumen/nausd4/conf/ /opt/naumen/deploy/$(date +'%F')/backup/

    Tomcat:

    cp /opt/naumen/nausd4/tomcat/conf/server.xml /opt/naumen/deploy/$(date +'%F')/backup/

    cp /opt/naumen/nausd4/tomcat/bin/setenv.sh /opt/naumen/deploy/$(date +'%F')/backup/

Изменение параметров приложения

Параметры приложения изменяются в файле /opt/naumen/nausd4/conf/dbaccess.properties.

Перед изменением необходимо сделать резервную копию этого файла, см. Создание резервной копии SMP.

Изменения вступают в силу при перезапуске приложения.

Подробнее см. в разделе dbaccess.properties.

Конфигурация логирования приложения

Настройка уровня логирования, параметров хранения файлов логов приложения осуществляется в файле /opt/naumen/nausd4/conf/log4j2.properties.

Перед изменением необходимо сделать резервную копию этого файла, см. Создание резервной копии SMP.

Изменения вступают в силу при перезапуске приложения.

Подробнее см. в разделе log4j2.properties.

Контроль запуска приложения SMP

При любом запуске приложения - будь то обновление, плановый перезапуск для изменения настроек, или перезапуск для устранения инцидента, рекомендуется осуществлять контроль процесса старта приложения. Это позволит иметь возможность своевременно принимать решения об успешности или не успешности обновления, на раннем этапе обнаруживать ошибки, возникающие в процессе запуска приложения.

Основным источником информации, позволяющим осуществлять контроль данного процесса является лог приложения /opt/naumen/nausd4/logs/sdng.log.

Для того чтобы в реальном времени следить за процессом запуска приложения по логу можно использовать следующую команду:

tail -f /opt/naumen/nausd4/logs/sdng.log | grep 'main'

Начало процесса запуска в приложения сопровождается выводом в лог строки, содержащей server.SpringContextLoaderListener - Starting....

По завершении запуска приложения проверить доступность можно по ссылке http://SERVER_IP:8080/sd/index.jsp. По этой ссылке должна открыться форма ввода логина и пароля приложения при условии, что не закрыт доступ к порту Tomcat-а 8080.

Изменение параметров HTTP-коннектора Tomcat

Параметры HTTP-коннектора Tomcat изменяются в файле /opt/naumen/nausd4/tomcat/conf/server.xml.

Перед изменением необходимо сделать резервную копию этого файла, см. Создание резервной копии SMP.

Изменения вступают в силу при перезапуске приложения.

См. также: