Questo file di script configura tutte le risorse richieste da Business Process Choreographer.
Scopo
Questo script può essere eseguito in modalità interattiva o in batch. Questo script configura un contenitore dei processi aziendali attivo ed un contenitore human task senza utilizzare la procedura guidata all'installazione o la console di gestione. È possibile creare un database locale e le risorse di messaggistica necessarie, oltre a configurare Business Process Choreographer Explorer.
Se lo script viene applicato ad un server delle applicazioni che si trova in un cluster, tutti i server nel cluster verranno configurati per utilizzare Business Process Choreographer.
Posizione
Il file di script bpeconfig.jacl si trova nella directory
Business Process Choreographer
config:
- Sui sistemi Linux e UNIX: nella directory install_root/ProcessChoreographer/config
- Sui sistemi Windows: nella directory install_root\ProcessChoreographer\config
Limitazioni
Questo script dispone delle seguenti limitazioni:
- In un ambiente ND o in un cluster
- Per configurare vari server delle applicazioni in un ambiente ND o in un cluster,
è necessario eseguire lo script bpeconfig.jacl in modo interattivo. Lo script non può essere utilizzato per eseguire questo tipo di configurazione in modalità non interattiva.
- Utilizzo di un datrabase DB2 per z/OS
- Lo script bpeconfig.jacl non può creare un database DB2 per z/OS. È necessario crearlo manualmente.
- Utilizzo di un database Oracle
- Lo script bpeconfig.jacl non può creare un database Oracle locale. Se si desidera utilizzare un database Oracle locale per Business Process Choreographer, è necessario creare manualmente tale database.
Esecuzione dello script in un ambiente del server autonomo
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.
Esecuzione dello script in un ambiente ND
In un ambiente Network Deployment:
- Eseguire lo script sul nodo del gestore di distribuzione.
- Includere solo l'opzione -conntype NONE se il gestore distribuzione non è in esecuzione.
- Se è abilitata la sicurezza globale, includere le opzioni -user e -password.
- Se non si sta configurando il profilo predefinito, aggiungere l'opzione -profileName.
Configurazione del contenitore dei processi aziendali, Business Process
Choreographer Explorer e Business Process Choreographer Observer in modalità non interattiva
Se si forniscono i parametri necessari nella riga comandi, non verranno richiesti. Per configurare Business Process Choreographer, immettere uno dei seguenti comandi:
Sui sistemi UNIX e Linux, se la directory corrente
è install_root, immettere il comando:
bin/wsadmin.sh -f ProcessChoreographer/config/bpeconfig.jacl parameters
Sui sistemi Windows, se la directory corrente è install_root, immettere il comando:
bin\wsadmin -f ProcessChoreographer/config/bpeconfig.jacl parameters
dove
parametri sono i seguenti:
-conntype NONE
-user userName
-password userPassword
-profileName profileName
{-node nodeName -server serverName}
{-adminBFMUsers userList | -adminBFMGroups groupList}
{-monitorBFMUsers userList | -monitorBFMGroups groupList}
-jmsBFMRunAsUser userID
-jmsBFMRunAsPwd password
{-adminHTMUsers userList | -adminHTMGroups groupList}
{-monitorHTMUsers userList | -monitorHTMGroups groupList}
-jmsHTMRunAsUser userID
-jmsHTMRunAsPwd password
-contextRootBFM contextRootBFM
-contextRootHTM contextRootHTM
-mailServerName mailServerName
-mailUser mailUserID
-mailPwd mailPassword
-hostName explorerVirtualHostname
-explorerHost explorerURL
-remoteNodeName nodeName
-remoteServerName serverName
-remoteClusterName clusterName
-contextRootExplorer explorerContextRoot
-createDB { yes | no }
-dbType databaseType
-dbVersion version
-dbHome databaseInstallPath
-dbJava JDBCDriverPath
-dbName databaseName
-dbUser databaseUser
-dbPwd databasePassword
-dbAdmin databaseAdministratorUserID
-driverType JDBCDriverType
-dbTablespaceDir databaseTablespacePath
-dbServerName databaseServerName
-dbServerPort databaseServerPort
-dbStorageGroup DB2zOSStorageGroup
-dbSubSystem DB2zOSSubSystem
-dbSQLID DB2zOSSchemaQualifier
-dbInstance InformixInstance
-mqType JMSProviderType
-createQM { yes | no }
-qmNameGet getQueueManagerName
-mqClusterName appServerClusterName
-qmNamePut putQueueManagerName
-mqHome MQInstallationDirectory
-mqUser JMSProviderUserID
-mqPwd JMSProviderPassword
-mqSchemaName mqSchemaName
-mqCreateTables { true | false }
-mqDataSource datasourceName
-shell shell
-createEventCollector { yes | no }
-createObserver { yes | no }
Nota: alcuni dei parametri descritti in precedenza sono facoltativi, in base ai valori forniti per gli altri parametri. Le dipendenze tra parametri e le condizioni che determinano se un parametro è facoltativo o obbligatorio vengono descritte per ciascun parametro nelle descrizioni di seguito riportate.
I parametri obbligatori che non sono specificati nella riga comandi vengono richiesti per la modalità interattiva.
Parametri
È possibile utilizzare i seguenti parametri richiamando lo script con il comando wsadmin:
- conntype NONE
- Specifica che non è disponibile alcuna connessione di gestione. Includere solo questa opzione se il server delle applicazioni (autonomo) o il gestore distribuzione (per ND) non è in esecuzione.
- user userName
- Se è abilitata la sicurezza globale, è necessario fornire un ID utente per l'autenticazione.
- password userPassword
- Se è abilitata la sicurezza globale, è necessario fornire la password per l'ID utente userName.
- profileName profileName
- Dove profileName è il nome di un profilo definito dall'utente.
Specificare questa opzione se non si sta configurando il profilo predefinito.
- node nodeName
- Dove nodeName è il nome del nodo in cui deve essere configurato Business
Process Choreographer. Se si dispone di un solo nodo e di esattamente un server, questo parametro è facoltativo.
- server serverName
- Dove serverName è il nome del server in cui deve essere configurato Business
Process Choreographer. Se si dispone di un solo nodo e di esattamente un server, questo parametro è facoltativo.
- adminBFMUsers elencoutenti
- Dove elencoutenti è l'elenco dei nomi utente, dal registro utenti, a cui mappare il ruolo J2EE (Java 2 Enterprise Edition) BPESystemAdministrator. Il carattere separatore è la linea verticale (|). Questa proprietà è necessaria per installare il contenitore dei processi aziendali.
Questo parametro non dispone di valori predefiniti. È necessario impostare una o entrambe le opzioni adminBFMUsers o adminBFMGroups.
- adminBFMGroups groupList
- Dove groupList è l'elenco dei nomi dei gruppi del registro utente cui mappare il ruolo BPESystemAdministrator J2EE. Il carattere separatore è la linea verticale (|). Questa proprietà è necessaria per installare il contenitore dei processi aziendali. Questo parametro non dispone di valori predefiniti. È necessario impostare una o entrambe le opzioni adminBFMUsers o adminBFMGroups.
- monitorBFMUsers userList
- Dove userList è l'elenco dei nomi utente, del registro utente, cui mappare il ruolo BPESystemMonitor J2EE. Il carattere separatore è la linea verticale (|). Questa proprietà è necessaria per installare il contenitore dei processi aziendali. Questo parametro non dispone di valori predefiniti. È necessario impostare monitorBFMUsers, monitorBFMGroups o entrambi.
- monitorBFMGroups groupList
- Dove groupList è l'elenco dei nomi dei gruppi del registro utente cui mappare il ruolo BPESystemMonitor J2EE. Il carattere separatore è la linea verticale (|). Questa proprietà è necessaria per installare il contenitore dei processi aziendali. Questo parametro non dispone di valori predefiniti. È necessario impostare monitorBFMUsers, monitorBFMGroups o entrambi.
- jmsBFMRunAsUser IDutente
- Dove IDutente è l'ID utente run-as dal registro utenti per il ruolo J2EE JMSAPIUser.
Questa proprietà è necessaria per configurare il contenitore dei processi aziendali. Questo parametro non dispone di valori predefiniti. Deve essere impostato.
- jmsBFMRunAsPwd password
- Dove password è la password per l'ID utente jmsBFMRunAsUser. Questa proprietà è necessaria per configurare il contenitore dei processi aziendali. Questo parametro non dispone di valori predefiniti. Deve essere impostato.
- adminHTMUsers userList
- Dove userList è l'elenco dei nomi utente del registro utente, cui mappare il ruolo TaskSystemAdministrator J2EE (Java 2 Enterprise Edition). Il carattere separatore è la linea verticale (|). Questa proprietà è necessaria per installare il contenitore human task. Questo parametro non dispone di valori predefiniti. È necessario impostare una o entrambe le opzioni adminHTMUsers o adminHTMGroups.
- adminHTMGroups groupList
- Dove groupList è l'elenco dei nomi dei gruppi del registro utente cui mappare il ruolo TaskSystemAdministrator J2EE.
Il carattere separatore è la linea verticale (|). Questa proprietà è necessaria per installare il contenitore human task. Questo parametro non dispone di valori predefiniti.
È necessario impostare una o entrambe le opzioni adminHTMUsers o adminHTMGroups.
- monitorHTMUsers userList
- Dove userList è l'elenco dei nomi utente, del registro utente, cui mappare il ruolo TaskSystemMonitor J2EE. Il carattere separatore è la linea verticale (|). Questa proprietà è necessaria per installare il contenitore human task. Questo parametro non dispone di valori predefiniti. È necessario impostare monitorHTMUsers, monitorHTMGroups o entrambi.
- monitorHTMGroups groupList
- Dove groupList è l'elenco dei nomi dei gruppi del registro utente cui mappare il ruolo TaskSystemMonitor J2EE. Il carattere separatore è la linea verticale (|). Questa proprietà è necessaria per installare il contenitore human task. Questo parametro non dispone di valori predefiniti. È necessario impostare monitorHTMUsers, monitorHTMGroups o entrambi.
- jmsHTMRunAsUser IDutente
- Dove userID is the run-as user
ID from the user registry for the J2EE role EscalationUser.
Questa proprietà è necessaria per configurare il contenitore human task. Questo parametro non dispone di valori predefiniti. Deve essere impostato.
- jmsHTMRunAsPwd password
- Dove password è la password per l'ID utente jmsHTMRunAsUser. Questa proprietà è necessaria per configurare il contenitore human task. Questo parametro non dispone di valori predefiniti. Deve essere impostato.
- contextRootBFM contextRootBFM
- Dove contextRootBFM è la root di contesto per l'URL dell'endpoint del servizio Web. Per BFM (Business Flow Manager), su un server, la root di contesto predefinita è /BFMIF_${nomenodo}_${nomeserver}.
Su un cluster è /BFMIF_${nomecluster}.
Deve essere impostato.
- contextRootHTM contextRootHTM
- Dove contextRootHTM è la root di contesto per l'URL dell'endpoint dei servizi Web. Per HTM (Human Task Manager), su un server, la root di contesto predefinita è /HTMIF_${nomenodo}_${nomeserver}.
Su un cluster è /HTMIF_${nomecluster}.
Deve essere impostato.
- mailServerName mailServerName
- Dove mailServerName è il nome host del server di posta utilizzato da Human Task Manager per inviare e-mail di notifica. Questo parametro è necessario per la configurazione della sessione di posta. Se non viene impostato, la configurazione della sessione di posta verrà ignorata. Il valore predefinito è il nome host completo dell'host locale.
- mailUser mailUserID
- Dove mailUserID è l'ID utente per accedere al server di posta. È necessario creare la sessione di posta affinché Human Task Manager invii e-mail di notifica. Il valore predefinito è vuoto, che è appropriato solo se non è richiesta alcuna autenticazione.
- mailPwd mailPassword
- Dove mailPassword è la password per accedere al server di posta. È necessario creare la sessione di posta affinché Human Task Manager invii e-mail di notifica.
- hostName explorerVirtualHostname
- Dove explorerVirtualHostname è l'host virtuale in cui verrà eseguito Business Process Choreographer Explorer. Il valore predefinito è default_host.
- explorerHost explorerURL
- Dove explorerURL è l'URL di Business Process
Choreographer Explorer. Se questo parametro non è specificato per gli ambienti non in cluster, viene calcolato un valore predefinito, ad esempio, http://localhost:9080.
Il valore di questo parametro viene utilizzato per la proprietà personalizzata EscalationMail.ClientDetailURL
di Human Task Manager.
- precompileJSPs {
yes | no }
- Stabilisce se JSP (Java Server Pages) verrà precompilato o meno.
- remoteNodeName nodeName
- Utilizzare questo parametro e remoteServerName se non si desidera connettersi a Business Process Choreographer Explorer locale. Non specificare questo parametro se si desidera connettersi al server Business Process Choreographer identificato dai parametri node e server o dal parametro cluster.
- remoteServerName serverName
- Utilizzare questo parametro e remoteNodeName se non si desidera connettersi a Business Process Choreographer Explorer locale. Non specificare questo parametro se si desidera connettersi al server Business Process Choreographer identificato dai parametri node e server o dal parametro cluster.
- remoteClusterName clusterName
- Utilizzare questo parametro se non si desidera connettersi a Business
Process Choreographer Explorer locale e non specificare remoteNodeName e remoteServerName. Non specificare questo parametro se si desidera connettersi al server Business Process Choreographer identificato dai parametri node e server o dal parametro cluster.
- contextRootExplorer contextRootExplorer
- Dove contextRootExplorer è la root di contesto per Business Process Choreographer Explorer. Il valore predefinito è /bpc, che compone l'URL predefinito http://host:porta/contextRootExplorer. La root di contesto deve essere univoca nella cella di WebSphere.
- createDB { yes |
no }
- I valori possibili sono yes o no.
se impostato su yes, lo script crea il
database. Per database z/OS e Oracle, questo script non può creare il database,
può solo creare gli spazi di tabella e le tabelle. Per altri tipi di database, il valore predefinito è yes.
- dbType databaseType
- Dove databaseType è il tipo di database. Questo parametro è necessario per installare il contenitore dei processi aziendali, per la creazione del database o delle tabelle di database e per la creazione dell'origine dati. Questo parametro non dispone di valori predefiniti. I valori possibili sono:
- Cloudscape
- DB2
- zOS-DB2
- Informix
- MSSQL
- Oracle
- dbVersion versione
- Dove versione è il numero di versione del database. Non dispone di un valore predefinito. È necessario solo per i seguenti tipi di database:
- Per DB2 per z/OS il valore della versione deve essere 7 o 8.
- Per Oracle il valore della versione deve essere 9 o 10.
- Per MSSQL il valore della versione deve essere 2000 se il database non dispone di supporto Unicode, o 200U se il database dispone di supporto
Unicode.
- dbHome databaseInstallPath
- Dove databaseInstallPath è la directory di installazione del sistema di database. Viene utilizzato per creare il database o le tabelle di database e per la creazione dell'origine dati. Il valore predefinito e i requisiti dipendono dal database e dalla piattaforma:
- Per DB2:
- Su piattaforme Windows, il valore predefinito è current_drive\Program
Files\IBM\SQLLIB dove current_drive è la lettera dell'unità corrente.
- Su piattaforme Solaris, il valore predefinito è /export/home/${dbUser}/sqllib.
- Su altre piattaforme, il valore predefinito è /home/${dbUser}/sqllib.
È necessario che esistano le directory ${dbHome}/bnd e ${dbHome}/bin.
- Per Informix:
- Su piattaforme Windows, il valore predefinito è unità_corrente\Program
Files\Informix, dove unità_corrente è la lettera dell'unità corrente.
- Su piattaforme Solaris e HP-UX il valore predefinito è /opt/informix.
- Su piattaforme Linux e AIX il valore predefinito è /usr/informix.
Iil file ${dbHome}/jdbc/lib/ifxjdbc.jar deve esistere.
- Per Oracle:
- Su piattaforme Windows, il valore predefinito è c:\oracle\ora90.
- Su piattaforme Solaris, il valore predefinito è /opt/oracle.
- Su altre piattaforme, il valore predefinito è /usr/oracle.
È necessario che il file ${dbHome}/jdbc/lib/odbc14.jar esista.
- dbJava JDBCDriverPath
- Dove JDBCDriverPath è la directory in cui si trova il driver JDBC. Questo parametro è necessario solo per le seguenti combinazioni di tipi di driver e database:
- DB2 con un driver di tipo 4. Il valore predefinito è ${dbHome}/java.
- DB2 per z/OS, con un driver di tipo 4. Il valore predefinito è ${dbHome}/classes.
- MSSQL DataSource con il tipo di driver DataDirect. Questo parametro non dispone di valori predefiniti.
- Oracle. Il valore predefinito è ${dbHome}/jdbc/lib.
- dbName databaseName
- Dove databaseName è il nome del database di Business Process
Choreographer. Viene utilizzato per creare il database o le tabelle di database e per la creazione dell'origine dati. Per Oracle, è TNS. Il valore predefinito è BPEDB.
- dbUser databaseUser
- Dove databaseUser è l'ID utente per accedere al database.
Viene utilizzato per creare le tabelle di database e l'origine dati. Il valore predefinito dipende dal database e dalla piattaforma:
- Per DB2 su piattaforme Windows: "db2admin"
- Per DB2 su altre piattaforme: "db2inst1"
- Per Oracle: "sistema"
- Per MSSQL: <utente al momento collegato>
- dbPwd databasePassword
- Dove databasePassword è la password per l'ID utente databaseUser.
- dbAdmin databaseAdministratorUserID
- Dove databaseAdministratorUserID è l'ID utente dell'amministratore del database. Viene richiesto solo durante la creazione del database e delle tabelle di database per i seguenti tipi di database su piattaforme Linux e UNIX:
- Per DB2 su z/OS, il valore predefinito è db2inst1.
- Per Oracle, il valore predefinito è oracle.
- driverType JDBCDriverType
- Dove JDBCDriverType è il tipo di driver JDBC. Viene utilizzato per creare l'origine dati.
- Per DB2, i valori possibili sono Universal o CLI.
- Per Oracle, i valori possibili sono oci8 o thin.
Inoltre, viene utilizzato per l'installazione del contenitore dei processi aziendali.
- Per MSSQL, i valori possibili sono Embedded o DataDirect.
- dbTablespaceDir databaseTablespacePath
- Dove databaseTablespacePath è la directory in cui vengono creati gli spazi di tabella del database. Viene utilizzato per creare il database e le tabelle di database. Questo parametro viene richiesto solo per i seguenti tipi di database:
- Per Oracle, non esiste un valore predefinito. È necessario fornire un valore.
- Per DB2, il valore predefinito è vuoto, ovvero non sono stati creati spazi di tabella.
- dbServerName databaseServerName
- Dove databaseServerName è il server del nome host in cui si trova il database di Business Process Choreographer. Viene utilizzato per creare l'origine dati.
- Per DB2, il valore predefinito è vuoto.Per DB2 UDB, questo parametro è facoltativo e se non è specificato, verrà configurato un tipo 2 di driver JDBC, altrimenti verrà configurato un provider JDBC di tipo 4.
- Per tutti gli altri tipi di database, il valore predefinito è il nome host completo dell'host locale.
- dbServerPort databaseServerPort
- Dove databaseServerPort è la porta TCP/IP del server di database per Business Process Choreographer. Questo parametro è richiesto se è specificato dbServerName.
- Per DB2 il valore predefinito è 50000.
- Per Informix il valore predefinito è 1526.
- Per MSSQL il valore predefinito è 1433.
- Per Oracle con il tipo di driver thin, il valore predefinito è 1521.
- dbStorageGroup DB2zOSStorageGroup
- Dove DB2zOSStorageGroup è il gruppo di memorizzazione utilizzato per creare la tabella di database di Business Process Choreographer. Questo parametro è richiesto solo per DB2 su z/OS. Non esiste un valore predefinito, ma non deve essere vuoto.
- dbSubSystem DB2zOSSubSystem
- Dove DB2zOSSubSystem è il sottosistema DB2 utilizzato per creare la tabella di database e l'origine dati di Business Process Choreographer.
Questo parametro è richiesto solo per DB2 su z/OS. Il valore predefinito è BPEDB.
- dbSQLID DB2zOSSchemaQualifier
- Dove DB2zOSSchemaQualifier è il qualificatore di schema utilizzato per creare le tabelle di database. Questo parametro è richiesto solo per DB2 su z/OS. Questo parametro non dispone di valori predefiniti. Il valore può essere vuoto. Specificare solo un valore quando si utilizza il tipo di driver JDBC Universal.
- dbInstance InformixInstance
- Dove InformixInstance è il nome dell'stanza per un database Business
Process Choreographer. Il valore predefinito è ids1.
- mqType JMSProviderType
- Dove JMSProviderType è il tipo di provider JMS (Java Message Service) da utilizzare per Business Process Choreographer. Viene utilizzato per creare il gestore code e le code, le porte di ascolto o ActivationSpecs, oltre
alle produzioni di connessione code.
Dove JMSProviderType è uno dei seguenti valori:
- WPM
- Per la messaggistica predefinita (WebSphere Platform Messaging). Questa opzione è sempre disponibile.
- MQSeries
- Per WebSphere MQ. Questa opzione richiede che sia installato il prodotto WebSphere MQ.
- createQM { yes | no})
- Controlla se lo script crea un gestore code WebSphere MQ locale.Questa opzione viene applicata solo se il parametro
mqType ha il valore MQSeries. Il valore predefinito per questo parametro è sì. Utilizzare il valore no se non si desidera che lo script crei il gestore code WebSphere MQ, ad esempio se si desidera creare il gestore code su un server diverso da quello in cui si sta eseguendo lo script.
- qmNameGet getQueueManagerName
- Dove getQueueManagerName è il nome del gestore code per le richieste GET. Viene utilizzato per creare il gestore code, le code, oltre alle porte di ascolto e alle produzioni di connessione code. Non deve contenere il carattere -. Il valore predefinito per getQueueManagerName è BPC_nodeName_serverName. Questa opzione viene applicata solo se il parametro
mqType ha il valore MQSeries.
- mqClusterName appServerClusterName
- Dove appServerClusterName è il nome del cluster di WebSphere
Application Server in cui devono essere creati i motori di messaggistica del provider JMS. Ciò non ha legami con un cluster WebSphere MQ. Questa opzione viene utilizzata solo per la configurazione di
Business Process Choreographer in un cluster e l'opzione mqType viene impostata su WPM.
- qmNamePut putQueueManagerName
- Dove putQueueManagerName è il nome del gestore code per le richieste PUT. Viene utilizzato solo quando viene impostato il parametro mqClusterName. Viene utilizzato per creare il gestore code, le code, oltre alle porte di ascolto e alle produzioni di connessione code. Non deve contenere il carattere - e non deve essere uguale al nome del gestore code specificato per il parametro qmNameGet. Il valore predefinito per putQueueManagerName è BPCC_nodeName_serverName.
- mqHome MQInstallationDirectory
- Dove MQInstallationDirectory è la directory
di installazione di WebSphere MQ. Questa operazione è utilizzata per creare il gestore code e le code
(solo sistemi Windows) e le porte di ascolto e le produzioni connessioni delle code. Se è impostata la variabile di WebSphere MQ_INSTALL_ROOT, viene utilizzato il relativo valore, pertanto non viene modificata. Questa opzione viene applicata solo se il parametro
mqType ha il valore MQSeries.
Se
MQ_INSTALL_ROOT non è impostato, il valore predefinito utilizzato per MQInstallationDirectory dipende dalla piattaforma:
- Sistemi Windows:
- current_drive\Program Files\IBM\WebSphere
MQ
- AIX:
- /usr/mqm
- Solaris e HP-UX:
- /opt/mqm
- mqUser JMSProviderUserID
- Dove JMSProviderUserID è l'ID utente per accedere al provider
JMS.
- Se mqType ha il valore WPM, questo parametro viene utilizzato per creare ActivationSpecs e le produzioni connessioni, il valore predefinito è costituito dall'utente al momento collegato.
- Se mqType ha il valore MQSeries, questo parametro viene utilizzato su piattaforme non Windows per creare il gestore code e le code. Il valore predefinito per JMSProviderUserID dipende dalla piattaforma.
- Sistemi Windows:
- currently_logged-on_user
- Sistemi Linux e UNIX
- mqm
- mqPwd JMSProviderPassword
- Dove JMSProviderPassword è la password dell'ID utente per mqUser. Questo parametro non dispone di valori predefiniti.
- mqSchemaName mqSchemaName
- Dove mqSchemaName è il nome dello schema di database per il motore di messaggistica del provider JMS predefinito. Il valore predefinito è BPEME. Questa opzione viene utilizzata solo per la configurazione di
Business Process Choreographer in un cluster e l'opzione mqType viene impostata su WPM.
- mqCreateTables { true |
false}
- Questo parametro Booleano controlla se il provider JMS predefinito crea le relative tabelle nel database del motore di messaggistica alla prima connessione
Il valore predefinito è true. Questa opzione viene utilizzata solo per la configurazione di
Business Process Choreographer in un cluster e l'opzione mqType viene impostata su WPM.
- mqDataSource datasourceName
- Dove datasourceName è il nome JNDI dell'origine dati da utilizzare dal motore del provider di messaggistica predefinito JMS. Deve trattarsi di un'origine dati a livello di cluster in WebSphere identificato da mqClusterName.
Il database sottostante per il provider JMS predefinito deve essere creato manualmente. Questa opzione viene utilizzata solo per la configurazione di
Business Process Choreographer in un cluster e l'opzione mqType viene impostata su WPM.
- shell shell
- Su piattaforme UNIX e Linux, questo parametro determina la shell che viene utilizzata per eseguire i comandi esterni. Il valore predefinito è /bin/sh.
- createEventCollector { yes
| no}
- In esecuzione il modalità batch, il valore predefinito è yes, che implica la configurazione dell'applicazioneo del raccoglitore di eventi di Business Process Choreographer,
richiesta da Business Process Choreographer Observer. Se non si desidera installarlo, impostare il valore del parametro su no.
- createObserver { yes | no}
- Quando in esecuzione in modalità batch, il valore predefinito è yes, che configura l'applicazione di Business Process Choreographer Observer.
Se non di desidera installarlo, impostare il valore del parametro su no.
Esecuzione dello script di configurazione in modo interattivo
Questo esempio illustra l'esecuzione dello script bpeconfig per
installare e configurare il contenitore dei processi aziendali che utilizza un database DB2 esistente,
un contenitore human task e Business Process Choreographer Explorer.
- Sul server, o per ND, sul gestore distribuzione, avviare lo script:
- Sui sistemi UNIX e Linux, immettere il seguente comando:
install_root/bin/wsadmin.sh
-f install_root/ProcessChoreographer/sample/bpeconfig.jacl
( [-user userName][-password password]|[-conntype NONE])
[-profileName profileName]
- Su sistemi Windows, immettere il comando:
install_root\bin\wsadmin.bat
-f install_root\ProcessChoreographer\sample\bpeconfig.jacl
( [-user userName][-password password]|[-conntype NONE])
[-profileName profileName]
- Immettere interattivamente le risposte alle domande che vengono visualizzate:
- In un ambiente ND, verrà proposto un cluster da configurare. Se non si tratta del cluster corretto, immettere No in modo che venga proposto il cluster successivo.
Se si tratta del cluster corretto, immettere Yes.
- Per la domanda Install the business process container?,
immettere Yes.
- Per la domanda User(s) to add to role BPESystemAdministrator,
immettere gli ID utente per gli utenti che eseguiranno il ruolo di amministratore processo aziendale.
- Per la domanda Group(s) to add to role BPESystemAdministrator,
immettere i gruppi dal registro dell'utente di dominio che sono stati mappati al ruolo di amministratori del processo.
- Per la domanda User(s) to add to role BPESystemMonitor,
immettere gli ID utente degli utenti che avranno il ruolo di monitorare il processo aziendale.
- Per la domanda Group(s) to add to role BPESystemMonitor,
immettere i gruppi dal registro dell'utente di dominio mappati al ruolo di monitor di processo aziendale.
- Se si ottiene la domanda Use WebSphere default messaging
or WebSphere MQ, immettere una delle due opzioni visualizzate.
- Per la domanda Run-as UserId for role JMSAPIUser,
immettere l'ID utente run-as che verrà utilizzato per il ruolo JMSAPIUser.
- Immettere la password per l'ID utente run-as.
- Per la domanda Use
a DB2, an Informix, an Oracle, or an SQL Server database [DB2/Informix/Oracle/MSSQL]?,
per questo esempio, immettere DB2. Se si seleziona un database diverso, vengono effettuate altre domande specifiche a quel database.
- Per la domanda Use WebSphere default messaging
or WebSphere MQ [WPM/MQSeries]?, selezionare il provider JMS da utilizzare.
- Se è stato selezionato WOM (WebSphere Platform Messaging), immettere anche quanto segue:
- Per la domanda Virtual Host for the SCA Web Service
[default_host]: , premere Invio per accettare il valore predefinito default_host.
- Per la domanda Context root for the SCA Web Service
[/BFMIF_PNODE_server1]:, premere Invio per accettare il valore predefinito /BFMIF_PNODE_server1.
- Per la domanda Create the DataSource for the
Process Choreographer database?,
immettere Yes.
- Immettere il nome del database.
- Per la domanda Universal or CLI?, immettere il tipo di driver JDBC.
- Per la domanda DB2 User ID, immettere l'ID utente utilizzato per creare le tabelle e lo schema di database.
- Per la domanda Database server name (may be empty,
set to use the type 4 driver), immettere il nome del server in cui si trova il database.
- Per la domanda Database server port,
immettere la porta del server del database, ad esempio 50000.
- Per la domanda Create the Process Choreographer
database?, se l'ID utente ha privilegi sufficienti per creare il
database è possibile immettere Yes, diversamente, se il database
già esiste o se l'ID utente non ha privilegi sufficienti per creare il database, immettere No.
- Per la domanda DB2 tablespace directory (may
be empty) immettere la directory per lo spazio di tabella o lasciarla vuota.
- Per la domanda Create the ActivationSpecs for
the business flow manager?, immettere Yes o No.
- Se si ottiene la domanda User ID for access to default
messaging, immettere l'ID utente da utilizzare per accedere al provider JMS predefinito.
- Se si ottiene la domanda Name of the message engine
cluster, immettere il nome del cluster del motore di messaggistica.
- Se si ottiene la domanda Name of the message engine
database schema, immettere il nome dello schema di database del motore di messaggistica.
- Se si ottiene la domanda Automatically create the
message engine database tables [true/false]?, immettere true per creare automaticamente le tabelle di database del motore di messaggistica, altrimenti immettere false.
- Se si ottiene la domanda Message engine datasource
JNDI name, immettere il nome JNDI dell'origine dati del motore di messaggistica.
- Per la domanda Install the task container?,
immettere Yes.
- Per la domanda User(s) to add to role TaskSystemAdministrator,
immettere gli ID utente per degli utenti che eseguiranno il ruolo di amministratore dell'attività.
- Per la domanda Group(s) to add to role TaskSystemAdministrator,
immettere i gruppi dal registro utente di dominio che sono mappati al ruolo dell'amministratore dell'attività.
- Per la domanda User(s) to add to role TaskSystemMonitor,
immettere gli ID utente per gli utenti che eseguono il ruolo per monitorare l'attività.
- Per la domanda Run-as UserID for role EscalationUser,
immettere l'ID utente run-as per il ruolo dell'utente dell'escalation, ad esempio db2admin.
- Per la domanda Context root for the SCA Web Service
[/HTMIF_PNODE_server1]: , immettere la root del contesto per il server web SCA (Service Component Architecture)
o premere Invio per accettare il valore predefinito.
- Per la domanda Create the mail notification session
for the human task manager?, immettere No se non si desidera creare la sessione di posta di notifica per Human Task Manager.
Altrimenti, immettere Yes, quindi specificare l'host di trasferimento di posta e l'ID utente.
- Per la domanda Create the ActivationSpecs for
the human task manager?, immettere Yes per creare
J2EE ActivationSpecs per MDB di Human Task Manager, altrimenti immettere No.
- Se si ottiene la domanda Configure in cluster 'MECluster'
[Yes/no]?, immettere Yes per effettuare la configurazione nel cluster specificato, altrimenti immettere No.
- Se si ottiene la domanda Add JDBC provider permissions
to server.policy [Yes/no]?, immettere Yes per aggiungere automaticamente
le autorizzazioni per il provider JDBC provider per il file server.policy,
altrimenti immettere No.
- Per la domanda Install the Business Process Choreographer
Explorer?, immettere Yes per installare Business Process
Choreographer Explorer, per Host virtuale per Business
Process Choreographer Explorer immettere il nome dell'host virtuale per Business Process Choreographer Explorer, ad esempio host_predefinito,
per la domanda Precompile JSPs?, immettere Yes se si desidera precompilare JSP (Java Server Pages), altrimenti immettere No. Per Business Process Choreographer Explorer remoto,
per la domanda Node of Process Choreographer to connect
to [PNODE]: immettere il nome del nodo di Business Process Choreographer
da connettere e per la domanda Server of
Process Choreographer to connect to [server1]: immettere il nome del server
Business Process Choreographer da connettere o premere Invio per accettare il valore predefinito.
- Se si ottiene la domanda Context root for the Business
Process Choreographer Explorer [/bpc]:, immettere la root di contesto per Business Process Choreographer Explorer o premere Invio per utilizzare il valore predefinito /bpc.
- Per la domanda Create aliases for your_server in
host your_host?, immettere Yes per creare gli alias per il server nell'host virtuale, altrimenti immettere No.
- Vengono visualizzate diverse informazioni, ad esempio l'URL di Business Process Choreographer Explorer e promemoria in cui trovare i file di script che è possibile utilizzare per configurare Business Process Choreographer Observer.
- Per la domanda Enable global security using the
Local OS user registry?, immettere Yes per abilitare la sicurezza globale utilizzando il registro utente del sistema operativo locale, altrimenti immettere No.
- Per la domanda Server user ID, immettere l'ID utente del server.
- Per la domanda Enforce Java 2 security?,
immettere Yes per implementare la sicurezza Java 2, altrimenti immettere No.
- Per la domanda Set 'com.ibm.SOAP.loginUserid'
in soap.client.props?, immettere Yes per impostare l'ID utente di login nelle proprietà cliente SOAP, altrimenti immettere No.
- Per la domanda Delete the temporary directory?,
immettere Yes per eliminare la directory temporanea specificata, altrimenti immettere No.
- In caso di problemi, verificare i file di log.
File di log
Se si verificano problemi durante la creazione della configurazione utilizzando il file script bpeconfig.jacl, verificare i seguenti file di log:
- bpeconfig.log
- wsadmin.traceout
È possibile trovare entrambi i file nella directory log per il profilo:
- Sui sistemi Linux e UNIX: nella directory install_root/profiles/profileName/logs/
- Su sistemi Windows: nella directory install_root\profiles\profileName\logs\
Se si esegue lo script in modalità connessa, verificare anche i file
SystemOut.log e
SystemErr.log che si trovano nella directory secondaria della directory
logs denominata dopo il nome del server.