[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 deux 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

Web Server Plug-ins Configuration Tool résout toutes les configurations du serveur Web et WebSphere Application Server dans deux scénarios : configuration de plug-in distante et configuration de plug-in locale. 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é et que le profil est supprimé par accident ou manque, le scénario est considéré correspondre à une installation distante. Créez un profil avant d'exécuter le script.
Serveur d'applications autonome avec définition de serveur Web ?
Si le profil a une définition de serveur Web existante, l'installation est considérée correspondre à une configuration de plug-in distante. Un serveur d'applications autonome ne peut pas contenir plusieurs définitions de serveur Web.

Scénario A. Configuration de plug-in autonome locale

Dans ce scénario, Web Server Plug-ins Configuration Tool crée une définition de serveur Web directement dans le profil du serveur d'applications sans utiliser de script.

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 régénère le ficher 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.

Après avoir configuré le serveur d'applications pour le serveur Web local, vous pouvez démarrer le serveur d'applications et le serveur Web immédiatement.
Tableau 1. Configuration possible pour le scénario de serveur d'applications local.    
Type de profil 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 Oui Non

Un profil de serveur d'applications disposant d'une définition de serveur Web doit être traité comme une configuration de plug-in distante. Un serveur d'applications disposant ne peut avoir qu'une seule définition de serveur Web.

Voir le scénario B 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 configuration modifiée.
  3. Indiquez l'adresse http://localhost:9080/snoop dans le 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 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 se trouve 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 2. Configurations possibles pour le scénario de serveur d'applications distant.    
Type de profil 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 Par script N/A
Aucun profil Par script N/A
Profil de serveur d'applications autonome avec une définition de serveur Web existante Par script Oui

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. Créez la définition de serveur Web dans le serveur d'applications.
    Exécutez le script pour créer manuellement 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
    Le script configurenom_serveur_Web peut recevoir trois paramètres : nom_profil, nom_utilisateur_console_admin et mot_de_passe_console_admin.
    • nom_profil indique le nom du profil utilisé pour créer la définition de serveur Web.
    • nom_utilisateur_console_admin indique le nom d'utilisateur de la console d'administration. Le profil avec la console d'administration déployée doit avoir la sécurité de console d'administration activée. Ce paramètre ne peut pas être utilisé si nom_profil n'est pas renseigné.
    • mot_de_passe_console_admin indique le mot de passe associé au nom d'utilisateur. Ce paramètre ne peut pas être utilisé si nom_profil et nom_utilisateur_console_admin ne sont pas définis.
    Remarque : La valeur webserverNodeName 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 au cours de la configuration du plug-in et vous ne pouvez pas la modifier. Par exemple, si vous avez appelé le serveur Web myserver pendant la configuration du plug-in, la valeur associée à sa définition 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.

  2. 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.
  3. Démarrez le serveur Web en suivant la procédure correspondant à votre serveur. Ouvrez la console d'administration et enregistrez la configuration modifiée.
  4. 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.
  5. Vérifiez que les deux adresses affichent la page Snoop Servlet - Informations de demande/client.

En résumé, deux 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. Ce fichier a pour fonction de publier l'emplacement de tous les objets de serveur d'applications pertinents pour un serveur Web et contrôler les options de configuration de plug-in binaire. Le fichier identifie les objets, tels que les applications et les hôtes virtuels des applications de serveur.

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 B dans cette rubrique.

Dans le scénario local, le serveur Web peut accéder au fichier plugin-cfg.xml, car le serveur Web se trouve sur la même machine que le fichier.

Toutes les configurations du scénario A 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 3. 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 de serveur Web
A Profil de serveur d'applications   X
B 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 avec une définition de serveur Web existante X  
Légende :
racine_plug-ins
plugins_root/config/web_server_name/plugin-cfg.xml
racine_profil : dans le noeud du 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-base-dist&topic=cins_webplugins
Nom du fichier : cins_webplugins.html