La instalación de un módulo de mediación consiste en mover el archivo
EAR instalable, para el módulo de mediación, a un servidor o clúster que
alojará el módulo de mediación.
Los módulos de mediación instalados que se inician y se ejecutan correctamente
se consideran desplegados.
Antes de empezar
Si ha exportado el módulo de mediación a un archivo JAR, utilice el
mandato serviceDeploy para crear un archivo EAR instalable a partir del archivo
JAR de módulo de mediación.
Para obtener más información sobre cómo crear un archivo EAR instalable para un
módulo de mediación, consulte
Instalación de un módulo en un servidor de producción.
Por qué y cuándo realizar esta tarea
Para habilitar
WebSphere ESB
de tal manera que utilice las funciones proporcionadas por un módulo de
mediación para integrar aplicaciones y servicios, tiene que instalar el archivo
EAR para el módulo en un servidor o clúster y, a continuación, iniciar el
módulo desplegado.
Este tema describe cómo utilizar la consola administrativa para instalar
un archivo EAR de módulo de mediación.
Como alternativa, también puede utilizar otros métodos, como el mandato install
o installinteractive con la herramienta wsadmin, de la misma manera que al
instalar archivos de aplicación de empresa en WebSphere Application Server.
Importante: Después de empezar a realizar los pasos
siguientes, si decide no instalar la aplicación, pulse Cancelar para
salir.
No se limite a ir a otra página de la consola administrativa sin pulsar antes
Cancelar en una página de instalación de aplicación.
Para utilizar una 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 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 estos subpasos:
- Especifique el nombre de vía de acceso completo del archivo EAR
de módulo de mediación (archivo .ear). El archivo EAR que va a instalar puede estar 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 el cliente está conectado).
Si especifica un archivo EAR en la máquina cliente, la consola administrativa
carga el archivo EAR en la máquina en que está ejecutándose la consola y
continúa con la instalación de la aplicación.
- Pulse Siguiente.
- En la segunda página de Preparación para la instalación de
la aplicación, siga estos subpasos:
- Seleccione si va a generar enlaces por omisión.
El
uso de los enlaces por
omisión hace que los enlaces incompletos de la aplicación se llenen con
valores por omisión.
No se alteran los enlaces existentes.
Puede personalizar los valores por
omisión utilizados al generar enlaces por omisión.
- Pulse Siguiente. Si se
muestran avisos de seguridad, pulse Continuar. Se
muestran las páginas Instalar una nueva aplicación. Si ha
elegido generar enlaces por omisión y la aplicación no utiliza un adaptador de
recursos, puede continuar en el paso de Resumen (último paso que encontrará más
abajo).
- En el panel Paso: Seleccionar opciones de
instalación, proporcione los valores siguientes. Para obtener más información sobre los valores de esta página,
consulte Seleccionar valores de opciones de instalación. Se utilizarán valores por omisión si no especifica ningún valor.
- Para Directorio de instalación de la
aplicación, especifique el directorio en que se instalará el archivo
EAR de aplicación. El valor por omisión es el valor de
APP_INSTALL_ROOT/nombre_célula,
donde la variable APP_INSTALL_ROOT es
raíz_instalación/installedApps.
Por ejemplo, para
WebSphere ESB
que está instalado en Windows en C:\Archivos de
programa\WESB\,
la ubicación por omisión es
C:\Archivos de
programa\WESB\nombre_perfil\installedApps\nombre_célula.
Nota: Si no se especifica un directorio de instalación
cuando se instala una aplicación en un perfil autónomo, la aplicación se instala en
APP_INSTALL_ROOT/nombre_célula_base.
Si añade el servidor autónomo a una célula del gestor de despliegue, el nombre
de célula de la nueva configuración de servidor se convierte en el nombre de
célula del nodo del gestor de despliegue.
Si se utiliza la opción -includeapps para el programa de utilidad
addNode, las aplicaciones que se instalan antes que la operación addNode
todavía utilizarán el directorio de instalación
APP_INSTALL_ROOT/nombre_célula_base.
Sin embargo, una aplicación que se instale después de añadir el servidor
autónomo a la configuración de red, utiliza el directorio de instalación por
omisión
APP_INSTALL_ROOT/nombre_célula_red. Para mover la aplicación a la ubicación
APP_INSTALL_ROOT/nombre_célula_red
al ejecutar la operación addNode, debe especificar de manera explícita el
directorio de instalación como
${APP_INSTALL_ROOT}/${CELL} durante la instalación. En tal caso, los
archivos de aplicación pueden encontrarse siempre bajo
APP_INSTALL_ROOT/nombre_célula_actual.
- Para Distribuir aplicación, especifique si
WebSphere ESB
expande o suprime los binarios de aplicación en el directorio de instalación. El valor por omisión es habilitar la distribución de la aplicación.
Como resultado, cuando guarde cambios en la consola, los binarios de aplicación
para las aplicaciones recién instaladas se expandirán al directorio
especificado.
Los binarios también se suprimen cuando se desinstala y se guardan los cambios
en la configuración.
Si inhabilita esta opción, debe asegurarse de que los binarios de aplicación se
expanden de la manera correcta en los directorios de destino de todos los nodos
donde se espera que se ejecute la aplicación.
Importante: Si inhabilita esta opción y no copia y expande los
binarios de aplicación a los nodos, una operación posterior de guardar la
configuración o la sincronización manual
no mueve automáticamente los binarios de aplicación a los nodos.
- Para Utilizar configuración binaria,
especifique si el servidor o el clúster utiliza los enlaces, extensiones y
descriptores de despliegue situados con el documento de despliegue de
aplicación, el archivo deployment.xml (valor por omisión) o los
ubicados en el archivo EAR.
- Para Nombre de aplicación, escriba un nombre para la
aplicación. Los nombres de aplicación deben ser exclusivos en una célula y no pueden
contener caracteres que no estén permitidos en los nombres de objeto.
Para ver una lista de caracteres que no están permitidos en los nombres de
objeto, consulte Nombres de objeto
- Para Crear MBeans para recursos, especifique si se deben
crear MBeans para diversos recursos (como, por ejemplo, servlets o archivos
JSP) en una aplicación cuando ésta se inicie. El valor por omisión es crear instancias de MBean.
- Para Habilitar recarga de clases, especifique si debe
habilitar la recarga de clases cuando se actualicen los archivos de aplicación. El valor por omisión es no habilitar la recarga de clases. Al habilitar la recarga de clases se establece
reloadEnabled en true en el archivo deployment.xml para el
módulo de mediación.
Si la definición de clase de un módulo de mediación cambia, el tiempo de
ejecución del servidor se detiene e inicia la aplicación para recargar las
clases de aplicación.
- Para Intervalo de recarga en segundos, especifique el
número de segundos para explorar el sistema de archivos de la aplicación en
busca de archivos actualizados. El valor por omisión es el valor del atributo de intervalo de
recarga en el archivo de extensión 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 entra
en vigor si se ha habilitado la recarga de clases.
- Para 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 los servicios Web.
El valor por omisión es no ejecutar la herramienta wsdeploy. Debe
habilitar este valor si el archivo EAR contiene módulos que utilizan servicios
Web y no se ha ejecutado previamente la herramienta
wsdeploy en el mismo, sea desde la opción de menú Desplegar
de una herramienta de ensamblaje o desde una línea de mandatos.
- Para Validar entrada desactivada/aviso/error
especifique si WebSphere ESB
examina las referencias de aplicación especificadas durante la instalación o
actualización de la aplicación y, si se ha habilitado la validación, le
avisará de las referencias incorrectas que existan o la operación dará error. Una aplicación suele hacer referencia a recursos que utilizan
orígenes de datos para beans de persistencia gestionada por contenedor (CMP) o
que utilizan referencias de recurso o referencias de entorno de recursos
definidas en los descriptores de despliegue.
La validación comprueba si el recurso al que hace referencia la aplicación está
definido en el ámbito del destino de despliegue de esa aplicación. Seleccione desactivada si no hay validación de recursos,
aviso para avisos de mensajes sobre referencias de recursos incorrectas,
o error para detener las operaciones que fallen como resultado de
referencias de recursos incorrectas.
- Para Procesar configuración incorporada, especifique si
debe procesarse la configuración incorporada. Una configuración incorporada consta de archivos tales como
resource.xml y variables.xml.
Cuando se selecciona o el valor es true, la configuración incorporada
se carga en el ámbito de aplicación del archivo .ear. Si el archivo
.ear no contiene una configuración incorporada, el por omisión es
false. Si el archivo .ear contiene una configuración
incorporada, el valor por omisión es true.
- En el panel Paso: Correlacionar módulos con
servidores, seleccione para cada módulo un servidor o clúster de
destino de la lista Clústeres y servidores. Seleccione el recuadro de selección junto a
Módulo para seleccionar el módulo de mediación.
Si la aplicación utiliza un WebSphere Adapter, especifique los
servidores o clústeres de destino para cada archivo RAR.
Correlacione también con los mismos destinos todos los demás módulos que
utilizan los adaptadores de
recursos definidos en los módulos RAR.
Nota: Cuando se instala un archivo RAR en un servidor,
WebSphere ESB
busca el archivo de manifiesto (MANIFEST.MF) para el módulo de conector.
Busca primero en el archivo
connectorModule.jar del archivo RAR y carga el archivo de manifiesto del
archivo _connectorModule.jar. Si la entrada de la variable classpath se encuentra en
el archivo de manifiesto del archivo connectorModule.jar y, a continuación, el
archivo RAR utiliza esa variable classpath. Para asegurarse de que el módulo de
conector instalado encuentre las clases y recursos que necesita, seleccione el
valor de Class path para el archivo RAR utilizando la
consola. Para obtener más información sobre el valor Class
path, consulte Valores de adaptador de recursos y Valores de
adaptador de recursos relacionales de WebSphere para la consola
administrativa.
Puede especificar servidores
Web como destino que direccionan peticiones a la aplicación. El archivo de
configuración de plug-in plugin-cfg.xml para cada servidor Web se
genera en función de las aplicaciones que se direccionan a través del mismo.
Si desea que un servidor Web sirva a la aplicación, utilice la tecla
Control para seleccionar juntos un servidor de aplicación o clúster y el
servidor Web para tener el archivo de configuración de plug-in
plugin-cfg.xml para ese servidor Web generado en función de las
aplicaciones que se direccionan a través del mismo.
- Si la aplicación define referencias de recursos, para
Paso: Correlacionar referencias de recurso con recursos,
especifique nombres JNDI para los recursos que representan los nombres lógicos
definidos en las referencias de recurso. Cada referencia de recurso definida en la aplicación debe enlazarse a un
recurso definido en la configuración de
WebSphere ESB
antes de pulsar en Finalizar en el panel Resumen.
- Opcional: Especifique el nombre de configuración de
inicio de sesión y las propiedades de autenticación del recurso.
- Pulse Aceptar para guardar los valores y
volver al paso de correlación.
- Si la aplicación utiliza módulos Web, para 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 de sistema
principal virtual se utiliza en el URL que se usa para acceder a artefactos
tales como, por ejemplo, servlets y archivos JSP en el módulo Web.
Cada módulo Web debe tener un sistema principal virtual con el que se
correlaciona.
No especificar todos los sistemas principales virtuales necesarios producirá un
error de validación que se mostrará después de que pulse Finalizar en el
panel Resumen.
- Si la aplicación tiene roles de seguridad definidos en su descriptor
de despliegue, para Paso: Correlacionar roles de seguridad con
usuarios/grupos, especifique usuarios y grupos que se correlacionen con
cada uno de los roles de seguridad.
Seleccione Rol para seleccionar todos los
roles o bien seleccionar roles individuales.
Para cada rol, debe seleccionar una de las opciones siguientes acerca de cómo
debe aplicarse la seguridad:
Opción |
Descripción |
Todos |
Equivale a que no haya seguridad. |
Todos los autenticados |
Cualquier usuario que
se autentique con un nombre de usuario y contraseña válidos es miembro del rol. |
Usuarios correlacionados |
Los usuarios
individuales se listan como miembros del rol. |
Grupos correlacionados |
Los grupos son la
manera más conveniente de añadir los usuarios y todos los miembros de los
grupos identificados se convierten en miembros del rol. |
Para Usuarios correlacionados o
Grupos correlacionados, para seleccionar usuarios o
grupos específicos del registro de usuarios, siga estos subpasos:
- Seleccione un rol y pulse Buscar usuarios o Buscar
grupos.
- En el panel Buscar usuarios/grupos que se visualiza, especifique
los criterios de búsqueda para extraer una lista de usuarios o grupos del
registro de usuarios.
- Seleccione usuarios o grupos individuales a partir de los
resultados visualizados.
- Pulse Aceptar para correlacionar los usuarios o grupos
seleccionados con el rol seleccionado en el panel
Paso: Correlacionar roles de seguridad con usuarios/grupos.
- Si la aplicación tiene roles de Ejecutar como definidos en su
descriptor de despliegue, para Paso: Correlacionar roles RunAs con
usuario, especifique el nombre de usuario y la contraseña de Run As para
cada rol Run As. Los roles Run As los utilizan los
enterprise beans que deben ejecutarse como un rol concreto mientras interactúan
con otro enterprise bean. Seleccione Rol para seleccionar todos los
roles o bien seleccionar roles individuales.
Después de seleccionar un rol, especifique valores para los campos de nombre de
usuario, contraseña y verificar contraseña y pulse Aplicar.
- Si la aplicación define referencias de recursos, para Paso:
Correlacionar referencias de entorno de recurso con recursos, especifique
nombres JNDI de los recursos que se correlacionan con los nombres
lógicos definidos en las referencias de entorno de recurso. Si cada referencia de entorno de recurso no tiene un recurso asociado al
mismo, después de pulsar Finalizar se visualizará un error de validación.
- Si la aplicación define Identidad Run-As como Identidad
del sistema, para Paso: Sustituir sistema RunAs por roles
RunAs, tiene la opción de cambiarlo por
Rol Run-As y especificar un nombre de usuario y contraseña para el rol
Run As especificado. La selección de Identidad del sistema implica que la
invocación se realice utilizando el ID de servidor de seguridad de
WebSphere Application Server y debe utilizarse con precaución, ya que este ID
tiene más privilegios.
- Si la aplicación tiene referencias de recurso que se correlacionan
con recursos que tengan una base de datos Oracle que ejecuta un proceso de
programa de fondo, para Paso: Especificar el nivel de aislamiento para
proveedor de tipo Oracle, especifique o corrija el nivel de aislamiento que
debe utilizarse para tales recursos cuando los utilice la aplicación. Las bases de datos Oracle
sólo dan soporte a los niveles de aislamiento ReadCommitted y
Serializable.
- En el panel Resumen, verifique la célula, el nodo y el servidor en
los que se instalarán los módulos de aplicación:
- Junto a Célula/Nodo/Servidor, pulse en Pulse aquí.
- Verifique los valores.
- Pulse Finalizar.
Resultado
Se visualizan varios mensajes, lo que indica si el archivo de
aplicación se instala satisfactoriamente o no.
Si recibe una excepción OutOfMemory y el archivo de 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 en ella para instalarse satisfactoriamente
en el servidor.
Si la falta de memoria del sistema no es la causa de la excepción, vuelva a
empaquetar la aplicación de manera que el archivo
.ear tenga menos módulos.
Si la falta de memoria del sistema y el número de módulos no son las causas de
la excepción, compruebe las opciones que ha especificado en la
página Java Virtual Machine del servidor
de aplicaciones que ejecuta la consola administrativa.
A continuación, intente instalar de nuevo el archivo de aplicación.
Durante la instalación, ciertos archivos de
aplicación se extraen en el directorio representado por la sesión de
configuración y, cuando se guarda la configuración, estos archivos se guardan
en el depósito 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 de archivos. Por consiguiente, la instalación de la aplicación podría
fallar si la vía de acceso para los archivos de aplicación en la sesión de
configuración o en el depósito de configuración sobrepasa el límite de 256
caracteres.
Podría ver excepciones FileNotFound con nombre de vía de acceso
demasiado largo en el mensaje.
Para superar estos problemas, haga que los nombres de aplicación y los nombres
de URI de módulo tengan una longitud más corta, ya que esto ayuda a reducir la
longitud de la vía de acceso de archivos.
A continuación, intente instalar de nuevo el archivo de aplicación.
Qué hay que hacer a continuación
Una vez que el archivo de aplicación se haya instalado
satisfactoriamente, realice las acciones siguientes:
- Asocie las bibliotecas
compartidas que la aplicación necesita para la aplicación.
- Guarde los cambios en la configuración. La aplicación se registra con los
archivos de aplicación y configuración administrativa copiados en el directorio
de destino, que por omisión es
raíz_instalación/installedApps/nombre_célula
o el directorio que indique. Cuando se realiza la instalación en un perfil de Network
Deployment, los archivos se copian en nodos remotos cuando la configuración que
hay en el gestor de despliegue se sincroniza con la configuración en nodos
individuales.
- Si el módulo se despliega en un clúster de servidores, pulse
Desplegar actualización en la página Aplicaciones
de empresa para propagar la configuración modificada en todos los
miembros del clúster.
Desplegar actualización realiza una actualización secuencial de la
configuración en los nodos que contienen miembros de clúster.
Para habilitar
WebSphere ESB
con el fin de utilizar las funciones proporcionadas por un módulo de mediación
para integrar aplicaciones y servicios, debe iniciarse el módulo desplegado.
Puede iniciar el módulo manualmente o configurarlo para que se inicie de forma
automática.
También puede administrar el módulo de otras maneras; por ejemplo, para cambiar
la configuración del módulo, para detener o actualizar el módulo y gestionar su
actividad de otras maneras.