Propriétés de plug-in de serveur Web

Cette page permet d'afficher ou de modifier les paramètres du fichier de configuration d'un plug-in de serveur Web. Le fichier de configuration du plug-in, plugin_cfg.xml, fournit les propriétés nécessaires pour établir des communications entre le serveur Web et le serveur d'applications.

Pour afficher cette page de la console d'administration, cliquez sur Serveurs > Types de serveurs > Serveurs Web > nom_serveur_web > Propriétés du plug-in.

L'onglet Configuration comporte des zones modifiables. L'onglet Exécution comporte des informations en lecture seule.

L'onglet Exécution est disponible uniquement lorsque ce serveur Web a accédé aux applications exécutées sur des serveurs d'applications et qu'un fichier http_plugin.log existe.

Ignorer les erreurs DNS lors du démarrage du serveur Web

Indique si le plug-in ignore les échecs DNS dans une configuration lors de son lancement.

Cette zone correspond à l'élément IgnoreDNSFailures dans le fichier plugin-cfg.xml.

Lorsque la valeur true est définie, le plug-in ignore les échecs DNS dans une configuration et peut être lancé avec succès si un serveur au moins du groupe ServerCluster est capable de résoudre le nom d'hôte. Tout serveur dont le nom d'hôte ne peut pas être résolu est marqué comme étant non disponible pendant la durée de vie de la configuration. Aucune tentative visant à résoudre le nom d'hôte ne sera effectuée ultérieurement lors du routage des demandes. En cas d'échec DNS, un message est enregistré dans le fichier journal du plug-in et l'initialisation du plug-in se poursuit sans compromettre le démarrage du serveur Web. Si la valeur false est indiquée, l'échec DNS empêche le serveur de démarrer.

Type de données Chaîne
Valeur par défaut false
Régénérer l'intervalle de configuration

Définit l'intervalle, en secondes, auquel le plug-in doit vérifier le fichier de configuration pour déterminer si des mises à jour ou des modifications ont été effectuées. Le plug-in recherche les modifications apportées au fichier depuis le dernier chargement de la configuration du plug-in.

Dans un environnement de développement dans lequel les modifications sont fréquentes, il est recommandé d'indiquer une valeur inférieure à celle définie par défaut, à savoir 60 secondes. En production, une valeur supérieure à la valeur par défaut est conseillée car les mises à jour de la configuration sont moins fréquentes. Si le rechargement du plug-in échoue pour une raison quelconque, un message est enregistré dans le fichier journal du plug-in et la configuration antérieure est utilisée jusqu'à ce que le fichier de configuration du plug-in soit rechargé. Si les modifications apportées à la configuration de votre plug-in ne sont pas visibles, consultez le fichier journal du plug-in pour obtenir des informations sur l'incident.

Type de données Entier
Valeur par défaut 60 secondes.
Nom du fichier de configuration du plug-in

Indique le nom du fichier de configuration du plug-in. Par défaut, le serveur d'applications génère le fichier plugin-cfg.xml. Le fichier de configuration identifie les applications, les serveurs d'applications, les clusters et les ports HTTP du serveur Web. Le serveur Web utilise le fichier pour accéder aux applications déployées sur plusieurs serveurs d'applications.

Remarque : La zone "Nom de fichier de configuration du plug-in" est désactivée et ne peut pas être modifiée ; elle s'affiche à titre d'information.

Si vous voulez utiliser un emplacement différent, réexécutez le programme d'installation du plug-in et exécutez le nouveau script configureWebserver produit par le processus d'installation sur l'ordinateur du serveur WebSphere Application Server.

Si vous sélectionnez le plug-in du serveur Web lors de l'installation, le programme d'installation configure le serveur Web pour identifier l'emplacement du fichier plugin-cfg.xml. Le fichier de configuration du plug-in est installé par défaut dans le répertoire racine_plugins/config/nom_serveur_web.

Le programme d'installation ajoute une directive à la configuration du serveur Web pour indiquer l'emplacement du fichier plugin-cfg.xml.

Pour les serveurs Web éloignés, vous devez copier le fichier disponible dans le répertoire local où le serveur d'applications est installé et le placer sur le système éloigné. Cette opération est appelée "propagation" du fichier de configuration du plug-in. Si vous utilisez IBM HTTP Server V6.1 ou supérieure comme serveur Web, WebSphere Application Server peut automatiquement propager le fichier de configuration du plug-in aux machines distantes dès lors qu'un mécanisme de transport HTTP approprié est disponible.

Vous pouvez cliquer sur Afficher pour afficher une copie du fichier de configuration du plug-in en cours.

Type de données Chaîne
Valeur par défaut plugin-cfg.xml
Générer automatiquement le fichier de configuration du plug-in
Pour générer automatiquement un fichier de configuration de plug-in pour un serveur Web distant :
  • sélectionnez la zone,
  • activez le service de configuration du plug-in.
Lorsque le service de configuration du plug-in est activé, un fichier de configuration de plug-in est automatiquement généré pour un serveur Web dans les cas suivants :
  • L'administrateur de WebSphere Application Server définit le nouveau serveur Web.
  • Une application est déployée sur un serveur d'applications.
  • Une application est désinstallée.
  • Une définition d'hôte virtuel est mise à jour et sauvegardée.

Par défaut, cette zone est cochée. Désélectionnez la case pour générer manuellement un fichier de configuration de plug-in pour ce serveur Web.

[AIX Solaris HP-UX Linux Windows] Important : Lorsque le fichier de configuration du plug-in est généré, il n'inclut pas admin_host dans la liste des hôtes virtuels. L'article du centre de documentation "Autoriser les serveurs Web à accéder à la console d'administration" explique comment ajouter admin_host à la liste des hôtes virtuels.
Propager automatiquement le fichier de configuration du plug-in
Détermine si le serveur d'applications doit transmettre automatiquement une copie du fichier de configuration du plug-in modifié à un serveur Web :
  • sélectionnez la zone,
  • activez le service de configuration du plug-in.
  • Dans un environnement Network Deployment, un agent de noeud WebSphere Application Server doit se trouver sur le noeud qui héberge le serveur Web associé au fichier de configuration du plug-in modifié.
Par défaut, cette zone est cochée.
Remarque : Le fichier de configuration du plug-in ne peut être propagé automatiquement à un serveur Web distant que si celui-ci est un serveur IBM HTTP Server Version 6.1 ou ultérieur, et si son serveur d'administration est en cours d'exécution.

Comme le service de configuration du plug-in s'exécute en arrière-plan et n'est pas attaché à la console d'administration, cette dernière ne peut pas afficher le résultat de la propagation automatique.

[AIX Solaris HP-UX Linux Windows] Dans le cas des plateformes réparties, vous pouvez consulter les messages associés dans le fichier SystemOut.log du gestionnaire de déploiement pour vérifier que la propagation automatique s'est déroulée correctement.

[z/OS] Dans le cas de la plateforme z/OS, vous pouvez consulter les messages associés dans le journal TSO JOB pour vérifier que la propagation automatique s'est déroulée correctement.

Nom du fichier de clés du plug-in
Indique le chemin d'accès complet du répertoire et le nom du fichier de la base de données contenant les fichier de clés de sécurité utilisés par le serveur Web pour les requêtes HTTPS. Ce fichier se trouve sur le serveur Web associé à ce plug-in de serveur Web. Après avoir indiqué le chemin d'accès du répertoire et le nom de fichier de la base de données, vous pouvez :
  • Cliquez sur Gérer des clés et des certificats pour mettre à jour ce fichier.
  • Cliquez sur Copier vers le répertoire du magasin de clés du serveur Web pour ajouter une copie de ce fichier au répertoire du fichier de clés du serveur Web.
Type de données Chaîne
Valeur par défaut Aucune
Nom de fichier et répertoire de configuration du plug-in

Indique le chemin qualifié complet de la copie serveur Web du fichier de configuration du plug-in de serveur Web. Ce chemin est le nom et l'emplacement du fichier sur le système où est exécuté le serveur Web.

Nom de fichier et répertoire du magasin de clés du plug-in

Indique le chemin d'accès complet de la copie du serveur Web du fichier de base de données contenant les fichiers de clés de sécurité. Ce chemin est le nom et l'emplacement du fichier sur le système où est exécuté le serveur Web.

Journalisation du plug-in

Définit l'emplacement et le nom du fichier http_plugin.log. Définit également le champ d'application des messages dans le journal.

Le journal décrit l'emplacement et le niveau des messages que le plug-in consigne. Dans certains cas, si aucun journal n'est spécifié dans le fichier de configuration, les messages sont consignés dans le journal d'erreurs du serveur Web.

Sur une plateforme répartie, le système crée le fichier si celui-ci n'existe pas. S'il existe déjà, il est ouvert en mode ajout et les messages consignés préalablement sont conservés dans le journal.

Nom du fichier journal : Chemin d'accès complet au fichier journal dans lequel le plug-in doit consigner les messages d'erreur.

Type de données Chaîne
Valeur par défaut racine_plugins/logs/nom_serveur_web/http_plugin.log

Indiquez le chemin d'accès au fichier http_plugin.log.

Niveau de journalisation : Il s'agit du niveau d'information des messages que le plug-in doit consigner dans le journal. Vous pouvez indiquer l'une des valeurs suivantes pour cet attribut :
  • Trace. Toutes les étapes du processus de demande sont consignées en détail.
  • Stats. Le serveur sélectionné pour chaque demande, ainsi que d'autres informations d'équilibrage de charge liées à la gestion des demandes, sont consignés.
  • Warn. Tous les messages d'avertissement et d'erreur résultant d'un traitement incorrect des demandes sont consignés.
  • Error. Seuls les messages d'erreur résultant d'un traitement incorrect des demandes sont consignés.
  • Debug. Consignation de toutes les étapes cruciales effectuées lors du traitement des requêtes.
  • Detail. Toutes les informations sur les demandes et les réponses sont consignées.

Si le niveau de journalisation n'est pas défini, la valeur par défaut Erreur est utilisée.

Réfléchissez bien avant d'appliquer le niveau Trace. De nombreux messages sont consignés à ce niveau et peuvent rapidement entraîner la saturation de l'espace disque et du système de fichiers. Le paramètre Trace ne doit jamais être utilisé dans un environnement opérationnel normal car il réduit les performances.

[AIX Solaris HP-UX Linux Windows] [iSeries] [z/OS] Important : Lorsque le serveur Web et le plug-in du serveur Web sont exécutés sur un système AIX, HP-UX, Linux ou Solaris, si vous modifiez le niveau de journalisation dans le fichier plugin-cfg.xml, la modification n'est pas appliquée de façon dynamique. Vous devez redémarrer le serveur Web pour appliquer la modification. Pour Solaris, par exemple, si vous ne redémarrez pas le serveur Web, le message d'erreur suivant apparaît dans le fichier racine_plugin/logs/http_plugin.log :
ERROR: ws_config_parser:handleLogEnd: Failed to open log file 
'/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS
Type de données Chaîne
Valeur par défaut Erreur



Les liens marqués (en ligne) requièrent un accès à Internet.

Tâches associées
Référence associée
Propriétés d'optimisation des demandes et des réponses d'un plug-in de serveur Web
Propriétés de mise en cache d'un plug-in de serveur Web
Propriétés d'acheminement des demandes de plug-in de serveur Web


Nom du fichier : uwsv_plugin_props.html