Run WSO2 products with Stratos Locally

WSO2 Stratos is the most complete, enterprise-grade, open PaaS, with support for more core services. WSO2 Stratos provides the core cloud services and essential building blocks for example federated identity and single sign-on, data-as-a-service and messaging-as-a-service and more, required for developing SaaS and cloud applications.

WSO2 Stratos enables organizations to combine the cost savings of cloud with the security, control and SLAs of enterprise data centers. WSO2 Stratos enables:

  • Unprecedented data center utilization and lower IT infrastructure costs
  • Tenant self-provisioning and agile app development
  • Tenant usage metering and billing
  • Easy access to SQL and noSQL data stores
  • Messaging, business and presentation services
  • Automated governance and centralized identity and security controls
  • Accelerated adoption of internal clouds and gradual migration into public clouds

This post is about deploying WSO2 products locally with Stratos. 

  • First build the products you want to deploy and put the zip files that are in /carbon/products/(product)/modules/distribution/service/target into a one folder. Say home/ToRunWithStratos
  • Create a folder called 'deploy' in ToRunWithStratos. Now you have all the zip files of products plus the deploy folder in ToRunWithStratos folder. 
  • Install "perl" to your machine. Use following commands.
    • sudo apt-get install libfile-copy-recursive-perl
    • sudo apt-get install libfile-path-perl
    • sudo apt-get install libfile-basedir-perl
    • sudo apt-get install libxml-libxml-perl (You many need to install libxml2-dev first- sudo apt-get install libxml2-dev)
    • sudo apt-get install libarchive-zip-perl
    • sudo apt-get install libgetopt-declare-perl
    • sudo apt-get install liblist-moreutils-perl

  • Install mySQL database using package manager. Use the following command to assign the password "root" to root. 
mysqladmin -u root -p password root

  • Following are the general parameters that is needed to have in order to run stratos. In brackets I have shown my configuation values. 
    • -p : Packs dir where services archive files resides(home/ToRunWithStratos)
    • -t : directory where changed configuration files are stored(home/ToRunWithStratos/deploy)
    • -v : version(1.1.0-SNAPSHOT)
    • -s : whether to enable sso (true)
    • -d : whether to create database (true)
    • -l : service list to enable ("mb is mnager")
    • -c : configuration file name (stratos_config_min.xml)
    • -u : database user name(root)
    • -w : database password(root)
  • cd to carbon/build
  • In my case following is the command I used to run mb on stratos 
./   -p /home/hasitha/ToRunWithStratos -t /home/hasitha/ToRunWithStratos/deploy -v "1.1.0-SNAPSHOT" -d true -l "manager is mb" -c stratos_config_min.xml -u root -w root -s true

  • After the script is run, add following lines to /etc/hosts file after opening it as administrator, as you will be instructed in the command prompt after above command is run. 


  • Now cd to /home/hasitha/ToRunWithStratos/deploy/wso2stratos-mb-1.1.0-SNAPSHOT/bin directory and run in order to start MB server. Now it is running in stratos. 

Hasitha Hiranya

No comments:

Post a Comment