Using the installation wizard to configure the business process container

Use this task to configure the business process container.

Why and when to perform this task

This describes how to configure the business process container using the installation wizard.

Steps for this task

  1. Make sure that you are logged on to the administrative console with a user ID with sufficient administration rights. On Windows® platforms, use the user ID that is used to start WebSphere® Process Server.
  2. Click Servers > Application Servers > serverName.

    Where serverName is the name of the application server where you want to install the business process container. In a cluster, you can select any application server, and the business process container is installed simultaneously on all of the application servers in the cluster.

    Note: When installed on a non-clustered application server, the name of the business process container is BPEContainer_nodeName_serverName, on a cluster it is named BPEContainer_clusterName.
  3. Go to the Business Process Container settings. On the Configuration tab, under Container Settings, expand Business process container settings, and click Business process container.
  4. Verify that the business process container is not installed. There should be a message indicating that the business process container is not currently installed. If the business process container is already installed, uninstall the application and delete all its resources before starting the installation wizard.
  5. Start the installation wizard. In the Additional Properties section, click the link Business process container installation wizard.
    Note: Where possible, the installation wizard offers appropriate default values in the parameter fields. However, with some combinations of browser and platform, no defaults are provided. In this case, you can view the recommended values on the Install wizard settings page.
  6. Select the database configuration (wizard step 1):
    1. In the JDBC Providers drop-down list, select the entry with the database system, system version and Java™ Database Connectivity (JDBC) driver that you are using.
    2. For the Implementation class name use the default class name that is provided for the JDBC driver implementation.
    3. For Classpath enter the location of the Java archive (JAR) or the zipped file that contains the JDBC driver. To use the path variable that is displayed in the text field, you must set it explicitly in Environment > Manage WebSphere Variables.
    4. The Data source user name must be a user ID that has the authority to connect to the database and to manipulate the data. If you want to have the database schema updated automatically, the user ID must also have the authority to create tables and indexes in the database.
    5. Enter the Data source password for the data source user name.
    6. Make sure that the options in the Custom properties field match your database requirements. For more information, see the Installation wizard settings page and the product documentation for your database system.
    7. Click Next to go to the next step in the installation wizard.
  7. Select the JMS provider and security (wizard step 2):
    1. In the drop-down list for JMS provider, select the messaging service for the business process container to use.
      • For default messaging, select Default messaging provider.
      • For WebSphere MQ, select WebSphere MQ.
    2. Use the default value for Queue Manager, BPC_nodeName_serverName. If you are using the default messaging provider, this field is ignored.
    3. If you are using the WebSphere MQ JMS provider and you have not defined the WebSphere environment variable ${MQ_INSTALL_ROOT}, make sure that the Classpath points to the WebSphere MQ Java lib directory.
    4. For the JMS user ID, enter a user ID that has administration rights for the messaging service. On Linux® and UNIX® systems, use root. On Windows systems, use the default.
    5. For the JMS password, enter the password for the JMS user ID.
    6. For the JMS API User ID, enter the user ID that is to be used when processing asynchronous API calls.
    7. For the JMS API Password, enter the password for the JMS API User ID.
    8. For the Administrator security role mapping, enter the group from the domain's user registry to map onto the role of Business Process Administrator.
    9. For the System monitor security role mapping, enter the group from the domain's user registry to map onto the Business Process System Monitor role.
    10. Click Next to go to the next step in the installation wizard.
  8. Select the JMS Resources and Web client (wizard step 3): Either select Create new JMS resources using default values, or perform the following:
    1. Select Select existing JMS resources.
    2. Use the Connection Factory drop-down list to select BPECF.
    3. Use the Internal Queue drop-down list to select BPEIntQueue.
    4. Use the External Request Processing Queue drop-down list to select BPEApiQueue.
    5. Use the Hold Queue drop-down list to select BPEHldQueue.
    6. Use the Retention Queue drop-down list to select BPERetQueue.
  9. To install the Business Process Choreographer Explorer, select the check box; otherwise, clear the check box. If you do not install the BPC Explorer now, you can install it later, as described in Overview: Installing, starting, and uninstalling Business Process Choreographer Explorer.
  10. To use the Common Event Infrastructure, select Enable CEI Logging .
  11. To enable the audit log, select Enable AuditLog .
  12. Click Next to view the summary (wizard step 4).
  13. 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 business process container, but you must create the resources before you activate the business process container. Printing the summary page helps you to create the correct resources.
    1. To make corrections, click Previous.
    2. To install the business process container and define its resources, click Finish. The progress is shown on the Installing page.
  14. If the container did not install successfully, check for any error messages that can help you correct the problem, then repeat this task.
  15. If the container installed successfully, click Save Master Configuration, then click Save.

Result

The business process container is configured.

Parent topic: Configuring the business process container using the wizard