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: