[KB7088] Apache Tomcat für die ESET PROTECT On-Prem-Webkonsole mit einem unterstützten JDK konfigurieren (Windows)

Problem

• Unterstützte JDK- und Apache Tomcat-Versionen für die ESET PROTECT On-Prem-Webkonsole
• Wechseln der von Apache Tomcat für die ESET PROTECT On-Prem-Webkonsole verwendeten JDK-Distribution
• Installieren Sie das Amazon Corretto JDK
• Behebung des Fehlers „Daten konnten nicht geladen werden“ mit JDK 17 oder höher

Details

Lösung

Unterstützte JDK- und Apache-Tomcat-Versionen für die ESET PROTECT On-Prem-Webkonsole

Um die ESET PROTECT On-Prem-Webkonsole auszuführen, benötigen Sie eine Java-Laufzeitumgebung, die von einem Java Development Kit (JDK) bereitgestellt wird, sowie eine kompatible Apache-Tomcat-Version.

Wir empfehlen die Installation von:

• Apache Tomcat 9.x. (neueste stabile Version)
• JDK 17 oder 21 (LTS)
  Weitere Informationen zu den JDK-Versionen finden Sie im Abschnitt „Unterstützte JDK-Versionen “ weiter unten.

Unterstützte JDK-Versionen

Alternativen zu Oracle JDK (kostenlose Distributionen):

• Amazon Corretto 17 oder 21 (LTS)

  Anweisungen zur Installation finden Sie im Abschnitt „Installieren des Amazon Corretto JDK “.

• OpenJDK-basierte Distributionen – zum Beispiel Eclipse Temurin 17 oder 21 (LTS)

  Wenn Sie eine OpenJDK-Distribution unter Windows mithilfe eines .msi-Installationsprogramms installieren, wählen Sie im Setup-Assistenten (in der Regel unter „Benutzerdefinierte Installation“) die Option zum Festlegen oder Überschreiben der Umgebungsvariable JAVA_HOME aus. Dadurch wird sichergestellt, dass der Java-Installationspfad in Windows registriert wird, sodass Apache Tomcat das JDK finden kann.

Wechseln der von Apache Tomcat für die ESET PROTECT On-Prem Web-Konsole verwendeten JDK-Distribution

1. Navigieren Sie zum Apache-Tomcat-Ordner (z. B. C:\Program Files\Apache Software Foundation\Tomcat 9.0). Öffnen Sie den Ordner „bin“ und suchen Sie die Datei „tomcat9w.exe“. Doppelklicken Sie auf die Datei, um sie auszuführen. Das Fenster „Apache Tomcat-Eigenschaften“ wird geöffnet.

2. Klicken Sie auf die Registerkarte „Allgemein“ und dann auf „Beenden“, um den Apache-Tomcat-Dienst anzuhalten.

3. Deinstallieren Sie Ihr aktuelles JDK.

4. Installieren Sie ein neues JDK.

5. Kehren Sie zu den „Apache Tomcat-Eigenschaften“ zurück und klicken Sie auf die Registerkarte „Java “.

6. Passen Sie im Feld „Java Virtual Machine“ den Pfad so an, dass er auf die Datei „jvm.dll“ des neu installierten JDK verweist (z. B. bei Amazon Corretto: C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Klicken Sie auf die Registerkarte „Allgemein“ und dann auf „Starten“, um den Apache-Tomcat-Dienst zu starten.

8. Stellen Sie sicher, dass Sie sich bei Ihrer ESET PROTECT On-Prem-Webkonsole anmelden können.

Installieren Sie das Amazon Corretto JDK

1. Laden Sie die Windows -.msi -Installationsdatei für Amazon Corretto 17 oder Amazon Corretto 21 herunter.

2. Doppelklicken Sie auf die Installationsdatei, um die Installation zu starten.

3. Führen Sie die Installationsschritte durch.

   Sie haben die Möglichkeit, einen benutzerdefinierten Installationspfad festzulegen. Standardmäßig wird Amazon Corretto 17 unter C:\Program Files\Amazon Corretto\ installiert. Wenn Sie einen benutzerdefinierten Pfad festlegen, notieren Sie sich diesen für den nächsten Schritt.

4. Wenn die Installation abgeschlossen ist, legen Sie die Umgebungsvariablen JAVA_HOME und PATH fest.

   • Setzen Sie JAVA_HOME auf das Amazon Corretto-Installationsverzeichnis.

     Beispielpfade:

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

     Die Build-Nummern können variieren

     Jeder Ordner einer Amazon Corretto-Version (z. B. jdk17.0.17_10) enthält eine Build-Nummer, die sich mit neuen Releases ändert. Überprüfen Sie nach der Installation immer den tatsächlichen Ordnernamen unter C:\Program Files\Amazon Corretto.

   • Fügen Sie %JAVA_HOME%\bin zum PATH hinzu.

5. Überprüfen Sie die Installation. Führen Sie in der Eingabeaufforderung folgenden Befehl aus:

   java -version

   Es sollte folgende Ausgabe angezeigt werden (Build-Nummern können variieren):

   • 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-Bit Server VM Corretto-17.0.17.10.1 (Build 17.0.17+10-LTS, gemischter Modus, gemeinsam genutzt)
     

   • Amazon Corretto 21:

     OpenJDK-Version „21.0.9“ 21.10.2025 LTS
     OpenJDK-Laufzeitumgebung 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, gemischter Modus, gemeinsam genutzt)

Behebung des Fehlers „Failed to load data“ bei JDK 17 oder höher

Dieses Problem tritt auf, wenn die ESET PROTECT On-Prem Webkonsole auf Apache Tomcat mit neueren JDK-Versionen (JDK 17 oder höher) ausgeführt wird. Ab Java 9 schränkt das Java Platform Module System den reflektiven Zugriff auf bestimmte interne APIs ein, die von einigen von der Webkonsole verwendeten Bibliotheken benötigt werden.

Um dieses Problem zu beheben, müssen Sie der Java-Konfiguration von Apache Tomcat spezielle --add-opens-Optionen hinzufügen, damit diese Module weiterhin zugänglich bleiben. Sie können die Optionen über die Apache-Tomcat-Dienstkonfiguration (tomcat9w.exe) oder die Datei „catalina.bat“ bzw. „service.bat“ hinzufügen.

Fügen Sie die Optionen „--add-opens“ über die Apache-Tomcat-Dienstkonfiguration (tomcat9w.exe) hinzu

1. Navigieren Sie zum Apache-Tomcat-Ordner (z. B. C:\Program Files\Apache Software Foundation\Tomcat 9.0). Öffnen Sie den Ordner „bin“ und suchen Sie die Datei „tomcat9w.exe“. Doppelklicken Sie auf die Datei, um sie auszuführen.

2. Klicken Sie auf die Registerkarte „Java“ und fügen Sie die folgenden Werte in das Feld „Java 9-Optionen“ ein:

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

   

   Das Feld „Java 9-Optionen “ enthält nun die folgenden Werte:

   --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. Klicken Sie auf „OK“.

Fügen Sie die Optionen „--add-opens“ in die Datei „catalina.bat“ ein

1. Navigieren Sie zum Apache-Tomcat-Ordner (z. B. C:\Program Files\Apache Software Foundation\Tomcat 9.0). Öffnen Sie den Ordner „bin“ und suchen Sie die Datei „catalina.bat “. Öffnen Sie die Datei in einem Texteditor.

2. Suchen Sie den Abschnitt „rem Configure JAVA 9 specific start-up parameters“ und fügen Sie die folgenden Werte hinzu:
   

   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"

   Der Abschnitt „JAVA 9-spezifische Startparameter konfigurieren“ enthält nun die folgenden Werte:

   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. Speichern Sie die Änderungen.

Fügen Sie die Optionen „--add-opens“ in die Datei „service.bat“ ein

1. Navigieren Sie zum Apache-Tomcat-Ordner (z. B. C:\Program Files\Apache Software Foundation\Tomcat 9.0). Öffnen Sie den Ordner „bin“ und suchen Sie die Datei „service.bat “. Öffnen Sie die Datei in einem Texteditor.

2. Suchen Sie die Zeile „--JvmOptions9“ und ändern Sie sie wie folgt:

   --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. Speichern Sie die Änderungen.