[Tutorial] Step-by-Step Guide on Installing and Configuring WSO2 App Factory Puppet Master Using Virtualbox

  • By Anuruddha Premalal
  • 11 Feb, 2015

A separate puppetmaster can make a developer’s life easy because it offers flexibility in terms of altering the puppetmaster and testing new features. Having a puppetmaster in the same host virtualbox will also reduce network latencies. This tutorial provides a step-by-step guide to installing and configuring WSO2 App Factory puppet master in a virtualbox.

Archived Content
This article is provided for historical perspective only, and may not reflect current conditions. Please refer to relevant product page for more up-to-date product information and resources.

Follow the steps below to install and configure WSO2 App Factory puppet master using virtualbox.

  1. Create a new linux instance in virtualbox (we have used Ubuntu 14.04 instance for this tutorial)
    Follow this tutorial to create an Ubuntu VM.

  2. Configure networking interfaces in VM to access the Internet and communicate with the local machine.

    2.1 Configure VM to access Internet.

    Figure 01

    This will allow the VM to access the broader internet through your host’s connection. You’ll be able to download packages; however, you will not be able to access any VM resources from your host machine just yet.

    2.2 Add a host-only network interface

    We’ll need to add another network adapter to the VM; this time, it’ll be a Host-Only Adapter. By using this type of adapter, you’ll be able to access a private, virtual network consisting solely of your host and any guests. Any of the member VMs can access each other, but nothing outside of this self-contained can get in.

    You might need to create a host-only network from File > Preferences > VirtualBox > Settings

    Figure 02

    Figure 03

    2.3 Configure an IP address to host-only network

    We need to have a static IP for the puppet master server. Login to the server and execute the following command:

    >ifconfig eth1 netmask up

    Use whatever IP on your host-only network you wish to. This binds a network interface to one of the IP addresses on your host-only network (eth0 was bound to the NAT adapter). Now you should be able to SSH into your guest from your host (for instance) using this IP address.

    This is just temporary; however, once you reboot, this configuration will disappear. To make it permanent, add this to your / etc/ network/ interfaces file (as root):

    # The host-only network interface 
    auto eth1 
    iface eth1 inet static 

    Start the eth1 network interface

    >eth1 up

    and this interface should now show up when you type ifconfig.

    Optional: Configuring ssh access to the VM

    Sometime you’ll find that it’s easier to use the VM terminal from your host machine. In that case, you’ll need to install a ssh server in the VM.

    >sudo apt-get install openssh-server

  3. Configuring a hostname for puppet master

    We will be using puppet.apfactory.wso2.com as the puppetmaster hostname. Execute the following command as the root user

    > hostname puppet.appfactory.wso2.com > /etc/hostname
    > echo " puppet.appfactory.wso2.com" >gt; /etc/hosts

    Make sure you’ve used the IP address of the host-only interface for the above command.

  4. Install puppet master

    Note: Be sure to use Puppet Master version 3.7 or above

    4.1 Enable the repository for Ubuntu 14.04 Trusty Tahr

    >wget https://apt.puppetlabs.com/puppetlabs-release-trusty.deb
    >sudo dpkg -i puppetlabs-release-precise.deb
    >sudo apt-get update

    4.2 Install puppet master

    >sudo apt-get install puppetmaster

  5. Configuring a file server to manage appfactory distribution packs. We use apache2 for this tutorial.

    >sudo apt-get install apache2

    We need this file server to manage the distribution packs of all products involved in an App Factory deployment, such as WSO2 App Factory, API manager, ELB, application server, etc.

    Create a folder named software inside the Apache document ­root (/var/www) and download the following distribution packs to the /var/www/software folder:

    WSO2 products Other products
    wso2appfactory-2.1.0.zip apache-maven-3.0.5-bin.tar.gz
    wso2as-5.2.1.zip apache-activemq-5.9.1-bin.tar.gz
    wso2bam-2.4.1.zip apache-stratos-4.0.0-wso2v1.zip
    wso2bps-3.2.0.zip apache-stratos-cartridge-agent-4.0.0-wso2v1-bin.zip
    wso2mb-2.2.0.zip apache-stratos-load-balancer-4.0.0-wso2v1.zip
    wso2ss-1.1.0.zip gitblit-1.4.1.zip
    wso2ues-1.1.0.zip jdk-7u51-linux-x64.tar.gz
    wso2-private-paas-4.0.0-installer.zip mysql-connector-java-5.1.29-bin.jar

    Configure apache2 to point to /var/www/software as document root
    Edit the /etc/apache2/sites-enabled/000-default.conf with the following configuration

    <VirtualHost *:80>
    	ServerAdmin webmaster@localhost
    	DocumentRoot /var/www/software
    	ErrorLog ${APACHE_LOG_DIR}/error.log
    	CustomLog ${APACHE_LOG_DIR}/access.log combined

    Restart the apache2 service

    >sudo service apache2 restart

  6. Configuring puppet master

    6.1 Install git

              >sudo apt-get install git

    6.2 Clone appfactory code-base

              >git clone https://github.com/wso2/product-af.git

    6.3 Copy the puppet manifest to a desired location

              >cp product-af/modules/puppet-manifests /home/master

    6.4 Carry out the configuration changes in nodes.pp

    Update the following parameters of the puppet-manifests/appfactory/manifests/nodes.pp

              $package_repo = ''

    Add the correct package repository url created in step 5

              $domain = 'appfactory.wso2.com'

    Just update the first occurrence of this parameter

              $hosts_mapping  = [

    In $hosts_mapping there’s hard coded IP change it to the puppet master IP

             ## Private paas configurations
             $stratos_domain     = "paas.${wso2_env_domain}"
             #Private paas IAAS configuration
             $iaas                 = "os"
             $iaas_region          = "RegionOne"
             $iaas_cartridge_image = "34dd924f-ef3d-49ae-884a-4784f0330f1b"
             $os_identity          = "openstackDemo:admin"
             $os_credentials       = "password"
             $os_jclouds_endpoint  = "http://appfactorycloud.private.wso2.com:5000/v2.0"
             $os_keypair_name      = "appfackey"
             $os_security_groups   = "default"

    6.5 Edit /etc/puppet/puppet.conf file with the following configurations

    puppet.conf is the main configuration file of the puppet. We’ll need to point appfactory puppet manifest via this configuration file. Additional configurations are highlighted in green.

    # These are needed when the puppetmaster is run by passenger
    # and can safely be removed if webrick is used.
    ssl_client_header = SSL_CLIENT_S_DN
    ssl_client_verify_header = SSL_CLIENT_VERIFY

    The additional configs compared to the default puppet.conf are;

    autosign=true in [master]
    This configuration allows to sign the certificates requests without manual intervention (use this configuration only in a development environment to prevent security vulnerabilities)


    Now if you browse the URL from your host machine web browser you should be able to see the packages we have copied to /var/www/software folder. Note that you cannot proceed without this step.

    That’s all you need to setup WSO2 App Factory with minimal configurations. To install WSO2 App Factory follow the on-premise installation guide [4]. Here, instead of pointing to an external puppet master, you could point it to the configured virtual machine IP.


[1] https://help.ubuntu.com/community/Ubuntu_as_Guest_OS [2] https://docs.puppetlabs.com/ [3] https://docs.wso2.com/display/AF200/WSO2+App+Factory+Documentation [4] https://docs.wso2.com/display/AF210/Installing+On-Premise