[AIX Solaris HP-UX Linux Windows][IBM i]

Configuración de plug-ins

La herramienta de configuración de plug-ins de servidor web configura un servidor de aplicaciones para un tipo de servidor web y crea una definición de servidor web en la configuración del servidor de aplicaciones. Familiarícese con las distintas vías de acceso de proceso que la herramienta de configuración de plug-ins de servidor web puede utilizar.

En este artículo se describen los dos modos en que la herramienta de configuración de plug-ins de servidor web puede configurar un servidor web y crear el archivo plugin-cfg.xml, que es el archivo de configuración del plug-in.

Supported configurations Supported configurations: Esta herramienta sólo tiene soporte en AIX, Linux y Windows. Como alternativa a utilizar la Herramienta de configuración de plug-ins de servidor web, puede utilizar la herramienta de línea de mandatos pct con un archivo de respuestas para configurar un servidor web. Para obtener más información, consulte Configuración de un plug-in de servidor web utilizando la herramienta pct.sptcfg
Antes de empezar: Los archivos de configuración de plug-ins y servidor web se actualizan durante la configuración de los plug-ins. Si utiliza la herramienta de configuración de plug-ins de servidor web o la herramienta de línea de mandatos pct como un usuario no root, verifique que tiene los privilegios adecuados para actualizar los archivos de configuración de los plug-ins del servidor web así como los archivos de configuración del servidor web (como IHS) antes de iniciar una configuración, especialmente si no es el propietario de estos archivos.
Atención: Al utilizar la herramienta de configuración de plug-ins de servidor web para configurar IBM® HTTP Server Administration Server, se debe ejecutar Websphere Customization Toolbox como una cuenta "local" con privilegios de administrador/root.

Además, el archivo de configuración predeterminado httpd.conf debe permanecer dentro del directorio <INICIO_IHS>/conf, y debe ejecutar setupadm manualmente después de la configuración de administración.

Supported configurations Supported configurations: La herramienta de configuración de plug-ins de servidor web está diseñada para utilizarla con el perfil completo de WebSphere Application Server; no es obligatoria ni está admitida en el perfil de Liberty. Para obtener información sobre cómo generar un plug-in de servidor web, consulte Configuración del perfil de Liberty con un plug-in de servidor web.sptcfg

Flujos de configuración

La herramienta de configuración de plug-ins de servidor web resuelve todas las configuraciones del servidor web y WebSphere Application Server en dos escenarios: configuración de plug-in remoto y configuración de plug-in local. La lógica implementada para determinar qué escenario se aplica a una configuración se muestra en el diagrama siguiente.

Flujo de plug-ins de lógica de diseño

Leyenda:
¿Tipo de instalación?
El tipo de instalación puede ser remoto o local.

Si el servidor web y el servidor de aplicaciones no están en el mismo sistema, elija el escenario remoto. Si el servidor web y el servidor de aplicaciones están en el mismo sistema, elija el escenario local.

¿Perfil?
Si el producto está instalado pero el perfil se suprime accidentalmente o en otro caso falta, el escenario se considera que es una instalación remota. Cree un perfil antes de ejecutar el script.
¿Servidor de aplicaciones autónomo con definición de servidor web?
Si el perfil tiene una definición de servidor web existente, la instalación se considera una configuración de plug-in remoto. No puede tener más de una definición de servidor web en un servidor de aplicaciones autónomo.

Escenario A. Configuración de plug-in autónomo local

En este escenario, la herramienta de configuración de plug-ins de servidor web crea una definición de servidor web en el perfil de servidor de aplicaciones directamente, sin utilizar un script.

La herramienta de configuración de plug-ins de servidor web configura el servidor web para utilizar el archivo plugin-cfg.xml que está dentro del perfil de servidor de aplicaciones. El servidor de aplicaciones 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 produce cada vez que se produce un cambio en la configuración de servidor de aplicaciones que afecta a las aplicaciones desplegadas.

Después de configurar el servidor de aplicaciones para el servidor web local, puede iniciar el servidor de aplicaciones y el servidor web inmediatamente.
Tabla 1. Configuración apta para el escenario de servidor de aplicaciones local.    
Tipo de perfil ¿Creación automática de la definición de servidor web? ¿Servidor web ya definido en la configuración de servidor de aplicaciones?
Servidor de aplicaciones Sí No

Un perfil de servidor de aplicaciones que tiene una definición de servidor web existente se debería procesar como una configuración de plug-in remoto. Un servidor de aplicaciones puede tener solo una definición de servidor web.

Consulte el Escenario B para obtener una descripción de este tipo de nodo.

La descripción general siguiente muestra el procedimiento para verificar la configuración de servidor web:

  1. Inicie el servidor web con el procedimiento apropiado para el servidor web.
    Por ejemplo, inicie IBM HTTP Server desde una línea de mandatos:
    • [AIX][HP-UX][Linux][Solaris]./raíz_IHS/bin/apachectl start
    • [Windows]raíz_IHS\bin\apache
  2. Inicie el servidor de aplicaciones.
    Cambie de directorio a raíz_perfil/bin y ejecute el mandato startServer:
    • [AIX][HP-UX][Linux][Solaris]./raíz_perfil/bin/startServer.sh server1
    • [Windows]raíz_perfil\bin\startServer server1
    Abra la consola administrativa y guarde la configuración que ha cambiado.
  3. Acceda desde el navegador a la dirección: http://localhost:9080/snoop para probar el transporte HTTP interno proporcionado por el servidor de aplicaciones. Acceda mediante el navegador a http://nombre_host_de_la_máquina_servidor_web/snoop para probar el plug-in del servidor web.
  4. Verifique que las dos direcciones web muestran la página Snoop Servlet - Request/Client Information.

La herramienta de configuración de plug-ins de servidor web no crea automáticamente una definición de servidor web dentro del perfil distribuido en una máquina remota. La herramienta crea el script configurenombre_servidor_web en su lugar.

La herramienta de configuración de plug-ins de servidor web configura el servidor web para utilizar el archivo plugin-cfg.xml mantenido en la máquina del servidor web en el directorio raíz_plug-ins/config/nombre_servidor_web. Este archivo requiere una propagación periódica. La propagación copia el archivo plugin-cfg.xml actual de la máquina del servidor de aplicaciones para sustituir el archivo raíz_plug-ins/config/nombre_servidor_web/plugin-cfg.xml.

Después de instalar el plug-in binario para el servidor web local, no tiene que ejecutar el script para poder iniciar el servidor de aplicaciones y el servidor web. Sin embargo, no tiene las ventajas de una definición de servidor web en el nodo de servidor de aplicaciones hasta que no ejecuta el script.
Tabla 2. Configuraciones que cumplen los requisitos para el escenario de servidor de aplicaciones remoto.    
Tipo de perfil ¿Creación de la definición de servidor web? ¿Servidor web ya definido en la configuración de servidor de aplicaciones?
Cualquier perfil en cualquier lugar si selecciona un tipo de instalación remoto en la herramienta de configuración de plug-ins de servidor web Mediante script N/D
Ningún perfil Mediante script N/D
¿Perfil de servidor de aplicaciones autónomo con una definición de servidor web existente? Mediante script Sí

La descripción general siguiente muestra el procedimiento para verificar el archivo raíz_plug-ins/config/nombre_servidor_web/plugin-cfg.xml temporal.

El servidor web se comunica con el servidor de aplicaciones remoto mediante el archivo plugin-cfg.xml temporal.

Si el servidor de aplicaciones tiene una asignación de puerto de transporte HTTP distinto de 9080, la prueba no resulta satisfactoria. Continúe hasta la sección siguiente para crear la definición de servidor web en el servidor de aplicaciones y completar la prueba de la configuración.

  1. Inicie el servidor web con el procedimiento apropiado para el servidor web.
    Por ejemplo, inicie IBM HTTP Server desde una línea de mandatos:
    • [AIX][HP-UX][Linux][Solaris]./raíz_IHS/bin/apachectl start
    • [Windows]raíz_IHS\bin\apache
  2. Inicie el servidor de aplicaciones en la máquina remota.
    Cambie de directorio a raíz_perfil/bin y ejecute el mandato startServer:
    • [AIX][HP-UX][Linux][Solaris]./raíz_perfil/bin/startServer.sh server1
    • [Windows]raíz_perfil\bin\startServer server1
  3. Acceda desde el navegador a la dirección: http://localhost:9080/snoop para probar el transporte HTTP interno proporcionado por el servidor de aplicaciones. Acceda mediante el navegador a http://nombre_host_de_la_máquina_servidor_web/snoop para probar el plug-in del servidor web.
  4. Verifique que las dos direcciones web muestran la página Snoop Servlet - Request/Client Information.
La descripción general siguiente muestra el procedimiento para completar la configuración. La configuración no se completa hasta que no exista la definición de servidor web en la configuración del nodo de servidor de aplicaciones. La definición de servidor web es un elemento central en la regeneración de un archivo de configuración del plug-in válido, plugin-cfg.xml.
  1. Cree la definición de servidor web en el servidor de aplicaciones.
    Ejecute el script para crear manualmente la definición de servidor web en la configuración del nodo de servidor de aplicaciones.
    1. Copie el script del directorio raíz_plug-ins/bin en el directorio raíz_servidor_aplicaciones/bin remoto.
    2. Abra una ventana de mandato y ejecute el script:
      • [AIX][HP-UX][Linux][Solaris]./configurenombre_servidor_web.sh
      • [Windows]configurenombre_servidor_web.bat
    El script configurenombre_servidor_web puede aceptar tres parámetros: nombre_perfil, nombre_usuario_consola_administración y contraseña_consola_administración.
    • nombre_perfil indica el nombre del perfil utilizado para crear la definición de servidor web.
    • nombre_usuario_consola_administrativa indica el nombre de usuario de la consola administrativa. El perfil con la consola administrativa desplegada debe tener activada la seguridad de consola administrativa. Este parámetro no se puede utilizar si nombre_perfil está vacío.
    • contraseña_consola_administración indica la contraseña correspondiente al nombre de usuario. Este parámetro no se puede utilizar si nombre_perfil y nombre_usuario_consola_administración están vacíos.
    Nota: El valor de nombre_nodo_servidor_web del script es una concatenación del apodo que ha elegido para el servidor web y el sufijo -node. Se crea automáticamente durante la configuración de plug-in y no se puede cambiar. Por ejemplo, si ha llamado al servidor web miservidor durante la configuración de plug-in, el valor de la definición de servidor web asociada creada después de ejecutar el script sería miservidor-node.

    Si ha habilitado la seguridad o ha cambiado el tipo de conector JMX predeterminado, edite el script e incluya los parámetros correspondientes.

  2. Copie el archivo de configuración del plug-in actual, plugin-cfg.xml, en el directorio raíz_perfil/config/cells/nombre_célula/nodes/nombre_servidor_web_node/servers/nombre_servidor_web. Pegue el archivo en la máquina del servidor web para sustituir el archivo raíz_plug-ins/config/nombre_servidor_web/plugin-cfg.xml temporal. IBM HTTP Server admite la propagación automática. Otros servidores web requieren la propagación manual.
  3. Inicie el servidor web con el procedimiento apropiado para el servidor web. Abra la consola administrativa y guarde la configuración que ha cambiado.
  4. Acceda desde el navegador a la dirección: http://localhost:9080/snoop para probar el transporte HTTP interno proporcionado por el servidor de aplicaciones. Acceda mediante el navegador a http://nombre_host_de_la_máquina_servidor_web/snoop para probar el plug-in del servidor web.
  5. Verifique que las dos direcciones web muestran la página Snoop Servlet - Request/Client Information.

Para resumir, existen dos escenarios para los plug-ins de servidor web. Cada escenario gira alrededor de una ubicación exclusiva para el archivo de configuración del plug-in, plugin-cfg.xml.

El servidor de aplicaciones genera el archivo de configuración del plug-in. La finalidad del archivo es publicar la ubicación de todos los objetos de servidor de aplicaciones relevantes para un servidor web y controlar las opciones de configuración de plug-in binario. El archivo identifica los objetos como las aplicaciones y los host virtuales para dar servicio a las aplicaciones.

Si el servidor web no puede acceder al archivo en la máquina del servidor de aplicaciones, debe copiar el archivo en el servidor web. Ese proceso se denomina propagación. La propagación está reservada para el escenario de configuración de plug-in remoto, que es el Escenario B de este artículo.

En el escenario local, el servidor web puede acceder al archivo plugin-cfg.xml porque el servidor web está en la misma máquina que el archivo.

Todas las configuraciones de Escenario A tienen la definición de servidor web en su propio nodo de servidor web.

Opciones de gestión limitadas no permiten crear ni suprimir la única definición de servidor web en la consola administrativa de un servidor de aplicaciones autónomo. La incapacidad de un servidor de aplicaciones autónomo para crear una definición de servidor web es la base de los scripts de configuración creados por la herramienta de configuración de plug-ins de servidor web. Sin los scripts, no podría crear fácilmente una definición de servidor web en un nodo de servidor de aplicaciones autónomo.

La ubicación del archivo plugin-cfg.xml para cada configuración descrita en este artículo se muestra en la tabla siguiente:
Tabla 3. Ubicaciones de archivo de configuración del plug-in. En esta tabla se describen las ubicaciones de archivo de configuración del plug-in.
Escenario Tipo de perfil Ubicación del archivo plugin-cfg.xml
raíz_plug-ins raíz_perfil: en el nodo de servidor web
A Perfil del servidor de aplicaciones   X
B Cualquier perfil en cualquier lugar si selecciona un tipo de instalación remoto en la herramienta de configuración de plug-ins de servidor web X  
Ningún perfil X  
Perfil de servidor de aplicaciones con una definición de servidor web existente X  
Leyenda:
raíz_plug-ins
raíz_plug-ins/config/nombre_servidor_web/plugin-cfg.xml
raíz_perfil: en el nodo de servidor web
raíz_perfil/config/cells/nombre_célula/nodes/nombre_servidor_web_node/servers/nombre_servidor_web/plugin-cfg.xml

Icon that indicates the type of topic Reference topic



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