[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 виберіть у майстрі налаштування (зазвичай у розділі «Custom setup») опцію для встановлення або заміни змінної середовища 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» вкажіть шлях до файлу 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)
     64-бітна серверна віртуальна машина OpenJDK 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.

Додайте параметри --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

   

   Тепер поле «Параметри 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. Натисніть «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 » тепер містить такі значення:

   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"
   встановити "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. Збережіть зміни.