VoIP zoološki vrt — Provisioning

Uvod

Jednom je rukovodstvo odobrilo eksperiment implementacije IP telefonije u našoj firmi. Budući da je moje iskustvo u ovoj oblasti bilo minimalno, zadatak je probudio ogroman interes u meni i uronio sam u proučavanje različitih aspekata pitanja. Nakon završetka istraživanja odlučio sam da podelim stečena znanja — u nadi da će nekome pomoći. Dakle…

Izvorni podaci

Za IP-ATC odabran je i postavljen Asterisk. Park telefona se sastoji od uređaja Cisco 7906g, Panasonic UT-KX123B, Grandstream GXP1400 i Dlink DPH-150S(E)/F3, Yealink T19 i T21. Ova raznovrsnost je rezultat odluke da se unutar eksperimenta proba sve pomalo, kako bi se formiralo vlastito mišljenje o odnosu cena/kvalitet/ugodnost.

Zadatak

Maksimalno pojednostaviti i unificirati proces podešavanja novih uređaja. Svi telefoni treba da budu sinhronizovani po vremenu, imati telefonsku knjigu koja se učitava sa servera i pružiti pristup podešavanjima za administratora.

Rešenje ovog zadatka je jednostavno — implementirati automatsko podešavanje telefona, tzv. Provisioning. Upravo o mojoj implementaciji ove divne funkcije i govoriće se.

Podešavanje tftpd, dhcpd

Za deljenje podešavanja telefonima odabrao sam tftp kao univerzalnu opciju, podržanu na svim platformama, koja je jednostavna za podešavanje i upravljanje.

Specifična podešavanja za tftp nisu bila potrebna. Instalirao sam standardni tftpd i postavio sve potrebne fajlove u njegovoj glavnoj direktoriji.
Fajlove sa podešavanjima rasporedio sam po direktorijumima u skladu sa proizvođačem telefona. Nažalost, uređaj od Cisco nije hteo da koristi svoju mapu, morao sam ga čuvati u glavnom direktorijumu.

Da bih telefonima ukazao na lokaciju tftp-servera, iskoristio sam option-66. Pored toga, podelio sam ih u posebne klase po proizvođaču. Svaka klasa je dobila svoj segment adresa i jedinstvenu mapu za konfiguracione fajlove. Uostalom, uređaje od D-linka je trebalo odrediti po MAC adresama, s obzirom na to da u dhcp zahtevima ne pružaju informacije o proizvođaču.

Fragment dhcpd.conf

# Указываем необходимые опции 
option option-66 code 66 = text;

class "panasonic" {
	match if substring (option vendor-class-identifier,0,9) = "Panasonic";
	option option-66 "10.1.1.50/panasonic/";
}
class "cisco" {
	match if substring (option vendor-class-identifier,0,36) = "Cisco Systems, Inc. IP Phone CP-7906";
	option option-66 "10.1.1.50/cisco/";
}

class "grandstream" {
 match if substring (option vendor-class-identifier,0,11) = "Grandstream";
 option option-66 "10.1.1.50/grandstream/";
}

class "dlink" {
	match if (binary-to-ascii (16,8,":",substring(hardware,1,4)) = "c8:d3:a3:8d") or
	(binary-to-ascii (16,8,":",substring(hardware,1,4)) = "90:94:e4:72");
	option option-66 "10.1.1.50/dlink/";
}

class "yealink" {
                match if substring (option vendor-class-identifier,0,7) = "Yealink";
                option option-66 "10.1.1.50/yealink/";
        }

Telefoni su morali biti prisilno isključeni iz zajedničkog bazena. Inače, nikako nisu želeli da odu u svoj "babarogić".
Primer podešavanja podsistema

subnet 10.1.1.0 netmask 255.255.255.0 {
        option routers 10.1.1.1;
        pool {
                deny members of "cisco";
                deny members of "panasonic";
                deny members of "dlink";
                range 10.1.1.230 10.1.1.240;
        }
        pool {
                allow members of "cisco";
                range 10.1.1.65 10.1.1.69;
        }
        pool {
                allow members of "panasonic";
                range 10.1.1.60 10.1.1.64;
        }
        pool {
                allow members of "dlink";
                range 10.1.1.55 10.1.1.59;
        }
}

Nakon ponovnog pokretanja svih uključenih servisa, telefoni su se sigurno uputili po postavke na predviđeni tftp server. Ostalo je samo da ih tamo smestim.

Cisco 7906

Ovi uređaji su mi dostavljeni u fabričkom pakovanju. Morao sam ih rekonfigurisati da ih povežem sa asteriskom. Ali to je posebna priča. U konkretnom slučaju, za podešavanje uređaja, prema uputstvu, kreirao sam u korenu tftp servera datoteku SEPAABBCCDDEEFF.cnf.xml. Gde je AABBCCDDEEFF — MAC adresa uređaja.

O podešavanju telefona od Ciscoa je već više puta pisano, pa ću samo ostaviti radnu datoteku sa postavkama.
Postavke za cisco

true
 SIP
 root
 ADMIN_PWD

 
 D-M-Y
 Central Pacific Standard Time
     
         
             10.1.1.4
              Unicast
          
     
 

   
 10.1.1.50
 
 2000
 5060
 5061
 
 10.1.1.50
   
 

 Disable


120
 

 
 true
 x-cisco-serviceuri-cfwdall
 x-cisco-serviceuri-pickup
 x-cisco-serviceuri-opickup
 x-cisco-serviceuri-gpickup
 x-cisco-serviceuri-meetme
 x-cisco-serviceuri-abbrdial
 false
 2
 true
 true
 2
 2
 0
 true
 false
 
 
 6
 10
 180
 3600
 5
 120
 120
 5
 500
 4000
 70
 true
 None
 
1
 false
 true
 false
 false
 none
 101
 3
avt
 3
 false
 false
 Cisco Phone
 2
 false
 15000
10
 true
 false
 16384
 32766

 
 9
 10.1.1.50
 5060
  2 
 3
 false
 3
 
 4
 5
 
 true
 true
 false
 true
 

 User #103
 103
 103
 SIP_PWD
 
 
$num
5060
 184
 0
 dialplan.xml
 

 *0#
 true
 2
 


 false
 false
 1
 0
 1
 0
 0
 0
 1
 0
 1,7
 09:00
 12:00
 01:00
 1
 2
 10.1.1.50
 0
 100
 50
 
 0
 0
 5
 1
 10.1.1.50
 0
 0
 0
 0
 0
 0
 1
 1
 
1143565489-a3cbf294-7526-4c29-8791-c4fce4ce4c37

 Bosnian_Bosnia
 bs_BA
 
 utf-8
 

 
 
 
 
1
 0
 
 http://10.1.1.50/provisioning/cisco-services.xml
 
 
 
 
 http://10.1.1.50/provisioning/cisco-services.xml
 96
 0
 96
 2
 0
 0
 
 3804
 <!-- 10.1.1.50 -->
  

 false
 1

D-Link DPH-150S/F3

Ako tek planirate kupiti telefon ove serije, obratite pažnju, automatsko podešavanje se podržava samo na uređajima 150S/F3. Na uređaju 150S/F2, koji je došao u moje ruke, nisam pronašao tu funkcionalnost.

Konfiguracijski fajl može biti u xml formatu ili običnom tekstualnom formatu. Za xml postoji jedan zahtev: oznaka mora biti na početku reda, inače će je parser ignorisati i vrednost odgovarajućeg parametra se neće promeniti.

Za podešavanje telefona koriste se dva fajla. f0D00580000.cfg — za čuvanje podešavanja svih telefona i 00112233aabb.cfg (MAC-adresa u malim slovima) za individualna podešavanja. Individualna podešavanja, naravno, imaju veći prioritet.

Kompletan skup podešavanja broji više od hiljadu redova, kako ne bih opterećivao članak, opisujem minimalni dovoljno skup podešavanja.

Obavezni su korenski čvor VOIP_CONFIG_FILE i ugrađeni čvor version. Podešavanja će se primeniti samo ako je verzija fajla viša od trenutnih podešavanja na uređaju. Tu vrednost možete saznati kroz .web-interfejs telefona u odeljku maintenance (sistemsko upravljanje). Za telefone sa fabričkim podešavanjima u oba slučaja to je 2.0002. Pored toga, verzija individualnog fajla mora biti veća od verzije opšteg fajla.

Prvo ću navesti fajl sa opštom konfiguracijom za sve telefone. U suštini, on čuva sva podešavanja, individualni fajl će odgovarati samo za broj telefona i natpis na ekranu.

U dva bloka, navedena u nastavku, postavljaju se parametri vremenske zone i sinhronizacije vremena, početni port za RTP i uključuje se mrežni most između WAN i LAN portova uređaja.

Fragment№1

DHCP
2
1
1
0
VOIP
10000
200
10.1.1.4
1


0
60
12
1500


1
1

Nazivi parametara konfiguracije su dovoljno „govorljivi” da ih ne treba detaljno opisivati.
SIP za jednu liniju

5060


SIP1
10.1.1.50
5060
3600
1
10.1.1.50
1
0
G711A,G711U,G722

Podešavanja daljinskog upravljanja

23
80
0
443
1
0



Item1
10.1.1.152
10.1.1.160




Account1
admin
ADMIN_PWD
10


Account2
guest
GUEST_PWD
5

Podešavanja telefona

123
123

0
112
Company
5
1
30
0

1
0,,1
0
0
1


XML-PBook1
Phonebook
http://10.1.1.50/provisioning/dlink-phonebook.xml
:
0
0


friend,home,work,business,classmate,colleague

Sve ostale postavke će ostati „podrazumevano”. Sada će svaki Dlink telefon povezan u mrežu odmah prihvatiti zajednički set parametara. Da bi se postavile pojedinačne postavke za uređaj potreban je poseban fajl. U njemu treba samo navesti potrebne postavke za pojedinog pretplatnika.
postavke pretplatnika

2.0006



SIP1
Korisnik #117
117
5060
117
SIP_PWD
3600
1
5060
117
SIP_PWD

Panasonic UT-KX123B

Ovi uređaji primaju postavke prema malo drugačijem principu. Konfiguracija se čuva u tekstualnim datotekama. Maksimalna veličina konfiguracijske datoteke iznosi 120 KB. Bez obzira na broj datoteka, njihova ukupna veličina ne smije preći 120 KB.
Konfiguracijska datoteka se sastoji od skupa redova, na koje se primjenjuju dolje navedeni uvjeti:

  • Prva uvijek ide redak komentara, koji uključuje sljedeću sekvencu znakova (44 bajta):
    # Panasonic SIP Phone Standard Format File #
    Šesnaesteročno predstavljanje ove sekvence:
    23 20 50 61 6E 61 73 6F 6E 69 63 20 53 49 50 20 50 68 6F 6E 65 20 53 74 61 6E 64 61 72 64 20 46 6F 72 6D 61 74 20 46 69 6C 65 20 23
    Za sprečavanje slučajne promjene postavljene sekvence znakova preporučuje se započinjanje konfiguracijske datoteke sa redkom:
    # Panasonic SIP Phone Standard Format File # DO NOT CHANGE THIS LINE!
  • Konfiguracijske datoteke trebaju završavati praznim redkom.
  • Svaki redak treba završiti sekvencom "".
  • Maksimalna dužina retka iznosi 537 bajta, uključujući sekvencu "".
  • Sljedeći redovi se ignoriraju:
    • redovi koji premašuju ograničenje od 537 bajta;
    • prazni redovi;
    • redovi komentara koji počinju znakom "#";
  • Svaki parametar se zapisuje u obliku XXX="yyy" (XXX: naziv parametra, yyy: njegova vrijednost). Vrijednost mora biti udupljivim navodnicima.
  • Razbijanje reda parametara na više redova nije dozvoljeno. To će uzrokovati grešku u obradi konfiguracijske datoteke i, kao rezultat, neuspjeh inicijalizacije.
  • Vrijednosti nekih parametara potrebno je navesti odvojeno za svaku liniju. Parametar s sufiksom "_1" u nazivu je parametar za liniju 1; "_2"— za liniju 2 itd.
  • Maksimalna dužina naziva parametra iznosi 32 znaka.
  • Maksimalna dužina vrijednosti parametra iznosi 500 znakova, osim znakova dvostrukih navodnika.
  • Razmaci u redu nisu dozvoljeni osim u slučajevima kada vrednost uključuje razmak.
  • Vrednosti nekih parametara mogu se navesti kao "prazne" da bi se postavila prazna vrednost parametra.
  • Parametri se navode bez određenog redosleda.
  • Ako se isti parametar navodi više od jednom u konfiguracionom fajlu, koristiće se vrednost koja je navedena prva.

Ovakav ozbiljan skup zahteva za konfiguracioni fajl me, iskreno, ogorčio. Po mom mišljenju, implementacija interakcije sa serveru upravljanjem na telefonima Panasonic je izuzetno nepraktična. Po ovom parametru telefon znatno zaostaje za ostalim.
Kada se aparat prvi put uključi (ili nakon vraćanja na fabričke postavke), pokušava da učita takozvani fajl proizvoda (u ovom slučaju to je KX-UT123RU.cfg), u kojem bi trebali biti navedeni putanje do ostalih fajlova konfiguracije.
Fajl proizvoda# Panasonic SIP Phone Standard Format File # DO NOT CHANGE THIS LINE!

CFG_STANDARD_FILE_PATH=«tftp://10.1.1.50/panasonic/{mac}.cfg»
CFG_PRODUCT_FILE_PATH=«tftp://10.1.1.50/panasonic/KX-UT123RU.cfg»
CFG_MASTER_FILE_PATH=«tftp://10.1.1.50/panasonic/master.cfg»

Nakon toga, telefon će prikazati poruku o uspešnom završetku pripreme i čekati da ga ponovo pokrenu. A tek nakon ponovnog pokretanja će početi da obrađuje odgovarajuće konfiguracione fajlove.

U fajlu master.cfg preporučuje se navođenje zajedničkih podešavanja za sve telefone. Kao i u slučaju Dlink-a, navešću samo neke parametre. Imena ostalih parametara i njihove vrednosti mogu se pronaći u dokumentaciji na sajtu proizvođača.
master.cfg############################################################
# System Settings #
############################################################
## Login Account Settings
ADMIN_ID=«admin»
ADMIN_PASS=«ADMIN_PWD»
USER_ID=«user»
USER_PASS=«USER_PWD»

## System Time Settings
NTP_ADDR=«10.1.1.4»
TIME_ZONE=«660»
DST_ENABLE=«N»
DST_OFFSET=«60»
DST_START_MONTH=«3»
DST_START_ORDINAL_DAY=«2»
DST_START_DAY_OF_WEEK=«0»
DST_START_TIME=«120»
DST_STOP_MONTH=«10»
DST_STOP_ORDINAL_DAY=«2»
DST_STOP_DAY_OF_WEEK=«0»
DST_STOP_TIME=«120»
LOCAL_TIME_ZONE_POSIX=""

## Syslog Settings
SYSLOG_ADDR=«10.1.1.50»
SYSLOG_PORT=«514»
SYSLOG_EVENT_SIP=«6»
SYSLOG_EVENT_CFG=«6»
SYSLOG_EVENT_VOIP=«6»
SYSLOG_EVENT_TEL=«6»

## Provisioning Settings
OPTION66_ENABLE=«Y»
OPTION66_REBOOT=«N»
PROVISION_ENABLE=«Y»
CFG_STANDARD_FILE_PATH=«tftp://10.1.1.50/panasonic/{mac}.cfg»
CFG_PRODUCT_FILE_PATH=«tftp://10.1.1.50/panasonic/KX-UT123RU.cfg»
CFG_MASTER_FILE_PATH=«tftp://10.1.1.50/panasonic/master.cfg»

############################################################
# Network Settings #
############################################################
## IP Settings
CONNECTION_TYPE=«1»
HOST_NAME=«UT123»
DHCP_DNS_ENABLE=«Y»
STATIC_IP_ADDRESS=""
STATIC_SUBNET=""
STATIC_GATEWAY=""
USER_DNS1_ADDR=""
USER_DNS2_ADDR=""

## DNS Settings
DNS_QRY_PRLL=«Y»
DNS_PRIORITY=«N»
DNS1_ADDR=«10.1.1.1»
DNS2_ADDR=""

## HTTP Settings
HTTPD_PORTOPEN_AUTO=«Y»
HTTP_VER=«1»
HTTP_USER_AGENT=«Panasonic_{MODEL}/{fwver} ({mac})»
HTTP_SSL_VERIFY=«0»
CFG_ROOT_CERTIFICATE_PATH=""

## XML Application Settings
XML_HTTPD_PORT=«6666»
XMLAPP_ENABLE=«Y»
XMLAPP_USERID=""
XMLAPP_USERPASS=""
XMLAPP_START_URL=""
XMLAPP_INITIAL_URL=" "
XMLAPP_INCOMING_URL=""
XMLAPP_TALKING_URL=""
XMLAPP_MAKECALL_URL=""
XMLAPP_CALLLOG_URL=""
XMLAPP_IDLING_URL=""
XMLAPP_LDAP_URL=«10.1.1.50/provisioning/panasonic-phonebook.xml»
XMLAPP_LDAP_USERID=""
XMLAPP_LDAP_USERPASS=""

U individualnoj konfiguraciji uređaja, po tradiciji, ostaju samo podešavanja korisnika.
aabbccddeeff.cfgDISPLAY_NAME_1=„Korisnik #168“

PHONE_NUMBER_1=„168“
SIP_URI_1=„168“
LINE_ENABLE_1=„Omogućeno“
PROFILE_ENABLE_1=„Omogućeno“
SIP_AUTHID_1=„168“
SIP_PASS_1=„SIP_PWD“

Grandstream GXP-1400

Parametri ovih telefona čuvaju se u jednom xml-fajlu pod imenom cfg{mac}.xml. Ili u običnom tekstu pod imenom cfg{mac}. Ovaj telefon zahteva samo individualnu konfiguraciju, tako da optimizacija podešavanja premještanjem u zajednički fajl nije moguća. Još jedna karakteristika podešavanja Grandstreama je imenovanje parametara. Svi su numerisani i označeni kao P###. Na primer:

P1650 – odgovara za veb-interfejs za upravljanje telefonom (0 – HTTPS, 1 – HTTP)
P47 – adresa SIP servera za povezivanje.

Ako je konfiguracija sačuvana u tekstualnom fajlu, parametri ne zahtevaju nikakvu grupaciju i idu u bilo kom redosledu. Linije koje počinju sa # smatraju se komentarima.

U slučaju da su podešavanja predstavljena u formatu xml, moraju biti ugnježdena unutar čvora , koji takođe mora biti ugnježden unutar . Svi parametri se beleže u obliku odgovarajućih oznaka sa vrednostima unutar.
Primer podešavanja

1
    
    109
    
    109
    
    109
    
    SIP_PWD
    
    Korisnik# 109

        10.1.1.50
        2
   10.1.1.50
   0
   ADMIN_PWD
   USER_PWD
   ru
        0
        10.1.1.50/grandstream
   1 
   TZc-11
   10.1.1.4
        1
        http://10.1.1.50/provisioning/grandstream
        30

Yealink T19 i T21

Uređaji ovih modela podržavaju jedinstvene konfiguracijske datoteke za uređaje i zajedničke za modele. U mom slučaju, morao sam zajedničke parametre smjestiti u datoteke y000000000031.cfg i y000000000034.cfg, redom. Jedinstvene konfiguracijske datoteke nazivaju se prema MAC adresi: 00112233aabb.cfg.

Postavke za yealink uređaje čuvaju se u tekstualnom formatu. Od obaveznih zahtjeva, samo je prisutnost verzije datoteke u prvom redu, u formatu #!version:1.0.0.1.

Svi parametri zapisani su u obliku parametar = vrijednost. Komentari trebaju započinjati sa simbolom "#". Imena parametara i njihovi vrijednosti mogu se pronaći u dokumentaciji na web stranici proizvođača.
opće postavke#!version:1.0.0.1
#Configure the WAN port type; 0-DHCP (default), 1-PPPoE, 2-Static IP Address;
network.internet_port.type = 0
#Configure the PC port type; 0-Router, 1-Bridge (default);
network.bridge_mode = 1
#Configure the access type of the web server; 0-Disabled, 1-HTTP & HTTPS(default), 2-HTTP Only, 3-HTTPS Only;
network.web_server_type = 3
#Configure the maximum local RTP port. It ranges from 0 to 65535, the default value is 11800.
network.port.max_rtpport = 10100
#Configure the minimum local RTP port. It ranges from 0 to 65535, the default value is 11780.
network.port.min_rtpport = 10000
security.user_name.admin = root
security.user_password = root:ADMIN_PWD
security.user_name.user = user
security.user_password = user:USER_PWD
#Specify the web language, the valid values are: English, Chinese_S, Turkish, Portuguese, Spanish, Italian, French, Russian, Deutsch and Czech.
lang.wui = Bosanski
#Specify the LCD language, the valid values are: English (default), Chinese_S, Chinese_T, German, French, Turkish, Italian, Polish, Spanish and Portuguese.
lang.gui = Bosanski
#Configure the time zone and time zone name. The time zone ranges from -11 to +12, the default value is +8.
#The default time zone name is China(Beijing).
#Refer to Yealink IP Phones User Guide for more available time zones and time zone names.
local_time.time_zone = +11
local_time.time_zone_name = Vladivostok
#Configure the domain name or the IP address of the NTP server. The default value is cn.pool.ntp.org.
local_time.ntp_server1 = 10.1.1.4
#Configure the logo mode of the LCD screen; 0-Disabled (default), 1-System logo, 2-Custom logo;
phone_setting.lcd_logo.mode = 1
#Configure the access URL and dispaly name of the remote phonebook. X ranges from 1 to 5.
remote_phonebook.data.1.url = 10.1.1.50/provisioning/yealink-phonebook.xml
remote_phonebook.data.1.name = Telefon knjiga
features.remote_phonebook.flash_time = 3600

jedinstvene postavke#!version:1.0.0.1
#Enable or disable the account1, 0-Disabled (default), 1-Enabled;
account.1.enable = 1
#Configure the label displayed on the LCD screen for account1.
account.1.label = Test telefon
#Configure the display name of account1.
account.1.display_name = Korisnik 998
#Configure the username and password for register authentication.
account.1.auth_name = 998
account.1.password = 998
#Configure the register user name.
account.1.user_name = 998
#Configure the SIP server address.
account.1.sip_server_host = 10.1.1.50
#Specify the port for the SIP server. The default value is 5060.
account.1.sip_server_port = 5060

Na kraju, zahvaljujući sjajnoj funkciji auto-provision koja je predviđena u spomenutim uređajima, povezivanje novih uređaja u mrežu nije predstavljalo nikakve probleme. Sve se svodilo na utvrđivanje MAC adrese telefona i generisanje konfiguracijske datoteke prema šablonu.

Nadam se da ste do kraja pročitali i izvukli korist iz pročitanog.

Hvala na pažnji.

Izvor: habr.com

Kupite pouzdan hosting za sajtove uz zaštitu od DDoS, VPS VDS servere 🔥 Kupite pouzdan hosting za sajtove uz zaštitu od DDoS, VPS VDS servere | ProHoster