Configuración del servidor Web

La configuración de plug-in implica la configuración del servidor web para utilizar el módulo de plug-in binario que proporciona WebSphere® Application Server . La configuración de plug-in también incluye la actualización del archivo de configuración XML de plug-in para reflejar la configuración actual del servidor de aplicaciones. El módulo binario utiliza el archivo XML para ayudar a direccionar las peticiones de cliente web.

Después de instalar un servidor web soportado, debe instalar los plug-ins de servidor web. El módulo de plug-in permite que el servidor web se comunique con el servidor de aplicaciones. La herramienta de configuración de plug-ins del servidor Web permite configurar el servidor web y crear una definición de servidor web en la configuración del servidor de aplicaciones. La herramienta de configuración de plug-ins de servidor web utiliza los siguientes archivos para configurar un plug-in para el servidor web que elija:

El archivo de configuración del servidor web en la máquina del servidor web, como por ejemplo el archivo httpd.conf para IBM® HTTP Server.
El archivo del plug-in de servidor web binario en la máquina del servidor web.
El archivo de configuración del plug-in, plugin-cfg.xml, en la máquina del servidor de aplicaciones que se propaga (copia) en una máquina del servidor Web.
El archivo de configuración del plug-in (temporal) por omisión, plugin-cfg.xml, en la máquina del servidor web.
El script deconfigureweb_server_name que copia desde la máquina del servidor web a la máquina del servidor de aplicaciones.

El proceso de configuración de plug-ins utiliza los siguientes archivos para configurar un plug-in para el servidor web que elija:

El archivo de configuración del servidor web en la máquina del servidor web, como por ejemplo el archivo httpd.conf para IBM HTTP Server.
El archivo del plug-in de servidor web binario en la máquina del servidor web.
El archivo de configuración del plug-in, plugin-cfg.xml, en la máquina del servidor de aplicaciones que se propaga (copia) en una máquina del servidor Web.
El script de configuración para configurar la definición de servidor web del servidor de aplicaciones se encuentra en un caso de ejemplo de HTTP remoto.

Consulte las siguientes descripciones de cada archivo.

Archivo de configuración del servidor Web

El archivo de configuración del servidor web se instala como parte del servidor web.

[AIX Solaris HP-UX Linux Windows] La herramienta de configuración de plug-ins de servidor web debe reconfigurar el archivo de configuración de un servidor web soportado.

La configuración consiste en añadir directivas que identifican las ubicaciones de dos archivos:

Archivo del plug-in de servidor web binario
Archivo de configuración de plug-in, plugin-cfg.xml

Archivo del plug-in de servidor web binario

Un ejemplo de un módulo de plug-in binario es el archivo mod_was_ap22_http.dll para IBM HTTP Server en la plataforma Windows.

[IBM i] Otro ejemplo de un módulo de plug-in binario es el programa de servicio QSVTAP20 en la plataforma IBM i .

El archivo del plug-in binario no cambia. No obstante, el archivo de configuración del plug-in binario es un archivo XML. El servidor de aplicaciones cambia el archivo de configuración cuando se producen determinados cambios en la configuración de WebSphere Application Server .

El módulo binario lee el archivo XML para ajustar los valores y direccionar las peticiones al servidor de aplicaciones.

Archivo de configuración de plug-in, plugin-cfg.xml

El archivo de configuración del plug-in es un archivo XML con valores que se pueden ajustar en la consola administrativa. El archivo enumera todas las aplicaciones instaladas en la definición de servidor web. El módulo binario lee el archivo XML para ajustar los valores y direccionar las peticiones al servidor de aplicaciones.

[AIX Solaris HP-UX Linux Windows] El servidor de aplicaciones autónomo vuelve a generar el archivo plugin-cfg.xml en el directorio raíz_perfil/config/cells/nombre_célula/nodes/nombre_servidor_web_node/servers/nombre_servidor_web . La regeneración se realiza siempre que se produce un cambio en la configuración del servidor de aplicaciones que afecta a las aplicaciones desplegadas.

[IBM i] Al efectuar cambios de configuración del servidor de aplicaciones que afecten a las aplicaciones desplegadas, vuelva a generar el archivo XML de configuración de plug-in.

Después de la regeneración, propague (copie) el archivo en la máquina del servidor web. A continuación, el plug-in binario tiene acceso a la copia más reciente de su archivo de configuración.

[AIX Solaris HP-UX Linux Windows] El servicio de configuración del plug-in de servidor web vuelve a generar automáticamente el archivo plugin-cfg.xml después de determinados sucesos que cambian la configuración. El servicio de configuración propaga automáticamente el archivo plugin-cfg.xml a una máquina de IBM HTTP Server cuando se vuelve a generar el archivo. Debe copiar manualmente el archivo en otros servidores web.

[IBM i] En sistemas IBM i , el plug-in no se genera automáticamente. Debe regenerar y propagar manualmente el archivo.

El archivo de configuración del plug-in por omisión, plugin-cfg.xml

La herramienta de configuración de plug-ins de servidor web también crea el archivo plugin-cfg.xml temporal en el directorio raíz_plug-ins/config/nombre_servidor_web. La herramienta crea el archivo de cada escenario de instalación remota.

El archivo por omisión es un espacio reservado que se debe sustituir por el archivo plugin-cfg.xml de la definición de servidor web en el servidor de aplicaciones. El archivo predeterminado es una réplica del archivo que crea el servidor de aplicaciones para un servidor de aplicaciones autónomo predeterminado.

Ejecute el script configureweb_server_name desde el directorio raíz_servidor_aplicaciones/bin de la máquina del servidor de aplicaciones para una instalación remota o directamente desde el directorio raíz_plugins/bin para una instalación local. El script crea la definición de servidor web en los archivos de configuración del perfil por omisión. Para configurar un perfil distinto del predeterminado, edite el script configureweb_server_name . Utilice el parámetro -profileName para identificar un perfil distinto del perfil por omisión.

Una vez creada la definición de servidor web, el servicio de configuración del plug-in del servidor web dentro del servidor de aplicaciones crea el primer archivo plugin-cfg.xml en la definición de servidor web en la máquina del servidor de aplicaciones. Si instala una aplicación, crea un host virtual o realiza alguna operación que modifica la configuración, debe propagar el archivo plugin-cfg.xml actualizado desde la máquina del servidor de aplicaciones a la máquina del servidor web para sustituir el archivo por omisión.

Configure el script `nombre_servidor_web` para la definición del servidor web

La herramienta de configuración de plug-ins de servidor web crea el script configureweb_server_name en la máquina del servidor web en el directorio raíz_plugins/bin . Si una máquina de un escenario remoto se ejecuta en un sistema operativo como AIX® o Linux® y la otra máquina se ejecuta en Windows, utilice el script creado en el directorio plugins_root/bin/crossPlatformScripts . El script sólo se crea para escenarios de instalación remota.

Copie el script de la máquina del servidor web en el directorio raíz_servidor_aplic/bin en una máquina de servidor de aplicaciones remoto. No tiene que copiar el script en una instalación local. Ejecute el script para crear la definición de servidor web en la configuración del servidor de aplicaciones:

Cuando utilice IBM HTTP Server, configure también el servidor de administración IBM HTTP . El servidor de administración IBM HTTP funciona con la consola administrativa para gestionar definiciones de servidor web. Asimismo, utilice la consola administrativa para actualizar la definición de servidor web con las opciones de gestión del servidor web remoto. Pulse Servidores > Tipos de servidor > Servidores web > nombre_servidor_web para ver las opciones de configuración. Por ejemplo, pulse Gestión del servidor Web remoto para cambiar propiedades como, por ejemplo:

Nombre de host
Puerto administrativo
ID de usuario
Contraseña

Importante: Abra siempre una nueva ventana de mandatos antes de ejecutar este script. De esta forma puede evitar posibles problemas.

El problema es un conflicto entre una variable de entorno del shell, la variable de entorno WAS_USER_SCRIPT, y el perfil por omisión real. El script siempre trabaja con el perfil por omisión. No obstante, si se establece la variable de entorno WAS_USER_SCRIPT, surge un conflicto cuando el script intenta trabajar en el perfil identificado por la variable.

La variable se puede establecer fácilmente por accidente. Emita un mandato cualquiera desde el directorio raíz_perfil/bin de un perfil y la variable se establecerá en ese perfil.

Si tiene más de un perfil en el sistema, existe la posibilidad de que el perfil por omisión y el perfil identificado por la variable sean perfiles diferentes. Si este es el caso, se produce un conflicto y el script no podrá crear la definición de servidor web en el perfil correcto, o puede que ni siquiera cree la definición de servidor web.

Restablezca la variable de cualquiera de estos dos modos:

Cierre la ventana de mandatos donde se ha establecido la variable y abra una nueva.
Cambie de directorio a raíz_perfil/bin del perfil por omisión y cree el origen del script setupCmdLine.sh:
1. Abra una ventana de indicador de mandatos.
2. Vaya al directorio raíz_servidor_aplicaciones\bin .
3. Emita el mandato setupCmdLine.bat .
1. Abra una ventana de shell de mandatos.
2. Vaya al directorio raíz_servidor_aplicaciones/bin .
3. Emita el mandato . ./setupCmdLine.sh . Tenga en cuenta el espacio entre los puntos. El formato especial de este mandato hace que el mandato active el valor para todos los procesos iniciados desde el shell de mandatos.

Si ya existe una definición de servidor web para un servidor de aplicaciones autónomo, la ejecución del script no añade una nueva definición de servidor web. Cada servidor de aplicaciones autónomo puede tener sólo una definición de servidor web.

No puede utilizar la consola administrativa de un servidor de aplicaciones autónomo para añadir o suprimir una definición de servidor Web. No obstante, puede realizar ambas tareas utilizando la interfaz de scripts de administración:

Añada una definición de servidor web mediante el servicio wsadmin utilizando el script configurenombre_servidor_Web. El script utiliza un script Jacl (Java™ Command Language) denominado configureWebserverDefintion.jacl para crear y configurar la definición de servidor web.

Suprima una definición de servidor web utilizando mandatos de wsadmin. En el siguiente ejemplo, el servidor Web se denomina webserver1:

 set webserverName webserver1
 set webserverNodeSuffix _node
 set webserverNodeName   $webserverName$webserverNodeSuffix
 $AdminConfig remove [$AdminConfig getid /Node:$webserverNodeName/Server:$webserverName]
 $AdminConfig remove [$AdminConfig getid /Node:$webserverNodeName]
 $AdminConfig save

Script de configuración para la definición de servidor Web

La configuración del servidor web con el script configureOs400WebserverDefinition o utilizando la GUI administrativa de IBM i crea el script configureweb_server_name en la máquina del servidor web en el directorio plugins_root/bin . El script sólo se crea para escenarios de instalación remota.

Copie el script de la máquina del servidor web en el directorio raíz_servidor_aplicaciones/bin de la partición IBM i . Ejecute el script para crear la definición de servidor web en la configuración del servidor de aplicaciones:

La GUI administrativa de IBM i tiene plug-ins que permiten a la consola administrativa gestionar IBM HTTP Servers. Utilice la consola administrativa para actualizar la definición de servidor web con las opciones de gestión del servidor web remoto. Pulse Servidores > Tipos de servidor > Servidores web > nombre_servidor_web para ver las opciones de configuración. Por ejemplo, pulse Gestión del servidor Web remoto para cambiar propiedades como, por ejemplo:

Nombre de host
Puerto administrativo
ID de usuario
Contraseña

No puede utilizar la consola administrativa de un servidor de aplicaciones autónomo para añadir o suprimir una definición de servidor web. No obstante, puede realizar ambas tareas utilizando la interfaz de scripts de administración:

Añada una definición de servidor web a través del recurso wsadmin utilizando el script configureweb_server_name . El script utiliza un script Jacl (Java Command Language) denominado configureWebserverDefintion.jacl para crear y configurar la definición de servidor web.

Suprima una definición de servidor web utilizando mandatos de wsadmin. En el siguiente ejemplo, el servidor Web se denomina webserver1:

set webserverName webserver1
set webserverNodeSuffix _node
set webserverNodeName 
$webserverName$webserverNodeSuffix
$AdminConfig remove 
  [$AdminConfig getid 
    /Node:$webserverNodeName/Server:$webserverName]
$AdminConfig remove 
  [$AdminConfig getid /Node:$webserverNodeName]
$AdminConfig save

Como alternativa, puede utilizar los scripts configureOs400WebServerDefinition y removeOs400WebServerDefinition para realizar estas tareas.

Sustitución del archivo de configuración del plug-in por omisión por el archivo de la definición de servidor web (propagación)

El archivo por omisión utiliza valores de parámetros fijos que puede que no coincidan con los valores de parámetros en el archivo que hay en el servidor de aplicaciones. El archivo por omisión sólo es un espacio reservado.

El archivo no puede reflejar los cambios que se producen en la configuración del servidor de aplicaciones. El archivo tampoco puede reflejar los valores distintos de los valores predeterminados que se estén aplicando en el servidor de aplicaciones.

[AIX Solaris HP-UX Linux Windows] El servidor de aplicaciones debe tener los valores siguientes en el archivo plugin-cfg.xml real. En este caso, el archivo por omisión puede configurar correctamente el módulo de plug-in binario. A continuación, el módulo de plug-in puede comunicarse correctamente con el servidor web y el servidor de aplicaciones.

[AIX Solaris HP-UX Linux Windows] Suponga que el servidor de aplicaciones no tiene los valores siguientes en el archivo plugin-cfg.xml real. En este caso, el archivo por omisión configura incorrectamente el módulo de plug-in binario. El módulo de plug-in siempre puede comunicarse con el servidor web. Pero con un archivo de configuración incorrecto, el módulo de plug-in no puede comunicarse correctamente con el servidor de aplicaciones.

Los valores siguientes son valores de parámetros fijos del archivo temporal de configuración del plug-in.

Nombre del host virtual
valor predeterminado: default_host

Este host virtual se configura para dar servicio a DefaultApplication. Este valor probablemente es el mismo que el valor del archivo plugin-cfg.xml real. No obstante, supongamos que crea otro host virtual para dar servicio a las aplicaciones y que instala DefaultApplication en él. En este caso, se vuelve a generar el archivo plugin-cfg.xml. El servidor web no puede acceder a DefaultApplication. (La aplicación incluye el servlet snoop y el servlet hitcount).

Para acceder a las aplicaciones en el nuevo host virtual, propague el archivo plugin-cfg.xml real. La propagación consiste en copiar el archivo actualizado de la máquina del servidor de aplicaciones en la máquina del servidor web.
Puerto de transporte HTTP
Valor predeterminado: 9080

El valor 9080 es el valor predeterminado del puerto de transporte HTTP del host virtual default_host. Este valor probablemente es el mismo que el valor del archivo actualizado. No obstante, este valor cambia para cada perfil en la máquina del servidor de aplicaciones. El valor del puerto de transporte HTTP debe ser exclusivo para cada servidor de aplicaciones.

Para comunicarse con otro puerto, propague el archivo plugin-cfg.xml real.
Puerto de escucha del servidor Web
Valor predeterminado: 80

El valor 80 es el valor predeterminado del puerto que controla la comunicación con el servidor web. No obstante, cada perfil de servidor de aplicaciones debe tener un valor de puerto exclusivo para comunicarse con un servidor web. El valor del puerto real puede ser 81 u otro número.

Para comunicarse con otro puerto, propague el archivo plugin-cfg.xml real.
Puerto de transporte HTTPS
Valor predeterminado: 9443

El valor 9443 es el valor predeterminado del puerto de transporte HTTPS (seguro) del host virtual default_host. Este valor probablemente es el mismo que el valor del archivo actualizado. No obstante, este valor cambia para cada perfil en la máquina del servidor de aplicaciones. El valor del puerto de transporte HTTPS debe ser exclusivo para cada servidor de aplicaciones.

Para comunicarse con otro puerto seguro, propague el archivo plugin-cfg.xml real.
Aplicaciones instaladas en el servidor de aplicaciones server1
Todas las aplicaciones y los servlets por omisión se incluyen en el archivo por omisión.

Para dar servicio a una aplicación que ha desarrollado con el servidor web, propague el archivo plugin-cfg.xml real.