[KB7088] Konfigurera Apache Tomcat för ESET PROTECT On-Prem-webbkonsolen med hjälp av ett stödt JDK (Windows)

Problem

• JDK- och Apache Tomcat-versioner som stöds av 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 ”Failed to load data” med JDK 17 eller senare

Detaljer

Lösning

Stödda JDK- och Apache Tomcat-versioner för ESET PROTECT On-Prem Web Console

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

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 Stödda JDK-versioner nedan.

Stödda JDK-versioner

Alternativ till Oracle JDK (kostnadsfria distributioner):

• Amazon Corretto 17 eller 21 (LTS)

  För installationsanvisningar, 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 ett .msi-installationsprogram ska du välja alternativet för att ställa in eller åsidosätta miljövariabeln JAVA_HOME i installationsguiden (vanligtvis under Anpassad installation). Detta säkerställer att Java-installationsvägen registreras i Windows, vilket gör att Apache Tomcat kan hitta JDK.

Byt JDK-distribution som används av Apache Tomcat för ESET PROTECT On-Prem Web Console

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

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

3. Avinstallera din nuvarande JDK.

4. Installera en ny JDK.

5. Gå tillbaka till Apache Tomcat-egenskaperna 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:t (till exempel, för Amazon Corretto, C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Klicka på fliken General och sedan på Start för att starta Apache Tomcat-tjänsten.

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

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. Följ installationsstegen.

   Du har möjlighet att ange en anpassad installationsväg. Som standard installeras Amazon Corretto 17 i C:\Program Files\Amazon Corretto\. Om du anger en anpassad väg ska du anteckna vägen inför nästa steg.

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

   • Ange 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 mapp för en Amazon Corretto-version (till exempel jdk17.0.17_10) innehåller ett build-nummer som ändras vid nya utgåvor. Kontrollera alltid det faktiska mappnamnet efter installationen i C:\Program Files\Amazon Corretto.

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

5. Kontrollera 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-bitars server-VM Corretto-21.0.9.11.1 (build 21.0.9+11-LTS, blandat läge, delning)

Åtgärda felet ”Failed to load data” med JDK 17 eller senare

Det här problemet uppstår när ESET PROTECT On-Prem Web Console 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, vilket vissa bibliotek som används av webbkonsolen kräver.

För att lösa detta måste du lägga till särskilda --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 mappen Apache Tomcat (till exempel C:\Program Files\Apache Software Foundation\Tomcat 9.0). Öppna mappen bin 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-alternativ:

   --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-alternativen i catalina.bat

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

2. Leta reda på avsnittet rem Configure JAVA 9 specific start-up parameters 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 ”Konfigurera JAVA 9-specifika startparametrar” 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-alternativen i service.bat

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

2. Gå 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.