[KB7088] Apache Tomcat configureren voor ESET PROTECT On-Prem Web Console met een ondersteunde JDK (Windows)

Probleem

• Ondersteunde JDK en Apache Tomcat versies voor de ESET PROTECT On-Prem Web Console
• Wissel JDK-distributie gebruikt door Apache Tomcat voor de ESET PROTECT On-Prem Web Console
• Installeer de Amazon Corretto JDK
• De fout "Mislukt bij het laden van gegevens" oplossen met JDK 17 of hoger

Details

Oplossing

Ondersteunde JDK en Apache Tomcat versies voor de ESET PROTECT On-Prem Web Console

Om de ESET PROTECT On-Prem Web Console te draaien, heb je een Java runtime nodig die wordt geleverd door een Java Development Kit (JDK) en een compatibele Apache Tomcat versie.

Wij raden aan om te installeren:

• Apache Tomcat 9.x. (laatste stabiele release)
• JDK 17 of 21 (LTS)
  Zie de sectie Ondersteunde JDK-versies hieronder voor meer informatie over de JDK-versies.

Ondersteunde JDK versies

Alternatieven voor Oracle JDK (gratis distributies):

• Amazon Corretto 17 of 21 (LTS)

  Voor installatie-instructies, zie de sectie Amazon Corretto JDK installeren.

• OpenJDK-gebaseerde distributies-bijvoorbeeld Eclipse Temurin 17 of 21 (LTS)

  Wanneer je een OpenJDK distributie op Windows installeert met een .msi installatieprogramma, selecteer dan de optie om de JAVA_HOME omgevingsvariabele in te stellen of te overschrijven in de Setup Wizard (meestal onder Aangepaste setup). Dit zorgt ervoor dat het Java-installatiepad wordt geregistreerd in Windows, zodat Apache Tomcat de JDK kan vinden.

Veranderen van JDK-distributie gebruikt door Apache Tomcat voor de ESET PROTECT On-Prem Web Console

1. Navigeer naar de Apache Tomcat map (bijvoorbeeld C:\Program Files\Apache Software Foundation\Tomcat 9.0). Open de map bin en zoek tomcat9w.exe. Dubbelklik op het bestand om het uit te voeren. Apache Tomcat Eigenschappen wordt geopend.

2. Klik op het tabblad General en klik op Stop om de Apache Tomcat-service te stoppen.

3. Verwijder je huidige JDK.

4. Installeer een nieuwe JDK.

5. Ga terug naar Apache Tomcat Properties en klik op het tabblad Java.

6. Werk in het Java Virtual Machine veld het pad bij zodat het verwijst naar het jvm.dll bestand van de nieuw geïnstalleerde JDK (bijvoorbeeld, voor Amazon Corretto, C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Klik op het tabblad General en klik op Start om de Apache Tomcat service te starten.

8. Controleer of u kunt inloggen op uw ESET PROTECT On-Prem Web Console.

Installeer de Amazon Corretto JDK

1. Download het Windows .msi installatiebestand voor Amazon Corretto 17 of Amazon Corretto 21.

2. Dubbelklik op het installatiebestand om de installatie te starten.

3. Doorloop de installatiestappen.

   Je hebt de optie om een aangepast installatiepad in te stellen. Standaard wordt Amazon Corretto 17 geïnstalleerd in C:\Program Files\Amazon Corretto\. Als je een aangepast pad instelt, noteer het pad dan voor de volgende stap.

4. Wanneer de installatie voltooid is, stel dan de omgevingsvariabelen JAVA_HOME en PATH in.

   • Stel JAVA_HOME in op de Amazon Corretto installatiemap.

     Voorbeeld paden:

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

     Bouwnummers kunnen variëren

     Elke Amazon Corretto versie map (bijvoorbeeld jdk17.0.17_10) bevat een build nummer dat verandert bij nieuwe releases. Controleer altijd de huidige mapnaam na installatie in C:\Program Files\Amazon Corretto.

   • Voeg %JAVA_HOME%\bin toe aan het PATH.

5. Controleer de installatie. Voer in Opdrachtprompt uit:

   java -version

   Je zou de volgende uitvoer moeten zien (buildnummers kunnen variëren):

   • Amazon Corretto 17:

     openjdk versie "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 versie "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, gemengde modus, delen)

Fout "Mislukt bij het laden van gegevens" met JDK 17 of hoger oplossen

Dit probleem treedt op wanneer de ESET PROTECT On-Prem Web Console draait op Apache Tomcat met nieuwere JDK versies (JDK 17 of later). Vanaf Java 9 beperkt het Java Platform Module System de reflectieve toegang tot bepaalde interne API's, die sommige bibliotheken die worden gebruikt door de Web Console nodig hebben.

Om dit op te lossen, moet je speciale --add-opens opties toevoegen aan Apache Tomcat's Java configuratie zodat deze modules toegankelijk blijven. Je kunt de opties toevoegen via de Apache Tomcat serviceconfiguratie (tomcat9w.exe), het catalina.bat of service.bat bestand.

Opties --add-opens toevoegen via Apache Tomcat-serviceconfiguratie (tomcat9w.exe)

1. Navigeer naar de map Apache Tomcat (bijvoorbeeld C:\Program Files\Apache Software Foundation\Tomcat 9.0). Open de map bin en zoek tomcat9w.exe. Dubbelklik op het bestand om het uit te voeren.

2. Klik op het tabblad Java en voeg de volgende waarden toe aan het veld Java 9 Options:

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

   

   Het veld Java 9 Options bevat nu de volgende waarden:

   --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. Klik op OK.

Opties --add-opens toevoegen in catalina.bat

1. Navigeer naar de map Apache Tomcat (bijvoorbeeld C:\Program Files\Apache Software Foundation\Tomcat 9.0). Open de map bin en zoek het bestand catalina.bat. Open het bestand in een tekstverwerker.

2. Zoek de rem Configureer JAVA 9 specifieke opstartparameters sectie en voeg de volgende waarden toe:
   

   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"

   De rem Configureer JAVA 9 specifieke opstartparameters sectie bevat nu de volgende waarden:

   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. Sla de wijzigingen op.

Voeg --add-opens opties toe in service.bat

1. Navigeer naar de map Apache Tomcat (bijvoorbeeld C:\Program Files\Apache Software Foundation\Tomcat 9.0). Open de map bin en zoek het bestand service.bat. Open het bestand in een tekstverwerker.

2. Navigeer naar de regel --JvmOptions9 en wijzig deze in:

   --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. Sla de wijzigingen op.