[z/OS]

Instalación y configuración del plug-in para IBM HTTP Server para WebSphere Application Server en z/OS

El plug-in de IBM® HTTP Server para WebSphere Application Server forma parte del componente de plug-in de servidores web de WebSphere Application Server. El plug-in permite a un IBM HTTP Server para WebSphere Application Server comunicarse con un WebSphere Application Server. Para utilizar este plug-in, debe tener un IBM HTTP Server para WebSphere Application Server, que esté basado en Apache, y que se ejecute en z/OS.

Antes de empezar

Antes de instalar el plug-in, instale el software de IBM HTTP Server para WebSphere Application Server en el sistema z/OS y configure una instancia de IBM HTTP Server. Consulte la documentación del producto para instalar IBM HTTP Server para WebSphere Application Server en z/os.

Acerca de esta tarea

Como parte del proceso de configuración del servidor web, creará un directorio de instalación para la instancia del servidor web. En los ejemplos que aparecen a continuación, se utiliza el valor /etc/websrv1 para el directorio de instalación del servidor web. La ubicación recomendada para los archivos de configuración del plug-in es el subdirectorio Plugins del directorio de instalación del servidor web. El directorio Plugins contendrá un subdirectorio conf/nombre_servidorweb_WAS y el archivo de configuración del plug-in plugin-cfg.xml normalmente residirá en este directorio.

Este procedimiento describe cómo instalar y configurar el plug-in para IBM HTTP Server para WebSphere Application Server en z/os.

Procedimiento

  1. Instale los plug-in de servidor web. Utilice IBM Installation Manager para instalar los plug- de servidor web para WebSphere Application Server para z/OS y monte el sistema de archivos del producto en su sistema z/OS de destino. De forma predeterminada, los plug-ins se encuentran en el directorio /usr/lpp/WebSphere/Plugins/V9R0.
  2. Inicie una sesión en el shell OMVS utilizando el ID del servidor para la instancia del servidor web. Los scripts install_plugin y ConfigureIHSPlugin se deben ejecutar bajo este ID de usuario, de forma que todos los archivos son propiedad del mismo grupo que la instancia del servidor web.
  3. Cree un directorio de instalación para el plug-in. El directorio del plug-in contendrá información de configuración que utilizará el plug-in cuando se ejecute en esta instancia del servidor web. La ubicación recomendada para este directorio es el subdirectorio Plugins del directorio de instalación de la instancia del servidor web.
    Para crear la imagen de instalación del tiempo de ejecución, ejecute el mandato ubicación_smp_plugin/bin/install_plugin.sh:
    ./install_plugin.sh 
       -pluginInstallLocation directorio_producto_de_código_plugin
       -pluginRuntimeLocation directorio_instalación_de_plugin_servidor_Web
       -wasInstallLocation    directorio_producto_de_WebSphere_Application_Server
    El siguiente ejemplo es una muestra de invocación de este mandato:
    cd /usr/lpp/WebSphere/Plugins/V9R0/bin
    ./install_plugin.sh   
       -pluginInstallLocation /usr/lpp/WebSphere/Plugins/V9R0/
       -pluginRuntimeLocation /etc/websrv1/Plugins
       -wasInstallLocation    /usr/lpp/WebSphere/AppServer/V9R0
  4. Configure la instancia de IBM HTTP Server para z/OS para utilizar el plug-in del servidor web.
    Ejecute el mandato ubicación_ejecución_plugin/bin/ConfigureIHSPlugin.sh para configurar el IBM HTTP Server para utilizar el plug-in del servidor web:
    ./ConfigureIHSPlugin.sh
       -plugin.home        directorio_instalación_plugin_servidor_Web
       -plugin.config.xml  ubicación_de_archivo_plugin-cfg.xml
       -ihs.conf.file      ubicación_de_archivo_httpd.conf
       -operating.system   ZOS
       -WAS.webserver.name nombre_Webserver_definido_en_WebSphere_Application_Server
       -WAS.host.name      nombrehost_o_dirección_IP_de_WebSphere_Application_Server
    El siguiente ejemplo es una muestra de invocación de este mandato:
    cd /etc/websrv1/Plugins/bin
    ./ConfigureIHSPlugin.sh 
       -plugin.home /etc/websrv1/Plugins 
       -plugin.config.xml /etc/websrv1/Plugins/config/webserver1/plugin-cfg.xml
       -ihs.conf.file /etc/websrv1/conf/httpd.conf 
       -operating.system ZOS
       -WAS.webserver.name webserver1 
       -WAS.host.name appsrv1.mycorp.com
  5. Cree una definición de servidor web en WebSphere Application Server para el servidor web local o remoto de z/OS.
    • Para añadir una definición de servidor web durante la creación de servicios, utilice la herramienta de gestión de perfiles o el mandato zpmt.
    • Para añadir un servidor web a un perfil de WebSphere Application Server existente, utilice la consola administrativa, el script createWebServerDefinition.jacl o el mandato wsadmin createWebServer.
    Cuando defina el servidor web en WebSphere Application Server:
    • Para el nombre del servidor web, utilice el valor especificado para WAS.webserver.name
    • Para el directorio de instalación del plug-in del servidor web, utilice el valor especificado para PluginRuntimeLocation
  6. Configure el plug-in. Utilice la consola administrativa o bien emita el mandato GenPluginCfg para crear su archivo plugin-cfg.xml.
    Avoid trouble Avoid trouble: Debe suprimir el archivo plugin-cfg.xml que se encuentra en el directorio raíz_perfil/config/cells para poder realizar esta tarea. De lo contrario, los cambios de configuración no permanecerán en el archivo plugin-cfg.xml.gotcha
    Nota: Ambos métodos crean el archivo de configuración del plug-in, plugin-cfg.xml, en formato ASCII.
    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 > 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.

    Podría necesitar copiar manualmente el archivo plugin-cfg.xml en la ubicación correcta del directorio de instalación del plug-in del servidor web.

  7. Asegúrese de que el host virtual se ha configurado con un alias de número de puerto que utilice IBM HTTP Server para z/OS. Si ha configurado manualmente el archivo plugin-cfg.xml, vaya a la página Servidores > Tipos de servidor > Servidores de aplicaciones WebSphere > Propiedades de plug-in > Solicitud y respuesta en la consola administrativa y asegúrese de que se haya seleccionado Utilizar físicamente el puerto especificado en la solicitud para Coincidencia de host virtual.
  8. Si desea que habilitar el plug-in del servidor web para que utilice cabeceras privadas, defina un repertorio de configuraciones SSL que defina un archivo de confianza. A continuación, en la consola administrativa, pulse Servidores > Tipos de servidor > Servidores de aplicaciones WebSphere > nombre_servidor y, a continuación, en la sección Valores de contenedor, pulse Valores del contenedor web > Cadenas de transporte del contenedor web > cadena_transporte_seguro > Canal SSL de entrada (SSL_2) y especifique este repositorio para esa cadena de transporte.
    Avoid trouble Avoid trouble: El archivo de confianza proporciona la misma funcionalidad para IBM HTTP Server para z/OS, basado en Apache, que la propiedad personalizada TrustedProxy proporcionada por la versión 5.3 de HTTP Server para z/OS en versiones anteriores del producto.gotcha

    Si intenta utilizar cabeceras privadas sin definir un repertorio de configuraciones SSL que no incluye una definición de archivo de confianza, se ignorarán las cabeceras privadas. Si se ignoran las cabeceras privadas, quizá el servidor de aplicaciones no localice la aplicación solicitada.

    Después de habilitar el uso de cabeceras privadas, el canal SSL de entrada de la cadena de transporte confía en todas las cabeceras privadas que recibe. Por lo tanto, debe asegurarse de que todas las vías de acceso al canal SSL de entrada de la cadena de transporte son de confianza.

  9. Si desea habilitar el plug-in del servidor web para utilizar un conjunto de claves SAF (System Authorization Facility), en lugar del archivo kdb con una propiedad stashfile, debe crear las dos siguientes propiedades de plug-in personalizadas desde la consola administrativa.
    • KeyringLocation, que se establece en la ubicación de directorio del conjunto de claves de SAF
    • StashfileLocation, que se establece en "" (nulo)

    Consulte la información acerca de las propiedades de configuración del plug-in de servidor Web para obtener las instrucciones sobre cómo crear KeyringLocation y StashfileLocation desde la consola administrativa con objeto de utilizar un conjunto de claves de SAF en la configuración SSL. Consulte también la información del archivo plugin-cfg.xml.

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

Resultados

Si el plug-in del IBM HTTP Server para z/OS se activa correctamente cuando se vuelve a iniciar IBM HTTP Server, se añade un mensaje al archivo de anotaciones cronológicas del plug-in, /dir_tiempo_ejecución_plugin/log/nombre_servidor_web/http_plugin.log. El mensaje que aparece en http_plugin.log es similar a la siguiente salida de ejemplo:

PLUGIN: Plugins loaded.
PLUGIN: --------------------System Information-----------------------
PLUGIN: Bld version: 9.0.0
PLUGIN: Bld date: Jun 13 2016, 09:55:09
PLUGIN: Webserver: IHS 390 Webserver: Http Plug-in Build Info: build level 9.0.0.0 (cf031208.05) release WAS90.ZNATV date 06/13/16 09:54:07
PLUGIN: Hostname = ZWASAXXX
PLUGIN: NOFILES = hard: 64000, soft: 64000
PLUGIN: MAX COREFILE SZ = hard: 4194304, soft: 4194304
PLUGIN: DATA = hard: INFINITE, soft: INFINITE
PLUGIN: --------------------------------------------------------------

Qué hacer a continuación

Después de haber configurado correctamente el servidor de aplicaciones, IBM HTTP Server y el plug-in:
  • WebSphere Application Server para z/OS puede utilizar este plug-in para realizar funciones normales de plug-in.
  • Las solicitudes pueden direccionarse desde un navegador, mediante IBM HTTP Server y el plug-in, a un servidor de aplicaciones en el que la aplicación solicitada se ha desplegado. Se envía una nueva solicitud a un servidor de aplicaciones seleccionado de forma aleatoria en el que se despliega la aplicación. Una vez establecida una sesión, las solicitudes subsiguientes se direccionan al servidor de aplicaciones que se asignó a la solicitud original.
  • Utilice las cabeceras privadas como mecanismo para el reenvío de información del proxy desde el plug-in de servidor Web a un servidor de aplicaciones en 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_ihsz
File name: trun_plugin_ihsz.html