Cette procédure décrit l'installation d'un serveur Web et de son plug-in sur une machine où le profil par défaut est un profil personnalisé.
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.
Cette procédure configure le profil personnalisé sur la machine B. Elle implique que l'installation d'un gestionnaire de déploiement sur la machine A a déjà été effectuée.
Le noeud WebSphere Application Server sur la
machine B est le noeud personnalisé que vous créez dans cette procédure. Cette procédure démarre le gestionnaire de déploiement et fédère le noeud personnalisé avant d'installer les plug-ins de serveur Web.
Démarrez le gestionnaire de déploiement.
Le gestionnaire de déploiement doit être en cours d'exécution afin de réussir la fédération et la configuration du noeud personnalisé.
Pourquoi et quand exécuter cette tâche
Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM® i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL
en vue du traitement des incidents liés aux applications.
Utilisez la procédure ci-après pour installer le plug-in de serveur Web, configurer le serveur Web et créer une définition de serveur Web dans le profil personnalisé (noeud personnalisé).
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
Procédure
- Ouvrez une session sur le système d'exploitation.
Si vous effectuez une installation en tant qu'utilisateur autre que root ou
administrateur, certaines limitations s'appliquent.
![[Windows]](../images/windows.gif)
Lors de l'installation d'un utilisateur administratif
sur un système d'exploitation Windows, un service Windows est automatiquement créé pour
démarrer automatiquement le serveur d'applications. Le compte d'utilisateur d'installation doit avoir les
droits d'utilisateur suivants :
- Agir en tant que partie du système d'exploitation
- Se connecter en tant que service
Par exemple, sur certains systèmes d'exploitation Windows, cliquez sur
Panneau de configuration > Outils d'administration > Stratégie de sécurité
locale > Stratégies locales > Attribution des droits utilisateur pour définir les options avancées. Pour plus d'informations, voir la documentation de votre système d'exploitation Windows.
Si vous prévoyez d'exécuter le serveur d'applications en
tant que service Windows, ne l'installez pas à partir d'un ID utilisateur contenant des espaces. Un ID
utilisateur comportant des espaces ne peut pas être validé. Vous ne pouvez pas continuer l'installation avec l'ID utilisateur mentionné ci-dessus.
Pour éviter cette restriction, employez un ID utilisateur ne contenant pas d'espace pour l'installation.
- Utilisez Installation Manager pour installer les éléments suivants sur l'ordinateur B.
- WebSphere Application
Server Network Deployment
- Plug-ins du serveur Web pour WebSphere
Application Server
- WebSphere Customization Toolbox
- Utilisez Installation Manager pour installer IBM HTTP Server sur l'ordinateur B, ou pour installer un autre serveur Web pris en charge sur l'ordinateur B.
- Créez un profil personnalisé comme premier profil sur la machine B et fédérez le noeud pendant que vous le créez.
- Facultatif : Utilisez la console d'administration du gestionnaire de déploiement pour créer un serveur d'applications sur le noeud personnalisé.
Cliquez sur Serveurs > Serveurs d'applications > Nouveau et suivez les instructions relatives à la création d'un serveur. Un serveur n'est pas nécessaire pour l'installation des plug-ins, mais il vous permet de vérifier la fonctionnalité du serveur Web.
- Facultatif : Dans la console d'administration du gestionnaire de déploiement, installez l'application par défaut sur le nouveau serveur.
L'application par défaut comprend le servlet Snoop. L'étape de vérification utilise le servlet Snoop.
- Ouvrez WebSphere Customization
Toolbox et lancez l'outil de configuration des plug-ins de serveur Web sur l'ordinateur B.
- Sélectionnez un emplacement d'exécution pour le plug-in de serveur Web.
Si vous souhaitez utiliser l'emplacement d'un plug-in de 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'administration IBM 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 local.
- Effectuez
l'une des actions suivantes :
- Entrez l'emplacement d'installation de WebSphere Application Server (racine_serveur_app).
- Cliquez sur Parcourir, recherchez l'emplacement d'installation de WebSphere Application Server
(racine_serveur_app), puis cliquez sur OK.
- Cliquez sur Suivant.
- Sélectionnez le profil à configurer avec le plug-in de serveur Web en cours, puis cliquez sur Next.
- Examinez le panneau récapitulatif et cliquez sur Configure pour commencer la configuration du serveur Web, du plug-in de serveur Web et du profil.
- 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.
- Créez la définition de serveur Web sur l'ordinateur A.
Vous pouvez utiliser la console d'administration du gestionnaire de
déploiement pour créer la définition de serveur Web sur un noeud fédéré ; ou, vous pouvez exécuter le script de configuration créé par l'outil de configuration des plug-ins de serveur Web.
Le script contient déjà toutes les informations à rassembler lors de l'utilisation de l'option de la console d'administration.
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.
- 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.
- Si l'application par défaut n'est pas installée sur le gestionnaire de déploiement, vous pouvez tester la fonctionnalité du serveur Web et du noeud personnalisé en utilisant l'une de vos applications.
- A partir de la console d'administration du gestionnaire de déploiement, cliquez sur
Administration du système > Sauvegarde des modifications dans le référentiel maître > Synchroniser les modifications avec les noeuds > Sauvegarder.
- Pour créer plusieurs définitions de serveur Web concernant le noeud géré, utilisez l'outil de configuration des plug-ins de serveur Web afin de configurer chaque serveur Web.
Identifiez le même noeud géré à chaque fois. Donnez un alias différent à chaque serveur Web.
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 crée une définition de serveur Web dans le noeud géré.
L'outil de configuration des plug-ins de serveur Web configure le serveur Web pour qu'il utilise le fichier plugin-cfg.xml se trouvant dans le noeud personnalisé géré.
Le gestionnaire de déploiement régénère le fichier de configuration de plug-in de serveur Web, plugin-cfg.xml, lorsqu'un événement se produit et affecte le fichier. Ces événements incluent l'ajout ou la suppression d'une application, d'un serveur ou d'un hôte virtuel.
La création ou suppression des clusters et des membres de cluster provoque également la régénération de fichier. La propagation automatique à travers la synchronisation de noeud effectue une copie du fichier après chaque régénération dans l'emplacement ci-dessous sur la machine de noeud personnalisé :
racine_profil
/config/cells/nom_cellule/nodes/
nom_noeud_du_profil_personnalisé/servers/
nom_serveur_web/plugin-cfg.xml
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
Pour obtenir des informations sur l'emplacement du fichier de configuration de plug-in, voir Configuration des plug-ins.
Pour plus d'informations sur les fichiers impliqués dans la configuration
d'un serveur Web, voir Configuration du serveur Web.
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.
Pour obtenir des informations sur d'autres scénarios d'installation concernant l'installation des plug-ins de serveur Web, voir Configuration des plug-ins de serveur Web.