Cette rubrique explique comment implémenter un plug-in de serveur Web.
Le produit utilise un serveur Web pour acheminer les demandes de contenu dynamique, comme des servlets, à partir d'applications Web. Les serveurs Web sont nécessaires à l'acheminement du trafic à partir de navigateurs Web vers les applications qui s'exécutent sur un serveur d'applications. Le
plug-in du serveur Web utilise le fichier de configuration XML pour déterminer si une demande est adressée au serveur d'applications.
Avant de commencer
- Reportez-vous aux informations sur la sélection d'un système frontal pour votre topologie WebSphere
Application Server. Cette rubrique vous aide à déterminer
si vous devez définir un plug-in de serveur Web, un serveur proxy ou
un serveur proxy sécurisé pour fournir une affinité de session, une prise en charge des incidents,
et l'équilibrage de la charge de travail pour votre topologie WebSphere
Application Server. Installez votre serveur Web si nécessaire.
Eviter les incidents: Le serveur Web fourni avec
IBM® i est déjà installé sous le produit 5761-DG1 for
IBM i V6R1
ou 5770-DG1 for
IBM i V7R1. Le serveur Web
IBM i
est également dénommé IBM HTTP
Server for
IBM i. Ce serveur Web est différent du serveur HTTP IBM HTTP
Server fourni avec
WebSphere
Application Server qui ne fonctionne pas avec
IBM i.
gotcha
Si vous souhaitez utiliser IBM HTTP Server fourni avec le produit, voir les informations relatives à l'installation d'IBM HTTP
Server.
Sinon, reportez-vous aux informations d'installation fournies par votre serveur Web.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Assurez-vous que le fichier du plug-in approprié a été installé sur votre serveur Web
et que le script configurenom_serveur_Web a été exécuté pour créer et
configurer la définition de ce serveur Web.
Si vous
utilisez un serveur Web sur une plateforme répartie, utilisez l'outil de configuration de plug-ins de serveur Web pour installer le fichier de plug-in approprié sur le serveur Web. Exécutez ensuite le script
configurenom_serveur_Web créé par l'assistant pour créer et configurer la définition du serveur Web dans
le référentiel de configuration WebSphere.
Si vous utilisez IBM HTTP Server for z/OS d'Apache fourni avec le produit, voir les informations d'installation et de configuration du plug-in pour IBM HTTP Server
for WebSphere
Application Server sur z/OS.
Si vous utilisez la version 5.3 de HTTP Server fournie avec le système d'exploitation z/OS de base, voir les informations d'installation et de configuration du plug-in de serveur Web pour IBM HTTP Server for z/OS V5.3.
Si vous utilisez un serveur Web sur une plateforme répartie avec une version de produit s'exécutant sur des systèmes d'exploitationz/OS, utilisez FTP pour envoyer le plug-in sur le serveur Web et l'assistant d'installation de plug-in pour installer le fichier du plug-in approprié sur votre serveur Web.
Si vous apportez simultanément plusieurs modifications, par exemple si vous installez de nombreuses applications, il est préférable de désactiver le service de configuration jusqu'à ce que vous ayez effectué la dernière modification. Le service de configuration du plug-in de serveur Web est activé par défaut. Pour désactiver ce service, dans la console d'administration, cliquez sur , puis désélectionnez l'option .
Eviter les incidents: Si votre installation utilise un pare-feu, assurez-vous de configurer le plug-in de serveur Web de sorte qu'il utilise un port ouvert. Prenez contact avec l'administrateur de sécurité pour savoir comment obtenir un port ouvert.
gotcha
Pourquoi et quand exécuter cette tâche
Le fichiers de plug-in approprié est installé.
En outre, un profil http est créé (/QIBM/UserData/WebSphere/Plugins/V85/webserver/profiles/http).
Le profil http peut être utilisé pour faciliter la création des définitions de
serveur Web. Reportez-vous à la rubrique sur la sélection d'un diagramme de topologie de serveurs Web et d'une feuille de route pour savoir comment configurer IBM HTTP Server for IBM pour qu'il communique avec un serveur d'applications.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
Les étapes suivantes sont effectuées lors du processus d'installation du plug-in. Reportez-vous au plan d'installation du plug-in pour plus d'informations.
Un noeud est créé. Un noeud non géré est créé lorsque
le serveur Web se trouve sur un ordinateur différent du serveur d'applications. Un noeud non géré est un noeud qui n'a aucun agent de noeud. A l'aide des noeuds non gérés, le produit peut représenter des serveurs qui ne sont pas des serveurs d'applications dans sa topologie de configuration. Cette représentation permet de conserver les informations de connexion de ces serveurs et
des serveurs d'applications. Voir la rubrique sur l'ajout, la gestion et la suppression de noeuds pour plus d'informations.
- Une définition de serveur Web est créée.
Vous pouvez aussi utiliser la console d'administration
ou le script ConfigurewebServerDefinition.jacl
pour créer une définition de serveur Web.
- Une application ou des modules sont mappés vers un serveur Web. Si une application à utiliser avec ce serveur Web est déjà installée, elle est automatiquement mappée vers le serveur Web. Si l'application n'est pas installée, sélectionnez le serveur Web lors de l'étape "Mappage de modules sur les serveurs" du processus d'installation de l'application.
- Le référentiel maître est mis à jour et sauvegardé.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Lorsque vous installez un plug-in, son fichier de configuration est automatiquement créé. Vous pouvez changer ou ajuster les valeurs
des propriétés définies dans ce fichier de configuration. Dès lors que vous modifiez une
valeur dans ce fichier, vous devez le régénérer afin que les modifications
soient prises en compte.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
La génération ou la régénération du fichier de configuration peut durer un certain temps.
Une
fois la régénération terminée, tous les objets de la cellule d'administration
utilisent les paramètres les plus récents auxquels le serveur Web a accès. En général, si le serveur d'applications se trouve sur le même poste de travail physique que le serveur Web, la régénération prend environ 30 à 60 secondes. La régénération dure plus longtemps si le serveur d'applications et le serveur Web sont situés sur des postes de travail différents.
La procédure suivante explique comment mettre à jour le fichier de configuration de plug-in, y compris la
configuration pour optimiser les serveurs SSL et Web.
Procédure
- Utilisez la console d'administration pour changer les valeurs dans le
fichier de configuration du plug-in.
Lors de la configuration de votre plug-in de serveur Web, déterminez si la configuration doit être automatiquement générée après modification. Lorsque
le service de configuration du plug-in de serveur Web est activé et si l'une des
conditions suivantes existe, le fichier de configuration du plug-in est automatiquement généré :
- lorsque le serveur Web est créé et sauvegardé,
- lorsqu'une application est installée,
- lorsqu'une application est désinstallée,
- lorsque la définition de l'hôte virtuel est mise à jour.
Eviter les incidents: Lors de sa première génération, le
fichier de configuration de plug-in n'inclut pas admin_host dans la liste des hôtes
virtuels. Les informations relatives aux autorisations d'accès des serveurs Web à la console
d'administration expliquent comment l'ajouter à la liste.
gotcha
Vous pouvez soit utiliser la console d'administration, soit émettre la commande GenPluginCfg pour régénérer le fichier plugin-cfg.xml.
Procédez comme suit pour régénérer le fichier plugin-cfg.xml à l'aide de la console d'administration :
- Sélectionnez .
- sélectionnez Générer automatiquement le fichier de configuration du plug-in ou cliquez sur l'une ou plusieurs des
rubriques suivantes pour configurer manuellement le fichier plugin-cfg.xml :
Eviter les incidents: Ne mettez pas le fichier
plugin-cfg.xml à jour manuellement. En effet, les modifications apportées manuellement au fichier
plugin-cfg.xml d'un serveur Web sont
annulées et remplacées dès que ce fichier est régénéré.
gotcha
- Cliquez sur
OK.
Propager la configuration du plug-in. Pour propager la configuration du plug-in, à partir de la console d'administration, cliquez sur nom_serveur_Web. Une autre méthode de propagation de la configuration du plug-in consiste à exécuter la commande
GenPluginCfg. Pour plus d'informations, voir la documentation relative à la commande GenPluginCfg.
Vous n'avez pas besoin de propager la configuration du plug-in si le serveur Web
est situé sur la même machine que le serveur que la version autonome associée du produit. Si
la propagation de la configuration du plug-in n'aboutit pas pour une raison inconnue, vous devez
copier manuellement le fichier plugin-cfg.xml à l'emplacement d'installation du serveur Web distant.
Eviter les incidents: Si vous utilisez la fonction FTP pour procéder à la copie et que le rechargement de la
configuration n'aboutit pas, vérifiez les droits sur le fichier
plugin-cfg.xml et assurez-vous
que les utilisateurs QTMHHTTP, QNOTES et QEJBSVR détiennent le droit RWX. Si les droits ne sont pas corrects,
le serveur Web ne peut pas accéder à la nouvelle version du fichier et le rechargement de la
configuration n'aboutit pas. Pour vérifier ces droits d'accès, exécutez la commande IBM i suivante :
wrklnk 'plug_in_folder_location/plugin-cfg.xml'
Ensuite, sélectionnez l'option 9
pour afficher les droits attribués aux utilisateurs (QTMHHTTP, QNOTES et QEJBSVR).
gotcha
Si ces droits sont erronés, émettez la commande suivante IBM i suivante pour les rectifier :
CHGAUT USER(QEJBSVR QTMHHTTP QNOTES) OBJ('emplacement_dossier_plug_in/plugin-cfg.xml') DTAAUT(*RWX)
emplacement_dossier_plug_in est l'emplacement que vous avez indiqué lorsque vous avez transféré le fichier
plugin-cfg.xml.
- Vous pouvez être amené à arrêter
le serveur d'applications et à le démarrer pour permettre au serveur Web de localiser le fichier plugin-cfg.xml.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Optimisez le serveur Web. Voir la page relative à l'optimisation des serveurs Web pour plus d'informations.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Propager la configuration du plug-in. Le fichier de configuration du plug-in plugin-cfg.xml est automatiquement transmis au serveur Web si le service de configuration du plug-in de serveur Web est activé et que l'une des conditions suivantes existe : - Le serveur Web est un serveur Web local, ce qui signifie qu'il se trouve sur le même poste de travail qu'un serveur d'applications.
- Le serveur Web est un serveur HTTP IBM version 7 distant sur lequel s'exécute un serveur d'administration IBM HTTP.
Si aucune de ces conditions n'est satisfaite, vous devez copier manuellement le fichier plugin-cfg.xml à l'emplacement d'installation du serveur Web distant. Copiez le fichier plugin-cfg.xml dans <racine_serveur_app>/profiles/<nom_profil>/config/cells/../../nodes/../servers/<nom_serveur_web> à l'emplacement hôte du serveur, qui est <racine_install_plug_in>/config/<nom_serveur_web>/.
Important : Si vous utilisez la fonction FTP pour copier le fichier et que le rechargement de la configuration échoue, vérifiez les droits d'accès au fichier
plugin-cfg.xml qui doivent être
rw-r--r--. Si les droits d'accès au fichier ne sont pas corrects, le serveur Web ne peut pas accéder à la nouvelle version du fichier et le rechargement de la configuration échoue.
Si les droits d'accès au fichier ne sont pas corrects, émettez la commande suivante pour les modifier :
chmod 644 plugin-cfg.xml
La fonction FTP d'AIX ne conserve pas les attributs de fichier. Par conséquent, si vous devez copier manuellement
le fichier plugin-cfg.xml à partir d'un système d'exploitation AIX, vous souhaitez peut-être utiliser la fonction RCP
d'AIX à la place de la fonction FTP.
Le répertoire d'installation du serveur Web distant est le répertoire que vous avez indiqué
lors de la création du noeud pour ce serveur Web.
- Copiez le fichier de clés dans le répertoire de fichier de clés du serveur Web.
Eviter les incidents: Cette étape est indispensable au bon fonctionnement du serveur Web.
gotcha
Pour des instructions détaillées sur la copie du fichier de clés, lisez la rubrique relative à la configuration du plug-in du serveur Web pour SSL (Secure Sockets Layer).
Résultats
La configuration est terminée. Pour l'activer, arrêtez et redémarrez le serveur Web. Si des erreurs
se produisent lors du redémarrage du serveur Web, recherchez dans le fichier
http_plugin.log des informations
sur la section du fichier
plugin-cfg.xml qui contient une erreur. Le fichier
journal indique le numéro de ligne où se situe l'erreur, ainsi que
des détails susceptibles de vous aider à déterminer la cause de
l'échec du démarrage du serveur Web. Vous pouvez ensuite utiliser la console d'administration pour mettre à jour le fichier
plugin-cfg.xml.
Si vous n'installez ou ne désinstallez pas souvent des applications, ce qui est généralement le cas dans un environnement de production, ou si vous pouvez tolérer l'impact sur les performances qu'entraînent la génération et la distribution du fichier de configuration du plug-in à chaque fois que l'une des actions répertoriées ci-dessus est effectuée, vous pouvez envisager d'activer le service de configuration.