RapidSMS Ubuntu installation instructions

*RapidSMS requires python version 2.5 or later. Python comes with Ubuntu, but checking its version now may save a headache later.

==========================

Install necessary packages

==========================

/——

sudo apt-get install python-mysqldb

——

install git for ease of upgrading (optional)

/——

sudo apt-get install git-core

——

install mysql (optional – rapidsms uses sqlite3 by default) See MySql?‘s website for more information.

Download and install Django

*Note: We are currently supporting RapidSMS only with django version 1.0*

/——-

mkdir ~/src

cd ~/src

wget http://www.djangoproject.com/download/1.0/tarball/

tar xzvf Django-1.0.tar.gz

cd Django-1.0

sudo python setup.py install

——

Download and install RapidSMS

/——-

cd ~/src

wget http://github.com/unicefinnovation/rapidsms/tarball/master

tar xzvf unicefinnovation-rapidsms-3345f44ad08f99c604307aca3b7212ee59e40088.tar.gz

cd unicefinnovation-rapidsms-3345f44ad08f99c604307aca3b7212ee59e40088

sudo python setup.py install

——

**OR**

clone RapidSMS if you are using git *Note: if you are planning to contribute code, we recommend that you fork unicefinnovation/rapidsms on github, push your code to your fork, and submit pull requests. Otherwise, check with the core developers via irc or mailing list for information about submitting patch files (see rapidsms.org for details).

/——-

git clone git://github.com/unicefinnovation/rapidsms.git

——

Start a project!

/——-

mkdir ~/projects

cd ~/projects

rapidsms startproject myprojectname

cd myprojectname

cp rapidsms.ini local.ini

——-

edit your local.ini file to add whichever apps and backends you desire and then generate the necessary database tables

/——-

./rapidsms syncdb

——-

and run RapidSMS!

/——-

./rapidsms route

——-

then open another window (or use screen! google ‘gnu screen’ for more info)

/——-

cd ~/projects/myprojectname

./rapidsms runserver

——-

and visit http://localhost:8000 in your browser

============================================

for GSM modem support via RubyGSM (optional)

============================================

*Note: on Windows and maybe other systems, you may need to download and install drivers for USB –> serial converter

Install necessary packages

/——

sudo apt-get install ruby ruby1.8-dev rdoc irb

——

Install ruby serial port bindings *Note: we have had better luck with toholio-serialport on ubuntu and mac osx, but your mileage may vary.

either via

/——

sudo apt-get install libserialport-ruby

——

or

/——

sudo gem install toholio-serialport (via gems.github.com — you may need to run $gem sources -a http://gems.github.com)

——

Download and install rubygems

*Note: the rubygems deb package (the one you would get via apt-get install rubygems) doesn’t work on Ubuntu, so we recommend building the latest version from source*

/——

mkdir ~/src

cd ~/src

http://rubyforge.org/frs/download.php/45905/rubygems-1.3.1.tgz

tar xzvf rubygems-1.3.1.tgz

cd rubygems-1.3.1

sudo ruby setup.rb

sudo ln -s /usr/bin/gem1.8 /usr/bin/gem

sudo gem update –system

——

Install the rubygems we need

*Note: on Windows, when installing Mongrel, choose windows-32 instead of ruby

/——

sudo gem install uuid rack mongrel

——

Clone or download rubygsm, rubysms, spomskyd from:

http://github.com/unicefinnovation/rubygsm (also available as a ruby gem via gems.github.com — you may need to run $gem sources -a http://gems.github.com)

http://github.com/unicefinnovation/rubysms

http://github.com/unicefinnovation/spomskyd

========================================================

for GSM modem support via Kannel and pyKannel (optional)

========================================================

Download, install, and configure Kannel. Visit Kannel’s website for more details.

Clone or download pyKannel from:

http://github.com/adammck/pykannel

==========================================================

for GSM handset support via Gnokii and pyGnokii (optional)

==========================================================

Download, install, and configure Gnokii. Visit Gnokii’s website for more details.

Clone or download pyGnokii from:

http://github.com/adammck/pygnokii