# Hojas de ruta de instalación de plug-ins de servidor Web para WebSphere Application Server Network Deployment

Cómo empezar
Hojas de ruta de instalación de plug-ins:

1. Instalación del plug-in de servidor web para servidores de aplicaciones autónomos
2. Instalación del plug-in de servidor web para entornos distribuidos

## Instalación del plug-in de servidor web para servidores de aplicaciones autónomos

| Escenario de instalación remota | Escenario de instalación local
## Entorno típico | # Producción (recomendado) | # Desarrollo
## Instalación y configuración |
Instalación del servidor de aplicaciones:
(Máquina A)
1. | Instale IBM Installation Manager.
2. | Utilice Installation Manager para instalar el producto WebSphere Application Server Network Deployment.
3. | Cree un servidor de aplicaciones autónomo.
Instalación de un servidor web y de los plug-ins de servidor web:
(Máquina B)
4. | Instale IBM Installation Manager.
5. | Utilice Installation Manager para instalar IBM HTTP Server o instale otro servidor web soportado.
6. | Utilice Installation Manager para instalar los plug-ins de servidor web para WebSphere Application Server.
Configuración del plug-in de servidor web:
(Máquina B)
7. | Utilice Installation Manager para instalar WebSphere Customization Tools.
8. | Abra WebSphere Customization Tools lance la herramienta de configuración de plug-ins de servidor web para configurar el plug-in de servidor web. El script para crear y configurar el servidor Web se crea en el directorio raíz_plug-ins`/bin`.
9. | Copie el script configurenombre_servidor_Web para pegarlo en la Máquina A. Consulte la sección Consideraciones acerca de plataformas cruzadas de este documento para obtener más información acerca de la ejecución de scripts de configuración cuando: Una máquina ejecuta Windows y la otra ejecuta Linux o UNIX. Una máquina ejecuta una codificación de archivos diferente.
Creación de la definición del servidor web:
(Máquina A)
10. | Pegue el script `configurenombre_servidor_Web` de la Máquina B en el directorio raíz_servidor_aplic`/bin` de la Máquina A
11. | Inicie el servidor de aplicaciones en la Máquina A.
12. | Ejecute el script en la Máquina A.
Verificación:
(Máquina A)
13. | Verifique que el servidor de aplicaciones esté en ejecución.
(Máquina B)
14. | Inicie IBM HTTP Server u otro servidor web soportado.
15. | Ejecute el servlet Snoop.
| Para verificar su propia aplicación, genere de nuevo y propague el archivo `plugin-cfg.xml` después de configurar (instalar) la aplicación.
Instalación del servidor de aplicaciones:
(Máquina A)
1. | Instale IBM Installation Manager.
2. | Utilice Installation Manager para instalar el producto WebSphere Application Server Network Deployment.
3. | Cree un servidor de aplicaciones autónomo.
Instalación de un servidor web y de los plug-ins de servidor web:
(Máquina A)
4. | Utilice Installation Manager para instalar IBM HTTP Server o instale otro servidor web soportado.
5. | Utilice Installation Manager para instalar los plug-ins de servidor web para WebSphere Application Server.
Configuración del plug-in de servidor web y creación de la definición de servidor web:
(Máquina A)
6. | Utilice Installation Manager para instalar WebSphere Customization Tools.
7. | Abra WebSphere Customization Tools e inicie la Herramienta de configuración de plug-ins de servidor Web para configurar el plug-in de servidor Web y crear la definición de servidor web.
8. | Inicie el servidor de aplicaciones.
Verificación:
(Máquina A)
9. | Verifique que el servidor de aplicaciones esté en ejecución.
10. | Inicie IBM HTTP Server u otro servidor web soportado.
11. | Ejecute el servlet Snoop.
## Regeneración del archivo `plugin-cfg.xml` | Durante la configuración, el archivo temporal `plugin-cfg.xml` se instala en la máquina B en el directorio raíz_plug-ins`/config/nombre_servidor_web`. El servicio de configuración de plug-ins del servidor Web vuelve a generar el archivo `plugin-cfg.xml` automáticamente. Para utilizar el archivo `plugin-cfg.xml` real del servidor de aplicaciones, propague el archivo `plugin-cfg.xml` como se describe en la sección siguiente. | El servicio de configuración de plug-ins del servidor Web vuelve a generar el archivo `plugin-cfg.xml` automáticamente. El archivo `plugin-cfg.xml` se genera en el directorio raíz_perfil`/config/cells/nombre_célula/nodes/nombre_nodo/servers/nombre_servidor_Web` cuando se crea la definición del servidor web.
## Propagación del archivo `plugin-cfg.xml` | El servicio de configuración del plug-in de servidor web propaga el archivo `plugin-cfg.xml` automáticamente sólo para IBM HTTP Server. Para habilitar la propagación automática, realice la configuración única. Para todos los demás servidores Web, propague el archivo de configuración del plug-in del plug-in copiando manualmente el archivo `plugin-cfg.xml` del directorio raíz_perfil`/config/cells/nombre_célula/nodes/nombre_nodo/servers/ nombre_servidor_web` de la Máquina A en el directorio `raíz_plugins/config/nombre_servidor_web` de la Máquina B. | Utilice la opción de propagación pata mover el archivo `plugin-cfg.xml` del directorio raíz_perfil/config/cells/nombre_célula/nodes/nombre_nodo/servers/nombre_servidor_Web al directorio raíz_plugins/config/nombre_servidor_web.

### Topología remota | ### Topología local

# Instalación del plug-in de servidor web para entornos distribuidos (células)
| Escenario de instalación distribuida remota | Escenario de instalación distribuida local
## Entorno típico | # Producción (recomendado) | # Desarrollo
## Instalación y configuración |
Instalación del gestor de despliegue:
(Máquina A)
1. | Instale IBM Installation Manager.
2. | Utilice Installation Manager para instalar el producto WebSphere Application Server Network Deployment.
3. | Cree un perfil de gestor de despliegue.
4. | Compruebe que el gestor de despliegue se está ejecutando para permitir la sincronización de nodos de los archivos de configuración modificados.
Instalación del servidor de aplicaciones:
(Máquina B)
5. | Instale IBM Installation Manager.
6. | Utilice Installation Manager para instalar el producto WebSphere Application Server Network Deployment.
7. | Cree un servidor de aplicaciones autónomo.
8. | Añada el nodo a la célula del gestor de despliegue para iniciar el proceso del agente de nodo. Inicie el agente de nodo en un nodo gestionado existente. El gestor de despliegue y el agente de nodo deben estar ejecutándose para permitir la sincronización de nodos de los archivos de configuración modificados.
Instalación de un servidor web y de los plug-ins de servidor web:
(Máquina C)
9. | Instale IBM Installation Manager.
10. | Utilice Installation Manager para instalar IBM HTTP Server o instale otro servidor web soportado.
11. | Utilice Installation Manager para instalar los plug-ins de servidor web para WebSphere Application Server.
Configuración del plug-in de servidor web:
(Máquina C)
12. | Utilice Installation Manager para instalar WebSphere Customization Tools.
13. | Abra WebSphere Customization Tools lance la herramienta de configuración de plug-ins de servidor web para configurar el plug-in de servidor web. El script para crear y configurar el servidor Web se crea en el directorio raíz_plug-ins`/bin`.
14. | Copie el script configurenombre_servidor_Web para pegarlo en la Máquina A. Consulte la sección Consideraciones acerca de plataformas cruzadas de este documento para obtener más información acerca de la ejecución de scripts de configuración cuando: Una máquina ejecuta Windows y la otra ejecuta Linux o UNIX. Una máquina ejecuta una codificación de archivos diferente.
Creación de la definición del servidor web:
(Máquina A)
15. | Pegue el script configurenombre_servidor_Web de la Máquina C en el directorio raíz_servidor_aplic`/bin` de la Máquina A.
16. | Ejecute el script desde una línea de mandatos. Este paso requiere que el gestor de despliegue y el agente de nodo estén en ejecución. Si tiene la seguridad habilitada o ha cambiado el tipo de conector JMX por omisión, edite el script e incluya los parámetros apropiados.
Verificación:
(Máquinas A y B)
17. | Utilice la consola administrativa del gestor de despliegue de la máquina A para iniciar el servidor de aplicaciones en la máquina B.
(Máquina C)
18. | Inicie IBM HTTP Server u otro servidor web soportado.
19. | Ejecute el servlet Snoop.
Note: el procedimiento siguiente describe cómo instalar los plug-ins en dos máquinas. No obstante, puede realizar este procedimiento en una única máquina.
Instalación del gestor de despliegue:
(Máquina A)
1. | Instale IBM Installation Manager.
2. | Utilice Installation Manager para instalar el producto WebSphere Application Server Network Deployment.
3. | Cree un perfil de gestor de despliegue.
4. | Compruebe que el gestor de despliegue se está ejecutando para permitir la sincronización de nodos de los archivos de configuración modificados.
Instalación del servidor de aplicaciones:
(Máquina B)
5. | Instale IBM Installation Manager.
6. | Utilice Installation Manager para instalar el producto WebSphere Application Server Network Deployment.
7. | Cree un servidor de aplicaciones autónomo.
8. | Añada el nodo a la célula del gestor de despliegue para iniciar el proceso del agente de nodo. Inicie el agente de nodo en un nodo gestionado existente. El gestor de despliegue y el agente de nodo deben estar ejecutándose para permitir la sincronización de nodos de los archivos de configuración modificados.
Instalación de un servidor web y de los plug-ins de servidor web:
(Máquina B)
9. | Utilice Installation Manager para instalar IBM HTTP Server o instale otro servidor web soportado.
10. | Utilice Installation Manager para instalar los plug-ins de servidor web para WebSphere Application Server.
Configuración del plug-in de servidor web:
(Máquina B)
11. | Utilice Installation Manager para instalar WebSphere Customization Tools.
12. | Abra WebSphere Customization Tools e inicie la Herramienta de configuración de plug-ins de servidor Web para configurar el plug-in de servidor Web y crear la definición de servidor web. El script para crear y configurar el servidor Web se crea en el directorio raíz_plug-ins`/bin`.
13. | Copie el script configurenombre_servidor_Web para pegarlo en la Máquina A. Consulte la sección Consideraciones acerca de plataformas cruzadas de este documento para obtener más información acerca de la ejecución de scripts de configuración cuando: Una máquina ejecuta Windows y la otra ejecuta Linux o UNIX. Una máquina ejecuta una codificación de archivos diferente.
Creación de la definición del servidor web:
(Máquina A)
14. | Pegue el script configurenombre_servidor_Web de la Máquina B en el directorio raíz_servidor_aplic`/bin` de la Máquina A.
15. | Ejecute el script desde una línea de mandatos. Este paso requiere que el gestor de despliegue y el agente de nodo estén en ejecución. Si tiene la seguridad habilitada o ha cambiado el tipo de conector JMX por omisión, edite el script e incluya los parámetros apropiados.
Verificación:
(Máquinas A y B)
16. | Utilice la consola administrativa del gestor de despliegue de la máquina A para iniciar el servidor de aplicaciones en la máquina B.
17. | Inicie IBM HTTP Server u otro servidor web soportado. Antes de iniciar el servidor Web Domino en un sistema Linux o UNIX, establezca el script raíz_plug-ins`/setupPluginCfg.sh` como origen.
18. | Ejecute el servlet Snoop.
## Regeneración del archivo `plugin-cfg.xml` | Durante la configuración, un archivo temporal `plugin-cfg.xml` se instala en la máquina C en el directorio raíz_plug-ins`/config/nombre_servidor_web`. El servicio de configuración de plug-ins del servidor Web vuelve a generar el archivo `plugin-cfg.xml` automáticamente. Para utilizar el archivo `plugin-cfg.xml` real del servidor de aplicaciones, propague el archivo `plugin-cfg.xml` como se describe en la sección siguiente. | El archivo `plugin-cfg.xml` se genera en el directorio raíz_perfil`/config/cells/nombre_célula/nodes/nombre_nodo/servers/nombre_servidor_Web` cuando se crea la definición del servidor web. Vuelva a generar el archivo `plugin-cfg.xml` en la definición de servidor Web del servidor de aplicaciones cuando cambie la configuración. El servidor Web tiene acceso inmediato al archivo siempre que se vuelva a generar. Cuando el servicio de configuración de plug-ins del servidor Web (un servicio de administración) se habilita en la máquina A, el archivo `plugin-cfg.xml` se genera automáticamente para todos los servidores Web.
## Propagación del archivo `plugin-cfg.xml` | El servicio de configuración del plug-in de servidor web propaga el archivo `plugin-cfg.xml` automáticamente sólo para IBM HTTP Server. Para habilitar la propagación automática, realice la configuración única descrita en la última sección de este hoja de ruta. Para todos los demás servidores Web, propague el archivo de configuración de plug-ins, manualmente copiando el archivo `plugin-cfg.xml` del directorio raíz_perfil`/config/cells/nombre_célula/nodes/nombre_nodo/servers/nombre_servidor_web` en la máquina A al directorio raíz_plug-ins`/config/nombre_servidor_web` en la máquina C. | Utilice la opción de propagación para mover el archivo `plugin-cfg.xml` del directorio raíz_perfil/config/cells/nombre_célula/nodes/nombre_nodo/servers/nombre_servidor_Web al directorio raíz_plugins/config/nombre_servidor_web.

### Topología remota | ### Topología local

# Procedimiento de configuración y resolución de problemas de la propagación automática El servicio de configuración del plug-in de servidor web propaga el archivo `plugin-cfg.xml` automáticamente sólo para IBM HTTP Server. Para habilitar la propagación automática, realice la siguiente configuración única: Cree un user=adminUser, password=adminPassword en el archivo raíz_IHS`/conf/admin.passwd`. Por ejemplo: c:\ws\ihs85\bin\htpasswd -cb c:\ws\ihs85\conf\admin.passwd adminUser adminPassword En la consola administrativa, pulse Servidores > Servidores Web > webserver1 > Gestión de servidor web remoto. Defina los valores siguientes: admin Port=8008, User Id=adminUser, Password=adminPassword. Establezca los permisos correctos de lectura/grabación para el archivo `httpd.conf` y el archivo `plugin-cfg.xml`. Consulte el archivo raíz_IHS`/logs/admin_error.log` para obtener más información. Para la propagación automática del archivo de configuración del plug-in, es preciso que el servidor administrativo IBM HTTP esté en ejecución. Si gestiona un servidor IBM HTTP Server mediante la consola administrativa de WebSphere Application Server, es posible que aparezca este error:
    "No se ha podido conectar al servidor de administración IHS"
Siga el procedimiento siguiente: Compruebe que el servidor de administración de IBM HTTP Server esté en ejecución. Verifique que el nombre de host del servidor Web y el puerto definidos en la consola administrativa de WebSphere Application Server coincidan con el nombre de host y el puerto del servidor de administración IBM HTTP Server. Compruebe que el cortafuegos no impida el acceso al servidor de administración de IBM HTTP Server desde la consola administrativa de WebSphere Application Server. Compruebe que el ID de usuario y la contraseña especificados en la consola administrativa de WebSphere Application Server, mediante gestión remota, se hayan creado en el archivo `admin.passwd` utilizando el mandato htpasswd. Si intenta conectarse de forma segura, compruebe que exporta el certificado personal keydb del servidor de administración de IBM HTTP Server a la base de datos de claves de WebSphere Application Server como un certificado de firmante. Esta base de datos de claves se especifica mediante la directiva `com.ibm.ssl.trustStore` en el archivo `sas.client.props` del perfil en el que se ejecuta la consola administrativa. Esta consideración es principalmente para los certificados autofirmados. Si continúa teniendo problemas, consulte el archivo `admin_error.log` de IBM HTTP Server y las anotaciones cronológicas (archivo `trace.log`) de WebSphere Application Server para determinar la causa del problema.

- # Consideraciones acerca de plataformas cruzadas para ejecutar el script de configuración Al configurar un servidor web remoto, pueden aparecer varias diferencias en cuanto a sistemas operativos y plataformas de máquina: Una máquina ejecuta Windows y la otra ejecuta Linux o UNIX. Una máquina ejecuta una codificación predeterminada que es diferente de la otra. Una máquina ejecuta Windows y la otra ejecuta Linux o UNIX Si una máquina se ejecuta en Linux o UNIX y la otra máquina se ejecuta en Windows, utilice el script creado en el directorio `raíz_plugins/bin/crossPlatformScripts`. Una máquina ejecuta una codificación predeterminada que es diferente de la otra El contenido de los scripts `configurenombre_servidor_web.bat` o `configurenombre_servidor_web.sh` puede dañarse si la codificación de archivo predeterminado de las dos máquinas es distinta. Este escenario es posible cuando una máquina está configurada para un entorno local de juego de caracteres de doble byte (DBCS) y la otra máquina no. Determine la codificación de archivos de cada máquina y utilice uno de los procedimientos siguientes como método alternativo. Para determinar la codificación de archivo predeterminada, ejecute el mandato apropiado: Sistemas Windows:
      CHCP
- Sistemas Linux y UNIX:
      locale
Utilice el resultado del mandato en cada máquina como valor de la variable codificación_máquina_servidor_web y la variable codificación_máquina_servidor_aplicaciones en uno de los procedimientos siguientes. Procedimientos de corrección de las diferencias de codificación Supongamos que el servidor Web se está ejecutando en una máquina Linux y que Network Deployment se está ejecutando en una máquina Windows. Servidor web en ejecución en una máquina Linux Ejecute el mandato siguiente en el sistema Linux o UNIX para codificar el archivo de script que configura la definición del servidor web, antes de enviar el archivo por FTP a la máquina Windows en modalidad binaria:
    iconv -f codificación_máquina_servidor_Web \
    -t codificación_máquina_servidor_aplicaciones \
             configurenombre_servidor_Web.bat
Omita los caracteres de continuación (\) de Linux y UNIX especificando el mandato en una sola línea. Importante: el nombre del servidor Web (apodo) se utiliza en el nombre del archivo de script. El nombre no puede contener caracteres de un juego de caracteres de doble byte (DBCS) si se desea configurar el servidor IBM HTTP Server para la propagación automática. Ahora supongamos que el servidor Web se está ejecutando en una máquina Windows y que Network Deployment se está ejecutando en una máquina Linux o UNIX. Servidor web en ejecución en una máquina Windows Ejecute el mandato siguiente en el sistema Linux o UNIX para codificar el archivo de script que configura la definición del servidor web, después de enviar el archivo por FTP en modalidad binaria:
    iconv -f codificación_máquina_servidor_Web \
    -t codificación_máquina_servidor_aplicaciones \
             configurenombre_servidor_Web.sh
Omita los caracteres de continuación (\) de Linux y UNIX especificando el mandato en una sola línea. Si el mandato iconv del sistema no admite la correlación de conversión, copie el contenido del script de configuración del servidor web en un área común y péguelo en la máquina en la que se ejecuta el servidor de aplicaciones.