[AIX Solaris HP-UX Linux Windows][IBM i]

Configuration des plug-ins

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 le fichier de configuration des plug-ins.

Configurations prises en charge Configurations prises en charge: Cet outil est pris en charge uniquement sous AIX, Linux et Windows. Au lieu d'utiliser l'outil de configuration des plug-ins de 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.sptcfg
Avant de commencer : Les fichiers de configuration des plug-ins et du serveur Web sont mis à jour lors de la configuration des plug-ins. 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 plug-ins 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.
Avertissement : Lorsque Web Server Plug-ins Configuration Tool est utilisé pour configurer le serveur d'administration IBM® HTTP Server, l'outil de personnalisation WebSphere Customization Toolbox doit être exécuté en tant que compte "local" avec des privilèges administrateur/superutilisateur.

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

Configurations prises en charge Configurations prises en charge: L'outil Web Server Plug-ins Configuration Tool est conçu pour être utilisé avec le profil WebSphere Application Server complet. Il n'est pas requis ni pris en charge pour être utilisé dans 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 de serveur Web pour le profil Liberty, consultez l'article Configuration du profil Liberty avec un plug-in de serveur Web.sptcfg

Flux de configuration pour le produit Network Deployment

Web Server Plug-ins Configuration Tool résout toutes les configurations du serveur Web et WebSphere Application Server dans trois scénarios : serveur d'applications distant, serveur d'applications réparti local et 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 la logique de structure des plug-ins

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 le Outil de gestion de profil n'a pas encore créé de profil, le scénario pris en compte est celui d'une installation distante.
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 correspondre à une installation distante.
Profile_type?
Web Server Plug-ins Configuration Tool ne peut configurer qu'un seul profil à la fois. Les trois chemins suivants montrent la différence de traitement existant d'un type de profil à l'autre.
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 machne 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 machne 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.

Web Server Plug-ins Configuration Tool 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 le scénario 2.
Tableau 1. Configuration possible pour le scénario de serveur d'applications local autonome.    
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.

Voir le scénario 3 pour la description de ce type de noeud.

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 :

  1. Démarrez le serveur Web en suivant la procédure correspondant à votre serveur Web.
    Par exemple, lancez le serveur IBM HTTP à partir d'une ligne de commande :
    • [AIX][HP-UX][Linux][Solaris]./racine_IHS/bin/apachectl start
    • [Windows]racine_IHS\bin\apache
  2. Démarrez le serveur d'applications.
    Modifiez les répertoires en fonction du répertoire racine_profil/bin et exécutez la commande startServer :
    • [AIX][HP-UX][Linux][Solaris]./racine_profil/bin/startServer.sh server1
    • [Windows]racine_profil\bin\startServer server1
    Ouvrez la console d'administration et enregistrez la nouvelle configuration.
  3. Indiquez l'adresse http://localhost:9080/snoop dans votre navigateur pour tester le transport HTTP interne fourni par le serveur d'applications. Indiquez http://Nom_hôte_serveur_Web/snoop dans le navigateur pour tester le plug-in du serveur Web.
  4. 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 configurenom_serveur_web à la place dans le répertoire racine_plug-ins/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'applications lorsque vous exécuterez le script. 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. 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 avoir installé le plug-in binaire du serveur Web local, vous devez exécuter le script pour pouvoir 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'est pas créé tant que le script configurenom_serveur_Web n'est pas exécuté.
Tableau 2. Configurations possibles 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 N/A
Profil personnalisé Non fédéré Par script N/A
Profil personnalisé Fédéré Par script N/A
Profil de gestionnaire de déploiement avec un noeud géré (profil réparti) N/A Par script N/A

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 :

  1. Lancez le gestionnaire de déploiement.
  2. 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.
  3. 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 racine_plug-in/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 :
      • [AIX][HP-UX][Linux][Solaris]./configurenom_serveur_Web.sh
      • [Windows]configurenom_serveur_Web.bat
      Remarque : La valeur webserverNodeName dans le script provient d'une concaténation de l'alias 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.

  4. Démarrez le serveur Web en suivant la procédure correspondant à votre serveur Web.
    Par exemple, lancez le serveur IBM HTTP à partir d'une ligne de commande :
    • [AIX][HP-UX][Linux][Solaris]./racine_IHS/bin/apachectl start
    • [Windows]racine_IHS\bin\apache
  5. Démarrez le serveur d'applications.
    Modifiez les répertoires en fonction du répertoire racine_profil/bin et exécutez la commande startServer :
    • [AIX][HP-UX][Linux][Solaris]./racine_profil/bin/startServer.sh server1
    • [Windows]racine_profil\bin\startServer server1
  6. 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.
  7. Indiquez l'adresse http://localhost:9080/snoop dans votre navigateur pour tester le transport HTTP interne fourni par le serveur d'applications. Indiquez http://Nom_hôte_serveur_Web/snoop dans le navigateur pour tester le plug-in du serveur Web.
  8. 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 configurenom_serveur_web à la place.

Web Server Plug-ins Configuration Tool configure le serveur Web pour utiliser le fichier plugin-cfg.xml qui sera géré sur le serveur Web dans le répertoire racine_plug-ins/config/nom_serveur_web. Ce fichier exige une propagation périodique. La propagation consiste à copier le fichier plugin-cfg.xml actuel depuis le serveur d'applications pour remplacer le fichier racine_plug-in/config/nom_serveur_web/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 possibles 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 N/A Par script N/A
Aucun profil N/A Par script N/A
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 N/A Par script N/A

La présentation suivante montre la procédure de vérification du fichier temporaire racine_plug-ins/config/nom_serveur_web/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.

  1. Démarrez le serveur Web en suivant la procédure correspondant à votre serveur Web.
    Par exemple, lancez le serveur IBM HTTP à partir d'une ligne de commande :
    • [AIX][HP-UX][Linux][Solaris]./racine_IHS/bin/apachectl start
    • [Windows]racine_IHS\bin\apache
  2. Démarrez le serveur d'applications à partir de la machine distante.
    Accédez au répertoire racine_profil/bin et exécutez la commande startServer :
    • [AIX][HP-UX][Linux][Solaris]./racine_profil/bin/startServer.sh server1
    • [Windows]racine_profil\bin\startServer server1
  3. Indiquez l'adresse http://localhost:9080/snoop dans votre navigateur pour tester le transport HTTP interne fourni par le serveur d'applications. Indiquez http://Nom_hôte_serveur_Web/snoop dans le navigateur pour tester le plug-in du serveur Web.
  4. 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.
  1. Démarrez le gestionnaire de déploiement si vous le configurez ou si vous configurez un noeud géré.
  2. 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.
  3. 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 racine_plug-in/bin dans le répertoire distant racine_serveur_applications/bin.
      2. Ouvrez une fenêtre de commande et exécutez le script suivant :
        • [AIX][HP-UX][Linux][Solaris]./configurenom_serveur_Web.sh
        • [Windows]configurenom_serveur_Web.bat
      Remarque : La valeur webserverNodeName dans le script provient d'une concaténation de l'alias 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 avez appelé 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 (Java™Management Extensions) par défaut, modifiez le script en y incluant les paramètres appropriés.

  4. 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.
  5. Copiez le fichier actuel de configuration des plug-in, plugin-cfg.xml, dans le répertoire racine_profil/config/cells/ nom_cellule/nodes/nom_serveur_Web_node/servers/nom_serveur_Web. Collez le fichier sur le serveur Web pour remplacer le fichier temporaire racine_plug-ins/config/nom_serveur_web/plugin-cfg.xml. Le serveur IBM HTTP prend en charge la propagation automatique, D'autres serveurs Web nécessitent une propagation manuelle.
  6. Démarrez le serveur Web en suivant la procédure correspondant à votre serveur Web.
  7. Indiquez l'adresse http://localhost:9080/snoop dans votre navigateur pour tester le transport HTTP interne fourni par le serveur d'applications. Indiquez http://Nom_hôte_serveur_Web/snoop dans le navigateur pour tester le plug-in du serveur Web.
  8. Vérifiez que les deux adresses affichent la page Snoop Servlet - Informations de demande/client.

En résumé, trois scénarios existent pour les plug-ins de serveurs 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 le serveur d'applications, vous devez copier le fichier vers le serveur Web. Ce processus est appelé "propagation". La propagation est réservée au scénario de configuration de plug-in à distance, à 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é. La différence entre le scénario 2 et le scénario 1 de cette rubrique réside dans le type de noeud. 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 de chaque configuration décrite dans cet article est indiqué dans le tableau suivant :
Tableau 4. Emplacements du fichier de configuration de plug-in. Ce tableau décrit les emplacements des fichiers de configuration de plug-in.
Scénario Type de profil Emplacement du fichier plugin-cfg.xml
racine_plug-ins racine_profil : dans le noeud géré racine_profil : 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é X    
Légende :
racine_plug-ins
racine_plug-ins
/config/web_server_name/plugin-cfg.xml
racine_profil : dans le noeud géré
profile_root/config/cells/cell_name/nodes/node_name_of_AppServer/servers/web_server_name/plugin-cfg.xml
racine_profil : dans le noeud de serveur Web
profile_root/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name/plugin-cfg.xml

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=cins_webplugins
Nom du fichier : cins_webplugins.html