This documentation is for WSO2 API Manager 1.9.0. View documentation for the latest release.

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  1. Download WSO2 Business Process Server.  

  2. Set an offset of 2 to the default BPS port in <BPS_HOME>/repository/conf/carbon.xml file. This prevents port conflicts that occur when you start more than one WSO2 product on the same server. Also see Changing the Default Ports with Offset.

    Code Block

    Tip: If you change the BPS port offset to a value other than 2 or run the API Manager and BPS on different machines (therefore, want to set the hostname to a different value than localhost), you do the following:

    • Search and replace the value 9765 in all the files (.epr) inside <APIM_HOME>/business-processes folder with the new port (9763 + port offset.)
    • Search and replace port 9445 in <APIM_HOME>/repository/deployment/server/jaggeryapps/admin-dashboard/site/conf/site.json file with the new port (9443 + port offset.)
  3. Copy the following from <APIM_HOME>/business-processes/epr to <BPS_HOME>/repository/conf/epr folder. If the  <BPS_HOME>/repository/conf/epr  folder isn't is not there, please create it.

    • SubscriptionService.epr
    • SubscriptionCallbackService.epr
  4. Start the BPS server and log in to its management console (https://<Server Host>:9443+<port offset>/carbon).  

  5. Select Add under Processes menu and upload t he the <APIM_HOME>/business-processes/subscription-creation/BPEL/ file to BPS. This is the business process archive file.
  6. Select Add under the Human Tasks menu and upload <APIM_HOME>/business-processes/subscription-creation/HumanTask/ to BPS. This is the human task archived file.