Si no desea utilizar la característica de mensajería predeterminada de
WebSphere ESB
para la transmisión de sucesos, puede configurar el transporte de mensajes asíncrono
para que utilice un proveedor de servicios de mensajería Java (JMS) distinto.
Antes de empezar
Antes de configurar la mensajería de sucesos utilizando un proveedor JMS
externo, primero debe crear una cola JMS y una fábrica de conexiones que utilice las
interfaces adecuadas para su proveedor JMS.
Por qué y cuándo se efectúa esta tarea
El script
event-message.jacl establece los objetos de
configuración necesarios para la transmisión de sucesos asíncrona utilizando un
proveedor JMS externo como WebSphere MQ:
- Si se especifica un ámbito, se crea un perfil de transmisiones JMS utilizando la
cola JMS y la fábrica de conexiones que especifique.
- Crea un perfil de fábrica de emisores utilizando el perfil de transmisiones JMS
creado para la transmisión de sucesos asíncrona.
- Despliega el bean controlado por mensajes que utiliza
Common Event Infrastructure para recibir
sucesos enviados asíncronamente al servidor de sucesos utilizando un puerto de
escucha o una especificación de activación JMS.
Si desea configurar más de una cola JMS en el servidor de sucesos, puede
ejecutar este script varias veces especificando diferentes nombres de aplicación
empresarial y colas JMS. Cada vez que ejecute el script, desplegará un bean
controlado por mensajes adicional y configurará nuevos recursos para utilizar la
cola JMS especificada.
Para configurar la mensajería de sucesos para que
utilice un proveedor JMS externo:
Pasos para realizar esta tarea
- Vaya al directorio $WAS_HOME/event/application del perfil que define el
entorno de ejecución WebSphere ESB en
el que desea configurar la mensajería predeterminada. (Sustituya
vía_acceso_perfil por la vía de acceso al directorio que contenga
el perfil WebSphere ESB.)
- Ejecute el script event-message.jacl utilizando el mandato wsadmin:
- Sistemas Windows
%WAS_HOME%\bin\wsadmin -profile event-profile.jacl -f event-message.jacl
-action install -earfile event-message.ear -node nombre_nodo
[-server nombre_servidor] [cluster nombre_clúster]
-appname nombre_aplicación -qjndi cola -qcfjndi fábrica_conexiones
[-listenerport puerto_escucha] [-activationspecjndi nombre_especificación]
[-eventprofilescope ámbito] [-trace]
- Sistemas Linux y UNIX
$WAS_HOME/bin/wsadmin -profile event-profile.jacl -f event-message.jacl
-action install -earfile event-message.ear -node nombre_nodo
[-server nombre_servidor] [cluster nombre_clúster]
-appname nombre_aplicación -qjndi cola -qcfjndi fábrica_conexiones
[-listenerport puerto_escucha] [-activationspecjndi nombre_especificación]
[-eventprofilescope ámbito] [-trace]
$WAS_HOME/bin/wsadmin -profile event-profile.jacl -f event-message.jacl
-action install -earfile event-message.ear -node nombre_nodo
[-server nombre_servidor] [cluster nombre_clúster]
-appname nombre_aplicación -qjndi cola -qcfjndi fábrica_conexiones
[-listenerport puerto_escucha] [-activationspecjndi nombre_especificación]
[-eventprofilescope ámbito] [-trace]
Los parámetros del script
event-message.jacl son los siguientes:
- nombre_nodo
- El nodo de WebSphere ESB en
el que debe desplegarse la aplicación de mensajería. Para determinar el nombre de
nodo:
- Ejecute el script vía_acceso_perfil/bin/setupCmdLine.
- Ejecute el mandato echo $WAS_NODE (sistemas Linux/UNIX) o
echo %WAS_NODE% (sistemas Windows).
Este valor tiene en cuenta las mayúsculas y minúsculas. Si despliega la
aplicación en un clúster, omita este parámetro.
- nombre_servidor
- El servidor de WebSphere en el que debe desplegarse la aplicación de mensajería.
Este valor tiene en cuenta las mayúsculas y minúsculas. Si despliega la aplicación
en un clúster, omita este parámetro.
- nombre_clúster
- El clúster de WebSphere en el que desea desplegar la aplicación de mensajería.
Especifique este parámetro sólo si configura la mensajería en un clúster y no
especifica un nodo y un servidor.
Nota: Si utiliza una base de datos de sucesos
Cloudscape, la configuración en clúster se soporta sólo para fines de prueba (no en
un entorno de producción).
- nombre_aplicación
- El nombre que se utilizará para la aplicación empresarial de mensajería. Este
parámetro es necesario.
- cola
- El nombre JNDI de la cola JMS que debe utilizar la aplicación empresarial de
mensajería. Esta cola sirve para el transporte de mensajes asíncronos al servidor de
sucesos. Si despliega la aplicación de mensajería varias veces, debe especificar una
cola JMS diferente cada vez.
- fábrica_conexiones
- El nombre JNDI de la fábrica de conexiones JMS que utiliza la aplicación empresarial de mensajería.
- puerto_escucha
- El nombre del puerto de escucha que utiliza la aplicación empresarial de mensajería.
El puerto de escucha se especifica en el descriptor de despliegue. Especifique este
parámetro sólo si la aplicación de mensajería utiliza un puerto de escucha.
- nombre_especificación
- El nombre JNDI de la especificación de activación que utiliza la aplicación empresarial de mensajería.
La especificación de activación se especifica en el descriptor de despliegue. Especifique
este parámetro sólo si la aplicación de mensajería utiliza una especificación de
activación.
- ámbito
- El ámbito de los objetos de perfil de configuración que deben crearse para la
mensajería de sucesos. Este parámetro es opcional. Si especifica un ámbito, se
crearán un perfil de transmisiones JMS y un perfil de fábrica de emisores en el
ámbito especificado. Los valores válidos son cell,
node y server.
El parámetro opcional -trace hace
que se visualice información de depuración adicional en la salida estándar.
Nota: - Si especifica una vía de acceso totalmente calificada para la ubicación del
archivo event-message.ear, asegúrese de usar barras inclinadas (/) en la vía de
acceso, incluso en sistemas Windows.
- Si despliega la aplicación de mensajería en un nodo autónomo, especifique el
parámetro opcional -conntype none para que ejecute wsadmin
en modalidad local.
Después de iniciar el script, se le solicitará el ID
de usuario y la contraseña de JMS.