The document provides a detailed guide for installing and configuring Kannel as an SMS gateway server, specifically for the Motorola Razer V3. It includes instructions on downloading dependencies, configuring Bearerbox and SMSbox, and editing the 'smskannel.conf' file with necessary settings for modem operation and SMS services. The document also explains how to check modem compatibility and run the services once configured.

1. Final Year Project
Kannel Configuration
with Motorola Razer
V3
Report
Mahtab Rasheed
10-May-12

2. Kannel Installation and Configuration as SMS gateway Server
Installation
1. Download latest version of Kannel http://www.kannel.org/download.shtml
2. Unzip it into some directory
3. Before installation of Kannel we have to install a dependency libxml2. To install libxml2 we can
download it from the following link. ftp://gd.tuwien.ac.at/pub/libxml/
a. After extracting the package cd into the directory where it is extracted.
b. Type ./configure
c. make
d. make install
e. to check whether the installation is successful or not type this command: make tests
4. After installation of libxml2 now we will be able to install the Kannel. Now repeat the above
steps which we repeated for the libxml2 installation
a. cd into directory where Kannel is unzipped and then type the following commands
b. ./configure
c. make
d. make install
5. Now Kannel is installed and ready for the configuration
Configuration
6. Kannel has three parts bearerbox, smsbox and wapbox. We will need only two bearerbox and
smsbox as we are going to setup it as SMS gateway server. Bearerbox is the main queue and
smsbox handles the smscs.
7. Now we need configuration of each beaerbox and smsbox to run the Kannel according to device
attached. Configuration of bearerbox and smsbox is written into a configuration file sometimes
but not necessarily named as ‘smskannel.conf’.
8. How to find the ‘smskannel.conf’? Open the terminal and type this command > locate
smskannel.conf. Now you the open the ‘smskannel.conf’ by the path returned by the command.
a. After opening the ‘smskannel.conf’ you will see different types of groups there. E.g.
Core group, smsc group, modem group and smsc service groups. You can refer Kannel
installation guide for further information.
9. By default bearerbox and smsbox installation files lies in /usr/local/sbin
10. Now copy the ‘smskannel.conf’ into /usr/local/sbin
11. Modem which will be used with Kannel should support ‘AT+CNMI’ command otherwise modem
will not work with Kannel.
12. We can check if our modem is detected or not by this command > ls /dev . If modem is being
detected then we will see ttyACM0 / ttyUSB0 in result.
13. To check whether’ AT+CNMI’ command is supported on the modem or not we have to test it
through serial port. In Linux we can open our device through serial port using ‘minicom’.

5. If get error in return then you cannot use that modem with Kannel and if you get out put something like
above then you can use that modem with Kannel.
14. Now run the bearerbox by this command
 bearerbox smskannel.conf
15. Now run smsbox by this command opening a new terminal and going into directory
 smsbox smskannel.conf
16. smskannel.conf for Motorola Razer V3 is given below
*******************************smskannel.conf starts here********************************
# 1% gw/bearerbox gw/smskannel.conf
# 2% gw/smsbox gw/smskannel.conf
# 3% test/fakesmsc -i 0.1 -m 100 "123 345 text nop"
# CORE
# There is only one core group and it sets all basic settings
# of the bearerbox (and system). You should take extra notes on

6. # configuration variables like 'store-file' (or 'store-dir'),
# 'admin-allow-ip' and 'access.log'
group = core
admin-port = 13003
smsbox-port = 13004
admin-password = bar
#status-password = foo
#admin-deny-ip = ""
#admin-allow-ip = ""
log-file = "/usr/local/Log/kannel.log"
box-deny-ip = "*.*.*.*"
box-allow-ip = "127.0.0.1"
access-log = "/usr/local/Log/access.log"
#-----------------Modem Group------------
group = modems
id = motorola
name = "ATI 144"
detect-string = "Motorola"
init-string = "AT0"
init-string= "ATQ0 V1 E1 S0=0 &C1 &D2 +FCLASS=0"
init-string = "AT+CNMI=3,2,0,0,0"
init-string = "AT+CMEE=2;+CNMI=3,1,0,0,0"
reset-string = "ATZ"
speed=115200

7. need-sleep = true
keepalive-cmd = "AT+CBC;+CSQ"
enable-mms = true
message-storage="SM"
#-------------------------------------------
# SMSC CONNECTIONS
#this is for Motorola Razer V3i
group = smsc
smsc = at
smsc-id = Motorola Razer V3i
modemtype = motorola
device=/dev/ttyACM0
my-number = 00923457055195
sms-center= 00923330005150
connect-allow-ip = 127.0.0.1
log-level = 0
#---------------------------------------------
# SMSBOX SETUP
group = smsbox
bearerbox-host = 127.0.0.1
sendsms-port = 13013
global-sender = 13013
#sendsms-chars = "0123456789 +-"
#log-file = "/tmp/smsbox.log"
#log-level = 0

8. #access-log = "/tmp/access.log"
#---------------------------------------------
# SEND-SMS USERS
# These users are used when Kannel smsbox sendsms interface is used to
# send PUSH sms messages, i.e. calling URL like
# http://kannel.machine:13013/cgi-bin/sendsms?username=tester&password=foobar...
group = sendsms-user
username = tester
password = foobar
#user-deny-ip = ""
#user-allow-ip = ""
#---------------------------------------------
# SERVICES
group = sms-service
keyword = nop
text = "You asked nothing and I did it!"
# There should be always a 'default' service. This service is used when no
# other 'sms-service' is applied.
group = sms-service
keyword = default
text = "Kannel Configured by Mahtab Rasheed: Reply from Kannel"
catch-all = yes
max-messages = 1

9. group = sms-service
keyword = Mahtab
text = "How are u Mahtab?"
group = sms-service
keyword = majid
text = "How are u Majid Hussain?"
group = sms-service
keyword = hammad
text = "Sir we are fine....This message is from Sir Hammad"
*******************************smskannel.conf ends here*********************************