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

NOTE:

Cette page a été traduite par un ordinateur. Cliquez sur English sous Languages sur cette page pour afficher le texte original. Si vous estimez que quelque chose n'est pas clair, veuillez contacter votre support local.

Problème

Détails

Cliquez pour agrandir

La console Web ESET PROTECT On-Prem fonctionne sur Apache Tomcat, un serveur Web et un conteneur de servlets pour les applications Java. Apache Tomcat n'inclut pas de runtime Java ; il s'appuie sur le runtime Java fourni par un kit de développement Java (JDK). Historiquement, Oracle JDK 8 (Java SE 8) était la version la plus utilisée pour Apache Tomcat, de sorte que de nombreux déploiements en dépendaient.

À partir de janvier 2019, Oracle a modifié ses licences pour Java SE 8. Les mises à jour publiques pour une utilisation professionnelle, commerciale ou de production nécessitent désormais un abonnement payant.

Si vous utilisez Oracle JDK 8 (Java SE 8) et ne disposez pas d'un abonnement Oracle, vous pouvez passer à une alternative gratuite et prise en charge (telle qu'Amazon Corretto).

Cet article couvre les installations Windows. Pour Linux, consultez les guides relatifs à l'installation d'un JDK pour SUSE Linux Enterprise Server ou Debian.

Solution

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

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

Nous 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, voir la section Versions du JDK prises en charge ci-dessous.
Recommandations en matière de compatibilité
  • Supprimer les versions antérieures du JDK : si plusieurs versions du JDK sont installées, désinstallez les versions antérieures et ne conservez que le dernier JDK pris en charge.
  • Correspondance des bits : assurez-vous que le JDK, Apache Tomcat et ESET PROTECT On-Prem utilisent tous la même architecture (64 bits recommandé).
Versions du JDK prises en charge
Versions prises en charge

Seules les versions du JDK bénéficiant d'un support à long terme (LTS) sont prises en charge.

Version JDK prise en charge Version d'ESET PROTECT On-Prem
17
10.x - 13.x
21
11.x - 13.x

Alternatives à Oracle JDK (distributions gratuites) :

  • Amazon Corretto 17 ou 21 (LTS)

    Pour les instructions d'installation, voir 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 Configuration personnalisée). Cela garantit que le chemin d'installation de Java est enregistré dans Windows, ce qui permet à Apache Tomcat de localiser le JDK.

Dépannage de l'erreur "Failed to load data" (Échec du chargement des données)

Si vous rencontrez l'erreur "Failed to load data" lorsque vous utilisez le JDK 17 ou une version ultérieure, reportez-vous à la section Corriger l'erreur "Failed to load data" avec le JDK 17 ou une version ultérieure pour obtenir des conseils.

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

  1. Naviguez jusqu'au dossier Apache Tomcat (par exemple, C:\NProgram Files\NApache Software Foundation\NTomcat 9.0). Ouvrez le dossier bin et localisez tomcat9w.exe. Double-cliquez sur le fichier pour l'exécuter. Les propriétés d'Apache Tomcat s'ouvrent.

  2. Cliquez sur l'onglet Général et cliquez sur Arrêter pour arrêter le service Apache Tomcat.

  3. Désinstallez votre JDK actuel.

  4. Installez un nouveau JDK.

  5. Retournez dans Apache Tomcat Properties et cliquez sur l'onglet Java.

  6. Dans le champ Machine virtuelle Java, mettez à jour le chemin d'accès pour qu'il pointe vers le fichier jvm.dll du JDK nouvellement installé (par exemple, pour Amazon Corretto, C:\NProgram Files\NAmazon Corretto\Njdk21.0.9_10\Nbin\Nserver\Njvm.dll).

  7. Cliquez sur l'onglet Général et cliquez 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 Windows .msi pour Amazon Corretto 17 ou Amazon Corretto 21.

  2. Double-cliquez sur le fichier d'installation pour démarrer l'installation.

  3. Suivez les étapes de l'installation.

    Vous avez la possibilité de définir un chemin d'installation personnalisé. Par défaut, Amazon Corretto 17 est installé dans C:\NProgram Files\NAmazon Corretto\N. Si vous définissez un chemin d'accès 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 :

      • Amazon Corretto 17 : C:\NProgram Files\NAmazon Corretto\Njdk17.0.17_10
      • Amazon Corretto 21 : C:\NProgram Files\NAmazon Corretto\Njdk21.0.9_11

      Les numéros de version peuvent varier

      Chaque dossier de version d'Amazon Corretto (par exemple, jdk17.0.17_10) comprend un numéro de build qui change avec les nouvelles versions. Vérifiez toujours le nom du dossier après l'installation dans C:\Program Files\Amazon Corretto.

    • Ajoutez %JAVA_HOME%\bin à PATH.

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

    java -version

    Vous devriez obtenir le résultat suivant (les numéros de build peuvent varier) :

    • 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, mixed mode, sharing)

    • Amazon Corretto 21 :

      openJDK version "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, mixed mode, sharing)

Correction de l'erreur "Failed to load data" avec le JDK 17 ou plus récent

Ce problème survient lorsque la console Web ESET PROTECT On-Prem s'exécute sur Apache Tomcat avec des versions JDK plus récentes (JDK 17 ou plus). À partir de Java 9, le système de modules de la plate-forme Java restreint l'accès réfléchi à 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 dans la configuration du service Apache Tomcat (tomcat9w.exe), dans le fichier catalina.bat ou service.bat.

Redémarrer le service Apache Tomcat après chaque modification

Vous devez redémarrer le service Apache après chaque modification des fichiers .exe ou .bat. Pour redémarrer le service, procédez comme suit :

  1. Appuyez sur la touche Windows, tapez Service et ouvrez l'application Services.

  2. Cliquez avec le bouton droit de la souris sur Apache Tomcat dans la liste de droite.

  3. Cliquez sur Redémarrer.

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

  1. Naviguez jusqu'au dossier Apache Tomcat (par exemple, C:\NProgram Files\NApache Software Foundation\NTomcat 9.0). Ouvrez le dossier bin et localisez tomcat9w.exe. Double-cliquez sur le fichier pour l'exécuter.

  2. Cliquez sur l'onglet Java et ajoutez les valeurs suivantes au champ Options Java 9:

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

    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.
Ajouter les options --add-opens dans catalina.bat

  1. Naviguez jusqu'au dossier Apache Tomcat (par exemple, C:\NProgram Files\NApache Software Foundation\NTomcat 9.0). Ouvrez le dossier bin et localisez le fichier catalina.bat. Ouvrez le fichier dans un éditeur de texte.

  2. Localisez la section rem Configure JAVA 9 specific start-up parameters 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 rem Configure JAVA 9 specific start-up parameters contient maintenant 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" set "JDK_JAVA_OPTIONS=%JDK_JAVA_OPTIONS% --add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED"

  3. Sauvegardez les modifications.

Ajouter les options --add-opens dans service.bat

  1. Naviguez jusqu'au dossier Apache Tomcat (par exemple, C:\NProgram Files\NApache Software Foundation\NTomcat 9.0). Ouvrez le dossier bin et localisez le fichier service.bat. Ouvrez le fichier dans un éditeur de texte.

  2. Naviguez jusqu'à la ligne --JvmOptions9 et modifiez-la en :

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

Dernière mise à jour: 7 janv. 2026

Ressources supplémentaires:

Aide en ligne

Forum ESET

Vidéos de la base de connaissances
ESET Status Portal ESET Technical Support

Client existant?