Difference between revisions of "OpenBTS: Yate Softswitch"

Revision as of 04:02, 3 August 2012

Yate adalah sebuah mesin untuk routing message yang sangat flexible. Yate di rancang untuk dapat di jalankan mulai dari switch SIP yang sangat besar hingga SIP client yang di jalankan di pesawa telepon. Proses instalasi Yate akan di jelaskan di sini.

Install Aplikasi Pendukung

Install

sudo apt-get install build-essential autoconf cvs sox pkg-config

Yate Install

Untuk interoperability dengan OpenBTS, kita perlu menginstalasi libgsm1-dev SEBELUM mengbuat Yate. Tanpa library tersebut, yate tidak akan mendukung codec gsm dan kita akan melihat message berikut:

<yrtp:WARN> Wrapper neither format nor payload specified [0x1b014b0]

Untuk mengatasi hal ini, kita perlu menginstalasi libgsm1-dev melalui perintah berikut,

sudo apt-get install libgsm1-dev

Download source code dari

http://yate.null.ro/pmwiki/index.php?n=Main.Download

Compile menggunakan perintah

cp yate-4.1.0-1.tar.gz /usr/local/src/
cd /usr/local/src/
tar zxvf yate-4.1.0-1.tar.gz 
cd /usr/local/src/yate
./configure
make clean
make all
make install

atau

cd /usr/local/src/yate
./configure
./autogen.sh

Pastikan bahwa codec gsm telah berhasil di instalasi dengan baik dengan lihat adanya file "modules/gsmcodec.yate"

ls /usr/local/src/yate/modules/
ls /usr/local/src/yate/modules/gsmcodec.*

harusnya ada

/usr/local/src/yate/modules/gsmcodec.cpp
/usr/local/src/yate/modules/gsmcodec.yate

Pastikan bahwa yate telah di instalasi dengan baik di lokasi default dengan melihat adanya file /usr/local/share/yate/scripts

 ls /usr/local/share/yate/scripts

Library Lain

Kita memerlukan dua library untuk melakukan routing di yate, yaitu:

Python Messaging https://github.com/pmarti/python-messaging
libvbts https://github.com/kheimerl/libvbts

Proses instalasi yang perlu dilakukan adalah,

cd /usr/local/src
git clone git://github.com/pmarti/python-messaging
git clone git://github.com/kheimerl/libvbts
cd /usr/local/src/python-messaging/
sudo python setup.py install
cd /usr/local/src/libvbts/
sudo python setup_yate.py install

Yate Configuration

Ada beberapa file yang perlu di ubah untuk mengkonfigurasi yate dengan OpenBTS. File ini berlokasi di /usr/local/etc/yate/

ysipchan.conf

ysipchan mengkonfigurasi sip module. Kita perlu memberitahukan yate untuk membuat SIP MESSAGE event.

vi /usr/local/etc/yate/ysipchan.conf

Di bagian [general], tambahkan : OpenBTS: Yate Softswitch

[general]
maxpkt=4096
generate=yes

dan, di blok [methods], tambahkan :

[methods] 
message=yes

regexroute.conf

regexroute.conf control routing dari paket tertentu. Kita menggunakan regexroute.conf untuk mematikan authorization of messages.

vi /usr/local/etc/yate/regexroute.conf

Di blok [extra] tambahkan

[extra]
;skipping auth step
user.auth=20

Tambahkan aturan routing yang sebenarnya di akhir file. Perhatikan block ini tidak ada, kita harus menambahkannya:

[user.auth]
.*=return true

extmodule.conf

extmodule.conf mengontrol external modul yate. libvbts mengimplementasi beberapa hal yang dibutuhkan untuk operasi OpenBTS. Kita perlu mengaktif module tersebut, dengan mengedit

vi /usr/local/etc/yate/extmodule.conf

Pada block [scripts] isi:

[scripts]
VBTS_SMS_Route.py=50
VBTS_Call_Route.py=10
VBTS_Echo_SMS.py=10|vbts_tp_dest_address|^100$

Variabel ini menset prioritas penanganan message dan / atau regex yang menyebabkan bagaimana cara message di tangani.

OpenBTS configuration

Hanya perlu satu perubahan parameter untuk operasi dengan openbts: kita perlu mengarahkan OpenBTS di yate agar dapat menangani messages, ini dilakukan di OpenBTS command line:

config SIP.Proxy.SMS {YATE_IPADDRESS}:{YATE_PORT}

yate monitor port berikut

TCP 1720: untuk H323
UDP 4569: untuk IAX2 
UDP 5060
TCP 5038: Telnet admin app

Yate Use

Dengan perubahan tersebut, yate akan secara automatis akan me-route voice / sms message. Lihat catatan yate berikut ini:

Run

Menjalankan yate menggunakan perintah

cd /usr/local/src/yate
./run

RManager

RManager adalah CLI engine Yate. Ini memungkinkan Yate untuk di control melalui telnet yang sederhana. RManager dapat di akses menggunakan perintah telnet berikut (asumsi kita beroperasi di localhost):

telnet localhost 5038

Perintah dalam RManager

Available commands:
  quit
  echo [on|off]
  help [command]
  auth password
  status [overview] [modulename]
  uptime
  machine [on|off]
  output [on|off]
  color [on|off]
  debug [module] [level|on|off]
  drop {chan|*|all} [reason]
  call chan target
  control chan [operation] [param=val] [param=...]
  reload [plugin]
  restart [now]
  stop [exitcode]
  alias [name [command...]]
  module {{load|reload} modulefile|unload modulename|list}
  events [clear] [type]
  logview 
  status jabber [stream_name|{c2s|s2s} [remote_jid]]
  jabber drop {stream_name|{c2s|s2s|*|all} [remote_jid]}
  jabber create remote_domain [local_domain] [parameter=value...]
  jabber debug stream_name [debug_level|on|off]
  callgen {start|stop|drop|pause|resume|single|info|reset|load|save|set paramname[=value]}
  filetransfer {{send|receive} filename [callto:]target [[paramname=value]...]}
  accounts [reload|{login|logout|...} [account]]
  users {add user [parameter=value...]|delete user|update user [parameter=value...]}
  sigdump component [filename]
  cache {load|flush} cache_name [[param=value]...]

Referensi

Pranala Menarik

OpenBTS

Persiapan

Ettus E110

Power Amplifier

Lain Lain

Catatan Legal dan Pendukung

Catatan Sejarah

Dokumentasi Video

@@ Line 1: / Line 1: @@
-Yate adalah sebuah mesin untuk routing message yang sangat flexible. Yate di rancang untuk dapat di jalankan mulai dari switch SIP yang sangat besar hingga SIP client yang di jalankan di pesawa telepon. Proses instalasi Yate akan di jelaskan di sini.
+[[Yate]] adalah sebuah mesin untuk routing message yang sangat flexible. [[Yate]] di rancang untuk dapat di jalankan mulai dari switch [[SIP]] yang sangat besar hingga [[SIP]] client yang di jalankan di pesawa telepon. Proses instalasi Yate akan di jelaskan di sini.
+==Install Aplikasi Pendukung==
+Install
+ sudo apt-get install build-essential autoconf cvs sox pkg-config
 ==Yate Install==
-Untuk interoperability dengan OpenBTS, kita perlu menginstalasi libgsm1-dev SEBELUM mengbuat Yate. Tanpa library tersebut, yate tidak akan mendukung codec gsm dan kita akan melihat message berikut:
+Untuk interoperability dengan [[OpenBTS]], kita perlu menginstalasi libgsm1-dev SEBELUM mengbuat Yate. Tanpa library tersebut, yate tidak akan mendukung codec gsm dan kita akan melihat message berikut:
   <yrtp:WARN> Wrapper neither format nor payload specified [0x1b014b0]
@@ Line 44: / Line 50: @@
-Pastikan bahwa yate telah di instalasi dengan baik di lokasi default dengan melihat adanya file /usr/local/share/yate/scripts
+Pastikan bahwa [[yate]] telah di instalasi dengan baik di lokasi default dengan melihat adanya file /usr/local/share/yate/scripts
    ls /usr/local/share/yate/scripts
@@ Line 51: / Line 57: @@
 ==Library Lain==
-Kita memerlukan dua library untuk melakukan routing di yate, yaitu:
+Kita memerlukan dua library untuk melakukan routing di [[yate]], yaitu:
 * Python Messaging https://github.com/pmarti/python-messaging
@@ Line 77: / Line 83: @@
 Di bagian [general], tambahkan :
+OpenBTS: Yate Softswitch
   [general]
   maxpkt=4096