Capítulo 1. Requisitos de instalación para IBM WebSphere Application Server - Express
Capítulo 2. Instalar WebSphere Application Server - Express en Windows
Capítulo 3. Instalar WebSphere Application Server - Express en Linux
Capítulo 4. Instalación de WebSphere Application Server - Express en AIX
Capítulo 5. Instalar WebSphere Application Server - Express en Solaris
Capítulo 6. Instalar WebSphere Application Server - Express en HP-UX
Capítulo 7. Conectores de seguridad de servidor Web HTTP
Capítulo 8. Instalar los conectores de seguridad de servidor Web HTTP
Capítulo 9. Configurar WebSphere Application Server - Express para trabajar en un entorno de equipo
Esta sexta edición (Noviembre 2003) de la Guía de instalación contiene la información siguiente para WebSphere Application Server - Express Versión 5.1:
Consulte el sitio de soporte del producto en www.ibm.com/software/webservers/appserv/express/support.html para obtener la siguiente información de arreglos y soporte:
Por ejemplo, para actualizar de 5.0 ó 5.0.1 ó 5.0.2 a 5.1.
Tenga en cuenta lo siguiente acerca de WebSphere Application Server - Express V5.1:
Esta guía está disponible en las versiones HTML y PDF Acrobat, en el directorio raíz del CD de instalación y en el directorio de instalación del producto. Ambas versiones contienen información idéntica. Puede abrir install.html en cualquier navegador Web. Para abrir install.pdf, debe tener instalado el software Acrobat Reader, que puede bajar de www.adobe.com/products/acrobat/readstep2.html.
El hardware siguiente debe estar instalado para poder instalar WebSphere Application Server - Express:
Pantalla VGA 800 x 600 como mínimo (se recomienda 1024 x 768)
Pantalla SVGA 1024 x 768 como mínimo
Da soporte a un adaptador de comunicaciones
Soporte para TCP/IP y un adaptador.
El software siguiente debe estar instalado para poder instalar WebSphere Application Server - Express:
Uno de los siguientes sistemas operativos:
Windows(R) 2000 Server o Advanced Server con Service Pack 4 o
superior, solo el componente servidor remoto
Windows(R) 2003 Server Standard Edition, solo el componente
servidor remoto
Windows(R) 2000 Professional con Service Pack 4 o superior,
componentes servidor y herramientas de WebSphere Studio
Windows XP SP1a Professional para los componentes herramientas y servidor de
WebSphere Studio
Red Hat, Versión 7.2, solo para el componente herramientas de
WebSphere Studio, incluido el entorno de prueba unitaria
Red Hat, Versión 8.0, solo para el componente herramientas de
WebSphere Studio, incluido el entorno de prueba unitaria
Red Hat, Versión AS (o EL) 2.1, solo para el componente servidor
remoto
SuSE, Versión 7.2, solo el componente herramientas de WebSphere Studio,
incluido el entorno de prueba unitaria
SuSE, Versión 8.1, solo el componente herramientas de Studio, incluido
el entorno de prueba unitaria
United Linux V 1.0 ( Suse SLES 8), solo el componente servidor remoto
AIX 5.2 (5200-01 de nivel de mantenimiento) solo el componente
servidor remoto, con despliegue remoto desde cualquier plataforma soportada de
herramientas de Studio
Solaris 9 (con el parche recomendado de Cluster de abril de 2003), solo el
componente servidor remoto
HP 11iv1 (nivel de arreglo de diciembre de 2002), solo el componente servidor
remoto
Tabla 1. Idiomas soportados por los sistemas operativos Red Hat y SuSE.
|
| Solo inglés | Inglés más otros idiomas | Juego de caracteres de un solo byte (SBCS) | Juego de caracteres de9 doble byte (DBCS) (ver nota 1) |
|---|---|---|---|---|
| Red Hat 7.2 | SÍ |
|
|
|
| Red Hat 8.0 |
| SÍ | SÍ | SÍ (1) |
| SuSE 7.2 | SÍ |
|
|
|
| SuSE 8.1 |
| SÍ | SÍ |
|
(1) Si desea utilizar el juego de caracteres de doble byte en Red Hat 8.0 debe actualizar GTK 2.0 a GTK 2.2 o posterior. Consulte el apartado (Optional) Actualizar a GTK 2.2.2 o una versión posterior.
Avisos:
Si tiene instalado WebSphere Application Server - Express e instaló conectores de terceros, debe obtener los conectores correspondientes para la Versión 5.1.1 y volver a instalarlos.
Este paquete contiene dos juegos de CD:
Escenarios de utilización de la instalación
IMPORTANTE: puede utilizar DB2 Universal Database Express Edition en un sistema solo a efectos de demostración, prueba y desarrollo de programas de aplicación. No puede instalar este programa en un servidor de producción. Consulte la licencia que se incluye para obtener más detalles.
Esta sección contiene información acerca de la instalación de WebSphere Application Server - Express en Windows. Los componentes principales de WebSphere Application Server - Express son Application Server (servidor de aplicaciones), Remote Agent Controller y WebSphere Studio Site Developer (WSSD). Puede optar por instalar alguno de estos componentes o todos ellos. Debe instalar Remote Agent Controller juntamente con el servidor de aplicaciones para poder administrar el servidor de aplicaciones utilizando WSSD. Puede instalar WebSphere Application Server - Express desde el CD-ROM o desde las imágenes electrónicas que descargue.
Nota de instalación:
El programa de instalación puede ejecutarse en una modalidad de consola interactiva en lugar de utilizar los paneles del asistente de GUI. La modalidad de consola puede estar más indicada para personas con necesidades de acceso. La modalidad "-accessibility" proporciona información audible para usuarios finales con limitaciones de visión. Para ejecutar en modalidad de consola, ejecute este mandato desde el directorio setup del CD de instalación de WebSphere Application Server - Express:
Siga las solicitudes para completar la instalación. Nota: la opción "-is:javaconsole" es de vital importancia. Si no especifica esta opción, el programa de instalación se colgará. "-log @NONE" desactiva el registro de anotaciones para la consola. Si experimenta problemas durante la instalación, elimine esta opción para recoger anotaciones.
Importante: no instale esta versión sobre una versión anterior. Puede instalarlo en otro directorio para que coexistan o desinstalar la versión anterior antes de instalar en el mismo directorio. Si el programa de instalación detecta una versión anterior del servidor de aplicaciones, se le brindará la oportunidad de migrar la configuración a la del servidor de la versión 5.1. Encontrará más detalles en la Guía de migración.
Importante: si intenta abrir un área de trabajo de la Versión 4.0.x desde el IDE de la Versión 5.1.1 de Studio Site Developer, el área de trabajo se convertirá en un área de trabajo de la Versión 5.1.1. Los nombres de proyecto, los archivos fuente de proyecto y las vías de construcción Java (vías de acceso de clases) del proyecto se conservan. Sin embargo, los valores de interfaz de usuario, depuración y la mayoría de las preferencias se pierden. En la Guía de migración hallará instrucciones para migrar sin problemas los proyectos existentes a la Versión 5.1.1.
Como precaución, le recomendamos que haga copia de seguridad de las áreas de trabajo de la Versión 5.x antes de migrar a la Versión 5.1.1.
Antes de instalar el producto, compruebe lo siguiente:
Para instalar WebSphere Application Server - Express desde el primer CD de instalación del producto, siga estos pasos:
Sugerencias:
Importante: no instale en un directorio cuyo nombre contenga caracteres de doble byte o caracteres especiales como por ejemplo un signo de dólar. Si hace esto, es posible que se produzcan efectos indeseados tales como problemas de vías de acceso de clase en el entorno de prueba de WebSphere.
Hay múltiples componentes descargables para WebSphere Application Server - Express. Todos los componentes son archivadores autoextraíbles y todos son obligatorios.
Antes de instalar el producto, compruebe lo siguiente:
Para instalar la imagen electrónica de WebSphere Application Server - Express, siga estos pasos:
Después de instalar WebSphere Application Server - Express, debe tener la siguiente estructura de directorios bajo el directorio <VíaInstalaciónExpress> que seleccionó durante la instalación:
En caso de que el número de archivos de alguno de estos directorios sea considerablemente distinto, puede sospechar que se produjo un problema durante la instalación. Consulte el archivo expressInstallLog.txt del directorio <VíaInstalaciónExpress>\logs para diagnosticar el problema.
Si la instalación ha concluido satisfactoriamente, inicie Site DeveloperIf siguiendo los elementos de menú Inicio > Programas > IBM WebSphere Application Server - Express 5.1 > Studio Site Developer. Una vez que se haya iniciado Site Developer, siga los enlaces de la página de bienvenida para cargar y ejecutar un ejemplo de Express.
IBM Agent Controller se instala siempre como un servicio Windows y se inicia automáticamente. IBM Agent Controller proporciona el canal de comunicación entre Site Developer y el servidor de aplicaciones. Vaya a Panel de control > Herramientas administrativas > Servicios para ver si IBM Agent Controller aparece en la lista y está ejecutándose. Si sospecha que existe algún problema, examine el archivo servicelog.log en el directorio <Expressinstallpath>\RAC\config.
ISi la instalación no concluyó satisfactoriamente, examine el archivo racInstallLog.txt del directorio <VíaInstalaciónExpress>\logs. Si el archivo racInstallLog.txt no existe, puede que se deba a que ya había otra versión de IBM Agent Controller en el sistema. Desinstale la otra versión y vuelva a intentar la instalación.
Puede verificar el funcionamiento básico de la instalación del servidor de aplicaciones ejecutando Verificar instalación de servidor desde la aplicación Primeros Pasos. La aplicación Primeros Pasos se lanza al final del proceso de instalación, pero puede lanzarla siguiendo los elementos de menú Inicio > Programas > IBM WebSphere Application Server - Express 5.1 > Primeros Pasos.
Otra manera de verificar el funcionamiento del servidor de aplicaciones consiste en ejecutar el archivo <VíaInstalaciónExpress>\Express\bin\testServer.bat. Este archivo por lotes sirve de guía para iniciar y detener el servidor de aplicaciones utilizando la configuración por omisión. Tenga en cuenta que este archivo por lotes solo se utiliza a efectos de prueba de la instalación del servidor.
Cuando se ejecuta setupwin32.exe, se inicia el programa de instalación Java y luego el control se devuelve al indicador de mandatos. En realidad, el programa de instalación sigue ejecutándose en segundo plano. A continuación se indican varias maneras sencillas de verificar si ha concluido una instalación silenciosa:
Otra manera de ejecutar el programa de instalación consiste en emitir el mandato que ejecuta directamente el programa de instalación Java. Para que el programa funcione como es debido, hay que pasar varios parámetros en la línea del mandato. En el directorio util del primer CD, hay un archivo por lotes de ejemplo que se llama syncInstall.bat y que permite ejecutar la instalación de manera síncrona (es decir, que el control no se devolverá al indicador de mandatos hasta que el programa de instalación haya terminado completamente). Puede pasar parámetros al mandato de syncInstall.bat igual que lo hace con setupwin32.exe. Este mandato por lotes es especialmente útil para las instalaciones silenciosas.
Si desea incluir WebSphere Application Server - Express en otro producto, puede ejecutar el programa de instalación de WebSphere Application Server - Express de manera silenciosa. Para instalar WebSphere Application Server - Express de manera silenciosa, utilice la opción de línea de mandatos -silent. Durante una instalación silenciosa no verá paneles del asistente después de efectuar el mandato de instalación.
Para ejecutar la instalación de manera silenciosa con los valores por omisión, utilice un mandato como:
setupwin32.exe -silent
Si desea cambiar la ubicación de la instalación de Express (IBM/WebSphere/Express) por omisión, utilice:
setupwin32.exe -silent -P waseBean.installLocation=c:\<su_directorio>
También puede utilizar un archivo de respuesta para establecer opciones adicionales para la instalación silenciosa. Consulte el archivo de respuesta de ejemplo que se incluye en el CD de instalación para ver la plantilla. Para ejecutar una instalación silenciosa utilizando un archivo de respuesta, utilice un mandato como:
setupwin32.exe -silent -options <vía totalmente calificada>\responsefile
Nota: en WebSphere Application Server - Express, si se selecciona la característica WebSphere Studio Site Developer, no se puede realizar una instalación silenciosa desde un CD. Ello se debe a que se necesita un segundo CD para la característica, y el programa de instalación no le pide el segundo CD si la instalación es silenciosa. Para instalar la característica WebSphere Studio Site Developer en modalidad silenciosa, puede copiar el segundo CD en el disco duro o montar el CD en una segunda unidad de CD y después utilizar la opción '-media 2=<vía de acceso al segundo CD>' para indicar al programa de instalación dónde se encuentra la imagen del segundo CD.
Junto con Express se incluye un archivo de respuesta de ejemplo en: \util\responsefile.txt. Este archivo le servirá de modelo para el archivo de respuesta.
Para desinstalar WebSphere Application Server - Express:
Para eliminar WebSphere Application Server - Express completamente, suprima los directorios restantes manualmente.
Cuando se ejecuta la desinstalación de WebSphere Application Server - Express, el panel de característica que se visualiza muestra varias características adicionales a las que se visualizan durante la instalación. Estas características adicionales se muestran como subcaracterísticas de la característica Studio Site Developer. Si desea seleccionar o deseleccionar la característica Studio Site Developer, asegúrese de que todas las características estén seleccionadas o deseleccionadas.
IBM Agent Controller proporciona un mecanismo de comunicación entre Studio Site Developer y el servidor de aplicaciones. Agent Controller se instala como un servicio de Windows y está configurado para ejecutarse con la cuenta de sistema local. Puede utilizar el panel del administrador de servicios de Windows para cambiar esta configuración, si desea que IBM Agent Controller se ejecute con otra cuenta de usuario. Como Agent Controller se utiliza para iniciar el servidor de aplicaciones, la cuenta con la que se que ejecuta Agent Controller es también la cuenta con la que se ejecuta el servidor de aplicaciones.
Existen varias opciones para asegurar el enlace entre Studio Site Developer y Agent Controller. La instalación configura el enlace para permitir que cualquier usuario de Studio Site Developer se conecte con Agent Controller. Si utiliza Agent Controller en un entorno de servidor de producción, podrá cambiar este valor por omisión de seguridad.
Puede utilizar los archivos <VíaInstalaciónExpress>\RAC\bin\RACSecurityOn.bat y RACSecurityOff.bat para habilitar e inhabilitar la seguridad básica de inicio de sesión. Cuando la seguridad está habilitada, el usuario de Studio Site Developer debe proporcionar una combinación válida de nombre de usuario y contraseña que sea un nombre de usuario y una contraseña del sistema operativo cuando se conecte a Agent Controller. Agent Controller reenvía el nombre de usuario y la contraseña al sistema operativo a efectos de autenticación. En Windows, no se autenticarán las contraseñas de nombres de dominio. Debe proporcionar pares de nombre de usuario local y contraseña.
Para ejecutar el programa de utilidad SetConfig de IBM Agent Controller debe tener java en la vía de acceso de ejecución.
Si instala WebSphere Application Server - Express 5.1 en una máquina en la que ya tiene una copia de WebSphere Application Server - Express 5.0, IBM Agent Controller se actualizará a la versión 5.1.1 y se configurará para que señale hacia el servidor Express 5.1. Si ulteriormente desea eliminar WebSphere Application Server - Express 5.1 y restaurar el entorno 5.0, deberá reinstalar el componente Application Server (servidor de aplicaciones) o Studio Site Developer 5.0 para restaurar la versión 5.0 de IBM Agent Controller. Con cualquiera de estas dos características de 5.0 se instala también IBM Agent Controller para 5.0.
Este apartado describe las limitaciones y los problemas conocidos relacionados con la instalación y desinstalación de WebSphere Application Server - Express en Windows. En el archivo readme hallará información sobre las limitaciones y los problemas que afectan al uso real del producto.
Si correlaciona una unidad de red sin especificar un nombre de dispositivo (por ejemplo, \\nombre_sistema\nombre_compartido), puede obtener el mensaje siguiente cuando intente instalar WebSphere Application Server - Express: El asistente no puede continuar debido al error siguiente: no se ha podido cargar el asistente especificado en /wizard.inf(104). La solución consiste en correlacionar localmente la unidad de red especificando un nombre de dispositivo (por ejemplo, x:\nombre_compartido).
No realice la instalación en una unidad de Novell NetWare. La instalación daría error en una unidad de Novell NetWare.
Debe iniciar la sesión como administrador antes de empezar la instalación de WebSphere Application Server - Express.
De vez en cuando, un error de instalación puede dar como resultado que los archivos de desinstalación en el directorio _uninst no estén completos. El síntoma de este problema consiste en un mensaje según el cual no se encuentra un JVM adecuado al tratar de ejecutar el programa de desinstalación. Debe ejecutar la desinstalación de la manera siguiente:
Si falla la instalación, debe eliminar todos los archivos de WebSphere Application Server - Express que se hayan instalado. Si el directorio en el que pensaba instalar WebSphere Application Server - Express está vacío, es que el proceso de instalación ha eliminado los archivos que ya se habían instalado; puede suprimir el directorio vacío si lo desea.
Pasos a seguir si falla la instalación:
Esta sección contiene información acerca de la instalación de WebSphere Application Server - Express en Linux. Los componentes principales de WebSphere Application Server - Express son Application Server (servidor de aplicaciones), Remote Agent Controller y WebSphere Studio Site Developer (WSSD). Puede optar por instalar alguno de estos componentes o todos ellos. Debe instalar Remote Agent Controller juntamente con el servidor de aplicaciones para poder administrar el servidor de aplicaciones utilizando WSSD.
Puede instalar WebSphere Application Server - Express desde CD-ROM o desde las imágenes electrónicas que descargue.
Nota de instalación:
El programa de instalación puede ejecutarse en una modalidad de consola interactiva en lugar de utilizar los paneles del asistente de GUI. La modalidad de consola puede estar más indicada para personas con necesidades de acceso. La modalidad "-accessibility" proporciona información audible para usuarios finales con limitaciones de visión. Para ejecutar en modalidad de consola, ejecute este mandato desde el directorio setup del CD de instalación de WebSphere Application Server - Express:
Siga las solicitudes para completar la instalación. Nota: la opción "-is:javaconsole" es de vital importancia. Si no especifica esta opción, el programa de instalación se colgará. "-log @NONE" desactiva el registro de anotaciones para la consola. Si experimenta problemas durante la instalación, elimine esta opción para recoger anotaciones.
No instale esta versión sobre una versión anterior. Puede instalarlo en otro directorio para que coexistan o desinstalar la versión anterior antes de instalar en el mismo directorio. Si el programa de instalación detecta una versión anterior del servidor de aplicaciones, se le brindará la oportunidad de migrar la configuración a la del servidor de la versión 5.1. Encontrará más detalles en la Guía de migración.
Si desea obtener instrucciones para migrar sin problemas los proyectos existentes de una versión anterior de Studio Site Developer a la Versión 5.1.1, consulte la Guía de migración.
Como precaución, le recomendamos que haga copia de seguridad de las áreas de trabajo de la Versión 4.0.x y la Versión 5.0 antes de migrar a la Versión 5.1.1.
Para instalar WebSphere Application Server - Express desde el CD del producto, siga estos pasos:
Ejecutar 'setupLinux' en un indicador de mandatos:si el directorio de trabajo actual del indicador de mandatos es /mnt/cdrom y está instalando desde el CD, cuando la instalación le solicite el segundo CD de instalación no podrá sacar el primer CD de la unidad. Esto es así porque el directorio de trabajo del indicador de mandatos utiliza el CD, por lo que la unidad de CD aparece en uso. Para evitarlo, asegúrese de que el directorio de trabajo del indicador de mandatos no sea /mnt/cdrom. Esto significa que en lugar de utilizar el mandato ./setupLinux para iniciar la instalación, debe utilizar la vía de acceso completa del CD: /mnt/cdrom/setupLinux.
Ejecutar '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary' en un indicador de mandatos:
Puede obtener errores del estilo 'no se ha encontrado mqver' y 'no se ha encontrado wempsservice'. Puede ignorar estos mensajes de error.
Ejecutar Cloudscape en Linux
Para utilizar Cloudscape en Linux, emplee el script de shell EXPcview.sh proporcionado en el directorio /opt/IBM/WebSphere/Express51/Express/bin.
Antes de instalar el producto, compruebe lo siguiente:
La imagen del CD de Linux de WebSphere Application Server - Express se divide en varios componentes para reducir el tamaño de la descarga. Cada uno de los componentes es un archivo archivador de cintas (tar) y todos ellos son necesarios.
Para instalar las imágenes electrónicas de WebSphere Application Server - Express, siga estos pasos:
Después de instalar WebSphere Application Server - Express, debe tener la siguiente estructura de directorios bajo el directorio /opt/IBM/WebSphere/Express51:
En caso de que el número de archivos de alguno de estos directorios sea considerablemente distinto, puede sospechar que se produjo un problema durante la instalación. En el archivo /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt encontrará información para diagnosticar el problema.
Primero examine el archivo /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt. Vaya al final del archivo y compruebe cuál es el estado de finalización de la instalación. Si la instalación ha concluido satisfactoriamente, inicie Site Developer ejecutando wasexpress51 o /opt/IBM/WebSphere/Express51/SiteDeveloper/wasexpress51. Una vez que se haya iniciado Site Developer, siga los enlaces de la página de bienvenida para cargar y ejecutar uno de los ejemplos de Express.
Si la instalación no ha concluido satisfactoriamente, examine el archivo expressInstallLog.txt para determinar la razón.
Si la instalación ha concluido satisfactoriamente, ejecute el archivo /opt/IBMRAC/bin/RAStart.sh para iniciar IBM Agent Controller. Si sospecha que existe algún problema, examine el archivo /opt/IBMRAC/config/servicelog.log.
Si la instalación no concluyó satisfactoriamente, examine el archivo racInstallLog.txt para determinar la razón.
Puede verificar el funcionamiento básico de la instalación del servidor de aplicaciones ejecutando Verificar instalación de servidor desde la aplicación Primeros Pasos. La aplicación Primeros Pasos se lanza al final del proceso de instalación, pero puede lanzarla desde el menú Inicio.
Otra manera de verificar el funcionamiento del servidor de aplicaciones consiste en ejecutar el script /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh. Este script sirve de guía para iniciar y detener el servidor de aplicaciones utilizando la configuración por omisión. Tenga en cuenta que este script solo se utiliza para comprobar la instalación del servidor.
Si desea incluir WebSphere Application Server - Express en otro producto, puede ejecutar el programa de instalación de WebSphere Application Server - Express de manera silenciosa. Para instalar WebSphere Application Server - Express de manera silenciosa, utilice la opción de línea de mandatos -silent. Durante una instalación silenciosa no verá paneles del asistente después de efectuar el mandato de instalación.
Para ejecutar la instalación de manera silenciosa con los valores por omisión, utilice un mandato como:
./setupLinux -silent
También puede utilizar un archivo de respuesta para establecer opciones adicionales para la instalación silenciosa. Consulte el archivo de respuesta de ejemplo que se incluye en el CD de instalación para ver la plantilla. Para ejecutar una instalación silenciosa utilizando un archivo de respuesta, utilice un mandato como:
./setupLinux -silent -options <vía totalmente calificada>/responsefile
Nota: en WebSphere Application Server - Express, si se selecciona la característica WebSphere Studio Site Developer, no se puede realizar una instalación silenciosa desde un CD. Ello se debe a que se necesita un segundo CD para la característica, y el programa de instalación no le pide el segundo CD si la instalación es silenciosa. Para instalar la característica WebSphere Studio Site Developer en modalidad silenciosa, puede copiar el segundo CD en el disco duro o montar el CD en una segunda unidad de CD y después utilizar la opción "-media 2=<vía de acceso al segundo CD>" para indicar al programa de instalación dónde se encuentra la imagen del segundo CD.
Junto con Express se incluye un archivo de respuesta de ejemplo en: /util/responsefile.txt. Este archivo le servirá de modelo para el archivo de respuesta.
IBM Agent Controller proporciona un mecanismo de comunicación entre Studio Site Developer y el servidor de aplicaciones.
Existen varias opciones para asegurar el enlace entre Studio Site Developer y Agent Controller. La instalación configura el enlace para permitir que cualquier usuario de Studio Site Developer se conecte con Agent Controller. Cuando utilice Agent Controller en un entorno de servidor de producción, podrá cambiar este valor por omisión de seguridad.
Puede utilizar los scripts /opt/IBMRAC/bin/RACSecurityOn.sh y RACSecurityOff.sh para habilitar e inhabilitar la seguridad básica de inicio de sesión. Cuando la seguridad está habilitada, el usuario de Studio Site Developer debe proporcionar una combinación válida de nombre de usuario y contraseña que sea un nombre de usuario y una contraseña del sistema operativo cuando se conecte a Agent Controller. El nombre de usuario y la contraseña son enviados por Agent Controller al sistema operativo para su autenticación.
Si instala WebSphere Application Server - Express 5.1 en una máquina en la que ya tiene una copia de WebSphere Application Server - Express 5.0, IBM Agent Controller se actualizará a la versión 5.1.1 y se configurará para que señale hacia el servidor Express 5.1. Si ulteriormente desea eliminar WebSphere Application Server - Express 5.1 y restaurar el entorno 5.0, deberá reinstalar el componente Application Server (servidor de aplicaciones) o Studio Site Developer 5.0 para restaurar la versión 5.0 de IBM Agent Controller. Con cualquiera de estas dos características de 5.0 se instala también IBM Agent Controller para 5.0.
Avisos:
Si desea utilizar el juego de caracteres de doble byte (DBCS) en Red Hat 8.0, debe seguir los pasos siguientes para actualizar GTK a 2.2.2 o una versión posterior. Las instrucciones siguientes son para GTK 2.2.2.
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH
rpm -q libtiff-devel
Si no está instalado, instálelo del CD de instalación de Red Hat.
/usr/local/lib
./configure make make install /sbin/ldconfig
Por omisión, se selecciona la instalación de GTK 2.0.6. Para asegurarse de que la aplicación utiliza GTK 2.2.2, cada vez deberá ejecutar los mandatos de ejemplo siguientes en la línea de mandatos antes de lanzar la aplicación.
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH export PATH=/usr/local/bin/:$PATH /opt/IBM/WebSphereExpress/SiteDeveloper/wasexpress51
Para obtener más información sobre cómo utilizar GTK, consulte el sitio Web developer.gnome.org/doc/API/2.2/gtk/gtk-building.html.
Para desinstalar WebSphere Application Server - Express en Linux, siga estos pasos:
./uninstaller
Para eliminar WebSphere Application Server - Express completamente, suprima los directorios restantes manualmente.
Este apartado describe las limitaciones y los problemas conocidos relacionados con la instalación y la desinstalación de WebSphere Application Server - Express para Linux. En el archivo readme hallará información sobre las limitaciones y los problemas que afectan al uso real del producto.
Si la instalación falla:
De vez en cuando, un error de instalación puede dar como resultado que los archivos de desinstalación en el directorio _uninst no estén completos. El síntoma de este problema consiste en un mensaje según el cual no se encuentra un JVM adecuado al tratar de ejecutar el programa de desinstalación. Debe ejecutar la desinstalación de la manera siguiente:
Esta sección contiene información acerca de la instalación de WebSphere Application Server - Express en AIX. Los componentes principales de WebSphere Application Server - Express que pueden instalarse en AIX son Application Server (servidor de aplicaciones) y Remote Agent Controller. Puede optar por instalar uno o ambos componentes. Debe instalar Remote Agent Controller juntamente con el servidor de aplicaciones para poder administrar el servidor de aplicaciones en AIX utilizando Studio Site Developer en Windows o Linux. También puede utilizar la consola administrativa basada en navegador para administrar el servidor de aplicaciones.
Puede instalar WebSphere Application Server - Express desde CD-ROM o desde las imágenes electrónicas que descargue.
Si tiene instalada en su sistema una copia anterior de WebSphere Application Server - Express, debería desinstalarla antes de continuar.
Solo hay un CD de producto para la instalación. Para instalar WebSphere Application Server - Express desde el CD del producto, siga estos pasos:
Antes de instalar el producto, compruebe lo siguiente:
La imagen del CD de AIX de WebSphere Application Server - Express se divide en varios componentes para reducir el tamaño de la descarga.
Cada uno de los componentes es un archivo archivador de cintas (tar) y todos ellos son necesarios. Para instalar las imágenes electrónicas de WebSphere Application Server - Express, siga estos pasos:
Después de instalar WebSphere Application Server - Express, debe tener la siguiente estructura de directorios bajo el directorio /opt/IBM/WebSphere/Express51:
En caso de que el número de archivos de alguno de estos directorios sea considerablemente distinto, puede sospechar que se produjo un problema durante la instalación. Consulte el archivo /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt.
En primer lugar, consulte el archivo /opt/IBM/WebSphere/Express51/logs/expressracInstallLog.txt. Vaya al final del archivo y compruebe cuál es el estado de finalización de la instalación. Si la instalación ha finalizado satisfactoriamente, ejecute el archivo /opt/IBMRAC/bin/RAStart.sh para iniciar IBM Agent Controller. Si sospecha que existe algún problema, examine el archivo /opt/IBMRAC/config/servicelog.log.
Si la instalación no se completó satisfactoriamente, examine el archivo racInstallLog.txt para determinar la causa.
Puede verificar el funcionamiento básico de la instalación del servidor de aplicaciones ejecutando Verificar instalación de servidor desde la aplicación Primeros Pasos. La aplicación Primeros Pasos se lanza al final del proceso de instalación, pero puede lanzarla ejecutando el script /opt/IBM/WebSphere/Express51/Express/bin/launchFirstSteps.sh.
Otra manera de verificar el funcionamiento del servidor de aplicaciones consiste en ejecutar el script /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh. Este script sirve de guía para iniciar y detener el servidor de aplicaciones utilizando la configuración por omisión. Tenga en cuenta que este script solo se utiliza para comprobar la instalación del servidor.
Si desea incluir WebSphere Application Server - Express en otro producto, puede ejecutar el programa de instalación de WebSphere Application Server - Express de manera silenciosa. Para instalar WebSphere Application Server - Express silenciosamente, se utiliza la opción de línea de mandatos -silent. Durante una instalación silenciosa no verá paneles del asistente después de efectuar el mandato de instalación.
Para ejecutar la instalación de manera silenciosa con los valores por omisión, utilice un mandato como:
./aix/setupAIX -silent
También puede utilizar un archivo de respuesta para establecer opciones adicionales para la instalación silenciosa. Consulte el archivo de respuesta de ejemplo que se incluye en el CD de instalación para ver la plantilla. Para ejecutar una instalación silenciosa utilizando un archivo de respuesta, utilice un mandato como:
./aix/setupAIX -silent -options <vía totalmente calificada>/responsefile
Junto con Express se incluye un archivo de respuesta de ejemplo en: /util/responsefile.text. Este archivo le servirá de modelo para el archivo de respuesta.
IBM Agent Controller proporciona un mecanismo de comunicación entre Studio Site Developer y el servidor de aplicaciones.
Existen varias opciones para asegurar el enlace entre Studio Site Developer y Agent Controller. La instalación configura el enlace para permitir que cualquier usuario de Studio Site Developer se conecte con Agent Controller. Cuando utilice Agent Controller en un entorno de servidor de producción, podrá cambiar este valor por omisión de seguridad.
Puede utilizar los scripts /opt/IBMRAC/bin/RACSecurityOn.sh y RACSecurityOff.sh para habilitar e inhabilitar la seguridad básica de inicio de sesión. Cuando la seguridad está habilitada, el usuario de Studio Site Developer debe proporcionar una combinación válida de nombre de usuario y contraseña que sea un nombre de usuario y una contraseña del sistema operativo cuando se conecte al Agent Controller. Agent Controller reenvía el nombre de usuario y la contraseña al sistema operativo a efectos de autenticación.
Para desinstalar WebSphere Application Server - Express en AIX, siga estos pasos:
./uninstaller
Esta sección describe problemas y limitaciones conocidos de la instalación y desinstalación de WebSphere Application Server - Express para AIX. En el archivo readme hallará información sobre las limitaciones y los problemas que afectan al uso real del producto.
Si la instalación falla:
De vez en cuando, un error de instalación puede dar como resultado que los archivos de desinstalación en el directorio _uninst no estén completos. El síntoma de este problema consiste en un mensaje según el cual no se encuentra un JVM adecuado al tratar de ejecutar el programa de desinstalación. Debe ejecutar la desinstalación de la manera siguiente:
Si tiene instalada en su sistema una copia anterior de WebSphere Application Server - Express, debería desinstalarla antes de continuar.
Para instalar WebSphere Application Server - Express desde el CD del producto, siga estos pasos:
Nota de instalación:
Si ejecuta el mandato '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary' desde un indicador de mandatos, pueden producirse errores del estilo 'no se ha encontrado mqver' y 'no se ha encontrado wempsservice'. Puede ignorar estos mensajes de error.
Antes de instalar el producto, compruebe lo siguiente:
La imagen del CD de Solaris de WebSphere Application Server - Express se divide en varios componentes para reducir el tamaño de la descarga. Cada uno de los componentes es un archivo archivador de cintas (tar) y todos ellos son necesarios.
Para instalar las imágenes electrónicas de WebSphere Application Server - Express, siga estos pasos:
Después de instalar WebSphere Application Server - Express, debe tener la siguiente estructura de directorios bajo el directorio /opt/IBM/WebSphere/Express51:
En caso de que el número de archivos de alguno de estos directorios sea considerablemente distinto, puede sospechar que se produjo un problema durante la instalación. Consulte el archivo /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt.
Si desea incluir WebSphere Application Server - Express en otro producto, puede ejecutar el programa de instalación de WebSphere Application Server - Express de manera silenciosa. Para instalar WebSphere Application Server - Express de manera silenciosa, utilice la opción de línea de mandatos -silent. Durante una instalación silenciosa no verá paneles del asistente después de efectuar el mandato de instalación.
Para ejecutar la instalación de manera silenciosa con los valores por omisión, utilice un mandato como:
./solaris/setupSolaris -silent
También puede utilizar un archivo de respuesta para establecer opciones adicionales para la instalación silenciosa. Consulte el archivo de respuesta de ejemplo que se incluye en el CD de instalación para ver la plantilla. Para ejecutar una instalación silenciosa utilizando un archivo de respuesta, utilice un mandato como:
./solaris/setupSolaris -silent -options <vía totalmente calificada>/responsefile
Para desinstalar WebSphere Application Server - Express en Solaris, siga estos pasos:
./uninstaller
Esta sección describe problemas y limitaciones conocidos de la instalación y desinstalación de WebSphere Application Server - Express para Solaris. En el archivo readme hallará información sobre las limitaciones y los problemas que afectan al uso real del producto.
Si la instalación falla:
De vez en cuando, un error de instalación puede dar como resultado que los archivos de desinstalación en el directorio _uninst no estén completos. El síntoma de este problema consiste en un mensaje según el cual no se encuentra un JVM adecuado al tratar de ejecutar el programa de desinstalación. Debe ejecutar la desinstalación de la manera siguiente:
Esta sección contiene información acerca de la instalación de WebSphere Application Server - Express en HP-UX. Solo el componente Application Server (servidor de aplicaciones) de WebSphere Application Server - Express puede instalarse en HP-UX. Puede utilizar la consola administrativa basada en navegador para administrar el servidor de aplicaciones en HP-UX.
Puede instalar WebSphere Application Server - Express desde CD-ROM o desde las imágenes electrónicas que descargue.
Si tiene instalada en su sistema una copia anterior de WebSphere Application Server - Express, debería desinstalarla antes de continuar.
Para instalar WebSphere Application Server - Express desde el CD del producto, siga estos pasos:
Nota de instalación:
Si ejecuta el mandato '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary' desde un indicador de mandatos, pueden producirse errores del estilo 'no se ha encontrado mqver' y 'no se ha encontrado wempsservice'. Puede ignorar estos mensajes de error.
Antes de instalar el producto, compruebe lo siguiente:
La imagen del CD de HP/UX de WebSphere Application Server - Express se divide en varios componentes para reducir el tamaño de la descarga. Cada uno de los componentes es un archivo archivador de cintas (tar) y todos ellos son necesarios.
Para instalar las imágenes electrónicas de WebSphere Application Server - Express, siga estos pasos:
Después de instalar WebSphere Application Server - Express, debe tener la siguiente estructura de directorios bajo el directorio /opt/IBM/WebSphere/Express51:
En caso de que el número de archivos de alguno de estos directorios sea considerablemente distinto, puede sospechar que se produjo un problema durante la instalación. Consulte el archivo /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt.
Puede verificar el funcionamiento básico de la instalación del servidor de aplicaciones ejecutando Verificar instalación de servidor desde la aplicación Primeros Pasos. La aplicación Primeros Pasos se lanza al final del proceso de instalación, pero puede lanzarla ejecutando el script /opt/IBM/WebSphere/Express51/Express/bin/launchFirstSteps.sh.
Otra manera de verificar el funcionamiento del servidor de aplicaciones consiste en ejecutar el script /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh. Este script sirve de guía para iniciar y detener el servidor de aplicaciones utilizando la configuración por omisión. Tenga en cuenta que este script solo se utiliza para comprobar la instalación del servidor.
Si desea incluir WebSphere Application Server - Express en otro producto, puede ejecutar el programa de instalación de WebSphere Application Server - Express de manera silenciosa. Para instalar WebSphere Application Server - Express de manera silenciosa, utilice la opción de línea de mandatos -silent. Durante una instalación silenciosa no verá paneles del asistente después de efectuar el mandato de instalación.
Para ejecutar la instalación de manera silenciosa con los valores por omisión, utilice un mandato como:
./hpux/setupHPUX -silent
También puede utilizar un archivo de respuesta para establecer opciones adicionales para la instalación silenciosa. Consulte el archivo de respuesta de ejemplo que se incluye en el CD de instalación para ver la plantilla. Para ejecutar una instalación silenciosa utilizando un archivo de respuesta, utilice un mandato como:
./hpux/setupHPUX -silent -options <vía totalmente calificada>/responsefile
Para desinstalar WebSphere Application Server - Express en HP-UX, siga estos pasos:
./uninstaller
Esta sección describe problemas y limitaciones conocidos de la instalación y desinstalación de WebSphere Application Server - Express para HP-UX. En el archivo readme hallará información sobre las limitaciones y los problemas que afectan al uso real del producto.
Si la instalación falla:
De vez en cuando, un error de instalación puede dar como resultado que los archivos de desinstalación en el directorio _uninst no estén completos. El síntoma de este problema consiste en un mensaje según el cual no se encuentra un JVM adecuado al tratar de ejecutar el programa de desinstalación. Debe ejecutar la desinstalación de la manera siguiente:
Bienvenido a la característica de conectores del servidor Web para WebSphere Application Server - Express.
El conector del servidor Web permite a los usuarios separar la máquina del servidor Web y la máquina del servidor Express Application para mejorar la seguridad y el rendimiento. Esta separación también permite ser más flexible en la arquitectura del sitio Web en general.
Estos conectores se comunican con WebSphere Application Server - Express a través de HTTP(S).
La instalación de conectores de servidor Web incluye todos los componentes necesarios para configurar automáticamente los servidores Web siguientes en plataformas para las que están soportados.
| Servidor Web Apache |
|
| Servidor Web IBM HTTP |
|
| Microsoft Internet Information System (IIS) |
|
| Servidor Web iPlanet (Sun ONE) |
|
| Servidor Web Lotus Domino |
|
| WebSphere Application Server - Express |
Nota nº1
|
Notas:
| Servidor Web Apache |
|
| Servidor Web IBM HTTP |
|
| Microsoft Internet Information System (IIS) |
|
| Servidor Web iPlanet (Sun ONE) |
|
| Servidor Web Lotus Domino |
|
| WebSphere Application Server - Express |
Ver la nota nº 1 más abajo
|
Notas:
Aquí es donde se instalarán los archivos y las bibliotecas del conector del servidor Web. Si WebSphere Application Server - Express está instalado en el sistema, la ubicación por omisión es <DirectorioInstalaciónExpress>/Plugins.
Nota: el directorio de instalación es la ubicación en la que están instalados los archivos de licencia, los archivos del producto, la JVM y el programa de desinstalación. Los archivos de conectores de servidor Web que se necesitan en tiempo de ejecución están instalados en <DirectorioInstalación>/../AppServer.
Estructura de directorios de ejemplo:
C:\
- Archivos de programa
-IBM
-WebSphere
- Plugins
- AppServer
En un entorno de un solo nivel, en el que el servidor Web está instalado en el misma máquina que el servidor de aplicaciones Express, los conectores del servidor Web se encuentran en el directorio de WebSphere Application Server - Express: <DirectorioInstalaciónExpress>/AppServer. Ello proporcionará una integración sin fisuras del conector del servidor Web con el servidor de aplicaciones Express. Esto implica que el directorio por omisión del archivo plugin-cfg.xml regenerado esté en la misma ubicación que vaya a utilizar el servidor Web según la configuración. Por tanto, no es necesario copiar manualmente ni mover de otra manera el archivo plugin-cfg.xml una vez regenerado.
Este es el nombre de sistema principal de la máquina que está ejecutando WebSphere Application Server - Express. Esta información se recoge para insertar valores adecuados en el archivo de configuración de conectores (plugin-cfg.xml). El valor por omisión es el nombre del sistema principal local. Si WebSphere Application Server - Express se está ejecutando en otra máquina, especifique el nombre de sistema principal de ese servidor remoto.
Para cada conector de servidor Web que desee instalar, se le solicitará la ubicación del archivo de configuración. El archivo debe existir para poder continuar con la instalación.
Consulte el apartado 4.0 "Qué cambios se realizan en la configuración del servidor Web" para obtener información detallada.
Consulte el apartado 4.0 "Qué cambios se realizan en la configuración del servidor Web" para obtener información detallada.
Esta sección describe las modificaciones en los archivos de configuración del servidor Web durante la instalación como tareas que pueden llevarse a cabo manualmente. Estos pasos los lleva a cabo automáticamente el proceso de instalación y se listan aquí a efectos de consulta.
Las modificaciones incluyen la adición de una referencia a la biblioteca de conectores de servidor Web y de una referencia a la ubicación del archivo del configuración del conector del servidor Web (plugin-cfg.xml).
Pasos para la realización de estas tareas
Las siguientes entradas le servirán de modelo para configurar su archivo. NOTA: <raízInstalaciónConectores> es el directorio raíz de instalación de los conectores de WebSphere Application Server - Express.
LoadModule ibm_app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_ibm_app_server_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
Nota: el directorio raíz de instalación puede variar para cada plataforma de sistema operativo. Por ejemplo, el directorio raíz de instalación en AIX es /opt/IBM/WebSphere/Express51/Plugins/ para la Versión 5.
LoadModule ibm_app_server_http_module <raízInstalaciónConectores>\bin\mod_ibm_app_server_http.dll WebSpherePluginConfig <raízInstalaciónConectores>\config\cells\plugin-cfg.xml
Utilice las entradas siguientes como modelo para configurar el archivo.
LoadModule was_ap20_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_was_ap20_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/plugins/config/cells/plugin-cfg.xml
Nota: el directorio raíz de instalación puede variar para cada plataforma de sistema operativo. Por ejemplo, el directorio raíz de instalación en AIX es /opt/IBM/WebSphere/Express51/Plugins/ para la Versión 5.
LoadModule was_ap20_module <raízInstalaciónConectores>\bin\mod_was_ap20_http.dll WebSpherePluginConfig <raízInstalaciónConectores>\config\cells\plugin-cfg.xml
Nota: si la directiva IBM HTTP Server 1.3.26, LoadModule ibm_app_server_http_module, está presente en un archivo httpd.conf de IBM HTTP Server 2.0, IBM HTTP Server no puede iniciarse. Debe comentar o suprimir la directiva para iniciar el servidor Versión 2.
Utilice las entradas siguientes como modelo para configurar el archivo.
LoadModule app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_app_server_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
La mayoría de los servidores Web Apache no se compilan con el soporte de API ampliada (EAPI). Si ve un mensaje parecido al siguiente, al iniciar el servidor Web con el módulo de conector mod_app_server_http.so, utilice la versión EAPI del módulo.
[Tue Jul 2 13:20:14 2002] [warn] DSO cargado /opt/IBM/WebSphere/AppServer/bin/mod_app_server_http.so utiliza API Apache 1.3 ¡Este módulo puede sufrir una anomalía bajo EAPI! (recompílelo con -D EAPI, por favor)
Para utilizar el módulo EAPI, configure el archivo httpd.conf para que señale hacia mod_app_server_http_eapi.so en lugar de hacia mod_app_server_http.so:
LoadModule app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_app_server_http_eapi.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
Nota: el directorio raíz de instalación puede variar para cada plataforma de sistema operativo. Por ejemplo, el directorio raíz de instalación en AIX es /opt/IBM/WebSphere/Express51/Plugins/ para la Versión 5.
LoadModule app_server_http_module <raízInstalaciónConectores>\bin\mod_app_server_http.dll WebSpherePluginConfig <raízInstalaciónConectores>\config\cells\plugin-cfg.xml
La mayoría de los servidores Web Apache no se compilan con el soporte de API ampliada (EAPI). Si ve un mensaje parecido al siguiente, al iniciar el servidor Web con el módulo de conector mod_app_server_http.dll, utilice la versión EAPI del módulo.
[Tue Jul 2 13:20:14 2002] [warn] DSO cargado C:\WebSphere\AppServer\bin\mod_app_server_http.so utiliza API Apache 1.3 ¡Este módulo puede sufrir una anomalía bajo EAPI! (recompílelo con -D EAPI, por favor)
Para utilizar el módulo EAPI, configure el archivo httpd.conf para que señale hacia mod_app_server_http_eapi.dll en lugar de hacia mod_app_server_http.dll:
LoadModule app_server_http_module <raízInstalaciónConectores>\bin\mod_app_server_http_eapi.dll WebSpherePluginConfig <raízInstalaciónConectores>\config\cells\plugin-cfg.xml
Siga este procedimiento para habilitar el conector de transporte HTTP para que funcione con Domino Versión 5.05 ó 5.06. El asistente de instalación no realiza esta modificación. Lleve a cabo este procedimiento manual.
Nota: si ya se han especificado otros archivos de filtro de Domino Web Server Application Programming Interface (DSAPI), utilice un espacio para delimitar el archivo del conector de WebSphere Application Server.
Establezca la variable de entorno WAS_HOME para que señale hacia el directorio raíz de instalación de WebSphere Application Server.
Añada la variable Plugin Config al registro bajo la vía HKEY_LOCAL_MACHINE > SOFTWARE > IBM > WebSphere Application Server > 5.1.0.0. Establezca el valor de esta variable en la ubicación del archivo plugin-cfg.xml, que es <raízInstalaciónConectores>\config\cells\plugin-cfg.xml.
Aquí <raízInstalaciónConectores> es el directorio raíz de instalación de los conectores de WebSphere Application Server - Express.
02/12/2001 03:05:09 PM JVM: Máquina virtual Java inicializada Filtro DSAPI de WebSphere Application Server cargado 02/12/2001 03:05:10 PM HTTP Web Server iniciado
Utilice las entradas siguientes como modelo para configurar el archivo.
Incluya estas directivas en el archivo obj.conf:
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="/opt/IBM/WebSphere/Express51/Plugins/bin/libns41_http.so" Init fn="as_init" bootstrap.properties=" /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml" Service fn="as_handler"
Nota: el directorio raíz de instalación puede variar para cada plataforma de sistema operativo. Por ejemplo, el directorio raíz de instalación en AIX es /opt/IBM/WebSphere/Express51/Plugins/ para la Versión 5.
Añada una directiva al archivo obj.conf después de "<Object name=default>":
Service fn="as_handler"
Añada dos directivas al final del archivo magnus.conf:
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="/opt/IBM/WebSphere/Express51/Plugins/bin/libns41_http.so" Init fn="as_init" bootstrap.properties=" /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml"
Nota: el directorio raíz de instalación puede variar para cada plataforma de sistema operativo. Por ejemplo, el directorio raíz de instalación en AIX es /opt/IBM/WebSphere/Express51/Plugins/ para la Versión 5.
Incluya estas directivas en el archivo obj.conf:
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="<raízInstalaciónConectores>\bin\libns41_http.dll" Init fn="as_init" bootstrap.properties=" <raízInstalaciónConectores>\config\cells\plugin-cfg.xml" Service fn="as_handler"
Añada una directiva al archivo obj.conf después de "<Object name=default>":
Service fn="as_handler"
Añada dos directivas al final del archivo magnus.conf:
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="<raízInstalaciónConectores>\bin\libns41_http.dll" Init fn="as_init" bootstrap.properties=" <raízInstalaciónConectores>:\config\cells\plugin-cfg.xml"
Siga este procedimiento para reproducir manualmente la configuración del servidor Web Internet Service Manager (IIS) que realiza el asistente de instalación:
Aquí <raízInstalaciónConectores> es el directorio raíz de instalación de los conectores de WebSphere Application Server - Express.
La regeneración del archivo de configuración de conectores de servidor Web, plugin-cfg.xml, es necesaria después de desplegar aplicaciones en WebSphere Application Server - Express.
En WebSphere Application Server - Express Versión 5.1.0, utilice el script genPluginCfg para regenerar el archivo plugin-cfg.xml tomando como base la configuración actual de WebSphere Express Application Server.
Aquí <DirectorioInstalaciónExpress> es el directorio raíz de instalación de WebSphere Application Server - Express.
Aquí, <RaízInstalaciónConectores> es el directorio raíz de instalación de los conectores de WebSphere Application Server - Express.
Las situaciones siguientes necesitan una edición manual del archivo plugin-cfg.xml:
<?xml version="1.0" encoding="ISO-8859-1" ?> <Config> <Log LogLevel="Error" Name="C:\Archivos de programa\IBM\WebSphere\Express51\Plugins\logs\http_plugin.log" /> <VirtualHostGroup Name="default_host"> <VirtualHost Name="*:7080" /> <VirtualHost Name="*:80" /> <VirtualHost Name="*:7443" /> </VirtualHostGroup> <ServerCluster Name="server1_DefaultNode_Cluster"> <Server Name="DefaultNode_server1"> <Transport Hostname="myHostname.raleigh.ibm.com" Port="7080" Protocol="http" /> <Transport Hostname="myHostname.raleigh.ibm.com" Port="7443" Protocol="https"> <Property name="keyring" value=" C:\Archivos de programa\IBM\WebSphere\Express51\Plugins\etc\plugin-key.kdb" /> <Property name="stashfile" value=" C:\Archivos de programa\IBM\WebSphere\Express51\Plugins\etc\plugin-key.sth" /> </Transport> </Server> <PrimaryServers> <Server Name="DefaultNode_server1" /> </PrimaryServers> </ServerCluster> <UriGroup Name="default_host_server1_DefaultNode_Cluster_URIs"> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/UTC/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/CustomHomePageExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/YourCoExpressExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/CustomerServiceExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/DocumentMgmtExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/SurveyExample/*" /> </UriGroup> <Route ServerCluster="server1_DefaultNode_Cluster" UriGroup="default_host_server1_DefaultNode_Cluster_URIs" VirtualHostGroup="default_host" /> </Config>
Cuando el servidor Web está instalado en una maquina distinta de auqella en la que está instalado WebSphere Application Server - Express, el archivo plugin-cfg.xml generado se debe trasladar al directorio <RaízInstalaciónConectores>/config/cells situado en la máquina del servidor Web. Como resultado, las vías de acceso referidas en el archivo plugin-cfg.xml deberán editarse manualmente. Las utilizaciones subsiguientes del script genPluginCfg fusionarán las actualizaciones y preservarán las actualizaciones manuales de las entradas de vías de acceso.
Ejemplo: export SHLIB_PATH=/usr/lib:/lib
El CD-ROM del producto está en formato ISO-9660 con extensión Rockridge. Es posible que deba montar el CD-ROM manualmente. Para montar o desmontar el CD_ROM se necesita tener privilegios de root.
Siga estas instrucciones para montar el CD_ROM en HP-UX
/usr/sbin/pfs_mountd &
/usr/sbin/pfsd &
<archivo_dispositivo> <punto_montaje> <Tipo_sistema_archivos> <método_conversión>
Ejemplo: /dev/dsk/c0t0d0 /cdrom pfs-rrip ro,suid 0 0
/usr/sbin/pfs_mount /cdrom
/usr/sbin/pfs_umount /cdrom
Ejemplo: export WAS_HOME=/opt/IBM/WebSphere/Express51/Plugins
WebSphere Application Server - Express, Versión 5.1 incluye una aplicación preinstalada que se llama Snoop y permite verificar que el conector del servidor Web está debidamente instalado y configurado. El archivo de configuración de conectores de servidor Web, plugin-cfg.xml, que se instala durante el proceso de instalación de los conectores de servidor Web, está preconfigurado para probar la aplicación Snoop. Sin embargo, si lo desea, también puede regenerar el conector de servidor Web tal como se describe en esta documentación.
CONSEJO: no olvide reiniciar el servidor Web una vez regenerado el archivo de configuración de conectores.
Procedimiento para probar el conector de servidor Web
http://nombreSistemaPrincipal:7080
CONSEJO: si el servidor Web no se inicia, consulte la sección "Consejos para la resolución de problemas" de este documento, donde hallará información para resolver el problema.
NOTA: no especifique el transporte interno, 7080, de WebSphere Application Server - Express. El conector de servidor Web actuará como proxy del servidor utilizando el transporte interno 7080. En el siguiente URL se presupone que el servidor Web está a la escucha en el puerto HTTP por omisión, que es el 80.
http://nombreSistemaPrincipal
Si el conector de servidor Web está debidamente instalado y configurado, la página Web de la aplicación por omisión de WebSphere Application Server se visualizará en el navegador.
Intente esto en primer lugar: la razón más habitual de por qué no se inicia el servidor Web después de configurar el conector del servidor Web es que el archivo plugin-cfg.xml contiene información incorrecta o que no es válida y el servidor Web no lo puede analizar. Las situaciones más frecuentes que suelen provocar el problema son:
Si tiene problemas con el componente del conector HTTP, el componente que envía peticiones desde el servidor HTTP (como IBM HTTP Server, Apache o IIS) a Websphere Application Server - Express, siga estos pasos:
Si estos archivos no revelan la causa del problema, siga estos pasos adicionales.
Pasos para la determinación de problemas con los conectores
El conector proporciona un rastreo muy legible que puede ayudar a identificar el problema. Si establece el atributo LogLevel del archivo config/plugin-cfg.xml en Trace, puede seguir el proceso de la petición para ver qué es lo que no funciona. Para un nivel alto:
Esto puede verlo claramente leyendo el rastreo de una sola petición:
[Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: -----------------Información del sistema------------------ [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Fecha build: Jul 3 2002, 15:35:09 [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Servidor Web: IIS [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Nomb. sist. pral. = SWEETTJ05 [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: OS Versión 4.0, build 1381, 'Service Pack 6' [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: ---------------------------------------------------------------
ws_common: websphereGetStream: No se ha podido conectar con el servidor de aplicaciones, OS err=%d
Donde %d es un código de error específico de OS relacionado con la anomalía de la llamada connect(). Esto puede ocurrir por varias razones.
La regeneración del archivo plugin-cfg.xml puede realizarse a través de la consola administrativa basada en navegador o utilizando el script GenPluginCfg situado en <DirectorioInstalaciónExpress>/AppServer/bin.
Utilización: GenPluginCfg [[-nombre.opción valorOpción]...]
Opciones válidas:
-config.root configroot_dir
(el valor por omisión es la variable de entorno CONFIG_ROOT)
-cell.name cell
(el valor por omisión es la variable de entorno WAS_CELL)
-node.name node
(el valor por omisión es la variable de entorno WAS_NODE)
-server.name server
(necesaria para la generación de un solo conector de servidor)
-output.file.name file_name
(el valor por omisión es configroot_dir/plugin-cfg.xml)
-destination.root root
(se utilizará el directorio raíz de instalación de la configuración de la máquina)
-destination.operating.system windows/unix
(se utilizará el sistema operativo de la configuración de la máquina)
-debug yes/no
(el valor por omisión es no)
Ejemplos:
IBM HTTP Server
Artículos técnicos y código de ejemplo
Actualizaciones de la documentación
Para obtener la información más actualizada acerca de WebSphere Application Server - Express más allá de lo que está incluido en el sistema de ayuda en línea, consulte los sitios Web siguientes:
Esta sección describe como instalar la característica de conectores de seguridad de servidor Web para WebSphere Application Server - Express. La característica de conectores de seguridad de servidor Web debe instalarse desde el CD de conectores de servidor Web incluido con WebSphere Application Server - Express Versión 5.1.1.
Los conectores de seguridad de servidor Web permiten a los usuarios separar la máquina del servidor Web y la máquina del servidor de aplicaciones Express para mejorar la seguridad y el rendimiento. Esta separación también permite ser más flexible en la arquitectura del sitio Web en general.
Estos conectores de seguridad se comunican con WebSphere Application Server - Express sobre HTTP(S).
La instalación de los conectores de servidor Web incluye todos los componentes necesarios para configurar automáticamente los servidores Web siguientes en plataformas para las que están soportados.
El conector de seguridad de servidor Web debe estar instalado en la misma máquina que el servidor Web HTTP. Por lo tanto, asegúrese de que el servidor Web HTTP ya esté instalado antes de instalar el conector del servidor Web HTTP.
Consulte el archivo README ubicado en el CD de conectores de servidor Web para obtener información detallada acerca de los temas siguientes:
Para instalar los conectores de seguridad de servidor Web HTTP desde el CD, siga estos pasos:
Aquí es donde se instalarán los archivos y las bibliotecas de conectores de servidor Web. Si WebSphere Application Server - Express está instalado en el sistema, la ubicación por omisión es <DirectorioInstalaciónExpress>/Plugins.
Nota: el directorio de instalación es la ubicación en la que están instalados los archivos de licencia, los archivos del producto, la JVM y el programa de desinstalación. Los archivos de conectores de servidor Web que se necesitan en tiempo de ejecución están instalados en <DirectorioInstalación>/../AppServer.
Estructura de directorios de ejemplo:
C:\Archivos de programa\IBM\WebSphere\Plugins
C:\Archivos de programa\IBM\WebSphere\Appserver
En un entorno de un solo nivel, en el que el servidor Web está instalado en el misma máquina que el servidor de aplicaciones Express, los conectores del servidor Web se encuentran en el directorio de WebSphere Application Server - Express: <DirectorioInstalaciónExpress>/AppServer. Ello proporcionará una integración sin fisuras del conector del servidor Web con el servidor de aplicaciones Express. Esto implica que el directorio por omisión del archivo plugin-cfg.xml regenerado esté en la misma ubicación que vaya a utilizar el servidor Web según la configuración. Por tanto, no es necesario copiar manualmente ni mover de otra manera el archivo plugin-cfg.xml una vez regenerado.
Es el nombre de sistema principal de la máquina en la que se está ejecutando WebSphere Application Server - Express. Esta información se recoge para insertar valores adecuados en el archivo de configuración de conectores (plugin-cfg.xml). El valor por omisión es el nombre del sistema principal local. Si WebSphere Application Server - Express se está ejecutando en una máquina distinta, entre el nombre de sistema principal de ese servidor remoto.
Para cada conector de servidor Web seleccionado para instalar, se le solicitará la ubicación del archivo de configuración correspondiente. El archivo debe existir para continuar con la instalación.
Si desea incluir los conectores de WebSphere Application Server - Express en otro producto, puede ejecutar el programa de instalación de los conectores de WebSphere Application Server - Express de manera silenciosa. Para instalar los conectores de WebSphere Application Server - Express de manera silenciosa, utilice la opción de línea de mandatos -silent. Durante una instalación silenciosa no verá paneles del asistente después de efectuar el mandato de instalación.
Puede utilizar un archivo de respuesta para establecer las opciones adecuadas para una instalación silenciosa. Consulte el archivo de respuesta de ejemplo que se incluye en el CD de instalación para ver la plantilla. Para ejecutar una instalación silenciosa utilizando un archivo de respuesta, utilice un mandato como:
Para Windows:
install.exe -silent -options <vía totalmente calificada>/responsefile
Para Linux y Unix:
linux/setupLinux -silent -options <vía totalmente calificada>/responsefile
Ejemplos para las plataformas Unix:
WebSphere Application Server - Express, Versión 5.1 incluye una aplicación preinstalada que se llama Snoop y permite verificar que el conector del servidor Web está debidamente instalado y configurado. El archivo de configuración de conectores de servidor Web, plugin-cfg.xml, que se instala durante el proceso de instalación de los conectores de servidor Web, está preconfigurado para probar la aplicación Snoop. Sin embargo, si lo desea, también puede regenerar el conector de servidor Web tal como se describe en esta documentación.
CONSEJO: no olvide reiniciar el servidor Web una vez regenerado el archivo de configuración de conectores.
Procedimiento para probar el conector de servidor Web
http://nombreSistemaPrincipal:7080
CONSEJO: si el servidor Web no se inicia, consulte la sección "Consejos para la resolución de problemas" de este documento, donde hallará información para resolver el problema.
NOTA: no especifique el transporte interno, 7080, de WebSphere Application Server - Express. El conector de servidor Web actuará como proxy del servidor utilizando el transporte interno 7080. En el siguiente URL se presupone que el servidor Web está a la escucha en el puerto HTTP por omisión, que es el 80.
http://nombreSistemaPrincipal
Si el conector de servidor Web está debidamente instalado y configurado, la página Web de la aplicación por omisión de WebSphere Application Server se visualizará en el navegador.
Para desinstalar los conectores de seguridad de servidor Web HTTP de WebSphere Application Server - Express, siga estos pasos:
Para desinstalar los conectores de servidor Web HTTP para WebSphere Application Server - Express en las plataformas Linux y Unix, siga estos pasos:
./uninstaller
Por omisión, los conectores CVS (Sistema de versiones concurrentes) se instalan automáticamente con WebSphere Application Server - Express. La versión más reciente del servidor CVS está disponible en www.cvshome.org. Para usar CVS, no necesita instalar un cliente CVS, tan solo un servidor CVS. Hallará más información sobre cómo instalar y utilizar CVS en la ayuda en línea de equipo. Además, hay un artículo acerca del soporte del equipo CVS en WebSphere Application Server - Express en www.ibm.com/websphere/developer/library/ techarticles/0108_karasiuk/0108_karasiuk.html
Como alternativa a CVS, puede utilizar Rational(R) ClearCase(R) como sistema de gestión de configuración de software (SCM). Hallará más información sobre Rational ClearCase en www.ibm.com/software/awdtools/clearcase/
Ni el servidor CVS ni el cliente o el servidor Rational ClearCase se instalan automáticamente. Debe instalarlos independientemente de WebSphere Studio.
Existe la posibilidad de integrar otros depósitos SCM en WebSphere Application Server - Express mediante adaptadores de equipo SCM (conocidos en Eclipse como proveedores de equipo). Para encontrar una lista de productos y adaptadores de SCM proporcionados por Business Partners de IBM, vaya al sitio www-3.ibm.com/software/awdtools/studioappdev/about/ y en la sección Further reading seleccione SCM Adaptor Vendors. Desde esa lista puede acceder a los sitios Web de los distribuidores de productos SCM para bajar los adaptadores SCM que prefiera. IBM no es responsable ni garantiza el buen funcionamiento de estos adaptadores. Para obtener soporte o más información, póngase en contacto directamente con el proveedor del producto SCM.
Nota sobre los derechos restringidos de los usuarios del Gobierno de los EE.UU. - El uso, la duplicación o la divulgación están restringidos por el contrato GSA ADP Schedule Contract con IBM Corp.
Esta información se ha desarrollado para los productos y los servicios que se ofrecen en Estados Unidos. Es posible que IBM no ofrezca en otros países los productos, los servicios o las características que se describen en este documento. El representante local de IBM le puede informar acerca de los productos y servicios que actualmente están disponibles en su localidad. Las referencias hechas a productos, programas o servicios de IBM no pretenden afirmar ni dar a entender que únicamente puedan utilizarse dichos productos, programas o servicios de IBM. Puede utilizarse en su lugar cualquier otro producto, programa o servicio funcionalmente equivalente que no vulnere ninguno de los derechos de propiedad intelectual de IBM. No obstante, es responsabilidad del usuario evaluar y verificar el funcionamiento de cualquier producto, programa o servicio que no sea de IBM.
IBM puede tener patentes o solicitudes de patente pendientes de aprobación que cubran alguno de los temas tratados en este documento. La posesión de este documento no le confiere ninguna licencia sobre dichas patentes. Puede enviar consultas sobre licencias por escrito a:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
Estados Unidos de América
Para consultas sobre licencias relativas a la información de doble byte (DBCS), póngase en contacto con el departamento de propiedad intelectual de IBM en su país o envíe las consultas, por escrito, a:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japón
IBM puede utilizar o distribuir la información que usted le suministre del modo que IBM considere conveniente sin incurrir por ello en ninguna obligación para con usted.
El párrafo que sigue no se aplica al Reino Unido ni a ningún otro país en el que tales disposiciones sean incompatibles con la legislación local: INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIÓN "TAL CUAL", SIN GARANTÍA DE NINGUNA CLASE, YA SEAN EXPLÍCITA O IMPLÍCITA, INCLUIDAS, PERO SIN LIMITARSE A ELLAS, LAS GARANTÍAS O CONDICIONES IMPLÍCITAS DE NO VULNERACIÓN, DE COMERCIALIZACIÓN O IDONEIDAD PARA UN PROPÓSITO DETERMINADO. Algunas legislaciones no contemplan la declaración de limitación de responsabilidad, ni implícitas ni explícitas, en determinadas transacciones, por lo que cabe la posibilidad de que esta declaración no se aplique en su caso.
Esta información puede contener imprecisiones técnicas o errores tipográficos. La información incluida en este documento está sujeta a cambios periódicos; estos cambios se incorporarán en nuevas ediciones de la publicación. IBM puede efectuar mejoras y/o cambios en los productos y/o programas descritos en esta publicación en cualquier momento y sin previo aviso.
Los licenciatarios de este programa que deseen obtener información acerca de él con el fin de: (i) intercambiar la información entre los programas creados independientemente y otros programas (incluido este) y (ii) utilizar mutuamente la información que se ha intercambiado, deben ponerse en contacto con:
Lab Director
IBM Canada Ltd. Laboratory
8200 Warden Avenue
Markham, Ontario, Canadá L6G 1C7
Dicha información puede estar disponible, sujeta a los términos y condiciones apropiados, incluyendo en algunos casos el pago de una cantidad.
IBM proporciona el programa bajo licencia descrito en este documento, así como todo el material bajo licencia disponible, según los términos del Acuerdo de Cliente de IBM, del Acuerdo Internacional de Programas bajo Licencia de IBM o de cualquier otro acuerdo equivalente entre ambas partes.
La información concerniente a productos no IBM se ha obtenido de los suministradores de dichos productos, de sus anuncios publicados o de otras fuentes de información pública disponibles. IBM no ha comprobado dichos productos y no puede afirmar la exactitud en cuanto a rendimiento, compatibilidad u otras características relativas a productos no IBM. Las consultas acerca de las posibilidades de los productos que no son de IBM deben dirigirse a las personas que los suministran.
Cualquier referencia hecha en esta información a sitios Web no de IBM se proporciona únicamente para su comodidad y no debe considerarse en modo alguno como promoción de dichos sitios Web. Los materiales de estos sitios Web no forman parte de los materiales de IBM para este producto, y el usuario será responsable del uso que se haga de estos sitios Web.
Esta información contiene ejemplos de datos e informes utilizados en operaciones comerciales diarias. Para ilustrarlos de la forma más completa posible, los ejemplos pueden incluir nombres de personas, empresas, marcas y productos. Todos estos nombres son ficticios y cualquier parecido con los nombres y direcciones utilizados por una empresa real es mera coincidencia.
LICENCIA DE COPYRIGHT:
Esta información contiene programas de aplicación de ejemplo en lenguaje fuente, que ilustra las técnicas de programación en diversas plataformas operativas. Puede copiar, modificar y distribuir los programas de ejemplo de cualquier forma, sin tener que pagar a IBM, con intención de desarrollar, utilizar, comercializar o distribuir programas de aplicación que estén en conformidad con la interfaz de programación de aplicaciones (API) de la plataforma operativa para la que están escritos los programas de ejemplo. Los ejemplos no se han probado minuciosamente bajo todas las condiciones. Por lo tanto, IBM no puede garantizar ni dar por sentada la fiabilidad, la facilidad de mantenimiento ni el funcionamiento de los programas. Usted puede copiar, modificar y distribuir los programas de ejemplo de cualquier forma, sin tener que pagar a IBM, con el fin de desarrollar, utilizar, comercializar o distribuir programas de aplicación que estén en conformidad con las interfaces de programación de aplicaciones (API) de IBM.
Cada copia o cada parte de los programas de ejemplo o de los trabajos que se deriven de ellos debe incluir un aviso de copyright como se indica a continuación:
(C) (nombre de la empresa) (año). Algunas partes de este código se derivan de programas de ejemplo de IBM Corp. (C) Copyright IBM Corp. 2000, 2003. Reservados todos los derechos.
La información de las interfaces de programación está destinada a ayudarle a crear software de aplicaciones mediante este programa.
Las interfaces de programación de uso general le permiten escribir software de aplicaciones que obtengan los servicios de las herramientas de este programa.
Sin embargo, aquí también puede haber información de diagnóstico, modificación y ajuste. La información de diagnóstico, modificación y ajuste que se proporciona está destinada a ayudarle a depurar el software de las aplicaciones.
Aviso: no utilice la información de diagnóstico, modificación y ajuste como interfaz de programación porque está sujeta a cambios.
Los siguientes términos son marcas registradas de International Business Machines Corporation en Estados Unidos y/o en otros países:
Java y todas las marcas y logotipos basados en Java son marcas registradas de Sun Microsystems, Inc., en Estados Unidos y en otros países.
ActiveX, Microsoft, Windows, Windows NT y el logotipo de Windows son marcas o marcas registradas de Microsoft Corporation en Estados Unidos y/o en otros países.
UNIX es una marca registrada de The Open Group.
Los nombres de otras empresas, productos y servicios que se hayan señalado con dos asteriscos (**) pueden ser marcas registradas o marcas de servicio de terceros.