Implémentation d'un plug-in de serveur Web

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

    [AIX Solaris HP-UX Linux Windows]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][z/OS]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.

    [AIX Solaris HP-UX Linux Windows]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.

    [z/OS]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.

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

    [z/OS]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 Serveurs > Types de serveurs > Serveurs d'applications WebSphere > nom_serveur > Services d'administration > Service de configuration de plug-in de serveur Web, puis désélectionnez l'option Activer le traitement de la configuration de serveur Web automatique.

Eviter les incidents 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

[IBM i]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][z/OS]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.
  1. [AIX Solaris HP-UX Linux Windows]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.

  2. 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.

  3. 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.
  4. Le référentiel maître est mis à jour et sauvegardé.

[AIX Solaris HP-UX Linux Windows][z/OS]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][z/OS]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

  1. 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 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 :

    1. Sélectionnez Serveurs > Types de serveurs > Serveurs Web > nom_serveur_Web > Propriétés de plug-in.
    2. 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 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
    3. Cliquez sur OK.
    4. [IBM i]Propager la configuration du plug-in. Pour propager la configuration du plug-in, à partir de la console d'administration, cliquez sur Serveurs > Types de serveur > Serveurs Webnom_serveur_WebPropager un plug-in.

      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 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.
    5. 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.
  2. [AIX Solaris HP-UX Linux Windows][IBM i]Optimisez le serveur Web. Voir la page relative à l'optimisation des serveurs Web pour plus d'informations.
  3. [AIX Solaris HP-UX Linux Windows][z/OS]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

    [AIX]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.

  4. Copiez le fichier de clés dans le répertoire de fichier de clés du serveur Web.
    Eviter les incidents 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.


Icône indiquant le type de rubrique Rubrique de tâche



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