SMS Server Tools Installation unter Ubuntu

SMS Server Tools 3 (smstools) sind eine SMS Gateway Software zum Versand und Empfang von Kurznachrichten (SMS) mittels GSM Modems unter Linux. Sie sind vor allem für Monitoringsysteme interessant, um Benachrichtigungen nicht nur per E-Mail, sondern auch per SMS zu versenden. Dieser Artikel zeigt wie Sie die smstools unter Ubuntu einrichten und SMS versenden. Die Anleitung wurde mit Ubuntu 12.04, 14.04, 16.04 und 18.04 getestet.

Installation

Die smstools sind bereits im Ubuntu Repository enthalten und können einfach mit folgenden Kommandos installiert werden:

sudo apt update
sudo apt install smstools

Konfiguration

In der Konfigurationsdatei /etc/smsd.conf müssen Sie die Gerätedatei (device Eintrag) des verwendeten Modems eintragen. Die folgende Tabelle zeigt die Gerätedateien von einigen von uns getesteten Modems:

Modem	Gerätedatei
CEP CT63	/dev/ttyACM0
Huawei ME909u-521 (älteres Modell)	/dev/ttyUSB0
MultiTech MTD-H5-2.0	/dev/ttyACM0
Quectel E-25G	/dev/ttyUSB2

Sollte Ihr Modem mit der oben angeführten Gerätedatei nicht funktionieren, überprüfen Sie mit dem Kommando "dmesg | grep -i usb" welche Gerätedateien Ihr Modem bereitstellt und testen Sie einfach alle bereitgestellten Dateien in der Konfiguration bis Sie eine funktionierende Konfiguration gefunden haben.

Das folgende Beispiel zeigt die Anpassungen der Konfigurationsdatei /etc/smsd.conf für die Verwendung der smstools mit einem Quectel E-25G Modem.

Zuerst passen Sie den devices Eintrag in /etc/smsd.conf an:

devices = MY_MODEM

Anschließend ergänzen Sie die folgenden Zeilen am Ende der Konfigurationsdatei /etc/smsd.conf. In diesem Beispiel wurde zuvor der PIN-Code der SIM-Karte deaktiviert (SIM Karte kurzzeitig in einem Handy einlegen und PIN-Code deaktivieren):

[MY_MODEM]
device = /dev/ttyUSB2
incoming = no
keep_open = yes
cs_convert = yes
# pin = 1234
report = no
rtscts = no
report_device_details = yes
# Generate a status file for a monitoring solution to monitor the network status of the modem
regular_run_interval = 60
regular_run_cmd = AT+CREG?;+CSQ;+COPS?
regular_run_statfile = /dev/shm/sms_stat

Damit die Konfigurationsänderungen wirksam werden, laden Sie die Konfiguration neu:

sudo service smstools restart

SMS Versand

Um eine Test-SMS zu versenden erstellen Sie eine Textdatei, die Sie anschließend mit sudo in das Verzeichnis /var/spool/sms/outgoing verschieben:

echo -e "To: 43699123456789\n\nDas ist ein Test-SMS." > Test-SMS
sudo mv Test-SMS /var/spool/sms/outgoing/

Kurz darauf wird das SMS versandt. Im Verzeichnis /var/spool/sms ist dann die Test-SMS mit Statusinformationen im Unterverzeichnis sent abgelegt:

$ cd /var/spool/sms
/var/spool/sms$ find .
.
./failed
./incoming
./outgoing
./checked
./sent
./sent/Test-SMS
$ cat ./sent/Test-SMS
To: 43699123456789
Modem: MY_MODEM
Sent: 14-07-22 07:27:00
IMSI: 232122000012345

Das ist ein Test-SMS.

Hinweis: das in manchen Anleitungen erwähnte Skript sendsms zum Verschicken von SMS ist im Ubuntu Paket als Beispiel in der Dokumentation enthalten (/usr/share/doc/smstools/examples/scripts/sendsms).

Fehlersuche

Falls beim SMS Versand Probleme auftreten, kann zur Fehlersuche der Loglevel in /etc/smsd.conf erhöht werden. Dazu entfernt man das Kommentarsymbol (#) in folgender Zeile:

loglevel = 7

Damit die Konfigurationsänderung wirksam wird, laden Sie wieder die Konfiguration neu:

sudo service smstools reload

Die in /etc/smsd.conf standardmäßig konfigurierte Logdatei enthält nur detailliertere Logging-Informationen. Sie können diese mit folgendem Kommando öffnen:

sudo less -M /var/log/smstools/smsd.log

Überwachung der SMS Server Tools

Informationen zur Überwachung der SMS Server Tools finden Sie auf exchange.icinga.com:

• check_sms3status (exchange.icinga.com)

Einzelnachweise

Autor: Werner Fischer Werner Fischer arbeitet im Product Management Team von Thomas-Krenn. Er evaluiert dabei neueste Technologien und teilt sein Wissen in Fachartikeln, bei Konferenzen und im Thomas-Krenn Wiki. Bereits 2005 - ein Jahr nach seinem Abschluss des Studiums zu Computer- und Mediensicherheit an der FH Hagenberg - heuerte er beim bayerischen Server-Hersteller an. Als Öffi-Fan nutzt er gerne Bus & Bahn und genießt seinen morgendlichen Spaziergang ins Büro.