[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 tres modos en que la herramienta de configuración de plug-ins de servidor web puede configurar un archivo 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 del producto Network Deployment

La herramienta de configuración de plug-ins de servidor web resuelve todas las configuraciones de un servidor web y de WebSphere Application Server en tres escenarios: servidor de aplicaciones remoto, servidor de aplicaciones distribuido local y servidor de aplicaciones autónomo local. La lógica implementada en 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 la Herramienta de gestión de perfiles no ha creado todavía un perfil, el escenario se considera que es una instalación remota.
¿Servidor de aplicaciones autónomo con definición de servidor web?
Si el perfil es un servidor de aplicaciones con una definición de servidor web existente, la instalación se considera una instalación remota.
Tipo_perfil?
La herramienta de configuración de plug-ins de servidor web puede configurar solo un perfil cada vez. Estas tres rutas muestran cómo varía el proceso para distintos tipos de perfiles.
¿Federado?
Si el nodo de servidor de aplicaciones está federado, la herramienta de configuración de plug-ins de servidor web configura la definición de servidor web en el nodo gestionado. Esto tiene ventajas. Supongamos que el servidor web y el nodo gestionado están en máquinas distintas. El archivo plugin-cfg.xml se propaga automáticamente al nodo remoto durante la sincronización de nodos porque la definición de servidor web es parte de la configuración de nodo.
¿Perfil distribuido?
Si el gestor de despliegue tiene un nodo personalizado federado (perfil personalizado), la herramienta de configuración de plug-ins de servidor web configura la definición de servidor web en el nodo gestionado. Esto tiene ventajas. Supongamos que el servidor web y el nodo gestionado están en máquinas distintas. El archivo plugin-cfg.xml se propaga automáticamente al nodo remoto durante la sincronización de nodos porque la definición de servidor web es parte de la configuración de nodo.

La herramienta de configuración de plug-ins de servidor web crea una definición de servidor web dentro del perfil de servidor de aplicaciones.

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 autónomo vuelve a generar el archivo raíz_perfil/config/cells/nombre_célula/nodes/nombre_servidor_web_node/servers/nombre_servidor_web/plugin-cfg.xml cada vez que se produce un cambio en la configuración del servidor de aplicaciones que afecta a las aplicaciones desplegadas.

Después de instalar el plug-in binario para el servidor web local, puede iniciar el servidor de aplicaciones y el servidor web inmediatamente al finalizar la instalación.

Supongamos que crea una definición de servidor web en un servidor de aplicaciones autónomo y luego federa el nodo. La definición de servidor web no se federa en la célula porque la definición de servidor web está definida como un nodo aparte en un servidor de aplicaciones autónomo. Debe volver a crear la definición de servidor web en el nodo gestionado. Consulte el Escenario 2.
Tabla 1. Configuración apta para el escenario de servidor de aplicaciones autónomo local.    
Tipo de perfil Estado de federación ¿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 No federado No

Un servidor de aplicaciones autónomo no federado que tiene una definición de servidor web existente se debería procesar como una configuración de plug-in remoto.

Una definición de servidor web existente en un servidor de aplicaciones autónomo requiere que la herramienta de configuración de plug-ins de servidor web siga la ruta de instalación remota. Un servidor de aplicaciones autónomo puede tener exactamente una definición de servidor web.

Consulte el Caso 3 para obtener una descripción de este tipo de nodo.

Un servidor de aplicaciones autónomo federado se debería procesar como una configuración de plug-in distribuido local. Consulte el Escenario 2 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 modificada.
  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 de un perfil de servidor de aplicaciones federado. La herramienta crea el script configurenombre_servidor_web en su lugar en el directorio raíz_plug-ins/bin/.

La herramienta de configuración de plug-ins de servidor web configura el servidor web para utilizar el archivo plugin-cfg.xml que se creará dentro del perfil de servidor de aplicaciones cuando ejecute el script. El gestor de despliegue vuelve a generar el archivo plugin-cfg.xml en el directorio raíz_perfil/config/cells/nombre_célula/nodes/nombre_nodo/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 en el nodo gestionado.

Después de instalar el plug-in binario para el servidor web local, debe ejecutar el script para poder iniciar el servidor web. El servidor web ya se ha configurado para utilizar el archivo plugin-cfg.xml en la configuración de servidor de aplicaciones. Ese archivo no existe hasta que no ejecuta el script configurenombre_servidor_web.
Tabla 2. Configuraciones aptas para el escenario de servidor de aplicaciones distribuido local.    
Tipo de perfil Estado de federación ¿Creación de la definición de servidor web? ¿Servidor web ya definido en la configuración de servidor de aplicaciones?
Perfil del servidor de aplicaciones Federado Mediante script N/D
Perfil personalizado No federado Mediante script N/D
Perfil personalizado Federado Mediante script N/D
Perfil de gestor de despliegue con un nodo gestionado (perfil distribuido) N/D Mediante script N/D

La descripción general siguiente muestra el procedimiento para completar la configuración y verificación del servidor web:

  1. Inicie el gestor de despliegue.
  2. Si tiene previsto añadir un nodo de servidor de aplicaciones a una célula de gestor de despliegue pero todavía no lo ha hecho, federe el nodo antes de instalar los plug-ins. Si existe la definición de servidor web al federar el nodo, se pierde la definición de servidor web al federarlo.
  3. Cree la definición de servidor web en el servidor de aplicaciones. Tiene dos opciones:
    • Utilice la consola administrativa del gestor de despliegue para crear una definición de servidor web en un nodo gestionado. Pulse Servidores > Servidores web > Nuevo y utilice el asistente Crear nueva entrada de servidor web para crear la definición de servidor web.
    • Ejecute el script para crear manualmente la definición de servidor web en la configuración del gestor de despliegue. Ejecute el script desde el directorio raíz_plug-ins/bin. El script puede direccionar el gestor de despliegue en la misma máquina.
      Abra una ventana de mandato y ejecute el script adecuado:
      • [AIX][HP-UX][Linux][Solaris]./configurenombre_servidor_web.sh
      • [Windows]configurenombre_servidor_web.bat
      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 instalación del plug-in y no se puede cambiar. Por ejemplo, si ha llamado al servidor web miservidor durante la instalación del 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.

  4. 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
  5. 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
  6. Abra la consola administrativa del gestor de despliegue. Espere a que se produzca la sincronización de nodos y guarde la configuración modificada que incluye la nueva definición de servidor web.
  7. 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.
  8. 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 que se mantendrá 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 3. Configuraciones que cumplen los requisitos para el escenario de servidor de aplicaciones remoto.    
Tipo de perfil Estado de federación ¿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 N/D Mediante script N/D
Ningún perfil N/D Mediante script N/D
Perfil de servidor de aplicaciones autónomo sin federar con una definición de servidor web existente No federado Mediante script
Perfil de gestor de despliegue sin nodos gestionados N/D Mediante script N/D

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 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. Inicie el gestor de despliegue si va a configurar el gestor de despliegue o un nodo gestionado.
  2. Federe ahora un nodo de servidor de aplicaciones remoto o un nodo personalizado si tiene pensado federar el nodo en determinado momento. Si ya existe una definición de servidor web al federar un nodo, se pierde la definición.
  3. Cree la definición de servidor web en el servidor de aplicaciones. Tiene dos opciones para un nodo gestionado. Utilice la opción de script para un nodo de gestor de despliegue sin nodos gestionados.
    • Utilice la consola administrativa del gestor de despliegue para crear una definición de servidor web en un nodo gestionado. Pulse Servidores > Servidores web > Nuevo y utilice el asistente Crear nueva entrada de servidor web para crear la definición de servidor web.
    • 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
      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 instalación de plug-in y no se puede cambiar. Por ejemplo, si ha llamado al servidor web miservidor durante la instalació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 (Java™ Management Extensions) predeterminado, edite el script e incluya los parámetros correspondientes.

  4. Abra la consola administrativa del gestor de despliegue si el nodo está federado. Espere a que se produzca la sincronización de nodos y guarde la configuración modificada que incluye la nueva definición de servidor web. Si el nodo remoto no está federado, abra la consola administrativa del servidor de aplicaciones y guarde la configuración modificada.
  5. 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.
  6. Inicie el servidor web con el procedimiento apropiado para el servidor web.
  7. 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.
  8. Verifique que las dos direcciones web muestran la página Snoop Servlet - Request/Client Information.

Para resumir, existen tres 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 elementos de servidor de aplicaciones relevantes para un servidor web. Tales elementos incluyen, por ejemplo, aplicaciones, host virtuales para dar servicio a las aplicaciones, clústeres y miembros de clúster.

Si el servidor web no puede acceder al archivo en la máquina del servidor de aplicaciones, debe llevar el archivo al 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 3 en este artículo.

En cada 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. Existen dos escenarios locales porque hay dos ubicaciones distintas para un archivo plugin-cfg.xml local.

El esquema de WebSphere Application Server coloca el archivo de configuración del plug-in en una definición de servidor web que o bien está en un nodo de servidor web o bien está en un nodo gestionado. El tipo de nodo es la diferencia entre el Escenario 2 y el Escenario 1 de este artículo. Todas las configuraciones de Escenario 2 requieren que exista la definición de servidor web en un nodo de servidor de aplicaciones gestionado. Todas las configuraciones de Escenario 1 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 4. Ubicaciones de archivo de configuración de 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 gestionado raíz_perfil: en el nodo de servidor web
1 Perfil del servidor de aplicaciones     X
2 Perfil del servidor de aplicaciones   X  
Perfil personalizado   X  
Perfil de gestor de despliegue con un nodo gestionado (perfil distribuido)   X  
3 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 (autónomo) sin federar con una definición de servidor web existente X    
Perfil de gestor de despliegue sin nodos gestionados X    
Leyenda:
raíz_plug-ins
raíz_plug-ins
/config/nombre_servidor_web/plugin-cfg.xml
raíz_perfil: en el nodo gestionado
raíz_perfil/config/cells/nombre_célula/nodes/nombre_nodo_de_servidor_aplicaciones/servers/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-nd-mp&topic=cins_webplugins
File name: cins_webplugins.html