WebSphere Application
Server fournit un plug-in de serveur Web que vous pouvez configurer afin de communiquer avec une marque particulière de serveur Web. Apprenez à installer le serveur Web et le plug-in de serveur Web pour WebSphere Application
Server sur une machine et à configurer le serveur d'applications dans le profil par défaut sur une autre machine afin de communiquer avec le
serveur Web.
Avant de commencer
Lorsqu'il existe plusieurs profils, vous pouvez sélectionner le profil
configuré par l'outil de configuration des plug-ins de serveur Web. Pour une description du flux de logique qui détermine comment sélectionner le profil à configurer, voir Configuration des plug-ins.
Lorsqu'il existe plusieurs profils, vous pouvez sélectionner le profil
configuré par l'outil de configuration des plug-ins de serveur Web. Pour une description du flux de logique qui détermine comment sélectionner le
profil à configurer, voir Configuration des plug-ins.
Si la famille de produits WebSphere Application Server
prend en charge une marque spécifique de serveur Web tel qu'IBM® HTTP Server ou Microsoft Internet Information Services
(IIS), un plug-in binaire est fourni par votre produit WebSphere Application
Server pour le serveur Web que vous devez installer.
Si la famille de produits WebSphere Application Server ne fournit pas
de plug-in binaire pour une marque spécifique de serveur web, celui-ci ne sera pas pris en charge. L'objectif du plug-in binaire est de fournir le protocole de communication entre le serveur Web et le serveur d'applications.
Supposons
que vous créez un profil et que vous souhaitez également utiliser un serveur Web. Vous devez installer
un nouveau serveur Web pour le nouveau profil, installer les plug-ins du serveur Web
et utiliser l'outil de configuration des plug-ins du serveur Web pour configurer le
serveur Web ainsi que le serveur d'applications.
Si le serveur Web n'est pas encore installé, vous pouvez installer les plug-ins du serveur Web pour usage ultérieur.
Pourquoi et quand exécuter cette tâche
L'installation
des plug-ins du serveur Web installe le module plug-in. L'outil de configuration des
plug-ins du serveur Web configure le serveur Web pour qu'il communique
avec le serveur d'applications et crée une définition de configuration du serveur Web
dans le serveur d'applications, si possible.
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
Configuration d'un plug-in de serveur Web à l'aide de l'outil pct.
sptcfg
Cette procédure configure le profil du serveur d'applications qui est celui par défaut sur la machine. Il existe une relation univoque entre un serveur Web et le serveur
d'applications.
Cette rubrique décrit comment créer la topologie suivante :
Avertissement : Si vous planifiez d'ajouter le noeud de serveur d'applications dans une cellule de gestionnaire de déploiement mais que ce n'est pas encore fait, lancez le gestionnaire de déploiement et fédérez le noeud avant de configurer le plug-in.
Vous ne pouvez pas ajouter un serveur d'applications avec une définition de serveur Web dans la cellule de gestionnaire de déploiement.
La topologie suivante est considérée comme étant une topologie distante car le serveur Web est sur une machine distincte. Le diagramme affiche une topologie distante classique pour un environnement
réparti :
Cette rubrique décrit l'installation d'un serveur Web sur une machine
et l'installation d'un serveur d'applications sur une machine distincte. Dans
cette situation, l'outil de configuration des plug-ins du serveur Web sur une
machine ne peut pas créer la définition du serveur Web dans la configuration du
serveur d'applications sur l'autre machine.
Dans
ce cas, l'outil de configuration des plug-ins du serveur Web crée un
script sur le serveur Web que vous pouvez copier sur le
serveur d'applications. Exécutez le script sur le serveur d'applications pour créer la définition de configuration du serveur Web dans la configuration du serveur d'applications.
Procédez comme suit pour installer le plug-in et configurer le serveur Web ainsi que le serveur d'applications.
Procédure
- Installez Installation Manager sur la machine A et sur la machine B.
- Utilisez Installation Manager pour installer WebSphere
Application Server Network Deployment sur la machine A.
- Créez un serveur d'applications autonome sur la machine A.
- Facultatif : Créez un alias hôte pour l'hôte virtuel par
défaut.
Si vous avez configuré le serveur Web pour qu'il utilise un port
autre que le port 80, vous devez ajouter un nouvel alias hôte pour ce port, pour l'hôte
par défaut. Par exemple, lorsqu'il est exécuté en tant que non root, IBM HTTP Server
est configuré avec la valeur de port par défaut 8080.
- Utilisez Installation Manager pour installer les éléments suivants sur l'ordinateur B.
- Plug-ins du serveur Web pour WebSphere
Application Server
- WebSphere Customization Toolbox
- Utilisez Installation Manager pour installer IBM HTTP Server sur la machine B ou
installez un autre serveur Web pris en charge sur la machine B.
Ouvrez WebSphere Customization Toolbox
et lancez l'outil de configuration des plug-ins de serveur
Web sur la machine contenant le serveur Web.
- Sélectionnez un emplacement d'exécution pour le plugin de serveur Web.
Si vous souhaitez utiliser l'emplacement d'un serveur Web déjà installé et que cet emplacement ne figure pas dans la liste, exécutez les actions suivantes pour l'ajouter à votre ensemble de projets :
- Cliquez sur Ajouter.
- Entrez un nom pour l'emplacement du plug-in de serveur Web.
- Effectuez
l'une des actions suivantes :
- Entrez l'emplacement.
- Cliquez sur Parcourir, recherchez l'emplacement, puis cliquez sur OK.
- Cliquez sur Créer.
- Sélectionnez le type de serveur Web que vous configurez, puis cliquez sur
Suivant.
- Sélectionnez l'architecture de votre serveur Web cible installé (64 bits ou 32 bits) et cliquez sur Suivant si le système vous y invite.
- Cliquez sur Parcourir pour sélectionner le ou
les fichiers de configuration de votre serveur Web et vérifier que le port du
serveur Web est correct, puis cliquez sur Suivant après avoir
terminé.
Sélectionnez le fichier et pas seulement son répertoire. Certains serveurs
Web sont dotés de deux fichiers de configuration et exigent que vous
recherchiez chaque fichier.
La liste suivante affiche les fichiers de configuration pour les serveurs
Web pris en charge :
- Apache HTTP Server
- racine_apache/config/httpd.conf
- Domino Web Server
- names.nsf et Notes.jar
L'assistant vous invite à indiquer le fichier notes.jar. Le nom réel est Notes.jar.
L'outil de configuration des plug-ins de serveur Web vérifie que les fichiers
existent mais ne valide aucun de ces fichiers.
- IBM HTTP
Server
racine_IHS/conf/httpd.conf
racine_profil_IHS/conf/httpd.conf
- Microsoft Internet
Information Services (IIS)
- L'outil de configuration des plug-ins de serveur Web peut déterminer les fichiers à
modifier.
- Sun Java™ System Web Server
(anciennement Sun ONE Web Server et iPlanet Web Server) version 6.0 ou ultérieure
- obj.conf et magnus.conf
- Si vous configurez un plug-in de serveur Web IBM HTTP, exécutez les actions ci-après.
- Le cas échéant, installez la configuration du serveur d'administration pour administrer le serveur Web.
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.
- Sélectionnez Configurer IBM HTTP
Server Administration Server.
- Spécifiez un numéro de port via lequel le serveur d'administration d'IBM HTTP pourra communiquer.
- Le cas échéant, sélectionnez Créer un ID utilisateur pour l'authentification auprès du serveur d'administrationIBM HTTP Server et entrez un ID utilisateur et un mot de passe pour vous authentifier sur le serveur d'administration d'IBM HTTP Server à partir de la console d'administration.
- Cliquez sur Next.
![[AIX]](../images/aixlogo.gif)
Spécifiez le groupe et l'ID utilisateur système disposant de droits d'accès en écriture sur IBM HTTP
Server, le serveur d'administration d'IBM HTTP Server et les fichiers de configuration de plug-in de serveur Web.Sélectionnez Créer un ID utilisateur système et un groupe uniques avec les données d'identification, si nécessaire.
Restriction : La
configuration peut échouer si vous spécifiez un nouvel ID utilisateur ou un nom de groupe dépassant la limite de la plateforme, laquelle est généralement de 8 caractères et parfois configurable.
Le cas échéant, configurez le serveur d'administration d'IBM HTTP Server à exécuter en tant que service Windows.- Sélectionnez Exécuter le serveur d'administration IBM HTTP Server
en tant que service Windows.
- Effectuez
l'une des actions suivantes :
- Sélectionnez Se connecter en tant que compte système local.
- Sélectionnez Se connecter en tant que compte utilisateur spécifié et entrez l'ID utilisateur et le mot de passe de ce compte.
L'ID utilisateur requiert les droits utilisateur avancés suivants :
- Agir en tant que partie du système d'exploitation
- Se connecter en tant que service
- Choisissez le type de démarrage (automatique ou manuel).
- Cliquez sur Next.
- Spécifiez un nom unique pour la définition de serveur Web et cliquez sur Suivant.
- Sélectionnez le scénario de configuration.
- Choisissez le scénario distant.
- Identifiez le nom d'hôte ou l'adresse IP de la machine A, laquelle est la machine du serveur d'applications.
- Cliquez sur Suivant.
- Sélectionnez le profil à configurer avec le plug-in de serveur Web en cours, puis cliquez sur Next.
Ce panneau ne s'affiche pas si vous avez sélectionné le scénario distant à l'étape précédente.
- Examinez le panneau récapitulatif et cliquez sur Configurer pour
commencer la configuration.
Le panneau vous informe que vous devez exécuter des opérations manuelles afin de compléter l'installation et la configuration.
L'outil de configuration des plug-ins de serveur Web crée le script
configurenom_serveur_Web dans le
répertoire racine_plug-ins/bin/ sur la
machine B (dotée du serveur Web).
L'outil de configuration des plug-ins de serveur Web crée également le
fichier plugin-cfg.xml dans le répertoire
racine_plug-ins/config/nom_serveur_Web.
Le serveur Web lit le fichier plugin-cfg.xml pour déterminer quelles applications le serveur d'applications de la machine A peut servir au serveur Web de la machine B. Lorsque la configuration change, le serveur d'applications régénère le fichier. Quand la régénération se produit,
propagez ou copiez le fichier plugin-cfg.xml du serveur
d'applications dans le serveur Web. Vous pouvez propager le fichier automatiquement vers le produit IBM HTTP Server.
- Dans le panneau récapitulatif, assurez-vous que l'installation a abouti et cliquez sur Finish.
Si un incident se produit et que l'installation n'aboutit pas, examinez les journaux dans le répertoire racine_plug-ins/logs. Corrigez les erreurs éventuelles et relancez la configuration.
- Copiez le script configurenom_serveur_Web de la machine
B (dotée du serveur Web) dans le répertoire
racine_serveur_app /bin sur la machine
A (du serveur d'applications).
nom_serveur_Web correspond au pseudonyme du serveur Web
indiqué. nom_serveur_Web n'est
pas un nom de fournisseur, comme IIS ou Apache.
Sur un système d'exploitation comme
AIX ou Linux, le fichier est configurenom_serveur_Web.sh.
Sur un système Windows, le
fichier est configurenom_serveur_Web.bat.
Par exemple, sur un système Linux
avec un serveur IBM HTTP Server nommé
serveur_Web_1 à l'emplacement par défaut, copiez racine_plugins/bin/configureweb_server_1.sh de la machine B (du serveur Web) dans le répertoire racine_serveur_app/bin
de la machine A (du serveur d'applications).
Par
exemple, sur un système IBM i
avec un serveur IBM HTTP Server nommé
serveur_Web_1 à l'emplacement par défaut, copiez racine_plugins/bin/configureweb_server_1 de
la machine B (du serveur Web) dans le répertoire racine_serveur_app/bin
de la machine A (du serveur d'applications).
- Compensez les différences d'encodage des fichiers afin que l'exécution du script n'échoue pas.
Le contenu du script
configurenom_serveur_Web.bat ou
configurenom_serveur_Web.sh peut être
corrompu si l'encodage des fichiers par défaut des deux machines n'est pas
identique.
Ce scénario peut se produire si une machine est configurée pour un environnement local DBCS (Double-Byte Character Set) et l'autre non.
Le contenu du script configurenom_serveur_Web peut être
corrompu si le codage du fichier par défaut est différent sur les deux
machines.
Ce scénario peut se produire si une machine est configurée pour un environnement local DBCS (Double-Byte Character Set) et l'autre non.
Déterminez l'encodage des fichiers et suivez l'une des procédures ci-dessous afin d'éviter l'échec. Pour déterminer le codage de fichiers par défaut, exécutez la commande appropriée.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
- Exécutez la commande locale charmap sur un système, tel que AIX ou Linux.
- Exécutez la commande CHCP sur une machine Windows.
Le résultat obtenu après l'exécution de la commande sur chaque machine doit être défini comme valeur pour les variables web_server_machine_encoding et application_server_machine_encoding dans l'une des procédures suivantes.Procédures permettant de compenser les différences d'encodage
Ne tapez pas les caractères de continuation (\) si vous entrez la commande sur une seule ligne.
Si le mappage de la conversion n'est pas pris en charge par la commande iconv
sur le système, copiez le contenu du script de configuration du serveur Web dans le presse-papiers et collez-le sur la machine sur laquelle le serveur d'applications est exécuté.
Remarque : Si vous copiez un fichier .sh
sur un système d'exploitation UNIX après une configuration à distance
sur un système d'exploitation Windows, vous devez exécuter chmod 755.
- Démarrez le serveur d'applications sur la machine A.
- Ouvrez une fenêtre de commande et accédez au répertoire du profil où doit être affecté le serveur Web. Exécutez le script que vous avez copié sur la machine A (la machine du serveur d'applications). Vous avez besoin des
paramètres suivants :
- Nom du profil
- (Facultatif) ID administrateur
- (Facultatif) Mot de passe de l'administrateur
Par exemple, vous pouvez entrer ce qui suit :configurewebserver1.sh AppSrv01 my_user_ID my_Password
Le serveur Web sera configuré via wsadmin.Le contenu du script configurewebserver1.sh est similaire à celui-ci :
wsadmin.bat -profileName AppSrv01 -user my_user_ID -password my_Password
-f "%WAS_HOME%\bin\configureWebserverDefinition.jacl" webserver1 IHS..
- A partir de la console d'administration du gestionnaire de déploiement, cliquez sur Administration système > Sauvegarde des modifications dans le référentiel maître > Synchroniser les modifications avec les noeuds > Sauvegarder.
Serveur Web Domino Web uniquement : Définissez la variable d'environnement WAS_PLUGIN_CONFIG_FILE. Sur les plateformes, telles que AIX ou Linux, sourcer le script vers le shell parent
permet aux processus enfant d'hériter des variables exportées.
Sur les systèmes Windows, exécutez le script comme vous l'auriez fait pour une autre commande. L'action de sourçage est automatique sur les systèmes Windows.
- Ouvrez une fenêtre de commande.
- Accédez au répertoire racine de l'installation des plug-ins.
- Exécutez la commande appropriée pour le script racine_plug-ins/bin/setupPluginCfg.sh :
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
. racine_plug-ins/bin/setupPluginCfg.sh (Notez l'espace entre le point et le répertoire racine d'installation.)
source racine_plug-ins/bin/setupPluginCfg.sh
Le script se trouve également dans le répertoire lotus_root/notesdata sur des systèmes d'exploitation, tels que AIX ou Linux.
Exécutez la commande appropriée pour le script avant de démarrer Domino Web Server.
- Régénérez le fichier plugin-cfg.xml sur la machine A (la machine du serveur d'applications) à l'aide de la console d'administration. Cliquez
sur Serveurs > Types de serveurs > Serveurs Web.
Sélectionnez le serveur Web, puis cliquez sur Générer un
plug-in.
Au cours de l'installation des plug-ins, le fichier
plugin-cfg.xml par défaut est installé sur la machine B
(dotée du serveur Web) dans le répertoire racine_plugins/config/nom_serveur_Web.
Le service de configuration de plug-in du serveur Web régénère automatiquement
le fichier plugin-cfg.xml. Pour utiliser le fichier plugin-cfg.xml actuel du serveur d'applications, propagez
le fichier plugin-cfg.xml comme décrit dans l'étape suivante.
Cette étape explique comment régénérer le fichier plugin-cfg.xml. Les produits WebSphere Application Server sont configurés afin de régénérer automatiquement le fichier à chaque fois qu'un événement majeur se produit. Par exemple, l'installation d'applications sur le serveur d'applications et sur le serveur Web. La création d'un hôte virtuel est aussi un événement majeur.
- Propagez le fichier plugin-cfg.xml
du serveur d'applications au serveur Web à l'aide de la console d'administration. Cliquez sur Serveurs > Serveur Web. Sélectionnez le serveur Web, puis cliquez sur Propager un
plug-in.
Des serveurs Web autres que le serveur IBM HTTP Server nécessitent une propagation manuelle.
Le
service de configuration de plug-in du serveur Web propage automatiquement le fichier
plugin-cfg.xml
uniquement pour IBM HTTP Server. Pour tous les autres serveurs Web, propagez le fichier de
configuration de plug-in en copiant manuellement le fichier
plugin-cfg.xml du répertoire
racine_profil/config/cells/nom_cellule/nodes/nom_noeud/servers/nom_serveur_Web
sur la machine A (du serveur d'applications) dans le répertoire
racine_plugins/config/nom_serveur_Web
sur la machine B (dotée du serveur Web).
- Lancez le servlet Snoop afin de tester la capacité du serveur Web à extraire une application du serveur d'applications.
Testez votre environnement en lançant votre serveur d'applications ainsi que votre serveur Web et en utilisant le servlet Snoop ayant une adresse IP.
- Démarrez le serveur d'applications. Dans un environnement Network Deployment, le servlet Snoop est disponible dans la cellule uniquement si vous avez inclus l'application par défaut lors de l'ajout du serveur d'applications à la cellule. L'option -includeapps de la commande
addNode permet de migrer l'application par défaut dans la
cellule. Si vous ne disposez pas de cette application, ignorez cette étape.
- Lancez le serveur IBM HTTP
ou le serveur Web que vous utilisez.
Utilisez la page 2001 ou la commande STRTCPSVR
SERVER(*HTTP) HTTPSVR(nom_instance) pour démarrer IBM HTTP Server.
Utilisez une fenêtre de commande pour accéder au répertoire de l'image d'IBM HTTP Server installée, ou l'image installée du serveur Web. Exécutez la commande appropriée pour lancer
le serveur Web (commandes pour IBM HTTP Server, par exemple) :
Pour démarrer
IBM HTTP Server à partir de la ligne de
commande :
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Accédez aux commandes
apache et
apachectl dans le répertoire
IBMHttpServer/bin.
- 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.
La valeur par défaut du port de transport HTTP est 9080 et doit être unique pour chaque profil. Ce port
est associé à un hôte virtuel nommé default_host, qui est configuré pour héberger l'application
installée par défaut. Le servlet Snoop fait partie de l'application par défaut. Modifiez le port pour qu'il corresponde au port de transport HTTP.
- Vérifiez que Snoop est en cours d'exécution.
L'une
des adresses Web doit afficher la page Servlet Snoop - Informations de
demande/client.
- Serveur IBM HTTP Server distant uniquement :
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Vérifiez que la fonction de propagation automatique peut
fonctionner sur un serveur IBM HTTP Server distant en suivant les étapes ci-après.
Cette procédure ne s'applique pas aux serveurs Web locaux.
- Créez user=adminUser, password=adminPassword dans le fichier racine_IHS /conf/admin.passwd.
Par exemple : c:\ws\ihs85\bin\htpasswd -cb c:\ws\ihs85\conf\admin.passwd
adminUser adminPassword
- Utilisez la console d'administration du gestionnaire
de déploiement ou le serveur d'applications pour saisir les informations d'ID utilisateur et de mot de passe
que vous avez créées pour l'administrateur d'IBM HTTP Server. Accédez à Serveurs
> Serveur Web > définition_serveur_Web > Administration du serveur Web
distant. Définissez les valeurs suivantes : admin Port=8008, User Id=adminUser, Password=adminPassword.
- Définissez les droits d'accès en lecture/écriture corrects aux fichiers httpd.conf et plugin-cfg.xml. Consultez le fichierracine_IHS /logs/admin_ERROR.
LOG pour plus d'informations.
Pour que le fichier de configuration du plug-in soit propagé automatiquement, le serveur d'administration IBM HTTP doit être actif. Si vous gérez un serveur IBM HTTP Server à l'aide de la console d'administration de WebSphere Application Server, l'erreur suivante peut s'afficher :
"Could not connect to IHS Administration server error"
Pour corriger l'erreur, procédez comme suit :
- Vérifiez que le serveur d'administration IBM HTTP Server est actif.
- Vérifiez que le nom d'hôte et le port du serveur Web définis dans la console d'administration WebSphere Application
Server correspondent au nom d'hôte et au port du serveur d'administration IBM HTTP Server.
- Assurez-vous que le pare-feu ne vous empêche pas d'avoir accès au serveur d'administration IBM HTTP Server à partir de la console d'administration de WebSphere Application
Server.
- Vérifiez que le mot de passe et l'ID utilisateur indiqués dans la console d'administration de WebSphere Application Server, gérée à distance, sont créés dans le fichier admin.passwd, à l'aide de la commande htpasswd.
- Lors d'une tentative de connexion sécurisée, veillez à exporter le certificat personnel keydb du
serveur d'administration IBM HTTP Server dans la base de données de clés de WebSphere Application Server en tant que certificat de signataire. Cette base de données de clés est spécifiée par la directive com.ibm.ssl.trustStore dans le fichier sas.client.props du profil dans lequel la console d'administration est exécutée. Cet élément s'applique essentiellement aux certificats auto-signés.
- Si vous rencontrez encore des erreurs, consultez le fichier IBM HTTP Server admin_ERROR. LOG
et les journaux WebSphere Application
Server (fichier trace.log) pour déterminer la cause du problème.
Résultats
Cette procédure a permis d'installer des plug-ins de serveur Web pour WebSphere Application
Server sur une machine de serveur Web. L'outil de configuration des plug-ins de serveur Web configure également le serveur Web afin qu'il prenne en charge un serveur d'applications sur une machine distincte.
L'installation des plug-ins de serveur Web génère la création du répertoire
Plugins ainsi que celle de plusieurs sous-répertoires. Par exemple, les répertoires suivants font partie des répertoires créés sur un système Linux :
- plugins_root/bin/32bits or plugins_root/bin/64bits contient les plug-in binaires de tous les serveurs Web pris en charge.
- Le répertoire racine_plug-ins/logs contient des fichiers journaux.
- Le répertoire racine_plug-ins/properties contient les informations relatives à la version.
Que faire ensuite
See Selecting a web server topology diagram and
roadmap for an overview of the installation procedure.
Pour plus d'informations sur les fichiers impliqués dans la configuration
d'un serveur Web, voir Configuration du serveur Web.
Pour obtenir des informations sur l'emplacement du fichier de configuration de plug-in, voir Configuration des plug-ins.
Pour
plus d'informations sur la façon dont l'outil de configuration des plug-ins de serveur Web
configure les serveurs Web pris en charge, voir Edition des fichiers de configuration de serveur Web.