WebSphere® Application Server proporciona un complemento de servidor web que puede configurar para comunicarse con una marca particular de servidor web. Aprenda a instalar el servidor web y su complemento de servidor web para WebSphere Application Server en una máquina y configurar el servidor de aplicaciones en el perfil predeterminado en otra máquina para comunicarse con el servidor web.
Antes de comenzar
Si existen varios perfiles, puede seleccionar el configurado por la herramienta de configuración de plug-ins del servidor web. Ver Configuración de complementos para obtener una descripción del flujo de lógica que determina cómo seleccionar el perfil a configurar.
Si el WebSphere Application Server La familia de productos admite una marca particular de servidor web, como IBM® HTTP Server o Microsoft Internet Information Services (IIS), su WebSphere Application Server El producto proporciona un complemento binario para el servidor web que debe instalar.
Si el WebSphere Application Server Si una familia de productos no proporciona un complemento binario para una marca particular de servidor web, el servidor web no será compatible. 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
![[AIX Solaris HP-UX Linux Windows]](../images/ngdist.svg)
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.
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 tema se describe cómo crear la topología
siguiente:
Este tema describe la instalación de un servidor web en una máquina y el
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 ServerExpress 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 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:
- Plug-ins de servidor web para WebSphere Application Server
- WebSphere Customization Toolbox
- Usar Installation Manager para instalar el IBM HTTP Server en la Máquina B, o instale otro servidor web compatible en la Máquina B.
Abre el WebSphere Caja de herramientas de personalización e inicie la herramienta de configuración de complementos del 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 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.
- Hacer clic Crear.
- Seleccione el tipo de servidor web que está configurando y haga clic en Próximo.
- Seleccione la arquitectura de su servidor web de destino instalado (64 bits o 32 bits) y haga clic en Próximo si te lo piden.
- Hacer clic Navegar Para seleccionar el archivo o archivos de configuración para su servidor web, verifique que el puerto del servidor web sea correcto y luego haga clic en Próximo Cuando termines.
Seleccione el archivo y no solamente
el directorio del archivo. Algunos servidores web tienen dos archivos de configuración y es necesario que localice los dos archivos.
La siguiente lista muestra los archivos de configuración para los
servidores web soportados:
- Apache HTTP Server
- raíz_apache/config/httpd.conf
- Servidor web Domino
- 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 del servidor web verifica que los archivos existen pero no los valida.
- IBM HTTP Server
IHS_raíz/conf/httpd.conf
- Servicios de información de Internet (IIS) de Microsoft
- La herramienta de configuración de plug-ins del servidor web
puede determinar los archivos que hay que editar.
- Sun Java™ System Web Server (anteriormente Sun ONE Web Server y iPlanet Servidor web) Versión 6.0 y después
- obj.conf y magnus.conf
- Si está configurando un complemento de servidor web IBM HTTP, realice las siguientes acciones.
- Especifique un nombre exclusivo para la definición del servidor web y haga clic en Próximo.
- Seleccione el escenario de la configuración.
- Elija el escenario remoto.
- Identifique el nombre de host o la dirección IP de lamáquina A, que es la máquina del servidor de aplicaciones.
- Pulse Siguiente.
- Seleccione el perfil para configurar con el complemento del servidor web actual y haga clic en Próximo.
Este panel no se visualiza si ha seleccionado el escenario remoto en el paso anterior.
- Examine el panel de resumen y haga clic en Configurar para comenzar a configurar.
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 complementos del servidor web crea elconfigureweb_server_name guión en el raíz_complementos/bin/ directorio en la Máquina B (la máquina con el servidor web).
La herramienta de configuración de complementos del servidor web también crea elplugin-cfg.xml archivo en el raíz_complementos/config/web_server_name directorio.
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 IBM HTTP Server producto.
- Verifique el éxito de la instalación en el panel de resumen y haga clic en 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.
- Copia elconfigureweb_server_name script desde la Máquina B (la máquina con el servidor web) al raíz_servidor_aplicación/bin directorio en 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 AIX® o Linux®, el archivo esconfigureweb_server_name.sh . En un sistema Windows, el archivo esconfigureweb_server_name.bat . Por ejemplo, en un Linux sistema con un IBM HTTP Server llamado web_server_1 en la ubicación predeterminada, copie raíz_complementos/bin/configureweb_server_1.sh desde la Máquina B (la máquina con el servidor web) a la raíz_servidor_aplicación/bin directorio en 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 laconfigureweb_server_name.bat guión o elconfigureweb_server_name.sh El script puede estar dañado si la codificación de archivos predeterminada de las dos máquinas es diferente. 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/ngdist.svg)
- Ejecute ellocale charmap comando en un sistema como AIX o Linux.
- Ejecute elCHCP comando en una máquina con 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 sobre un.sh archivo 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.
- Inicie el servidor de administración de IBM HTTP Server.
El servidor de administración debe iniciarse para que el script configureweb_server_name.bat/.sh pueda generar y propagar el archivo plugin-cfg.xml. Para más información, ver Iniciar y detener el IBM HTTP Server Servidor de Administración.
Si no inicia el servidor de administración, el script puede configurar el servidor web, pero el complemento no se propaga yPLGC0063E,PLGC0049E, yPLGC0053Ese producen errores.
- 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).
Los siguientes parámetros son necesarios:
- Nombre de perfil
- (Opcional) ID de usuario administrativo
- (Opcional) Contraseña de usuario administrativo
Por ejemplo, puede escribir lo siguiente:
configurewebserver1.sh AppSrv01 my_user_ID my_Password
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 my_user_ID -password my_Password
-f "%WAS_HOME%\bin\configureWebserverDefinition.jacl" webserver1 IHS..
![[Linux]](../images/nglinux.svg)
![[AIX]](../images/ngaix.svg)
![[HP-UX]](../images/nghpux.svg)
Solo servidor web Domino: establezca la variable de entorno WAS_PLUGIN_CONFIG_FILE.
En plataformas como AIX o Linux, obtener un script en el shell principal permite que los procesos secundarios hereden las variables exportadas. En sistemas Windows, ejecute el script como ejecutaría cualquier otro comando. El abastecimiento es automático en los sistemas Windows.
- Abra una ventana de mandatos.
- Vaya al directorio raíz de instalación de plug-ins.
- Emitir el comando apropiado para el raíz_complementos/bin/setupPluginCfg.sh guion:
![[AIX]](../images/ngaix.svg)
![[HP-UX]](../images/nghpux.svg)
![[Solaris]](../images/ngsolaris.svg)
.
plugins_root/bin/setupPluginCfg.sh(Observe el espacio entre el punto y el directorio raíz de instalación).
![[Linux]](../images/nglinux.svg)
source
plugins_root/bin/setupPluginCfg.sh
El guión también está en el raíz de loto/notesdata directorio en sistemas operativos como AIX o Linux.
Emita el comando apropiado para el script antes de iniciar el servidor web de Domino.
- Regenerar elplugin-cfg.xml archivo en la Máquina A (la máquina del servidor de aplicaciones) usando la consola administrativa. Pulse Servidores > Tipos de servidor >
Servidores web. Seleccione el servidor web y pulse Generar plug-in.
Durante la instalación de los complementos, el valor predeterminadoplugin-cfg.xml El archivo está instalado en la máquina B (la máquina con el servidor web) en el raíz_complementos/config/web_server_name directorio. 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. WebSphere Application Server Los productos están configurados para regenerar automáticamente el archivo cada vez que ocurre un evento 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.
- Propagar elplugin-cfg.xml desde el servidor de aplicaciones al servidor web mediante la consola administrativa. Hacer clic 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 del complemento del servidor web propaga elplugin-cfg.xml archivar automáticamente para IBM HTTP Server 8.5 solo. 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.
- Iniciar el IBM HTTP Server o el servidor web que esté utilizando.
Utilice una ventana de comando para cambiar el directorio al IBM HTTP Server imagen instalada, o a la imagen instalada de su servidor web. Emita el comando apropiado para iniciar el servidor web, como estos comandos para IBM HTTP Server:
Para iniciar el IBM HTTP Server desde la línea de comando:
![[AIX Solaris HP-UX Linux Windows]](../images/ngdist.svg)
Acceder al
apache y
apachectl comandos en el
IBMHttpServer/bin directorio.
- Dirija su navegador a http://localhost:9080/snoop para probar el transporte HTTP interno proporcionado por el servidor de aplicaciones. Apunte su navegador ahttp://Host_name_of_Web_server_machine/snoop para probar el complemento del servidor web.
El puerto de transporte HTTP es 9080 de forma predeterminada 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.
- Remoto IBM HTTP Server solo:
![[AIX Solaris HP-UX Linux Windows]](../images/ngdist.svg)
Verifique que la función de propagación automática pueda funcionar en un control remoto IBM HTTP Server siguiendo los siguientes pasos. 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 servidor de aplicaciones para ingresar la información de ID de usuario y contraseña que creó para el usuario administrativo 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. Ver el IHS_raíz /logs/admin_ERROR. LOG archivo para 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
Realice el procedimiento siguiente para solucionar el error:
- 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.
- Verifique que el ID de usuario y la contraseña especificados en el WebSphere Application Server consola administrativa bajo administración remota, se crea en eladmin.passwd archivo, utilizando elhtpasswd dominio.
- 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 aún tienes problemas, revisa el IBM HTTP Serveradmin_ERROR. LOG archivo y el WebSphere Application Server registros (trace.log archivo) para determinar la causa del problema.
Resultados
Este procedimiento da como resultado la instalación de los complementos del servidor web para WebSphere Application Server en una máquina 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 siguientes directorios se encuentran entre los creados en un Linux sistema, por ejemplo:
- raíz_plug-ins/bin
contiene los plug-ins binarios de todos los servidores web admitidos
- 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
Ver Seleccionar un diagrama de topología y una hoja de ruta del servidor web para obtener una descripción general del procedimiento de instalación.
Ver configuración del servidor web para obtener más información sobre los archivos involucrados en la configuración de un servidor web.
Ver Configuración de complementos para obtener información sobre la ubicación del archivo de configuración del complemento.
Ver Edición de archivos de configuración del servidor web para obtener información sobre cómo la herramienta de configuración de complementos del servidor web configura los servidores web compatibles.