[KB7088] „Apache Tomcat“ konfigūravimas „ESET PROTECT On-Prem“ žiniatinklio konsolės reikmėms naudojant palaikomą JDK (Windows)

Problema

• „ESET PROTECT On-Prem“ žiniatinklio konsolėje palaikomos JDK ir „Apache Tomcat“ versijos
• „Apache Tomcat“ naudojamos JDK versijos keitimas „ESET PROTECT On-Prem“ žiniatinklio konsolėje
• Įdiekite „Amazon Corretto“ JDK
• „Nepavyko įkelti duomenų“ klaidos ištaisymas naudojant JDK 17 ar naujesnę versiją

Išsami informacija

Sprendimas

„ESET PROTECT On-Prem“ žiniatinklio konsolės palaikomos JDK ir „Apache Tomcat“ versijos

Norint paleisti „ESET PROTECT On-Prem“ žiniatinklio konsolę, reikalinga „Java Development Kit“ (JDK) teikiama „Java“ vykdymo aplinka ir suderinama „Apache Tomcat“ versija.

Rekomenduojame įdiegti:

• „Apache Tomcat“ 9.x. (naujausia stabili versija)
• JDK 17 arba 21 (LTS)
  Daugiau informacijos apie JDK versijas rasite žemiau esančiame skyriuje „Palaikomos JDK versijos “.

Palaikomos JDK versijos

„Oracle JDK “ alternatyvos (nemokamos versijos):

• „Amazon Corretto“ 17 arba 21 (LTS)

  Diegimo instrukcijas rasite skyriuje „Amazon Corretto JDK diegimas “.

• „OpenJDK“ pagrįstos distribucijos, pavyzdžiui, „Eclipse Temurin“ 17 arba 21 (LTS)

  Diegdami „OpenJDK“ distribuciją „Windows“ sistemoje naudodami .msi diegimo programą, nustatymo vedlyje pasirinkite parinktį, leidžiančią nustatyti arba pakeisti aplinkos kintamąjį „JAVA_HOME“ (paprastai tai daroma skyriuje „Custom setup“). Tai užtikrina, kad „Java“ diegimo kelias bus užregistruotas „Windows“ sistemoje, o „Apache Tomcat“ galės rasti JDK.

„Apache Tomcat“ naudojamos JDK versijos keitimas „ESET PROTECT On-Prem“ žiniatinklio konsolėje

1. Eikite į „Apache Tomcat“ aplanką (pavyzdžiui, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Atidarykite „bin“ aplanką ir suraskite failą „tomcat9w.exe“. Dukart spustelėkite failą, kad jį paleistumėte. Atsivers „Apache Tomcat Properties“ langas.

2. Spustelėkite skirtuką „Bendrieji“ ir spustelėkite „Sustabdyti“, kad sustabdytumėte „Apache Tomcat“ paslaugą.

3. Pašalinkite esamą JDK.

4. Įdiekite naują JDK.

5. Grįžkite į „Apache Tomcat“ savybes ir spustelėkite skirtuką „Java “.

6. Lauke „Java Virtual Machine“ atnaujinkite kelią, kad jis rodytų į naujai įdiegtos JDK failą „jvm.dll“ (pavyzdžiui, „Amazon Corretto“ atveju – C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Spustelėkite skirtuką „General“ ir spustelėkite „Start“, kad paleistumėte „Apache Tomcat“ paslaugą.

8. Patikrinkite, ar galite prisijungti prie „ESET PROTECT On-Prem“ žiniatinklio konsolės.

Įdiekite „Amazon Corretto“ JDK

1. Atsisiųskite „Amazon Corretto 17“ arba „Amazon Corretto 21“ diegimo failą „.msi“ formatu, skirtą „Windows“ sistemai.

2. Dukart spustelėkite diegimo failą, kad pradėtumėte diegimą.

3. Vykdykite diegimo veiksmus.

   Galite nustatyti pasirinktinį diegimo kelią. Pagal numatytuosius nustatymus „Amazon Corretto 17“ diegiamas į katalogą „C:\Program Files\Amazon Corretto\“. Jei nustatote pasirinktinį kelią, užsirašykite jį, kad galėtumėte jį naudoti kitame žingsnyje.

4. Baigus diegimą, nustatykite aplinkos kintamuosius „JAVA_HOME “ ir „PATH “.

   • Nustatykite „JAVA_HOME“ į „Amazon Corretto“ diegimo katalogą.

     Pavyzdiniai katalogai:

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

     Versijų numeriai gali skirtis

     Kiekvienoje „Amazon Corretto“ versijos aplankėje (pavyzdžiui, jdk17.0.17_10) yra versijos numeris, kuris keičiasi išleidžiant naujas versijas. Po įdiegimo visada patikrinkite tikslų aplanko pavadinimą kataloge C:\Program Files\Amazon Corretto.

   • Pridėkite %JAVA_HOME%\bin į PATH.

5. Patikrinkite įdiegimą. Komandų eilutėje paleiskite:

   java -version

   Turėtumėte pamatyti tokį rezultatą (versijos numeriai gali skirtis):

   • „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 (versija 17.0.17+10-LTS, mišrus režimas, bendras naudojimas)
     

   • „Amazon Corretto“ 21:

     „OpenJDK“ versija „21.0.9“ 2025-10-21 LTS
     „OpenJDK“ vykdymo aplinka „Corretto-21.0.9.11.1“ (versija 21.0.9+11-LTS)
     „OpenJDK“ 64 bitų serverio VM „Corretto-21.0.9.11.1“ (versija 21.0.9+11-LTS, mišrusis režimas, bendras naudojimas)

Ištaisyta klaida „Nepavyko įkelti duomenų“ naudojant JDK 17 ar naujesnę versiją

Ši problema kyla, kai „ESET PROTECT On-Prem“ žiniatinklio konsolė veikia „Apache Tomcat“ aplinkoje su naujesnėmis JDK versijomis (JDK 17 ar naujesnėmis). Nuo „Java 9“ versijos „Java Platform Module System“ riboja refleksinę prieigą prie tam tikrų vidinių API, kurių reikalauja kai kurios žiniatinklio konsolės naudojamos bibliotekos.

Norėdami išspręsti šią problemą, turite į „Apache Tomcat“ „Java“ konfigūraciją įtraukti specialias --add-opens parinktis, kad šie moduliai liktų prieinami. Šias parinktis galite įtraukti per „Apache Tomcat“ paslaugos konfigūraciją (tomcat9w.exe), failą „catalina.bat“ arba „service.bat “.

Pridėkite --add-opens parinktis per „Apache Tomcat“ paslaugos konfigūraciją (tomcat9w.exe)

1. Eikite į „Apache Tomcat“ aplanką (pavyzdžiui, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Atidarykite „bin“ aplanką ir suraskite fail ą „tomcat9w.exe“. Dvigubai spustelėkite failą, kad jį paleistumėte.

2. Spustelėkite skirtuką „Java“ ir lauke „Java 9 Options“ įveskite šias reikšmes:

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

   

   Lauke „Java 9 Options “ dabar yra šios reikšmės:

   --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. Spustelėkite „OK“.

Įtraukite --add-opens parinktis į failą „catalina.bat“

1. Eikite į „Apache Tomcat“ aplanką (pavyzdžiui, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Atidarykite „bin“ aplanką ir suraskite failą „catalina.bat “. Atidarykite failą teksto redaktoriuje.

2. Suraskite skyrių „rem Configure JAVA 9 specific start-up parameters “ ir įterpkite šias reikšmes:
   

   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"

   Skyriuje „Konfigūruoti JAVA 9 specifinius paleidimo parametrus“ dabar yra šios reikšmės:

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

3. Išsaugokite pakeitimus.

Įtraukite --add-opens parinktis į failą service.bat

1. Eikite į „Apache Tomcat“ aplanką (pavyzdžiui, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Atidarykite „bin“ aplanką ir suraskite failą „service.bat “. Atidarykite failą teksto redaktoriuje.

2. Pereikite prie eilutės --JvmOptions9 ir pakeiskite ją taip:

   --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. Išsaugokite pakeitimus.