Use this panel to install and configure Business Process Choreographer.
To view this administrative console page, click either Configuration tab, in the Business Integration section, expand Business Process Choreographer, and click or , then on the Business Process Choreographer Containers.
If the Service Component Architecture is not configured, a message is displayed that tells you to configure it.
Links marked (online) require access to the Internet. Each link launches a search for the topic in the online information center. When search results are listed, select the topic that corresponds best to your configuration.
Check for updates to this topic (online)
In this section you specify the data source for Business Process Choreographer.
Click this to change database-specific settings for the data source.
For some setups it is necessary to change the defaults. For example, when using a DB2 for z/OS database, to change the storage group or connection pool settings.
Tests the connection to the data source.
The name of the database used by the Business Flow Manager and Human Task Manager.
Property | Value |
---|---|
Data type | String |
Default for Derby Embedded | WPRCSDB |
Default for DB2 | BPEDB |
Default for iSeries | *SYSBAS or *LOCAL |
The name of the schema to be used.
You only need to change the schema name if you want to use your own schema instead of the default schema.
Property | Value |
---|---|
Data type | String |
Default | WPRBE01 |
If selected, the tables will be created automatically the first time that the database is accessed. For this option to work, the database must already exist, and the user name provided must have the authority to create tables and indexes in the database.
For a production system, it is not recommended to use this option. If you do not select this option, the tables will not be created automatically, and you must create the tables manually by running scripts.
Property | Value |
---|---|
Data type | Check box |
Default | Selected |
A user ID that has the authority to connect to the database and to modify the data.
If the user ID has the authority to create tables and indexes in the database, then the option to create the tables automatically can be used, and when necessary, the database schema will be updated automatically after applying a service or fix pack.
Property | Value |
---|---|
Data type | String |
The password for the data source user ID.
Property | Value |
---|---|
Data type | String |
The address of the database server.
Specify either the host name or the IP address, and the port number.
Property | Value |
---|---|
Data type | String |
Example | localhost:50000 |
The JDBC provider for Business Process Choreographer.
Property | Value |
---|---|
Data type | Drop-down list |
In this section you specify the parameters for escalation e-mails.
You must enable a mail session if the Human Task Manager will send escalation e-mail notifications.
Property | Value |
---|---|
Data type | Check box |
The host name or IP address where the Simple Mail Transfer Protocol (SMTP) e-mail service is located.
Property | Value |
---|---|
Data type | String |
The user ID for the e-mail service.
If the mail server does not require authentication, you can leave this field empty.
Property | Value |
---|---|
Data type | String |
Password for the mail transport user ID.
If the mail server does not require authentication, you can leave this field empty.
Property | Value |
---|---|
Data type | String |
Enter the password again, or leave it blank if the mail server does not require authentication.
Specifies the URL used for e-mail links to the Business Process Choreographer Explorer.
This URL is used to provide a link in generated e-mails so that a business administrator who receives an e-mail notification can click on the link to view the related business process or human task in their Web browser.
Property | Value |
---|---|
Data type | String |
Example | http://www.ibm.com:9080/bpc |
In this section you specify the mapping of functional roles to user IDs and groups, and the authentication credentials necessary for Business Process Choreographer.
The administrator security role is mapped to the specified user IDs.
Property | Value |
---|---|
Data type | String |
Example | userA|userB|userC |
Default | Currently logged on user |
The administrator security role is mapped to the specified groups.
Property | Value |
---|---|
Data type | String |
Example | groupA|groupB|groupC |
Default | None |
The system monitor security role is mapped to the specified user IDs.
Property | Value |
---|---|
Data type | String |
Example | userA|userB|userC |
Default | Currently logged on user |
The system monitor security role is mapped to the specified groups.
Property | Value |
---|---|
Data type | String |
Example | groupA|groupB|groupC |
Default | None |
The authentication alias for the system integration bus.
Property | Value |
---|---|
Data type | String |
Default | Currently logged on user |
The password for the JMS authentication user ID.
Property | Value |
---|---|
Data type | String |
Default | None |
The run-as user ID for the Business Flow Manager message driven bean.
Property | Value |
---|---|
Data type | String |
Default | Currently logged on user |
The password for the JMS API authentication user ID.
Property | Value |
---|---|
Data type | String |
Default | None |
The run-as user ID for the Human Task Manager message driven bean.
Property | Value |
---|---|
Data type | String |
Default | Currently logged on user |
The password for the escalation user authentication user ID.
Property | Value |
---|---|
Data type | String |
Default | None |
The run-as user ID used to run administrative jobs such as cleanup service jobs and migrating running process instances. This user ID must be in the Administrator role.
Property | Value |
---|---|
Data type | String |
Default | Currently logged on user |
The password for the administration job user authentication user ID.
Property | Value |
---|---|
Data type | String |
Default | None |
In this table you can enable audit logging and Common Event Infrastructure (CEI) logging for the Business Flow Manager and Human Task Manager. For the Human Task Manager you can also enable the Task History.
When these check boxes are selected, audit logging is enabled for the Business Flow Manager or Human Task Manager.
When these check boxes are selected, Common Event Infrastructure logging is enabled for the Business Flow Manager or Human Task Manager.
When selected, the state observer that is required by the Business Process Choreographer Explorer reporting function is enabled.
For the Service Component Architecture (SCA) bindings, you can set the context root for the Web services API.
This read-only field illustrates the contextual prefix of the hosts for the Business Flow Manager and the Human Task Manager bindings to which the context roots are appended.
The context root for the Business Flow Manager Web service.
Property | Value |
---|---|
Data type | String |
Default when configured on a server | /BFMIF_nodeName_serverName |
Default when configured on a cluster | /BFMIF_clusterName |
The context root for the Human Task Manager Web service.
Property | Value |
---|---|
Data type | String |
Default when configured on a server | /HTMIF_nodeName_serverName |
Default when configured on a cluster | /HTMIF_clusterName |
This read-only field shows the relative paths for the SCA bindings for the Business Flow Manager and the Human Task Manager.
Property | Value |
---|---|
Data type | Read-only string |
Relative path for the Business Flow Manager | /sca/com/ibm/bpe/spi/sca/BFMWS |
Relative path for the Human Task Manager | /sca/com/ibm/task/spi/sca/HTMWS |
If you want to use a different data source for the Business Process Choreographer messaging engine than you configured for the Service Component Architecture (SCA), expand this section to change the settings.
If selected, the current configuration settings of the SCA messaging engine will be used.
If you want to use different settings, clear the check box to enable the other fields in this section.
Determines whether the messaging engine's data will be stored locally or remotely.
Select between Local and Remote. If you select Remote, the remote destination location selector and the New button are enabled.
Property | Value |
---|---|
Data type | Radio buttons |
Default | Local |
Specifies the deployment target for the remote messaging engine store.
If the list is empty, or does not contain the location that you want to select, click New.
Property | Value |
---|---|
Data type | Drop-down list |
Default | None |
This button opens the Browse deployment target page.
After selecting a deployment target, the target is added to the list of remote destination locations.
Click this to change database-specific settings for the data source.
For some setups it is necessary to change the defaults. For example, when using a DB2 for z/OS database, to change the storage group or connection pool settings.
Tests the connection to the data source.
The name of the database.
Property | Value |
---|---|
Data type | String |
Default | WPRCSDB |
The name of the schema to be used.
Property | Value |
---|---|
Data type | String |
Default | WPRBM00 |
If selected, the tables will be created automatically the first time that the database is accessed. For this option to work, the database must already exist, and the user name provided must have the authority to create tables and indexes in the database.
If not selected, the tables will not be created automatically, and you must create the tables manually by running scripts. For a production system, you might prefer not to have the default tables that are created by this option.
Property | Value |
---|---|
Data type | Check box |
Default | Selected |
A user ID that has the authority to connect to the database and to modify the data.
If the user ID has the authority to create tables and indexes in the database, then the option to create the tables automatically can be used, and when necessary, the database schema will be updated automatically after applying a service or fix pack.
Property | Value |
---|---|
Data type | String |
The password for the data source user ID.
Property | Value |
---|---|
Data type | String |
The address of the database server.
Specify either the host name or the IP address, and the port number.
Property | Value |
---|---|
Data type | String |
Example | localhost:50000 |
The JDBC provider for the Business Process Choreographer messaging engine.
If you configured SCA to use a file store, this field is set to File Store and the fields for the database parameters are not available. When a database provider is selected, the database parameters are available.
Property | Value |
---|---|
Data type | Drop-down list |
Default | The provider that you configured for SCA. |