[KB7088] Az Apache Tomcat beállítása az ESET PROTECT On-Prem webkonzolhoz egy támogatott JDK használatával (Windows)

Probléma

• Az ESET PROTECT On-Prem webkonzol által támogatott JDK- és Apache Tomcat-verziók
• Az Apache Tomcat által az ESET PROTECT On-Prem webkonzolhoz használt JDK-disztribúció váltása
• Az Amazon Corretto JDK telepítése
• A „Failed to load data” hiba kijavítása JDK 17 vagy újabb verziók esetén

Részletek

Megoldás

Az ESET PROTECT On-Prem webkonzol által támogatott JDK- és Apache Tomcat-verziók

Az ESET PROTECT On-Prem webkonzol futtatásához szüksége van egy Java Development Kit (JDK) által biztosított Java futtatókörnyezetre és egy kompatibilis Apache Tomcat verzióra.

A következő telepítését javasoljuk:

• Apache Tomcat 9.x. (legújabb stabil kiadás)
• JDK 17 vagy 21 (LTS)
  A JDK-verziókkal kapcsolatos további információkért lásd az alábbi „Támogatott JDK-verziók ” című részt.

Támogatott JDK-verziók

Az Oracle JDK alternatívái (ingyenes disztribúciók):

• Amazon Corretto 17 vagy 21 (LTS)

  A telepítési utasításokat az Amazon Corretto JDK telepítése című szakaszban találja.

• OpenJDK-alapú disztribúciók – például Eclipse Temurin 17 vagy 21 (LTS)

  Ha .msi telepítőprogrammal OpenJDK-disztribúciót telepít Windows rendszerre, válassza ki a telepítővarázslóban (általában az Egyéni beállítások alatt) azt az opciót, amely a JAVA_HOME környezeti változó beállítását vagy felülírását teszi lehetővé. Ez biztosítja, hogy a Java telepítési útvonala regisztrálásra kerüljön a Windows rendszerben, így az Apache Tomcat megtalálja a JDK-t.

Az Apache Tomcat által az ESET PROTECT On-Prem webkonzolhoz használt JDK-disztribúció váltása

1. Keresse meg az Apache Tomcat mappát (például: C:\Program Files\Apache Software Foundation\Tomcat 9.0). Nyissa meg a bin mappát, és keresse meg a tomcat9w.exe fájlt. Kattintson duplán a fájlra a futtatásához. Megnyílik az Apache Tomcat tulajdonságai ablak.

2. Kattintson az Általános fülre, majd a Leállítás gombra az Apache Tomcat szolgáltatás leállításához.

3. Távolítsa el a jelenlegi JDK-t.

4. Telepítsen egy új JDK-t.

5. Térjen vissza az Apache Tomcat tulajdonságai ablakba, és kattintson a Java fülre.

6. A Java virtuális gép mezőben frissítse az elérési utat úgy, hogy az az újonnan telepített JDK jvm.dll fájljára mutasson (például az Amazon Corretto esetében: C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Kattintson az Általános fülre, majd a Start gombra az Apache Tomcat szolgáltatás elindításához.

8. Ellenőrizze, hogy be tud-e jelentkezni az ESET PROTECT On-Prem webkonzoljába.

Telepítse az Amazon Corretto JDK-t

1. Töltse le az Amazon Corretto 17 vagy az Amazon Corretto 21 Windows .msi telepítőfájlját.

2. Kattintson duplán a telepítőfájlra a telepítés elindításához.

3. Kövesse a telepítési lépéseket.

   Lehetősége van egyéni telepítési útvonalat beállítani. Alapértelmezés szerint az Amazon Corretto 17 a C:\Program Files\Amazon Corretto\ mappába kerül telepítésre. Ha egyéni útvonalat állít be, jegyezze fel az útvonalat a következő lépéshez.

4. A telepítés befejezése után állítsa be a JAVA_HOME és a PATH környezeti változókat.

   • Állítsa be a JAVA_HOME értéket az Amazon Corretto telepítési könyvtárára.

     Példa útvonalakra:

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

     A build-számok eltérhetnek

     Minden Amazon Corretto verziómappa (például jdk17.0.17_10) tartalmaz egy build-számot, amely az új kiadásokkal változik. A telepítés után mindig ellenőrizze a tényleges mappanevet a C:\Program Files\Amazon Corretto könyvtárban.

   • Adja hozzá a %JAVA_HOME%\bin elemet a PATH változóhoz.

5. Ellenőrizze a telepítést. A Parancssorban futtassa a következő parancsot:

   java -version

   A következő kimenetnek kell megjelenni (a build számok eltérhetnek):

   • 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-bites szerver VM Corretto-17.0.17.10.1 (build 17.0.17+10-LTS, vegyes mód, megosztás)
     

   • Amazon Corretto 21:

     openjdk verzió „21.0.9” 2025-10-21 LTS
     OpenJDK futási környezet Corretto-21.0.9.11.1 (build 21.0.9+11-LTS)
     OpenJDK 64 bites szerver VM Corretto-21.0.9.11.1 (build 21.0.9+11-LTS, vegyes mód, megosztás)

A „Failed to load data” hiba kijavítása JDK 17 vagy újabb verziók esetén

Ez a probléma akkor jelentkezik, amikor az ESET PROTECT On-Prem webkonzol az Apache Tomcaton újabb JDK-verziókkal (JDK 17 vagy újabb) fut. A Java 9-től kezdve a Java Platform Module System korlátozza a bizonyos belső API-khoz való reflexív hozzáférést, amelyekre a webkonzol által használt egyes könyvtáraknak szükségük van.

A probléma megoldásához speciális --add-opens opciókat kell hozzáadnia az Apache Tomcat Java-konfigurációjához, hogy ezek a modulok továbbra is elérhetők legyenek. Az opciókat az Apache Tomcat szolgáltatáskonfigurációján (tomcat9w.exe), a catalina.bat vagy a service.bat fájlon keresztül adhatja hozzá.

Adja hozzá az --add-opens opciókat az Apache Tomcat szolgáltatás konfigurációján keresztül (tomcat9w.exe)

1. Keresse meg az Apache Tomcat mappát (például: C:\Program Files\Apache Software Foundation\Tomcat 9.0). Nyissa meg a bin mappát, és keresse meg a tomcat9w.exe fájlt. Kattintson duplán a fájlra a futtatásához.

2. Kattintson a „Java” fülre, és adja hozzá a következő értékeket a „Java 9 Options” mezőbe:

   --add-opens=java.base/java.util=ALL-UNNAMED
   --add-opens=java.base/java.util.concurrent=ALL-UNNAMED

   

   A Java 9 Options mező most a következő értékeket tartalmazza:

   --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. Kattintson az OK gombra.

Adja hozzá az --add-opens opciókat a catalina.bat fájlba

1. Keresse meg az Apache Tomcat mappát (például: C:\Program Files\Apache Software Foundation\Tomcat 9.0). Nyissa meg a bin mappát, és keresse meg a catalina.bat fájlt. Nyissa meg a fájlt egy szövegszerkesztőben.

2. Keresse meg a „rem Configure JAVA 9 specific start-up parameters ” szakaszt, és adja hozzá a következő értékeket:
   

   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"

   A „JAVA 9-specifikus indítási paraméterek beállítása” szakasz most a következő értékeket tartalmazza:

   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"
   állítsd be: "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util.concurrent=ALL-UNNAMED"
   állítsa be: "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED"

3. Mentse el a módosításokat.

Adja hozzá az --add-opens opciókat a service.bat fájlba

1. Keresse meg az Apache Tomcat mappát (például: C:\Program Files\Apache Software Foundation\Tomcat 9.0). Nyissa meg a bin mappát, és keresse meg a service.bat fájlt. Nyissa meg a fájlt egy szövegszerkesztőben.

2. Keresse meg a --JvmOptions9 sort, és módosítsa a következőre:

   --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. Mentse el a módosításokat.