Instalar un módulo de mediación consiste en mover el archivo EAR instalable
para el módulo de mediación al servidor o clúster que alojará el módulo de mediación.
Se considera que un módulo de mediación instalado que se inicia y ejecuta correctamente es
un módulo desplegado.
Antes de empezar
Si ha exportado su módulo de mediación a un archivo JAR, utilice el mandato
serviceDeploy para crear un archivo EAR instalable a partir del archivo JAR del módulo de
mediación. Para obtener información sobre cómo crear un archivo EAR instalable para un módulo
de mediación, consulte
Despliegue de un módulo de mediación.
Por qué y cuándo se efectúa esta tarea
Para habilitar
WebSphere ESB de
modo que utilice las funciones proporcionadas por un módulo de mediación para integrar
aplicaciones y servicios, debe instalar el archivo EAR del módulo en un servidor o
clúster y luego iniciar el módulo desplegado.
En este tema se describe cómo utilizar la consola administrativa para instalar un
archivo EAR de módulo de mediación. Si lo desea, también puede utilizar otros métodos,
como el mandato install o installinteractive con la herramienta wsadmin, del mismo modo
que instala archivos de aplicación de empresa en
WebSphere Application Server.
Importante: una vez que haya empezado a ejecutar los pasos siguientes, pulse
Cancelar para salir si decide no instalar la aplicación. No pase a otra página de
la consola administrativa sin primero pulsar Cancelar en una página de instalación
de la aplicación.
Para utilizar la consola administrativa para instalar un archivo EAR de módulo
de mediación, siga estos pasos:
Pasos para realizar esta tarea
- Pulse en el árbol de navegación de la consola. Se muestra la primera de las dos páginas de Preparación para la instalación de la aplicación.
- En la primera página de Preparación para la instalación de la aplicación, siga los pasos secundarios que se indican a continuación:
- Especifique el nombre completo de la vía de acceso del archivo EAR del
módulo de mediación (archivo .ear). El archivo EAR que instale puede
encontrarse en la máquina cliente (la máquina que ejecuta el navegador web de la consola
administrativa) o en la máquina servidor (la máquina a la que está conectado el cliente).
Si especifica un archivo EAR de la máquina cliente, la consola administrativa carga el
archivo EAR en la máquina en la que se ejecuta la consola y procede con la instalación de
la aplicación.
- Pulse Siguiente.
- En la segunda página Preparación para la instalación de la aplicación, siga los pasos secundarios que
se indican a continuación:
- Indique si desea generar enlaces predeterminados.
El uso de
enlaces predeterminados da lugar a que
los enlaces incompletos de la aplicación se cumplimenten con valores predeterminados.
Los enlaces existentes no se modifican.
Los valores predeterminados utilizados al
generar enlaces predeterminados pueden personalizarse.
- Pulse Siguiente. Si aparecen
avisos de seguridad, pulse Continuar. Se muestran las páginas Instalar una nueva aplicación. Si opta por generar enlaces predeterminados
y la aplicación no utiliza ningún adaptador de recursos, puede proceder hasta el paso
de resumen (el último de los pasos que se indican a continuación).
- En el panel Paso: Seleccionar las opciones de instalación, especifique los valores para los valores siguientes. Para obtener más información sobre los valores
de esta página, consulte el apartado sobre la selección de valores de las opciones de instalación. Si no especifica ningún valor, se utilizan los valores predeterminados.
- Para Directorio de instalación de la aplicación, especifique
el directorio en el que se instalará el archivo EAR de la aplicación. El valor predeterminado es el valor de RAÍZ_INSTAL_APLIC/nombre_celda,
siendo la variable RAÍZ_INSTAL_APLIC raíz_instalación/installedApps.
Por ejemplo, para el producto WebSphere ESB instalado en Windows en el directorio C:\Archivos de programa\WESB\,
la ubicación predeterminada es C:\Archivos de programa\WESB\nombre_perfil\installedApps\nombre_celda.
Nota: si no se especifica ningún directorio al instalar la
aplicación en un perfil autónomo, la aplicación se instala en
RAÍZ_INSTAL_APLIC/nombre_celda_base.
Si añade el servidor autónomo a una celda de gestor de despliegue, el nombre de la celda
de la configuración del servidor nuevo pasa a ser el nombre de la celda del nodo del
gestor de despliegue. Si utiliza la opción -includeapps para el programa de utilidad addNode,
las aplicaciones que se hayan instalado antes de ejecutar la operación addNode seguirán utilizando
el directorio de instalación RAÍZ_INSTAL_APLIC/nombre_celda_base.
No obstante, una aplicación que se instale tras añadir el servidor autónomo
a la configuración de la red utiliza el directorio de instalación predeterminado RAÍZ_INSTAL_APLIC/nombre_celda_red. Para mover la aplicación a la ubicación
RAÍZ_INSTAL_APLIC/nombre_celda_red tras
ejecutar la operación addNode, debe especificar explícitamente el directorio de
instalación como ${RAÍZ_INSTAL_APLIC}/${CELL} durante la instalación. En este caso, los archivos
de la aplicación siempre pueden encontrarse en el directorio RAÍZ_INSTAL_APLIC/nombre_celda_actual.
- Para Distribuir la aplicación, especifique si WebSphere ESB expande o
suprime los archivos binarios de la aplicación en el destino de la instalación. De forma predeterminada,
se permite la distribución de la aplicación. Como consecuencia de ello, al guardar los
cambios en la consola, los archivos binarios de la aplicación para las aplicaciones
recientemente instaladas se expanden en el directorio especificado. Los archivos binarios
también se suprimen al desinstalar y guardar los cambios realizados en la configuración.
Si inhabilita esta opción, debe garantizar que los archivos binarios de la aplicación se
expandan de forma adecuada en los directorios de destino de todos los nodos en los que se
prevé ejecutar la aplicación.
Importante: si inhabilita esta opción y no copia
y expande los archivos binarios de la aplicación en los nodos, al ejecutar una operación
para guardar la configuración o realizar
una sincronización manual los archivos binarios de la aplicación no se moverán
automáticamente.
- Para Utilizar configuración binaria, especifique si el
servidor o el clúster utiliza los descriptores de enlace, extensiones y despliegue
que se encuentran en el documento de despliegue de la aplicación, archivo
deployment.xml (opción predeterminada), o los que se encuentran en el
archivo EAR.
- En Nombre de aplicación, especifique un nombre para la aplicación. Los nombres de aplicación deben ser exclusivos dentro de una celda y no pueden
contener caracteres no admitidos para los nombres de objeto. Si desea obtener una lista
de los caracteres que no pueden utilizarse en los nombres de objeto, consulte
Nombres de objeto.
- En Crear MBeans para los recursos, especifique si deben crearse
MBeans para distintos recursos (como servlets o archivos JSP) en una aplicación al
iniciar la aplicación. De forma predeterminada se crean instancias de MBean.
- En Habilitar recarga de clases, especifique si debe habilitarse la
recarga de clases al actualizar los archivos de aplicación. De forma predeterminada,
la recarga de clases no está habilitada. Si se habilita la recarga de
clases, el valor de reloadEnabled se establece en true en el archivo
deployment.xml del módulo de mediación. Si una definición de clase del módulo de
mediación cambia, el entorno de ejecución del servidor detiene e inicia la aplicación para cargar de
nuevo las clases de aplicación.
- En Intervalo de recarga en segundos, especifique el número de segundos
para explorar el sistema de archivos de la aplicación para detectar los archivos que se
hayan actualizado. El valor predeterminado es el valor del atributo del intervalo de
recarga del archivo de extensiones de IBM (META-INF/ibm-application-ext.xmi)
del archivo EAR. Para habilitar la recarga, especifique un valor mayor que
cero (por ejemplo, de 1 a 2147483647). Para inhabilitar la recarga, especifique cero
(0).
El intervalo de recarga especificado aquí sólo es efectivo si se ha habilitado la recarga
de clases.
- En Desplegar servicios web, especifique si la herramienta de
despliegue de servicios web wsdeploy se ejecuta durante la instalación de la aplicación. La herramienta genera el código necesario para ejecutar aplicaciones utilizando
servicios web. De forma predeterminada, la herramienta wsdeploy no se ejecuta.
Este valor debe habilitarse si el archivo EAR contiene módulos que utilizan servicios web y anteriormente no se ha ejecutado la herramienta wsdeploy en dicho archivo,
ya sea desde la opción de menú Desplegar de una herramienta de ensamblaje o desde
la línea de mandatos.
- En Validar entrada desactivada/aviso/error, especifique si
WebSphere ESB
examina las referencias de la aplicación especificadas durante la instalación o
actualización de la aplicación; si se ha habilitado la validación, le advierte si hay
referencias incorrectas o genera un error en la operación. Generalmente, una aplicación hace referencia a recursos utilizando orígenes
de datos para los beans CMP (Container Managed Persistence) o utilizando referencias de
recursos o de entornos de recursos definidas en los descriptores de despliegue. En la
validación se comprueba si el recurso al que hace referencia la aplicación está definido
en el ámbito del destino de despliegue de dicha aplicación. Seleccione desactivada si no desea realizar la validación de recursos,
aviso si desea recibir mensajes de aviso sobre las referencias a recursos
incorrectas, o error para detener las operaciones que dan error como
consecuencia de referencias a recursos incorrectas.
- En Procesar configuración incorporada, especifique si debe procesarse
la configuración incorporada. Una configuración incorporada está formada por
archivos tales como resource.xml y variables.xml. Si se selecciona o si
su valor es true, la configuración incorporada se carga en el ámbito de la
aplicación desde el archivo .ear. Si el archivo .ear no contiene
ninguna configuración incorporada, el valor predeterminado es false. Si el
archivo .ear contiene una configuración incorporada, el valor predeterminado es
true.
- En el panel Paso: Correlacionar módulos con servidores, seleccione
un servidor o clúster de destino de la lista Clústeres y servidores
para cada uno de los módulos. Active el recuadro de selección que se
encuentra junto a Módulo para seleccionar el módulo de mediación.
Si la aplicación utiliza un adaptador WebSphere, especifique los servidores o
clústeres de destino para cada archivo RAR. Correlacione también todos los demás módulos que utilizan
los adaptadores de recursos definidos en los módulos RAR con los mismos destinos.
Nota: Al instalar un archivo RAR en un servidor,
WebSphere ESB busca
el manifiesto (MANIFEST.MF) para el módulo de conector. Primero busca en el archivo
connectorModule.jar para determinar si existe un archivo RAR y carga el manifiesto del
archivo _connectorModule.jar. Si la entrada de la vía de acceso a clases se encuentra en el manifiesto del
archivo connectorModule.jar, el archivo RAR utiliza dicha vía de acceso a clases. Para
garantizar que el módulo de conector instalado encuentre las clases y los recursos que
necesita, compruebe el valor de la vía de acceso a clases para el archivo RAR
utilizando la consola. Si desea obtener más información sobre el valor de la vía de acceso a clases, consulte los valores del adaptador de recursos y los valores del adaptador
de recursos relacionales de WebSphere para la consola administrativa.
Es posible
especificar servidores web como destinos que dirijan las solicitudes a la aplicación. El archivo de configuración
de conectores plugin-cfg.xml para cada servidor web se genera en función de las aplicaciones
que se redirigen a través del mismo. Si desea que un servidor web preste servicio a la
aplicación, utilice la tecla Ctrl para seleccionar conjuntamente un servidor o
clúster de aplicaciones y el servidor web de modo que el archivo de configuración de
conector plugin-cfg.xml para dicho servidor web se genere en función de las
aplicaciones que se redirigen a través del mismo.
- Si la aplicación define referencias a recursos, en Paso: Correlacionar referencias de recursos con los recursos, especifique nombres JNDI para los recursos
que representan los nombres lógicos definidos en las referencias a recursos. Cada referencia de recurso definida en la aplicación debe estar vinculada a un
recurso definido en la configuración de
WebSphere ESB
antes de pulsar Finalizar en el panel de resumen.
- Opcional: Especifique el nombre de configuración de inicio de
sesión y las propiedades de autenticación para el recurso.
- Pulse Aceptar para guardar los valores y regresar al
paso de correlación.
- Si la aplicación utiliza módulos Web, en Paso: Correlacionar sistemas principales virtuales para módulos Web, seleccione un sistema principal virtual de la lista que deba correlacionarse con un
módulo web definido en la aplicación.
El número de puerto especificado en
la definición del sistema principal virtual se utiliza en el URL que se utiliza para acceder a
artefactos tales como servlets y archivos JSP del módulo Web. Cada módulo web debe tener un sistema principal virtual al que correlacionarse. Si no se especifican todos los sistemas principales
virtuales necesarios, se mostrará un error de validación tras pulsar Finalizar en
el panel de resumen.
- Si la aplicación tiene roles de seguridad definidos en su descriptor de
despliegue, en Paso: Correlacionar roles de seguridad con usuarios y grupos, especifique los usuarios y grupos que están correlacionados a cada uno de los roles de seguridad.
Seleccione Rol para seleccionar todos los roles o seleccione roles
individuales. Para cada rol, debe seleccionar una de las opciones siguientes a fin de
indicar cómo debe aplicarse la seguridad:
Opción |
Descripción |
Todos |
Equivale a no tener seguridad. |
Todos autenticados |
Todos los usuarios que se autentiquen
con un nombre de usuario y una contraseña válidos son miembros del rol. |
Usuarios correlacionados |
Los usuarios individuales se indican
como miembros del rol. |
Grupos correlacionados |
Los grupos constituyen el mejor
método para agregar usuarios; todos los miembros de los grupos identificados pasan a ser
miembros del rol. |
En Usuarios correlacionados o Grupos correlacionados, para seleccionar usuarios o grupos específicos del registro de
usuarios, siga estos pasos secundarios:
- Seleccione un rol y pulse Buscar usuarios o Buscar grupos.
- En el panel Buscar usuarios y grupos que se muestra, especifique los
criterios de búsqueda para extraer una lista de los usuarios o grupos del registro de
usuarios.
- Seleccione usuarios individuales o grupos en los resultados que se muestran.
- Pulse Aceptar para correlacionar los usuarios o grupos seleccionados
con el rol seleccionado en el panel Paso: Correlacionar roles de seguridad con usuarios y grupos.
- Si la aplicación tiene roles de tipo Ejecutar como (RunAs) definidos en el descriptor de
despliegue, en Paso: Correlacionar roles RunAs como usuarios, especifique el nombre de usuario RunAs y la contraseña para cada rol RunAs. Los enterprise beans utilizan
los roles RunAs cuando deben ejecutarse como un rol determinado al interactuar con otro
enterprise bean.
Seleccione Rol para seleccionar todos los roles o seleccione roles
individuales. Una vez que haya seleccionado el rol, especifique un valor para el campo de
nombre de usuario, contraseña y verificación de la contraseña y pulse Aplicar.
- Si la aplicación contiene referencias a un entorno de recursos, en Paso: Correlacionar referencias de entradas de entorno de recursos con los recursos, especifique los nombres JNDI de los
recursos que se correlacionan con los nombres lógicos definidos en las referencias al
entorno de recursos. Si hay alguna referencia al entorno de recursos que no tenga ningún recurso
asociado, tras pulsar Finalizar se muestra un error de validación.
- Si la aplicación define Identidad RunAs como Identidad del sistema, en Paso: Sustituir sistema RunAs por roles RunAs, si lo desea puede
cambiarlo por Rol RunAs y especificar un nombre de usuario y una contraseña
para el rol RunAs especificado. Seleccionar Identidad del sistema implica que la invocación se realiza
utilizando el ID de servidor de seguridad WebSphere Application Server; esta opción debe
utilizarse con precaución, ya que este ID tiene más privilegios.
- Si la aplicación tiene referencias a recursos que se correlacionan con
recursos que tienen una base de datos Oracle que realiza el proceso de fondo, en
Paso: Especifique el nivel de aislamiento para los proveedores de tipo Oracle., especifique o
corrija el nivel de aislamiento que debe utilizarse para dichos recursos cuando la
aplicación los utiliza. Las bases de datos Oracle dan soporte únicamente a
los niveles de aislamiento ReadCommitted y Serializable.
- En el panel de resumen, verifique la celda, el nodo y el servidor en los que
se instalarán los módulos de aplicación:
- Junto a Célula/Nodo/Servidor, pulse Pulse aquí.
- Verifique los valores.
- Pulse Finalizar.
Resultado
Se muestran varios mensajes en los que se indica si el archivo de la aplicación
se ha instalado correctamente.
Si recibe una excepción OutOfMemory y el archivo de la
aplicación de origen no se instala, es posible que el sistema no tenga memoria suficiente
o que la aplicación tenga demasiados módulos para poder instalarse correctamente en el
servidor. Si la causa de la excepción no reside en la falta de memoria del sistema,
empaquete de nuevo la aplicación de modo que el archivo .ear tenga menos
módulos. Si la causa de la excepción no reside en la falta de memoria del sistema ni en el
número de módulos, compruebe las opciones especificadas en la
página JVM (máquina virtual Java) del servidor de aplicaciones que ejecuta la consola
administrativa. A continuación, intente instalar de nuevo el archivo de la aplicación.
Durante la instalación se extraen determinados archivos de
aplicación del directorio representado por la sesión de configuración y, al guardar la
configuración, dichos archivos se guardan en el repositorio de configuración de WebSphere
Application Server. En las máquinas Windows, existe un límite de
256 caracteres para las vías de acceso a archivos. Por consiguiente, es posible que la
aplicación no pueda instalarse si la vía de acceso de los archivos de la aplicación en la
sesión de configuración o en el repositorio de configuración excede dicho límite.
Es posible que vea excepciones de tipo FileNotFound que indican informaciones del tipo nombre de vía de acceso demasiado larga en el mensaje. A fin de evitar problemas de este tipo, defina nombres de
URI cortos para la aplicación y los módulos, lo que le ayudará a reducir la longitud de
la vía de acceso de los archivos. A continuación, intente instalar de nuevo el archivo de la aplicación.
Qué hacer a continuación
Una vez que haya instalado correctamente el archivo de la aplicación, complete
las acciones que se indican a continuación:
- Asocie las bibliotecas compartidas
necesarias para la aplicación a la aplicación.
- Guarde los cambios realizados en la configuración. La aplicación se registra con la
configuración administrativa y los archivos de aplicación se copian en el directorio de
destino, que es el directorio predeterminado
raíz_instalación/installedApps/nombre_celda
o el directorio que se designe. Si la instalación se
realiza en un perfil de despliegue en red, los archivos se copian en nodos remotos cuando
la configuración del gestor de despliegue se sincroniza con la configuración de los nodos
individuales.
- Si el módulo se despliega en un clúster de servidor, pulse Desplegar actualización en la página Aplicaciones de empresa para propagar la configuración
cambiada en todos los miembros del clúster. La función Desplegar actualización actualiza
secuencialmente la configuración en los nodos que contienen miembros de clúster.
Para permitir que
WebSphere ESB
utilice funciones proporcionadas por un módulo de mediación para integrar aplicaciones y
servicios, el módulo desplegado debe estar iniciado. El módulo puede iniciarse
manualmente o se puede configurar para que el inicio sea automático. También puede
administrar el módulo de otros modos; por ejemplo, para cambiar la configuración del módulo,
detener o actualizar el módulo, y también gestionar la actividad del mismo.