WSO2 BPS v1.1.0 - Installation Guide

WSO2 Business Process Server (BPS) Installation Guide

This document describes how to install and run WSO2 Business Process Server using binary distribution available for download. Binary Distribution includes binary files for both MS Windows and Linux operating systems as a zip file.

Installing and Running WSO2 BPS using the binary distriution

Prerequisites

Java SE Development Kit 1.5.x (For instructions on setting up the JDK on different operating systems, visit http://java.sun.com)

To build WSO2 BPS from the Source distribution, it is necessary that you have JDK 1.5.x version and Maven 2.0.6 or later

Web browser- To log-in to the BPS Management Console Mozilla Firefox 2.0 at a resolution of 1024x768 is recommended. MS Internet Explorer 7 may be used as well, with some limitations. Once the WSO2 BPS is started point the browser to https://localhost:9443/carbon you can access your Management Console. See the Web Administrator Guide for more details.
Memory No minimum requirement - A heap size of 256~512MB is generally sufficient to process typical SOAP messages. Requirements may vary with larger message size and on the number of messages processed concurrently
Disk No minimum requirement. The installation will require ~150MB excluding space allocated for log files and Databases.
Operating System Linux, Solaris, MS Windows - XP/ Vista (Not fully tested on Windows Vista). As the WSO2 BPS is a Java application, it will generally be possible to run it on other operating systems with a JDK 1.5.x runtime. Linux/Solaris is recommended for a production deployment.

Installing on Linux / Unix

  1. Download the WSO2 BPS binary distribution.
  2. Extract the zip archive where you want the WSO2 BPS installed (e.g. into /opt)
  3. Set the JAVA_HOME environment variable to your Java home using the export command or by editing /etc/profile, and add the Java /bin directory to your PATH
  4. Execute the WSO2 BPS start script or the daemon script from the bin directory. e.g. ./wso2sever.sh OR ./daemon.sh start OR ./daemon.sh console
  5. Check your WSO2 BPS instance using the URL https://localhost:9443/carbon which will take you to the WSO2 BPS Management Console.
  6. Login as "admin" using the default password "admin"

Installing on MS Windows

The following steps will take you through the installation for the MS Windows operating system.
  1. Download the WSO2 BPS binary distribution.
  2. Extract the zip archive where you want the WSO2 BPS installed
  3. Set the JAVA_HOME environment variable to your Java installation, and the PATH environment variable to the Java /bin directory.
  4. Execute the WSO2 BPS start script from the bin folder. e.g. wso2serve.sh/bat
  5. If you would like to install the WSO2 BPS as a Windows service, use the install.bat script
  6. Check your WSO2 BPS instance using the URL https://localhost:9443/carbon which will take you to the WSO2 BPS Management Console.
  7. Login as "admin" using the default password "admin"