[KB7088] Konfigurieren Sie Apache Tomcat für die ESET PROTECT On-Prem Web Console mit einem unterstützten JDK (Windows)

Ausgabe

• Unterstützte JDK- und Apache Tomcat-Versionen für die ESET PROTECT On-Prem Web Console
• Wechseln Sie die von Apache Tomcat verwendete JDK-Distribution für die ESET PROTECT On-Prem Web Console
• Installieren Sie das Amazon Corretto JDK
• Behebung des Fehlers "Failed to load data" mit JDK 17 oder höher

Einzelheiten

Lösung

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

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

Wir empfehlen die Installation von:

• Apache Tomcat 9.x. (letzte 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 (kostenfreie Distributionen):

• Amazon Corretto 17 oder 21 (LTS)

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

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

  Wenn Sie eine OpenJDK-Distribution unter Windows mit einem .msi-Installationsprogramm installieren, wählen Sie die Option, die Umgebungsvariable JAVA_HOME im Setup-Assistenten zu setzen oder zu überschreiben (normalerweise unter Benutzerdefiniertes Setup). Dadurch wird sichergestellt, dass der Java-Installationspfad in Windows registriert wird, so dass Apache Tomcat das JDK finden kann.

Wechseln der JDK-Distribution, die von Apache Tomcat für die ESET PROTECT On-Prem Web Console verwendet wird

1. Navigieren Sie zum Apache Tomcat-Ordner (z. B. C:\Programmdateien\Apache Software Foundation\Tomcat 9.0). Öffnen Sie den Ordner bin und suchen Sie tomcat9w.exe. Doppelklicken Sie auf die Datei, um sie auszuführen. Die Eigenschaften von Apache Tomcat werden geöffnet.

2. Klicken Sie auf die Registerkarte Allgemein und dann auf Anhalten, um den Apache Tomcat-Dienst zu beenden.

3. Deinstallieren Sie Ihr aktuelles JDK.

4. Installieren Sie ein neues JDK.

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

6. Aktualisieren Sie im Feld Java Virtual Machine den Pfad, so dass er auf die Datei jvm.dll des neu installierten JDK verweist (zum Beispiel für Amazon Corretto: C:\Programme\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 Web Console 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. Fahren Sie mit den Installationsschritten fort.

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

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

   • Setzen Sie JAVA_HOME auf das Installationsverzeichnis von Amazon Corretto.

     Beispielpfade:

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

     Build-Nummern können variieren

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

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

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

   java -version

   Sie sollten die folgende Ausgabe sehen (Build-Nummern können variieren):

   • Amazon Corretto 17:

     openjdk Version "17.0.17" 2025-10-21 LTS OpenJDK Laufzeitumgebung 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 Version "21.0.9" 2025-10-21 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, mixed mode, sharing)

Behebung des Fehlers "Failed to load data" mit JDK 17 oder höher

Dieses Problem tritt auf, wenn die ESET PROTECT On-Prem Web Console 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 einige von der Web Console verwendete Bibliotheken benötigen.

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

Hinzufügen der Optionen --add-opens über die Konfiguration des Apache Tomcat-Dienstes (tomcat9w.exe)

1. Navigieren Sie zum Apache Tomcat-Ordner (z. B. C:\Programme\Apache Software Foundation\Tomcat 9.0). Öffnen Sie den Ordner bin und suchen Sie nach 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 Options 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.

Hinzufügen der Optionen --add-opens in catalina.bat

1. Navigieren Sie zum Apache Tomcat-Ordner (z. B. C:\Programmdateien\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 rem Configure JAVA 9 specific start-up parameters 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" setze "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util=ALL-UNNAMED" setzen "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util.concurrent=ALL-UNNAMED" setzen "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED"

3. Speichern Sie die Änderungen.

Hinzufügen der Optionen --add-opens in service.bat

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. Navigieren Sie zur Zeile --JvmOptions9 und ändern Sie sie 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. Speichern Sie die Änderungen.