Introduction

Follow these steps to run a kitsune development environment inside a virtual machine.

Installation

Clone the repository:

$ gem install vagrant
$ git clone git://github.com/readevalprint/kitsune-vagrant.git
$ cd kitsune-vagrant

Then up the vagrant box:

$ vagrant up

This will take about 15-20 minutes to run on a "modern" machine (author has 2.66Ghz Macbook Pro w/4GB RAM). When it finishes, you will be able to connect to the vagrant box:

$ vagrant ssh

From within the vagrant shell:

$ cd kitsune
$ python ./manage.py runserver

Then in your browser open:

- http://33.33.33.10:8000

When you are finished working, in the host type:

$ vagrant halt

Troubleshooting

Vagrant is taking too long

Sometimes vagrant up will say:

[default] Waiting for VM to boot. This can take a few minutes.

then take much longer. If it takes longer than a few minutes, CTRL-C and re-run vagrant up.

Vagrant says read-only fs

Sometimes vagrant up will quit with the message:

[default] err: Could not send report: Got 1 failure(s) while initializing: change from absent to directory failed: Could not set 'directory on ensure: Read-only file system - /var/lib/puppet/rrd

vagrant destroy and vagrant up again should fix the problem (whatever it is).

Vagrant won't gem install, with a vague datetime error

Use the most current version of rubygems, and not the one from your distibution. http://rubyforge.org/projects/rubygems/

Notes

[1]	https://github.com/jsocol/kitsune

[2]	Requires vagrant and VirtualBox to be installed: http://vagrantup.com, http://www.virtualbox.org/.

[3]	You only need to do this once. Afterward you can vagrant destroy and vagrant up as needed.