IBM BPM, V8.0.1, All platforms > Install IBM BPM > IBM BPM Advanced for z/OS: Process Server > Configure IBM BPM Advanced for z/OS: Process Server > Configure components > Configure optional components > Configure Business Process Choreographer

Verifying that Business Process Choreographer works

Run the Business Process Choreographer installation verification application.


Procedure

  1. Using either the administrative console or the wsadmin command, deploy the application in INSTALL_ROOT/installableApps/bpcivt.ear.

    Restriction: In a ND environment, you can only deploy one instance of the Business Process Choreographer installation verification application.

    For example, if you have two Business Process Choreographer clusters in the same ND cell, you can deploy the bpcivt.ear application only on one of the clusters. Later, if you want to deploy it on the second cluster, first undeploy it from the first cluster. After the enterprise application is deployed, it is in the state stopped, and any process and task templates that it contains are in the state started. No process or task instances can be created until the application is started.

  2. Depending on where you configured Business Process Choreographer, make sure that either:

    • The application server is running.

    • At least one member of the cluster is running.

  3. Verify that the database system, and messaging service are running.

  4. Select the application BPCIVTApp and click Start to start the application.
  5. Verify that the application works. Using a web browser, open the following page: 
    http:// app_server_host: port_no/bpcivt
    Where app_server_host is the network name for the host of the application server and port_no is the port number used by the virtual host to which you mapped the IVT web module when installing the file bpcivt.ear. The port number depends on your system configuration. You should see a message indicating success.

  6. Optional: Stop and remove the bpcivt application.

    For more information about undeploying BPEL process and human task applications, see Undeploying BPEL process and human task applications, using the administrative console.

  7. If an error occurs, it can be caused by any of the following:

    • If Business Process Choreographer cannot access the database, check that the database system is running, that all database clients are correctly configured, and that the data source is defined correctly. Verify that the user ID and password for the data source are valid.

    • If Business Process Choreographer cannot read the input queues, check that the messaging service is running, and make sure that the JMS provider and JMS resources are defined correctly.

    • For further help, see Troubleshooting the Business Process Choreographer configuration.


Results

The basic functionality of your Business Process Choreographer configuration works.


What to do next

If you have configured other optional parts, such as the Business Process Choreographer Explorer, Business Process Choreographer Explorer reporting function, or a people directory provider, they will need to be tested separately.