Adding a business process management 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 a business process management system to the federated environment.

Complete the following steps to add a business process management 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 system.
   • If the system runs BPD processes, point the data source to the Workflow Server or Process Server database (BPMDB) that is enabled for indexing. For more information, see Enabling indexing of BPD-related data 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 in a federated environment.
4. Add the appropriate index and REST retriever implementation elements for the 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 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.