Service Oriented Architecture: Install and configure WSO2 API Manager on Debian

This entry documents how to install and configure the WSO2 API Manager, on Debian Linux 7. WSO2 API Manager is a tool for publishing APIs, with features such as:

  • API Store
  • Publishing and Governing API
  • API Traffic routing
  • Developer Community
  • Govern Complete API Lifecycle
  • Performance monitoring

Further details available on the vendor's website, http://wso2.com/products/api-manager/

A good starting point is the official product install documentation: http://docs.wso2.org/display/AM160/Installing+on+Linux, which this entry relies on.

Install Java

The latest JDK is required, prior to installing the product. Below is a step by step guide on how to install it:

  1. Add the WebUpd8 Oracle Java PPA repository:
    sudo echo "deb http://ppa.launchpad.net/webupd8team/java/ubuntu precise main" | tee -a /etc/apt/sources.list
    sudo echo "deb-src http://ppa.launchpad.net/webupd8team/java/ubuntu precise main" | tee -a /etc/apt/sources.list
    sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys EEA14886
    
  2. Update the package list:
    apt-get update
    
  3. Install Java:
    apt-get install oracle-java7-installer
    

Prepare the environment

Official documentation provides an example on how to set the JAVA_HOME environment variable. Latest versions of Java binaries, installed on Debian, reside in /usr/bin/, thus the JAVA_HOME value should be set to /usr, as per the example below:

export JAVA_HOME=/usr
Last step is to configure the PATH environment variable, to include the newly configured JAVA_HOME variable, as per below:
export PATH=${JAVA_HOME}/bin:${PATH}
Download and install the application
 
Once Java and the environment variables are ready, the application can be downloaded and installed. To obtain the latest version, details on how to register and download a free copy are available here: http://docs.wso2.org/display/AM160/Downloading+the+Product. Once downloaded, the contents of the archive can be extracted:
unzip wso2am-1.6.0.zip
Start the server:
 
Issue the following command:
wso2am-1.6.0/bin/wso2server.sh

Leave a Reply

Your email address will not be published. Required fields are marked *