The ckan software is used to run the CKAN/OpenRegistry site (CKAN stands for the Comprehensive knowledge Archive Network) which provides a listing of (mainly open) knowledge packages.
Copyright (c) 2006-2007 Open Knowledge Foundation.
Licensed under the MIT license:
Rufus Pollock <email@example.com>
## Installation and Setup
Get the code if you do not have it already (see Getting the Code below).
$ sudo python setup.py
If you want to work from a subversion copy and plan to make modifications do:
$ sudo python setup.py develop
This step should install most the library dependencies for CKAN. However some dependencies may not be able to be installed automatically. Please see install_requires option (and associated comments) in setup.py.
Make a config file as follows:
$ paster make-config ckan config.ini
Alternatively just copy an existing configuration (such as development.ini):
$ cp development.ini config.ini
Tweak the config file as appropriate and then setup the application:
$ paster setup-app config.ini
Run the webserver:
$ paster serve config.ini
Point your browswer at: localhost:5000 (if you set a different port in your config file then youl will need to change 5000 to whatever port value you chose).
[optional] Production deployment. CKAN2 is built using pylons. A full walkthrough of production deployment can be found at:
## Getting the Code
Download ckan or checkout the code from the subversion repository.
When starting from a clean system for the tests to run properly you will need to:
- Create the basic db structure: $ bin/ckan-admin rebuild
- Create some basic test data: $ bin/ckan-admin testdata
To run the tests you should use py.test:
$ py.test ckan/tests
Note that the functional tests require twill: <http://twill.idyll.org/>