WSO2 API Manager BOSH Release

A BOSH release for deploying WSO2 API Manager 2.1.0 on BOSH Director:

Quick Start Guide

1. First get configuration files that specify BOSH environment in VirtualBox and run bosh create-env as following:

   $ git clone https://github.com/cloudfoundry/bosh-deployment bosh-deployment
   $ mkdir vbox
   $ bosh create-env bosh-deployment/bosh.yml \
   --state vbox/state.json \
   -o bosh-deployment/virtualbox/cpi.yml \
   -o bosh-deployment/virtualbox/outbound-network.yml \
   -o bosh-deployment/bosh-lite.yml \
   -o bosh-deployment/bosh-lite-runc.yml \
   -o bosh-deployment/jumpbox-user.yml \
   --vars-store vbox/creds.yml \
   -v director_name="Bosh Lite Director" \
   -v internal_ip=192.168.50.6 \
   -v internal_gw=192.168.50.1 \
   -v internal_cidr=192.168.50.0/24 \
   -v outbound_network_name=NatNetwork

2. Once VM with BOSH Director is running, point your CLI to it, saving the environment with the alias vbox:

   bosh -e 192.168.50.6 alias-env vbox --ca-cert <(bosh int vbox/creds.yml --path /director_ssl/ca)

3. Obtain generated password to BOSH Director:

   bosh int vbox/creds.yml --path /admin_password

4. Log in using admin username and generated password:

   bosh -e vbox login

5. Download Oracle JDK 1.8 from Oracle website and WSO2 API Manager 2.1.0 via WSO2 Update Manager (WUM).

6. Add above distributions as blobs:

   bosh -e vbox add-blob jdk-8u144-linux-x64.tar.gz oraclejdk/jdk-8u144-linux-x64.tar.gz
   bosh -e vbox add-blob wso2am-2.1.0.zip wso2apim/wso2am-2.1.0.zip
   bosh -e vbox -n upload-blobs

7. Create the WSO2 API Manager bosh release:

   bosh -e vbox create-release --force

8. Upload the WSO2 API Manager bosh release to BOSH Director:

   bosh -e vbox upload-release

9. Download latest bosh-lite warden stemcell from bosh.io and upload it to BOSH Director:

   wget https://s3.amazonaws.com/bosh-core-stemcells/warden/bosh-stemcell-3445.7-warden-boshlite-ubuntu-trusty-go_agent.tgz
   bosh -e vbox upload-stemcell bosh-stemcell-3445.7-warden-boshlite-ubuntu-trusty-go_agent.tgz

10. Deploy the WSO2 API Manager bosh release manifest in BOSH Director:

    bosh -e vbox -d wso2apim deploy wso2apim-manifest.yml

11. Add route to VirtualBox network:

    sudo route add -net 10.244.0.0/16 192.168.50.6 # Mac OS X
    sudo route add -net 10.244.0.0/16 gw 192.168.50.6 # Linux
    route add 10.244.0.0/16 192.168.50.6 # Windows
    

12. Find the VM IP address via the bosh CLI and access the WSO2 API Manager Store via a web browser:

    bosh -e vbox vms
    ...
    
    Deployment 'wso2apim'
    
    Instance                                       Process State  AZ  IPs           VM CID                                VM Type
    wso2apim/08b2075d-c7e6-49f8-b223-12d989b734c2  running        -   10.244.15.21  84cac420-fd02-4884-5821-0fad60e3ce29  wso2apim-resource-pool
    ...
    
    # WSO2 API Manager Store URL: http://10.244.15.21:9763/store/

References

• A Guide to Using BOSH
• BOSH Lite