[KB7088] Configurer Apache Tomcat pour la console Web ESET PROTECT On-Prem à l'aide d'un JDK pris en charge (Windows)

Problème

• Versions prises en charge de JDK et d'Apache Tomcat pour la console Web ESET PROTECT On-Prem
• Changer la distribution JDK utilisée par Apache Tomcat pour la console Web ESET PROTECT On-Prem
• Installer le JDK Amazon Corretto
• Résoudre l’erreur « Échec du chargement des données » avec le JDK 17 ou une version ultérieure

Détails

Solution

Versions prises en charge du JDK et d’Apache Tomcat pour la console Web ESET PROTECT On-Prem

Pour exécuter la console Web ESET PROTECT On-Prem, vous avez besoin d’un environnement d’exécution Java fourni par un kit de développement Java (JDK) et d’une version compatible d’Apache Tomcat.

Nous vous recommandons d'installer :

• Apache Tomcat 9.x. (dernière version stable)
• JDK 17 ou 21 (LTS)
  Pour plus d’informations sur les versions du JDK, consultez la section « Versions du JDK prises en charge » ci-dessous.

Versions JDK prises en charge

Alternatives à Oracle JDK (distributions gratuites) :

• Amazon Corretto 17 ou 21 (LTS)

  Pour obtenir des instructions d’installation, consultez la section « Installer le JDK Amazon Corretto ».

• Distributions basées sur OpenJDK, par exemple Eclipse Temurin 17 ou 21 (LTS)

  Lors de l’installation d’une distribution OpenJDK sous Windows à l’aide d’un programme d’installation .msi, sélectionnez l’option permettant de définir ou de remplacer la variable d’environnement JAVA_HOME dans l’assistant d’installation (généralement sous « Installation personnalisée »). Cela garantit que le chemin d’installation de Java est enregistré dans Windows, ce qui permet à Apache Tomcat de localiser le JDK.

Changer la distribution JDK utilisée par Apache Tomcat pour la console Web ESET PROTECT On-Prem

1. Accédez au dossier Apache Tomcat (par exemple, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Ouvrez le dossier bin et localisez le fichier tomcat9w.exe. Double-cliquez sur ce fichier pour l’exécuter. La fenêtre Propriétés d’Apache Tomcat s’ouvre.

2. Cliquez sur l’onglet « Général », puis sur « Arrêter » pour arrêter le service Apache Tomcat.

3. Désinstallez votre JDK actuel.

4. Installez un nouveau JDK.

5. Revenez à la fenêtre « Propriétés d’Apache Tomcat » et cliquez sur l’onglet « Java ».

6. Dans le champ « Machine virtuelle Java », modifiez le chemin d'accès pour qu'il pointe vers le fichier jvm.dll du JDK nouvellement installé (par exemple, pour Amazon Corretto, C:\Program Files\Amazon Corretto\jdk21.0.9_10\bin\server\jvm.dll).

7. Cliquez sur l’onglet « Général », puis sur « Démarrer » pour lancer le service Apache Tomcat.

8. Vérifiez que vous pouvez vous connecter à votre console Web ESET PROTECT On-Prem.

Installer le JDK Amazon Corretto

1. Téléchargez le fichier d’installation .msi Windows pour Amazon Corretto 17 ou Amazon Corretto 21.

2. Double-cliquez sur le fichier d’installation pour lancer l’installation.

3. Suivez les étapes d’installation.

   Vous avez la possibilité de définir un chemin d'installation personnalisé. Par défaut, Amazon Corretto 17 est installé dans le répertoire C:\Program Files\Amazon Corretto\. Si vous définissez un chemin personnalisé, notez-le pour l'étape suivante.

4. Une fois l'installation terminée, définissez les variables d'environnement JAVA_HOME et PATH.

   • Définissez JAVA_HOME sur le répertoire d’installation d’Amazon Corretto.

     Exemples de chemins d'accès :

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

     Les numéros de build peuvent varier

     Chaque dossier de version d'Amazon Corretto (par exemple, jdk17.0.17_10) comporte un numéro de build qui change à chaque nouvelle version. Vérifiez toujours le nom réel du dossier après l'installation dans C:\Program Files\Amazon Corretto.

   • Ajoutez %JAVA_HOME%\bin à la variable PATH.

5. Vérifiez l'installation. Dans l'invite de commande, exécutez :

   java -version

   Vous devriez voir s'afficher le résultat suivant (les numéros de build peuvent varier) :

   • Amazon Corretto 17 :

     openjdk version « 17.0.17 » 21/10/2025 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, mode mixte, partage)
     

   • Amazon Corretto 21 :

     version openjdk « 21.0.9 » 21/10/2025 LTS
     Environnement d'exécution OpenJDK Corretto-21.0.9.11.1 (build 21.0.9+11-LTS)
     Machine virtuelle OpenJDK 64 bits pour serveurs Corretto-21.0.9.11.1 (build 21.0.9+11-LTS, mode mixte, partage)

Correction de l’erreur « Échec du chargement des données » avec le JDK 17 ou une version ultérieure

Ce problème survient lorsque la console Web ESET PROTECT On-Prem s’exécute sur Apache Tomcat avec des versions récentes du JDK (JDK 17 ou version ultérieure). À partir de Java 9, le système de modules de la plate-forme Java (Java Platform Module System) restreint l’accès par réflexion à certaines API internes, dont certaines bibliothèques utilisées par la console Web ont besoin.

Pour résoudre ce problème, vous devez ajouter des options spéciales --add-opens à la configuration Java d’Apache Tomcat afin que ces modules restent accessibles. Vous pouvez ajouter ces options via la configuration du service Apache Tomcat (tomcat9w.exe), le fichier catalina.bat ou service.bat.

Ajoutez les options --add-opens via la configuration du service Apache Tomcat (tomcat9w.exe)

1. Accédez au dossier Apache Tomcat (par exemple, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Ouvrez le dossier « bin » et localisez le fichier tomcat9w.exe. Double-cliquez sur le fichier pour l'exécuter.

2. Cliquez sur l’onglet « Java » et ajoutez les valeurs suivantes dans le champ « Options Java 9 » :

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

   

   Le champ « Options Java 9 » contient désormais les valeurs suivantes :

   --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. Cliquez sur OK.

Ajoutez les options --add-opens dans le fichier catalina.bat

1. Accédez au dossier Apache Tomcat (par exemple, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Ouvrez le dossier bin et localisez le fichier catalina.bat. Ouvrez le fichier dans un éditeur de texte.

2. Recherchez la section « rem Configurer les paramètres de démarrage spécifiques à JAVA 9 » et ajoutez les valeurs suivantes :
   

   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 section « Configurer les paramètres de démarrage spécifiques à JAVA 9 » contient désormais les valeurs suivantes :

   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"
   définir « JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED »

3. Enregistrez les modifications.

Ajoutez les options --add-opens dans le fichier service.bat

1. Accédez au dossier Apache Tomcat (par exemple, C:\Program Files\Apache Software Foundation\Tomcat 9.0). Ouvrez le dossier bin et localisez le fichier service.bat. Ouvrez le fichier dans un éditeur de texte.

2. Recherchez la ligne --JvmOptions9 et remplacez-la par :

   --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. Enregistrez les modifications.