Требования

  • Java 17
  • Поддерживается обновление сайта с версии 1.2.31-4, если текущая версия сайта ниже, то рекомендуется сначала обновиться на эту версию.
  • Менеджер сервиса не ниже версии 1.1.5.14

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

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

    # все параметры перечисление здесь: https://docs.spring.io/spring-boot/docs/current/reference/html/application-properties.html
    server.port=8180
    management.server.port=8181
    spring.datasource.url=jdbc:postgresql://localhost:5432/site?ApplicationName=site
    spring.datasource.username=postgres
    spring.datasource.password=postgres
    logging.file.path=/var/log/site/
  • Также настройки можно указать как переменные среды (в верхнем регистре с заменой точек на подчеркивания), например:

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

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

  1. Выполнить резервное копирование:
    • БД сайта
  2. Обновление версии сайта 1.2.32 и выше:
    • Установить новую версию из пакета deb/rpm либо заменить war.
  3. Обновление с версии сайта ниже, чем 1.2.31:
    • Обновиться до версии 1.2.31
  4. Обновление с версии сайта 1.2.31:
    • Остановить сервис либо удалить tomcat7:

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

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

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

      service tomcat7 start