Configuration des plug-in

Web Server Plug-ins Configuration Tool configure un serveur d'applications pour un type de serveur Web et crée une définition de serveur Web dans la configuration du serveur d'applications. Prenez connaissance des différents chemins de traitement que peut utiliser Web Server Plug-ins Configuration Tool.

Cette rubrique décrit les trois manières dont Web Server Plug-ins Configuration Tool peut configurer un serveur Web et créer le fichier plugin-cfg.xml qui est un fichier de configuration de plug-in.

Configurations prises en charge: Cet outil est pris en charge uniquement sous AIX®, Linux®et Windows. Au lieu d'utiliser l'outil de configuration de plug-in du serveur Web, vous pouvez vous servir de l'outil de ligne de commande pct avec un fichier de réponses pour configurer un serveur Web. Pour plus d'informations, voir la rubrique Configuration d'un plug-in de serveur Web à l'aide de l'outil pct.

Avant de commencer: Les fichiers de configuration des plug-in et du serveur Web sont mis à jour lors de la configuration des plug-in. Si vous utilisez l'outil de configuration des plug-ins du serveur Web ou l'outil de ligne de commande pct en tant qu'utilisateur non superutilisateur, vérifiez que vous disposez des droits appropriés permettant de mettre à jour les fichiers de configuration des plugs-in de serveur Web et les fichiers de configuration de votre serveur Web (IHS, par exemple) avant de commencer une configuration, plus particulièrement si vous n'êtes pas le propriétaire de ces fichiers.

Attention: Lorsque vous utilisez l'outil de configuration des plug-in de serveur Web pour configurer le serveur d'administration IBM® HTTP Server , WebSphere Customization Toolbox doit être exécuté en tant que compte "local" avec des privilèges d'administrateur ou de superutilisateur.

En outre, le fichier de configuration httpd.conf par défaut doit rester dans le répertoire <IHS_HOME>/conf et vous devez exécuter setupadm manuellement après la configuration d'administration.

Configurations prises en charge: l'outil de configuration des plug-in de serveur Web est destiné à être utilisé avec le profil WebSphere® Application Server complet ; il n'est pas requis ni pris en charge pour la génération d'un plug-in de serveur Web pour le profil Liberty. Pour plus d'informations sur la génération d'un plug-in du serveur Web pour le profil Liberty, consultez la section Configuration du profil Liberty avec un plug-in du serveur Web.

Flux de configuration pour le produit Network Deployment

L'outil de configuration des plug-in de serveur Web résout toutes les configurations d'un serveur Web et de WebSphere Application Server dans trois scénarios: un serveur d'applications distant, un serveur d'applications distribué local et un serveur d'applications autonome local. La logique mise en oeuvre pour déterminer le scénario à appliquer à une configuration est illustrée par le diagramme suivant.

Flux de plug-in de la logique de conception

Légende :

Type d'installation: L'installation peut être distante ou locale.
Lorsque le serveur Web et le serveur d'applications ne se trouvent pas sur le même ordinateur, choisissez le scénario distant. Lorsqu'ils se trouvent sur le même ordinateur, choisissez le scénario local.
Profil ?: Si le produit est installé mais que l' outil de gestion des profils n'a pas encore créé de profil, le scénario est considéré comme une installation à distance.
Serveur d'applications autonome avec définition de serveur Web?: Si le profil est un serveur d'applications avec une définition de serveur Web existante, l'installation est considérée comme une installation distante.
Profile_type?: Web Server Plug-ins Configuration Tool ne peut configurer qu'un seul profil à la fois. Ces trois chemins montrent comment le traitement varie en fonction des types de profils.
Noeud fédéré: Si le noeud du serveur d'applications est fédéré, Web Server Plug-ins Configuration Tool configure la définition de serveur Web sur le noeud géré. Cette configuration présente des avantages. Supposons que le serveur Web et le noeud géré se trouvent sur une machine distincte. Le fichier plugin-cfg.xml est automatiquement propagé vers le noeud distant au cours de la synchronisation du noeud, car la définition de serveur Web fait partie de la configuration du noeud.
Profil réparti ?: Si le gestionnaire de déploiement a un noeud personnalisé fédéré (profil personnalisé), Web Server Plug-ins Configuration Tool configure la définition de serveur Web sur le noeud géré. Cette configuration présente des avantages. Supposons que le serveur Web et le noeud géré se trouvent sur une machine distincte. Le fichier plugin-cfg.xml est automatiquement propagé vers le noeud distant au cours de la synchronisation du noeud, car la définition de serveur Web fait partie de la configuration du noeud.

L'outil de configuration des plug-ins de serveur Web crée une définition de serveur Web dans le profil du serveur de configuration.

Web Server Plug-ins Configuration Tool configure le serveur Web pour utiliser le fichier plugin-cfg.xml qui se trouve dans le profil du serveur d'applications. Le serveur d'applications autonome régénère le fichier racine_profil/config/cells/nom_cellule/nodes/nom_serveur_Web_node/servers/nom_serveur_Web/plugin-cfg.xml dès qu'un changement affectant les applications déployées survient dans la configuration du serveur d'applications.

Après avoir installé le plug-in binaire du serveur Web local, vous pouvez démarrer le serveur d'applications et le serveur Web immédiatement à la fin de l'installation.

Supposons que vous créiez une définition de serveur Web sur un serveur d'applications autonome, puis fédériez le noeud. La définition de serveur Web n'est pas fédérée dans la cellule, car la définition de serveur Web est définie comme un noeud distinct dans un serveur d'applications autonome. Vous devez recréer la définition de serveur Web sur le noeud géré. Voir Scénario 2.

Tableau 1. Configuration qui se qualifie pour le scénario de serveur d'applications autonome local .
Type de profil	Etat de la fédération	Création automatique de la définition du serveur Web ?	Le serveur Web est-il déjà défini dans la configuration du serveur d'applications ?
Serveur d'applications	Non fédéré	Oui	Non

Un serveur d'applications autonome non fédéré ayant une définition de serveur Web existant doit être traitée comme configuration de plug-in distant.

Une définition de serveur Web sur un serveur d'applications autonome nécessite que Web Server Plug-ins Configuration Tool suive le chemin d'installation. Un serveur d'applications autonome ne peut avoir qu'une seule définition de serveur.

Pour une description de ce type de noeud, voir le scénario 3.

Un serveur d'applications autonome fédéré doit être traité comme une configuration de plug-in répartie locale. Voir le Scénario 2 pour la description de ce type de noeud.

La présentation suivante montre la procédure de vérification de la configuration du serveur Web :

Démarrez le serveur Web en suivant la procédure correspondant à votre serveur.
Par exemple, démarrez IBM HTTP Server à partir d'une ligne de commande:
- ./IHS_root/bin/apachectl start
- racine_IHS\bin\apache
Démarrez le serveur d'applications.
Modifiez les répertoires en fonction du répertoire racine_profil/bin et exécutez la commande startServer :
- ./profile_root/bin/startServer.sh server1
- racine_profil\bin\startServer server1
Ouvrez la console d'administration et enregistrez la nouvelle configuration.
Indiquez l'adresse http://localhost:9080/snoop dans votre navigateur pour tester le transport HTTP interne fourni par le serveur d'applications. Pointez votre navigateur sur http://Host_name_of_Web_server_machine/snoop pour tester le plug-in de serveur Web.
Vérifiez que les deux adresses affichent la page Snoop Servlet - Informations de demande/client.

Web Server Plug-ins Configuration Tool ne crée pas automatiquement une définition de serveur Web dans le profil d'un serveur d'applications fédéré. L'outil crée le script configureweb_server_name à la place dans le répertoire racine_plug-in/bin .

Web Server Plug-ins Configuration Tool configure le serveur Web pour utiliser le fichier plugin-cfg.xml qui sera créé dans le profil du serveur d'application lorsque vous exécuterez le script. Le gestionnaire de déploiement régénère le fichier plugin-cfg.xml dans racine_profil/config/cells/nom_cellule/nodes/nom_noeud/servers/nom_serveur_Web . La régénération a lieu à chaque fois qu'une modification dans la configuration du serveur d'applications affecte des applications déployées sur le noeud géré.

Après installation du plug-in binaire pour le serveur Web local, vous devez exécuter le script avant de démarrer le serveur Web. Le serveur Web a déjà été configuré pour utiliser le fichier plugin-cfg.xml dans la configuration du serveur d'applications. Ce fichier n'existe pas tant que vous n'avez pas exécuté le script configureweb_server_name .

Tableau 2. Configurations qui se qualifient pour le scénario de serveur d'applications distribué local .
Type de profil	Etat de la fédération	Création d'une définition de serveur Web ?	Le serveur Web est-il déjà défini dans la configuration du serveur d'applications ?
profil de serveur d'applications	Fédéré	Par script	Non disponible
profil personnalisé	Non fédéré	Par script	Non disponible
profil personnalisé	Fédéré	Par script	Non disponible
Profil de gestionnaire de déploiement avec un noeud géré (profil réparti)	Non disponible	Par script	Non disponible

La présentation suivante montre la procédure d'exécution de la configuration et la de vérification de la configuration du serveur Web :

Lancez le gestionnaire de déploiement.
Si vous envisagez d'ajouter un noeud de serveur d'applications dans une cellule du gestionnaire de déploiement, pensez à fédérer le noeud avant d'installer les plug-in. Si la définition de serveur existe Web lorsque vous fédérez le noeud, elle est perdue lorsque vous fédérez.
Créez la définition de serveur Web dans le serveur d'applications. Deux options s'offrent à vous :
- Utilisez la console d'administration du gestionnaire de déploiement pour créer une définition de serveur Web pour un noeud géré. Cliquez sur Serveurs > Serveurs Web > Nouveau et utilisez l'assistant de création d'une entrée de serveur web pour créer la définition du serveur Web.
- Exécutez le script pour créer manuellement la définition de serveur Web dans la configuration du gestionnaire de déploiement. Exécutez le script à partir du répertoire plugins_root/bin . Le script peut s'adresser au gestionnaire de déploiement sur la même machine.
  Ouvrez une fenêtre de commande pour exécuter le script suivant :
  - ./configureweb_server_name.sh
  - configureweb_server_name.bat
  Remarque: la valeur webserverNodeNom dans le script est une concaténation du pseudonyme que vous avez choisi pour le serveur Web et du suffixe -node. Elle est créée automatiquement lors de l'installation du plug-in et ne peut pas être modifiée. Par exemple, si vous nommez le serveur Web myserver au cours de l'installation du plug-in, la valeur de la définition du serveur Web associé créée après l'exécution du script est myserver-node.
  
  Si vous avez activé la sécurité ou changé le type de connecteur JMX par défaut, éditez le script en y incluant les paramètres appropriés.
Démarrez le serveur Web en suivant la procédure correspondant à votre serveur.
Par exemple, démarrez IBM HTTP Server à partir d'une ligne de commande:
- ./IHS_root/bin/apachectl start
- IHS_root\bin\apache
Démarrez le serveur d'applications.
Modifiez les répertoires en fonction du répertoire racine_profil/bin et exécutez la commande startServer :
- ./profile_root/bin/startServer.sh server1
- profile_root\bin\startServer server1
Ouvrez la console d'administration du gestionnaire de déploiement. Attendez la synchronisation du noeud et enregistrez la configuration modifiée qui contient la nouvelle définition de serveur Web.
Indiquez l'adresse http://localhost:9080/snoop dans votre navigateur pour tester le transport HTTP interne fourni par le serveur d'applications. Pointez votre navigateur sur http://Host_name_of_Web_server_machine/snoop pour tester le plug-in de serveur Web.
Vérifiez que les deux adresses affichent la page Snoop Servlet - Informations de demande/client.

Web Server Plug-ins Configuration Tool ne crée pas automatiquement une définition de serveur Web dans le profil réparti sur une machine distante. L'outil crée le script configureweb_server_name à la place.

Web Server Plug-ins Configuration Tool configure le serveur Web pour utiliser le fichier plugin-cfg.xml qui sera géré sur la machine du serveur Web dans le répertoire plugins_root/config/web_server_name. Ce fichier exige une propagation périodique. La propagation consiste à copier le fichier plugin-cfg.xml en cours à partir de la machine du serveur d'applications pour remplacer le fichier plugins_root/config/web_server_name/plugin-cfg.xml .

Après avoir installé le plug-in binaire du serveur Web local, vous n'avez pas à exécuter le script avant de démarrer le serveur d'applications et le serveur Web. Dans ce cas, vous ne bénéficiez pas d'une définition de serveur Web dans le noeud du serveur d'applications tant que le script n'est pas exécuté.

Tableau 3. Configurations qui se qualifient pour le scénario de serveur d'applications distant .
Type de profil	Etat de la fédération	Création d'une définition de serveur Web ?	Le serveur Web est-il déjà défini dans la configuration du serveur d'applications ?
Tout profil où qu'il se trouve si vous sélectionnez un type d'installation distante dans Web Server Plug-ins Configuration Tool	Non disponible	Par script	Non disponible
Aucun profil	Non disponible	Par script	Non disponible
Profil de serveur d'applications autonome non fédéré avec une définition de serveur Web existante	Non fédéré	Par script	Oui
Profil de gestionnaire de déploiement sans noeud gérés	Non disponible	Par script	Non disponible

La présentation suivante montre la procédure de vérification du fichier temporaire plugins_root/config/web_server_name/plugin-cfg.xml.

Le serveur Web communique avec le serveur d'applications distant en utilisant le fichier temporaire plugin-cfg.xml.

Si l'affectation du port de transport HTTP du serveur d'applications est autre que 9080, le test a échoué. Passez à la section suivante pour créer la définition de serveur Web sur le serveur d'applications et pour terminer le test de la configuration.

Démarrez le serveur Web en suivant la procédure correspondant à votre serveur.
Par exemple, démarrez IBM HTTP Server à partir d'une ligne de commande:
- ./IHS_root/bin/apachectl start
- racine_IHS\bin\apache
Démarrez le serveur d'applications à partir de la machine distante.
Modifiez les répertoires en fonction du répertoire racine_profil/bin et exécutez la commande startServer :
- ./profile_root/bin/startServer.sh server1
- profile_root\bin\startServer server1
Indiquez l'adresse http://localhost:9080/snoop dans votre navigateur pour tester le transport HTTP interne fourni par le serveur d'applications. Pointez votre navigateur sur http://Host_name_of_Web_server_machine/snoop pour tester le plug-in de serveur Web.
Vérifiez que les deux adresses affichent la page Snoop Servlet - Informations de demande/client.

La présentation suivante montre la procédure d'exécution de la configuration. La configuration n'est pas terminée tant qu'une définition de serveur Web n'a pas été créée dans la configuration du noeud du serveur d'applications. La définition de serveur Web est une élément central dans la régénération d'un fichier de configuration de plug-in valide, plugin-cfg.xml.

Démarrez le gestionnaire de déploiement si vous le configurez ou si vous configurez un noeud géré.
Fédérez un noeud de serveur d'applications distant ou un noeud personnalisé dès à présent si vous envisagez de fédérer le noeud à un moment donné. S'il existe déjà une définition de serveur lorsque vous fédérez le noeud, la définition du serveur Web est perdue.
Créez la définition de serveur Web dans le serveur d'applications. Pour un noeud géré, deux options s'offrent à vous. Optez pour le script dans le cas d'un noeud de gestionnaire de déploiement sans noeuds gérés.
- Utilisez la console d'administration du gestionnaire de déploiement pour créer une définition de serveur Web pour un noeud géré. Cliquez sur Serveurs > Serveurs Web > Nouveau et utilisez l'assistant de création d'une entrée de serveur web pour créer la définition du serveur Web.
- Exécutez le script pour créer la définition de serveur Web dans la configuration du noeud du serveur d'applications :
  1. Copiez le script du répertoire plugins_root/bin vers le répertoire distant racine_serveur_app/bin .
  2. Ouvrez une fenêtre de commande et exécutez le script suivant :
    - ./configureweb_server_name.sh
    - configureweb_server_name.bat
  Remarque: la valeur webserverNodeNom dans le script est une concaténation du pseudonyme que vous avez choisi pour le serveur Web et du suffixe -node. Elle est créée automatiquement lors de l'installation du plug-in et ne peut pas être modifiée. Par exemple, si vous nommez le serveur Web myserver au cours de l'installation du plug-in, la valeur de la définition du serveur Web associé créée après l'exécution du script est myserver-node.
  
  Si vous avez activé la sécurité ou modifié le type de connecteur JMX (Java™ Management Extensions) par défaut, éditez le script et incluez les paramètres appropriés.
Si le noeud est fédéré, ouvrez la console d'administration du gestionnaire de déploiement. Attendez la synchronisation du noeud et enregistrez la configuration modifiée qui contient la nouvelle définition de serveur Web. Si le noeud distant n'est pas fédéré, ouvrez la console d'administration du serveur d'applications et enregistrez la configuration modifiée.
Copiez le fichier de configuration de plug-in en cours, plugin-cfg.xml, dans le répertoire racine_profil/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name . Collez le fichier sur la machine du serveur Web pour remplacer le fichier temporaire plugins_root/config/web_server_name/plugin-cfg.xml. Le serveur HTTP IBM prend en charge la propagation automatique, D'autres serveurs Web nécessitent une propagation manuelle.
Démarrez le serveur Web en suivant la procédure correspondant à votre serveur.
Indiquez l'adresse http://localhost:9080/snoop dans votre navigateur pour tester le transport HTTP interne fourni par le serveur d'applications. Pointez votre navigateur sur http://Host_name_of_Web_server_machine/snoop pour tester le plug-in de serveur Web.
Vérifiez que les deux adresses affichent la page Snoop Servlet - Informations de demande/client.

Pour résumer, il existe trois scénarios pour les plug-in de serveur Web. Chaque scénario dépend d'un emplacement unique pour le fichier de configuration de plug-in plugin-cfg.xml. Le serveur d'applications génère un fichier de configuration de plug-in. Le fichier a pour fonction de publier l'emplacement de tous les éléments de serveur d'applications pertinents pour un serveur Web. Ces éléments incluent les applications, les hôtes virtuels des applications de serveur, les clusters et les membres de cluster, par exemple.

Si le serveur Web ne peut pas accéder au fichier sur la machine du serveur d'applications, vous devez copier le fichier vers le serveur Web. Ce processus s'appelle la propagation. La propagation est réservée au scénario de configuration de plug-in distante, à savoir le scénario 3 dans cette rubrique.

Dans chaque scénario local, le serveur Web peut accéder au fichier plugin-cfg.xml car l'un et l'autre se trouvent sur la même machine. Il existe deux scénarios locaux différents car deux emplacements distincts sont possibles pour le fichier plugin-cfg.xml.

Le schéma de configuration de WebSphere Application Server place le fichier de configuration de plug-in dans une définition de serveur Web qui se trouve dans un noeud de serveur Web ou un noeud géré. Le type de noeud est la différence qui existe entre le scénario 2 et le scénario 1 dans cette rubrique. Toutes les configurations du scénario 2 nécessitent que la définition du serveur Web existe dans un noeud de serveur d'applications géré. Toutes les configurations du scénario 1 ont la définition de serveur Web dans leur propre noeud de serveur Web.

Des options de gestions limitées ne vous permettent pas de créer ou de supprimer la définition de serveur Web dans la console d'administration d'un serveur d'applications autonome. l'impossibilité pour un serveur d'applications autonome de créer une définition de serveur Web constitue la base des scripts de configuration créés par Web Server Plug-ins Configuration Tool. Sans les scripts, vous ne pourriez pas créer de définition de serveur Web aisément sur un noeud de serveur d'applications autonome.

L'emplacement du fichier plugin-cfg.xml pour chaque configuration décrite dans cette rubrique est indiqué dans le tableau suivant :

Tableau 4. Emplacements des fichiers de configuration de plug-in . Ce tableau répertorie les emplacements du fichier de configuration de plug-in.
Scénario	Type de profil	Emplacement du fichier plugin-cfg.xml
Scénario	Type de profil	`racine_plug-in`	`profile_root` : dans le noeud géré	`profile_root` : dans le noeud de serveur Web
1	profil de serveur d'applications			X
2	profil de serveur d'applications		X
	profil personnalisé		X
	Profil de gestionnaire de déploiement avec un noeud géré (profil réparti)		X
3	Tout profil où qu'il se trouve si vous sélectionnez un type d'installation distante dans Web Server Plug-ins Configuration Tool	X
	Aucun profil	X
	Profil de serveur d'applications (autonome) non fédéré avec une définition de serveur Web existante	X
	Profil de gestionnaire de déploiement sans noeud gérés	X

Légende :

racine_plug-in

racine_plug-in

/config/web_server_name/plugin-cfg.xml

profile_root : dans le noeud géré

profile_root/config/cells/cell_name/nodes/node_name_of_AppServer/servers/web_server_name/plugin-cfg.xml

profile_root : dans le noeud de serveur Web

profile_root/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name/plugin-cfg.xml