How To - Deploy WSO2-BPS in Apache-Tomcat

  • By Denis Weerasiri
  • |
  • 23 Mar, 2011


Tested Environment

  • Ubuntu 10.04
  • WSO2BPS-2.0.2
  • Apache-Tomcat-6.0.12
  • Sun Java version "1.6.0_21"


Step 1

  • Extract the downloaded distribution of wso2bps-2.0.2 into a directory.
  • Copy repository and resources directories into a new folder. Call it carbon-repo (i.e. /opt/temp-svn/products/carbon-repo)


Step 2

  • Extract the downloaded distribution of apache-tomcat-6.0.32 into directory CATALINA_HOME.
  • Go to CATALINA_HOME\webapps directory and create a new folder, bps
  • Copy wso2bps-2.0.2/lib/core/WEB-INF to CATALINA_HOME/webapps/bps


Step 3

  • We need to enable HTTPS in Tomcat. Therefore, edit CATALINA_HOME\conf\server.xml by adding the following entry:
  • Make sure to give the exact location of wso2carbon.jks as highlighted above.


Step 4

  • We have done the configurations required in Tomcat. Now, we must do the necessary configurations in a set of configuration files shipped with WSO2 BPS. We will update carbon.xml, axis2.xml, registry.xml and user-mgt.xml which can be found at carbon-repo\repository\conf directory.
  • First, open carbon.xml and update the ServerURL and WebContextRoot elements as follows. It is required that we change the WebContextRoot to match with the web application directory name given in Step 2. In our case, it is bps.
  • We have now configured Tomcat to run on 8443 port. Save and close carbon.xml.
  • Open registry.xml and update database URL as follows:


  • Open user-mgt.xml and update database URL as follows:
  • Make sure to specify the absolute path of the WSO2CARBON_DB in both of the above elements.
  • Open axis2.xml and change the ports in the HTTP and HTTPS transport receivers as follows:


Step 5

  • Now, open a new command window and change the directory to CATALINA_HOME/bin.
  • Define an environment variable called CARBON_HOME and set the path to your carbon-repo directory.
    eg - export CARBON_HOME=/opt/temp-svn/products/carbon-repo


Denis Weerasiri
Senior Software Engineer; WSO2, Inc.
[email protected]


About Author

  • Denis Weerasiri
  • PhD Student
  • UNSW