Skip to content

Latest commit

 

History

History

all-in-one-pattern

README.md

WSO2 API Manager Configurations for All-In-One Pattern

This repository contains configurations required for setting up WSO2 API Manager 2.1.0 and WSO2 API Manager Analytics 2.1.0 according to all-in-one deployment pattern. The purpose of creating this repository is to provide a clear view of the deployment architecture, configurations required and the dependencies that exist between components.

Deployment Architecture

The following diagram illustrates the deployment architecture:

Repository Content

  • /conf/default

    The default configurations folder contains all configuration files that are shipped with the WSO2 API Manager 2.1.0 and WSO2 API Manager Analytics 2.1.0 distributions.

  • /conf/wso2am-2.1.0

    This folder contains configurations required for WSO2 API Manager node 1 and node 2.

  • /conf/wso2am-analytics-2.1.0

    This folder contains configurations required for WSO2 API Manager Analytics node.

  • /dist/

    This folder has been reserved for copying the WSO2 API Manager distribution, API Manager Analytics distribution and MySQL connector for Java.

  • /volumes/apim-gateway/synapse-configs/

    This is the default synapse configuration folder shipped with the API Manager 2.1.0 distribution. It has been copied to a separate folder to be able to mount to both API Manager nodes via symbolic links.

Hostnames

Following hostnames have been used in this deployment:

  • wso2-apim-node1 This is the hostname or the IP address of the WSO2 API Manager node 1.

  • wso2-apim-node2 This is the hostname or the IP address of the WSO2 API Manager node 2.

  • wso2-apim-analytics-node This is the hostname of the WSO2 API Manager Analytics node.

  • wso2-apim-lb This is the hostname of the load balancer used for load balancing HTTP traffic of API Manager nodes.

Quick Start

The following steps can be used to try this out on a local machine before using it in a real environment:

  • Clone this repository and switch to the all-on-one-pattern folder:

    git clone https://github.com/imesh/wso2-apim-conf.git
cd wso2-apim-conf/all-in-one-pattern/

  • Download WSO2 API Manager 2.1.0 and WSO2 API Manager Analytics 2.1.0 distributions via WSO2 Update Manager and copy them to the dist/ folder.

  • Download MySQL connector for Java distribution, extract it and copy the JAR file to the dist/ folder.

  • Update MySQL connector JAR filename in setup.sh script:

    connector_jar="mysql-connector-java-5.1.36-bin.jar"

  • Install JDK 8, set JAVA_HOME and update the $PATH variable:

    export JAVA_HOME=/path/to/jdk/home/directory
export PATH=$JAVA_HOME/bin:$PATH

  • Set following hostnames in /etc/hosts file:

    127.0.0.1 wso2-apim-node1
127.0.0.1 wso2-apim-node2
127.0.0.1 wso2-apim-analytics-node
127.0.0.1 wso2-apim-lb

  • Execute setup.sh script to setup the deployment:

    ./setup.sh

  • Once the work is completed, execute clean.sh script to remove the deployment. Note that this operation will remove both MySQL database containers, WSO2 API Manager and WSO2 API Manager Analytics installations:

    ./clean.sh