Порядок обновления страницы информации о недоступности до версии 1.1.8

Требования

  • Java 17

Изменения с версии 1.1.8

  • Выполнен переход на Spring Boot 2
  • Для работы требуется Java 17, параметры java можно указать в /etc/default/unavailability-page, например: JAVA_OPTS=-Xmx1024M, также в нем можно указать JAVA_HOME.
  • Для развертывания теперь не требуется Tomcat
  • Настройки теперь указываются либо в файле application.properties, либо как переменные среды (в верхнем регистре и точки заменить на подчеркивания), основные параметры:

    # все параметры перечислены здесь: https://docs.spring.io/spring-boot/docs/current/reference/html/application-properties.html
    
    server.port=8380
    ws.am.endpoint=http://example.com/int/ws/Availability
    ws.am.username=Reader
    ws.am.password=123Qwer
    urls.unavailability-page=https://example.com/unavailability-page/unavailability-page
    urls.site=https://example.com
    mail.mail_to=info@example.com
    mail.mail_support_to=support@example.com
    logging.file.path=/var/log/unavailability-page/
  • В текущем каталоге должен быть расположены каталог msgs с текстами, сами тексты можно скопировать из "unavailability-page-1.1.*-*.war\WEB-INF\classes\msgs\",

  • Установить можно либо из пакета deb/rpm, в этом случае:
    • Добавляется пользователь unavailability-page и группа grpunavailability-page.
    • Управление сервисом выполняется с помощью systemd, файл расположен: /etc/systemd/system/unavailability-page.service.
    • Настройки и сообщения указываются в /etc/unavailability-page/ (основные настройки указаны).
    • При первой установке нужно указать свои значения. После изменения значений, нужно выполнить перезапуск: "systemctl restart unavailability-page"
  • Либо можно самостоятельно развернуть war, как описано в документации Spring Boot: https://docs.spring.io/spring-boot/docs/current/reference/html/deployment.html

Порядок обновления

  1. Обновление версии 1.1.8 и выше:
    • Установить новую версию из пакета deb/rpm либо заменить war.
  2. Обновление с версии 1.1.7 и ниже:
    • Остановить сервис (либо удалить tomcat7):

      service tomcat7 stop
    • Удалить временные файлы из рабочих директорий сервера приложений tomcat:

      /var/lib/tomcat7/webapps/availability/
      /var/cache/tomcat6/work/Catalina/
    • Удалить availability.war из директории/var/lib/tomcat7/webapps/

    • При необходимости стартовать сервис:

      service tomcat7 start