Vagrant Installation

Note: the instructions in this page are outdated and not officially supported or recommended by the pump.io project. See #1302 which tracks official Vagrant support.

Vagrant Installation

Document Version 0.1 (Jan 28th, 2015)

The intention of this document is to give prospective administrators more information on developing and testing VM builds running Pump.io.

Pump.io is relatively simple to run, however there can be some difficulties surrounding database choice and installation.

It has also been noted that setting up the config file can be distro agnostic, and cause confusion for people who are wanting more specific answers.

In this example installation, we will be using the standard install information provided in the pump.io tutorial, and using it to configure a Virtual Machine based on an Ubuntu base image to run Pump.io.

Install system build essentials

apt-get install build-essential curl git python-software-properties

Install Vagrant Dependencies

apt-get install virtualbox virtualbox-dkms vagrant

Install vagrant

apt-get install vagrant

Initialise Base OS

cd /path/to/your/build/directory && vagrant init
vagrant box add UbuntuTrusty64 https://cloud-images.ubuntu.com/vagrant/trusty/current/trusty-server-cloudimg-amd64-vagrant-disk1.box

Download Provisioning Shell Script

mkdir provision && cd provision
wget https://gist.github.com/debanjum/3c3e92de34d290a8bc68/raw/f2d86de263980e744a7ac1079c2863f49fe1c9d6/Pump.sh

Edit Vagrantfile

# -*- mode: ruby -*-
# vi: set ft=ruby :

# Vagrantfile API/syntax version. Don't touch unless you know what you're doing!
VAGRANTFILE_API_VERSION = "2"

Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
 # All Vagrant configuration is done here. The most common configuration
 # options are documented and commented below. For a complete reference,
 # please see the online documentation at vagrantup.com.

 # Every Vagrant virtual environment requires a box to build off of.
 config.vm.box = "UbuntuTrusty64"

 # The url from where the 'config.vm.box' box will be fetched if it
 # doesn't already exist on the user's system.
 config.vm.box_url = "https://cloud-images.ubuntu.com/vagrant/trusty/current/trusty-server-cloudimg-amd64-vagrant-disk1.box"

 # Enable provisioning with shell, specifying a script path
 config.vm.provision "shell" do |s|
    s.privileged = false
    s.path = "provision/Pump.sh"
    s.args = "local"
 end
end

Startup

vagrant up  # Creates VM and Runs Provisioning Shell Script(Pump.sh)

Verify & Debug

vagrant ssh  # ssh into the VM
screen -r    # to see pump console output

• NOTE: If you don't see it, something went wrong - you can see the error messages in screenlog.0 by cat screenlog.0