[KB7088] Konfigurer Apache Tomcat til ESET PROTECT On-Prem-webkonsollen ved hjælp af en understøttet JDK (Windows)

Problem

• Understøttede JDK- og Apache Tomcat-versioner til ESET PROTECT On-Prem Web Console
• Skift den JDK-distribution, der bruges af Apache Tomcat til ESET PROTECT On-Prem Web Console
• Installer Amazon Corretto JDK
• Løs fejlen "Failed to load data" med JDK 17 eller nyere

Detaljer

Løsning

Understøttede JDK- og Apache Tomcat-versioner til ESET PROTECT On-Prem Web Console

For at køre ESET PROTECT On-Prem Web Console skal du have et Java-runtime fra et Java Development Kit (JDK) og en kompatibel version af Apache Tomcat.

Vi anbefaler at installere:

• Apache Tomcat 9.x. (seneste stabile udgave)
• JDK 17 eller 21 (LTS)
  For yderligere oplysninger om JDK-versionerne henvises til afsnittet Understøttede JDK-versioner nedenfor.

Understøttede JDK-versioner

Alternativer til Oracle JDK (gratis distributioner):

• Amazon Corretto 17 eller 21 (LTS)

  Se afsnittet Installer Amazon Corretto JDK for installationsvejledning.

• OpenJDK-baserede distributioner – for eksempel Eclipse Temurin 17 eller 21 (LTS)

  Når du installerer en OpenJDK-distribution på Windows ved hjælp af et .msi-installationsprogram, skal du vælge indstillingen til at indstille eller overskrive miljøvariablen JAVA_HOME i installationsguiden (normalt under Brugerdefineret installation). Dette sikrer, at Java-installationsstien registreres i Windows, så Apache Tomcat kan finde JDK'en.

Skift den JDK-distribution, der bruges af Apache Tomcat til ESET PROTECT On-Prem Web Console

1. Naviger til Apache Tomcat-mappen (f.eks. C:\Program Files\Apache Software Foundation\Tomcat 9.0). Åbn mappen bin, og find filen tomcat9w.exe. Dobbeltklik på filen for at køre den. Vinduet Apache Tomcat Properties åbnes.

2. Klik på fanen General, og klik på Stop for at stoppe Apache Tomcat-tjenesten.

3. Afinstaller din nuværende JDK.

4. Installer en ny JDK.

5. Gå tilbage til Apache Tomcat-egenskaber, og klik på fanen Java.

6. I feltet Java Virtual Machine skal du opdatere stien, så den peger på jvm.dll-filen i den nyinstallerede JDK (f.eks. for Amazon Corretto: C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Klik på fanen General, og klik på Start for at starte Apache Tomcat-tjenesten.

8. Kontroller, at du kan logge ind på din ESET PROTECT On-Prem-webkonsol.

Installer Amazon Corretto JDK

1. Download Windows .msi -installationsfilen til Amazon Corretto 17 eller Amazon Corretto 21.

2. Dobbeltklik på installationsfilen for at starte installationen.

3. Følg installationsvejledningen.

   Du har mulighed for at angive en brugerdefineret installationssti. Som standard installeres Amazon Corretto 17 i mappen C:\Program Files\Amazon Corretto\. Hvis du angiver en brugerdefineret sti, skal du notere stien til det næste trin.

4. Når installationen er afsluttet, skal du indstille miljøvariablerne JAVA_HOME og PATH.

   • Indstil JAVA_HOME til Amazon Corretto-installationsmappen.

     Eksempler på stier:

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

     Build-numre kan variere

     Hver Amazon Corretto-versionsmappe (f.eks. jdk17.0.17_10) indeholder et build-nummer, der ændres ved nye udgivelser. Kontroller altid det faktiske mappenavn efter installationen i C:\Program Files\Amazon Corretto.

   • Føj %JAVA_HOME%\bin til PATH.

5. Kontroller installationen. Kør følgende i Kommandoprompten:

   java -version

   Du bør se følgende output (build-numre kan variere):

   • 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, blandet tilstand, deling)
     

   • Amazon Corretto 21:

     openjdk version "21.0.9" 21.10.2025 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, blandet tilstand, deling)

Løs fejlen "Failed to load data" med JDK 17 eller nyere

Dette problem opstår, når ESET PROTECT On-Prem Web Console kører på Apache Tomcat med nyere JDK-versioner (JDK 17 eller nyere). Fra og med Java 9 begrænser Java Platform Module System refleksiv adgang til visse interne API'er, som nogle biblioteker, der bruges af Web Console, kræver.

For at løse dette skal du tilføje specielle --add-opens-indstillinger til Apache Tomcats Java-konfiguration, så disse moduler forbliver tilgængelige. Du kan tilføje indstillingerne via Apache Tomcat-tjenestekonfigurationen (tomcat9w.exe), filen catalina.bat eller service.bat.

Tilføj --add-opens-indstillinger via Apache Tomcat-tjenestekonfigurationen (tomcat9w.exe)

1. Naviger til Apache Tomcat-mappen (f.eks. C:\Program Files\Apache Software Foundation\Tomcat 9.0). Åbn bin-mappen, og find tomcat9w.exe. Dobbeltklik på filen for at køre den.

2. Klik på fanen Java, og tilføj følgende værdier i feltet Java 9-indstillinger:

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

   

   Feltet »Java 9 Options « indeholder nu følgende værdier:

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

Tilføj --add-opens-indstillingerne i catalina.bat

1. Naviger til Apache Tomcat-mappen (f.eks. C:\Program Files\Apache Software Foundation\Tomcat 9.0). Åbn mappen bin, og find filen catalina.bat. Åbn filen i en teksteditor.

2. Find afsnittet rem Configure JAVA 9 specific start-up parameters, og tilføj følgende værdier:
   

   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"

   Afsnittet "Konfigurer JAVA 9-specifikke opstartsparametre" indeholder nu følgende værdier:

   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"
   sæt "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util.concurrent=ALL-UNNAMED"
   sæt "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED"

3. Gem ændringerne.

Tilføj --add-opens-indstillingerne i service.bat

1. Naviger til Apache Tomcat-mappen (f.eks. C:\Program Files\Apache Software Foundation\Tomcat 9.0). Åbn mappen bin, og find filen service.bat. Åbn filen i en teksteditor.

2. Gå til linjen --JvmOptions9 og ændr den til:

   --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. Gem ændringerne.