The following is a step-by-step process for installing the development indicator collection kit on an Ubuntu machine.
If you're installing the collection kit on a machine with other python applications, you'll likely want to create a "Virtual Environment" to install all dependencies. This keeps the copy of python in /usr clean, and also keeps you from having to run sudo to install every dependency. From a terminal, you'll run the following commands:
sudo apt-get install python-virtualenv cd /path/to/your/virtual/environments/ mkdir virtual_environments cd virtual_environments virtualenv --no-site-packages kit source kit/bin/activate
Second, you'll need the application source itself. Unfortunately, for now, this required a clone directly from github (rather than a download or pip install). Check this README on github for updates to the install process. From a terminal, run:
cd /path/to/your/projects/ git clone git://github.com/daveycrockett/kit.git cd kit git submodule init git submodule update
Once you've downloaded kit, you'll need to install kit's requirements:
cd kit
pip install -r requirements.pip
Run the usual database initialization steps:
python manage.py syncdb
python manage.py migrate
And now you should be ready to run the server:
python manage.py runserver
When you navigate to http://localhost:8000, you'll be walked through the process of initializing the system to collect data. This involves uploading locations (these aren't GPS coordinates, but rather a tree of locations for aggregating information), users (those reporting information), reports (SMS reports and XForms) and indicators (individual pieces of data to be collected).