[KB7088] Konfigurace Apache Tomcat pro webovou konzoli ESET PROTECT On-Prem pomocí podporovaného JDK (Windows)

Obsah

• Podporované verze JDK a Apache Tomcat pro webovou konzoli ESET PROTECT On-Prem
• Přepínání distribuce JDK používané Apache Tomcat pro webovou konzoli ESET PROTECT On-Prem
• Instalace JDK Amazon Corretto
• Oprava chyby “Failed to load data” s JDK 17 nebo novějším

Podrobnosti

Řešení

Podporované verze JDK a Apache Tomcat pro webovou konzoli ESET PROTECT On-Prem

Pro spuštění webové konzole ESET PROTECT On-Prem potřebujete běhové prostředí Java, které je poskytováno sadou Java Development Kit (JDK), a kompatibilní verzi Apache Tomcat.

Doporučujeme nainstalovat:

• Apache Tomcat 9.x. (nejnovější stabilní verze)
• JDK 17 nebo 21 (LTS)
  Další informace o verzích JDK naleznete v části Podporované verze JDK níže.

Podporované verze JDK

Alternativy k Oracle JDK (distribuce bez nákladů):

• Amazon Corretto 17 nebo 21 (LTS)

  Pokyny k instalaci naleznete v části Instalace JDK Amazon Corretto.

• Distribuce založené na OpenJDK—například Eclipse Temurin 17 nebo 21 (LTS)

  Při instalaci distribuce OpenJDK do systému Windows pomocí .msi instalační program, vyberte možnost nastavit nebo přepsat nastavení JAVA_HOME prostředí v Průvodci instalací (obvykle v části Vlastní nastavení). Tím se zajistí, že cesta k instalaci Javy bude zaregistrována v systému Windows, což umožní, aby Apache Tomcat vyhledal JDK.

Přepínání distribuce JDK používané Apache Tomcat pro webovou konzoli ESET PROTECT On-Prem

1. Přejděte do složky Apache Tomcat (například, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Otevřete bin a najděte složku tomcat9w.exe. Poklepáním na soubor jej spustíte. Otevře se okno Vlastnosti aplikace Apache Tomcat.

2. Klikněte na kartu Obecné a kliknutím na tlačítko Zastavit zastavte službu Apache Tomcat.

3. Odinstalujte stávající JDK.

4. Nainstalujte nový JDK.

5. Vraťte se do okna Vlastnosti aplikace Apache Tomcat a klikněte na kartu Java.

6. V poli Java Virtual Machine aktualizujte cestu tak, aby ukazovala na jvm.dll soubor nově nainstalovaného JDK (například pro Amazon Corretto, C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Klikněte na kartu Obecné a kliknutím na tlačítko Spustit spusťte službu Apache Tomcat.

8. Ověřte, zda se můžete přihlásit do webové konzole ESET PROTECT On-Prem.

Instalace JDK Amazon Corretto

1. Stáhněte si systém Windows .msi instalační soubor pro Amazon Corretto 17 nebo Amazon Corretto 21.

2. Instalaci spustíte poklepáním na instalační soubor.

3. Pokračujte v instalaci.

   Máte možnost nastavit vlastní instalační cestu. Ve výchozím nastavení je aplikace Amazon Corretto 17 nainstalována na adrese C:\Program Files\Amazon Corretto\. Pokud jste nastavili vlastní cestu, poznamenejte si ji pro další krok.

4. Po dokončení instalace nastavte JAVA_HOME a PATH proměnné prostředí.

   • Sada JAVA_HOME na instalační adresář Amazon Corretto.

     Příklady cest:

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

     Čísla sestavení se mohou lišit

     Každá složka verze Amazon Corretto (např, jdk17.0.17_10) obsahuje číslo sestavení, které se mění s novými verzemi. Po instalaci si vždy ověřte skutečný název složky v aplikaci C:\Program Files\Amazon Corretto.

   • Přidat %JAVA_HOME%\bin na PATH.

5. Ověřte instalaci. V Příkazovém řádku spusťte:

   java -version

   Měli byste vidět následující výstup (čísla sestavení se mohou lišit):

   • 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)

Oprava chyby “Failed to load data” s JDK 17 nebo novějším

Tento problém nastává, pokud je webová konzole ESET PROTECT On-Prem spuštěna na Apache Tomcat s novějšími verzemi JDK (JDK 17 nebo novější). Počínaje verzí Java 9 omezuje systém modulů platformy Java reflexní přístup k určitým interním rozhraním API, která některé knihovny používané webovou konzolou vyžadují.

Chcete-li to vyřešit, musíte přidat speciální --add-opens volby do konfigurace aplikace Apache Tomcat’v jazyce Java, aby tyto moduly zůstaly přístupné. Možnosti můžete přidat prostřednictvím konfigurace služby Apache Tomcat (tomcat9w.exe), souboru catalina.bat nebo service.bat.

Přidání možností --add-opens prostřednictvím konfigurace služby Apache Tomcat (tomcat9w.exe)

1. Přejděte do složky Apache Tomcat (například, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Otevřete bin a najděte složku tomcat9w.exe. Poklepáním na soubor jej spustíte.

2. Klikněte na kartu Java a do pole Možnosti Java 9 přidejte následující hodnoty:

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

   

   Pole Možnosti Java 9 nyní obsahuje následující hodnoty:

   --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. Klikněte na OK.

Přidání možnosti --add-opens do souboru catalina.bat

1. Přejděte do složky Apache Tomcat (například, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Otevřete bin a vyhledejte složku catalina.bat soubor. Otevřete soubor v textovém editoru.

2. Najděte část rem Konfigurace specifických parametrů spouštění JAVA 9 a přidejte následující hodnoty:
   

   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"

   Sekce rem Konfigurace specifických parametrů spouštění JAVA 9 nyní obsahuje následující hodnoty:

   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. Uložte změny.

Přidání možnosti --add-opens do souboru service.bat

1. Přejděte do složky Apache Tomcat (například, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Otevřete bin a vyhledejte složku service.bat soubor. Otevřete soubor v textovém editoru.

2. Přejděte na --JvmOptions9 a změňte jej na:

   --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. Uložte změny.