Apache Tomcat ®

Content

Before upgrading or migrating

When updating from one major Apache Tomcat version a newer one, please make sure that the JVM that is installed on your system supports at least the required Java version. While it is possible that older versions of Tomcat may not be compatible with newer JVMs, all the currently supported Apache Tomcat versions (7.0.x, 8.5.x, 9.0.x and 10.0.x) are known to run correctly on Java 8 JVMs.

When migrating from one major Tomcat version to another (e.g. from Tomcat 7 to Tomcat 8, or from Tomcat 8 to Tomcat 8.5), you should not copy the configuration files from the old version to the new version. The recommended approach is to start with the default configuration of the new version of Apache Tomcat and to adjust it as necessary.

When migrating from one minor release to another minor release within the same major release (e.g. from Tomcat 7.0.27 to Tomcat 7.0.28) you can retain the configuration files, but you should check to see if any defaults have changed and/or if any new elements have been added and adjust your configuration files accordingly.

Migration Guides

For upgrading between 10.0.x versions, see the upgrading section of the Tomcat 10.0.x Migration Guide.

For migration from 9.0.x to 10.0.x, see the Tomcat 10.0.x Migration Guide.

For upgrading between 9.0.x versions, see the upgrading section of the Tomcat 9.0.x Migration Guide.

For migration from 8.0.x / 8.5.x to 9.0.x, see the Tomcat 9.0.x Migration Guide.

For upgrading between 8.5.x versions, see the upgrading section of the Tomcat 8.5.x Migration Guide.

For migration from 8.0.x to 8.5.x, see the Tomcat 8.5.x Migration Guide.

For upgrading between 8.0.x versions, see the upgrading section of the Tomcat 8.0.x Migration Guide.

For migration from 7.0.x to 8.0.x, see the Tomcat 8.0.x Migration Guide.

For upgrading between 7.0.x versions, see the upgrading section of the Tomcat 7.0.x Migration Guide.

For migration from 6.0.x to 7.0.x, see the Tomcat 7.0.x Migration Guide.

For upgrading between 6.0.x versions, see the upgrading section of the Tomcat 6.0.x Migration Guide.

For migration from 5.5.x to 6.0.x, see the Tomcat 6.0.x Migration Guide.

Обновление компонента Apache Tomcat с помощью комплексного установщика (Windows)

Apache Tomcat — это необходимый компонент, требующийся для запуска веб-консоли ESET PROTECT. Этот метод подходит для быстрого обновления Apache Tomcat с помощью новейшего комплексного установщика ESET PROTECT 8.0. Или же можно обновить Apache Tomcat вручную.

1. Сделайте резервные копии следующих файлов:

C:\Program Files\Apache Software Foundation\[ Tomcat папка ]\ .keystore
C:\Program Files\Apache Software Foundation\[ Tomcat папка ]\ conf\server.xml
C:\Program Files\Apache Software Foundation\[ Tomcat папка ]\ webapps\era\WEB-INF\classes\sk\eset\era\g2webconsole\server\modules\config\EraWebServerConfig.properties

Если вы используете хранилище SSL-сертификатов с пользовательскими настройками в папке Tomcat , выполните также резервное копирование сертификата.

• Если установлена специальная версия Apache Tomcat (ручная установка службы Tomcat), последующее обновление веб-консоли ESET PROTECT с помощью комплексного установщика не поддерживается.

• При обновлении Apache Tomcat удалится папка era , расположенная в каталоге C:\Program Files\Apache Software Foundation\[ Tomcat папка ]\webapps\ . Если в папке era хранятся дополнительные данные, создайте их резервную копию перед обновлением.

• В случае C:\Program Files\Apache Software Foundation\[ Tomcat папка ]\ если webapps\ содержит дополнительные данные (кроме данных в папках era и ROOT ), Apache Tomcat не обновится и обновится только веб-консоль.

• Обновление веб-консоли и Apache Tomcat очищает файлы автономной справки. Если вы использовали автономную справку в ERA/ESMC или более старой версии ESET PROTECT, после обновления создайте ее повторно для ESET PROTECT 8.0. Это обеспечит наличие новейшей автономной справки, соответствующей версии ESET PROTECT.

2. Загрузите комплексный установщик ESET PROTECT с веб-сайта ESET и распакуйте загруженный файл.

3. Если вы хотите установить последнюю версию Apache Tomcat, а комплексный установщик содержит более раннюю версию Apache Tomcat (этот шаг является необязательным — перейдите к шагу 4, если вам не нужна последняя версия Apache Tomcat):

a. Откройте папку x64 и перейдите в папку installers .

b. Удалите файл apache-tomcat-9.0.x-windows-x64.zip , расположенный в папке installers .

c. Загрузите 64-разрядный ZIP-пакет для Windows решения Apache Tomcat 9 .

d. Переместите загруженный ZIP-пакет в папку installers .

4. Чтобы запустить комплексный установщик, дважды щелкните файл Setup.exe , а затем щелкните Далее на экране приветствия .

5. Выберите Обновить все компоненты и нажмите кнопку Далее .

6. Приняв условия лицензионного соглашения, нажмите кнопку Далее .

7. Комплексный установщик автоматически определяет наличие обновления. При этом возле компонентов ESET PROTECT, которые можно обновить, появляются флажки. Нажмите кнопку Далее .

8. Выберите установку Java на компьютере. Убедитесь, что вы используете последнюю версию Java/OpenJDK. Для Apache Tomcat требуется 64-разрядная версия Java/OpenJDK.

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

С января 2019 года для общедоступных обновлений Oracle JAVA SE 8 нужна лицензия, если ПО используется в целях ведения бизнеса, коммерции или производства. Если вы не хотите приобретать подписку JAVA SE, можете воспользоваться этим руководством, чтобы перейти на бесплатную альтернативу и установить один из указанных поддерживаемых выпусков Java.

9. Щелкните Обновить , чтобы завершить обновление, и нажмите кнопку Готово .

10. Если веб-консоль установлена на компьютере, отличном от того, на котором установлен ESET PROTECT Server:

a) Остановите службу Apache Tomcat: Перейдите в меню Пуск > Службы , щелкните правой кнопкой мыши службу Apache Tomcat и выберите пункт Остановить .

b) Восстановите файл EraWebServerConfig.properties (с шага 1) в исходном расположении.

c) Запустите службу Apache Tomcat: Перейдите в меню Пуск > Службы , щелкните правой кнопкой мыши службу Apache Tomcat и выберите пункт Запустить .

11. Подключитесь к веб-консоли ESET PROTECT и удостоверьтесь, что программа работает правильно.

Устранение неполадок

Если вам не удалось обновить Apache Tomcat , установите предыдущую версию и примените к ней конфигурацию, указанную в описании шага 1.

Обновление компонента Apache Tomcat вручную (Windows)

Apache Tomcat — это необходимый компонент, требующийся для запуска веб-консоли ESMC.

Используйте эти инструкции для обновления Apache Tomcat вручную (если у вас нет последней версии комплексного установщика ESMC).

Действия перед обновлением

1. Убедитесь, что используется актуальная версия Java/OpenJDK.

С января 2019 года для общедоступных обновлений Oracle JAVA SE 8 нужна лицензия, если ПО используется в целях ведения бизнеса, коммерции или производства. Если вы не хотите приобретать подписку JAVA SE, можете воспользоваться этим руководством, чтобы перейти на бесплатную альтернативу и установить один из указанных поддерживаемых выпусков Java.

• Требуется 64-разрядная версия Java .

• Если в вашей системе установлено несколько версий Java, рекомендуем удалить более старые версии Java (самая старая из поддерживаемых версий — Java 8) и оставить только последнюю версию Java.

2. Проверьте, какая версия Apache Tomcat используется в настоящее время.

a. Перейдите в папку установки Apache Tomcat:
C:\Program Files\Apache Software Foundation\[ Tomcat папка ]\

b. Откройте файл RELEASE-NOTES в текстовом редакторе и проверьте номер версии (например, 7.0.90).

c. Если доступна более новая поддерживаемая версия, выполните обновление.

Обновление

1. Остановите службу Apache Tomcat: Перейдите в меню Пуск > Службы , щелкните правой кнопкой мыши службу Apache Tomcat и выберите пункт Остановить .

Закройте файл Tomcat7w.exe в области уведомлений, если он запущен.

2. Сделайте резервные копии следующих файлов:

C:\Program Files\Apache Software Foundation\[ Tomcat папка ]\ .keystore
C:\Program Files\Apache Software Foundation\[ Tomcat папка ]\ conf\server.xml
C:\Program Files\Apache Software Foundation\[ Tomcat папка ]\ webapps\era\WEB-INF\classes\sk\eset\era\g2webconsole\server\modules\config\EraWebServerConfig.properties

Если вы используете хранилище SSL-сертификатов с пользовательскими настройками в папке Tomcat , выполните также резервное копирование сертификата.

3. Удалите текущую версию Apache Tomcat.

4. Удалите следующую папку, если она все еще присутствует в вашей системе:

C:\Program Files\Apache Software Foundation\[ Tomcat папка ]\

5. Загрузите последнюю поддерживаемую версию файла установщика Apache Tomcat (32-х или 64-разрядный установщик службы Windows) apache-tomcat-[ версия ].exe с сайта https://tomcat.apache.org.

6. Установите более новую версию Apache Tomcat, которую вы загрузили:

• Если установлено больше версий Java, выберите путь к новейшей версии Java во время установки.

• По завершении установки снимите флажок Запустить Apache Tomcat .

7. Восстановите .keystore , server.xml и настраиваемые сертификаты в первоначальные расположения.

8. Убедитесь, что HTTPS-подключение для Apache Tomcat для веб-консоли ESMC установлено надлежащим образом.

10. Восстановите EraWebServerConfig.properties в исходной папке.

11. Запустите Apache Tomcat и задайте правильную виртуальную машину Java. Для этого выполните следующие действия:

a) Перейдите к папке C:\Program Files\Apache Software Foundation\[ Tomcat папка ]\ bin и запустите Tomcat9w.exe .

b) На вкладке Общие установите для параметра Тип запуска значение Автоматический и щелкните Запустить .

c) Перейдите на вкладку Java и убедитесь, что флажок Использовать умолчания не установлен, а виртуальная машина Java содержит путь к файлу jvm.dll (см. иллюстрированные указания в нашей базе знаний), а затем нажмите кнопку OK.

12. Подключитесь к веб-консоли ESMC и удостоверьтесь, что программа работает правильно.

Устранение неполадок

• Если вам не удалось установить подключение по протоколу HTTPS для Apache Tomcat, пропустите этот этап и временно используйте подключение по протоколу HTTP.

• Если вам не удалось обновить Apache Tomcat, установите первоначальную версию и примените к ней конфигурацию, указанную в описании этапа 2.

Apache Tomcat ®

Content

Before upgrading or migrating

When updating from one major Apache Tomcat version a newer one, please make sure that the JVM that is installed on your system supports at least the required Java version. While it is possible that older versions of Tomcat may not be compatible with newer JVMs, all the currently supported Apache Tomcat versions (7.0.x, 8.5.x, 9.0.x and 10.0.x) are known to run correctly on Java 8 JVMs.

When migrating from one major Tomcat version to another (e.g. from Tomcat 7 to Tomcat 8, or from Tomcat 8 to Tomcat 8.5), you should not copy the configuration files from the old version to the new version. The recommended approach is to start with the default configuration of the new version of Apache Tomcat and to adjust it as necessary.

When migrating from one minor release to another minor release within the same major release (e.g. from Tomcat 7.0.27 to Tomcat 7.0.28) you can retain the configuration files, but you should check to see if any defaults have changed and/or if any new elements have been added and adjust your configuration files accordingly.

Migration Guides

For upgrading between 10.0.x versions, see the upgrading section of the Tomcat 10.0.x Migration Guide.

For migration from 9.0.x to 10.0.x, see the Tomcat 10.0.x Migration Guide.

For upgrading between 9.0.x versions, see the upgrading section of the Tomcat 9.0.x Migration Guide.

For migration from 8.0.x / 8.5.x to 9.0.x, see the Tomcat 9.0.x Migration Guide.

For upgrading between 8.5.x versions, see the upgrading section of the Tomcat 8.5.x Migration Guide.

For migration from 8.0.x to 8.5.x, see the Tomcat 8.5.x Migration Guide.

For upgrading between 8.0.x versions, see the upgrading section of the Tomcat 8.0.x Migration Guide.

For migration from 7.0.x to 8.0.x, see the Tomcat 8.0.x Migration Guide.

For upgrading between 7.0.x versions, see the upgrading section of the Tomcat 7.0.x Migration Guide.

For migration from 6.0.x to 7.0.x, see the Tomcat 7.0.x Migration Guide.

For upgrading between 6.0.x versions, see the upgrading section of the Tomcat 6.0.x Migration Guide.

For migration from 5.5.x to 6.0.x, see the Tomcat 6.0.x Migration Guide.

Обновление компонента Apache Tomcat (Linux)

Apache Tomcat — это необходимый компонент, требующийся для запуска веб-консоли ESMC.

Действия, которые необходимо выполнить перед обновлением Apache Tomcat

1. Убедитесь, что Java на вашем компьютере обновляется корректно.

• Убедитесь, что пакет openjdk обновлен (см. ниже).

2. Проверьте, какая версия Apache Tomcat используется в настоящее время. Если доступна более новая версия, выполните обновление:

• Выполните следующую команду: cd /usr/share/tomcat/bin && ./version.sh (в некоторых случаях указывается имя папки tomcat7 или tomcat8 ).

3. Ознакомьтесь с нашим списком поддерживаемых версий Apache Tomcat, чтобы убедиться, что новая версия совместима с продуктами ESET.

4. Сделайте резервную копию файла конфигурации Tomcat /etc/tomcat7/server.xml .

Обновление

1. Остановите службу Apache Tomcat:

• Выполните следующую команду: service tomcat stop (в некоторых случаях указывается имя службы tomcat7 ).

2. Обновите компонент Apache Tomcat и Java. Используйте команды терминала в зависимости от дистрибутивов Linux. Примеры имен пакетов, указанные ниже, могут отличаться от пакетов, доступных в репозитории дистрибутивов Linux.

Дистрибутивы Debian и Ubuntu

sudo apt-get update
sudo apt-get install openjdk-11-jdk tomcat9

Дистрибутивы CentOS , Red Hat и Fedora

yum update
yum install java-1.8.0-openjdk tomcat

zypper refresh
zypper install java-1_8_0-openjdk tomcat

3. Замените файл /etc/tomcat9/server.xml файлом server.xml из своей резервной копии.

4. Убедитесь, что HTTPS-подключение для Apache Tomcat установлено надлежащим образом.

После обновления Apache Tomcat до более поздней основной версии (к примеру, Apache Tomcat 7.x до версии 8.x):

• Повторно разверните веб-консоль ESMC (см. раздел «Установка веб-консоли ESMC — Linux»).