![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Configuration du serveur Web
La configuration de plug-in implique de configuer le serveur Web pour utiliser le module de plug-in binaire que fournit WebSphere Application Server. La configuration du plug-in comprend également la mise à jour du fichier de configuration XML du plug-in pour refléter la configuration actuelle du serveur d'applications. Le module binaire utilise le fichier XML pour router les demandes du client Web.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Voir ci-après les descriptions de chaque fichier.
Fichier de configuration du serveur Web
Le fichier de configuration du serveur Web est installé avec le serveur Web.
Web Server Plug-ins Configuration Tool doit reconfigurer le fichier de configuration d'un serveur Web prise en charge.
Fichier de plug-in de serveur Web binaire
Un exemple de module de plug-in binaire est le fichier mod_was_ap22_http.dll pour IBM HTTP Server sur la plateforme Windows.
Un autre exemple de module de plug-in binaire est le programme de service QSVTAP20 de la plateforme IBM i.
Le fichier de plug-in binaire ne change pas. Cela étant, le fichier de configuration pour le plug-in binaire est un fichier XML. Le serveur d'applications modifie le fichier de configuration lorsque certaines modifications surviennent dans la configuration de WebSphere Application Server.
Le module binaire lit le fichier XML afin d'ajuster les paramètres et d'acheminer les requêtes au serveur d'applications.
Fichier de configuration de plug-in, plugin-cfg.xml
Le fichier de configuration de plug-in est un fichier XML que vous pouvez paramétrer dans la console d'administration. Le fichier contient toutes les applications installées dans la définition du serveur Web. Le module binaire lit le fichier XML afin d'ajuster les paramètres et d'acheminer les requêtes au serveur d'applications.
Le serveur d'applications autonome régénère le fichier plugin-cfg.xml dans le répertoire racine_profil/config/cells/nom_cellule/nodes/nom_serveur_Web_node/servers/nom_serveur_Web. La régénération se fait à chaque fois qu'un changement dans la configuration du serveur d'applications affecte des applications déployées.
Le gestionnaire de déploiement régénère le fichier plugin-cfg.xml dans le répertoire racine_profil/config/cells/nom_cellule/nodes/nom_noeud/servers/nom_serveur_Web dès qu'un changement affectant les applications déployées sur le noeud géré survient dans la configuration du serveur d'applications.
Lorsque vous procédez à des modifications dans la configuration du serveur d'applications qui affectent les applications déployées, régénérez le fichier XML de configuration du plug-in.
Après la régénération, propagez (copiez) le fichier vers la machine du serveur Web. Le plug-in binaire peut ensuite accéder à la copie la plus récente de son fichier de configuration.
Le service de configuration de plug-in de serveur Web régénère automatiquement le fichier plugin-cfg.xml après certains événements qui changent la configuration. Ce service propage
automatiquement le fichier plugin-cfg.xml à une machine IBM HTTP Server lorsque
le fichier est régénéré. Vous devez copier manuellement le fichier sur d'autres serveurs Web.
Sur
les systèmes IBM i, le plug-in n'est pas automatiquement généré. Vous devez le régénérer le fichier et le propager manuellement.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Le fichier de configuration de plug-in par défaut, tel que plugin-cfg.xml
Web Server Plug-ins Configuration Tool crée le fichier temporaire plugin-cfg.xml dans le répertoire plugins_root/config/web_server_name. L'outil crée le fichier pour chaque scénario d'installation distante.
Le fichier par défaut est une marque de réservation que vous devez remplacer par le fichier plugin-cfg.xml depuis la définition de serveur Web sur le serveur d'applications. Le fichier par défaut est une réplique du fichier que le serveur d'applications crée pour un serveur d'applications autonome par défaut.
Exécutez le script configureweb_server_name depuis le répertoire app_server_root/bin sur la machine du serveur d'applications pour une installation distante ou directement depuis le répertoire plugins_root/bin pour une installation locale. Le script crée la définition de serveur Web dans les fichiers de configuration du profil par défaut. Modifiez le script configurenom_serveur_Web pour configurer un profil différent de celui défini par défaut. Utilisez le paramètre -profileName pour identifier un profil autre que le profil par défaut.
Une fois que la définition de serveur Web est créée, le service de configuration de plug-in de serveur Web dans le serveur d'applications crée le premier fichier plugin-cfg.xml dans la définition de serveur Web sur la machine du serveur d'applications. Si vous installez une application, créez un hôte virtuel ou exécutez une opération qui change la configuration, vous devez propager le fichier mis à jour plugin-cfg.xml depuis la machine du serveur d'applications vers la machine du serveur Web pour remplacer le fichier par défaut.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Configuration du script web_server_name pour la définition de serveur Web
Web Server Plug-ins Configuration Tool crée le script configureweb_server_name sur la machine du serveur Web dans le répertoire plugins_root/bin. Dans le cas d'une installation à distance, si l'une des machines fonctionne sous un système d'exploitation tel que AIX ou Linux et que l'autre machine fonctionne sous Windows, utilisez le script dans le répertoire racine_plugins/bin/crossPlatformScripts. Ce script n'est créé que dans le cas d'installations distantes.
Copiez le script de la machine du serveur Web vers le répertoire app_server_root/bin sur la machine d'un serveur d'applications distant. Il n'est donc pas nécessaire de copier le script sur une installation locale. Exécutez le script pour créer une définition de serveur Web dans la configuration du serveur d'applications.
En effet, un conflit peut survenir entre une variable d'environnement shell, la variable d'environnement WAS_USER_SCRIPT et le profil par défaut. Le script fonctionne toujours d'après le profil par défaut. Si la variable d'environnement WAS_USER_SCRIPT est définie, un conflit se produit, car le script tente d'utiliser le profil identifié par la variable.
Cette variable se définit facilement par erreur. Emettez n'importe quelle commande à partir du répertoire racine_profil/bin de n'importe quel profil et la variable sera définie pour ce profil.
Si votre système comporte plusieurs profils, il est probable que le profil par défaut et celui que la variable identifie sont différents. Dans ce cas, un conflit se produit et le script peut ne pas créer la définition de serveur Web dans le profil correct ou la définition de serveur Web.
S'il existe déjà une définition de serveur Web pour un serveur d'applications autonome, l'exécution du script n'ajoute pas une nouvelle définition de serveur Web. Chaque serveur d'applications autonome ne peut avoir qu'une seule définition de serveur Web.
Un noeud géréé, en revanche, peut avoir plusieurs définitions de serveur Web. Le script crée une définition de serveur Web si le nom du serveur Web n'est pas identique.
![[IBM i]](../images/iseries.gif)
Script de configuration pour la définition de serveur Web
La configuration du serveur Web avec le script configureOs400WebserverDefinition ou en utilisant l'interface graphique IBM i Administrative crée le script configureweb_server_name sur la machine du serveur Web dans le répertoire plugins_root/bin. Ce script n'est créé que dans le cas d'installations distantes.
Copiez le script de la machine du serveur Web vers le répertoire app_server_root/bin dans la partition IBM i. Exécutez le script pour créer une définition de serveur Web dans la configuration du serveur d'applications.
S'il existe déjà une définition de serveur Web pour un serveur d'applications autonome, l'exécution du script n'ajoute pas une nouvelle définition de serveur Web. Un serveur d'applications autonome ne peut avoir qu'une seule définition de serveur Web.
Vous pouvez également utiliser les scripts configureOs400WebServerDefinition et removeOs400WebServerDefinition pour réaliser ces tâches.
Un noeud géré, en revanche, peut avoir plusieurs définitions de serveur Web. Le script crée une définition de serveur web si le nom du serveur Web n'est pas identique.
Remplacement du fichier de configuration de plug-in par défaut par le fichier provenant de la définition de serveur Web (propagation)
Le fichier par défaut utilise des valeurs de paramètre fixes, valeurs susceptibles de ne pas correspondre à celles du fichier présent sur le serveur d'applications. Le fichier par défaut est uniquement une marque de réservation et
ne peut refléter les modifications survenues dans la configuration du serveur d'applications. Le fichier peut aussi ne pas refléter les valeurs non implicites qui peuvent être actives sur le serveur d'applications.
Les valeurs ci-après doivent figurer dans le fichier actif plugin-cfg.xml du serveur d'applications. Dans ce cas, le fichier par défaut est capable de configurer correctement le module de plug-in binaire. Le module de plug-in peut communiquer alors avec le serveur Web et le serveur d'applications.
Supposons que les valeurs ci-après ne figurent pas dans le fichier actif plugin-cfg.xml du serveur d'applications. Le fichier par défaut ne configure alors pas le module de plug-in binaire correctement.
Le module de plug-in peut toujours communiquer avec le serveur Web. Avec un fichier de configuration inapproprié, il ne peut communiquer correctement avec le serveur d'applications.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)