Instalación de Kannel 1.5.0 en Centos 5.5 (Compilado)

Kannel is a compact and very powerful open source WAP and SMS gateway, used widely across the globe both for serving trillions of short messages (SMS), WAP Push service indications and mobile internet connectivity.

Kannel es un compacto y muy poderoso WAP/SMS gateway Open Source, usado al rededor del planeta para servir trillones de mensajes cortos de textos, servicios WAP y conectividad de internet en dispositivos móbiles.

En un principio, la intención de este proyecto era instalar un SMPP Proxy Server con OpenSMMPBox. Lamentablemente, el performance de recepción en el mejor de los casos fue de 2 SMS por segundo, así que terminé desarrollando mi propio SMPP Server con las librerías JSMPP. Sin embargo, aunque el  SMPP Server no brinde resultados optimos, el resto de los servicios que ofrece es impresionante, así que vale la pena echarle un vistazo.

Este "how to" explica el proceso de instalación de Kannel en Centos 5.0.

La recomandación antes de inciar cualquier instalación de Kannel es actualizar el kernel del sistema operativo, esto con la intención de facilitar la instalación de cualquier modem GSM para el envío de SMS. El proceso de actualización del kernel esta descrito en este otro artículo.

Lo primero que vamos a hacer es crear el usuario kannel y el grupo kannel:

# groupadd kannel
# useradd -g kannel kannel

Ahora instalamos las dependencias básicas para la compilación en Centos, el equivalente al paquete build-essential de Ubuntu. Adicionalmente aprovechamos para instalar MySQL.

# yum groupinstall "Development Libraries" "Development Tools"  "MySQL Database"
# yum install mysql-devel.i386

Ahora descargamos el código fuente del repositorio SVN del proyecto.

# mkdir -p /usr/src/kannel
# cd /usr/src/kannel
# svn co https://svn.kannel.org/gateway/trunk 
# mv trunk gateway

 # cd /usr/src/kannel
# svn co https://svn.kannel.org/sqlbox/trunk
# mv trunk sqlbox

 # cd /usr/src/kannel
# svn co https://svn.kannel.org/opensmppbox/trunk
# mv trunk opensmppbox

Ahora compilamos módulo por módulo:

# cd gateway
# ./configure --prefix=/usr/local/kannel --with-mysql --with-mysql-dir=/usr/lib/mysql/ --enable-debug --enable-assertions --with-defaults=speed --disable-localtime --enable-start-stop-daemon --enable-pam
# touch .depend
# make depend
# make
# make bindir=/usr/local/kannel install

# cd sqbox
# ./bootstrap
# ./configure --prefix=/usr/local/kannel --with-kannel-dir=/usr/local/kannel
# make
# make bindir=/usr/local/kannel/sqlbox install
 

# cd opensmppbox
# ./configure --prefix=/usr/local/kannel --with-kannel-dir=/usr/local/kannel
# make
# make bindir=/usr/local/kannel/smppbox install

Ahora creamos los directorios del sistema:

# mkdir /etc/kannel
# mkdir /var/log/kannel
# chmod 755 /var/log/kannel

Y puedes usar como ejemplo los archivos de configuración de ejemplo, sin embargo es importante leer con detalle la documentación.

# cp /usr/local/src/kannel/gateway/gw/smskannel.conf /etc/kannel/kannel.conf
# cp /usr/local/src/kannel/gateway/debian/kannel.default /etc/default/kannel
# cp /usr/local/src/kannel/gateway/debian/kannel.init /etc/init.d/kannel
# cp /usr/local/src/kannel/sqlbox/example/sqlbox.conf.example /etc/kannel/sqlbox.conf
# cp /usr/local/src/kannel/smppbox/example/opensmppbox.conf.example /etc/kannel/opensmppbox.conf
# cp /usr/local/src/kannel/smppbox/example/smpplogins.txt.example /etc/kannel/smpplogins.txt

Es importante insistir en revisar con detalle la documentación del proyecto. El esquema de trabajo se parece bastante al de Bacula. Se debe configurar cada módulo por separado (smsc, modems, gateway, wapbox, etc, etc, etc). Es un esquema de configuración modular.

Y ahora solo resta iniciar los servicios:

# /usr/local/kannel/sbin/bearerbox -v 1 /etc/kannel/kannel.conf &
# /usr/local/kannel/sbin/smsbox -v 1 /etc/kannel/kannel.conf &
# /usr/local/kannel/sbin/opensmppbox -v 1 /etc/kannel/opensmpp.conf &
 

Más información en:

http://www.kannel.org/download/1.5.0/userguide-1.5.0/userguide.html