se non si desidera utilizzare la funzione di messaggistica WebSphere ESB predefinita
per la trasmissione di eventi, è possibile configurare il trasporto di messaggi asincroni per utilizzare
un provider JMS (Java Messaging Service) differente.
Informazioni preliminari
Prima di poter configurare la messaggistica di eventi utilizzando un provider JMS esterno, per prima cosa
è necessario creare una produzione di connessioni ed una coda JMS utilizzando le interfacce appropriate
per il provider JMS.
Perché e quando eseguire questa attività
Lo script
event-message.jacl imposta gli oggetti di configurazione richiesti per la
trasmissione di eventi asincroni utilizzando un provider JMS esterno come
WebSphere MQ:
- Se viene specificato un ambito, crea un profilo di trasmissione JMS utilizzando la produzione di connessioni e
la coda JMS specificate.
- Crea un profilo di produzione dell'emettitore utilizzando il profilo di trasmissione JMS creato per la trasmissione
di eventi asincroni.
- Distribuisce il bean basato sui messaggi utilizzato da Common Event Infrastructure per ricevere
gli eventi inviati in modalità asincrona al server eventi, utilizzando una porta
listener o una specifica di attivazione JMS.
Se si desidera impostare più di una coda JMS nel server eventi, è possibile eseguire questo
script più volte, specificando nomi di applicazioni enterprise e
code JMS differenti. Ogni volta che si esegue uno script, esso distribuisce un bean basato sui messaggi
aggiuntivo e configura nuove risorse per utilizzare la coda JMS
specificata.
Per configurare la messaggistica di eventi allo scopo di utilizzare un provider JMS esterno:
Passi per questa attività
- Andare alla directory $WAS_HOME/event/application per il profilo che definisce
l'ambiente di runtime WebSphere ESB,
su cui si desidera configurare la messaggistica predefinita. (Sostituire profile_path con il percorso
alla directory contenente il profilo WebSphere ESB).
- Eseguire lo script event-message.jacl utilizzando il comando wsadmin:
- Sistemi Windows
%WAS_HOME%\bin\wsadmin -profile event-profile.jacl -f event-message.jacl
-action install -earfile event-message.ear -node node_name
[-server server_name] [cluster cluster_name]
-appname app_name -qjndi queue -qcfjndi connection_factory
[-listenerport listener_port] [-activationspecjndi spec_name]
[-eventprofilescope scope] [-trace]
- Sistemi Linux e UNIX
$WAS_HOME/bin/wsadmin -profile event-profile.jacl -f event-message.jacl
-action install -earfile event-message.ear -node node_name
[-server server_name] [cluster cluster_name]
-appname app_name -qjndi queue -qcfjndi connection_factory
[-listenerport listener_port] [-activationspecjndi spec_name]
[-eventprofilescope scope] [-trace]
$WAS_HOME/bin/wsadmin -profile event-profile.jacl -f event-message.jacl
-action install -earfile event-message.ear -node node_name
[-server server_name] [cluster cluster_name]
-appname app_name -qjndi queue -qcfjndi connection_factory
[-listenerport listener_port] [-activationspecjndi spec_name]
[-eventprofilescope scope] [-trace]
I parametri dello script
event-message.jacl sono i
seguenti:
- node_name
- Il nodo WebSphere ESB su cui deve essere
distribuita l'applicazione di messaggistica. Per determinare il nome del
nodo:
- Eseguire lo script profile_path/bin/setupCmdLine.
- Eseguire il comando echo $WAS_NODE (sistemi Linux/UNIX) o echo
%WAS_NODE% (sistemi Windows).
Questo valore è sensibile al maiuscolo e minuscolo. Se si sta distribuendo l'applicazione in
un cluster, omettere questo parametro.
- server_name
- Il server WebSphere all'interno del quale deve essere distribuita l'applicazione di messaggistica.
Questo valore è sensibile al maiuscolo e minuscolo. Se si sta distribuendo l'applicazione in
un cluster, omettere questo parametro.
- cluster_name
- Il cluster WebSphere all'interno del quale si desidera distribuire l'applicazione di messaggistica.
Specificare questo parametro solo se si sta configurando la messaggistica in un cluster e non si sta
specificando un nodo e un server.
Nota: se si sta utilizzando un database di eventi Cloudscape, il
clustering è supportato solo per scopi di verifica (non in un ambiente di
produzione).
- app_name
- Il nome da utilizzare per l'applicazione enterprise di messaggistica. Questo parametro è
obbligatorio.
- queue
- Il nome JNDI della coda JMS che deve essere utilizzato dall'applicazione enterprise di
messaggistica. Questa coda viene utilizzata per il trasporto di messaggi asincroni al server
eventi. Se si distribuisce l'applicazione di messaggistica più volte, è necessario specificare una coda
JMS differente ogni volta.
- connection_factory
- Il nome JNDI di produzione connessioni JMS che deve essere utilizzato dall'applicazione enterprise di
messaggistica.
- listener_port
- Il nome della porta listener utilizzato dall'applicazione enterprise di messaggistica.
La porta listener viene specificata nel descrittore di distribuzione. Fornire questo parametro solo se
l'applicazione di messaggistica utilizza una porta listener.
- spec_name
- Il nome JNDI della specifica di attivazione utilizzata dall'applicazione enterprise
di messaggistica. La specifica di attivazione viene indicata nel descrittore di distribuzione.
Fornire questo parametro solo se
l'applicazione di messaggistica utilizza una specifica di applicazione.
- eventprofilescope
- L'ambito di oggetti del profilo di configurazione da creare per la messaggistica di
eventi. Questo parametro è facoltativo; se si specifica un ambito, un
profilo di produzione emettitore ed un profilo di trasmissione JMS vengono creati per l'ambito specificato. I valori
validi sono cell, node e server.
Il parametro facoltativo -trace consente la visualizzazione
di informazioni aggiuntive di debug sull'output standard.
Nota: - Se si specifica un percorso completo per l'ubicazione del file event-message.ear, accertarsi
di utilizzare le barre (/) nel percorso, anche su sistemi Windows.
- Se si sta distribuendo l'applicazione di messaggistica su un nodo autonomo, specificare il parametro
facoltativo -conntype none per eseguire wsadmin in modalità
locale
Dopo aver avviato lo script, verranno richiesti l'ID utente e la
password JMS.