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.
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 |
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. |
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.
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 |
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.
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.
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.
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.
Type de données | Chaîne |
Valeur par défaut | Aucune |
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.
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.
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. |
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.
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.