- Etusivu
- /
- Artikkeli
Määritä profiiliasetukset 9800-sarjan ja 8875-puhelimille (BroadWorks)
Tämä ohjeartikkeli koskee Cisco BroadWorksiin rekisteröityjä Cisco Desk Phone 9800 -sarjaa ja Cisco Video Phone 8875 -puhelinta. Tämän sivun tiedot sisältävät profiilin uudelleensynkronoinnin, profiilin manuaalisen käytön ja määrityssyntaksin.
Määritä puhelimesi profiilin uudelleensynkronointia varten
Synkronoi puhelinprofiili uudelleen TFTP: n kautta
Puhelin tukee useita verkkoprotokollia kokoonpanoprofiilien hakemiseksi. Perusprofiilin siirtoprotokolla on TFTP (RFC1350). TFTP: tä käytetään laajalti verkkolaitteiden tarjoamiseen yksityisissä LAN-verkoissa. Vaikka TFTP:tä ei suositella etäpäätepisteiden käyttöönottoon Internetissä, se voi olla kätevä käyttöönottoon pienissä organisaatioissa, sisäiseen esivalmisteluun sekä kehittämiseen ja testaukseen. Seuraavassa menettelyssä profiilia muokataan sen jälkeen, kun tiedosto on ladattu TFTP-palvelimelta.
| 1 |
Yhdistä LAN-ympäristössä tietokone ja puhelin keskittimeen, kytkimeen tai pieneen reitittimeen. |
| 2 |
Asenna ja aktivoi TFTP-palvelin tietokoneessa. |
| 3 |
Luo määritysprofiili tekstieditorilla. Voit tarkistaa, onko profiili lisätty puhelimeesi myöhemmin, asettamalla jotkin arvot merkkeiksi. Aseta GPP_A: n arvoksi esimerkiksi 12345678 seuraavan esimerkin mukaisesti:
|
| 4 |
Tallenna XML-määritystiedosto TFTP-palvelimen juurihakemistoon. Voit tarkistaa, että TFTP-palvelin on määritetty oikein: pyydä määritysprofiilitiedostoa käyttämällä muuta TFTP-asiakasohjelmaa kuin puhelinta. Käytä mieluiten TFTP-asiakasohjelmaa, joka on käynnissä erillisessä isännässä kuin provisiointipalvelimesta. |
| 5 |
Avaa tietokoneen verkkoselaimessa hallinnan verkkosivu. Oletetaan esimerkiksi, että puhelimen IP-osoite on 192.168.1.100, avaa seuraava URL-osoite selaimessasi:
|
| 6 |
Valitse Ääni -välilehti ja tarkista yleiskäyttöisten parametrien arvot GPP_A - GPP_P. Näiden pitäisi olla tyhjiä. |
| 7 |
Synkronoi testipuhelin uudelleen luomaasi määritysprofiiliin avaamalla uudelleensynkronoinnin URL-osoite verkkoselaimessa. Esimerkki: Jos TFTP-palvelimen IP-osoite on 192.168.1.200, komennon tulisi olla samanlainen kuin seuraava esimerkki:
Kun puhelin vastaanottaa tämän komennon, laite osoitteessa 192.168.1.100 pyytää määritysprofiilitiedostoa |
| 8 |
Varmista, että parametri on päivitetty oikein. Päivitä hallinnan verkkosivu ja siirry kohtaan Ääni . GPP_A-parametrin pitäisi nyt sisältää arvo 12345678. |
Puhelinkohtaisen profiilin luominen TFTP-palvelimella
| 1 |
Hanki puhelimen MAC-osoite tuotteen etiketistä. (MAC-osoite on numero, jossa käytetään numeroita ja pieniä heksadesimerkkejä, esimerkiksi 000e08aabbcc. |
| 2 |
Nimeä määritystiedosto uudelleen Esimerkki:
|
| 3 |
Siirrä uusi tiedosto TFTP-palvelimen virtuaaliseen juurihakemistoon. |
| 4 |
Siirry puhelimen hallinnan verkkosivulle. |
| 5 |
Valitse Ä . |
| 6 |
Kirjoita profiilitiedoston polku Profiilisään tö-kent tään. Esimerkki: Oletetaan, että TFTP-palvelimen IP-osoite on 192.168.1.200 ja profiilitiedoston nimi on
|
| 7 |
Valitse Lähetä kaikki muutokset. Tämä aiheuttaa välittömän uudelleenkäynnistyksen ja uudelleensynkronoinnin. Kun seuraava uudelleensynkronointi tapahtuu, puhelin hakee uuden tiedoston laajentamalla $MA-makrolausekkeen MAC-osoitteeseensa. |
Synkronoi puhelinprofiili uudelleen HTTP GET: n kanssa
| 1 |
Asenna HTTP-palvelin paikalliseen tietokoneeseen tai muuhun käytettävissä olevaan isäntään. Avoimen lähdekoodin Apache-palvelin voidaan ladata Internetistä. |
| 2 |
Lataa määritysprofiilitiedosto asennetun palvelimen virtuaaliseen juurihakemistoon. |
| 3 |
Voit tarkistaa palvelimen asianmukaisen asennuksen ja profiilitiedoston käytön avaamalla profiili verkkoselaimella. |
| 4 |
Muokkaa testipuhelimen Profile_Rule osoittamaan HTTP-palvelimeen TFTP-palvelimen sijasta, jotta sen profiili ladataan säännöllisesti. Olettaen esimerkiksi, että HTTP-palvelin on 192.168.1.300 ja profiilin tiedostonimi on basic.txt, anna seuraava arvo:
|
| 5 |
Valitse Lähetä kaikki muutokset. Tämä aiheuttaa välittömän uudelleenkäynnistyksen ja uudelleensynkronoinnin. |
| 6 |
Tarkkaile puhelimen lähettämät syslog-viestit. Jaksollisten uudelleensynkronointien pitäisi nyt hankkia profiili HTTP-palvelimelta. |
| 7 |
Tarkkaile HTTP-palvelinlokeissa, miten testipuhelimen tunnistavat tiedot näkyvät käyttäjäagenttien lokiin. Näihin tietoihin tulee sisältyä valmistaja, tuotteen nimi, nykyinen laiteohjelmistoversio ja sarjanumero. |
Synkronoi puhelinprofiili automaattisesti uudelleen
Laite voi synkronoida säännöllisesti uudelleen varmennuspalvelimeen varmistaakseen, että palvelimessa tehdyt profiilimuutokset leviävät päätepistelaitteeseen (sen sijaan, että päätelaitteeseen lähetettäisiin nimenomainen uudelleensynkronointipyyntö).
Jotta puhelin synkronoituu ajoittain uudelleen palvelimeen, määritysprofiilin URL-osoite määritetään Profile_Rule -parametrilla ja uudelleensynkronointijakso määritetään Resync_Periodic -parametrilla.
| 1 |
Siirry puhelimen hallinnan verkkosivulle. |
| 2 |
Valitse Ä . |
| 3 |
Määritä Profile_Rule-parametri. Tässä esimerkissä oletetaan, että TFTP-palvelimen IP-osoite on 192.168.1.200. |
| 4 |
Syötä säännöllinen synkronointi uudelleen -kenttään pieni testauksen arvo, kuten 30 sekuntia. |
| 5 |
Klik kaa Lähetä kaikki muutokset. Uusilla parametriasetuksilla puhelin synkronoituu kahdesti minuutissa URL-osoitteen määrittämään määritystiedostoon. |
| 6 |
Tarkkaile tuloksena olevia viestejä syslog-jäljityksessä. |
| 7 |
Varmista, että Resync On Reset On Reset -kentän arvoksi on asetettu Kyllä.
|
| 8 |
Käynnistä puhelin virran kytkemällä virta pakottaaksesi sen synkronoimaan uudelleen käyttöönottopalvelimeen. Jos uudelleensynkronointitoiminto epäonnistuu jostain syystä, esimerkiksi jos palvelin ei vastaa, yksikkö odottaa (uudelleensynkronointi virheen uudelleenyrittämisviiveessä määritettyjen sekuntien määrän) ennen kuin se yrittää synkronoida uudelleen. Jos uudelleensynkronointivirheen uudelleenkokeiluviive on nolla, puhelin ei yritä synkronoida uudelleen epäonnistuneen uudelleensynkronointiyrityksen jälkeen. |
| 9 |
(Valinnainen) Aseta Synkron ointivirheen uudelleenyrityksen viive -kentän arvoksi pieni luku, kuten 30.
|
| 10 |
Poista TFTP-palvelin käytöstä ja tarkkaile tuloksia syslog-tulosteessa. |
Profiilin uudelleensynkronointiparametrit
Seuraavassa taulukossa määritellään profiilin uudelleensynkronointiparametrien toiminta ja käyttö Puhelimen verkkosivun Kokoon panoprofiili -osiossa -välilehdessä. Se määrittelee myös merkkijonon syntaksin, joka lisätään puhelimen määritystiedostoon (cfg.xml) XML-koodilla parametrin määrittämiseksi.
|
Parametri |
Kuvaus |
|---|---|
|
Varaus Ota käyttöön |
Sallii tai kieltää määritysprofiilin uudelleensynkronointitoiminnot.
Oletus: Kyllä |
|
Synkronoi uudelleen nollauksen yhteydessä |
Määrittää, synkronoidaanko puhelin määritykset uudelleen varmennuspalvelimen kanssa käynnistyksen jälkeen ja jokaisen päivitysyrityksen jälkeen.
Oletus: Kyllä |
|
Synkronoi uudelleen satunnainen viive |
Estää varmennuspalvelimen ylikuormituksen, kun suuri määrä laitteita käynnistyy samanaikaisesti ja yritetään määrittää alkuasetukset. Tämä viive on voimassa vain alkuperäisessä määritysyrityksessä laitteen käynnistyksen tai nollauksen jälkeen. Parametri on suurin aikaväli, jonka laite odottaa ennen yhteydenottoa varmennuspalvelimeen. Todellinen viive on näennäissatunnaisluku välillä 0 ja tämän arvon. Tämä parametri on 20 sekunnin yksikköinä. Kelvollinen arvo vaihtelee välillä 0 ja 65535.
Oletusarvo on 2 (40 sekuntia). |
|
Synkronoi uudelleen (HHmm) |
Aika (HHmm), jonka puhelin synkronoi uudelleen alustavan palvelimen kanssa. Tämän kentän arvon on oltava nelinumeroinen luku, joka vaihtelee välillä 0000 - 2400, jotta aika ilmoitetaan HHmm-muodossa. Esimerkiksi 0959 tarkoittaa 09:59.
Oletusarvo on tyhjä. Jos arvo on virheellinen, parametri jätetään huomiotta. Jos tälle parametrille on asetettu kelvollinen arvo, Resync Perio dic -parametri ohitetaan. |
|
Synkronoi uudelleen satunnaisella viiveellä |
Estää varmennuspalvelimen ylikuormituksen, kun suuri määrä laitteita käynnistyy samanaikaisesti. Jotta vältetään uudelleensynkronointipyyntöjen tulva palvelimelle useista puhelimista, puhelin synkronoituu uudelleen tuntien ja minuuttien sekä tuntien ja minuuttien sekä satunnaisen viiveen välillä (hhmm, hhmm+random_delay). Jos esimerkiksi satunnainen viive = (Resync At Random Delay + 30) /60 minuuttia, syöttöarvo sekunteina muunnetaan minuuteiksi pyöristämällä seuraavaan minuuttiin lopullisen random_delay -välin laskemiseksi.
Kelvollinen arvo vaihtelee välillä 600 ja 65535. Jos arvo on pienempi kuin 600, sisäinen satunnaisviive on välillä 0—600. Oletusarvo on 600 sekuntia (10 minuuttia). |
|
Säännöllinen uudelleensynkronointi |
Aikaväli jaksollisen uudelleensynkronoinnin välillä varautumispalvelimen kanssa. Liittyvä uudelleensynkronointiajastin on aktiivinen vasta ensimmäisen onnistuneen synkronoinnin jälkeen palvelimen kanssa. Voimassa olevat muodot ovat seuraavat:
Aseta tämä parametri nollaksi poistaaksesi säännöllisen synkronoinnin käytöstä. Oletusarvo on 3600 sekuntia. |
|
Uudelleensynkronointivirhe Yrityksen viive uudelleen |
Jos uudelleensynkronointitoiminto epäonnistuu, koska puhelin ei pystynyt noutamaan profiilia palvelimelta tai ladattu tiedosto on vioittunut tai ilmenee sisäinen virhe, puhelin yrittää synkronoida uudelleen sekunneissa määritetyn ajan kuluttua. Voimassa olevat muodot ovat seuraavat:
Jos viiveeksi on asetettu 0, laite ei yritä synkronoida uudelleen uudelleen epäonnistuneen uudelleensynkronointiyrityksen jälkeen.
Oletus: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400 |
|
Pakotettu uudelleensynkronointiviive |
Suurin viive (sekunteina), jonka puhelin odottaa ennen uudelleensynkronoinnin suorittamista. Laite ei synkronoi uudelleen, kun yksi sen puhelinlinjoista on aktiivinen. Koska uudelleensynkronointi voi kestää useita sekunteja, on toivottavaa odottaa, kunnes laite on ollut käyttämättömänä pitkään ennen uudelleensynkronointia. Tämän avulla käyttäjä voi soittaa puheluita peräkkäin keskeytyksettä. Laitteessa on ajastin, joka alkaa laskea alaspäin, kun kaikki sen rivit ovat tyhjäkäynnillä. Tämä parametri on laskurin alkuarvo. Uudelleensynkronointitapahtumat viivästyvät, kunnes tämä laskuri laskee nollaan. Kelvollinen arvo vaihtelee välillä 0 ja 65535.
Oletusarvo on 14 400 sekuntia. |
|
Synkronoi uudelleen SIP: stä |
Ohjaa uudelleensynkronointipyyntöjä SIP NOTIFY -tapahtuman kautta, joka lähetetään palveluntarjoajan välityspalvelimelta puhelimeen. Jos tämä on käytössä, välityspalvelin voi pyytää uudelleensynkronointia lähettämällä laitteelle SIP NOTIFY -viestin, joka sisältää Event: resync -otsikon.
Oletus: Kyllä |
|
Synkronoi uudelleen päivitysyrityksen jälkeen |
Ottaa uudelleen synkronointitoiminnon käyttöön tai poistaa sen käytöstä päivityksen jälkeen. Jos Kyllä on valittuna, synkronointi käynnistyy laiteohjelmiston päivityksen jälkeen.
Oletus: Kyllä |
|
Synkronoi uudelleen liipaisin 1 Synkronoi uudelleen liipaisin 2 |
Jos näiden parametrien loogisen yhtälön arvo on FALSE, uudelleensynkronointia ei käynnisty, vaikka Resync On Reset -asetukseksi on asetettu TOSI. Vain uudelleensynkronointi suoratoiminnon URL-osoitteen ja SIP-ilmoituksen kautta ohittaa nämä uudelleensynkronoinnin laukaisimet. Parametrit voidaan ohjelmoida ehdollisella lausekkeella, joka laajenee makro. Kelvolliset makrolaajennukset on kohdassa Makron laajennusmuuttujat kohdasta Provision-parametrit.
Oletus: Tyhjä |
|
Käyttäjän konfiguroitava uudelleensynkronointi |
Antaa käyttäjän synkronoida puhelimen uudelleen puhelimen näytön valikosta. Kun asetus on Kyllä, käyttäjä voi synkronoida puhelimen määritykset uudelleen syöttämällä profiilisäännön puhelimesta. Kun asetus on Ei, Profiilisään töparametria ei näytetä puhelimen näytön valikossa.
Oletus: Kyllä |
|
Uudelleensynkronointi epäonnistuu FNF: ssä |
Uudelleensynkronointia pidetään tyypillisesti epäonnistuneena, jos pyydettyä profiilia ei vastaanota palvelimelta. Tämä parametri ohittaa tämän toiminnon. Kun asetus on Ei, laite hyväksyy palvelimelta tiedoston löytä
Oletus: Kyllä |
|
Profiilin todennustyyppi |
Määrittää profiilitilin todennuksessa käytettävät tunnistetiedot. Käytettä vissä olevat vaihtoehdot ovat:
Oletus: Perus HTTP-todennus Lisätietoja on kohdassa Profiilin todennustyypin määrittäminen kohdassa Määr itä puhelin profiilin uudelleensynkronointia varten. |
|
Profiilisääntö Profiilin sääntö B Profiilin sääntö C Profiilin sääntö D |
Jokainen profiilisäännö ilmoittaa puhelimelle lähteestä, josta profiili hankitaan (määritystiedosto). Jokaisen uudelleensynkronointitoiminnon aikana puhelin käyttää kaikkia profiileja peräkkäin.
Voit liittää salausavaimen lainausmerkkeihin (”) valinnaisesti.
Oletus: |
|
Käytettävä DHCP-vaihtoehto |
DHCP-asetukset, jotka on erotettu pilkuilla, käytetään laiteohjelmiston ja profiilien hakemiseen. Oletus: 66,160,159,150,60,43,125 |
|
DHCPv6 Käytettävä Vaihtoehto |
DHCP-asetukset, jotka on erotettu pilkuilla, käytetään laiteohjelmiston ja profiilien hakemiseen. Oletus: 17,160,159 |
Provisiointi Cisco XML: n kautta
Voit tarjota puhelimia Cisco XML -toimintojen kautta.
Voit lähettää XML-objektin puhelimeen SIP Notify -paketilla tai HTTP-postilla puhelimen CGI-käyttöliittymään: http://PhoneIPAddress/CGI/Execute.
CP-xxxx-3PCC laajentaa Cisco XML -ominaisuutta tukemaan XML-objektin kautta tapahtuvaa provisiointia:
<CP-xxxx-3PCCExecute>
<ExecuteItem URL=Resync:[profile-rule]/>
</CP-xxxx-3PCCExecute>
Kun puhelin on vastaanottanut XML-objektin, se lataa alustustiedoston osoitteesta [profiili-sääntö]. Tämä sääntö käyttää makroja XML-palvelusovelluksen kehittämisen yksinkertaistamiseen.
URL-tarkkuus makrolaajennuksella
Alihakemistot, joissa on useita profiileja palvelimella, tarjoavat kätevän menetelmän suuren määrän käyttöönotettujen laitteiden hallintaan. Profiilin URL-osoite voi sisältää:
-
Varmistuspalvelimen nimi tai nimenomainen IP-osoite. Jos profiili tunnistaa valmistelupalvelimen nimen perusteella, puhelin suorittaa DNS-haun nimen selvittämiseksi.
-
Epätavallinen palvelinportti, joka määritetään URL-osoitteessa käyttämällä palvelimen nimen jälkeistä vakiosyntax:port -merkkiä. -
Palvelimen virtuaalisen juurihakemiston alihakemisto, johon profiili on tallennettu. Se määritetään käyttämällä tavallista URL-merkintää ja jota hallitaan makrolaajennuksella.
Esimerkiksi seuraava Profile_Rule pyytää profiilitiedostoa ($PN.cfg) palvelimen alihakemistossa /cisco/config TFTP-palvelimelta, joka on käynnissä host prov.telco .com ja kuuntelee yhteyttä porttiin 6900-porttiin:
<Profile_Rule>
tftp://prov.telco.com:6900/cisco/config/$PN.cfg
</Profile_Rule>
Kunkin puhelimen profiili voidaan tunnistaa yleiskäyttöisestä parametrista, jonka arvo viitataan yhteisessä profiilisäännössä makrolaajennuksen avulla.
Oletetaan esimerkiksi, että GPP_B määritellään Dj6Lmp23Q: ksi.
Profile_Rule -toiminnolla on arvo:
tftp://prov.telco.com/cisco/$B/$MA.cfg
Kun laite synkronoidaan uudelleen ja makroja laajennetaan, puhelin, jonka MAC-osoite on 000e08012345, pyytää profiilia, jonka nimi sisältää laitteen MAC-osoitteen seuraavassa URL-osoitteessa:
tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg
Määritä profiilin todennustyyppi
Profiilin todennuksen avulla puhelimen käyttäjät voivat synkronoida varausprofiilin uudelleen puhelimeen. Todennustiedot vaaditaan, kun puhelin yrittää synkronoida uudelleen ja ladata määritystiedoston ensimmäistä kertaa ja saa HTTP- tai HTTPS 401 -todennusvirheen. Kun otat tämän ominaisuuden käyttöön, Profiilitilin asetukset -näyttö tulee näkyviin puhelimessa seuraavissa tilanteissa:
-
Kun HTTP- tai HTTPs 401 -todennusvirhe ilmenee ensimmäisen käyttöönoton aikana puhelimen uudelleenkäynnistyksen jälkeen
-
Kun profiilin käyttäjätunnus ja salasana ovat tyhjät
-
Kun profiilisäännössä ei ole käyttäjänimeä ja salasanaa
Jos Profiilitilin asetusnäyttö jää huomaamatta tai sitä ei oteta huomioon, käyttäjä voi käyttää asetusnäyttöä myös puhelimen näytön valikosta tai Aset ukset-toimintonäppäimestä, joka tulee näkyviin vain, kun puhelimessa ei ole rekisteröity linjaa.
Kun poistat ominaisuuden käytöstä, Profiilitilin aset usnäyttö ei näy puhelimessa.
Profi ilisääntö-kentän käyttäjätunnuksella ja salasanalla on korkeampi prioriteetti kuin profiilitilillä.
-
Kun annat oikean URL-osoitteen Profiilisääntö-kenttään ilman käyttäjänimeä ja salasanaa, puhelin vaatii todennuksen tai yhteenvedon profiilin synkronoimiseksi uudelleen. Oikealla profiilitilillä todennus läpäisee. Virheellisellä profiilitilillä todennus epäonnistuu.
-
Kun annat oikean URL-osoitteen Profiilisääntö-kenttään oikealla käyttäjänimellä ja salasanalla, puhelin vaatii todennuksen tai yhteenvedon profiilin synkronoimiseksi uudelleen. Profiilitiliä ei käytetä puhelimen uudelleensynkronointiin. Sisäänkirjautuminen onnistui.
-
Kun annat oikean URL-osoitteen Profiilisääntö-kenttään virheellisellä käyttäjänimellä ja salasanalla, puhelin vaatii todennuksen tai yhteenvedon profiilin synkronoimiseksi uudelleen. Profiilitiliä ei käytetä puhelimen uudelleensynkronointiin. Sisäänkirjautuminen epäonnistuu aina.
-
Kun annat väärän URL-osoitteen Profiilisääntö- kenttään, kirjautuminen epäonnistuu aina.
Voit myös määrittää puhelimen määritystiedoston parametrit XML (cfg.xml) -koodilla.
Voit määrittää profiilin todennustyypin puhelimen hallinnan verkkosivulta.
| 1 |
Siirry puhelimen hallinnan verkkosivulle. |
| 2 |
Valitse Ä . |
| 3 |
Määritä profiilitilin todennuksessa käytettävät tunnistetiedot määrittämällä Määritysprofiili -osiossa Profiilin todennustyyppi -parametri. Voit määrittää tämän parametrin puhelimen kokoonpanon XML-tiedostossa (cfg.xml) kirjoit tamalla merkkijonon tässä muodossa:
Vaihtoehdot:
Oletus: Perus HTTP-todennus |
| 4 |
Valitse Lähetä kaikki muutokset. |
Profiilin käyttäminen puhelimeen manuaalisesti
Lataa määritystiedosto puhelimeen TFTP-palvelimelta
Suorita nämä vaiheet ladataksesi määritystiedoston tietokoneesi TFTP-palvelinsovellukseen.
| 1 |
Liitä tietokone puhelimen LAN-porttiin. |
| 2 |
Suorita TFTP-palvelinsovellus tietokoneessa ja varmista, että määritystiedosto on käytettävissä TFTP-juurihakemistossa. |
| 3 |
Kirjoita verkkoselaimessa puhelimen lähiverkon IP-osoite, tietokoneen IP-osoite, tiedostonimi ja kirjautumistiedot. Käytä tätä muotoa:
Esimerkki:
|
Lataa määritystiedosto puhelimeen cURL-ohjelmalla
Suorita nämä vaiheet ladataksesi kokoonpanon puhelimeen cURL-ohjelmalla. Tätä komentorivityökalua käytetään tietojen siirtämiseen URL-syntaksilla. Jos haluat ladata cURL, käy osoitteessa:
https://curl.haxx.se/download.html
Suosittelemme, että et käytä cURL-ohjelmaa määrityksen lähettämiseen puhelimeen, koska käyttäjänimi ja salasana saatetaan kaapata cURL-toiminnon aikana.
| 1 |
Liitä tietokone puhelimen LAN-porttiin. |
| 2 |
Lataa määritystiedosto puhelimeen kirjoittamalla seuraava cURL-komento:
|
Viitteet profiilin määritykseen
Puhelin hyväksyy kokoonpanot XML-muodossa.
Tämän osan esimerkeissä käytetään määritysprofiileja, joissa on XML-syntaksi.
Kokoonpanoprofiilin muodot
Määritysprofiili määrittelee puhelimen parametriarvot.
Määritysprofiilin XML-muoto käyttää tavanomaisia XML-luontityökaluja parametrien ja arvojen kokoamiseen.
Jokaisella puhelimella on erilainen ominaisuusjoukko ja siten erilainen parametrijoukko.
Avaa profiilin muoto
Avoimen muotoinen profiili on tekstitiedosto, jossa on XML-tyyppinen syntaksi elementtien hierarkiassa, elementtien määritteillä ja arvoilla. Tämän muodon avulla voit luoda määritystiedoston vakiotyökaluilla. XML-määritystiedosto voidaan lähettää provisiointipalvelimelta puhelimeen uudelleensynkronointitoiminnon aikana ilman koostamista binääriobjektina.
Puhelin voi hyväksyä vakiotyökalujen luomat kokoonpanomuodot. Tämä ominaisuus helpottaa taustapalvelinohjelmistojen kehittämistä, joka luo määritysprofiileja olemassa olevista tietokannoista.
Määritysprofiilin luottamuksellisten tietojen suojaamiseksi varmennuspalvelin toimittaa XML-määritystiedoston puhelimeen TLS-suojaaman kanavan kautta. Valinnaisesti tiedosto voidaan pakata käyttämällä gzip deflate -algoritmia (RFC1951).
Tiedosto voidaan salata jollakin seuraavista salausmenetelmistä:
-
AES-256-CBC-salaus
-
RFC-8188-pohjainen HTTP-sisällön salaus AES-128-GCM-salauksella
Määritystiedosto voi sisältää seuraavat komponentit:
-
Elementtitunnisteet
-
Ominaisuudet
-
Parametrit
-
Muotoiluominaisuudet
-
XML-kommentit
Esimerkki: Avaa profiilin muoto
<flat-profile>
<Resync_On_Reset> Yes </Resync_On_Reset>
<Resync_Periodic> 7200 </Resync_Periodic>
<Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule>
</flat-profile>
Element <flat-profile>titunniste sisältää kaikki parametrielementit, jotka puhelin tunnistaa.
Elementtitunnisteen ominaisuudet
Pidä seuraavat säännöt mielessä, kun luot tai päivität määritystiedostoa.
-
XML-valmistelumuoto ja Web-käyttöliittymä mahdollistavat samojen asetusten määrittämisen. Web-käyttöliittymän XML-tunnisteiden nimet ja kenttien nimet ovat samankaltaisia, mutta vaihtelevat XML-elementtien nimirajoitusten vuoksi. Esimerkiksi alaviivat (_) XML-määritystiedostossa Web-käyttöliittymän välilyöntien sijaan.
-
<flat-profile>Puhelin tunnistaa elementit, joilla on oikeat parametrien nimet, jotka on kapseloitu erity
iseen elementtiin. -
Elementtien nimet on suljettu kulmasulkeisiin.
-
Useimmat elementtien nimet ovat samanlaisia kuin puhelimen Web-käyttöliittymän kenttien nimet, seuraavilla muutoksilla:
-
Elementtien nimissä ei saa olla välilyöntejä tai erikoismerkkejä. Jos haluat saada elementin nimen verkkokentän nimestä, korvaa jokaiselle välilyönnille tai erikoismerkkeille
[,],(,)tai/alaviiva.Esimerkki: E <Resync_On_Reset>lementti edustaa Resync Reset -kenttää.
-
Jokaisen elementin nimen on oltava yksilöllinen. Puhelimen Web-käyttöliittymässä samat kentät voivat näkyä useilla verkkosivuilla, kuten Linja-, Käyttäjä- ja Laajennussivuilla. Lisää
[n]elementin nimeen osoittaaksesi sivun välilehdessä näkyvän numeron.Esimerkki: E
<Dial_Plan_1_>lementti edustaa lin jan 1 valintasuunnitel maa.
-
-
Jokaisella avautuvan elementin tunnisteella on oltava vastaava sulkemiselementtitunniste. Esimerkiksi:
<flat-profile> <Resync_On_Reset> Yes </Resync_On_Reset> <Resync_Periodic> 7200 </Resync_Periodic> <Profile_Rule>tftp://prov.telco.com: 6900/cisco/config/CP_xxxx_MPP.cfg </Profile_Rule> </flat-profile> -
Elementtitunnisteet erottavat isot ja pienet kirjaimet.
-
Tyhjien elementtien tunnisteet ovat sallittuja, ja ne tulkitaan määrittävän arvon tyhjäksi. Kirjoita avauselementin tunniste ilman vastaavaa elementtitunnistetta ja lisää välilyönti ja eteenpäin viiva sulkemiskulman sulkeeseen (>). Tässä esimerkissä profiilin sääntö B on tyhjä:
<Profile_Rule_B /> -
Tyhjää elementtitunnistetta voidaan käyttää estämään käyttäjän antamien arvojen korvaaminen uudelleensynkronointitoiminnon aikana. Seuraavassa esimerkissä käyttäjän pikavalinnan asetukset eivät muutu:
<flat-profile> <Speed_Dial_2_Name ua="rw"/> <Speed_Dial_2_Number ua="rw"/> <Speed_Dial_3_Name ua="rw"/> <Speed_Dial_3_Number ua="rw"/> <Speed_Dial_4_Name ua="rw"/> <Speed_Dial_4_Number ua="rw"/> <Speed_Dial_5_Name ua="rw"/> <Speed_Dial_5_Number ua="rw"/> <Speed_Dial_6_Name ua="rw"/> <Speed_Dial_6_Number ua="rw"/> <Speed_Dial_7_Name ua="rw"/> <Speed_Dial_7_Number ua="rw"/> <Speed_Dial_8_Name ua="rw"/> <Speed_Dial_8_Number ua="rw"/> <Speed_Dial_9_Name ua="rw"/> <Speed_Dial_9_Number ua="rw"/> </flat-profile> -
Aseta vastaava parametri tyhjäksi merkkijonoksi tyhjällä arvolla. Syötä avautuva ja sulkeutuva elementti ilman arvoa niiden välillä. Seuraavassa esimerkissä GPP_A-parametri on asetettu tyhjäksi merkkijonoksi.
<flat-profile> <GPP_A> </GPP_A> </flat-profile> -
Tunnistamattomat elementtien nimet jätetään huomiotta.
Parametriominaisuudet
Nämä ominaisuudet koskevat parametreja:
Kaikki parametrit, joita profiili ei ole määrittänyt, jätetään muuttumattomiksi puhelimessa.
Tunnistamattomat parametrit jätetään huomiotta.
Jos Avoin muoto -profiili sisältää useita saman parametritunnisteen esiintymiä, viimeinen tällainen esiintymä ohittaa aiemmat. Parametrin määritysarvojen tahattoman ohituksen välttämiseksi suosittelemme, että jokainen profiili määrittää enintään yhden parametrin esiintymän.
Viimeinen käsitelty profiili on etusijalla. Jos useat profiilit määrittävät saman määritysparametrin, jälkimmäisen profiilin arvo on etusijalla.
Merkkijonomuodot
Nämä ominaisuudet koskevat merkkijonojen muotoilua:
Kommentit ovat sallittuja standardin XML-syntaksin kautta.
<!-- My comment is typed here -->Läpi- ja loppuväli sallitaan luettavuuden vuoksi, mutta se poistetaan parametriarvosta.
Arvon uudet rivit muunnetaan välilyönneiksi.
Lomakkeen XML-otsikko
<? ?> on sallittu, mutta puhelin jättää sen huomiotta.Jos haluat kirjoittaa erikoismerkkejä, käytä XML-perusmerkkejä seuraavassa taulukossa esitetyllä tavalla.
Erikoismerkki
XML Escape -sekvenssi
& (ampersandi)
&
< (vähemmän kuin)
<
> (suurempi kuin)
>
'(heittomerkki)
'
” (kaksinkertainen lainaus)
”
Seuraavassa esimerkissä merkkien väänteet merkitään valintasuunnitelmasäännössä vaadittavia suurempia kuin- ja pienempiä symboleja. Tässä esimerkissä määritellään vihjelinjan puhelinsuunnitelma, joka asettaa <Dial_Plan_1_>parametrin (Järjestel si (S0 <:18005551212>).
<flat-profile> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </flat-profile>Numeeriset merkkipakot käännetään desimaali- ja heksadesimaalisten arvo
jen avulla (s.a. (ja.).Puhelimen laiteohjelmisto tukee vain ASCII-merkkejä.
Avaa profiilin pakkaus
Tuettu pakkausmenetelmä on gzip deflate -algoritmi (RFC1951). Gzip-apuohjelma ja pakkauskirjasto, joka toteuttaa saman algoritmin (zlib), ovat saatavilla Internet-sivustoilta.
Pakkauksen tunnistamiseksi puhelin odottaa pakatun tiedoston sisältävän gzip-yhteensopivan otsikon. Gzip-apuohjelman kutsuminen alkuperäiseen Open-profiiliin luo otsikon. Puhelin tarkistaa ladatun tiedoston otsikon tiedostomuodon määrittämiseksi.
Jos esimerkiksi profile.xml on kelvollinen profiili, hyväksytään myös tiedosto profiili.xml. gz. Tämän profiilityypin voi luoda jompikumpi seuraavista komennoista:
-
> gzip profile.xmlKorvaa alkuperäisen tiedoston pakatulla tiedostolla.
-
>cat profile.xml | gzip > profile.xml.gzJättää alkuperäisen tiedoston paikoilleen ja tuottaa uuden pakatun tiedoston.
Avaa profiilin salaus
Symmetrisen avaimen salausta voidaan käyttää avoimen kokoonpanoprofiilin salaamiseen riippumatta siitä, onko tiedosto pakattu vai ei. Pakkaus, jos sitä käytetään, on sovellettava ennen salausta.
Varmistuspalvelin käyttää HTTPS-protokollaa puhelimen alustavan käyttöönoton jälkeen. Määritysprofiilien esisalaus offline-tilassa mahdollistaa HTTP: n käytön profiilien synkronointiin myöhemmin. Tämä vähentää HTTPS-palvelimen kuormitusta laajamittaisissa käyttöönotoissa.
Puhelin tukee kahta salausmenetelmää kokoonpanotiedostoille:
-
AES-256-CBC-salaus
-
RFC 8188-pohjainen HTTP-sisällön salaus AES-128-GCM-salauksella
Avain tai syöttöavaimen materiaali (IKM) on esiasetettava yksikköön aikaisemmin. Salaisen avaimen käynnistys voidaan suorittaa turvallisesti HTTPS: n avulla.
Määritystiedoston nimi ei vaadi tiettyä muotoa, mutta tiedostonimi, joka päättyy .cfg-tunnisteeseen, ilmais ee yleensä määritysprofiilin.
AES-256-CBC-salaus
Puhelin tukee AES-256-CBC-salausta kokoonpanotiedostoille.
OpenSSL-salaustyökalu, joka on ladattavissa eri Internet-sivustoilta, voi suorittaa salauksen. 256-bittisen AES-salauksen tuki saattaa vaatia työkalun uudelleenkokoamista AES-koodin ottamiseksi käyttöön. Laiteohjelmisto on testattu versiota openssl-1.1.1d vastaan.
Salatussa tiedostossa profiilissa oletetaan, että tiedoston muoto on sama kuin seuraavalla komennolla:
# example encryption key = SecretPhrase1234
openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg
# analogous invocation for a compressed xml file
openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg
Pieni kirjain -k edeltää salaista avainta, joka voi olla mikä tahansa pelkkä tekstilause, ja jota käytetään satunnaisen 64-bittisen suolan luomiseen. -k-argumentin määrittämällä salaisuudella salaustyökalu saa satunnaisen 128-bittisen alkuvektorin ja todellisen 256-bittisen salausavaimen.
Kun tätä salausmuotoa käytetään määritysprofiilissa, puhelimelle on ilmoitettava salaisen avaimen arvo tiedoston salauksen purkamiseksi. Tämä arvo määritetään määritykseksi profiilin URL-osoitteessa. Syntaksi on seuraava käyttämällä nimenomaista URL-osoitetta:
[--key “SecretPhrase1234”] http://prov.telco.com/path/profile.cfg
Tämä arvo ohjelmoidaan käyttämällä jotakin Profile_Rule-parametreista.
Useat provisiointiparametrit laajenevat makroa sisäisesti ennen niiden arviointia. Tämä ennakkoarviointivaihe tarjoaa suuremman joustavuuden puhelimen uudelleensynkronointi- ja päivitystoimintojen hallinnassa.
Nämä parametriryhmät laajenevat makro ennen arviointia:
-
Synkronoi uudelleen laukaisija_*
-
Profiili_sääntö*
-
Log_xxx_MSG
-
Päivityssääntö
Tietyissä olosuhteissa jotkin yleiskäyttöiset parametrit (GPP_*) laajennetaan myös makroa, kuten alla olevassa Val innaiset uudelleensynkronointiargumentit -osiossa on nimenomaisesti osoitettu.
Makrojen laajennuksen aikana nimettyjen muuttujien sisältö korvaa lomakkeen $NAME ja $ (NAME) lausekkeet. Näitä muuttujia ovat yleiskäyttöiset parametrit, useita tuotetunnisteita, tietyt tapahtuma-ajastimet ja alustavan tilan arvot. Täydellinen luettelo on kohdassa Makron laajennusmuuttujat kohdasta Provision-parametrit.
Seuraavassa esimerkissä lauseketta $ (MAU) käytetään MAC-osoitteen 000E08012345 lisäämiseen.
Järjestelmänvalvoja kirjoittaa: $ (MAU) config.cfg
Tuloksena oleva makrolaajennus laitteelle, jolla on MAC-osoite 000E08012345, on: 000E08012345config.cfg
Jos makron nimeä ei tunnisteta, sitä ei laajenneta. Esimerkiksi nimeä STRANGE ei tunnisteta kelvolliseksi makronimeksi, kun taas MAU tunnistetaan kelvolliseksi makronimeksi.
Järjestelmänvalvoja kirjoittaa: $strange$mau.cfg
Tuloksena oleva makrolaajennus laitteelle, jolla on MAC-osoite 000E08012345, on: $ Strange000E08012345.cfg
Makrolaajennusta ei käytetä rekursiivisesti. Esimerkiksi $$MAU ”laajenee muotoon $MAU” ($$ laajennetaan) eikä johda MAC-osoitteeseen.
Erikoiskäyttöparametrien, GPP_SA - GPP_SD, sisältö yhdistetään makrolausekkeisiin $SA - $SD. Nämä parametrit ovat vain makroa laajennettu --key-, -- uid- ja --pwd-asetusten argumenttina resync-URL-osoitteessa.
Ehdolliset lausekkeet voivat laukaista uudelleensynkronointitapahtumia ja valita vaihtoehtoisista URL-osoitteista uudelleensynkronointi- ja päivitystoimintoja varten.
Ehdolliset lausekkeet koostuvat vertailuluettelosta, joka on erotettu operaattorilla ja. Kaikkien vertailujen on täytyttävä, jotta ehto on totta.
Jokainen vertailu voi liittyä johonkin seuraavista kolmesta kirjaintyypistä:
-
Kokonaislukuarvot
-
Ohjelmisto- tai laitteistoversioiden numerot
-
Kaksinkertaisesti lainatut merkkijonot
Versionumerot
Cisco Video Phone 8875: n ohjelmistoversio käyttää tätä muotoa (jossa BN on koontinumero):
PHONEOS vvvv. 1-0-1-0001 - BN
missä vvv v ilmaisee puhelinmallin tai puhelinsarjan; 1 on pääversio; 0 on alempi versio; 1-0001 on mikroversio; ja BN on koontinumero.
Vertaileva merkkijono on käytettävä samaa muotoa. Muussa tapauksessa tuloksena on muodon jäsentämisvirhe.
Ohjelmistoversiota verrattaessa pääversiota, sivuversiota ja mikroversiota verrataan peräkkäin, ja vasemmanpuoleiset numerot ovat etusijalla jälkimmäisiin nähden. Kun versionumerot ovat identtiset, koontinumeroa verrataan.
Esimerkkejä kelvollisesta versionumerosta
PHONEOS-8875.1-0-1-0001-19
Vertailu
Lainattuja merkkijonoja voidaan verrata tasa-arvon tai epätasa-arvon suhteen. Kokonaislukuja ja versionumeroita voidaan verrata myös aritmeettisesti. Vertailuoperaattorit voidaan ilmaista symboleina tai lyhenteinä. Lyhenteet ovat käteviä ilmaisemaan ehto avoimen muodon profiilissa.
|
Operaattori |
Vaihtoehtoinen syntaksi |
Kuvaus |
Sovelletaan kokonaisluku- ja versiooperandeihin |
Sovelletaan lainattuihin merkkijonooperandeihin |
|---|---|---|---|---|
|
= |
ekv |
yhtä suuri kuin |
Joo |
Joo |
|
!= |
no |
ei yhtä suuri kuin |
Joo |
Joo |
|
< |
lt |
vähemmän kuin |
Joo |
Ei |
|
<= |
le |
pienempi tai yhtä suuri kuin |
Joo |
Ei |
|
> |
gt |
suurempi kuin |
Joo |
Ei |
|
>= |
ge |
suurempi tai yhtä suuri kuin |
Joo |
Ei |
|
AND |
|
ja |
Joo |
Joo |
On tärkeää sisällyttää makromuuttujat kaksoislainausmerkkeihin, joissa merkkijonon kirjaimellinen odotetaan. Älä tee niin siellä, missä numero tai versionumero on odotettavissa.
Kun niitä käytetään Profile_Rule*- ja Upgrade_Rule -parametrien yhteydessä, ehdolliset lausekkeet on sisällytettävä syntaksiin ”(expr)?” kuten tässä päivityssäännön esimerkissä. Muista korvata BN päivitetyn laiteohjelmistokuorman koontinumerolla.
($SWVER ne PHONEOS-8875.1-0-1-0001-19)? http://ps.tell.com/sw/PHONEOS-8875.1-0-1-0001-BN.loads
Älä käytä edellistä syntaksia sulkeilla Resync_Trigger_* -parametrien määrittämiseen.
Käytä vakioURL-syntaksia määrittääksesi, miten määritystiedostot ja laiteohjelmiston lataukset haetaan Profile_Rule*- ja Upgrade_Rule -parametreissa. Syntaksi on seuraava:
[kaavio://] [palvelin [:portti]] tiedostopolku
Jos järjestelmä on yksi näistä arvoista:
-
tftp
-
http
-
https
Jos järjestelmä jätetään pois, oletetaan tftp: n. Palvelin voi olla DNS-tunnistettu isäntänimi tai numeerinen IP-osoite. Portti on kohdeportin UDP- tai TCP-portin numero. Tiedostoreitin on aloitettava juurihakemistolla (/); sen on oltava absoluuttinen polku.
Jos palvelin puuttuu, käytetään DHCP:n kautta määritettyä tftp-palvelinta (vaihtoehto 66).
Päivityssääntöjä varten palvelin on määritettävä.
Jos por tti puuttuu, käytetään määritetyn järjestelmän vakioporttia. Tftp käyttää UDP-porttia 69, http TCP-porttia 80, https TCP-porttia 443.
Tiedostoreitin on oltava läsnä. Sen ei tarvitse välttämättä viitata staattiseen tiedostoon, mutta se voi osoittaa dynaamista sisältöä, joka on saatu CGI: n kautta.
Makrojen laajennus koskee URL-osoitteita. Seuraavassa on esimerkkejä kelvollisista URL-osoitteista:
/$MA.cfg
/cisco/cfg.xml
192.168.1.130/profiles/init.cfg
tftp://prov.call.com/cpe/cisco$MA.cfg
http://neptune.speak.net:8080/prov/$D/$E.cfg
https://secure.me.com/profile?Linksys
Kun käytät DHCP-vaihtoehtoa 66, päivityssäännöt eivät tue tyhjää syntaksia. Se koskee vain profiilisääntöä*.
RFC 8188-pohjainen HTTP-sisällön salaus
Puhelin tukee RFC 8188-pohjaista HTTP-sisällön salausta AES-128-GCM-salauksella määritystiedostoille. Tällä salausmenetelmällä kuka tahansa entiteetti voi lukea HTTP-viestin otsikot. Kuitenkin vain ne entiteetit, jotka tuntevat syöttöavaimen materiaalin (IKM), voivat lukea hyötykuorman. Kun puhelimeen on asennettu IKM, puhelin ja provisiointipalvelin voivat vaihtaa määritystiedostoja turvallisesti, samalla kun kolmannen osapuolen verkkoelementit voivat käyttää viestin otsikoita analytiikka- ja seurantatarkoituksiin.
XML-määritysparametri IKM_HTTP_EncryptContent pitää IKM: n puhelimessa. Turvallisuussyistä tämä parametri ei ole käytettävissä puhelimen hallinnan verkkosivulla. Se ei myöskään näy puhelimen määritystiedostossa, jota voit käyttää puhelimen IP-osoitteesta tai puhelimen määritysraporteista, jotka lähetetään varauspalvelimelle.
Jos haluat käyttää RFC 8188 -pohjaista salausta, varmista seuraava:
-
Asenna puhelin IKM:llä määrittämällä IKM XML-parametrilla
IKM_HTTP_EncryptContent määritystiedostossa, joka lähetetään alustuspalvelimelta puhelimeen. -
Jos tätä salausta käytetään määrityspalvelimelta puhelimeen lähetetyissä määritystiedostoissa, varmista, että määritystiedoston Content-Encoding HTTP-otsikossa on aes128gcm.
Tämän otsikon puuttuessa AES-256-CBC-menetelmä on etusijalla. Puhelin käyttää AES-256-CBC-salauksen purkua, jos AES-256-CBC-avain on läsnä profiilisäännössä IKM: stä riippumatta.
-
Jos haluat puhelimen käyttävän tätä salausta määritysraporteissa, jotka se lähettää käyttöönottopalvelimelle, varmista, että raporttisäännössä ei ole määritetty AES-256-CBC-avainta.
Valinnaiset uudelleensynkronointiargumentit
Valinnaiset argumentit, key, uid ja pwd, voivat edeltää Profile_Rule* -parametreihin syötettyjä URL-osoitteita, jotka on yhdessä suljettu hakasulkeilla.
--key -asetus kertoo puhelimelle, että sen käyttöönottopalvelimelta vastaanottama määritystiedosto on salattu AES-256-CBC-salauksella, ellei tiedoston Content-Encoding -otsikko osoita aes128gcm-salausta.
Itse avain määritetään merkkijonona termin --key jälkeen. Avain voidaan liittää kaksoislainausmerkkeihin (”) valinnaisesti. Puhelin käyttää avainta kokoonpanotiedoston purkamiseen.
Käyttöesimerkkejä
[--key VerySecretValue]
[--key “my secret phrase”]
[--key a37d2fb9055c1d04883a0745eb0917a4]
Sulkeissa olevat valinnaiset argumentit ovat makrolaajennettuja. Erityiskäyttöparametrit, GPP_SA - GPP_SD, laajennetaan makromuuttujiksi, $ SA - $ SD, vain silloin, kun niitä käytetään keskeisinä vaihtoehtoargumentteina. Katso nämä esimerkit:
[--key $SC]
[--key “$SD”]
Avoimen muodon profiileissa --key -argumentin on oltava sama kuin -k- vaihtoehdon argumentti, joka annetaan openssl: lle.
Uid- ja pwd-asetuksilla voidaan määrittää käyttäjätunnus ja salasana, jotka lähetetään vastauksena HTTP Basic- ja Digest -todennushaasteisiin, kun määritettyä URL-osoitetta pyydetään. Sulkeissa olevat valinnaiset argumentit ovat makrolaajennettuja. Erityiskäyttöparametrit, GPP_SA - GPP_SD, laajennetaan makromuuttujiksi, $ SA - $ SD, vain silloin, kun niitä käytetään keskeisinä vaihtoehtoargumentteina. Katso nämä esimerkit:
GPP_SA = MyUserID
GPP_SB = MySecretPassword
[--uid $SA --pwd $SB] https://provisioning_server_url/path_to_your_config/your_config.xml
laajenisi sitten seuraavaan:
[--uid MyUserId --pwdMySecretPassword] https://provisioning_server_url/path_to_your_config/your_config.xml
Tietotyypit
Näitä tietotyyppejä käytetään kokoonpanoprofiiliparametrien kanssa:
-
{a, b, c,...} - Valinta välillä a, b, c,...
-
Bool—Boolen arvo joko ”kyllä” tai ”ei”.
-
CADscript - miniskripti, joka määrittää signaalin poljinnopeusparametrit. Jopa 127 merkkiä.
Syntaksi: S 1 [; S 2], jossa:
-
S i =D i (päällä i,1 /off i,1 [, päällä i, 2 /off i, 2 [, päällä i, 3 /off i, 3 [, päällä i,4 /off i, 4 [, päällä i,5 /off i ,5 [, päällä i ,6 /off i ,6]]]]) ja tunnetaan nimellä osio.
-
päällä i, j ja pois i, j ovat segmentin päälle/pois-kesto sekunteina. i = 1 tai 2 ja j = 1 - 6.
-
D i on osion kokonaiskesto sekunteina.
Kaikilla kestoilla voi olla enintään kolme desimaalipaikkaa 1 ms: n tarkkuuden aikaansaamiseksi. Jokerimerkki ”*” tarkoittaa ääretöntä kestoa. Osion segmentit toistetaan järjestyksessä ja toistetaan, kunnes kokonaiskesto on toistettu.
Esimerkki 1:
60(2/4) Number of Cadence Sections = 1 Cadence Section 1: Section Length = 60 s Number of Segments = 1 Segment 1: On=2s, Off=4s Total Ring Length = 60sEsimerkki 2 — Erottuva rengas (lyhyt, lyhyt, lyhyt, pitkä):
60(.2/.2,.2/.2,.2/.2,1/4) Number of Cadence Sections = 1 Cadence Section 1: Section Length = 60s Number of Segments = 4 Segment 1: On=0.2s, Off=0.2s Segment 2: On=0.2s, Off=0.2s Segment 3: On=0.2s, Off=0.2s Segment 4: On=1.0s, Off=4.0s Total Ring Length = 60s -
-
DialPlanScript — komentosarjojen syntaksi, jota käytetään rivin 1 ja 2 valintasuunnitelmien määrittämiseen.
-
Flo <n>at —Liukuarvo enintään n desimaalin tarkkuudella.
-
FQDN — Täysin pätevä verkkotunnus. Se voi sisältää enintään 63 merkkiä. Esimerkkejä ovat seuraavat:
sip.cisco.com:5060 tai 109.12.14. 12:12345
Sip.cisco.com tai 109.12.14.12
-
FreqScript - miniskripti, joka määrittelee äänen taajuus- ja tasoparametrit. Sisältää jopa 127 merkkiä.
Syntaksi: F 1 @L 1 [, F 2 @L 2 [, F 3 @L 3 [, F 4 @L 4 [, F 5 @L 5 [, F 6 @L 6]]]], missä:
-
F 1 —F 6 ovat taajuuksia Hz (vain allekirjoittamattomat kokonaisluvut).
-
L 1 —L 6 ovat vast aavia tasoja dBm:ssä (enintään yhdellä desimaalilla).
Valkoiset välilyönnit ennen pilkkua ja sen jälkeen ovat sallittuja, mutta niitä ei suositella.
Esimerkki 1 — Puhelun odotusääni:
440@-10 Number of Frequencies = 1 Frequency 1 = 440 Hz at –10 dBmEsimerkki 2 — Soittoääni:
350@-19,440@-19 Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm -
-
IP— Voimassa oleva IPv4-osoite muodossa x.x.x.x, jossa x on välillä 0 ja 255. Esimerkki: 10.1.2.100.
-
Käyttäjätunnus — Käyttäjätunnus sellaisena kuin se näkyy URL-osoitteessa; enintään 63 merkkiä.
-
Puhelin — puhelinnumeron merkkijono, kuten 14081234567, *69, *72, 345678, tai yleinen URL-osoite, kuten 1234 @10 .10.10. 100:5068 tai jsmith@Cisco.com. Merkkijono voi sisältää enintään 39 merkkiä.
-
PHTMPLT - puhelinnumeromalli. Jokainen malli voi sisältää yhden tai useamman kuvion, jotka on erotettu pilkulla (,). Jokaisen kuvion alussa oleva valkoinen tila jätetään huomiotta. ”?” ja ”*” edustavat yleismerkkejä. Jos haluat esittää kirjaimellisesti, käytä %xx. Esimerkiksi %2a edustaa *. Malli voi sisältää enintään 39 merkkiä. Esimerkkejä: ”1408*, 1510*”, ”1408123???? , 555? 1.”.
-
Portti — TCP/UDP-portin numero (0—65535). Se voidaan määrittää desimaali- tai heksadesimuodossa.
-
ProvisioningRuleSyntax — komentosarjojen syntaksi, jota käytetään määritysten uudelleensynkronointi- ja laiteohjelmiston päivityssääntöjen määrittämiseen.
-
PWRLevel — Tehotaso, joka ilmaistaan dBm:inä yhdellä desimaalilla, kuten —13,5 tai 1,5 (dBm).
-
RSCTMPLT — SIP-vastaustilakoodin malli, kuten ”404, 5*”, ”61?” , ”407, 408, 487, 481”. Se voi sisältää jopa 39 merkkiä.
-
Sig <n>- Allekirjoitettu n-bittinen arvo. Se voidaan määrittää desimaali- tai heksadesimuodossa. ”-” -merkin on edeltävä negatiivisia arvoja. +-merkki ennen positiivisia arvoja on valinnainen.
-
Tähtikoodit — Lisäpalvelun aktivointikoodi, kuten *69. Koodi voi sisältää enintään 7 merkkiä.
-
Str <n>—Yleinen merkkijono, jossa on enintään n varaamatonta merkkiä.
-
A <n>ika —Ajan kesto sekunteina, enintään n desimaalin tarkkuudella. Ylimääräiset desimaalit jätetään huomiotta.
-
Tonescript—miniskripti, joka määrittää puhelun etenemisäänen taajuuden, tason ja poljinnopeusparametrit. Komentosarja voi sisältää enintään 127 merkkiä.
Syntaksi: FreqScript; Z 1 [; Z 2].
Osa Z 1 on samanlainen kuin CADscriptin S 1 -osa, paitsi että kutakin päälle/pois-segmenttiä seuraa taajuuskomponenttien parametri: Z 1 = D 1 (päällä i,1 /off i,1 /f i, 1 [, i,2/off i,2 /f i, 2 /f i, 2 [, päällä i,3 /off i, 3 /f i,3 [, päällä i, 4 /off i, 4 /f i, 4 /f /f i, 4 [, päällä i,5 /pois i ,5 /f i,5 [, päällä i ,6 /pois i ,6 /f i,6]]]]), jossa:
-
f i, j = n 1 [+n 2] +n 3 [+n 4 [+n 5 [+n 6]]]].
-
1 < n k < 6 määrittää taajuuskomponentit FreqScriptissä, joita käytetään kyseisessä segmentissä.
Jos segmentissä käytetään useampaa kuin yhtä taajuuskomponenttia, komponentit lasketaan yhteen.
Esimerkki 1 — Soittoääni:
350@-19,440@-19;10(*/0/1+2) Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm Number of Cadence Sections = 1 Cadence Section 1: Section Length = 10 s Number of Segments = 1 Segment 1: On=forever, with Frequencies 1 and 2 Total Tone Length = 10sEsimerkki 2 - Stutter-ääni:
350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm Number of Cadence Sections = 2 Cadence Section 1: Section Length = 2s Number of Segments = 1 Segment 1: On=0.1s, Off=0.1s with Frequencies 1 and 2 Cadence Section 2: Section Length = 10s Number of Segments = 1 Segment 1: On=forever, with Frequencies 1 and 2 Total Tone Length = 12s -
-
Uns <n>—Merkitsemätön n-bittinen arvo, jossa n = 8, 16 tai 32. Se voidaan määrittää desimaali- tai heksadesimuodossa, kuten 12 tai 0x18, kunhan arvo mahtuu n bittiin.
Pidä nämä huomioon:
- <Par Name>edustaa määritysparametrin nimeä. Profiilissa vastaava tunniste muodostetaan korvaamalla välilyönti alaviivulla ”_”, kuten Par _Name.
- Tyhjä oletusarvokenttä merkitsee tyhjää merkkijonoa < ”” >.
- Puhelin käyttää edelleen viimeisiä määritettyjä arvoja tunnisteille, joita ei ole tietyssä profiilissa.
- Malleja verrataan annetussa järjestyksessä. Ensimmäinen, ei lähin, ottelu valitaan. Parametrin nimen on vastattava tarkasti.
- Jos profiilissa annetaan useampi kuin yksi parametrin määritelmä, viimeinen tällainen määritelmä tiedostossa on se, joka tulee voimaan puhelimessa.
- Parametrimääritys, jossa on tyhjä parametriarvo, pakottaa parametrin takaisin oletusarvoonsa. Jos haluat määrittää tyhjän merkkijonon sen sijaan, käytä tyhjää merkkijonoa ”” parametrin arvona.