This documentation is for WSO2 Stratos 2.0.0. View the latest Apache Stratos documentation.
OpenStack - Stratos 2.0.0 - WSO2 Documentation
Skip to end of metadata
Go to start of metadata

Make sure that the mentioned prerequisites are available for the demo deployment (for more information see Prerequisites) and also that the common configurations are configured (for more information see Common IaaS Configurations).

You can use any OpenStack configured IaaS. We have tested Stratos 2.0 with Essex and Folsom which are versions of OpensStack. We recommend the SUSE Cloud since it has a production ready OpenStack IaaS. You can use a single node or multi node OpenStack environment. You can install WSO2 Stratos 2.0 servers into the same single node or on a separate node. 

  1. Install OpenStack Iaas.
  2. Download
  3. Extract on your OpenStack installed server.
  4. Follow the instructions in the README.txt file.
  5. Install Java in your server.
    Copy the JDK to any preferred location and export environment variable JAVA_HOME to point to your java run-time. We recommend that you use Java 6.0.  

    export JAVA_HOME="/opt/jdk1.6.0_24"


  6. Download mysql-connector-java-5.1.17-bin.jar
  7. Copy the jar inside wso2s2-openstack-1.0.0
    If you intend to use a different MySQL connector version then make sure you update the following line in the wso2s2-openstack-1.0.0 / conf/setup.conf file.

    export mysql_connector_jar="mysql-connector-java-5.1.24.jar" 

  8. Configure MySQL to allow requests from Cartridges as follows:

    • Add the following entry to the /etc/hosts file.

    • Add the following entry to the /etc/mysql/my.cnf file.

      bind-address =
    • Restart MySQL using the following command:

      sudo service mysql restart
  9. Create a public key to use with OpenStack
    Do not enter any passwords while creating the public key, to ensure ease of use. Just press ENTER.

    $ ssh-keygen -t rsa

    You can check the created public key as follows:

    $ cat ~/.ssh/

    Edit   wso2s2-openstack-1.0.0 / conf/setup.conf   according to your environment.
    When editing, you need to provide information about your OpenStack environment.

    Ensure to give the following information in the wso2s2-openstack-1.0.0 / conf/setup.conf .


    File path of the public key location.        

    Make sure that the conf/setup.conf is according to your environment (specially the “General configuration” section and “OpenStack” section). You can accept the default values for most of the parameters.
    The parameter descriptions are as follows:

    hostip IP of the machine where you setup Stratos2 packs
    stratos2_domain Define your own domain
    agent_hostname Hostname of the agent
    bam_hostname Hostname of the bam
    cc_hostname Hostname of Cloud Controller
    s2_db_hostname Hostname of the database
    sc_hostname Hostname of the Stratos Controller
    userstore_db_hostname Hostname of the userstore
    userstore_db_schema Schema name of the userstore
    userstore_db_port Port of userstore database
    userstore_db_user User of the userstore database
    userstore_db_pass Password of the userstore database
    s2_db_hostname Hostname of the Stratos2 foundation databse
    s2_db_schema Schema of the Stratos2 foundation databse
    s2_db_port Port of the Stratos2 foundation database
    s2_db_user User of the Stratos2 foundation databse
    s2_db_pass Password of the Stratos2 foundation databse
    git_user Username of the Git
    email email
     git_hostnameHostname of the Git
    git_ipIP of the Git server
    openstack_provider_enable Default value should be "true" when using OpenStack
    openstack_identity Openstack login username
    openstack_credential OpenStack login password
    openstack_tenantOpenStack project name
    openstack_project_idID of the Openstack project
    openstack_api_key Defualt should be "openstack"
    openstack_jclouds_endpoint jclouds endpoint URL e.g.,
    openstack_scaleup_order Scale up order
    openstack_scaledown_order Scale down order
    openstack_keypair_name Keypair used in OpenStack
    openstack_region OpenStack region provided in the setup
    openstack_instance_type_tiny Type of instance (tiny) spawed in OpenStack
    openstack_instance_type_small Type of instance (small) spawed in OpenStack (will be used by Carbon Cartridges)
    openstack_security_group Security group name in OpenStack
    php_cartridge_image_id PHP Cartridge image ID
    carbon_cartridge_image_id Carbon Cartridge image ID
    mysql_cartridge_image_id MySQL Cartridge image ID
  10. Run the (given below) inside wso2s2-openstack-1.0.0 as a root user to install Stratos2 Paas with Openstack demo.
    When you enable the Stratos2 demo, it will upload images of all out of the box Carbon and Non-Carbon Cartridges provided into the glance image server.

    sudo JAVA_HOME=/opt/jdk1.6.0_24 ./ -d openstack -p"all"

    Command Argument Description

    The IaaS that is used.
    All components in Stratos 2

    You can see the logs at:

    $ tail -f /var/log/s2/s2.log
    $ tail -f /var/log/s2/s2-openstack.log

  11. If you want to re-do the Stratos2 setup by running the, first you need to clean the existing setup by using and then if you enabled Stratos2 Openstack demo The commands are as follows:

    sudo ./ -a<hostname> -b<host_user> -c<Openstack mysql root user> -d<Openstack mysql password>


    sudo ./ -as2demo -bwso2 -croot -dopenstack


  • No labels