INSTALL

Installation Guide for the TUC Transfer Protocol Daemon
=======================================================

Package requirements:
---------------------

This package requires the following packages to be installed (Ubuntu
package names):

 | Stage   | Package             | Version                   | Description                |
 |---------+---------------------+---------------------------+----------------------------|
 | Install |                     |                           |                            |
 |         | python              | >= 2.6                    | Python Interpreter         |
 |         | python-zsi          | >= 2.1~a1-3               | Zolera Soap Infrastructure |
 |         | python-elixir       | >= 0.6.1-2                | Object Relational Mapping  |
 |         | python-mysqldb      | >= 1.2.2-10               | MySQL Python Interface     |
 |         | mysql-server        | >= 5.1.37-1ubuntu5        | MySQL Database Server      |
 |         | apache2             | >= 2.2.12-1ubuntu2        | Apache HTTP Server         |
 |         | libapache2-mod-php5 | >= 5.2.10.dfsg.1-2ubuntu6 | PHP 5                      |
 |         | python-pychart      | >= 1.39-7                 | For statistic graphs       |
 |---------+---------------------+---------------------------+----------------------------|
 | Build   |                     |                           |                            |
 |         | python-epydoc       | >= 3.0.1-3                | For documentation          |
 |         | texlive-metapost    | >= 2007.dfsg.2-7ubuntu1   | For documentation          |
 |         | context             | >= 2008.05.21-1           | For documentation          |
 |---------+---------------------+---------------------------+----------------------------|


In the following <version> is a generic identifier of the version you
are installing; your actual package version may be something like
'0.9.0'.

To install this package (and its scripts), the following should do:

1. Unpack the source distribution.  

       tar xvzf TTPD-<version>.tar.gz

2. Change to the directory that was created by the above command.

       cd TTPD-<version>/

3. Build and install the package.  If you want to install it locally
   (in your $HOME directories), the following comamnd should do:

       python setup.py install --optimize 2 --home=$HOME

   If you would like to install it system-wide, just skip the --home
   argument.

4. After you have installed the packages, you should add the path to
   where the Python modules from this package have been installed to
   the PYTHONPATH environment variable.  If you installed the package
   in your $HOME, that means adding something like this to your
   $HOME/.bash_profile (if you are using the BASH shell):
   
       export PYTHONPATH=$PYTHONPATH:$HOME/lib/python

That should be all that's needed to install this package.  After this,
the commands 'ttpd' and 'ttpc' should be available in the
'<your-install-path>/bin/' directory.


	 Martin Thorsen Ranang <mtr@ranang.org>, 2004-08-24.

$Id$