Business Process Choreographer configuration

Use this panel to install and configure Business Process Choreographer.

To view this administrative console page, click either Servers > Clusters > WebSphere application server clusters > cluster name or Servers > Server Types > WebSphere application servers > server name, then on the Configuration tab, in the Business Integration section, expand Business Process Choreographer, and click 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.

Check for updates to this topic (online)

Data Source

In this section you specify the data source for Business Process Choreographer.

Edit

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.

Test Connection

Tests the connection to the data source.

Database Name

The name of the database used by the Business Flow Manager and Human Task Manager.

Property Value
Data type String
Default for DB2 The database specified in the profile.

Schema Name

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 Based on the database name.

Create Tables

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

User Name

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

Password

The password for the data source user ID.

Property Value
Data type String

Server

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

Provider

The JDBC provider for Business Process Choreographer.

Property Value
Data type Drop-down list

Human Task Manager Mail Session

In this section you specify the parameters for escalation emails.

Enable e-mail service

You must enable a mail session if the Human Task Manager will send escalation email notifications.

Property Value
Data type Check box

Mail transport host

The host name or IP address where the Simple Mail Transfer Protocol (SMTP) email service is located.

Property Value
Data type String

Mail transport user

The user ID for the email service.

If the mail server does not require authentication, you can leave this field empty.

Property Value
Data type String

Mail transport password

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

Confirm mail transport password

Enter the password again, or leave it blank if the mail server does not require authentication.

Business Process Choreographer Explorer URL

Specifies the URL used for email links to the Business Process Choreographer Explorer.

This URL is used to provide a link in generated emails so that a business administrator who receives an email notification can click the link to view the related BPEL process or human task in their web browser.

Property Value
Data type String
Example http://www.ibm.com:9080/bpc

Security

In this section you specify the mapping of functional roles to user IDs and groups, and the authentication credentials necessary for Business Process Choreographer.

Administrator Users

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

Monitor Users

The Monitor security role is mapped to the specified user IDs.

Property Value
Data type String
Example userA|userB|userC
Default Currently logged on user

Monitor Groups

The Monitor security role is mapped to the specified groups.

Property Value
Data type String
Example groupA|groupB|groupC
Default None

Administrator Groups

The administrator security role is mapped to the specified groups.

Property Value
Data type String
Example groupA|groupB|groupC
Default None

Work Basket Administrator Users

The work basket administrator security role is mapped to the specified user IDs.

Property Value
Data type String
Example userA|userB|userC
Default Use Default is selected and the currently logged-on user is used

Work Basket Administrator Groups

The work basket administrator security role is mapped to the specified groups.

Property Value
Data type String
Example groupA|groupB|groupC
Default Use Default is selected but no group is specified

Business Category Administrator Users

The business category administrator security role is mapped to the specified user IDs.

Property Value
Data type String
Example userA|userB|userC
Default Use Default is selected and the currently logged-on user is used

Business Category Administrator Groups

The business category administrator security role is mapped to the specified groups.

Property Value
Data type String
Example groupA|groupB|groupC
Default Use Default is selected but no group is specified

JMS Authentication Users

The authentication alias for the system integration bus.

Property Value
Data type String
Default Currently logged on user

JMS Authentication Password and Confirm Password

The password for the JMS authentication user ID.

Property Value
Data type String
Default None

JMS API Authentication Users

The run-as user ID for the Business Flow Manager message driven bean.

Property Value
Data type String
Default Currently logged on user

JMS API Authentication Password and Confirm Password

The password for the JMS API authentication user ID.

Property Value
Data type String
Default None

Escalation User Authentication Users

The run-as user ID for the Human Task Manager message driven bean.

Property Value
Data type String
Default Currently logged on user

Escalation User Authentication Password and Confirm Password

The password for the escalation user authentication user ID.

Property Value
Data type String
Default None

Administration job user authentication Users

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

Administration job user authentication Password and Confirm Password

The password for the administration job user authentication user ID.

Property Value
Data type String
Default None

State Observers

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.

Audit Logging

When these check boxes are selected, audit logging is enabled for the Business Flow Manager or Human Task Manager.

Common Event Infrastructure Logging

When these check boxes are selected, Common Event Infrastructure logging is enabled for the Business Flow Manager or Human Task Manager.

Task History

When selected, the state observer that records the task history for the Human Task Manager is enabled

SCA Bindings

For the Service Component Architecture (SCA) bindings, you can set the context root for the web services API.

Host

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.

Context Root for the Business Flow Manager

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

Context Root for the Human Task Manager

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

Relative Path

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

Bus

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.

Use the default configuration

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.

Bus Member Location

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

Remote destination location

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

New

This button opens the Browse deployment target page.

After selecting a deployment target, the target is added to the list of remote destination locations.

Edit

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.

Test Connection

Tests the connection to the data source.

Database Name

The name of the database.

Property Value
Data type String
Default The database specified in the profile.

Schema Name

The name of the schema to be used.

Property Value
Data type String
Default Based on the database name.

Create Tables

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

User Name

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

Password

The password for the data source user ID.

Property Value
Data type String

Server

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

Provider

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.