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.
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.
La herramienta de configuración de plug-ins de servidor web debe reconfigurar el archivo de configuración de un servidor web soportado.
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.
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.
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.
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.
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.
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:
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.
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.
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:
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.
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.
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.
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.