[ckan-dev] Booting feature branch demo servers on s031

[Sean Hammond]

We're planning to look into better ways of deploying CKAN generally, but
for now if you have e.g. a feature branch, theme for extension that you
want to boot a demo of you can follow these instructions.

I'll add these instructions to the /home/okfn/README file on s031. I'm
not sure if this is the best place to document things on s031, should I
move it to a wiki page?

1. ssh into s031 and create a new virtual machine from the
lucid32_ckan_feature_demo base box:

    ssh okfn at s031.okserver.org
    cd Vagrant
    mkdir my_ckan_demo
    cd my_ckan_demo
    vagrant init lucid32_ckan_feature_demo

This is an Ubuntu 10.04 VM with a CKAN source install deployed with
Apache and with some sample datasets imported and some extensions
activated.

2. Edit the Vagrantfile that has been created in your directory to setup
port forwarding. Find the forward_port line and forward some port of
s031 to port 80 of your VM, e.g.:

    # Forward a port from the guest to the host, which allows for outside
    # computers to access the VM, whereas host only networking does not.
    config.vm.forward_port 80, 8976

3. Boot up the VM:

    vagrant up

Now you should be able to see your new CKAN instance in a web browser
at:

    http://s031.okserver.org:8976/

4. ssh into your VM and modify your CKAN instance:

    vagrant ssh

On the VM, the CKAN source install is at /usr/local/feature-2375-demo-theme
(I should probably rename that dir, the base VM was made from the
feature-2375-demo-theme VM). In this dir you'll find the pyenv,
development.ini file, and git repo with the CKAN source dir. Make
whatever changes you want and then reboot Apache on the VM:

    sudo /etc/init.d/apache2 restart