kpage - pager utilites for Kannel SMS gateway

Copyright (c) 2005 Stanislav Sinyagin 


OVERVIEW

The package consists of two programms:

kpage:
sends an SMS to a given GSM number. It generates a unique message ID and
stores its status in a database.

kpage_confirm.cgi:
a CGI script that is called by the Kannel daemon for delivery reports.

Both utilities record each event in a log file.


INSTALLATION

Install the following Perl modules from CPAN:
  LWP::UserAgent
  URI
  Log::Agent
  DBD::DBM
  Digest::MD5


Supply ./configure with options specific to your system.
Example:

./configure --prefix=/opt/kpage \
            cgidir=/opt/csw/apache/perl \
            statedir=/var/lib/kpage

In this example, the package components will be instaled under /opt/kpage,
and the CGI placed in the mod_perl repository.
The database will be created in /var/lib/kpage.

Run "make install"

Change configuration options. Look into the file "kpage-config.pl"
(/opt/kpage/share/kpage/kpage-config.pl in this example) for default options,
and overwrite them in "kpage-siteconfig.pl"
(/opt/kpage/etc/kpage-siteconfig.pl in this example).


Set the common files and directories group writable and owned
by the group that your Apache daemon uses (group "nobody" in this example):

chgrp nobody /var/log/kpage.log
chmod g+w /var/log/kpage.log

chgrp nobody /var/lib/kpage/
chmod g+ws /var/lib/kpage/


Initialize the database: "/opt/kpage/bin/kpage --initdb"

Now kpage is ready to use.


USAGE

Sending messages:

/opt/kpage/bin/kpage --send --to=012345678,023456798 --text='Hello world!'

List unconfirmed messages:

/opt/kpage/bin/kpage --list

Delete old unconfirmes messages:

/opt/kpage/bin/kpage --purge

Delete all information about unconfirmes messages:

/opt/kpage/bin/kpage --purge --all


Message events are not printed to stdout, and they are recorded
in the log file (/var/log/kpage.log by default).