[KB7088] Nastavitev Apache Tomcat za spletno konzolo ESET PROTECT On-Prem z uporabo podprtega JDK (Windows)

Težava

• Podprte različice JDK in Apache Tomcat za spletno konzolo ESET PROTECT On-Prem
• Zamenjava distribucije JDK, ki jo uporablja Apache Tomcat za spletno konzolo ESET PROTECT On-Prem
• Namestite Amazon Corretto JDK
• Odpravite napako »Failed to load data« z JDK 17 ali novejšo različico

Podrobnosti

Rešitev

Podprte različice JDK in Apache Tomcat za spletno konzolo ESET PROTECT On-Prem

Za zagon spletne konzole ESET PROTECT On-Prem potrebujete okolje Java, ki ga zagotavlja Java Development Kit (JDK), ter združljivo različico Apache Tomcat.

Priporočamo namestitev:

• Apache Tomcat 9.x. (najnovejša stabilna različica)
• JDK 17 ali 21 (LTS)
  Za več informacij o različicah JDK glejte spodnji razdelek Podprte različice JDK.

Podprte različice JDK

Alternative za Oracle JDK (brezplačne distribucije):

• Amazon Corretto 17 ali 21 (LTS)

  Za navodila za namestitev glejte poglavje Namestitev Amazon Corretto JDK.

• Distribucije na osnovi OpenJDK – na primer Eclipse Temurin 17 ali 21 (LTS)

  Pri namestitvi distribucije OpenJDK v sistemu Windows z namestitvenim programom .msi v čarovniku za namestitev izberite možnost za nastavitev ali prepis spremenljivke okolja JAVA_HOME (običajno v razdelku »Custom setup«). S tem zagotovite, da je pot do namestitve Java registrirana v sistemu Windows, kar omogoča Apache Tomcatu, da najde JDK.

Zamenjava distribucije JDK, ki jo Apache Tomcat uporablja za spletno konzolo ESET PROTECT On-Prem

1. Pojdite v mapo Apache Tomcat (na primer C:\Program Files\Apache Software Foundation\Tomcat 9.0). Odprite mapo bin in poiščite datoteko tomcat9w.exe. Dvakrat kliknite datoteko, da jo zaženete. Odprlo se bo okno Lastnosti Apache Tomcat.

2. Kliknite zavihek »General« (Splošno) in kliknite »Stop« (Ustavi), da ustavite storitev Apache Tomcat.

3. Odstranite trenutni JDK.

4. Namestite nov JDK.

5. Vrnite se v okno »Lastnosti Apache Tomcat« in kliknite zavihek »Java «.

6. V polju »Java Virtual Machine« posodobite pot tako, da kaže na datoteko jvm.dll na novo nameščenega JDK (na primer za Amazon Corretto: C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Kliknite zavihek »General« in kliknite »Start«, da zaženete storitev Apache Tomcat.

8. Preverite, ali se lahko prijavite v spletno konzolo ESET PROTECT On-Prem.

Namestite JDK za Amazon Corretto

1. Prenesite namestitveno datoteko .msi za Windows za Amazon Corretto 17 ali Amazon Corretto 21.

2. Dvakrat kliknite namestitveno datoteko, da začnete namestitev.

3. Sledite navodilom za namestitev.

   Imate možnost, da nastavite lastno namestitveno pot. Privzeto se Amazon Corretto 17 namesti v mapo C:\Program Files\Amazon Corretto\. Če nastavite lastno pot, si jo zapišite za naslednji korak.

4. Ko je namestitev končana, nastavite spremenljivki okolja JAVA_HOME in PATH.

   • Spremenite spremenljivko JAVA_HOME na namestitveni imenik programa Amazon Corretto.

     Primeri poti:

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

     Številke zgradb se lahko razlikujejo

     Vsaka mapa z različico Amazon Corretto (na primer jdk17.0.17_10) vsebuje številko različice, ki se spreminja z novimi izdajami. Po namestitvi v mapi C:\Program Files\Amazon Corretto vedno preverite dejansko ime mape.

   • Dodajte %JAVA_HOME%\bin v PATH.

5. Preverite namestitev. V ukazni vrstici zaženite:

   java -version

   Prikazati se mora naslednji izpis (številke zgradb se lahko razlikujejo):

   • Amazon Corretto 17:

     openjdk version "17.0.17" 2025-10-21 LTS
     OpenJDK Runtime Environment Corretto-17.0.17.10.1 (zgradba 17.0.17+10-LTS)
     OpenJDK 64-bitni strežniški VM Corretto-17.0.17.10.1 (zgradba 17.0.17+10-LTS, mešani način, souporaba)
     

   • Amazon Corretto 21:

     različica OpenJDK »21.0.9« 21.10.2025 LTS
     Izvedbeno okolje OpenJDK Corretto-21.0.9.11.1 (zgradba 21.0.9+11-LTS)
     64-bitni strežniški VM OpenJDK Corretto-21.0.9.11.1 (zgradba 21.0.9+11-LTS, mešani način, souporaba)

Odpravite napako »Failed to load data« pri JDK 17 ali novejših različicah

Ta težava se pojavi, ko spletna konzola ESET PROTECT On-Prem deluje na Apache Tomcat z novejšimi različicami JDK (JDK 17 ali novejše). Od Java 9 naprej sistem Java Platform Module System omejuje refleksivni dostop do nekaterih notranjih API-jev, ki jih potrebujejo nekatere knjižnice, ki jih uporablja spletna konzola.

Da bi to odpravili, morate v konfiguracijo Java za Apache Tomcat dodati posebne možnosti --add-opens, da bodo ti moduli ostali dostopni. Možnosti lahko dodate prek konfiguracije storitve Apache Tomcat (tomcat9w.exe) ali datoteke catalina.bat ali service.bat.

Dodajte možnosti --add-opens prek konfiguracije storitve Apache Tomcat (tomcat9w.exe)

1. Pojdite v mapo Apache Tomcat (na primer C:\Program Files\Apache Software Foundation\Tomcat 9.0). Odprite mapo »bin« in poiščite datoteko tomcat9w.exe. Dvakrat kliknite datoteko, da jo zaženete.

2. Kliknite zavihek »Java« in v polje »Java 9 Options« vnesite naslednje vrednosti:

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

   

   Polje »Java 9 Options « zdaj vsebuje naslednje vrednosti:

   --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. Kliknite OK.

Dodajte možnosti --add-opens v datoteko catalina.bat

1. Pojdite v mapo Apache Tomcat (na primer C:\Program Files\Apache Software Foundation\Tomcat 9.0). Odprite mapo bin in poiščite datoteko catalina.bat. Datoteko odprite v urejevalniku besedil.

2. Poiščite odsek rem Configure JAVA 9 specific start-up parameters in dodajte naslednje vrednosti:
   

   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"

   Oddelek »Konfigurirajte parametre zagona, specifične za JAVA 9« zdaj vsebuje naslednje vrednosti:

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

3. Shranite spremembe.

Dodajte možnosti --add-opens v datoteko service.bat

1. Pojdite v mapo Apache Tomcat (na primer C:\Program Files\Apache Software Foundation\Tomcat 9.0). Odprite mapo bin in poiščite datoteko service.bat. Datoteko odprite v urejevalniku besedil.

2. Pojdite do vrstice --JvmOptions9 in jo spremenite v:

   --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. Shranite spremembe.