Adding an IBM BPM system to the federated environment

The server.xml template file that is provided with Process Federation Server contains sample elements that you can use as the basis for adding an IBM® BPM system to the federated environment.

Complete the following steps to add a IBM BPM system to the federated environment. For each system, configure a data source, indexing and retrieval services, and the URLs that Process Portal uses for the federated environment.

1. Open the server.xml configuration file for editing. By default, the configuration file is in the pfs_install_root/usr/servers/server_name directory on Process Federation Server.
2. Add an ibmPfs_federatedSystem element.

   This element includes general configuration properties that apply to both BPD and BPEL systems. Ensure that you specify a value for the id property.

3. Add the appropriate data source element for the IBM BPM system.
   • If the system runs BPD processes, point the data source to the Process Server database (BPMDB) that is enabled for indexing. For more information, see Enabling indexing of BPD-related data on an IBM BPM server in a federated environment.
   • If the system runs BPEL processes, point the data source to the database containing the Business Process Choreographer tables (CMNDB) that is enabled for indexing. For more information, see Enabling indexing of BPEL-related data on an IBM BPM server in a federated environment.
4. Add the appropriate index and REST retriever implementation elements for the IBM BPM system. For example, for BPD systems, add and configure the ibmPfs_bpdIndexer and ibmPfs_bpdRetriever elements. For more information about the configuration properties, see Configuration properties for the Process Federation Server index.
   • Ensure that the value of the federatedSystemRef property in the implementation elements is the same as the id property in the ibmPfs_federatedSystem element.
   • Ensure that the indexer connects directly to the IBM BPM database server by specifying a value for the dataSourceRef property.
5. Add the URLs that Process Portal uses for the federated environment. Set values for the restUrlPrefix and taskCompletionUrlPrefix properties. For more information, see Configuration properties for the Process Federation Server index.
6. Save your changes to the server.xml file and restart Process Federation Server.