[KB7088] Konfigurera Apache Tomcat för ESET PROTECT On-Prem Web Console med hjälp av en JDK som stöds (Windows)

Problem

• JDK- och Apache Tomcat-versioner som stöds för ESET PROTECT On-Prem Web Console
• Byt JDK-distribution som används av Apache Tomcat för ESET PROTECT On-Prem Web Console
• Installera Amazon Corretto JDK
• Åtgärda felet "Misslyckades med att ladda data" med JDK 17 eller senare

Mer information

Lösning

Versioner av JDK och Apache Tomcat som stöds för ESET PROTECT On-Prem Web Console

För att köra ESET PROTECT On-Prem Web Console behöver du en Java-körtid som tillhandahålls av ett Java Development Kit (JDK) och en kompatibel Apache Tomcat-version.

Vi rekommenderar att du installerar:

• Apache Tomcat 9.x. (senaste stabila versionen)
• JDK 17 eller 21 (LTS)
  Mer information om JDK-versionerna finns i avsnittet JDK-versioner som stöds nedan.

JDK-versioner som stöds

Alternativ till Oracle JDK (kostnadsfria distributioner):

• Amazon Corretto 17 eller 21 (LTS)

  För installationsinstruktioner, se avsnittet Installera Amazon Corretto JDK.

• OpenJDK-baserade distributioner - till exempel Eclipse Temurin 17 eller 21 (LTS)

  När du installerar en OpenJDK-distribution på Windows med hjälp av ett .msi-installationsprogram ska du välja alternativet att ange eller åsidosätta miljövariabeln JAVA_HOME i installationsguiden (vanligtvis under Anpassad installation). Detta säkerställer att installationssökvägen för Java registreras i Windows, så att Apache Tomcat kan hitta JDK.

Byta JDK-distribution som används av Apache Tomcat för webbkonsolen ESET PROTECT On-Prem

1. Navigera till Apache Tomcat-mappen (till exempel C:\Program Files\Apache Software Foundation\Tomcat 9.0). Öppna bin-mappen och leta reda på tomcat9w.exe. Dubbelklicka på filen för att köra den. Apache Tomcat Properties kommer att öppnas.

2. Klicka på fliken Allmänt och klicka på Stopp för att stoppa Apache Tomcat-tjänsten.

3. Avinstallera din nuvarande JDK.

4. Installera en ny JDK.

5. Gå tillbaka till Apache Tomcat Properties och klicka på fliken Java.

6. I fältet Java Virtual Machine uppdaterar du sökvägen så att den pekar på filen jvm.dll i det nyinstallerade JDK (till exempel för Amazon Corretto , C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Klicka på fliken Allmänt och klicka på Start för att starta tjänsten Apache Tomcat.

8. Kontrollera att du kan logga in på din ESET PROTECT On-Prem Web Console.

Installera Amazon Corretto JDK

1. Ladda ner Windows .msi-installationsfilen för Amazon Corretto 17 eller Amazon Corretto 21.

2. Dubbelklicka på installationsfilen för att starta installationen.

3. Fortsätt genom installationsstegen.

   Du har möjlighet att ange en anpassad installationssökväg. Som standard installeras Amazon Corretto 17 på C:\Program Files\Amazon Corretto\. Om du anger en anpassad sökväg ska du notera sökvägen för nästa steg.

4. När installationen är klar ställer du in miljövariablerna JAVA_HOME och PATH.

   • Ställ in JAVA_HOME till installationskatalogen för Amazon Corretto.

     Exempel på sökvägar:

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

     Byggnummer kan variera

     Varje Amazon Corretto-versionsmapp (till exempel jdk17.0.17_10) innehåller ett byggnummer som ändras med nya utgåvor. Verifiera alltid det faktiska mappnamnet efter installationen i C:\Program Files\Amazon Corretto.

   • Lägg till %JAVA_HOME%\bin i PATH.

5. Verifiera installationen. I kommandotolken kör du:

   java -version

   Du bör se följande utdata (byggnummer kan variera):

   • 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, mixed mode, sharing)

   • Amazon Corretto 21:

     openjdk version "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, mixed mode, sharing)

Åtgärda felet "Misslyckades med att ladda data" med JDK 17 eller senare

Det här problemet uppstår när webbkonsolen ESET PROTECT On-Prem körs på Apache Tomcat med nyare JDK-versioner (JDK 17 eller senare). Från och med Java 9 begränsar Java Platform Module System reflekterande åtkomst till vissa interna API:er, som vissa bibliotek som används av webbkonsolen kräver.

För att lösa detta måste du lägga till speciella --add-opens-alternativ i Apache Tomcats Java-konfiguration så att dessa moduler förblir tillgängliga. Du kan lägga till alternativen via Apache Tomcat-tjänstens konfiguration (tomcat9w.exe), filen catalina. bat eller service.bat.

Lägg till --add-opens-alternativ via Apache Tomcat-tjänstens konfiguration (tomcat9w.exe)

1. Navigera till Apache Tomcat-mappen (till exempel C:\Program Files\Apache Software Foundation\Tomcat 9.0). Öppna bin-mappen och leta reda på tomcat9w.exe. Dubbelklicka på filen för att köra den.

2. Klicka på fliken Java och lägg till följande värden i fältet Java 9 Options:

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

   

   Fältet Java 9 Options innehåller nu följande värden:

   --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. Klicka på OK.

Lägg till --add-opens-alternativ i catalina.bat

1. Navigera till Apache Tomcat-mappen (till exempel C:\Program Files\Apache Software Foundation\Tomcat 9.0). Öppna bin-mappen och leta reda på filen catalina.bat. Öppna filen i en textredigerare.

2. Leta reda på avsnittet rem Konfigurera JAVA 9-specifika startparametrar och lägg till följande värden:
   

   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"

   Avsnittet rem Configure JAVA 9 specific startup parameters innehåller nu följande värden:

   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. Spara ändringarna.

Lägg till --add-opens-alternativ i service.bat

1. Navigera till Apache Tomcat-mappen (till exempel C:\Program Files\Apache Software Foundation\Tomcat 9.0). Öppna bin-mappen och leta reda på filen service.bat. Öppna filen i en textredigerare.

2. Navigera till raden --JvmOptions9 och ändra den till:

   --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. Spara ändringarna.