h5pybox

This repository provides the necessary files to provision a virtual machine with a python virtual environment with numpy, h5py, ipython and the required packages (jinja2, pyzmq, tornado) to run the ipython notebook.

At the time of this writing the box used is the official Ubuntu Server 14.04 LTS (Trusty Tahr) build as found at Vagrant Cloud at https://vagrantcloud.com/ubuntu/trusty64.

• Prerequisites
• Building the virtual machine
  • Python virtual environment
• Running the ipython notebook
• Vagrant tips
• Running the salt states

Prerequisites

You should have recent versions of the following installed:

• vagrant
• VirtualBox platform package
• VirtualBox Extension Pack

and the following vagrant plugins:

• cachier
• vbguest

$ vagrant plugin install vagrant-cachier vagrant-vbguest

Building the virtual machine

Run:

$ vagrant up

NOTE: Especially if it is the first time you build the machine, it'll take a while. (Perhaps in between 10 to 15 minutes plus the time to download the ubuntu image.)

Connect:

$ vagrant ssh

Python virtual environment

The box is provisioned to have a pre-built python virtual environment, named env under /home/vagrant.

Active it

vagrant@(...)~$ source env/bin/activate

The provisioning phase should also install the python packages listed under src/requirements.txt. Consequently, if you run pip freeze you should see the following packages:

• jinja2
• ipython
• h5py
• numpy
• pyzmq
• tornado

Running the ipython notebook

Before running the notebook, check the ip address (<box_ip>) of the virtual machine. You can run ifconfig to do so.

In the virtual environment run:

(env)vagrant@(...)~$ ipython notebook --ip=0.0.0.0 --no-browser

You should then be able to access the notebook from the host machine at http://<box_ip>:8888

Vagrant tips

Using an automatic vagrant bash completion, may be helpful to speed up your work when using vagrant.

The first time you run vagrant up the box will be provisioned, but afterwards it will not as this takes more time, and may not be needed. You can instruct vagrant to provision the box like so:

$ vagrant up --provision

If the box is already running then you can use the reload command like so:

$ vagrant reload --provision

Running the salt states

You can execute the salt states manually within the virtual machine, using the salt-call command:

vagrant@(...)~$ salt-call --local state.highstate -l debug

This will "re-provision" the machine, and is usually faster than getting out of the virtual machine, and invoking vagrant reload --provision.

It is useful to use this approach when troubleshooting the provisioning phase, and trying different configurations to fix the issue. That is, you can modify one or more salt states, and run salt-call to see the effect.