[z/OS]

Instalación y configuración del plug-in para HTTP Server V5.3 para z/OS

El plug-in de HTTP Server para z/OS es parte del componente de plug-ins de servidor web de WebSphere Application Server para z/OS. Para utilizar este plug-in, debe disponer de la versión 5.3 de HTTP Server para z/OS configurada como parte de un sistema z/OS.

Acerca de esta tarea

Nota: En WebSphere Application Server for z/OS versión 7 y anteriores, el plug-in de servidor web para IBM® HTTP Server (IHS/390) se encontraba en el directorio bin del producto base de WebSphere Application Server for z/OS. En la Versión 8.0, este plug-in se encuentra en el directorio bin del sistema de archivos de producto de plug-ins de servidor web, y el plug-in se ha renombrado de ihs390WAS70Plugin_http.so a ihs390WASPlugin_http.so.

El servidor HTTP versión 5.3 para z/OS se proporciona con el sistema operativo básico z/OS. HTTP Server para z/OS no es un servidor basado en Apache. HTTP Server para z/OS no soporta la arquitectura de 64 bits y no soporta IPv6.

Este procedimiento describe cómo instalar y configurar el plug-in para el servidor HTTP para z/OS.

Procedimiento

  1. Asegúrese de que la versión 5.3 de HTTP Server para z/OS esté instalada en un sistema z/OS.
  2. Instale los plug-ins de servidor web. Utilice IBM Installation Manager para instalar los plug-ins de servidor web para WebSphere Application Server para z/OS y monte el sistema de archivos de producto en el sistema z/OS de destino. De forma predeterminada, los plug-ins se encuentran en el directorio /usr/lpp/WebSphere/Plugins/V9R0.
  3. Si HTTP Server no tiene acceso al sistema de archivos del producto de plug-ins de servidor web, realice los pasos siguientes para bajar, en formato binario, el plug-in HTTP Server para z/OS y el archivo plugin-cfg.xml desde el LPAR en el que se está ejecutando el servidor de aplicaciones al LPAR en el que está instalado el HTTP Server. El directorio al que se baja el plug-in debe tener acceso de lectura para el ID de MVS bajo el que se está ejecutando el HTTP Server.
    1. Utilice FTP u otro mecanismo de transferencia de archivos para bajar, en formato binario, el plug-in HTTP Server para z/OS desde el directorio de instalación al sistema de HTTP Server y a un directorio con acceso de lectura para el ID de MVS bajo el que se está ejecutando HTTP Server. La DLL ihs390wasplugin_http.so se encuentra en el directorio /bin/ de los plug-ins de servidor web; por ejemplo:
      /usr/lpp/WebSphere/Plugins/V9R0/bin 
    2. Establezca los permisos (755 +p) en el archivo ihs390wasplugin_http.so del plug-in. Utilizando un ID de usuario de z/OS autorizado, emita los siguientes mandatos desde un indicador de línea de mandatos OMVS para activar el bit "p" en el HFS donde ahora se encuentra el plug-in HTTP Server para z/OS:
      chmod 755 ihs390WASPlugin_http.so
      extattr +p ihs390WASPlugin_http.so
      Para comprobar el resultado del mandato extattr, emita el siguiente mandato:
      ls -E  ihs390WASPlugin_http.so
      A continuación, busque "ps" en los atributos ampliados. Por ejemplo:
      -rwxr-xr-x  -ps-  1 USER123  WASUSER  1482752 Aug  2 14:17 ihs390WASPlugin_http.so
  4. Ejecute setup.sh para crear dos archivos, httpd.conf y httpd.enwars, para personalizar y configurar el servidor web. Crea los archivos httpd.conf y httpd.enwars en el directorio /etc. El archivo setup.sh se encuentra en el directorio usr/lpp/internet/sbin.
  5. Añada las directivas ServerInit, ServerTerm y Service al archivo de configuración httpd.conf de HTTP Server:
    • Añada las siguientes directivas ServerInit y ServerTerm para indicar los puntos de entrada a las rutinas de inicialización y salida del plug-in. Estas rutinas existen como puntos de entrada init_exit y term_exit, respectivamente, en el archivo DLL ihs390WASPlugin_http.so.
      Avoid trouble Avoid trouble:
      • En esta descripción, las directivas ServerInit y Service se dividen por consideraciones de impresión. En el archivo httpd.conf real, especifique cada una de las directivas en una sola línea.
      • En la directiva ServerInit, conf_plug-in_http representa la vía de acceso completa a la ubicación del archivo plugin-cfg.xml.
      • En las directivas ServerInit, Service y ServerTerm, http_plugin_dir representa una de las dos posibilidades siguientes:
        1. La vía de acceso completa del directorio de plug-ins de servidor web de WebSphere Application Server como, por ejemplo, /usr/lpp/WebSphere/Plugins/V9R0, si HTTP Server está en el mismo LPAR que WebSphere Application Server o
        2. La vía de acceso completa que ha designado como destino de la operación de FTP del paso anterior, si HTTP Server no se encuentra en un sistema con acceso al sistema de archivos de producto de plug-ins de servidor web.
      gotcha
      ServerInit /http_plugin_dir/bin/
          ihs390WASPlugin_http.so:init_exit /http_plugin_conf/
          plugin-cfg.xml
      ServerTerm /dir_plugin_http/bin/ihs390WASPlugin_http.so:term_exit
    • Añada la siguiente directiva Service para cada aplicación que utilice el plug-in del servidor web. Esta directiva indica el punto de entrada a la rutina de petición del plug-in. La rutina de solicitud existe como el punto de entrada service_exit en el archivo DLL (Dynamic Link Library) ihs390WASPlugin_http.so.
      Service
      /raíz_contexto_aplicación_web/*  /http_plugin_dir/
           ihs390WASPlugin_http.so:service_exit

      raíz_contexto_aplicación_web es el directorio raíz de contexto de la aplicación.

    transition: El plug-in de servidor web para z/OS HTTP Server, Versión 5.3, utiliza una interfaz SSL distinta a la interfaz SSL utilizada en versiones anteriores del producto. El PTF UK35083 de z/OS incluye el cambio de la interfaz SSL para z/OS HTTP Server, Versión 5.3, que corresponde a este cambio en el plug-in del servidor web. Por lo tanto, este PTF se debe aplicar al sistema para que la nueva interfaz SSL del plug-in del servidor web pueda funcionar correctamente.

    También debe incluir la opción SSLMode multi en el archivo httpd.conf para z/OS HTTP Server, Versión 5.3. Si la opción SSLMode multi no se especifica en el archivo httpd.conf, o si no tiene el PTF UK35083 de z/OS aplicado al sistema, es posible que reciba el mensaje de error IMW0584W, que indica que la modalidad SSL especificada para HTTP Server no es compatible con la modalidad SSL para el plug-in del servidor web que se utiliza con z/OS HTTP Server, Versión 5.3. En cualquiera de estas situaciones, se pueden producir resultados inesperados.

    Avoid trouble Avoid trouble:
    1. HTTP Server interpreta los espacios en blanco en la especificación de la directiva como delimitadores y los símbolos de almohadilla (#) como el principio de un comentario que se debe ignorar. Por lo tanto, si necesita utilizar un espacio en blanco o un símbolo de almohadilla en una directiva, debe incluir una barra inclinada invertida (\) antes del espacio en blanco o el símbolo de almohadilla para permitir que el HTTP Server procese correctamente la directiva.
    2. Si un servlet establece un código de respuesta HTTP de alguna manera, como mediante los métodos lastModified() o setStatus(), y el cliente no recibe el código de respuesta esperado, añada la siguiente directiva al archivo de configuración de HTTP Server:
      ServiceSync On
    gotcha
  6. Si el archivo httpd.conf contiene una directiva Pass que se ha establecido en /*, asegúrese de que las directivas Service precedan la directiva Pass.
  7. Cree una definición de servidor web para el servidor web de z/OS local o remoto utilizando la Herramienta de gestión de perfiles o el mandato zpmt.
  8. Configure el plug-in. Utilice la consola administrativa o bien emita el mandato genplugincfg para crear su archivo plugin-cfg.xml.
    Nota: Ambos métodos crean el archivo de configuración del plug-in, plugin-cfg.xml, en formato ASCII. (Anteriormente, el archivo de configuración se generaba en formato EBCDIC.)
    1. Si necesita editar este archivo, emita el mandato siguiente para convertir el archivo al formato EBCDIC:
      > iconv  -f ISO8859-1 -t IBM-1047 plugin-cfg.xml.ASCII > plugin-cfg.xml.EBCDIC
    2. Edite el archivo, a continuación, emita el mandato siguiente para volver a convertirlo al formato ASCII:
      > iconv  -f IBM-1047 -t ISO8859-1  plugin-cfg.xml.EBCDIC > plugin-cfg.xml.ASCII

    Para utilizar la consola administrativa:

    1. Seleccione Servidores > Tipos de servidor > Servidores web >nombre_servidor_web> Propiedades de plug-in.
    2. Seleccione Generar automáticamente el archivo de configuración del plug-in o pulse en uno o más temas de los siguientes para configurar manualmente el archivo plugin-cfg.xml:
      • Colocación en memoria caché
      • Solicitud y respuesta
      • Direccionamiento de solicitudes
      • Servicio
    3. Pulse Aceptar.
    4. Es posible que tenga que detener el servidor de aplicaciones y, a continuación, iniciar el servidor de aplicaciones nuevo para permitir que el servidor web localice el archivo plugin-cfg.xml.
  9. Asegúrese de que el host virtual se ha configurado con un alias de número de puerto que utilice z/OS V5.3 HTTP Server. Si ha configurado manualmente el archivo plugin-cfg.xml, en la consola administrativa, pulse Servidores > Tipos de servidor > Servidores web >nombre_servidor_web> Propiedades de plug-in > Direccionamiento de solicitudes y compruebe que Utilizar físicamente el puerto especificado en la solicitud se haya seleccionado para la propiedad Coincidencia de host virtual.
  10. Detenga el servidor de aplicaciones y el HTTP Server e inícielos de nuevo.

    La configuración está completa. Para activar la configuración, detenga y, a continuación, reinicie el servidor de aplicaciones y el servidor HTTP.

Resultados

Si el plug-in HTTP Server para z/OS aparece cuando se vuelve a iniciar HTTP Server, recibirá los mensajes siguientes:
El plug-in HTTP de WebSphere para z/OS versión 6.00 nivel de servicio 0 se ha iniciado
 El plug-in HTTP de WebSphere para z/OS se está inicializando con el archivo de configuración:
         vía_de_acceso_totalmente_cualificada_al_archivo_plugin-cfg.xml 
La inicialización del plug-in HTTP de WebSphere para z/OS ha sido correcta

Qué hacer a continuación

Una vez que el servidor de aplicaciones, el HTTP Server y el plug-in se han configurado adecuadamente:
  • El producto puede utilizar este plug-in para realizar funciones normales de plug-in.
  • Las peticiones pueden direccionarse desde un navegador, mediante un HTTP Server y un plug-in, a un servidor de aplicaciones en el que la aplicación solicitada se ha desplegado. (Las nuevas peticiones se envían a servidores de aplicaciones seleccionados al azar en los que esta aplicación se despliega. Una vez establecida una sesión, las peticiones se direccionan de vuelta al servidor de aplicaciones que se encargó de la petición original.
  • Las cabeceras privadas se pueden utilizar como un mecanismo para reenviar la información de proxy desde el plug-in de servidor de web a un servidor de aplicaciones de un sistema z/OS. (Esta información no se incluye en las solicitudes HTTP.)

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=trun_plugin_390
File name: trun_plugin_390.html