[KB7088] Настройка Apache Tomcat для веб-консоли ESET PROTECT On-Prem с использованием поддерживаемого JDK (Windows)

примечание:

Этот документ переведен для вашего удобства с помощью машинного перевода. Пожалуйста, будьте уверены, что мы приложили все усилия, чтобы обеспечить максимально точный перевод. Однако ни один автоматизированный перевод не призван заменить переводчика-человека. Официальным текстом является английская версия, которую можно найти, нажав на English справа от этого текста (или внизу, если вы читаете с мобильного). Если у вас возникли вопросы или замечания относительно точности переведенного текста, пожалуйста, обратитесь к официальной версии на английском языке или свяжитесь с местной службой поддержки. Спасибо за ваше терпение.

Проблема

Подробности


Нажмите, чтобы развернуть

Веб-консоль ESET PROTECT On-Prem работает на Apache Tomcat — веб-сервере и контейнере сервлетов для Java-приложений. Apache Tomcat не включает среду выполнения Java; он использует среду выполнения Java, предоставляемую набором средств разработки Java (JDK). Исторически сложилось так, что Oracle JDK 8 (Java SE 8) была наиболее широко используемой версией для Apache Tomcat, поэтому многие развертывания зависели от неё.

С января 2019 года компания Oracle изменила условия лицензирования Java SE 8. Для получения публичных обновлений, предназначенных для делового, коммерческого или производственного использования, теперь требуется платная подписка.

Если вы используете Oracle JDK 8 (Java SE 8) и не имеете подписки Oracle, вы можете перейти на бесплатную альтернативу с поддержкой (например, Amazon Corretto).

В этой статье рассматривается установка в Windows. Для Linux см. соответствующие руководства по установке JDK для SUSE Linux Enterprise Server или Debian.


Решение

Поддерживаемые версии JDK и Apache Tomcat для веб-консоли ESET PROTECT On-Prem

Для работы веб-консоли ESET PROTECT On-Prem требуется среда выполнения Java, предоставляемая набором средств разработки Java (JDK), а также совместимая версия Apache Tomcat.

Мы рекомендуем установить:

  • Apache Tomcat 9.x (последняя стабильная версия)
  • JDK 17 или 21 (LTS)
    Дополнительные сведения о версиях JDK см. в разделе «Поддерживаемые версии JDK » ниже.
Рекомендации по совместимости
  • Удалите более старые версии JDK: если установлено несколько версий JDK, удалите более старые версии и оставьте только последнюю поддерживаемую версию JDK.
  • Соответствие разрядности: убедитесь, что JDK, Apache Tomcat и ESET PROTECT On-Prem используют одну и ту же архитектуру (рекомендуется 64-разрядная).
Поддерживаемые версии JDK
Поддерживаемые версии

Поддерживаются только выпуски JDK с долгосрочной поддержкой (LTS).

Поддерживаемая версия JDK Версия ESET PROTECT On-Prem
17
10.x – 13.x
21
11.x – 13.x
25
13.1 и более поздние версии

Альтернативы Oracle JDK (бесплатные дистрибутивы):

  • Amazon Corretto 17 или 21 (LTS)

    Инструкции по установке см. в разделе «Установка Amazon Corretto JDK ».

  • Дистрибутивы на основе OpenJDK — например, Eclipse Temurin 17 или 21 (LTS)

    При установке дистрибутива OpenJDK в Windows с помощью установщика .msi выберите в мастере установки (обычно в разделе «Настройка по выбору») опцию, позволяющую установить или переопределить переменную среды JAVA_HOME. Это гарантирует, что путь к установке Java будет зарегистрирован в Windows, что позволит Apache Tomcat найти JDK.

Устранение ошибки «Не удалось загрузить данные»

Если при использовании JDK 17 или более поздней версии возникает ошибка «Failed to load data», обратитесь к разделу «Устранение ошибки «Failed to load data» при использовании JDK 17 или более поздней версии » для получения инструкций.


Смена дистрибутива JDK, используемого Apache Tomcat для веб-консоли ESET PROTECT On-Prem

  1. Перейдите в папку Apache Tomcat (например, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Откройте папку bin и найдите файл tomcat9w.exe. Дважды щелкните по файлу, чтобы запустить его. Откроется окно «Свойства Apache Tomcat».

  2. Перейдите на вкладку «Общие» и нажмите «Остановить», чтобы остановить службу Apache Tomcat.

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

  4. Установите новую версию JDK.

  5. Вернитесь в окно «Свойства Apache Tomcat» и перейдите на вкладку «Java ».

  6. В поле «Виртуальная машина Java» обновите путь, указав файл jvm.dll только что установленного JDK (например, для Amazon Corretto — C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

  7. Перейдите на вкладку «Общие» и нажмите «Запустить», чтобы запустить службу Apache Tomcat.

  8. Убедитесь, что вы можете войти в веб-консоль ESET PROTECT On-Prem.


Установка JDK для Amazon Corretto

  1. Загрузите установочный файл .msi для Windows с версией Amazon Corretto 17 или Amazon Corretto 21.

  2. Дважды щелкните установочный файл, чтобы начать установку.

  3. Выполните все шаги установки.

    У вас есть возможность указать собственный путь установки. По умолчанию Amazon Corretto 17 устанавливается в папку C:\Program Files\Amazon Corretto\. Если вы указали собственный путь, запишите его для следующего шага.

  4. По завершении установки задайте переменные среды JAVA_HOME и PATH.

    • Укажите в переменной JAVA_HOME путь к каталогу установки Amazon Corretto.

      Примеры путей:

      • Amazon Corretto 17: C:\Program Files\Amazon Corretto\jdk17.0.17_10
      • Amazon Corretto 21: C:\Program Files\Amazon Corretto\jdk21.0.9_11

      Номера сборок могут отличаться

      Каждая папка версии Amazon Corretto (например, jdk17.0.17_10) содержит номер сборки, который меняется с выходом новых версий. Всегда проверяйте фактическое имя папки после установки в папке C:\Program Files\Amazon Corretto.

    • Добавьте %JAVA_HOME%\bin в переменную PATH.

  5. Проверьте установку. В командной строке выполните:

    java -version

    Вы должны увидеть следующий вывод (номера сборок могут отличаться):

    • Amazon Corretto 17:

      openjdk version "17.0.17" 2025-10-21 LTS
      OpenJDK Runtime Environment Corretto-17.0.17.10.1 (build 17.0.17+10-LTS)
      OpenJDK 64-Bit Server VM Corretto-17.0.17.10.1 (сборка 17.0.17+10-LTS, смешанный режим, совместное использование)
      
    • Amazon Corretto 21:

      версия OpenJDK «21.0.9» 21.10.2025 LTS
      Среда выполнения OpenJDK Corretto-21.0.9.11.1 (сборка 21.0.9+11-LTS)
      64-разрядная серверная виртуальная машина OpenJDK Corretto-21.0.9.11.1 (сборка 21.0.9+11-LTS, смешанный режим, совместное использование)

Исправление ошибки «Не удалось загрузить данные» при использовании JDK 17 или более поздних версий

Эта проблема возникает, когда веб-консоль ESET PROTECT On-Prem работает на Apache Tomcat с более новыми версиями JDK (JDK 17 или более поздними). Начиная с Java 9, система модулей Java Platform Module System ограничивает рефлексивный доступ к определенным внутренним API, которые требуются некоторым библиотекам, используемым веб-консолью.

Чтобы решить эту проблему, необходимо добавить специальные параметры --add-opens в конфигурацию Java для Apache Tomcat, чтобы обеспечить доступ к этим модулям. Эти параметры можно добавить через конфигурацию службы Apache Tomcat (tomcat9w.exe), файл catalina.bat или service.bat.

Перезапускайте службу Apache Tomcat после каждого изменения

После каждого изменения в файлах .exe или .bat необходимо перезапустить службу Apache. Чтобы перезапустить службу, выполните следующие действия:

  1. Нажмите клавишу Windows, введите «Службы » и откройте приложение «Службы ».

  2. Щелкните правой кнопкой мыши «Apache Tomcat» в списке справа.

  3. Нажмите «Перезапустить».

Добавьте параметры --add-opens через конфигурацию службы Apache Tomcat (tomcat9w.exe)
  1. Перейдите в папку Apache Tomcat (например, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Откройте папку «bin» и найдите файл tomcat9w.exe. Дважды щелкните по файлу, чтобы запустить его.

  2. Перейдите на вкладку «Java » и добавьте следующие значения в поле «Параметры Java 9 »:

    --add-opens=java.base/java.util=ALL-UNNAMED
    --add-opens=java.base/java.util.concurrent=ALL-UNNAMED
    Рисунок 1-1

    Теперь поле «Параметры Java 9 » содержит следующие значения:

    --add-opens=java.base/java.lang=ALL-UNNAMED
    --add-opens=java.base/java.io=ALL-UNNAMED
    --add-opens=java.base/java.util=ALL-UNNAMED
    --add-opens=java.base/java.util.concurrent=ALL-UNNAMED
    --add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED
  3. Нажмите «ОК».
Добавьте параметры --add-opens в файл catalina.bat
  1. Перейдите в папку Apache Tomcat (например, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Откройте папку bin и найдите файл catalina.bat. Откройте файл в текстовом редакторе.

  2. Найдите раздел «rem Настройка параметров запуска для JAVA 9 » и добавьте следующие значения:

    set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util=ALL-UNNAMED"
    set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util.concurrent=ALL-UNNAMED"

    Раздел «Настройка параметров запуска для JAVA 9» теперь содержит следующие значения:

    set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.lang=ALL-UNNAMED"
    set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.io=ALL-UNNAMED"
    set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util=ALL-UNNAMED"
    set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util.concurrent=ALL-UNNAMED"
    set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED"
  3. Сохраните изменения.

Добавьте параметры --add-opens в файл service.bat
  1. Перейдите в папку Apache Tomcat (например, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Откройте папку bin и найдите файл service.bat. Откройте файл в текстовом редакторе.

  2. Найдите строку --JvmOptions9 и измените её на:

    --JvmOptions9 "--add-opens=java.base/java.lang=ALL-UNNAMED#--add-opens=java.base/java.io=ALL-UNNAMED#--add-opens=java.base/java.util=ALL-UNNAMED#--add-opens=java.base/java.util.concurrent=ALL-UNNAMED#--add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED" ^
  3. Сохраните изменения.