[z/OS]

Installation et configuration du plug-in pour HTTP Server for z/OS

The HTTP Server plug-in for z/OS is part of the web server plug-ins component of WebSphere Application Server for z/OS. Pour utiliser ce plug-in, vous devez posséder HTTP Server for z/OS version 5.3 configuré sur un système z/OS.

Pourquoi et quand exécuter cette tâche

Remarque : Dans WebSphere Application Server for z/OS version 7 et antérieure, le plug-in de serveur web pour IBM® HTTP Server (IHS/390) se trouvait dans le répertoire bin du produit de base WebSphere Application Server for z/OS. Dans les versions 8.0 et ultérieures, ce plug-in se trouve dans le répertoire bin du système de fichiers du produit Plug-ins du serveur Web et le plug-in ihs390WAS70Plugin_http.so a été renommé ihs390WASPlugin_http.so.

HTTP Server for z/OS version 5.3 est fourni avec le système d'exploitation de base z/OS. HTTP Server for z/OS n'est pas un serveur Apache. HTTP Server for z/OS ne prend pas en charge l'architecture 64-bit et ne prend pas en charge IPv6.

Cette procédure décrit l'installation et la configuration du plug-in HTTP Server for z/OS.

Procédure

  1. Assurez-vous que HTTP Server for er for z/OS version 5.3 est installé sur un système z/OS.
  2. Installez les plug-ins du serveur Web. Use IBM Installation Manager to install the web server plug-ins for WebSphere Application Server for z/OS, and mount the product file system on your target z/OS system. By default, the plug-ins are located in the /usr/lpp/WebSphere/Plugins/V9R0 directory.
  3. Si HTTP Server n'a pas accès au système de fichiers du produit de plug-ins du serveur Web, effectuez les étapes suivantes pour télécharger, au format binaire, le plug-in HTTP Server for z/OS et le fichier plugin-cfg.xml à partir de la partition logique sur laquelle le serveur d'applications est exécuté vers celle où HTTP Server est installé. Le répertoire dans lequel le plug-in est téléchargé doit être lisible par l'identificateur MVS sous lequel HTTP Server est exécuté.
    1. Utilisez FTP ou un autre mécanisme de transfert des fichiers pour télécharger au format binaire le plug-in HTTP Server for z/OS à partir de répertoire d'installation vers le système HTTP Server et dans un répertoire lisible par l'identification MVS sous laquelle HTTP Server est exécuté. La DLL ihs390WASPlugin_http.so se trouve dans le répertoire /bin/ des plug-ins du serveur Web, par exemple :
      /usr/lpp/WebSphere/Plugins/V9R0/bin 
    2. Définissez les droits d'accès (755 +p) sur le fichier ihs390WASPlugin_http.so du plug-in. A l'aide d'un ID utilisateur z/OS autorisé, émettez les commandes suivantes à partir d'une invite de ligne de commande OMVS pour activer la partie "p" dans le système hiérarchique de fichiers où est situé le plug-in HTTP Server for z/OS :
      chmod 755 ihs390WASPlugin_http.so
      extattr +p ihs390WASPlugin_http.so
      Pour vérifier les résultats de la commande extattr, entrez la commande suivante :
      ls -E  ihs390WASPlugin_http.so
      Puis recherchez "ps" dans les attributs étendus. Par exemple :
      -rwxr-xr-x  -ps-  1 USER123  WASUSER  1482752 Aug  2 14:17 ihs390WASPlugin_http.so
  4. Exécutez setup.sh pour créer deux fichiers, httpd.conf et httpd.enwars, pour personnaliser et configurer le serveur Web. Créez les fichiers httpd.conf et httpd.enwars dans le répertoire /etc. Le fichier setup.sh se trouve dans le répertoire usr/lpp/internet/sbin.
  5. Ajoutez les directives ServerInit, ServerTerm et Service au fichier de configuration httpd.conf de HTTP Server :
    • Ajoutez les directives ServerInit et ServerTerm suivantes pour indiquer les points d'entrée aux routines d'initialisation et d'exit du plug-in. Ces routines existent comme points d'entrée init_exit et term_exit respectivement, dans le fichier de DLL ihs390WASPlugin_http.so.
      Eviter les incidents Eviter les incidents:
      • Dans cette présentation, les directives ServerInit et Service sont scindées en plusieurs lignes pour des raisons d'affichage. Dans le fichier httpd.conf réel, entrez chacune de ces directives sur une seule ligne.
      • Dans la directive ServerInit, conf_plugin_http représente le chemin d'accès absolu au fichier plugin-cfg.xml.
      • Dans les directives ServerInit, Service et ServerTerm, rép_plugin_http représente soit :
        1. The full path of the WebSphere Application Server web server plug-ins directory, such as /usr/lpp/WebSphere/Plugins/V9R0, if the HTTP Server is on the same LPAR as the WebSphere Application Server, or
        2. le chemin d'accès absolu que vous avez désigné comme destination de l'opération FTP à l'étape précédente, si HTTP Server ne se trouve pas sur un système ayant accès au système de fichiers du produit de plug-ins du serveur Web.
      gotcha
      ServerInit /rép_plugin_http/bin/
          ihs390WASPlugin_http.so:init_exit /http_plugin_conf/
          plugin-cfg.xml
      ServerTerm /http_plugin_dir/bin/ihs390WASPlugin_http.so:term_exit
    • Ajoutez la directive Service suivante pour chaque application qui utilisera le plug-in de serveur Web. Cette directive indique le point d'entrée à la routine de requête du plug-in. La routine de requête existe comme point d'entrée service_exit dans le fichier DLL (Dynamic Link Library) ihs390WASPlugin_http.so.
      Service /racine_contexte_webapp/*  /rép_plugin_http/
           ihs390WASPlugin_http.so:service_exit

      racine_contexte_webapp est la racine de contexte de l'application

    transition : Le plug-in du serveur Web pour HTTP Server de z/OS, version 5.3, utilise une interface SSL différente de celle qui était utilisée dans les versions précédentes du produit. La modification provisoire du logiciel (PTF) UK35083 de z/OS inclut la modification de l'interface SSL pour HTTP Server de z/OS, version 5.3, qui correspond à ce changement de plug-in de serveur Web. C'est pourquoi cette modification doit être appliquée à votre système avant que la nouvelle interface SSL du plug-in du serveur Web ne puisse fonctionner correctement.

    Vous devez également inclure l'option SSLMode multi dans le fichier httpd.conf pour HTTP Server de z/OS, Version 5.3. Si l'option SSLMode multi n'est pas indiquée dans le fichier httpd.conf, ou si vous n'avez pas appliqué la modification UK35083 de z/OS à votre système, vous risquez de recevoir le message d'erreur IMW0584W, qui indique que le mode SSL spécifié pour HTTP Server n'est pas compatible avec le mode SSL du plug-in du serveur Web utilisé avec HTTP Server de z/OS, version 5.3. Dans chacun de ces cas, des conséquences inattendues peuvent survenir.

    Eviter les incidents Eviter les incidents:
    1. HTTP Server interprète les blancs insérés dans les spécifications de directive comme des délimiteurs et le signe dièse (#) comme le début d'un commentaire à ignorer. Par conséquent, si vous avez besoin d'utiliser un blanc ou un signe dièse dans une directive, vous devez insérer une barre oblique inversée (\) avant le blanc ou le signe dièse pour que HTTP Server puisse traiter la directive correctement.
    2. Si un servlet définit un code de réponse HTTP par tout moyen, tel qu'à l'aide des méthodes lastModified() ou setStatus(), et si le client ne reçoit pas le code de réponse attendu, ajoutez la directive suivante au fichier de configuration de HTTP Server :
      ServiceSync On
    gotcha
  6. Si le fichier httpd.conf contient une directive directive équivalente à /*, assurez-vous que les directives Service précèdent la directive Pass.
  7. Créez une définition de serveur Web pour le serveur Web z/OS local ou distant à l'aide de l'outil de gestion des profils ou de la commande zpmt.
  8. Configurez le plug-in. Vous pouvez soit utiliser la console d'administration, soit exécuter la commande genplugincfg pour créer votre fichier plugin-cfg.xml.
    Remarque : Les deux méthodes créent le fichier de configuration de plug-in, plugin-cfg.xml, au format ASCII. (Il était auparavant généré au format EBCDIC.)
    1. Si vous avez besoin de modifier ce fichier, lancez la commande suivante pour le convertir au format EBCDIC :
      > iconv  -f ISO8859-1 -t IBM-1047 plugin-cfg.xml.ASCII > plugin-cfg.xml.EBCDIC
    2. Apportez les modifications voulues au fichier, puis lancez la commande suivante pour le convertir à nouveau au format ASCII :
      > iconv  -f IBM-1047 -t ISO8859-1  plugin-cfg.xml.EBCDIC > plugin-cfg.xml.ASCII

    Si vous utilisez la console d'administration :

    1. Sélectionnez Serveurs > Types de serveurs > Serveurs Web > nom_serveur_Web > Propriétés du plug-in.
    2. Sélectionnez Générer automatiquement le fichier de configuration du plug-in ou cliquez sur l'une des rubriques suivantes pour configurer manuellement le fichier plugin-cfg.xml :
      • Mise en cache
      • Demande et réponse
      • Acheminement de la demande
      • Service
    3. Cliquez sur OK.
    4. Vous pouvez être amené à arrêter le serveur d'applications et à le redémarrer pour permettre au serveur Web de localiser le fichier plugin-cfg.xml.
  9. Assurez-vous que l'hôte virtuel est configuré avec un alias pour le numéro de port utilisé par HTTP Server z/OS version 5.3. Si vous avez configuré le fichier plugin-cfg.xml manuellement, dans la console d'administration, cliquez sur Serveurs > Types de serveurs > Serveurs Web > nom_serveur_web > Propriétés du plug-in> Acheminement de la demande, et assurez-vous que l'option Utiliser physiquement le port défini dans la demande est sélectionnée pour la propriété Correspondance d'hôte virtuel.
  10. Arrêtez et redémarrez le serveur d'applications et HTTP Server.

    La configuration est terminée. Pour l'activer, arrêtez et redémarrez le serveur d'applications et HTTP Server.

Résultats

Si le plug-in HTTP Server for z/OS se lance correctement lorsque HTTP Server redémarre, les messages suivants s'affichent :
Le plug-in WebSphere HTTP for z/OS version 6.00 Niveau de service 0 se lance
 Initialisation du plug-in WebSphere HTTP plug-in for z/OS avec le fichier de configuration :
         chemin_accès_absolu_au_fichier_plugin-cfg.xml 
L'initialisation du plug-in de WebSphere HTTP pour z/OS a réussi :-)

Que faire ensuite

Une fois que le serveur d'applications, le serveur HTTP et le plug-in sont correctement configurés :
  • Le produit peut utiliser ce plug-in pour exécuter des fonctions de plug-in normales.
  • Les demandes peuvent être acheminées à partir d'un navigateur, via le serveur HTTP et le plug-in, à un serveur d'applications sur lequel l'application demandée est déployée. Les nouvelles demandes sont envoyées à des serveurs d'applications où cette application est déployée, sélectionnés de façon aléatoire. Une fois qu'une session est établie, les demandes sont réacheminées vers le serveur d'applications affecté à la demande d'origine.)
  • Les en-têtes privés peuvent être utilisés comme mécanisme d'acheminement d'informations de proxy entre le plug-in du serveur Web et un serveur d'applications sur un système z/OS. (Ces informations ne sont autrement pas incluses avec les requêtes HTTP.)

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