[KB7088] Määritä Apache Tomcat ESET PROTECT On-Prem -verkkokonsolia varten tuetun JDK:n avulla (Windows)

Ongelma

• ESET PROTECT On-Prem -verkkokonsolin tukemat JDK- ja Apache Tomcat -versiot
• Vaihda Apache Tomcatin käyttämää JDK-jakelua ESET PROTECT On-Prem -verkkokonsolissa
• Asenna Amazon Corretto JDK
• Korjaa virhe ”Failed to load data” (Tietojen lataaminen epäonnistui) JDK 17:n tai uudemman version kanssa

Tiedot

Ratkaisu

ESET PROTECT On-Prem -verkkokonsolin tuetut JDK- ja Apache Tomcat -versiot

ESET PROTECT On-Prem -verkkokonsolin käyttämiseen tarvitaan Java Development Kitin (JDK) tarjoama Java-ajoympäristö sekä yhteensopiva Apache Tomcat -versio.

Suosittelemme seuraavien versioiden asentamista:

• Apache Tomcat 9.x. (uusin vakaa versio)
• JDK 17 tai 21 (LTS)
  Lisätietoja JDK-versioista on alla olevassa Tuetut JDK-versiot -osiossa.

Tuetut JDK-versiot

Vaihtoehtoja Oracle JDK:lle (ilmaiset jakelut):

• Amazon Corretto 17 tai 21 (LTS)

  Asennusohjeet löytyvät kohdasta Amazon Corretto JDK:n asentaminen.

• OpenJDK-pohjaiset jakelut – esimerkiksi Eclipse Temurin 17 tai 21 (LTS)

  Kun asennat OpenJDK-jakelupaketin Windowsiin .msi-asennusohjelman avulla, valitse asennusohjeessa (yleensä kohdassa Mukautettu asennus) vaihtoehto, jolla määritetään tai ohitetaan JAVA_HOME-ympäristömuuttuja. Tämä varmistaa, että Java-asennustie rekisteröidään Windowsissa, jolloin Apache Tomcat löytää JDK:n.

Vaihda Apache Tomcatin käyttämä JDK-jakelu ESET PROTECT On-Prem -verkkokonsolissa

1. Siirry Apache Tomcat -kansioon (esimerkiksi C:\Program Files\Apache Software Foundation\Tomcat 9.0). Avaa bin-kansio ja etsi tomcat9w.exe-tiedosto. Kaksoisnapsauta tiedostoa suorittaaksesi sen. Apache Tomcatin ominaisuudet -ikkuna avautuu.

2. Napsauta Yleiset- välilehteä ja valitse Lopeta, jotta Apache Tomcat -palvelu pysähtyy.

3. Poista nykyinen JDK.

4. Asenna uusi JDK.

5. Palaa takaisin Apache Tomcatin ominaisuuksiin ja napsauta Java-välilehteä.

6. Päivitä Java Virtual Machine -kentän polku osoittamaan äskettäin asennetun JDK:n jvm.dll-tiedosto on (esimerkiksi Amazon Corretto:n tapauksessa C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Napsauta General -välilehteä ja napsauta Start käynnistääksesi Apache Tomcat -palvelun.

8. Varmista, että voit kirjautua ESET PROTECT On-Prem -verkkokonsoliin.

Asenna Amazon Corretto JDK

1. Lataa Amazon Corretto 17:n tai Amazon Corretto 21:n Windows-asennustiedosto (.msi ).

2. Kaksoisnapsauta asennustiedostoa käynnistääksesi asennuksen.

3. Seuraa asennusohjeita.

   Voit määrittää mukautetun asennuskansion. Oletusarvoisesti Amazon Corretto 17 asennetaan kansioon C:\Program Files\Amazon Corretto\. Jos määrität mukautetun kansion, kirjoita se muistiin seuraavaa vaihetta varten.

4. Kun asennus on valmis, määritä JAVA_HOME- ja PATH -ympäristömuuttujat.

   • Määritä JAVA_HOME Amazon Corretto -asennushakemistoksi.

     Esimerkkejä poluista:

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

     Rakennusnumerot voivat vaihdella

     Jokaisen Amazon Corretto -version kansio (esimerkiksi jdk17.0.17_10) sisältää rakennusnumeron, joka muuttuu uusien julkaisujen myötä. Tarkista aina asennuksen jälkeen kansion todellinen nimi kansiosta C:\Program Files\Amazon Corretto.

   • Lisää %JAVA_HOME%\bin PATH-muuttujaan.

5. Tarkista asennus. Suorita komentokehotteessa:

   java -version

   Näytössä pitäisi näkyä seuraava tulos (rakennusnumerot voivat vaihdella):

   • 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-bittinen palvelin-VM Corretto-17.0.17.10.1 (rakennusnumero 17.0.17+10-LTS, sekamoodi, jaettu)
     

   • Amazon Corretto 21:

     openjdk-versio "21.0.9" 2025-10-21 LTS
     OpenJDK-ajoympäristö Corretto-21.0.9.11.1 (rakennus 21.0.9+11-LTS)
     OpenJDK 64-bittinen palvelin-VM Corretto-21.0.9.11.1 (rakennus 21.0.9+11-LTS, sekamoodi, jakaminen)

Korjaa virhe ”Failed to load data” (Tietojen lataaminen epäonnistui) JDK 17:n tai uudemman version kanssa

Tämä ongelma ilmenee, kun ESET PROTECT On-Prem -verkkokonsoli toimii Apache Tomcatissa uusimmilla JDK-versioilla (JDK 17 tai uudemmat). Java 9:stä lähtien Java Platform Module System rajoittaa reflektiivistä pääsyä tiettyihin sisäisiin sovellusliittymiin (API), joita jotkin verkkokonsolin käyttämät kirjastot tarvitsevat.

Tämän ratkaisemiseksi sinun on lisättävä erityisiä --add-opens-vaihtoehtoja Apache Tomcatin Java-määrityksiin, jotta nämä moduulit pysyvät käytettävissä. Voit lisätä vaihtoehdot Apache Tomcat -palvelun määritysten (tomcat9w.exe) tai catalina.bat- tai service.bat-tiedoston kautta.

Lisää --add-opens-vaihtoehdot Apache Tomcat -palvelun määritysten kautta (tomcat9w.exe)

1. Siirry Apache Tomcat -kansioon (esimerkiksi C:\Program Files\Apache Software Foundation\Tomcat 9.0). Avaa bin-kansio ja etsi tomcat9w.exe-tiedosto. Käynnistä tiedosto kaksoisnapsauttamalla sitä.

2. Napsauta Java-välilehteä ja lisää seuraavat arvot Java 9 Options -kenttään:

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

   

   Java 9 Options -kenttä sisältää nyt seuraavat arvot:

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

Lisää --add-opens-vaihtoehdot catalina.bat-tiedostoon

1. Siirry Apache Tomcat -kansioon (esimerkiksi C:\Program Files\Apache Software Foundation\Tomcat 9.0). Avaa bin-kansio ja etsi catalina.bat-tiedosto. Avaa tiedosto tekstieditorissa.

2. Etsi rem Configure JAVA 9 specific start-up parameters -osio ja lisää seuraavat arvot:
   

   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"

   Kohdassa ”Määritä JAVA 9:n käynnistysparametrit ” on nyt seuraavat arvot:

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

3. Tallenna muutokset.

Lisää --add-opens-vaihtoehdot service.bat-tiedostoon

1. Siirry Apache Tomcat -kansioon (esimerkiksi C:\Program Files\Apache Software Foundation\Tomcat 9.0). Avaa bin-kansio ja etsi service.bat-tiedosto. Avaa tiedosto tekstieditorissa.

2. Siirry riville --JvmOptions9 ja muuta se seuraavasti:

   --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. Tallenna muutokset.