Use this task to configure the human task container.
Before you begin
Why and when to perform this task
If you have run the bpeconfig.jacl script, the human task container
is already configured. The following steps describe how to configure the human
task container using the installation wizard.
Steps for this task
- In the administrative console, select the server or cluster where
you want to install the business process container. Click one of
the following:
Where serverName or clusterName is
the name of the application server or cluster where you want to install the
human task container.
- In the Container Settings section, click (in
the Additional Properties section). Where
possible, the installation wizard offers appropriate default values in the
parameter fields, you can view the recommended values on the Human task container installation wizard settings.
- Verify that the human task container is not configured. There
should be a message indicating that the Human Task Manager is not currently
installed. If the human task container is already configured, remove the configuration
before you start the installation wizard. For details about how to remove
the configuration, see Removing the Business Process Choreographer configuration.
- Select the JMS provider and security settings (step 1):
- For the JMS user ID, the
user ID that you enter depends on your messaging system. If you
use Websphere default messaging, enter a user ID that has connect, send, receive,
and browse rights for the Business Process Choreographer bus, BPC.cellname.Bus,
and its destinations. By default, all users that are successfully authenticated
with the Websphere Application Server have these permissions. If
you use an external JMS provider, such as Websphere MQ, enter a user ID that
has connect, send, receive, and browse rights for the queue manger and queues.
- For the JMS password, enter the password for the JMS
user ID.
- For the Webservices Endpoint, enter the
Webservice endpoint for the Webservice API.
- For Escalation user ID, enter the user
ID that will be used by the human task container to perform scheduled actions,
for example triggering escalations to verify the expected task state, timed
task deletion, and task expiration.
- For Escalation password, enter the password
for the escalation user ID.
- For the Administrator security role mapping,
enter the name of the group, defined in the user registry, that will map onto
the role of Business Process Administrator. On Windows systems,
for example, you can specify the group Administrators.
- For the System monitor security role mapping,
enter the name of the group in the user registry to map onto the role of Business
Process System Monitor. On Windows systems, for example, you can
specify the group Administrators.
- Click Next to go to step 2 in the installation
wizard.
- Optional: Select Mail session to
create the default mail session resource with cell scope.
- If you are configuring the human task container on a server, the default
mail session is named mail/HTMNotification_nodeName_serverName.
- If you are configuring the human task container on a cluster, the default
mail session is named mail/HTMNotification_clusterName.
Attention: If this is not set, no escalation mails are sent.
- Optional: To use the Common Event Infrastructure, select Enable
Common Event Infrastructure logging .
- Optional: To enable the audit log, select Enable
audit logging for all human tasks .
- Click Next to view the Summary (step 3).
- Check that the information on the summary page is correct. The summary includes reminders of which external resources are necessary.
If you have not already created them, you can continue configuring the human
task container, but you must create the resources before you activate the
human task container. Printing the summary page helps you to create the correct
resources.
- To make corrections, click Previous.
- To install the human task container and define its resources,
click Finish. The progress is shown
on the Installing page.
- Verify that no error messages are displayed.
- If you selected the Mail session option in step 5,
you must set the mail transport host:
- Click .
- Select the cell scope: Built-in Mail Provider.
- Under Mail sessions, click HTMMailSession_scope,
where scope consists of the cluster name or the node and
server names, then set the Mail transport host.
- If the mail transport host is secured, also set Mail transport
user ID and Mail transport password.
- Click OK.
- Click Save Master Configuration, then click Save.
- Restart the application server.
- If the container did not install successfully, check for any error
messages that can help you correct the problem, then repeat this task.
Check the administrative console or the SystemOut.log file
for the application server. On a cluster, check the log for all application
servers in the cluster.
Result
The human task container is configured.
What to do next
Continue configuring
in the parent topic at
step
3 .