Este procedimiento describe cómo instalar un servidor web y su plug-in
en una máquina en la que el perfil predeterminado es un perfil personalizado.
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.
En este procedimiento se configura el perfil personalizado en la máquina B. En este procedimiento se presupone que ya se ha instalado un
gestor de despliegue en la máquina A.
El nodo de WebSphere Application Server de la máquina B es
el nodo personalizado que se crea en este procedimiento. Este procedimiento inicia el gestor de despliegue y federa el nodo personalizado
antes de instalar los Plug-ins de servidor web.
Inicie el gestor de despliegue.
El gestor de despliegue debe estar en ejecución para federar y configurar correctamente
el nodo personalizado.
Acerca de esta tarea
Nota: En este tema se hace referencia a uno o más de los archivos de registro del servidor de aplicaciones. Como alternativa recomendada, puede configurar el servidor para utilizar la infraestructura de registro y rastreo HPEL en lugar de utilizar los archivos SystemOut.log , SystemErr.log, trace.log y activity.log en sistemas distribuidos y de IBM® i. Puede también utilizar HPEL junto con sus recursos de registro nativos de z/OS. Si utiliza HPEL, puede acceder a toda la
información de registro y rastreo utilizando la herramienta de línea de mandatos LogViewer desde
el directorio bin de perfil de servidor. Consulte la información sobre la utilización de HPEL
para resolver problemas de aplicaciones para obtener más información sobre la utilización de
HPEL.
Utilice este procedimiento para instalar el plug-in del servidor web, configurar el servidor web y crear una definición de servidor web en el perfil personalizado (nodo personalizado).
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
Procedimiento
- Inicie una sesión en el sistema operativo.
Si va a realizar la instalación como un usuario no root o no
administrativo, existen determinadas limitaciones.
![[Windows]](../images/windows.gif)
Cuando se realiza la instalación como usuario
administrativo en un sistema operativo Windows,
se crea un servicio Windows de forma automática
para iniciar automáticamente el servidor de aplicaciones. La cuenta de usuario
del instalador debe tener los siguientes derechos de usuario avanzados:
- Actuar como parte del sistema operativo
- Conectarse como un servicio
Por ejemplo, en algunos sistemas operativos Windows, pulse
Panel de control > Herramientas administrativas > Directiva de seguridad local > Directivas locales > Asignaciones de derechos de usuario para establecer las opciones avanzadas. Consulte la documentación del sistema operativo
Windows si desea más información.
Si tiene previsto ejecutar el servidor de
aplicaciones como un servicio de Windows, no
realice la instalación con un ID de usuario que contenga espacios. Los ID de usuario con espacios no
se pueden validar. No puede utilizarse un ID de usuario de este tipo para continuar
con la instalación.
Para solucionar esta restricción, instale un ID de usuario que no
contenga espacios.
- Utilice Installation Manager para instalar lo siguiente en la máquina B:
- WebSphere Application
Server Network Deployment
- Los plug-ins de servidor web para WebSphere Application Server
- Websphere Customization Toolbox
- Utilice Installation Manager para instalar IBM HTTP Server en la máquina B o para instalar otro servidor web soportado en la máquina b.
- Cree un perfil personalizado como el primer perfil en la Máquina B, y federe el nodo cuando cree el perfil.
- Opcional: Utilice la consola administrativa del gestor de
despliegue para crear un servidor de aplicaciones en el nodo personalizado.
Pulse Servidores > Servidores de aplicaciones > Nuevo y siga
las instrucciones para crear un servidor. No se necesita ningún servidor para instalar los plug-ins, pero permite verificar
el funcionamiento del servidor web.
- Opcional: Instale DefaultApplication en el servidor
nuevo cuando se encuentre en la consola administrativa del gestor de despliegue.
DefaultApplication incluye el servlet Snoop. El paso de verificación
utiliza el servlet snoop.
- Abra WebSphere Customization Toolbox e inicie la herramienta de configuración de plug-in de servidor web en la máquina B.
- Seleccione una ubicación de tiempo de ejecución de plug-in de servidor web.
Si la ubicación de un plug-in de 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 local.
- Efectúe una de las acciones siguientes:
- Escriba la ubicación de instalación de WebSphere Application Server (app_server_root).
- Pulse Examinar, busque la ubicación de instalación de WebSphere Application Server (app_server_root), y pulse ACEPTAR.
- Pulse Next (Siguiente).
- Seleccione el perfil que debe configurarse con el plug-in del servidor web actual y pulse Siguiente.
- Revise la información de resumen y pulse Configurar para empezar a configurar el servidor web, el plug-in de servidor y el perfil.
- 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.
- Cree la definición de servidor web en la Máquina A.
Puede utilizar la consola administrativa del gestor de despliegue para
crear la definición del servidor web en un nodo federado. O bien, puede ejecutar el script de configuración que ha creado la herramienta de configuración de plug-ins de servidor web.
El script ya contiene toda la información que debe recopilar cuando utilice la
opción de la consola administrativa.
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.
- 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.
- Si el gestor de despliegue no tiene DefaultApplication
instalado, puede probar la funcionalidad del servidor web y del nodo personalizado
utilizando una de sus aplicaciones.
- En la consola administrativa del gestor de despliegue, pulse Administración de sistema >
Guardar cambios en el repositorio maestro > Sincronizar cambios con nodos > Guardar.
- Para crear varias definiciones de servidor web para el nodo gestionado,
utilice la herramienta de configuración de plug-ins de servidor web para configurar cada servidor web.
Identifique el mismo nodo gestionado cada vez. Asigne al servidor web un apodo
distinto.
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 crea una definición de servidor web dentro del
nodo gestionado.
La herramienta de configuración de plug-ins de servidor web configura el servidor web para que utilice el archivo plugin-cfg.xml que
hay dentro del nodo personalizado gestionado.
El gestor de despliegue
genera de nuevo el archivo de configuración de plug-in del servidor web,
plugin-cfg.xml, siempre que se produce un suceso que afecta al archivo. Sucesos
de este tipo pueden ser la adición o supresión de una aplicación, un servidor o un
host virtual.
La creación o eliminación de clústeres y de miembros de clúster
da lugar a que se genere de nuevo el archivo. La propagación automática a través de la
sincronización del nodo copia el archivo después de cada regeneración en la ubicación
siguiente de la máquina del nodo personalizado:
raíz_perfil
/config/cells/nombre_célula/nodes/
nombre_nodo_de_perfil_personalizado/servers/
nombre_servidor_Web/plugin-cfg.xml
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 Configuración de plug-ins para obtener
información sobre la ubicación del archivo de configuración de plug-in.
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 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.
Consulte
Configuración de plug-ins de servidor web para
obtener información sobre otros escenarios de instalación para instalar los plug-ins
de servidor web.