RapidSMS
From MobileHacking.org
RapidSMS Google Summer of Code 2009 Ideas List
For the first version of RapidSMS rapidsms.sourceforge.org, refer to these instructions:
RapidSMS Current Devopment Structure
Contents |
Introduction
Version 2 of RapidSMS was developed with UNICEF Ethiopia during October 2008 as a supply monitoring system for PlumpyNuts.
Requirements
Necessary application software:
We recommend placing these in your user's home directory and linking them to your python site-packages directory. For the software on github, we recommend cloning the git repository rather than downloading the tar.gz, so you are may 'git pull' to get the most recent updates.
GSM modem interfaces:
We recommend RubyGSM for Ubuntu
Alternatively, you may use Gnokii with pyGnokii
or Kannel with pyKannel.
Installation
RapidSMS Ubuntu installation instructions
install necessary packages
/------
sudo apt-get install ruby ruby1.8-dev rdoc irb libserialport-ruby python-mysqldb git-core mysql-server-5.0
\------
download and install rubygems
/------
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
/------
sudo gem install rack mongrel
\------
download and install Django
/-------
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 rapidsms platform NOTE these instructions require an older version of rubygsm (tree ef8919d3d414797589dcb6174349ae5a2bfb91f7) from november 2008
/------
mkdir ~/rapidsms
cd ~/rapidsms
git clone git://github.com/adammck/rubygsm.git
git clone git://github.com/adammck/smsapp.git
git clone git://github.com/adammck/pykannel.git
git clone git://github.com/adammck/plumpynut.git
\------
install rapidsms libraries into python's site-packages
(substitute your username for 'user')
/------
sudo ln -s /home/user/rapidsms/pykannel/kannel.py /usr/lib/python2.5/site-packages/kannel.py
sudo ln -s /home/user/rapidsms/smsapp/smsapp.py /usr/lib/python2.5/site-packages/smsapp.py
\------
create mysql database and user
(you will be asked to make a password for 'root' during installation via apt-get)
/------
mysql -uroot -p
>create database unisms;
>grant all on unisms.* to 'unicef'@'localhost' identified by 'mepemepe';
>flush privileges;
>exit;
\------
create database tables
/------
cd plumpynut/webui
python manage.py syncdb
\------
(optionally load Ethiopia location fixtures)
/------
python manage.py loaddata places.25-09-08.json
\------
start scripts in different screen tabs
(google 'gnu screen' to learn about screen)
/------
cd ~/rapidsms
screen
cd plumpynut
./backend.py
\-----
now press ctrl-a c to open a new screen tab
then
/------
cd plumpynut/webui
python manage.py runserver
\------
now press ctrl-a c to open a new screen tab
then
NOTE if your SIM's PIN number is not the default 1234, edit line 750 of rubygsm.rb and replace 1234 with your SIM's PIN number
/------
cd rubygsm
./notkannel.rb
\------
press ctrl-a n to cycle through screen tabs
barcamp
GREETINGS BARCAMP!!!!
please accept our regrets for not making it today. here is some information about our rapidsms platform RapidSMS.pdf
cheers, unicef
