[KB7088] Apache Tomcat konfigūravimas ESET PROTECT On-Prem Web Console, naudojant palaikomą JDK (Windows)

PASTABA:

Šį puslapį išvertė kompiuteris. Norėdami peržiūrėti originalų tekstą, spustelėkite anglų kalbą šio puslapio skiltyje Kalbos. Jei jums kas nors neaišku, kreipkitės į vietinę pagalbos tarnybą.

Problema

Išsami informacija


Spustelėkite, jei norite išplėsti

ESET PROTECT On-Prem Web Console veikia su Apache Tomcat - žiniatinklio serveriu ir Java programoms skirtu servletų konteineriu. Apache Tomcat neturi Java paleidimo programos; jis remiasi Java paleidimo programa, kurią pateikia Java Development Kit (JDK). Istoriškai "Oracle JDK 8" (Java SE 8) buvo plačiausiai naudojama "Apache Tomcat" versija, todėl daugelis diegimų priklausė nuo jos.

Nuo 2019 m. sausio mėn. bendrovė "Oracle" pakeitė "Java SE 8" licencijavimą. Dabar verslui, komerciniam ar gamybiniam naudojimui skirtiems viešiems atnaujinimams reikia mokamos prenumeratos.

Jei naudojate "Oracle JDK 8" ("Java SE 8") ir neturite "Oracle" prenumeratos, galite pereiti prie nemokamos, palaikomos alternatyvos (pavyzdžiui, "Amazon Corretto").

Šiame straipsnyje aptariami "Windows" diegimai. Apie "Linux" skaitykite susijusius vadovus apie JDK diegimą SUSE Linux Enterprise Server arba Debian.


Sprendimas

Palaikomos JDK ir Apache Tomcat versijos, skirtos ESET PROTECT On-Prem Web Console

Norint paleisti ESET PROTECT On-Prem Web Console, reikia Java paleidimo programos, kurią teikia Java Development Kit (JDK), ir suderinamos Apache Tomcat versijos.

Rekomenduojame įdiegti:

  • Apache Tomcat 9.x. (naujausią stabilią versiją)
  • JDK 17 arba 21 (LTS)
    Daugiau informacijos apie JDK versijas rasite toliau pateiktame skyriuje Palaikomos JDK versijos.
Suderinamumo rekomendacijos
  • Pašalinkite ankstesnes JDK versijas: jei įdiegtos kelios JDK versijos, pašalinkite ankstesnes versijas ir palikite tik naujausią palaikomą JDK.
  • Suderinkite bitų skaičių: įsitikinkite, kad JDK, Apache Tomcat ir ESET PROTECT On-Prem naudoja tą pačią architektūrą (rekomenduojama 64 bitų).
Palaikomos JDK versijos
Palaikomos versijos

Palaikomos tik ilgalaikio palaikymo (LTS) JDK versijos.

Palaikoma JDK versija ESET PROTECT On-Prem versija
17
10.x - 13.x
21
11.x - 13.x

Oracle JDK alternatyvos (nebrangūs platinimai):

  • "Amazon Corretto" 17 arba 21 (LTS)

    Diegimo instrukcijų rasite skyriuje " Amazon Corretto JDK" diegimas ".

  • "OpenJDK" pagrįsti distributyvai, pavyzdžiui, "Eclipse Temurin" 17 arba 21 (LTS)

    Diegdami "OpenJDK" platinimą "Windows" sistemoje naudodami .msi diegimo programą, sąrankos vedlyje pasirinkite parinktį nustatyti arba pakeisti aplinkos kintamąjį JAVA_HOME (paprastai skyriuje "Custom setup" (pasirinktinė sąranka). Taip užtikrinama, kad "Java" diegimo kelias būtų užregistruotas "Windows" sistemoje ir "Apache Tomcat" galėtų rasti JDK.

Klaidos "Nepavyko įkelti duomenų" šalinimas

Jei naudojantis JDK 17 ar vėlesne versija susiduriate su klaida "Failed to load data" (nepavyko įkelti duomenų), žr. skyrių " Fix the "Failed to load data" error with JDK 17 or later" (ištaisyti klaidą "Nepavyko įkelti duomenų" naudojant JDK 17 ar vėlesnę versiją).


JDK distribucijos, naudojamos Apache Tomcat programai ESET PROTECT On-Prem Web Console, keitimas

  1. Pereikite į Apache Tomcat aplanką (pavyzdžiui, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Atidarykite aplanką bin ir raskite tomcat9w.exe. Dukart spustelėkite failą, kad jį paleistumėte. Atsidarys "Apache Tomcat Properties".

  2. Spustelėkite skirtuką General (Bendrieji) ir spustelėkite Stop (Sustabdyti), kad sustabdytumėte "Apache Tomcat" paslaugą.

  3. Išinstaliuokite dabartinį JDK.

  4. Įdiekite naują JDK.

  5. Grįžkite į "Apache Tomcat Properties" ir spustelėkite skirtuką Java.

  6. Lauke Java Virtual Machine (Java virtualioji mašina) 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 (Bendra) ir spustelėkite Start (Pradėti), kad paleistumėte "Apache Tomcat" paslaugą.

  8. Patikrinkite, ar galite prisijungti prie savo ESET PROTECT On-Prem Web konsolės.


Įdiekite Amazon Corretto JDK

  1. Atsisiųskite Amazon Corretto 17 arba Amazon Corretto 21 Windows .msi diegimo failą.

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

  3. Atlikite diegimo veiksmus.

    Turite galimybę nustatyti pasirinktinį diegimo kelią. Pagal numatytuosius nustatymus "Amazon Corretto 17" įdiegiama adresu C:\Program Files\Amazon Corretto\. Jei nustatėte pasirinktinį kelią, įsidėmėkite jį kitame žingsnyje.

  4. Baigę diegimą, nustatykite JAVA_HOME ir PATH aplinkos kintamuosius.

    • Nustatykite JAVA_HOME į "Amazon Corretto" diegimo katalogą.

      Kelio pavyzdys:

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

      Sukūrimo numeriai gali skirtis

      Kiekviename "Amazon Corretto" versijos aplanke (pvz., jdk17.0.17_10) yra surinkimo numeris, kuris keičiasi su naujomis versijomis. Visada patikrinkite tikrąjį aplanko pavadinimą po įdiegimo C:\Program Files\Amazon Corretto.

    • Į PATH įtraukite %JAVA_HOME%\bin.

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

    paleiskite komandą: java -version

    Turėtumėte matyti tokią išvestį (surinkimo numeriai gali skirtis):

    • "Amazon Corretto" 17:

      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 Runtime Environment Corretto-21.0.9.11.1 (build 21.0.9+11-LTS) OpenJDK 64 bitų serverio VM Corretto-21.0.9.11.1 (build 21.0.9+11-LTS, mišrus režimas, dalijimasis)

Ištaisyta klaida "Nepavyko įkelti duomenų" naudojant JDK 17 ar vėlesnę versiją

Ši problema atsiranda, kai ESET PROTECT On-Prem Web Console veikia Apache Tomcat su naujesnėmis JDK versijomis (JDK 17 ar vėlesnėmis). Nuo Java 9 versijos Java platformos modulių sistema riboja atspindinčią prieigą prie tam tikrų vidinių API, kurių reikia kai kurioms Web konsolės naudojamoms bibliotekoms.

Kad tai išspręstumėte, į "Apache Tomcat" "Java" konfigūraciją reikia įtraukti specialias --add-opens" parinktis, kad šie moduliai išliktų prieinami. Parinktis galite pridėti per "Apache Tomcat" paslaugos konfigūraciją (tomcat9w.exe), catalina.bat arba service.bat failą.

Po kiekvieno pakeitimo iš naujo paleiskite "Apache Tomcat" paslaugą

Po kiekvieno pakeitimo .exe arba .bat failuose reikia iš naujo paleisti "Apache" tarnybą. Norėdami iš naujo paleisti paslaugą, atlikite šiuos veiksmus:

  1. Paspauskite " Windows" klavišą, įveskite " Service" ir atidarykite programą " Services".

  2. Dešinėje pusėje esančiame sąraše dešiniuoju pelės klavišu spustelėkite " Apache Tomcat" .

  3. Spustelėkite Iš naujo paleisti.

Pridėti --add-opens parinktis per "Apache Tomcat" paslaugos konfigūraciją (tomcat9w.exe)
  1. Pereikite prie "Apache Tomcat" aplanko (pavyzdžiui, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Atidarykite aplanką bin ir raskite tomcat9w.exe. Dukart spustelėkite failą, kad jį paleistumėte.

  2. Spustelėkite skirtuką " Java" ir į lauką " Java 9 Options" įrašykite šias vertes:

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

    Java 9 parinkčių lauke 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.
Pridėkite --add-opens parinktis į catalina.bat
  1. Pereikite į "Apache Tomcat" aplanką (pavyzdžiui, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Atidarykite bin aplanką ir raskite catalina.bat failą. Atidarykite failą teksto redaktoriumi.

  2. Raskite skirsnį Rem Configure JAVA 9 specific start-up parameters (konfigūruoti JAVA 9 specifinius paleidimo parametrus ) ir pridėkite šias vertes:

    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"

    Skiltyje " Rem" Konfigūruoti konkrečius JAVA 9 paleidimo parametrus dabar pateikiamos šios reikšmės:

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

Į service.bat įrašykite --add-opens parinktis
  1. Pereikite į "Apache Tomcat" aplanką (pavyzdžiui, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Atidarykite bin aplanką ir raskite service.bat failą. Atidarykite failą teksto redaktoriumi.

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

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