Using the install wizard to configure the business process container

Why and when to perform this task

You must configure the necessary resources and install the business process container before you can use it. This topic describes how to do so using the install 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, use the user ID that will be used to start WebSphere.
  2. Select 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 will be installed simultaneously on all application servers in the cluster.

    Note: When installed on a non-clustered application server, the name of the business process container will be BPEContainer_nodeName_serverName, on a cluster it will be named BPEContainer_clusterName.

  3. In the Additional Properties section, click Business Process Container.
  4. Scroll down, past the Business Process Container settings. Near the bottom of the page click on the link for the Business Process Container Install Wizard.

    Note: Where possible, the install 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.

  5. Select the database configuration:
    1. Select JDBC Providers.
    2. In the drop-down list, select the entry with the database system, system version and JDBC driver that you are using.
    3. For the Implementation class name use the default class name provided for the JDBC driver implementation.
    4. For Classpath enter the location of the Java archive (JAR) or zip file of 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.
    5. 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.
    6. Enter the Data source password for the Data source user name.
    7. Make sure that the options in the Custom properties field match your database requirements. For more information, see the install wizard settings page and the product documentation for your database system.
    8. Click Next to go to the next step in the install wizard.
  6. Select the JMS provider and security configuration:
    1. In the drop-down list for JMS provider, select the messaging service that the business process container will use.
    2. For the Queue manager, use the default provided (WAS_nodeName_serverName).
    3. If you are using external messaging (WebSphere MQ) and you have not defined the WebSphere environment variable ${MQ_INSTALL_ROOT}, make sure that the Classpath points to the MQ Java lib directory.
    4. For the JMS user ID, enter a user ID that has administration rights for the messaging service. On UNIX, use root. On Windows, use the default.
    5. For the JMS password, enter the password for the JMS user ID.
    6. For the Scheduler calendar field, if you have your own scheduler calendar, enter its JNDI name. Otherwise, if you leave it blank, the default value, com/ibm/Websphere/scheduler/calendar/DefaultUserCalendar, will be used.
    7. For the Security role mapping, enter the group from your user registry that is to be mapped onto the role of Business Process Administrator.
    8. For the JMS API user ID, enter the user ID that is to be used when processing asynchronous API calls.
    9. For the JMS API password, enter the password for the JMS API User ID.
    10. Click Next to go to the next step in the install wizard.
  7. To select the JMS resources, either select Create new JMS resources using default values and click Next, 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.
  8. Click Next to view the summary page.
  9. Check that the information on the summary page is correct.

    Note: 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 will help 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.
  10. The progress is shown on the Installing page:
    1. If the container did not install successfully, check for any error messages that can help you correct the problem, then repeat this task from step 1.
    2. If the container was installed successfully, click Save Master Configuration, then click Save.

Related reference
Business process container install wizard settings



Searchable topic ID:   t2cow
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/workflow/tasks/t2cow.html

Library | Support | Terms of Use | Feedback