When you start Kannel, it attempts to start all the configured SMSC binds. While this is usually what most people needs, there might be some cases when you don’t want all your binds to come up at once:

• Failover routes that you manually enable when needed.
• New binds being worked out, not ready for production.
• Test binds you use only from time to time.
• Etc.

This patch allows you to configure in which state a bind will start when booting (or when adding it with the add-smsc command). This is done by a new parameter on the smsc group called start-at-boot, which defaults to true if not present.

In short: just add the following line to an smsc group:

start-at-boot = false

and that smsc will start as “dead” and will require a start-smsc command to activate it.

Download the patch from here.

As usual, this is fairly untested code and should be used with caution.

Please try it and let me know if you encounter any issues.

Alex

This is a nice-to-have feature IMHO, since right now you can only tell how many messages per second Kannel is sending globally, but not on a per-smsc basis.

This patch addresses that, adding to each smsc the same three counters Kannel uses for global traffic.

NOTE: The text and XML schema on the status page changed to accommodate the new counters, so if you’re parsing it from your code you’ll probably need to make a few changes to be able to parse it correctly.

Please download the patch from here.

As with most new patches, proceed with caution and test it thoroughly before using it on live systems.

Regards,

Alex

This patch implements syslog logging on bearerbox, smsbox and wapbox.

It uses two configurable parameters:

To use it, you need to add syslog-level and syslog-facility to the core, smsbox and/or wapbox group. You might also need to tweak your /etc/syslog.conf to suit your needs (I won’t teach you how to configure syslog here, you can Google it yourself isn’t it? ).

Please download the patch from here.

NOTE: This is fairly untested and it’s not part of Kannel’s main tree, so use it with caution.

Give it a spin and let me know if it works for you.

Alex

A lot of stuff has been happening lately on the Kannel project: lots of new patches, bug fixes and even a brand new development release.

With the release of Kannel 1.5.0 Development Version on Oct. 20th., Sqlbox is now part of Kannel’s distribution.

This is really great news, because you’ll get SqlBox along with Kannel.

You’ll also get OpenSmppBox as well (an Open Source SMPP server implementation for Kannel).

You can get the new release on the Downloads Page as usual. Browse down to the Development Release section.

Hope you enjoy it!

Alex

This patch adds separate dlr counters on the status page.

If you use dlrs (Delivery Receipts) with Kannel, you’ve noticed that they’re counted along with MO traffic as incoming messages.

This leads to misunderstandings on how much incoming traffic you’re really sustaining: For example on SMPP, if you request dlrs, depending on the carrier having it enabled or not, you’ll get one or two more “incoming” messages counted (dlrs are very similar to mo messages in structure).

After applying this patch, the status page will display incoming and dlr traffic on separate counter, either for the total amouns as in each and every defined smsc connection. It will also display separate load indicators, so you’ll know at all times if your inbound traffic is actually traffic or just old/delayed dlrs.

Here’s the patch:

kannel-dlr-status

As usual, please try it and let me know what you think.

Alex

Though kannel already has some pam functionality included, it’s far from optimal imho.

As it is now, to use pam authentication you have to:

1. Configure with –enable-pam and compile.
2. Create an smsbox-user called “pam” with a dummy password.
3. Create a pam configuration file called “kannel” on /etc/pam.d/, with your pam settings.
4. Kannel will then use only pam for authentication, so you could use LDAP, Radius or whatever supported authentication modules you have configured on the box.

However:

* Other smsbox-user‘s are disabled, only the “pam” user is allowed to authenticate.
* All users would get logged as “pam”, so you cannot make settings per users of any kind.
* Only one pam group is allowed.

After applying the patch, pam authentication gets managed with a special group sendsms-pam-user, which shares most of sendsms-user parameters, except for username and password, and adds the acl parameter instead.

group = sendsms-pam-user
acl = kannel
<other sendsms-user parameters>

* You can define as many groups as needed, pointing to different pam configuration files.
* The acl parameter points to the pam module on /etc/pam.d/ (“kannel” in this case, but could be anything you want).
* Pam authentication is only attempted after trying the regular sendsms-user way, so you can have local users and pam users at the same time (local taking precedence).
* Each sendsms-pam-user group will be logged separately, and you’ll also get info about the pam user making the call.

To use the patch:

1. Download the patch here and apply it.
2. Run ./bootstrap.sh
3. Run ./configure –enable-pam
4. make and make install as usual.

As usual, please try it and let me know what you think.

-Alex

With the addition of meta-data functionality in Kannel, now it’s possible to pass meta-data between different smsc’s and services.

When defining services or urls to send messages, the new %D parameter gets replaced with the complete meta-data information available.

However, there wasn’t any way to use only part of that data when posting to url’s. This is why I’ve created this patch that allows you to use individual meta-data fields in your urls.

USAGE

To use it, a new set of parameters is defined, with the following format:

%#group#parameter#

Where group is the meta-data group (for example: smpp, http or foo) and parameter is the individual meta-data parameter you want to replace.

For example, let’s suppose we’re using a generic http-smsc, and we want to pass a couple of extra parameters for a dynamic username and password (some aggregators do that). Right now, that would require patching the source code and inventing some method to pass the extra parameters from the sendsms interface.

With the patch applied, this would be as simple as this:

1. Pass the meta-data parameter on the sendsms request (urlencoded):

?http?user=Alex&pass=bar

2. Define the send-url parameter on your http-smsc to pass those parameters:

send-url = http://myhost/sms?….&username=%#http#user#&password=#http#pass#

Note: I’m defining the http group here, but it could be anything, even the smpp group coming from an smpp bind, in which case the syntax would be #smpp#username# instead.

Download the patch from here.

Please try it and let me know if it works for you.

This patch allows you to change the parameter names used when receiving incoming messages (MO’s) using the generic http-smsc.

To use it, you need to add a few extra entries for the parameters you want to be redefined. The format is: generic-param-<original-name> = <new-name>

For example, to redefine from, to, smsc and text:

generic-param-from = “phoneNumber”
generic-param-to = “shortCode”
generic-param-text = “message”
generic-param-smsc = “carrier”

That’s it, you’ll be able to use an url like this then:

http://myhost:myport/sms?phoneNumber=234567890&shortCode=1234&message=Hello+World&carrier=mycarrier

Download the patch from here.

As usual, try it and let me know.

-Alex

I’ve just updated SqlBox. Version 0.7.2 adds:

* rpm target (already on the latest snapshot). You can now run ./configure and then make rpm to build an RPM!
* Support for MS-SQL and Sybase over FreeTDS. You need a current Kannel snapshot to support this.
* Some code cleanups.

You can get it from here.

As usual, try it and let me know what you think.

Alex

If you’re using an external DB for dlr storage, there’s a slight chance that the carrier’s response to your MT (with the dlr information) would arrive after the dlr itself. If this happens, Kannel won’t be able to find the dlr (because it’s not there yet).

This patch implements an sleep and retry mechanism when calling dlr_get(). This aims to solve that problem.

2 new core parameters are defined:

dlr-retry-count -> How many times do we attempt to fetch the dlr? Default: 1
dlr-retry-delay -> How many milliseconds do we sleep before retrying? Default: 0

So, if you don’t set these parameters the behaviour remains as it was before patching. However, if you, for instance, set:

dlr-retry-count = 3
dlr-retry-delay = 200

Kannel will try 3 times in total (the original plus 2 more), pausing 200ms (0.2 seconds) before each attempt. If after the third attempt the DLR’s still missing, Kannel will display a warning as usual.

Download the patch from here: kannel-dlr-retry

Please try it and let me know what you think.

Regards,

Alex