WebSphere Application
Server proporciona un plug-in de servidor web que puede configurar para comunicarse con una determinada marca de servidor web. Conozca cómo instalar el servidor web y su plug-in de
servidor web para WebSphere Application Server en una máquina y cómo configurar
el servidor de aplicaciones del perfil predeterminado en otra máquina para que se comunique
con el servidor web.
Antes de empezar
Si existen varios perfiles, puede
seleccionar el configurado por la herramienta de configuración de
plug-ins del servidor web. Consulte Configuración de plug-ins para obtener una descripción del flujo de la lógica que determina cómo seleccionar el perfil que se ha de configurar.
Cuando existan varios perfiles, puede seleccionar el perfil que la Herramienta de configuración de los plug-ins de servidor web configure.
Consulte Configuración de plug-ins
para obtener una descripción del flujo de la lógica que determina
cómo seleccionar el perfil que se ha de configurar.
Si la familia de productos WebSphere Application Server da soporte a una marca determinada de servidor web, como, por ejemplo, IBM® HTTP Server o Microsoft Internet Information Services (IIS), el producto WebSphere Application Server proporciona un plug-in binario para el servidor web que debe instalar.
Si la familia de productos WebSphere Application Server no proporciona un plug-in binario para una marca determinada de servidor web, ello indica que no se da soporte al servidor web.
El objetivo del plug-in binario es proporcionar el protocolo de
comunicación entre el servidor web y el servidor de aplicaciones.
Supongamos que crea un perfil nuevo y que además desea utilizar un
servidor web.
Debe instalar un servidor web nuevo para el perfil
nuevo, instalar plug-ins del servidor web y utilizar la herramienta
de configuración de plug-ins del servidor web para configurar el
servidor web y el servidor de aplicaciones.
Aunque el servidor web
aún no esté instalado, puede instalar los plug-ins del servidor web
para su uso futuro.
Acerca de esta tarea
Instalar los plug-ins del servidor web instala
el módulo de plug-ins. La herramienta de configuración de plug-ins
del servidor web configura el servidor web para comunicarse con el
servidor de aplicaciones y crea una definición de configuración del
servidor web en el servidor de aplicaciones, si es posible.
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. Lea
Configuración de un plug-in de servidor web utilizando la herramienta pct para obtener más información.
sptcfg
Este procedimiento
configura el perfil del servidor de aplicaciones que es el perfil predeterminado en la
máquina. Existe una relación de uno a uno entre un servidor web y el servidor de aplicaciones.
En este artículo se describe cómo crear la topología
siguiente:
Atención: Si tiene previsto añadir el nodo del
servidor de aplicaciones a una célula del gestor de despliegue pero
todavía no lo ha hecho, inicie el gestor de despliegue y federe el
nodo antes de configurar el plug-in.
No se puede añadir un servidor
de aplicaciones con una definición del servidor web a una célula del
gestor de despliegue.
La topología siguiente se considera una
topología remota porque el servidor web se encuentra en una máquina
distinta. El diagrama muestra una topología remota típica para
un entorno distribuido:
En este
artículo se describe la instalación de un servidor web en una máquina y
del servidor de aplicaciones en otra máquina. En esta situación, la
herramienta de configuración de plug-ins del servidor web de una
máquina no puede crear la definición del servidor web en la
configuración del servidor de aplicaciones de la otra máquina.
En tal caso, la herramienta de configuración de plug-ins del servidor
web crea un script en la máquina del servidor web que puede copiarse
en la máquina del servidor de aplicaciones. Ejecute el script en la
máquina del servidor de aplicaciones para crear la definición de
configuración del servidor web en la configuración del servidor de
aplicaciones.
Ejecute el procedimiento siguiente
para instalar el plug-in y configurar el servidor web y el servidor
de aplicaciones.
Procedimiento
- Instale Installation Manager en la Máquina A y la Máquina B.
- Utilice Installation Manager para instalar WebSphere
Application Server Network Deployment en la
máquina A.
- Cree un servidor de aplicaciones autónomo en la máquina A.
- Opcional: Cree un nuevo alias de host para el host virtual predeterminado.
Si ha configurado el servidor web para utilizar un puerto distinto
del puerto 80, debe añadir un nuevo alias de host a ese puerto para
el host predeterminado. Por ejemplo, cuando se ejecuta como usuario no root, IBM HTTP Server está configurado con un valor de puerto predeterminado de 8080.
- Utilice Installation Manager para instalar lo siguiente en la máquina B:
- Los plug-ins de servidor web para WebSphere Application Server
- Websphere Customization Toolbox
- Utilice Installation Manager para instalar el IBM HTTP Server en la máquina B o para instalar otro servidor web admitido en la máquina b.
Abra WebSphere Customization Toolbox e inicie la herramienta de configuración de plug-in de servidor web en la máquina con el servidor web.
- Seleccione una ubicación de tiempo de ejecución de plug-in de servidor web.
Si la ubicación de un servidor web previamente instalado que desea utilizar no está en la lista, realice las acciones siguientes para añadir la ubicación a su conjunto de trabajo:
- Pulse Add (Añadir).
- Escriba un nombre para la ubicación de plug-in de servidor web.
- Efectúe una de las acciones siguientes:
- Escriba la ubicación.
- Pulse Examinar, busque la ubicación y pulse Aceptar.
- Pulse Crear.
- Seleccione el tipo de servidor web que está configurando, y pulse Siguiente.
- Seleccione la arquitectura de su servidor web de destino instalado (64 bits o 32 bits) y pulse Siguiente si se le solicita.
- Pulse Examinar para seleccionar el archivo o los archivos de configuración
para el servidor web, verifique que el puerto del servidor web sea el correcto y, a
continuación, pulse Siguiente cuando haya finalizado.
Seleccione el archivo y no solamente el directorio del archivo. Algunos servidores web tienen dos archivos de configuración y requieren que se localice cada uno de los archivos.
La siguiente lista muestra los archivos de configuración para los servidores web soportados:
- Apache HTTP Server
- raíz_apache/config/httpd.conf
- Domino Web Server
- names.nsf y Notes.jar
El
asistente solicita el archivo notes.jar. El nombre real es Notes.jar.
La herramienta de configuración de plug-ins de servidor web verifica que los archivos existen, pero no los valida.
- IBM HTTP Server
raíz_IHS/conf/httpd.conf
raíz_perfil_IHS/conf/httpd.conf
- Microsoft Internet
Information Services (IIS)
- La Herramienta de configuración de los plug-ins de servidor web puede determinar los archivos correctos que se deben editar.
- Sun Java™ System Web Server
(antes Sun ONE Web Server e iPlanet Web Server) Versión 6.0 y posterior
- obj.conf y magnus.conf
- Si está configurando un plug-in de servidor web IBM HTTP, realice las acciones siguientes.
- Opcionalmente, configure la configuración del servidor de administración para administrar el servidor web.
Atención: Cuando utilice la herramienta de configuración de plug-ins de servidor web para
configurar el servidor de administración de IBM
HTTP Server, Websphere Customization Toolbox debe ejecutarse como cuenta "local" con
privilegios de administrador/root.
- Seleccione Configurar servidor de administración de IBM HTTP Server.
- Especifique un número de puerto en el que el servidor de administración de IBM HTTP se comunicará.
- Opcionalmente, seleccione Crear ID de usuario para autenticación de servidor de administración de IBM Server y especifique un ID de usuario y una contraseña para autenticar en el servidor administrativo IBM HTTP Server desde la consola administrativa.
- Pulse Siguiente.
![[AIX]](../images/aixlogo.gif)
Especifique el ID de sistema de usuario y el grupo para tener permiso de escritura en IBM HTTP Server, el servidor administrativo de IBM HTTP Server y los archivos de configuración del plug-in del servidor web Seleccione Crear ID y grupo de usuario de sistema exclusivo nuevo mediante las credenciales si es necesario.
Restricción: La configuración puede fallar si especifica un ID de usuario nuevo o un nombre de grupo
que supera el límite de la plataforma, que normalmente es de 8 caracteres y a veces es
configurable.
Opcionalmente, configure el servidor de administración de IBM HTTP Server para ejecutar un servicio de ventana.- Seleccione Ejecutar servidor de administración IBM HTTP Server
como servicio Windows.
- Efectúe una de las acciones siguientes:
- Seleccione Iniciar sesión como cuenta de sistema local.
- Seleccione Iniciar sesión como cuenta de usuario especificada y especifique el ID de usuario y la contraseña para dicha cuenta.
El ID de usuario
necesita los siguientes derechos de usuario avanzados:
- Actuar como parte del sistema operativo
- Conectarse como un servicio
- Elija si el tipo de arranque será automático o manual.
- Pulse Siguiente.
- Especifique un nombre exclusivo para la definición de servidor web y pulse Siguiente.
- Seleccione el escenario de la configuración.
- Elija el escenario remoto.
- Identifique el nombre de host o la dirección IP de la
máquina A, que es la máquina del servidor de aplicaciones.
- Pulse Next (Siguiente).
- Seleccione el perfil que debe configurarse con el plug-in del servidor web actual y pulse Siguiente.
Este panel no se visualiza si ha seleccionado el escenario remoto en el paso anterior.
- Examine el panel de resumen y pulse Configurar para
empezar la configuración.
El panel le notifica que debe llevar a cabo pasos manuales
para completar la instalación y la configuración.
La herramienta de configuración de plug-ins del servidor web crea
el script
configurenombre_servidor_web
en el directorio
raíz_plug-ins/bin/ de la
máquina B (la máquina con el servidor web).
La herramienta de configuración de plug-ins del servidor web
también crea el archivo plugin-cfg.xml en el
directorio
raíz_plug-ins/config/nombre_servidor_web.
El servidor web lee el archivo plugin-cfg.xml
para determinar las aplicaciones que el servidor de aplicaciones de
la máquina A puede servir en el servidor web en la máquina B. Cuando
cambia la configuración, el servidor de aplicaciones vuelve a generar
el archivo. Cuando la regeneración tenga lugar, propague o copie el
archivo plugin-cfg.xml real de la máquina del
servidor de aplicaciones a la máquina del servidor web. Puede
propagar automáticamente el archivo al producto IBM
HTTP Server.
- Verifique el éxito de la instalación en el panel Resumen y pulse Finalizar.
Si se produce un problema y la instalación no se
realiza correctamente, examine los archivos de registros cronológicos del
directorio
raíz_plug-ins/logs.
Corrija los problemas y vuelva a realizar la configuración.
- Copie el script
configurenombre_servidor_web
de la máquina B (la máquina con el servidor web) en el directorio
raíz_servidor_aplicaciones
/bin de la máquina A (la máquina del servidor de
aplicaciones).
nombre_servidor_web es el apodo del servidor
web que se ha especificado. nombre_servidor_web no
es un nombre de proveedor, como IIS o Apache.
En un sistema operativo como, por ejemplo, AIX o Linux, el archivo es configurenombre_servidor_web.sh.
En un sistema Windows, el archivo es configurenombre_servidor_web.bat.
Por ejemplo, en un sistema Linux con un IBM HTTP Server denominado web_server_1 en la ubicación predeterminada, copie raíz_plug-ins/bin/configureweb_server_1.. sh de la máquina B (la máquina con el servidor web) en el directorio raíz_servidor_aplicaciones/bin de la máquina A (la máquina del servidor de aplicaciones).
Por ejemplo, en un sistema IBM i con un IBM HTTP Server denominado web_server_1 en la ubicación predeterminada, copieraíz_plug-ins/bin/configureweb_server_1 de la máquina B (la máquina con el servidor web) al directorio raíz_servidor_aplicaciones/bin de la máquina A (la máquina del servidor de aplicaciones).
- Compense las diferencias de codificación para evitar un error
del script.
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 caso 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.
El contenido del script
configurenombre_servidor_web
puede dañarse si la codificación de archivo predeterminado de las dos
máquinas es distinta.
Este caso 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 y utilice uno de los
procedimientos siguientes para evitar el error. Para determinar la codificación de archivo predeterminado, ejecute el mandato apropiado.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
- Ejecute el mandato locale charmap en un sistema como
AIX o Linux.
- Ejecute el mandato CHCP en una máquina Windows.
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 para compensar las diferencias de codificación
Omita los caracteres de continuación
(\) 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.
Nota: Si copia en un archivo .sh en un sistema operativo basado en UNIX
después de la configuración remota en un sistema operativo
Windows, debe ejecutar chmod 755.
- Inicie el servidor de aplicaciones en la máquina A.
- Abra una ventana de mandatos y cambie el directorio de perfil
donde se deba asignar el servidor web. Ejecute el script que ha copiado en la
máquina A (la máquina del servidor de aplicaciones). Necesita los parámetros siguientes:
- Nombre de perfil
- (Opcional) ID de usuario administrativo
- (Opcional) Contraseña de usuario administrativo
Por ejemplo, puede escribir lo siguiente:configurewebserver1.sh AppSrv01 mi_ID_usuario mi_contraseña
El servidor web se configura a través dedwsadmin.El contenido del script
configurewebserver1.sh será similar a lo siguiente:
wsadmin.bat
-profileName AppSrv01 -user mi_ID_usuario -password
mi_contraseña
-f "%WAS_HOME%\bin\configureWebserverDefinition.jacl" webserver1 IHS..
- En la consola administrativa del gestor de despliegue, pulse
Administración del sistema > Guardar cambios en el repositorio maestro >
Sincronizar cambios con nodos > Guardar.
Sólo
para el servidor web Domino: establezca la
variable de entorno WAS_PLUGIN_CONFIG_FILE. En plataformas como AIX o
Linux, proporcionar un script al shell principal
permite a los procesos secundarios heredar las variables exportadas.
En sistemas Windows, ejecute el script del mismo modo que ejecutaría cualquier otro
mandato. El abastecimiento del script en Windows se realiza de forma automática.
- Abra una ventana de mandatos.
- Vaya al directorio raíz de instalación de plug-ins.
- Emita el mandato apropiado para el script raíz_plug-ins/bin/setupPluginCfg.sh:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
. raíz_plug-ins/bin/setupPluginCfg.sh
(Observe que hay un espacio entre el punto y el directorio raíz de instalación.)
source
raíz_plug-ins/bin/setupPluginCfg.sh
El script también está en el directorio
raíz_lotus/notesdata en sistemas operativos como
AIX o Linux.
Emita el mandato apropiado para el script antes de iniciar Domino Web Server.
- Genere de nuevo el archivo plugin-cfg.xml
en la máquina A (la máquina del servidor de aplicaciones) mediante la
consola de administración. Pulse Servidores > Tipos de servidor > Servidores web.
Seleccione el servidor web y pulse Generar
plug-in.
Durante la instalación de los plug-ins, el archivo
plugin-cfg.xml predeterminado se instala en el
directorio
raíz_plug-ins/config/nombre_servidor_web
de la máquina B (la máquina que tiene el 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 actual del servidor de
aplicaciones, propague el archivo plugin-cfg.xml como se describe en el paso
siguiente.
Este paso muestra cómo generar de nuevo el archivo plugin-cfg.xml. Los productos de WebSphere Application Server
están configurados para volver a generar de forma automática el archivo cada vez que se
produce un suceso importante. Dichos sucesos incluyen la instalación de aplicaciones en
el servidor de aplicaciones y el servidor web, por ejemplo. Crear un
host virtual nuevo también puede considerarse un suceso de este tipo.
- Propague el archivo plugin-cfg.xml del
servidor de aplicaciones al servidor web utilizando la consola de
administración. Pulse
Servidores > Servidor Web. Seleccione el servidor web y pulse Propagar
plug-in.
Los servidores Web que no sean IBM HTTP Server
requieren una propagación manual.
El servicio de configuración de plug-ins del servidor web propaga el archivo
plugin-cfg.xml automáticamente sólo para
IBM HTTP Server. Para
los demás servidores web, propague el archivo de configuración de
plug-ins 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 (la máquina del servidor de aplicaciones) en el
directorio
raíz_plug-ins/config/nombre_servidor_web
de la máquina B (la máquina que tiene el servidor web).
- Inicie el servlet Snoop para verificar la capacidad del servidor
web de recuperar una aplicación del servidor de aplicaciones.
Pruebe el entorno iniciando el servidor de aplicaciones, el
servidor web y utilizando el servlet Snoop con una dirección IP.
- Inicie el servidor de aplicaciones. En un entorno Network Deployment, el servlet Snoop sólo está disponible en la célula si se ha incluido DefaultApplication al añadir el servidor de aplicaciones a la célula.
La opción -includeapps del mandato
addNode migra DefaultApplication (aplicación predeterminada) a la célula. Si la aplicación no está presente, omita este paso.
- Inicie IBM HTTP Server o el servidor web que utilice.
Utilice la página 2001 o utilice el mandato STRTCPSVR
SERVER(*HTTP) HTTPSVR(nombre_instancia) para iniciar
IBM HTTP Server.
Utilice una ventana de mandatos para cambiar de directorio a la imagen instalada de IBM HTTP Server o la imagen instalada del servidor web.
Emita el mandato adecuado para arrancar el servidor web, como estos mandatos de IBM HTTP Server:
Para iniciar IBM HTTP Server desde la línea de mandatos:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Acceda a los
mandatos
apache y
apachectl del directorio
IBMHttpServer/bin.
- 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.
El puerto de transporte HTTP es 9080
por omisión y debe ser único para cada perfil. El puerto está asociado con un sistema virtual denominado default_host, que está configurado para albergar la aplicación DefaultApplication. El servlet Snoop forma parte de DefaultApplication. Cambie el puerto para que coincida con el puerto de transporte HTTP real.
- Compruebe que el servlet Snoop se está ejecutando.
Las direcciones web deben mostrar la página Snoop Servlet - Request/Client Information.
- Sólo para el IBM HTTP Server remoto:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Siga los pasos que se indican a continuación para verificar si la función
de propagación automática puede ejecutarse en un IBM HTTP Server remoto. Este
procedimiento no es necesario para servidores web locales.
- Cree 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
- Utilice la consola administrativa del gestor de despliegue o del servidor de aplicaciones para especificar el ID de usuario y la contraseña que ha creado para el usuario de administración de IBM HTTP Server.
Vaya a Servidores
> Servidor web > definición_servidor_web > Administració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 de plug-in, es preciso que
el servidor administrativo IBM HTTP esté
ejecutándose. 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"
Realice el procedimiento siguiente para solucionar el error:
- Compruebe que se esté ejecutando el servidor de administración de
IBM HTTP Server.
- 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ónIBM HTTP.
- 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 de administración. Esta consideración
es principalmente para los certificados autofirmados.
- Si sigue teniendo problemas, consulte el archivo IBM HTTP Server admin_ERROR. LOG
y los registros cronológicos de WebSphere Application
Server (archivo trace.log) para determinar la causa del problema.
Resultados
Este procedimiento da lugar a la instalación de los Plug-ins de servidor web
para WebSphere Application Server en una máquina de servidor web. La herramienta de configuración de plug-ins de servidor web también configura el servidor web para dar soporte a un servidor
de aplicaciones en otra máquina.
La instalación de los plug-ins del servidor web da lugar a la
creación del directorio
Plugins y de varios
subdirectorios. Los directorios siguientes son
algunos de los directorios que se crean, por ejemplo, en un sistema Linux:
- raíz_plug-ins/bin/32bits o
raíz_plug-ins/bin/64bits contiene los plug-ins binarios
para todos los servidores web soportados
- raíz_plug-ins/logs
contiene archivos de registros cronológicos
- raíz_plug-ins/properties
contiene información sobre la versión
Qué hacer a continuación
Consulte Selección
de un diagrama de topología de servidor web y de un mapa para obtener una visión general
del procedimiento de instalación.
Consulte Configuración de servidor web para
obtener más información sobre los archivo implicados en la configuración de un servidor web.
Consulte Configuración de plug-ins para obtener
información sobre la ubicación del archivo de configuración de plug-in.
Consulte Edición de archivos de configuración del servidor para obtener más
información sobre el modo en que la herramienta de configuración de plug-ins de servidor web configura los servidores web soportados.