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

Проблем

• Поддържани версии на JDK и Apache Tomcat за уеб конзолата на ESET PROTECT On-Prem
• Смяна на дистрибуцията на JDK, използвана от Apache Tomcat за уеб конзолата на ESET PROTECT On-Prem
• Инсталиране на Amazon Corretto JDK
• Отстраняване на грешката „Не успях да заредя данните“ с JDK 17 или по-нова версия

Подробности

Решение

Поддържани версии на JDK и Apache Tomcat за уеб конзолата на ESET PROTECT On-Prem

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

Препоръчваме да инсталирате:

• Apache Tomcat 9.x. (последна стабилна версия)
• JDK 17 или 21 (LTS)
  За повече информация относно версиите на JDK вижте раздела „Поддържани версии на JDK “ по-долу.

Поддържани версии на JDK

Алтернативи на 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, използвана от 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 Virtual Machine“ актуализирайте пътя, така че да сочи към файла 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.

Инсталирайте 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 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-битова сървърна виртуална машина 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 платформата ограничава рефлексивния достъп до определени вътрешни API-та, които са необходими на някои библиотеки, използвани от уеб конзолата.

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

Добавете опциите --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

   

   Полето „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“ и добавете следните стойности:
   

   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 параметри при стартиране“ вече съдържа следните стойности:

   задайте "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"
   задайте "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util.concurrent=ALL-UNNAMED"
   задайте "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. Запазете промените.