Difference between revisions of "OpenBTS: Yate Softswitch install Ubuntu 13.04"

Latest revision as of 19:34, 25 January 2014

Sumber: http://wush.net/trac/rangepublic/wiki/yateConfig

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.

Siapkan Pendukung

Pastikan ada sambungan ke Internet, banyak aplikasi yang harus di download via Internet
Instal aplikasi pendukung

sudo apt-get install build-essential autoconf cvs sox pkg-config git-core subversion \
libgsm1-dev libgsm1 php5-cli python-setuptools

Download Yate

Source Code Yate dapat di ambil dari

Compile Yate

Untuk interoperability dengan OpenBTS, kita perlu menginstalasi libgsm1-dev SEBELUM menginstall Yate. Compile Yate

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

Cek Instalasi

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

Siapkan smspdu

Lakukan

sudo apt-get install python-pip
sudo pip install smspdu

Install script dari Kurtis Heilmerl

Pastikan anda mempunyai sambungan ke Internet yang baik.

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 https://github.com/pmarti/python-messaging.git
cd python-messaging
sudo python setup.py install

git clone https://github.com/kheimerl/libvbts.git
cd libvbts
sudo python setup.py install
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 :

[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

dalam blok [extra]

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

tambahkan

[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]
;sip.message handlers
VBTS_SMS_Provisioning.py=5
VBTS_SMS_Echo.py=10|vbts_tp_dest_address|^100$
VBTS_SMS_Route.py=50

;call.route handlers
VBTS_Route_Provisioning.py=5
VBTS_Route_Local.py=10

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:

cd /usr/local/src/openbts-2.8.0/openbts/trunk/apps
./OpenBTSCLI

OpenBTS original / yang normal

SIP.Proxy.SMS 127.0.0.1:5063

Masukan untuk Yate

config SIP.Proxy.SMS {YATE_IPADDRESS}:{YATE_PORT} #probably localhost:5060
config SIP.Proxy.Speech {YATE_IPADDRESS}:{YATE_PORT}

atau

config SIP.Proxy.SMS localhost:5060
config SIP.Proxy.Speech localhost:5060

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 & Kill

Menjalankan yate menggunakan perintah

cd /usr/local/src/yate
./run -t -l /var/log/yate -vvvv -c /usr/local/etc/yate -m /usr/local/lib/yate -e /usr/local/share/yate -d

Mematikan yate

killall yate

Melihat Log

Melihat log penting sekali untuk melihat masalah dalam konfigurasi, log yang penting

/tmp/VBTS.log
/var/log/yate

Calling

OpenBTS call melalui Yate menjadi sangat sederhana.

Yate (default) tidak memerlukan authentikasi / registrasi untuk menerima call. File configurasi default dapat menangani incoming call. Dial ke 99991002 dari handset harunya memberikan "busy tone" dari Yate. Jika ini terjadi, maka konfigurasi anda berhasil!

Daftar nomor untuk testing

99991001 dial
99991002 busy
99991003 ring
99991004 specdial
99991005 congestion
99991006 outoforder
99991007 milliwatt
99991008 info

Memaksa Yate Authentikasi

Dengan menambahkan route di regexroute.conf memaksa semua call untuk authentikasi;

${route}^$=-;error=noauth

Messaging

Yate (default) tidak merouting SIP MESSAGE.

Modifikasi ysipchan.conf untuk menerima to SIP MESSAGE. Tambahkan kalimat berikut di bagian [methods]:

message=true

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

Persiapan

Script

Ettus N210

RangeNetworks

OpenBTS: RangeNetwork Default Setting
OpenBTS: RangeNetwork Compile GNURadio UHD
OpenBTS: RangeNetwork Compile
OpenBTS: RangeNetwork Compile OpenBTS 3.1.3 *RECOMMENDED*
OpenBTS: RangeNetwork Yate Compile *RECOMMENDED*

GPRS

Briker OpenBTS

OpenBTS: Briker

FreeSWITCH OpenBTS

OpenBTS: FreeSWITCH

Power Amplifier

Lain Lain

Catatan Legal dan Pendukung

Catatan Sejarah

Dokumentasi Video

Perjuangan OpenBTS

http://www.technologyreview.com/news/522371/how-remote-places-can-get-cellular-coverage-by-doing-it-themselves/?utm_campaign=socialsync&utm_medium=social-post&utm_source=twitter

@@ Line 1: / Line 1: @@
+Sumber: http://wush.net/trac/rangepublic/wiki/yateConfig
 [[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.
@@ Line 14: / Line 16: @@
 * http://yate.null.ro/pmwiki/index.php?n=Main.Download
-* http://yate.null.ro/tarballs/yate4/yate-4.3.0-1.tar.gz
+* http://yate.null.ro/tarballs/yate5/yate-5.0.0-1.tar.gz
 ==Compile Yate==
@@ Line 20: / Line 22: @@
 Untuk interoperability dengan [[OpenBTS]], kita perlu menginstalasi libgsm1-dev SEBELUM menginstall Yate. Compile Yate
-  cp yate-4.3.0-1.tar.gz /usr/local/src/
+  cp yate-5.0.0-1.tar.gz /usr/local/src/
   cd /usr/local/src/
-  tar zxvf yate-4.3.0-1.tar.gz
+  tar zxvf yate-5.0.0-1.tar.gz
   cd /usr/local/src/yate
   ./configure
@@ Line 64: / Line 66: @@
 Proses instalasi yang perlu dilakukan adalah,
   cd /usr/local/src
@@ Line 103: / Line 104: @@
   vi /usr/local/etc/yate/regexroute.conf
-Di bagian akhir dari blok [default] pastikan '''*TIDAK ADA*''' perintah di bawah ini
+dalam blok [extra]
+ [extra]
+ ;skipping auth step
+ user.auth=20
+tambahkan
+ [user.auth]
   .*=return true
@@ Line 139: / Line 148: @@
 Masukan untuk Yate
-  config SIP.Proxy.SMS {YATE_IPADDRESS}:{YATE_PORT}
+  config SIP.Proxy.SMS {YATE_IPADDRESS}:{YATE_PORT} #probably localhost:5060
+  config SIP.Proxy.Speech {YATE_IPADDRESS}:{YATE_PORT}
-  config SIP.Proxy.SMS 127.0.0.1:5060
- config save
-atau kalau menggunakan IP 192.168.0.3
+atau
-  config SIP.Proxy.SMS 192.168.0.3:5060
+  config SIP.Proxy.SMS localhost:5060
-  config save
+  config SIP.Proxy.Speech localhost:5060
 yate monitor port berikut
@@ Line 286: / Line 293: @@
 * [[OpenBTS: Script Membuat GNURadio 3.4.2 di Ubuntu 13.04]]
 * [[OpenBTS: Script Membuat OpenBTS dan yate di Ubuntu 13.04]]
+* [[OpenBTS: Script Membuat OpenBTS di RangeNetwork Dev Kit]]
 ===OpenBTS 2.6===
@@ Line 345: / Line 352: @@
 * [[OpenBTS: 2.8 dari SVN Install Clock 52MHz di Ubuntu 12.10]] '''RECOMMENDED'''
 * [[OpenBTS: 2.8 dari SVN Install Clock 52MHz di Ubuntu 13.04]] '''RECOMMENDED'''
+* [[OpenBTS: 2.8 dari SVN 2.8.0 Install Clock 52MHz di Ubuntu 13.04]] '''RECOMMENDED'''
 * [[OpenBTS: 2.8 dari SVN Install Clock 52MHz dengan UHD tanpa GNURadio]] ''NOT RECOMMENDED''
 * [[OpenBTS: 2.8 Edit User di sqlite3.db]] '''RECOMMEND'''
@@ Line 358: / Line 366: @@
 * [[OpenBTS: Database SQLite]]
 * [[OpenBTS: Set SQLite Subscriber Registry secara manual]]
+* [[OpenBTS: FreeSWITCH]]
 ===Multi OpenBTS 2.8===
@@ Line 363: / Line 372: @@
 * [[OpenBTS: Pola Multi OpenBTS]] '''RECOMMENDED'''
 * [[Multi OpenBTS: Catatan Konfigurasi]] '''RECOMMENDED'''
+===OpenBTS 3.1.x===
+* [[OpenBTS: Install UHD untuk USRP1]]
+* [[OpenBTS: UHD Identifikasi Device]]
+* [[OpenBTS: OpenBTS 3.1.3 Compile]] '''Tidak bisa untuk USRP1'''
+* [[OpenBTS: Yate Compile]]
 ===Ettus E110===
@@ Line 397: / Line 413: @@
 * [[OpenBTS: RangeNetwork Default Setting]]
+* [[OpenBTS: RangeNetwork Compile GNURadio UHD]]
+* [[OpenBTS: RangeNetwork Compile]]
+* [[OpenBTS: RangeNetwork Compile OpenBTS 3.1.3]] '''*RECOMMENDED*'''
+* [[OpenBTS: RangeNetwork Yate Compile]] '''*RECOMMENDED*'''
 ===GPRS===
@@ Line 450: / Line 470: @@
 * [[OpenBTS: Permohonan Kanal dan DID untuk OpenBTS]]
 * [[OpenBTS: 2013/02/19 - OpenBTS TelkomSel Mengudara di Muscat Oman]]
+* [[OpenBTS: Beroperasi di Papua]]
 ===Dokumentasi Video===