[KB7088] Конфигуриране на Apache Tomcat за ESET PROTECT On-Prem Web Console с помощта на поддържан JDK (Windows)

ЗАБЕЛЕЖКА:

Тази страница е преведена от компютър. Щракнете върху Английски под Езици на тази страница, за да се покаже оригиналният текст. Ако установите, че нещо не е ясно, моля, свържете се с местната поддръжка.

Издание

Подробности


Натиснете, за да разширите

Уеб конзолата ESET PROTECT On-Prem работи с Apache Tomcat, уеб сървър и контейнер за сървлети за Java приложения. Apache Tomcat не включва Java runtime; той разчита на Java runtime, осигурен от Java Development Kit (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 Web Console, се нуждаете от Java runtime, осигурен от Java Development Kit (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

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

  • Amazon Corretto 17 или 21 (LTS)

    За инструкции за инсталиране вижте раздел Install the Amazon Corretto JDK (Инсталиране на Amazon Corretto JDK ).

  • Дистрибуции, базирани на OpenJDK - например Eclipse Temurin 17 или 21 (LTS)

    Когато инсталирате дистрибуция с OpenJDK в Windows с помощта на инсталационен файл .msi, изберете опцията за задаване или отменяне на променливата на средата JAVA_HOME в съветника за инсталиране (обикновено в раздел Custom setup). Това гарантира, че пътят за инсталиране на Java е регистриран в Windows, което позволява на Apache Tomcat да открие JDK.

Отстраняване на грешката "Failed to load data" (Неуспешно зареждане на данни)

Ако се сблъскате с грешката "Failed to load data" (Неуспешно зареждане на данни), когато използвате JDK 17 или по-нова версия, вижте раздела Fix the "Failed to load data" error with JDK 17 or later (Отстраняване на грешката "Неуспешно зареждане на данни" с 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. Щракнете върху раздела General (Общи) и щракнете върху Stop (Спиране), за да спрете услугата Apache Tomcat.

  3. Деинсталирайте текущия JDK.

  4. Инсталирайте нов JDK.

  5. Върнете се в Apache Tomcat Properties и щракнете върху раздела Java.

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

  7. Щракнете върху раздела General (Общи) и щракнете върху Start (Старт), за да стартирате услугата Apache Tomcat.

  8. Уверете се, че можете да влезете в своята уеб конзола ESET PROTECT On-Prem.


Инсталиране на Amazon Corretto JDK

  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 версия "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 (build 17.0.17+10-LTS, mixed mode, sharing)
    • Amazon Corretto 21:

      openjdk версия "21.0.9" 2025-10-21 LTS OpenJDK Runtime Environment Corretto-21.0.9.11.1 (build 21.0.9+11-LTS) OpenJDK 64-Bit Server VM Corretto-21.0.9.11.1 (build 21.0.9+11-LTS, mixed mode, sharing)

Отстраняване на грешката "Failed to load data" (Неуспешно зареждане на данни) с JDK 17 или по-нова версия

Този проблем възниква, когато уеб конзолата ESET PROTECT On-Prem работи на Apache Tomcat с по-нови версии на JDK (JDK 17 или по-нова). Започвайки от Java 9, системата Java Platform Module System ограничава отразяването на достъпа до определени вътрешни API, от които се нуждаят някои библиотеки, използвани от Web Console.

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

Рестартирайте услугата Apache Tomcat след всяка промяна

Трябва да рестартирате услугата Apache след всяка промяна в .exe или .bat файловете. За да рестартирате услугата, следвайте следните стъпки:

  1. Натиснете клавиша Windows, напишете Service и отворете приложението Services.

  2. Щракнете с десния бутон на мишката върху Apache Tomcat в списъка вдясно.

  3. Щракнете върху Restart.

Добавяне на опции --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 Options:

    --add-opens=java.base/java.util=ALL-UNNAMED --add-opens=java.base/java.util.concurrent=ALL-UNNAMED
    Фигура 1-1

    Полето Java 9 Options вече съдържа следните стойности:

    ---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. Щракнете върху OK.
Добавяне на опции --add-opens в catalina.bat
  1. Навигирайте до папката Apache Tomcat (например C:\Program Files\Apache Software Foundation\Tomcat 9.0). Отворете папката bin и намерете файла catalina.bat. Отворете файла в текстов редактор.

  2. Намерете раздела rem Configure JAVA 9 specific start-up parameters (Конфигуриране на специфични параметри за стартиране на 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"

    Разделът rem Configure JAVA 9 specific start-up parameters (Конфигуриране на специфични параметри за стартиране на 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. Запазете промените.