L'applicazione enterprise del server eventi deve essere distribuita in ogni ambiente di runtime
WebSphere in cui il profilo è stato ampliato per utilizzare
la Common Event Infrastructure.
Perché e quando eseguire questa attività
L'applicazione enterprise del server eventi viene inserita nel pacchetto del file EAR
event-application.ear. Lo script event-application.jacl installa questa applicazione
in WebSphere ESB.
Passi per questa attività
- Andare alla directory profile_path/event/application per il
profilo che definisce l'ambiente di runtime WebSphere Application Server in cui si desidera distribuire
l'applicazione. (Sostituire profile_path con il percorso alla
directory contenente il profilo WebSphere Application Server).
- Eseguire lo script event-application.jacl utilizzando il comando wsadmin:
- Sistemi Windows
profile_path\bin\wsadmin [-conntype none] -profile event-profile.jacl
-f event-application.jacl -action action -earfile event-application.ear
-backendid backend_id -node node_name -server server_name
[-cluster cluster_name] [-appname app_name] [-trace]
- Sistemi Linux e UNIX
profile_path/bin/wsadmin.sh [-conntype none] -profile event-profile.jacl
-f event-application.jacl -action action -earfile event-application.ear
-backendid backend_id -node node_name -server server_name
[-cluster cluster_name] [-appname app_name] [-trace]
I parametri sono i seguenti:
- action
- L'azione da eseguire. Per installare l'applicazione enterprise, specificare install.
Per aggiornare un'applicazione del server eventi esistente già installata,
specificare update. Durante un aggiornamento, lo script effettua una copia di backup
del file EAR dell'applicazione esistente nella directory corrente; se necessario,
è possibile utilizzare successivamente questa copia di backup per ripristinare la versione precedente
dell'applicazione.
- backend_id
- Il tipo di backend di database che deve essere utilizzato dall'applicazione enterprise.
Questo deve essere uno dei seguenti valori:
- CLOUDSCAPE_V51_1
- DB2UDBNT_V82_1
- DB2UDBNT_V8_1
- ORACLE_V10_1
- ORACLE_V9_1
- DB2UDBOS390_V8_1
- DB2UDBOS390_V7_1
- node_name
- Il nodo WebSphere ESB in cui il
server eventi deve essere distribuito. Per trovare il nome del nodo, effettuare quanto
segue:
- 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 enterprise in
un cluster, omettere questo parametro.
- server_name
- Il server WebSphere all'interno del quale deve essere distribuita l'applicazione enterprise del server
eventi. Questo valore è sensibile al maiuscolo e minuscolo. Se si sta distribuendo l'applicazione enterprise in
un cluster, omettere questo parametro.
- cluster_name
- Il cluster WebSphere all'interno del quale deve essere distribuita l'applicazione enterprise del server
eventi. Specificare questo parametro solo se si sta distribuendo l'applicazione in un cluster e non si sta
specificando un nodo e un server.
- app_name
- Il nome da utilizzare per l'applicazione enterprise di Common Event Infrastructure. Questo parametro
è facoltativo; il valore predefinito è CommonEventInfrastructureServer.
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-application.ear, accertarsi
di utilizzare le barre (/) nel percorso, anche su sistemi Windows.
- Se si sta distribuendo l'applicazione su un nodo autonomo, specificare il parametro
facoltativo -conntype none per eseguire wsadmin in modalità
locale.
Per ulteriori informazioni sul programma di utilità wsadmin, fare riferimento alla documentazione
relativa a WebSphere Application Server.
Risultato
Dopo il completamento dello script
event-application.jacl, l'applicazione enterprise di Common
Event Infrastructure viene distribuita nel server o cluster
specificati. In un ambiente
WebSphere ESB Network
Deployment, se l'applicazione è già installata, lo script aggiunge solo le informazioni sulla
distribuzione per il nodo o server specificati.