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.

Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM® i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL en vue du traitement des incidents liés aux applications.

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 du 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. Si un nom d'hôte de serveur ne peut pas être résolu, il est marqué comme étant non disponible pour permettre la poursuite de la configuration. Aucune autre 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 de celui-ci se poursuit.

Par défaut, avec la valeur false, les échecs DNS empêchent l'initialisation du plug-in et les demandes échouent. Cependant, le serveur Web démarre.

Information valeur
Type de données String (chaîne)
Valeut 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.

Information valeur
Type de données Entierr
Valeut 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.

Eviter les incidents Eviter les incidents: Cette zone est désactivée et ne peut pas être modifiée ; la valeur s'affiche à titre d'information.gotcha

Si vous désirez utiliser un autre emplacement, vous devez exécuter à nouveau l'outil de configuration de plug-in (pct) afin de définir le nouvel emplacement, puis lancer le script configureWebserver issu du 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.

Information valeur
Type de données String (chaîne)
Valeut 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 distribuées, 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.
Information valeur
Type de données String (chaîne)
Valeur par défaut Aucun

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.

Eviter les incidents Eviter les incidents: Cette zone est désactivée et ne peut pas être modifiée ; la valeur s'affiche à titre d'information.gotcha

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.

Eviter les incidents Eviter les incidents: Cette zone est désactivée et ne peut pas être modifiée ; la valeur s'affiche à titre d'information.gotcha

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 distribuée, 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 complet du fichier journal dans lequel le plug-in doit consigner ses messages d'erreur.

Information valeur
Type de données String (chaîne)
Valeut 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 : Niveau de détail que le plug-in doit consigner au journal. Indiquez 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][IBM i][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. Sur 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
Information valeur
Type de données String (chaîne)
Valeut par défaut Erreur

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=uwsv_plugin_props
Nom du fichier : uwsv_plugin_props.html