= How to Install geni-lib on a VM using Virtual Box and Vagrant =

As of Fall '15, if you have a mac running 10.10, geni-lib won't work.  Instead boot up a VM on your local machine and install geni-lib there.

We find the combination of [https://www.virtualbox.org/wiki/Downloads VirtualBox] and [http://www.vagrantup.com/downloads vagrant] is really easy to use:
     1. Install [https://www.virtualbox.org/wiki/Downloads VirtualBox]
     1. Install [http://www.vagrantup.com/downloads vagrant]
     1. Download a file describing the VM
{{{
mac> mkdir genilib # make a directory for genilib
mac> cd genilib
mac> curl -O http://www.gpolab.bbn.com/exp/vagrant/genilib/Vagrantfile  # an Ubuntu 12.04 LR 32-bit image
}}}
     1. Download the `omni.bundle` using the browser on your mac, but then copy the `omni.bundle` file from the `Downloads` directory to the same directory as your Vagrantfile. 
{{{
mac> cp ~/Downloads/omni.bundle . # copy your omni.bundle to this directory
}}}
     1. Bring up the VM and login:
{{{
mac> vagrant up # create an 12.04 LR 32-bit Ubuntu virtual machine with geni-lib installed
mac> vagrant ssh # login to your VM
}}}
     1. Then when you configure geni-lib, run the following command inside your VM instead of the listed instructions:
{{{
ubuntu> context-from-bundle --bundle /vagrant/omni.bundle
}}}
     1. You should now be able to [http://geni-lib.readthedocs.org/en/latest/tutorials/portalcontext.html#test-it-out test your setup] following the usual steps.
     1. When you are done
{{{
ubuntu> exit
mac> vagrant halt # to shutdown your VM (vagrant destroy will completely delete the VM causing you to lose all your work)
}}}

{{{
#!comment
== Original == 
We find the combination of [https://www.virtualbox.org/wiki/Downloads VirtualBox] and [http://www.vagrantup.com/downloads vagrant] is really easy to use:
     1. Install [https://www.virtualbox.org/wiki/Downloads VirtualBox]
     1. Install [http://www.vagrantup.com/downloads vagrant]
     1. Follow the [https://docs.vagrantup.com/v2/getting-started/index.html getting started] instructions for vagrant:
{{{
mac> vagrant init hashicorp/precise32  # an Ubuntu 12.04 LR 32-bit image
mac> vagrant up # load the virtual machine
mac> vagrant ssh # login to your VM
}}}
     1. Install geni-lib following the instructions for [http://geni-lib.readthedocs.org/en/latest/intro/ubuntu.html Ubuntu].  Note you may have to run `sudo apt-get update` when prompted.
     1. Download the `omni.bundle` using the browser on your mac, but then copy the `omni.bundle` file from the `Downloads` directory to the same directory as your Vagrantfile.  
{{{
mac> mv ~/Downloads/omni.bundle /path/to/where/running/vagrant
}}}
     1. Then when you configure geni-lib, run the following command inside your VM instead of the listed instructions:
{{{
ubuntu> context-from-bundle --bundle /vagrant/omni.bundle
}}}
     1. You should now be able to [http://geni-lib.readthedocs.org/en/latest/tutorials/portalcontext.html#test-it-out test your setup] following the usual steps.
     1. When you are done
{{{
ubuntu> exit
mac> vagrant halt # to shutdown your VM (vagrant destroy will completely delete the VM causing you to lose all your work)
}}}
}}}