= How to Install Ansible on a VM using Virtual Box and Vagrant =

'''These instructions are incomplete.'''

It is not possible to run `ansible` on Windows.  Instead boot up a VM on your local machine and install `ansible` 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 ansible # make a directory for ansible
mac> cd ansible
mac> curl -O https://raw.githubusercontent.com/GENI-NSF/geni-tutorials/master/OldTutorials/vagrant/Vagrantfile  # an Ubuntu 12.04 LR 32-bit image
}}}
     1. Create the ansible inventory file in the same directory as your Vagrantfile. 
{{{
mac> readyToLogin.py MYSLICE --useSliceAggregates --ansible-inventory -o
}}}
     1. Bring up the VM and login:
{{{
mac> vagrant up # create an 12.04 LR 32-bit Ubuntu virtual machine with ansible installed
mac> vagrant ssh # login to your VM
}}}
     1. Copy your private key to FIX ME.
     1. Run `ansible` with your inventory file:
{{{
ubuntu> ansible -i /vagrant/inventory all -m ping
}}}
     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)
}}}