Panduan
Pembuatan SMS Gateway di Linux Ubuntu
Hardware Requirement
Spesifikasi Minimum : Processor :
Intel P4 1.8GHZ
RAM : 256MB
Hardisk : 80GB
Modem atau handphone kompabilitynya bisa di cek di sini
Software Requirement
Kebutuhan Paket Software :
- Linux Ubuntu
- Apache 2.x.x
- PHP 5.x.x (with mysql, session, hash, json extension)
- PHP-CLI
- MySQL 5.x.x
- Gammu
- Kalkun
Instalasi
Install LAMP
- Install package ;
$
sudo tasksel install lamp-server
- Dalam proses instalasi akan di tanyakan untuk membuat
passsword user dan password mysql
user
: root
passwd
: root
- Install PHP-CLI [penting]
$
sudo apt-get install php5-cli
- Install PHPMYADMIN [optional]
$
sudo apt-get install phpmyadmin
- Dalam proses instalasi akan di tanyakan passsword user
dan password mysql
user
: root
pass
: root
Install GAMMU
- Update dan install aplikasi gammu dan gammu-smsd dengan
perintah berikut ;
$
sudo apt-get update
$
sudo apt-get install gammu gammu-smsd
- Untuk melihat konfigurasi port device, gunakan perintah
berikut :
$
dmesg | grep tty
[12321.308078]
usb 5-3: GSM modem (1-port) converter now attached to ttyUSB0
[12321.308275]
usb 5-3: GSM modem (1-port) converter now attached to ttyUSB1
- Konfigurasi Gammu terlebih dahulu ;
$
sudo gammu-config
- Isi dengan variabel seperti dibawah dan pilih Save ;
port
= /dev/ttyUSB0 # disesuaikan
connection
= at115200 # disesuaikan
synchronizetime
= yes
logfile
= /var/log/gammulog
logformat
= textall
use_locking
= # isi yes jika ingin resource modem di kunci
- Perintah diatas akan menyimpan file config dengan nama
.gammurc di home user : ~/.gammurc
- Konfigurasi berkas /etc/gammu-smsdrc
[gammu]
port
= /dev/ttyUSB0 # change this
connection
= at115200 # change this
[smsd]
PIN
= ''
service
= sql
phoneid
= Modem1
driver
= native_mysql
DeliveryReport
= sms
logfile
= /var/log/smsdlog
debuglevel
= 1 # change to 255 if you want to debug
sendtimeout
= 30
checksecurity = 0
user
= root # change this
password
= root # change this
pc
= localhost
database
= kalkun
runonreceive
= /var/www/kalkun/scripts/daemon.sh
- WARNING!!
untuk menggunakan perintah gammu, matikan dulu service gammu-smsd.
Pastikan dengan cara ;
$
sudo /etc/init.d/gammu-smsd stop
- Kemudian baru bisa cek identify modem dengan perintah ;
$
sudo gammu --identify
Device : /dev/ttyUSB0
Manufacturer : huawei
Model : E220 (E220)
Firmware : 11.117.10.02.00
IMEI : 351827014879XXX
SIM
IMSI : 510012541759XXX
- Untuk testing pengiriman SMS menggunakan perintah
berikut ;
$
sudo gammu --sendsms text 0857257XXXXX
Enter
the message text and press Ctrl+D:
test
server
If
you want break, press Ctrl+C...
Sending
SMS 1/1....waiting for network answer..OK, message reference=3
- Untuk cek pulsa (ex.simpati) ;
$
sudo gammu --getussd *888#
Press
Ctrl+C to break...
USSD
received
Status
: No action needed
Service
reply : “Sisa Pulsa Anda Rp.4950. Penggunaan pulsa di periode ini Rp.11150.
Aktif s.d. 14/05/2011. Cari t4 menarik dsekitarmu dgn TelkomselLacak. Hub
*123*55#”
- Setelah itu, jalankan service gammu-smsd untuk aplikasi
kalkun ;
$
sudo /etc/init.d/gammu-smsd start
Install Kalkun
Kalkun merupakan open source
berbasis web SMS (Short Message Service) manajemen, itu menggunakan gammu-smsd
(bagian dari keluarga gammu) sebagai mesin SMS gateway untuk menyampaikan dan
mengambil pesan dari telepon / modem.
Fitur-fitur
- Memiliki lebih dari satu pengguna (Multi User);
- Threated SMS.
- Memiliki lebih dari satu telepon / modem? Beberapa
modem yang tepat bagi Anda.
- Kirim SMS berulang kali (SMS Bomber);
- Ingin membuat SMS berbasis masyarakat? Anggota SMS akan
membantu Anda.
- Forward SMS ke Email;
- SMS Iklan untuk pesan Anda.
- Lelah mengetik SMS yang sama lagi dan lagi? Template
SMS adalah yang Anda butuhkan.
- Ingin membuat program Anda sendiri tetapi tidak ingin
menyentuh kode Kalkun? Script eksternal adalah solusinya.
- Mari kita menendang spammer dengan Spam Filter.
- Jawaban SMS secara otomatis dengan Autoreply Sederhana.
- Kirim SMS dari aplikasi lain menggunakan API.
Tahapan Installasi
- Download aplikasi Kalkun di sini http://sourceforge.net/projects/kalkun/files
$
wget -c http://nchc.dl.sourceforge.net/project/kalkun/kalkun/X.X/kalkun_X.X.zip
- Buat folder web Kalkun dan ekstrak file ;
$
sudo mkdir /var/www/kalkun
$
sudo mv kalkun_X.X.zip /var/www/kalkun
$
cd /var/www/kalkun/
$
sudo unzip kalkun_X.X.zip
- Buat database kalkun
$
mysql -u root -p
mysql>
CREATE DATABASE kalkun;
mysql>
quit
- Edit config Kalkun database di
/var/www/kalkun/application/config/database.php
$db['default']['hostname']
= "localhost";
$db['default']['username']
= "root"; // change this
$db['default']['password']
= "root"; // change this
$db['default']['database']
= "kalkun"; // change this
$db['default']['dbdriver']
= "mysql";
- Ekstrak example database struktur Gammu agar bisa di
import, caranya ;
$
sudo gunzip /usr/share/doc/gammu/examples/sql/mysql.sql.gz
- Import konfig database struktur Gammu;
$
mysql kalkun -u root -p < /usr/share/doc/gammu/examples/sql/mysql.sql
- Konfigurasi path daemon di
/var/www/kalkun/scripts/daemon.sh, menjadi dibawah ini ;
#!/bin/sh
#
Configure this (use absolute path)
PHP=/usr/bin/php
# php cli path
DAEMON=/var/www/kalkun/scripts/daemon.php
# daemon.php path
#
Execute
$PHP
$DAEMON
- Jangan lupa juga cek path konfigurasi
/var/www/kalkun/scripts/daemon.php dibagian;
$url
= "http://localhost/kalkun";
- Buka web browser mengarah ke http://localhost/kalkun/ dan selanjutnya akan terjadi proses instalasi.
- Pada akhir instalasi ada pesan gagal untuk menghapus
folder install, hapus secara manual ;
$
sudo rm -rf /var/www/kalkun/install
- Akses http://localhost/kalkun/ kembali dengan user dan pass default user=kalkun
pass=kalkun.
Troubleshooting
Startup Daemon
Untuk menjalankan daemon setiap kali
komputer restart, ketik perintah berikut ;
$
sudo update-rc.d gammu-smsd defaults
Log Membengkak
Agar log tidak membengkak, berikut
tahapan untuk mengatasi hal tersebut, sebaiknya anda menggunakan hak akses
superuser atau root :
- Sesuaikan tempat penyimpanan berkas log, misal di
/etc/smsdlog
- Membuat berkas smsdlog di /etc/logrotate.d/
$
sudo vim /etc/logrotate.d/smsdlog
- Membuat berkas smsdlog di /etc/logrotate.d/ :
/var/log/smsdlog
{
daily
missingok
rotate
7
compress
delaycompress
create
640 root root
endscript
}
- Selanjutnya membuat penjadwalan menggunakan perintah
crontab :
$
sudo su
#
crontab -e
- Isi dengan baris dibawah ini, agar daemon gammu-smsd
di-restart setiap jam 06.50
50
6 * * * /etc/init.d/gammu-smsd restart
Error database struktur
Jika dilihat kembali pesan error-nya
: Database structures version: 11, SMSD current version: 12, maka sebaiknya
lakukan perintah dibawah ini pada database server yang digunakan dalam hal ini
adalah MySQL.
$
mysql -u root -p
mysql>
UPDATE `kalkun`.`gammu` SET `Version` = '12' WHERE `gammu`.`Version` =11;
mysql>
quit
Connect/Disconnect di Kalkun
Connect/Disconnect di Kalkun hanya
perkiraan dari waktu terakhir gammu-smsd mengupdate aktifitas dengan waktu
sekarang. Defaultnya adalah 10 menit, bisa diganti di file
/var/www/kalkun/application/config/kalkun_settings.php,
$config['modem_tolerant']
= ’10′;
Beberapa mungkin yang bisa di
konfigurasi;
$config['sms_bomber']
= FALSE;
$config['enable_emoticons']
= FALSE;
$config['sms_advertise']
= FALSE;
$config['sms_advertise_message']
= "This is ads message";
Modem Tidak terdeteksi
Ketika melakukan perintah dmesg dan
tidak menemukan modem terknoneksi, berikut langkah solusinya (ex. Modem Huawei
e1550) ;
- Install package usb-modeswitch
$
sudo apt-get install usb-modeswitch
- Buat rule baru untuk udev:
$
sudo vim /etc/udev/rules.d/15-huawei-155x.rules
- Ketik dengan isian berikut :
SUBSYSTEM=="usb",
ATTRS{idProduct}=="1446",
ATTRS{idVendor}=="12d1",
RUN+="/lib/udev/modem-modeswitch
--vendor 0x$attr{idVendor} --product 0x$attr{idProduct} --type
option-zerocd"
- Simpan dan cabut modem dan colokkan kembali. Untuk
keterangan idProduct dan idVendor dapat di temukan dari perintah berikut ;
$
sudo lsusb -v | less
Bus
005 Device 004: ID 12d1:1446 Huawei Technologies Co., Ltd. E220 HSDPA Modem /
E270 HSDPA/HSUPA Modem
Device
Descriptor:
bLength 18
bDescriptorType 1
bcdUSB 2.00
bDeviceClass 0 (Defined at Interface level)
bDeviceSubClass 0
bDeviceProtocol 0
bMaxPacketSize0 64
idVendor 0x12d1 Huawei Technologies Co.,
Ltd.
idProduct 0x1446 E220 HSDPA Modem / E270
HSDPA/HSUPA Modem
bcdDevice 0.00
iManufacturer 2 HUAWEI Technology
iProduct 1 HUAWEI Mobile
iSerial 0
bNumConfigurations 1
Memindahkan
Port USB Modem, Service menjadi tidak berjalan
Kasus ini terjadi jika Anda memindah
modem ke port USB yang lain. Maka service tidak akan berjalan, karena config
masih mendeteksi lokasi port USB sebelumnya.
- Cek perubahan port menggunakan perintah wvdial :
$
sudo wvdialconf
$
cat /etc/wvdial.conf
[Dialer
Defaults]
Init1
= ATZ
Init2
= ATQ0 V1 E1 S0=0 &C1 &D2 +FCLASS=0
Modem
Type = Analog Modem
;
Phone = <Target Phone Number>
ISDN
= 0
;
Password = <Your Password>
New
PPPD = yes
;
Username = <Your Login Name>
Modem
= /dev/ttyUSB1
Baud
= 9600
- Tampak pada konfigurasi wvdial posisi modem pada
ttyUSB1, kemudian ubah konfigurasi dan sesuaikan port USBnya pada file
/root/.gammurc dan /etc/gammu-smsdlog.
Debugging Web Kalkun
Untuk mengidentifikasi error pada
web Kalkun, aktifkan log debugging pada config Kalkun seperti cara berikut ;
$sudo
vim kalkun/application/config/config.php
Ubah baris log_treshold menjadi
seprti berikut
$config['log_threshold']
= 4;
Akses menggunakan browser dengan
alamat berikut ;
Startup Daemon Bermasalah Ketika
Restart Server
Kendala ini ketika server sms
restart secara tidak sengaja karena masalah kelistrikan service gammu-smsd
tidak bisa melakukan auto startup daemon padahal sudah kita set secara
automatis. Hal ini bisa diakali dengan menambahkan script start service gammu
pada file rc.local. Langkah-langkahnya sebagai berikut :
Hapus Auto Daemon gammu dengan
perintah dibawah ini
$
sudo update-rc.d -f gammu-smsd remove
Kemudian edit file /etc/rc.local,
kemudian tambahkan baris menjadi seperti dibawah ini
#!/bin/sh
-e
#
#
rc.local
#
#
This script is executed at the end of each multiuser runlevel.
#
Make sure that the script will "exit 0" on success or any other
#
value on error.
#
#
In order to enable or disable this script just change the execution
#
bits.
#
#
By default this script does nothing.
sleep
10
/etc/init.d/gammu-smsd
start
exit
0
