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

Use the bpeconfig.jacl script to configure Business Process Archive Manager

You can use the bpeconfig.jacl script to configure a Business Process Archive Manager, Business Process Archive Explorer, and all the necessary resources on a given server or cluster.

You can also use this script to configure a Business Process Choreographer configuration, that case is described in Use the bpeconfig.jacl script to configure Business Process Choreographer.

The script uses the database parameters to generate and optionally run an SQL file, which creates the necessary database objects.


Procedure

  1. Verify that you know which options and parameters you are going to use. Refer to the values you planned in Plan for the Business Process Archive Manager. For detailed information about the script, examples, its options and parameters, see bpeconfig.jacl script file.

  2. Invoke the bpeconfig.jacl script file, either in batch mode providing the options and configuration parameters that you planned, or in interactive mode. For details about the script file, refer to bpeconfig.jacl script file.
  3. Restart the server or cluster where you configured Business Process Archive Manager.
  4. Verify that the Business Process Archive Manager and Business Process Archive Explorer applications have started successfully.

    1. Verify that there are no error messages in the SystemOut.log file for the application server. On a cluster, check the log for all application servers in the cluster.
    2. Verify that the following applications have started:

      • BPCArchiveExplorer_ scope
      • BPArchiveMgr_ scope
      • TaskArchiveMgr_ scope

      Where, the value of scope is nodeName_ serverName, if you configured Business Process Archive Manager on an application server, or the clusterName if you configured Business Process Archive Manager on a cluster.

  5. If you want to change the JMS authentication user IDs, the run-as user IDs, or the mappings of roles onto users and groups, using the administrative console, click Security > Business Integration security to change the security settings.

  6. If you have configured the people directory provider for the Business Process Choreographer configuration that this Business Process Archive Manager will be used for, then configure the people directory provider in the same way for the Business Process Archive Manager.
  7. Map the web modules for the BPArchiveMgr and TaskArchiveMgr applications to a web server to achieve load balancing and failover. You might need to change the default context roots for the REST API and the JAX web services API so that they are unique for each combination of host name and port. To set the context roots perform the following:

    1. To set the context roots for the Business Process Archive Manager, click Applications > Application Types > WebSphere enterprise applications then BPArchiveMgr_ scope > Context Root for Web Modules, where scope is either node_name_ server_name or the cluster_name where Business Process Archive Manager is configured. Then make sure that the context root for the web modules BFMRESTAPI and BFMIF_ scopeWeb are correct and unique.

    2. To set the context roots for the Human Task Archive Manager, click Applications > Application Types > WebSphere enterprise applications then TaskArchiveMgr_ scope > Context Root for Web Modules, where scope is either node_name_ server_name or the cluster_name where Business Process Archive Manager is configured. Then make sure that the context root for the web modules HTMRESTAPI and HTMIF_ scopeWeb are correct and unique.

  8. If you use the Business Process Archive Explorer: Change the REST endpoints to match the new context roots by clicking Application servers then either server_name or cluster_name, then under Business Integration, expand Business Process Choreographer, and click Business Process Choreographer Explorer, select the BPCArchiveExplorer_ scope instance that you want to modify, and set the new value.

    For example, if the context root for the Business Flow Manager REST API is /rest/bpm/bfm then the full URL might be something like http://system7.mycompany.com:9080/rest/bpm/bfm.

    If you mapped the modules to an HTTP server, proxy server, IP sprayer, load balancer, or similar server, the URL should be based on the hostname and port number for that server.

  9. Optional: Update your virtual host configuration. By default, the web modules of the Business Process Choreographer applications are configured for the default_host virtual host. Verify that the ports associated with the host alias are correct. You might need to add host aliases for the host names and ports of additional cluster members or for the web server that is used. For more details about virtual hosts, refer to Virtual hosts.


Results

Business Process Archive Manager and Business Process Archive Explorer are configured.