[KB7088] Apache Tomcat konfigurēšana ESET PROTECT On-Prem Web konsolei, izmantojot atbalstītu JDK (Windows)

PIEZĪME:

Šo lapu ir iztulkojis dators. Lai parādītu oriģināltekstu, šīs lapas sadaļā Valodas noklikšķiniet uz Angļu valoda. Ja jums kaut kas nav skaidrs, lūdzu, sazinieties ar vietējo atbalsta dienestu.

Izdevums

Sīkāka informācija


Noklikšķiniet, lai paplašinātu

ESET PROTECT On-Prem Web Console darbojas ar Apache Tomcat, tīmekļa serveri un Java lietojumprogrammu servletu konteineru. Apache Tomcat neietver Java izpildmehānismu; tas paļaujas uz Java izpildmehānismu, ko nodrošina Java izstrādes komplekts (JDK). Vēsturiski Oracle JDK 8 (Java SE 8) bija visplašāk izmantotā Apache Tomcat versija, tāpēc daudzi izvietojumi bija atkarīgi no tās.

Sākot ar 2019. gada janvāri, Oracle mainīja Java SE 8 licencēšanu. Publiskiem atjauninājumiem, kas paredzēti izmantošanai uzņēmējdarbībā, komerciāliem vai ražošanas mērķiem, tagad ir nepieciešama maksas abonēšana.

Ja izmantojat Oracle JDK 8 (Java SE 8) un jums nav Oracle abonementa, varat pāriet uz bezmaksas atbalstītu alternatīvu (piemēram, Amazon Corretto).

Šis raksts attiecas uz Windows instalācijām. Attiecībā uz Linux skatiet saistītās rokasgrāmatas par JDK instalēšanu SUSE Linux Enterprise Server vai Debian.


Risinājums

Atbalstītās JDK un Apache Tomcat versijas ESET PROTECT On-Prem Web konsolei

Lai palaistu ESET PROTECT On-Prem Web Console, ir nepieciešama Java runtime, ko nodrošina Java Development Kit (JDK), un saderīga Apache Tomcat versija.

Mēs iesakām instalēt:

  • Apache Tomcat 9.x. (jaunākā stabilā versija)
  • JDK 17 vai 21 (LTS)
    Sīkāku informāciju par JDK versijām skatiet tālāk sadaļā Atbalstītās JDK versijas.
Savietojamības ieteikumi
  • Noņemiet iepriekšējās JDK versijas: ja ir instalētas vairākas JDK versijas, atinstalējiet iepriekšējās versijas un saglabājiet tikai jaunāko atbalstīto JDK.
  • Atbilstība bitiem: pārliecinieties, ka JDK, Apache Tomcat un ESET PROTECT On-Prem izmanto vienu un to pašu arhitektūru (ieteicams 64 bitu).
Atbalstītās JDK versijas
Atbalstītās versijas

Tiek atbalstītas tikai ilgtermiņa atbalsta (LTS) JDK versijas.

Atbalstītā JDK versija ESET PROTECT On-Prem versija
17
10.x - 13.x
21
11.x - 13.x

Oracle JDK alternatīvas (bezmaksas izplatīšanas):

  • Amazon Corretto 17 vai 21 (LTS)

    Uzstādīšanas norādījumus skatiet sadaļā Instalēt Amazon Corretto JDK.

  • Uz OpenJDK balstītas izplatīšanas, piemēram, Eclipse Temurin 17 vai 21 (LTS)

    Instalējot OpenJDK distribūciju operētājsistēmā Windows, izmantojot .msi instalēšanas programmu, iestatīšanas vednī (parasti sadaļā Custom setup (Pielāgota iestatīšana)) atlasiet iespēju iestatīt vai aizstāt JAVA_HOME vides mainīgo. Tas nodrošina, ka Java instalācijas ceļš tiek reģistrēts Windows sistēmā, ļaujot Apache Tomcat atrast JDK.

Kļūdas "F failed to load data" (neizdevās ielādēt datus) novēršana

Ja, izmantojot JDK 17 vai jaunāku versiju, sastopaties ar kļūdu "Failed to load data" (neizdevās ielādēt datus), skatiet norādījumus sadaļā Kļūdas "Failed to load data" (neizdevās ielādēt datus) novēršana, izmantojot JDK 17 vai jaunāku vers iju.


Pārslēdziet JDK izplatījumu, ko izmanto Apache Tomcat ESET PROTECT On-Prem tīmekļa konsolei

  1. Pārejiet uz Apache Tomcat mapi (piemēram, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Atveriet bin mapi un atrodiet tomcat9w.exe. Divreiz noklikšķiniet uz faila, lai to palaistu. Atvērsies Apache Tomcat Properties.

  2. Noklikšķiniet uz cilnes General (Vispārīgi) un noklikšķiniet uz Stop (Pārtraukt), lai apturētu Apache Tomcat pakalpojumu.

  3. Atinstalējiet pašreizējo JDK.

  4. Instalējiet jaunu JDK.

  5. Atgriezieties Apache Tomcat Properties un noklikšķiniet uz cilnes Java.

  6. Laukā Java Virtual Machine (Java virtuālā mašīna) atjauniniet ceļu, lai norādītu uz jauninstalētās JDK jvm.dll failu (piemēram, Amazon Corretto gadījumā - C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

  7. Noklikšķiniet uz cilnes Vispārīgi un noklikšķiniet uz Sākt, lai palaistu Apache Tomcat pakalpojumu.

  8. Pārbaudiet, vai varat pieteikties savā ESET PROTECT On-Prem Web Console.


Instalējiet Amazon Corretto JDK

  1. Lejupielādējiet Windows .msi instalācijas failu Amazon Corretto 17 vai Amazon Corretto 21.

  2. Divreiz noklikšķiniet uz instalācijas faila, lai sāktu instalāciju.

  3. Veiciet instalēšanas darbības.

    Jums ir iespēja iestatīt pielāgotu instalēšanas ceļu. Pēc noklusējuma Amazon Corretto 17 ir instalēts C:\Program Files\Amazon Corretto\. Ja iestatāt pielāgotu ceļu, atzīmējiet to nākamajā solī.

  4. Kad instalēšana ir pabeigta, iestatiet JAVA_HOME un PATH vides mainīgos.

    • JAVA_HOME iestatiet uz Amazon Corretto instalācijas direktoriju.

      Ceļu piemēri:

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

      Veidņu numuri var atšķirties

      Katras Amazon Corretto versijas mapē (piemēram, jdk17.0.17_10) ir iekļauts izveides numurs, kas mainās līdz ar jaunām versijām. Pēc instalēšanas vienmēr pārbaudiet faktisko mapes nosaukumu mapē C:\Program Files\Amazon Corretto.

    • Pievienojiet PATH %JAVA_HOME%\bin.

  5. Pārbaudiet instalēšanu. Komandu prombūtnē palaidiet:

    java -version

    Jums jāparādās šādam izvades rezultātam (izveides numuri var atšķirties):

    • 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-bitu servera VM Corretto-21.0.9.11.1 (build 21.0.9+11-LTS, jaukts režīms, koplietošana)

Kļūdas "F failed to load data" (neizdevās ielādēt datus) labošana, izmantojot JDK 17 vai jaunāku versiju

Šī problēma rodas, kad ESET PROTECT On-Prem Web konsole darbojas Apache Tomcat ar jaunākām JDK versijām (JDK 17 vai jaunāka). Sākot ar Java 9, Java platformas moduļu sistēma ierobežo atstarojošo piekļuvi noteiktām iekšējām API, kas nepieciešama dažām Web konsoles izmantotajām bibliotēkām.

Lai to atrisinātu, Apache Tomcat Java konfigurācijā ir jāpievieno īpašas --add-opens opcijas, lai šie moduļi būtu pieejami. Šīs opcijas var pievienot, izmantojot Apache Tomcat pakalpojuma konfigurāciju (tomcat9w.exe), catalina.bat vai service.bat failu.

Pēc katrām izmaiņām restartējiet Apache Tomcat pakalpojumu

Pēc katrām izmaiņām .exe vai .bat failos ir jāpārstartē Apache pakalpojums. Lai restartētu pakalpojumu, izpildiet šādas darbības:

  1. Nospiediet taustiņu Windows, ierakstiet Service un atveriet programmu Services.

  2. Ar peles labo pogu noklikšķiniet uz Apache Tomcat sarakstā labajā pusē.

  3. Noklikšķiniet uz Restartēt.

Pievienojiet --add-opens opcijas, izmantojot Apache Tomcat pakalpojuma konfigurāciju (tomcat9w.exe)
  1. Pārejiet uz Apache Tomcat mapi (piemēram, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Atveriet bin mapi un atrodiet tomcat9w.exe. Divreiz noklikšķiniet uz faila, lai to palaistu.

  2. Noklikšķiniet uz cilnes Java un pievienojiet šādas vērtības laukā Java 9 Options:

    --add-opens=java.base/java.util=ALL-UNNAMED --add-opens=java.base/java.util.concurrent=ALL-UNNAMED
    1-1. attēls

    Java 9 opciju laukā tagad ir šādas vērtības:

    ---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. Noklikšķiniet uz OK.
Pievienojiet --add-opens opcijas catalina.bat
  1. Pārejiet uz Apache Tomcat mapi (piemēram, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Atveriet bin mapi un atrodiet catalina.bat failu. Atveriet failu teksta redaktorā.

  2. Atrodiet sadaļu Configure JAVA 9 specific start-up parameters un pievienojiet šādas vērtības:

    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"

    Sadaļā rem Konfigurēt JAVA 9 īpašos palaišanas parametrus tagad ir šādas vērtības:

    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. Saglabājiet izmaiņas.

Pievienojiet --add-opens opcijas service.bat
  1. Pārejiet uz Apache Tomcat mapi (piemēram, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Atveriet bin mapi un atrodiet service.bat failu. Atveriet failu teksta redaktorā.

  2. Pārejiet uz --JvmOptions9 rindu un mainiet to uz:

    --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. Saglabājiet izmaiņas.