| 1 | = How to Install geni-lib on a VM using Virtual Box and Vagrant = |
| 2 | |
| 3 | 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. |
| 4 | |
| 5 | We find the combination of [https://www.virtualbox.org/wiki/Downloads VirtualBox] and [http://www.vagrantup.com/downloads vagrant] is really easy to use: |
| 6 | 1. Install [https://www.virtualbox.org/wiki/Downloads VirtualBox] |
| 7 | 1. Install [http://www.vagrantup.com/downloads vagrant] |
| 8 | 1. Follow the [https://docs.vagrantup.com/v2/getting-started/index.html getting started] instructions for vagrant: |
| 9 | {{{ |
| 10 | mac> vagrant init hashicorp/precise32 # an Ubuntu 12.04 LR 32-bit image |
| 11 | mac> vagrant up # load the virtual machine |
| 12 | mac> vagrant ssh # login to your VM |
| 13 | }}} |
| 14 | 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. |
| 15 | 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. |
| 16 | {{{ |
| 17 | mac> mv ~/Downloads/omni.bundle /path/to/where/running/vagrant |
| 18 | }}} |
| 19 | 1. Then when you configure geni-lib, run the following command inside your VM instead of the listed instructions: |
| 20 | {{{ |
| 21 | ubuntu> context-from-bundle --bundle /vagrant/omni.bundle |
| 22 | }}} |
| 23 | 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. |
| 24 | 1. When you are done |
| 25 | {{{ |
| 26 | ubuntu> exit |
| 27 | mac> vagrant halt # to shutdown your VM (vagrant destroy will completely delete the VM causing you to lose all your work) |
| 28 | }}} |