DITrack README

$Id: README 2522 2008-05-28 06:58:24Z vss $
$HeadURL: https://svn.xiolabs.com/ditrack/src/tags/0.8/README $

Copyright (c) 2006-2008 The DITrack Project, www.ditrack.org.

REQUIREMENTS
============

* Python 2.3 or higher
* Subversion 1.3 or higher


DOCUMENTATION
=============

NB! The documentation describes DITrack as of v.0.4. Sorry, we don't have 
enough bandwidth to update it timely. :-( Any contributions are welcome.

See doc/html/index.html.

An up-to-date brief introduction to DITrack can be found at 
doc/quicktour/index.html.


INSTALLATION
============

Run the setup.py installation script:

$ python setup.py install

To get a list of available options, type:

$ python setup.py --help

See webui/README for the web interface installation instructions.

UPGRADING FROM PREVIOUS VERSIONS
================================

Automatic upgrade is possible for databases created by DITrack 0.7. If you are
upgrading from an older version of DITrack, use the upgrage utility from 
DITrack 0.7 first.

To upgrade a database run the 'upgrade-0.7-db.py' script, passing the database
path as the argument, like:

$ ./upgrade-0.7-db.py /home/user/ditrack-database

The upgrade procedure merely modifies the working copy (nothing gets committed
to the repository). So, when done, you should commit the changes manually,
like:

$ svn ci -m "Upgraded to DITrack 0.8 format" /home/user/ditrack-database


RESOURCES
=========

http://www.ditrack.org

