[KB7088] Configurarea Apache Tomcat pentru consola web ESET PROTECT On-Prem utilizând un JDK compatibil (Windows)

Problemă

• Versiunile JDK și Apache Tomcat compatibile cu consola web ESET PROTECT On-Prem
• Schimbarea distribuției JDK utilizate de Apache Tomcat pentru consola web ESET PROTECT On-Prem
• Instalați Amazon Corretto JDK
• Remediați eroarea „Failed to load data” cu JDK 17 sau o versiune ulterioară

Detalii

Soluție

Versiuni JDK și Apache Tomcat acceptate pentru consola web ESET PROTECT On-Prem

Pentru a rula consola web ESET PROTECT On-Prem, aveți nevoie de un mediu de execuție Java furnizat de un kit de dezvoltare Java (JDK) și de o versiune compatibilă de Apache Tomcat.

Vă recomandăm să instalați:

• Apache Tomcat 9.x. (cea mai recentă versiune stabilă)
• JDK 17 sau 21 (LTS)
  Pentru mai multe informații despre versiunile JDK, consultați secțiunea „Versiuni JDK acceptate ” de mai jos.

Versiuni JDK acceptate

Alternative la Oracle JDK (distribuții gratuite):

• Amazon Corretto 17 sau 21 (LTS)

  Pentru instrucțiuni de instalare, consultați secțiunea Instalarea Amazon Corretto JDK.

• Distribuții bazate pe OpenJDK — de exemplu, Eclipse Temurin 17 sau 21 (LTS)

  Când instalați o distribuție OpenJDK pe Windows folosind un program de instalare .msi, selectați opțiunea de a seta sau de a suprascrie variabila de mediu JAVA_HOME în Expertul de configurare (de obicei în secțiunea Configurare personalizată). Acest lucru asigură că calea de instalare Java este înregistrată în Windows, permițând Apache Tomcat să localizeze JDK-ul.

Schimbarea distribuției JDK utilizate de Apache Tomcat pentru consola web ESET PROTECT On-Prem

1. Accesați folderul Apache Tomcat (de exemplu, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Deschideți folderul bin și localizați fișierul tomcat9w.exe. Faceți dublu clic pe fișier pentru a-l rula. Se va deschide fereastra Proprietăți Apache Tomcat.

2. Faceți clic pe fila General și apoi pe Stop pentru a opri serviciul Apache Tomcat.

3. Dezinstalați JDK-ul actual.

4. Instalați un nou JDK.

5. Reveniți la fereastra „Proprietăți Apache Tomcat” și faceți clic pe fila „Java ”.

6. În câmpul „Java Virtual Machine”, actualizați calea astfel încât să indice fișierul jvm.dll al JDK-ului nou instalat (de exemplu, pentru Amazon Corretto, C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Faceți clic pe fila General și apoi pe Start pentru a porni serviciul Apache Tomcat.

8. Verificați dacă vă puteți autentifica în consola web ESET PROTECT On-Prem.

Instalați JDK-ul Amazon Corretto

1. Descărcați fișierul de instalare .msi pentru Windows al Amazon Corretto 17 sau Amazon Corretto 21.

2. Faceți dublu clic pe fișierul de instalare pentru a începe instalarea.

3. Urmați pașii de instalare.

   Aveți opțiunea de a seta o cale de instalare personalizată. În mod implicit, Amazon Corretto 17 se instalează în C:\Program Files\Amazon Corretto\. Dacă setați o cale personalizată, notați-o pentru pasul următor.

4. După finalizarea instalării, setați variabilele de mediu JAVA_HOME și PATH.

   • Setați JAVA_HOME la directorul de instalare al Amazon Corretto.

     Exemple de căi:

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

     Numerele de versiune pot varia

     Fiecare folder al unei versiuni Amazon Corretto (de exemplu, jdk17.0.17_10) include un număr de compilare care se modifică odată cu lansarea noilor versiuni. Verificați întotdeauna numele real al folderului după instalare în C:\Program Files\Amazon Corretto.

   • Adăugați %JAVA_HOME%\bin la variabila PATH.

5. Verificați instalarea. În Command Prompt, rulați:

   java -version

   Ar trebui să vedeți următorul rezultat (numerele de compilare pot varia):

   • 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 (build 17.0.17+10-LTS, mod mixt, partajare)
     

   • Amazon Corretto 21:

     versiunea OpenJDK „21.0.9” 21 octombrie 2025 LTS
     Mediul de execuție OpenJDK Corretto-21.0.9.11.1 (versiunea 21.0.9+11-LTS)
     Mașină virtuală OpenJDK 64-Bit Server Corretto-21.0.9.11.1 (versiune 21.0.9+11-LTS, mod mixt, partajare)

Remedierea erorii „Failed to load data” cu JDK 17 sau o versiune ulterioară

Această problemă apare atunci când consola web ESET PROTECT On-Prem rulează pe Apache Tomcat cu versiuni mai noi de JDK (JDK 17 sau o versiune ulterioară). Începând cu Java 9, sistemul Java Platform Module restricționează accesul reflexiv la anumite API-uri interne, de care au nevoie unele biblioteci utilizate de consola web.

Pentru a remedia această problemă, trebuie să adăugați opțiuni speciale --add-opens la configurația Java a Apache Tomcat, astfel încât aceste module să rămână accesibile. Puteți adăuga opțiunile prin configurația serviciului Apache Tomcat (tomcat9w.exe), fișierul catalina.bat sau service.bat.

Adăugați opțiunile --add-opens prin configurarea serviciului Apache Tomcat (tomcat9w.exe)

1. Accesați folderul Apache Tomcat (de exemplu, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Deschideți folderul „bin” și localizați fișierul tomcat9w.exe. Faceți dublu clic pe fișier pentru a-l rula.

2. Faceți clic pe fila „Java ” și adăugați următoarele valori în câmpul „Opțiuni Java 9 ”:

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

   

   Câmpul „Java 9 Options ” conține acum următoarele valori:

   --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. Faceți clic pe OK.

Adăugați opțiunile --add-opens în fișierul catalina.bat

1. Accesați folderul Apache Tomcat (de exemplu, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Deschideți folderul bin și localizați fișierul catalina.bat. Deschideți fișierul într-un editor de text.

2. Localizați secțiunea rem Configure JAVA 9 specific start-up parameters și adăugați următoarele valori:
   

   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"

   Secțiunea „Configurare parametri specifici de pornire pentru JAVA 9 ” conține acum următoarele valori:

   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"
   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. Salvați modificările.

Adăugați opțiunile --add-opens în fișierul service.bat

1. Accesați folderul Apache Tomcat (de exemplu, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Deschideți folderul bin și localizați fișierul service.bat. Deschideți fișierul într-un editor de text.

2. Navigați la linia --JvmOptions9 și modificați-o astfel:

   --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. Salvați modificările.