In questa sezione viene descritto come utilizzare uno script per configurare il raccoglitore di eventi e le tabelle di database necessari per Business Process Choreographer
Observer.
Prima di iniziare
- È disponibile un database.
- La variabile di ambiente CLASSPATH contiene il driver JDBC per il database.
- È necessario creare un'origine dati XA manualmente utilizzando la console di gestione del server delle applicazioni. L'origine dati deve fare riferimento al database.
Procedura di questa attività
- Passare alla directory secondaria di Business Process Choreographer in cui si trovano gli script
di configurazione.
Su sistemi Windows, immettere:
cd root_installazione\ProcessChoreographer\config
Su sistemi UNIX e Linux, immettere:
cd root_installazione/ProcessChoreographer/config
- Avviare lo script per impostare il raccoglitore di eventi.
Su sistemi Windows, immettere:
setupEventCollector.bat [-conntype SOAP | RMI | JMS | NONE]
( [-node nodeName] -server serverName ) | ( -cluster clusterName )
[ -remove [-silent]]
Su sistemi UNIX e Linux, immettere:
setupEventCollector.sh [-conntype SOAP | RMI | JMS | NONE]
( [-node nodeName] -server serverName ) | ( -cluster clusterName )
[ -remove [-silent]]
Dove:
- conntype SOAP | RMI | JMS | NONE
- La modalità di connessione utilizzata dallo strumento wsadmin.
- node nodeName
- Il nome del nodo. Questo
parametro è facoltativo. Il valore predefinito è il nodo locale.
- server serverName
- Il nome del server. Se non viene specificata l'opzione -conntype
none, tale parametro è facoltativo.
- cluster clusterName
- clusterName Se non viene specificata l'opzione -conntype
none, tale parametro è facoltativo.
- remove
- Specificare questa opzione per rimuovere il raccoglitore di eventi. Se questa opzione non viene specificata, per impostazione predefinita il raccoglitore di eventi verrà configurato.
- silent
- Questa opzione può essere utilizzata solo con l'opzione remove.
Se specificata, lo script non emette alcuna richiesta. Questo parametro è facoltativo.
Nota: In un ambiente server autonomo:
- Includere l'opzione -conntype NONE solo se il server delle applicazioni non è in esecuzione.
- Se il server è in esecuzione ed è abilitata la sicurezza globale, includere le opzioni -user e -password.
- Se non si sta configurando il profilo predefinito, aggiungere l'opzione -profileName.
Viene visualizzato il menu dei comandi:
Commands Menu
1) Prepare a database for the Event Collector
2) Install the Event Collector application
3) Remove the Event Collector application and related objects
4) Change configuration settings of an installed Event Collector
0) Exit Commands Menu
Nota: Se è stato avviato lo script in modalità locale, cioè con il parametro -conntype none e senza specificare un server o un cluster, vengono visualizzati solo gli elementi di menu 0 e 1.
- Selezionare l'opzione 1 per preparare un database per il raccoglitore di eventi.
- Quando viene visualizzato il menu dei comandi:
Select the type of your DBMS :
'd' ... DB2
'c' ... Cloudscape
'7' ... DB2 V7 on z/OS
'8' ... DB2 V8 on z/OS
'o' ... Oracle
'x' ... Exit
Your selection : [c]
Viene visualizzato il menu dei comandi:
- Selezionare il tipo di database.
- Per DB2, immettere d.
- Per Cloudscape, immettere c.
- Per DB2 V7 su z/OS, immettere 7.
- Per DB2 V8 su z/OS, immettere 8.
- Per Oracle, immettere o.
- Immettere le impostazioni del database.
- Per DB2, immettere quanto segue:
- Il nome del database, o un alias, ad esempio BPEDB.
- ID utente e password per collegarsi al database, ad esempio db2admin.
- La password per l'ID utente.
- Lo schema di database da utilizzare per gli oggetti del database. Se si specifica uno schema che non esiste, esso viene creato. Se si immette un carattere spazio o si lascia vuoto il campo, viene utilizzato lo schema dell'ID utente specificato in a.
- Per Cloudscape, immettere quanto segue:
- Il percorso completo del database, ad esempio d:\w\p\profiles\Srv01\databases\BPEDB.
- Lo schema di database da utilizzare per gli oggetti del database. Se si specifica uno schema che non esiste, esso viene creato. Se si immette un carattere spazio o si lascia vuoto il campo, viene utilizzato lo schema predefinito (generalmente APP).
- Se viene richiesto di arrestare il server, effettuare l'arresto, quindi premere c per continuare
l'operazione.
- Per Oracle, immettere quanto segue:
- Il nome del database, ad esempio BPEDB.
- Il nome dell'host su cui risiede il database, ad esempio localhost.
- Il numero di porta su cui il listener Oracle è in ascolto, ad esempio 1521.
- L'ID utente per collegarsi al database, ad esempio system.
- La password per l'ID utente.
Dopo la verifica della connessione, il database è preparato.
- Verificare eventuali errori. In caso di errori, verificare il file di log setupEventCollector.log, ubicato nella directory secondaria logs della directory
profile. Ad esempio, su Windows, se il profilo è denominato myServer e i profili sono memorizzati in root_installazione\profiles,
il file di log è collocato in root_installazione\profiles\myServer\logs.
- Installare l'applicazione del raccoglitore di eventi. Quando viene visualizzato il menu dei comandi:
Commands Menu
1) Prepare a database for the Event Collector
2) Install the Event Collector application
3) Remove the Event Collector application and related objects
4) Change configuration settings of an installed Event Collector
0) Exit Commands Menu
Selezionare l'opzione 2 per installare l'applicazione del raccoglitore di eventi di
Business Process Choreographer. Viene visualizzata la richiesta del nome
JNDI:
Specify the JNDI name of the database where the WebSphere BPC Event
Collector should store the collected events.
Enter '?' to get a list.
Your selection : [jdbc/BPEDB]
- Immettere il nome JNDI utilizzato per il collegamento al database. È possibile immettere anche il seguente carattere ? per visualizzare un elenco di tutte le origini
dati registrate.
- Immettere il nome dello schema per le tabelle del database in cui verranno memorizzati gli eventi
raccolti. Per utilizzare lo schema specificato nella definizione dell'origine dati, immettere un carattere spazio o lasciare il campo vuoto.
- Immettere l'ID utente JMS per effettuare l'autenticazione con il bus CEI (Common Event Infrastructure). Se per il bus CEI non è abilitata la sicurezza, è possibile lasciare vuoto questo campo.
Se viene specificato un ID utente, immettere anche una password alla richiesta successiva. Tutti gli oggetti richiesti vengono creati e l'applicazione
enterprise viene installata. La corretta esecuzione dell'operazione viene indicata
dal messaggio:
WebSphere Business Process Choreographer Event Collector
installed successfully!
- Se non viene visualizzato alcun messaggio di errore, immettere s per salvare
la configurazione. Altrimenti, immettere n per
eliminare le modifiche e conservare la configurazione di origine. Se si sono verificati errori, verificare il file di log denominato setupEventCollector.log, ubicato nella directory logs del profilo; ad esempio, su Windows, se il profilo è denominato myServer e i profili sono memorizzati in root_installazione\profiles, il file di log è collocato in root_installazione\profiles\myServer\logs.
- Se il collegamento CEI non è abilitato sul server, viene visualizzato quanto segue:
Checking if CEI event logging is enabled ...
Warning: The Business process container of nome_server has CEI event
logging disabled.
To allow the Event Collector to work correctly, CEI event logging is required.
Do you want to enable the CEI event logging on nome_server? (y/n)
Per
abilitare il collegamento CEI, immettere s, in caso contrario immettere n.
- Se viene chiesto di avviare l'applicazione, immettere y per avviarla o n per non avviarla.
- Per attivare tutte le impostazioni, riavviare il server.
Risultato
Il raccoglitore di eventi Business Process Choreographer è installato e
configurato.
Azione successiva
Configurare Business Process
Choreographer Observer con il passo 2. Nel caso si desideri, è possibile utilizzare l'opzione 4 del menu di comandi per modificare i parametri di configurazione del raccoglitore di eventi, come descritto nel documento di supporto
7008553.