This post describes how to install, configure, and start WSO2 API Manager 4.0.0 on Linux.

Download WSO2 API Manager

  1. Navigate to https://wso2.com/api-manager/
  2. Click on TRY IT NOW
  3. Enter your email address
  4. Click on the checkbox to accept the license
  5. Download the Zip Archive (you will get a file called wso2am-4.0.0.zip)

Download JDK 11

  1. Navigate to https://www.oracle.com/java/technologies/downloads/
  2. Scroll down and click on Java 11
  3. Click on Linux
  4. Click on jdk-11.0.14_linux-x64.tar.gz

Install Software

1. You should have these files on your Linux box:

jdk-11.0.14_linux-x64_bin.tar.gz

wso2am-4.0.0.zip

2. Define your installation folder:

export WSO2_BASE=/home/wso2

3. Extract software:

cd $WSO2_BASE
gtar -xzvf jdk-11.0.14_linux-x64_bin.tar.gz
unzip wso2am-4.0.0.zip

4. Set environment variables:

export CARBON_HOME=$WSO2_BASE/wso2am-4.0.0
export JAVA_HOME=$WSO2_BASE/jdk-11.0.14
export PATH=$JAVA_HOME/bin:$PATH

Configure Hostname

You may need to do this step to be able to access the consoles outside of your box, since the default installation binds specifically to localhost.

1. Edit the following files:

$CARBON_HOME/repository/conf/api-manager.xml
$CARBON_HOME/repository/conf/event-broker.xml
$CARBON_HOME/repository/conf/tomcat/catalina-server.xml
$CARBON_HOME/repository/conf/carbon.xml
$CARBON_HOME/repository/conf/event-processor.xml

2. Change localhost to the actual hostname of your server

Commands

1. Startup:

cd $CARBON_HOME/bin
./api-manager.sh --start

2. Stop:

cd $CARBON_HOME/bin
./api-manager.sh --stop

3. Restart:

cd $CARBON_HOME/bin
./api-manager.sh --restart

4. Status:

cd $CARBON_HOME/bin
./api-manager.sh --status

URLs / Consoles

The default username and password for all consoles is admin / admin.

Publisher - https://hostname:9443/publisher

Developer Portal - https://hostname:9443/devportal

Admin - https://hostname:9443/admin

Carbon - https://hostname:9443/carbon

Logs

$CARBON_HOME/repository/logs/wso2carbon.log

References