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

Випуск

• Підтримувані версії JDK та Apache Tomcat для веб-консолі ESET PROTECT On-Prem
• Перемикання дистрибутива JDK, який використовується Apache Tomcat для веб-консолі ESET PROTECT On-Prem Web Console
• Встановіть Amazon Corretto JDK
• Виправлення помилки "Не вдалося завантажити дані" з JDK 17 або новішої версії

Деталі

Вирішення

Підтримувані версії JDK та Apache Tomcat для веб-консолі ESET PROTECT On-Prem

Для запуску веб-консолі ESET PROTECT On-Prem Web Console потрібне середовище виконання Java, що надається набором для розробки Java (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 змініть шлях, щоб він вказував на файл 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. Завантажте інсталяційний файл Windows .msi для 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 (збірка 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" 2025-10-21 LTS Середовище виконання OpenJDK Corretto-21.0.9.11.1 (збірка 21.0.9+11-LTS) OpenJDK 64-розрядної серверної ВМ 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 тепер містить такі значення:

   --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"

   Розділ rem Налаштування специфічних параметрів запуску 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. Збережіть зміни.