INSTALL

mCTC application installation instructions
------------------------------------------

Starting with a stock Debian/Ubuntu system:

# Install Ubuntu prerequisites:

    $ sudo apt-get install python-django rubygems libserialport-ruby git-core

# If you would like to generate PDF's you will need reportlab. 
# This is an optional step, you just won't be able to create PDF's
# On Ubuntu that can be:

    $ apt-get install python-reportlab

# Install rubygsm and spomskyd from github gems

    $ sudo gem sources -a http://gems.github.com
    $ sudo gem install --ignore-dependencies adammck-rubygsm
    $ sudo gem install --ignore-dependencies adammck-rubysms
    $ sudo gem install adammck-spomskyd

# Download and install Schuyler's branch of RapidSMS:

    $ git clone git://github.com/schuyler/rapidsms.git
    $ cd rapidsms
    $ sudo python setup.py install

# Download the mCTC RapidSMS project:

    $ cd ~
    $ git clone git://github.com/schuyler/mctc.git
    $ cd mctc
    $ python manage.py syncdb

# Edit the rapidsms.ini file. Make sure it contains the following:

    [rapidsms]
    apps=mctc,webui
    backends=http,spomc

# Start spomskyd in one terminal (or screen):

    $ spomskyd --backend=GSM

# Start the RapidSMS message router in another:

    $ cd ~/mctc
    $ python manage.py route

# Start the RapidSMS Django server in a third:
    
    $ cd ~/mcrc
    $ python manage.py runserver