[KB7088] Configurazione di Apache Tomcat per ESET PROTECT On-Prem Web Console utilizzando un JDK supportato (Windows)

Problema

• Versioni JDK e Apache Tomcat supportate per ESET PROTECT On-Prem Web Console
• Cambiare la distribuzione JDK utilizzata da Apache Tomcat per ESET PROTECT On-Prem Web Console
• Installare il JDK Amazon Corretto
• Correggere l'errore "Failed to load data" con JDK 17 o successivo

Dettagli

Soluzioni

Versioni JDK e Apache Tomcat supportate per ESET PROTECT On-Prem Web Console

Per eseguire ESET PROTECT On-Prem Web Console, è necessario un runtime Java fornito da un Java Development Kit (JDK) e una versione di Apache Tomcat compatibile.

Si consiglia di installare:

• Apache Tomcat 9.x. (ultima versione stabile)
• JDK 17 o 21 (LTS)
  Per ulteriori informazioni sulle versioni JDK, vedere la sezione Versioni JDK supportate di seguito.

Versioni JDK supportate

Alternative a Oracle JDK (distribuzioni non costose):

• Amazon Corretto 17 o 21 (LTS)

  Per le istruzioni di installazione, vedere la sezione Installazione di Amazon Corretto JDK.

• Distribuzioni basate su OpenJDK, ad esempio Eclipse Temurin 17 o 21 (LTS)

  Quando si installa una distribuzione OpenJDK su Windows utilizzando un programma di installazione .msi, selezionare l'opzione per impostare o sovrascrivere la variabile d'ambiente JAVA_HOME nella procedura guidata di installazione (di solito sotto Configurazione personalizzata). Questo assicura che il percorso di installazione di Java sia registrato in Windows, consentendo ad Apache Tomcat di individuare il JDK.

Cambiare la distribuzione JDK utilizzata da Apache Tomcat per la Console Web ESET PROTECT On-Prem

1. Accedere alla cartella Apache Tomcat (ad esempio, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Aprire la cartella bin e individuare tomcat9w.exe. Fare doppio clic sul file per eseguirlo. Si aprirà Apache Tomcat Properties.

2. Fare clic sulla scheda Generale e fare clic su Stop per arrestare il servizio Apache Tomcat.

3. Disinstallare il JDK corrente.

4. Installare un nuovo JDK.

5. Tornare a Proprietà di Apache Tomcat e fare clic sulla scheda Java.

6. Nel campo Java Virtual Machine, aggiornare il percorso per puntare al file jvm.dll del nuovo JDK installato (ad esempio, per Amazon Corretto, C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Fare clic sulla scheda Generale e fare clic su Avvia per avviare il servizio Apache Tomcat.

8. Verificare che sia possibile accedere alla Console Web di ESET PROTECT On-Prem.

Installazione di Amazon Corretto JDK

1. Scaricare il file di installazione .msi per Amazon Corretto 17 o Amazon Corretto 21.

2. Fare doppio clic sul file di installazione per avviare l'installazione.

3. Procedere con le fasi di installazione.

   È possibile impostare un percorso di installazione personalizzato. Per impostazione predefinita, Amazon Corretto 17 viene installato in C:\Program Files\Amazon Corretto\. Se si imposta un percorso personalizzato, prendere nota del percorso per il passaggio successivo.

4. Al termine dell'installazione, impostare le variabili d'ambiente JAVA_HOME e PATH.

   • Impostare JAVA_HOME sulla directory di installazione di Amazon Corretto.

     Esempi di percorsi:

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

     I numeri di build possono variare

     Ogni cartella della versione di Amazon Corretto (ad esempio, jdk17.0.17_10) include un numero di build che cambia con le nuove versioni. Verificare sempre il nome effettivo della cartella dopo l'installazione in C:\Program Files\Amazon Corretto.

   • Aggiungere %JAVA_HOME%\bin al PATH.

5. Verificare l'installazione. Nel prompt dei comandi, eseguire

   java -version

   Si dovrebbe vedere il seguente output (i numeri di build possono variare):

   • Amazon Corretto 17:

     openjdk versione "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, mixed mode, sharing)

   • Amazon Corretto 21:

     openjdk versione "21.0.9" 2025-10-21 LTS OpenJDK Runtime Environment Corretto-21.0.9.11.1 (build 21.0.9+11-LTS) OpenJDK 64-Bit Server VM Corretto-21.0.9.11.1 (build 21.0.9+11-LTS, modalità mista, condivisione)

Correzione dell'errore "Failed to load data" con JDK 17 o successivo

Questo problema si verifica quando ESET PROTECT On-Prem Web Console viene eseguito su Apache Tomcat con versioni JDK più recenti (JDK 17 o successive). A partire da Java 9, il Java Platform Module System limita l'accesso riflessivo a determinate API interne, che alcune librerie utilizzate dalla Console Web richiedono.

Per risolvere questo problema, è necessario aggiungere le opzioni speciali --add-opens alla configurazione Java di Apache Tomcat, in modo che questi moduli rimangano accessibili. È possibile aggiungere le opzioni attraverso la configurazione del servizio Apache Tomcat (tomcat9w.exe), il file catalina.bat o service.bat.

Aggiungere le opzioni --add-opens tramite la configurazione del servizio Apache Tomcat (tomcat9w.exe)

1. Accedere alla cartella Apache Tomcat (ad esempio, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Aprire la cartella bin e individuare tomcat9w.exe. Fare doppio clic sul file per eseguirlo.

2. Fare clic sulla scheda Java e aggiungere i seguenti valori al campo Opzioni Java 9:

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

   

   Il campo Opzioni Java 9 contiene ora i seguenti 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. Fare clic su OK.

Aggiungere le opzioni --add-opens in catalina.bat

1. Accedere alla cartella Apache Tomcat (ad esempio, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Aprire la cartella bin e individuare il file catalina.bat. Aprire il file in un editor di testo.

2. Individuare la sezione Configurare i parametri di avvio specifici di JAVA 9 e aggiungere i seguenti 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"

   La sezione Configura parametri di avvio specifici di JAVA 9 contiene ora i seguenti 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" impostare "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util=ALL-UNNAMED" impostare "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.base/java.util.concurrent=ALL-UNNAMED" impostare "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED"

3. Salvare le modifiche.

Aggiungere le opzioni --add-opens in service.bat

1. Accedere alla cartella Apache Tomcat (ad esempio, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Aprire la cartella bin e individuare il file service.bat. Aprire il file in un editor di testo.

2. Andare alla riga --JvmOptions9 e modificarla in:

   --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. Salvare le modifiche.