ChattanoogaPublicLibrary / open-data-portal

Repository for the development of the Chattanooga Public Library's Open Data Portal initiative.
http://opendata.chattlibrary.org
7 stars 2 forks source link

Open Data Portal

The Open Data Portal is a project of Open Chattanooga. Open Chattanooga is a collabortive effort of the City of Chattanooga, the Chattanooga Public Library and the Open Chattanooga Brigade funded by the Knight Foundation and the Benwood Foundation.

Instructions for Local Development

To replicate the CPL's official development environment a number of open source tools are required, specifically:

Head to the Wiki for OS-specific instructions. In addition, this guide assumes you are developing on a *nix-based machine, as Windows is not fully supported by all the tools used here. With that important caveat noted, please don't let this be a deterent to those pioneers who want to dive in on a Windows machine!

VirtualBox

VirtualBox is relatively straight forward to install. Please visit the download page for installation instructions specific to your operating system.

Ubuntu:

sudo apt-get install -y virtualbox

Fedora:

sudo yum install -y virtualbox

Vagrant

Please visit the downloads page to find an appropriate binary for your operating system.

Once vagrant is installed you will need to install two plugins: vagrant-vbguest which updates your Vagrant box's installed guest additions to reflect the version of VirtualBox you are running and vagrant-hostmaster which manages your /etc/hosts file. Run the following commands from a terminal:

# Updates the VirtualBox Guest Editions version to match your VirtualBox version
vagrant plugin install vagrant-vbguest

# Manages /etc/hosts 
vagrant plugin install vagrant-hostmanager

Ansible

Please visit the installation page to find the most appropriate route for you to install Ansible. At the time of this writing Ansible 1.5 (most recent version) has not been released to the yum repositories so I installed from source. The rationale stemmed from needing a solution introduced in Ansible 1.5 regarding the git module.