Puhelimen määrittäminen profiilin uudelleensynkronointia varten

Puhelinprofiilin uudelleensynkronointi TFTP:n kautta

Puhelin tukee useita verkkoprotokollia konfigurointiprofiilien hakemiseen. Yksinkertaisin profiilinsiirtoprotokolla on TFTP (RFC1350). TFTP:tä käytetään laajalti verkkolaitteiden käyttöönotossa yksityisissä lähiverkoissa. Vaikka TFTP:tä ei suositella etäpäätepisteiden käyttöönotossa Internetin kautta, se voi olla kätevä pienten organisaatioiden käyttöönotossa, talon sisäisessä esivalmistelussa sekä kehitystyössä ja testauksessa. Seuraavassa menettelyssä profiilia muutetaan sen jälkeen, kun tiedosto on ladattu TFTP-palvelimelta.

1

Yhdistä tietokone ja puhelin lähiverkkoympäristössä keskittimeen, kytkimeen tai pieneen reitittimeen.

2

Asenna tietokoneeseen TFTP-palvelin ja ota se käyttöön.

3

Luo konfigurointiprofiili tekstieditorilla.

Jos haluat tarkistaa, että profiili on määritetty puhelimeen myöhemmin, voit määrittää joitakin arvoja merkkeinä. Aseta esimerkiksi GPP_A:n arvoksi 12345678 seuraavan esimerkin mukaisesti:
    < GPP _A> 12345678   </GPP _A>.
4

Tallenna XML-kokoonpanotiedosto TFTP-palvelimen juurihakemistoon.

Voit tarkistaa, että TFTP-palvelin on määritetty oikein: pyytää konfigurointiprofiilitiedostoa käyttämällä muuta TFTP-asiakasta kuin puhelinta. Käytä mieluiten TFTP-asiakasohjelmaa, joka toimii erillisessä isännässä kuin käyttöönottopalvelin.

5

Avaa hallintasivu tietokoneen verkkoselaimessa. Oletetaan esimerkiksi, että puhelimen IP-osoite on 192.168.1.100. Avaa seuraava URL-osoite verkkoselaimessa:


http://192.168.1.100/admin/advanced
6

Valitse Voice > Provisioning -välilehti ja tarkista yleiskäyttöisten parametrien GPP_A - GPP_P arvot. Näiden pitäisi olla tyhjiä.

7

Synkronoi testipuhelin uudelleen luomaasi konfigurointiprofiiliin avaamalla uudelleensynkronointi-URL verkkoselaimessa.

Esimerkki:

Jos TFTP-palvelimen IP-osoite on 192.168.1.200, komento on seuraavan esimerkin kaltainen:


http://192.168.1.100/admin/resync?tftp://192.168.1.200/basic.txt

Kun puhelin vastaanottaa tämän komennon, laite osoitteessa 192.168.1.100 pyytää konfigurointiprofiilitiedostoa basic.txt TFTP-palvelimelta IP-osoitteessa 192.168.1.200. Tämän jälkeen puhelin analysoi ladatun tiedoston ja päivittää GPP_A -parametrin arvolla 12345678.

8

Tarkista, että parametri on päivitetty oikein. Päivitä hallintasivu ja siirry osoitteeseen Voice > Provisioning.

GPP_A -parametrin pitäisi nyt sisältää arvo 12345678.

Puhelinkohtaisen profiilin määrittäminen TFTP-palvelimella
1

Hanki puhelimen MAC-osoite puhelimen tuoteselosteesta. (MAC-osoite on numero, jossa käytetään numeroita ja pieniä heksanumeroita, esimerkiksi 000e08aabbcc.)

2

Nimeä asetustiedosto uudelleen muotoon CP-xxxx macaddress.cfg (korvaa xxxx mallinumerolla ja macaddress puhelimen MAC-osoitteella).

Esimerkki:

CP-8875 000e08aabbcc.cfg

3

Siirrä uusi tiedosto TFTP-palvelimen virtuaaliseen juurihakemistoon.

4

Siirry puhelimen hallintasivulle.

5

Valitse Voice  > Provisioning.

6

Kirjoita profiilitiedoston polku Profile Rule -kenttään.

Esimerkki: Oletetaan, että TFTP-palvelimen IP-osoite on 192.168.1.200 ja profiilitiedoston nimi on 

 <Profile_Rule> tftp://192.168.1.200/CP-8875$MA.cfg </Profile_Rule>
7

Napsauta 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-makroilmaisun MAC-osoitteeksi.

Puhelinprofiilin uudelleensynkronointi HTTP GET:llä
1

Asenna HTTP-palvelin paikalliseen tietokoneeseen tai muuhun käytettävissä olevaan isäntäkoneeseen.

Avoimen lähdekoodin Apache-palvelimen voi ladata internetistä.

2

Lataa konfigurointiprofiilitiedosto asennetun palvelimen virtuaaliseen juurihakemistoon.

3

Voit tarkistaa palvelimen asennuksen ja profiilitiedoston oikeellisuuden avaamalla profiilin verkkoselaimella.

4

Muokkaa testipuhelimen Profile_-sääntöä siten, että se osoittaa HTTP-palvelimeen TFTP-palvelimen sijasta, jotta sen profiili ladataan säännöllisesti.

Jos HTTP-palvelin on esimerkiksi osoitteessa 192.168.1.300 ja profiilin tiedostonimi on basic.txt, anna seuraava arvo:

<Profile_Sääntö> http://192.168.1.200/basic.txt </Profile_Sääntö>
5

Napsauta Lähetä kaikki muutokset. Tämä aiheuttaa välittömän uudelleenkäynnistyksen ja uudelleensynkronoinnin.

6

Tarkkaile puhelimen lähettämiä syslog-viestejä. Ajoittaisten uudelleensynkronointien pitäisi nyt saada profiili HTTP-palvelimelta.

7

Tarkkaile HTTP-palvelimen lokitiedoissa, miten testipuhelimen tunnistetiedot näkyvät käyttäjäagenttien lokissa.

Näihin tietoihin on sisällyttävä valmistaja, tuotteen nimi, nykyinen laiteohjelmistoversio ja sarjanumero.

Synkronoi puhelinprofiili automaattisesti uudelleen

Laite voi uudelleensynkronoida määräajoin käyttöönottopalvelimen kanssa varmistaakseen, että kaikki palvelimella tehdyt profiilimuutokset siirtyvät päätelaitteeseen (toisin kuin lähettämällä nimenomaisen uudelleensynkronointipyynnön päätelaitteelle).

Jos haluat saada puhelimen synkronoimaan palvelimen säännöllisesti uudelleen, määritysprofiilin URL-osoite määritetään käyttämällä Profile_Rule -parametria ja uudelleensynkronointijakso määritetään käyttämällä Resync_Periodic -parametria.

1

Siirry puhelimen hallintasivulle.

2

Valitse Voice  > Provisioning.

3

Määritä parametri Profile_Rule. Tässä esimerkissä oletetaan, että TFTP-palvelimen IP-osoite on 192.168.1.200.

4

Kirjoita Resync Periodic -kenttään pieni arvo testausta varten, esimerkiksi 30 sekuntia.

5

Napsauta Lähetä kaikki muutokset.

Uusilla parametriasetuksilla puhelin synkronoi kahdesti minuutissa URL-osoitteessa määritettyyn määritystiedostoon.

6

Tarkkaile tuloksena syntyviä viestejä syslog-jäljennöksessä.

7

Varmista, että Resync On Reset -kentän arvoksi on asetettu Yes.

 <Resync_On_Reset>Kyllä</Resync_On_Reset>
8

Käynnistä puhelin virrankatkaisulla pakottaaksesi sen synkronoimaan uudelleen käyttöönottopalvelimen kanssa.

Jos uudelleensynkronointi epäonnistuu jostain syystä, esimerkiksi jos palvelin ei vastaa, yksikkö odottaa (kohdassa Resync Error Retry Delay määritetyn sekuntimäärän ajan) ennen kuin se yrittää uudelleensynkronointia uudelleen. Jos Resync Error Retry Delay on nolla, puhelin ei yritä uudelleensynkronointia epäonnistuneen uudelleensynkronointiyrityksen jälkeen.

9

(Valinnainen) Aseta Resync Error Retry Delay -kentän arvoksi pieni luku, esimerkiksi 30.

 <Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>
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 Voice > Provisioning -välilehden kohdassa Configuration Profile . Se määrittelee myös sen merkkijonon syntaksin, joka lisätään puhelimen asetustiedostoon (cfg.xml) XML-koodilla parametrin määrittämiseksi.

Taulukko 1. Profiilin uudelleensynkronointiparametrit

Parametri

Kuvaus

Provision Enable

Sallii tai estää konfiguraatioprofiilin uudelleensynkronointitoimet.

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <Provision_Enable ua="na">Kyllä</Provision_Enable>

  • Aseta puhelimen verkkosivulla tämän kentän arvoksi Kyllä salliaksesi uudelleensynkronointitoiminnot tai Ei estääksesi uudelleensynkronointitoiminnot.

Oletusarvo: Kyllä

Uudelleen synkronointi nollauksen yhteydessä

Määrittää, synkronoiko puhelin kokoonpanot uudelleen määrityspalvelimen kanssa virran kytkemisen jälkeen ja jokaisen päivitysyrityksen jälkeen.

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <Resync_On_Reset ua="na">Kyllä</Resync_On_Reset>

  • Aseta puhelimen verkkosivulla tämän kentän arvoksi Kyllä , jos haluat sallia uudelleensynkronoinnin käynnistyksen tai nollauksen yhteydessä, tai Ei , jos haluat estää uudelleensynkronoinnin käynnistyksen tai nollauksen yhteydessä.

Oletusarvo: Kyllä

Uudelleen synkronoinnin satunnainen viive

Estää määrityspalvelimen ylikuormittumisen, kun suuri määrä laitteita kytkeytyy päälle samanaikaisesti ja yrittää alustavaa määritystä. Tämä viive on voimassa vain ensimmäisellä konfigurointiyrityksellä laitteen käynnistyksen tai nollauksen jälkeen.

Parametri on enimmäisaikaväli, jonka laite odottaa ennen yhteydenottoa käyttöönottopalvelimeen. Todellinen viive on pseudosattumanvarainen luku 0:n ja tämän arvon välillä.

Tämän parametrin yksikkö on 20 sekuntia.

Kelvollinen arvo vaihtelee välillä 0-65535.

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <Resync_Random_Delay ua="na">2</Resync_Random_Delay>

  • Määritä puhelimen verkkosivulla, kuinka monta yksikköä (20 sekuntia) puhelin viivyttää uudelleensynkronointia käynnistyksen tai nollauksen jälkeen.

Oletusarvo on 2 (40 sekuntia).

Uudelleen synkronointi klo (HHmm)

Aika (HHmm), jolloin puhelin synkronoi uudelleen käyttöönottopalvelimen kanssa.

Tämän kentän arvon on oltava nelinumeroinen luku, joka vaihtelee välillä 0000-2400 ja ilmoittaa kellonajan HHmm-muodossa. Esimerkiksi 0959 tarkoittaa 09:59.

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>

  • Määritä puhelimen verkkosivulla kellonaika HHMM-muodossa, jolloin puhelin aloittaa uudelleensynkronoinnin.

Oletusarvo on tyhjä. Jos arvo on virheellinen, parametri jätetään huomiotta. Jos tämä parametri on asetettu kelvollisella arvolla, Resync Periodic -parametri jätetään huomiotta.

Uudelleen synkronointi satunnaisella viiveellä

Estää provisiointipalvelimen ylikuormittumisen, kun suuri määrä laitteita kytkeytyy päälle samanaikaisesti.

Välttääkseen useiden puhelimien palvelimelle lähettämien uudelleensynkronointipyyntöjen tulvan puhelin synkronoi uudelleen tuntien ja minuuttien sekä tuntien ja minuuttien ja satunnaisen viiveen (hhmm, hhmm+random_delay) välillä. Jos esimerkiksi satunnainen viive = (Resync At Random Delay + 30)/60 minuuttia, sekunteina ilmaistu syöttöarvo muunnetaan minuuteiksi ja pyöristetään ylöspäin seuraavaan minuuttiin lopullisen random_delay -välin laskemiseksi.

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>

  • Määritä puhelimen verkkosivulla ajanjakso sekunteina.

Kelvollinen arvo vaihtelee 600 ja 65535 välillä.

Jos arvo on pienempi kuin 600, sisäinen satunnaisviive on välillä 0-600.

Oletusarvo on 600 sekuntia (10 minuuttia).

Uudelleen synkronointi jaksoittain

Ajanjakso, joka kuluu säännöllisen uudelleen synkronoinnin välillä provisiointipalvelimen kanssa. Uudelleensynkronoinnin ajastin on aktiivinen vasta ensimmäisen onnistuneen synkronoinnin jälkeen.

Voimassa olevat muodot ovat seuraavat:

  • Kokonaisluku

    Esimerkki: Tulo 3000 tarkoittaa, että seuraava uudelleensynkronointi tapahtuu 3000 sekunnin kuluttua.

  • Useita kokonaislukuja

    Esimerkki: Syöttö 600,1200,300 tarkoittaa, että ensimmäinen uudelleensynkronointi tapahtuu 600 sekunnin kuluttua, toinen uudelleensynkronointi tapahtuu 1200 sekunnin kuluttua ensimmäisestä uudelleensynkronoinnista ja kolmas uudelleensynkronointi tapahtuu 300 sekunnin kuluttua toisesta uudelleensynkronoinnista.

  • Ajanjakso

    Esimerkki: 2400+30 tarkoittaa, että seuraava uudelleensynkronointi tapahtuu 2400-2430 sekunnin kuluttua onnistuneesta uudelleensynkronoinnista.

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <Resync_Periodic ua="na">3600</Resync_Periodic>

  • Määritä puhelimen verkkosivulla ajanjakso sekunteina.

Aseta tämä parametri nollaan, jos haluat poistaa jaksottaisen uudelleensynkronoinnin käytöstä.

Oletusarvo on 3600 sekuntia.

Uudelleensynkronointivirheen uusintaviive

Jos uudelleensynkronointi epäonnistuu, koska puhelin ei pystynyt hakemaan profiilia palvelimelta, ladattu tiedosto on vioittunut tai ilmenee sisäinen virhe, puhelin yrittää uudelleensynkronointia uudelleen sekunteina määritetyn ajan kuluttua.

Voimassa olevat muodot ovat seuraavat:

  • Kokonaisluku

    Esimerkki: Tulo 300 tarkoittaa, että seuraava uudelleensynkronointiyritys tapahtuu 300 sekunnin kuluttua.

  • Useita kokonaislukuja

    Esimerkki: Syöttö 600,1200,300 tarkoittaa, että ensimmäinen uusintayritys tehdään 600 sekunnin kuluttua epäonnistumisesta, toinen uusintayritys tehdään 1200 sekunnin kuluttua ensimmäisen uusintayrityksen epäonnistumisesta ja kolmas uusintayritys tehdään 300 sekunnin kuluttua toisen uusintayrityksen epäonnistumisesta.

  • Ajanjakso

    Esimerkki: syöttö 2400+30 tarkoittaa, että seuraava uusintayritys tapahtuu 2400-2430 sekunnin kuluttua uudelleensynkronoinnin epäonnistumisesta.

Jos viiveeksi on asetettu 0, laite ei yritä uudelleen synkronointia uudelleen epäonnistuneen synkronointiyrityksen jälkeen.

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <Resync_Error_Retry_Delay ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400</Resync_Error_Retry_Delay>

  • Määritä puhelimen verkkosivulla ajanjakso sekunteina.

Oletusarvo: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400

Pakotettu uudelleensynkronoinnin viive

Suurin viive (sekunteina), jonka puhelin odottaa ennen uudelleensynkronoinnin suorittamista.

Laite ei synkronoi uudelleen, kun jokin sen puhelinlinjoista on aktiivinen. Koska uudelleensynkronointi voi kestää useita sekunteja, on suotavaa odottaa, että laite on ollut pitkään käyttämättömänä ennen uudelleensynkronointia. Näin käyttäjä voi soittaa peräkkäisiä puheluita keskeytyksettä.

Laitteessa on ajastin, joka alkaa laskea alaspäin, kun kaikki sen linjat ovat käyttämättömiä. Tämä parametri on laskurin alkuarvo. Uudelleensynkronointitapahtumat viivästyvät, kunnes tämä laskuri laskee nollaan.

Kelvollinen arvo vaihtelee välillä 0-65535.

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>

  • Määritä puhelimen verkkosivulla ajanjakso sekunteina.

Oletusarvo on 14 400 sekuntia.

Uudelleen synkronointi 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ä tapahtuman sisältävän SIP NOTIFY -viestin: uudelleensynkronointiotsikko laitteeseen.

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <Resync_From_SIP ua="na">Kyllä</Resync_From_SIP>.

  • Valitse puhelimen verkkosivulla Kyllä , jos haluat ottaa tämän ominaisuuden käyttöön, tai Ei , jos haluat poistaa sen käytöstä.

Oletusarvo: Kyllä

Uudelleen synkronointi päivitysyrityksen jälkeen

Ottaa käyttöön tai poistaa käytöstä uudelleensynkronointitoiminnon päivityksen jälkeen. Jos valittuna on Yes , synkronointi käynnistyy laiteohjelmiston päivityksen jälkeen.

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <Resync_After_Upgrade_Attempt ua="na">Yes</Resync_After_Upgrade_Attempt>

  • Valitse puhelimen verkkosivulla Kyllä , jos haluat käynnistää uudelleensynkronoinnin laiteohjelmiston päivityksen jälkeen, tai Ei , jos et halua uudelleensynkronointia.

Oletusarvo: Kyllä

Uudelleen synkronoinnin laukaisija 1

Uudelleen synkronoinnin laukaisija 2

Jos näiden parametrien looginen yhtälö on FALSE, uudelleensynkronointia ei käynnistetä, vaikka Resync On Reset on asetettu TRUE. Ainoastaan suoran toiminto-URL-osoitteen ja SIP-ilmoituksen kautta tapahtuva uudelleensynkronointi ei huomioi näitä uudelleensynkronoinnin käynnistimiä.

Parametrit voidaan ohjelmoida ehdollisella lausekkeella, jossa on makrolaajennus. Kelvolliset makrolaajennukset löytyvät osoitteesta Makrolaajennusmuuttujat kohdasta Käyttöönottoparametrit.

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <Resync_Trigger_1 ua="na">$UPGTMR gt 300 ja $PRVTMR ge 600</Resync_Trigger_1>.

    <Resync_Trigger_2 ua="na"/>

  • Määritä puhelimen verkkosivulla laukaisimet.

Oletusarvo: Tyhjä

Käyttäjän konfiguroitavissa oleva uudelleensynkronointi

Mahdollistaa käyttäjän puhelimen uudelleensynkronoinnin puhelimen näyttövalikosta. Kun asetuksena on Kyllä, käyttäjä voi synkronoida puhelimen kokoonpanon uudelleen syöttämällä profiilisäännön puhelimesta. Kun asetuksena on Ei, parametri Profiilisääntö ei näy puhelimen näyttövalikossa.

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <User_Configurable_Resync ua="na">Kyllä</User_Configurable_Resync>

  • Valitse puhelimen verkkosivulla Kyllä näyttääksesi parametrin Profiilisääntö puhelimen valikossa tai piilottaaksesi tämän parametrin valitsemalla Ei .

Oletusarvo: Kyllä

Uudelleensynkronointi epäonnistuu FNF:ssä

Uudelleensynkronointia pidetään yleensä epäonnistuneena, jos palvelimelta ei saada pyydettyä profiilia. Tämä parametri ohittaa tämän käyttäytymisen. Kun asetuksena on Ei, laite hyväksyy palvelimen file-not-found -vastauksen onnistuneeksi uudelleensynkronoinniksi.

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <Resync_Fails_On_FNF ua="na">Kyllä</Resync_Fails_On_FNF>.

  • Valitse puhelimen verkkosivulla Kyllä , jos haluat hyväksyä tiedostoa ei löydy -vastauksen epäonnistuneeksi uudelleensynkronoinniksi, tai valitse Ei , jos haluat hyväksyä tiedostoa ei löydy -vastauksen onnistuneeksi uudelleensynkronoinniksi.

Oletusarvo: Kyllä

Profiilin todennustyyppi

Määrittää profiilitilin todennuksessa käytettävät tunnistetiedot. Käytettävissä olevat vaihtoehdot ovat:

  • Vammainen: Poistaa profiilitiliominaisuuden käytöstä. Kun tämä toiminto on poistettu käytöstä, Profiilitilin asetukset -valikko ei näy puhelimen näytössä.

  • Perus-HTTP-todennus: HTTP-kirjautumistietoja käytetään profiilitilin todennukseen.

  • XSI-todennus: XSI-kirjautumistietoja tai XSI SIP-tunnuksia käytetään profiilitilin todentamiseen. Todennustiedot riippuvat puhelimen XSI-todennustyypistä:

    • Kun puhelimen XSI-todennustyypiksi on asetettu kirjautumistiedot, käytetään XSI-kirjautumistietoja.

    • Kun puhelimen XSI-todennustyypiksi on asetettu SIP-tunnukset, käytetään XSI:n SIP-tunnuksia.

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <Profile_Authentication_Type ua="na">Basic Http Authentication</Profile_Authentication_Type>

  • Valitse puhelimen verkkosivulla luettelosta vaihtoehto puhelimen profiilin uudelleensynkronoinnin todennusta varten.

Oletusarvo: Perus HTTP-todennus

Lisätietoja on kohdassa Profiilin todennustyypin määrittäminen kohdassa Puhelimen määrittäminen profiilin uudelleensynkronointia varten.

Profiilin sääntö

Profiilin sääntö B

Profiilin sääntö C

Profiilin sääntö D

Kukin profiilisääntö ilmoittaa puhelimelle lähteen, josta profiili (konfigurointitiedosto) haetaan. Jokaisen uudelleensynkronoinnin aikana puhelin soveltaa kaikkia profiileja peräkkäin.

Jos käytät AES-256-CBC-salausta asetustiedostoihin, määritä salausavain --key -avainsanalla seuraavasti:

[--key ]

Voit sulkea salausavaimen valinnaisesti hakasulkeisiin (").

  • Kirjoita puhelimen määritystiedostoon (cfg.xml), jossa on XML, merkkijono tässä muodossa:

    <Profile_Rule ua="na">/$PSN.xml</Profile_Rule>

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • Määritä puhelimen verkkosivulla profiilisääntö.

Oletusarvo: /$PSN.xml

Käytettävä DHCP-vaihtoehto

Komoilla erotetut DHCP-vaihtoehdot, joita käytetään laiteohjelmiston ja profiilien hakemiseen.

Oletusarvo: 66,160,159,150,60,43,125

Käytettävä DHCPv6-vaihtoehto

Komoilla erotetut DHCP-vaihtoehdot, joita käytetään laiteohjelmiston ja profiilien hakemiseen.

Oletusarvo: 17,160,159

Käyttöönotto Ciscon XML:n avulla

Voit määrittää puhelimia Ciscon XML-toimintojen avulla.

Voit lähettää XML-objektin puhelimeen SIP-ilmoituspaketilla tai HTTP Post -lähetyksenä puhelimen CGI-käyttöliittymään: http://PhoneIPAddress/CGI/Execute.

CP-xxxx-3PCC laajentaa Ciscon XML-ominaisuutta tukemaan XML-olion kautta tapahtuvaa käyttöönottoa:

 <CP-xxxx-3PCCExecute> <ExecuteItem URL=Resync:[profile-rule]/> </CP-xxxx-3PCCExecute>

Kun puhelin vastaanottaa XML-objektin, se lataa määritystiedoston osoitteesta [profile-rule]. Tässä säännössä käytetään makroja XML-palvelusovelluksen kehittämisen yksinkertaistamiseksi.

URL-osoitteiden resoluutio makrolaajennuksella

Alihakemistot, joissa on useita profiileja palvelimella, ovat kätevä tapa hallita suurta määrää käyttöönotettuja laitteita. Profiilin URL-osoite voi sisältää:

  • Käyttöönottopalvelimen nimi tai nimenomainen IP-osoite. Jos profiilissa on tunnistettu määrityspalvelimen nimi, puhelin suorittaa DNS-haun nimen ratkaisemiseksi.

  • Epästandardi palvelimen portti, joka määritetään URL-osoitteessa käyttämällä vakiosyntaksia :port palvelimen nimen jälkeen.

  • Palvelimen virtuaalisen juurihakemiston alihakemisto, johon profiili on tallennettu, määritetään käyttämällä tavallista URL-merkintätapaa ja hallinnoidaan makrolaajennuksella.

Esimerkiksi seuraava Profile_-sääntö pyytää profiilitiedostoa ($PN.cfg), joka on palvelimen alihakemistossa /cisco/config, TFTP-palvelimelta, joka toimii isännällä prov.telco.com ja kuuntelee yhteyttä portissa 6900: 

 <Profile_Rule> tftp://prov.telco.com:6900/cisco/config/$PN.cfg </Profile_Rule>

Kunkin puhelimen profiili voidaan yksilöidä yleiskäyttöisessä parametrissa, jonka arvoon viitataan yhteisessä profiilisäännössä makrolaajennuksen avulla.

Oletetaan esimerkiksi, että GPP_B määritellään seuraavasti: Dj6Lmp23Q.

Profile_-säännön arvo on:

 tftp://prov.telco.com/cisco/$B/$MA.cfg

Kun laite synkronoidaan uudelleen ja makrot laajennetaan, puhelin, jonka MAC-osoite on 000e08012345, pyytää profiilia, jonka nimi sisältää laitteen MAC-osoitteen, seuraavasta URL-osoitteesta:

 tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg
Määritä profiilin todennustyyppi

Profiilin todennuksen avulla puhelimen käyttäjät voivat synkronoida käyttöönottoprofiilin uudelleen puhelimeen. Todennustietoja tarvitaan, kun puhelin yrittää synkronoida uudelleen ja ladata asetustiedoston ensimmäistä kertaa ja saa HTTP- tai HTTPS 401 -todennusvirheen. Kun otat tämän ominaisuuden käyttöön, puhelimessa näkyy Profiilitilin asetukset -näyttö seuraavissa tilanteissa:

  • Kun HTTP- tai HTTPs 401 -todennusvirhe ilmenee puhelimen uudelleenkäynnistyksen jälkeisen ensimmäisen käyttöönoton aikana.

  • Kun profiilitilin käyttäjänimi ja salasana ovat tyhjät.

  • Kun profiilisäännössä ei ole käyttäjätunnusta ja salasanaa.

Jos Profiilitilin asetukset -näyttö jää näkemättä tai jätetään huomiotta, käyttäjä voi siirtyä asetusnäyttöön myös puhelimen näyttövalikosta tai Asetukset -pehmonäppäimestä, joka tulee näkyviin vain silloin, kun puhelimessa ei ole rekisteröityjä linjoja.

Kun poistat ominaisuuden käytöstä, puhelimessa ei näy Profile account setup -näyttöä.

Käyttäjänimi ja salasana Profiilisääntö -kentässä ovat korkeammalla prioriteetilla kuin profiilitili.

  • Kun annat oikean URL-osoitteen Profiilisääntö -kenttään ilman käyttäjänimeä ja salasanaa, puhelin vaatii todennuksen tai digestin profiilin uudelleensynkronointia varten. Oikealla profiilitilillä todennus onnistuu. Jos käytössä on väärä profiilitili, todennus epäonnistuu.

  • Kun annat oikean URL-osoitteen Profiilisääntö -kenttään oikealla käyttäjänimellä ja salasanalla, puhelin vaatii todennuksen tai digestin profiilin uudelleensynkronointia varten. 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 todennusta tai digestiä profiilin uudelleensynkronointia varten. Profiilitiliä ei käytetä puhelimen uudelleensynkronointiin. Kirjautuminen epäonnistuu aina.

  • Kun annat väärän URL-osoitteen Profile Rule -kenttään, kirjautuminen epäonnistuu aina.

Voit määrittää parametrit myös puhelimen asetustiedostossa XML(cfg.xml)-koodilla.

Voit määrittää profiilin todennustyypin puhelimen hallintasivulla.

1

Siirry puhelimen hallintasivulle.

2

Valitse Voice > Provisioning.

3

Määritä Configuration Profile -osiossa Profile Authentication Type -parametrin avulla profiilitilin todennuksessa käytettävät tunnistetiedot.

Voit määrittää tämän parametrin puhelimen kokoonpanon XML-tiedostossa (cfg.xml) syöttämällä merkkijonon tässä muodossa:

<Profile_Authentication_Type ua="na">Ei käytössä</Profile_Authentication_Type>

Asetukset:

  • Vammainen: Poistaa profiilitiliominaisuuden käytöstä.Kun tämä ominaisuus on poistettu käytöstä, Profiilitilin asetukset -valikko ei näy puhelimen näytössä.

  • Perus-HTTP-todennus: HTTP-kirjautumistietoja käytetään profiilitilin todennukseen.

  • XSI-todennus: XSI-kirjautumistietoja tai XSI SIP-tunnuksia käytetään profiilitilin todentamiseen. Todennustiedot riippuvat puhelimen XSI-todennustyypistä:

    Kun puhelimen XSI-todennustyypiksi on asetettu kirjautumistiedot, käytetään XSI-kirjautumistietoja.

    Kun puhelimen XSI-todennustyypiksi on asetettu SIP-tunnukset, käytetään XSI:n SIP-tunnuksia.

Oletusarvo: Perus HTTP-todennus

4

Napsauta Lähetä kaikki muutokset.

Profiilin käyttäminen puhelimeen manuaalisesti

Lataa konfigurointitiedosto puhelimeen TFTP-palvelimelta.

Lataa konfigurointitiedosto tietokoneen TFTP-palvelinsovellukseen suorittamalla nämä vaiheet.

1

Liitä tietokone puhelimen LAN-porttiin.

2

Käynnistä TFTP-palvelinsovellus tietokoneella ja varmista, että konfigurointitiedosto on käytettävissä TFTP-juurihakemistossa.

3

Kirjoita verkkoselaimeen puhelimen lähiverkon IP-osoite, tietokoneen IP-osoite, tiedostonimi ja kirjautumistiedot. Käytä tätä muotoa:

http://<WAN_IP_Address>/admin/resync?tftp://<PC_IP_Address>/<file_name>&xuser=admin&xpassword=

Esimerkki: 

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin
Lataa konfigurointitiedosto puhelimeen cURL:n avulla.

Lataa kokoonpano puhelimeen cURL:n avulla suorittamalla nämä vaiheet. Tätä komentorivityökalua käytetään tietojen siirtämiseen URL-syntaksilla. Voit ladata cURL:n osoitteesta:

https://curl.haxx.se/download.html

Suosittelemme, ettet käytä cURL:ää asetusten lähettämiseen puhelimeen, koska käyttäjätunnus ja salasana saattavat jäädä talteen cURL:ää käytettäessä.

1

Liitä tietokone puhelimen LAN-porttiin.

2

Lataa konfigurointitiedosto puhelimeen syöttämällä seuraava cURL-komento:

curl -d @my_config.xml "http://192.168.15.1/admin/config.xml&xuser=admin&xpassword=admin”

Konfigurointiprofiilit

Puhelin hyväksyy määritykset XML-muodossa.

Tämän jakson esimerkeissä käytetään XML-syntaksilla varustettuja konfigurointiprofiileja.

Konfigurointiprofiilien muodot

Määritysprofiilissa määritellään puhelimen parametriarvot.

Määritysprofiilin XML-muodossa käytetään tavallisia XML-kirjoitustyökaluja parametrien ja arvojen kokoamiseen.

Vain UTF-8-merkistöä tuetaan. Jos muokkaat profiilia editorissa, älä muuta koodausmuotoa; muuten puhelin ei voi tunnistaa tiedostoa.

Jokaisella puhelimella on erilaiset ominaisuudet ja siksi myös erilaiset parametrit.

Avoin profiilimuoto

Avoimen formaatin profiili on tekstitiedosto, jonka syntaksi on XML:n kaltainen elementtihierarkia, jossa on elementtien attribuutteja ja arvoja. Tämän muodon avulla voit käyttää vakiotyökaluja määritystiedoston luomiseen. XML-määritystiedosto voidaan lähettää määrityspalvelimelta puhelimeen uudelleensynkronointitoiminnon aikana ilman, että se käännetään binääriobjektiksi.

Puhelin voi hyväksyä vakiotyökalujen tuottamat määritysmuodot. Tämä ominaisuus helpottaa sellaisten taustapalvelinohjelmistojen kehittämistä, jotka luovat konfiguraatioprofiileja olemassa olevista tietokannoista.

Määritysprofiilin luottamuksellisten tietojen suojaamiseksi käyttöönottopalvelin toimittaa XML-määritystiedoston puhelimeen TLS-suojatun 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ää näitä osia:

  • Elementtitunnisteet

  • Määritteet

  • Parametrit

  • Muotoiluominaisuudet

  • XML-kommentit

Esimerkki: Avoin profiilimuoto

  <Resync_On_Reset> Kyllä </Resync_On_Reset> <Resync_Periodic> 7200 </Resync_Periodic> <Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule>

Elementtitunniste sisältää kaikki parametrielementit, jotka puhelin tunnistaa.

Elementin tagin ominaisuudet

Pidä seuraavat säännöt mielessä, kun luot tai päivität asetustiedostoa.

  • XML-muodossa ja Web-käyttöliittymässä voidaan määrittää samat asetukset. XML-tunnisteiden nimet ja kenttien nimet Web-käyttöliittymässä ovat samankaltaisia, mutta vaihtelevat XML-elementtien nimirajoitusten vuoksi. Esimerkiksi alaviivat ( _ ) XML-konfiguraatiotiedostossa välilyöntien sijasta Web-käyttöliittymässä.

  • Puhelin tunnistaa elementit, joilla on oikeat parametrinimet, jotka on koteloitu erityiseen -elementtiin.

  • Elementtien nimet on suljettu hakasulkeisiin.

  • Useimmat elementtien nimet ovat samanlaisia kuin puhelimen web-käyttöliittymän kenttien nimet seuraavin muutoksin:

    • Elementtien nimet eivät saa sisältää välilyöntejä tai erikoismerkkejä. Jos haluat johtaa elementin nimen web-kentän nimestä, korvaa jokainen välilyönti tai erikoismerkkejä [, ], (, ) tai /.

      Esimerkki: <Resync_On_Reset>-elementti edustaa Resync On Reset -kenttää.

    • Jokaisen elementin nimen on oltava yksilöllinen. Puhelimen web-käyttöliittymässä samat kentät voivat näkyä useilla web-sivuilla, kuten Linja-, Käyttäjä- ja Laajennussivuilla. Liitä elementin nimeen [n] osoittaaksesi sivuvälilehdellä näkyvän numeron.

      Esimerkki: Elementti <Dial_Plan_1_> edustaa linjan 1 valintasuunnitelmaa .

  • Jokaisella avaavalla elementtitunnisteella on oltava vastaava sulkeva elementtitunniste. Esimerkiksi:

      <Resync_On_Nollaus> Kyllä </Resync_On_Nollaus> <Resync_Periodic> 7200 </Resync_Periodic> <Profile_Rule>tftp://prov.telco.com: 6900/cisco/config/CP_xxxx_MPP.cfg </Profile_Rule>

  • Elementtitunnisteiden isojen ja pienten kirjainten väliset erot ovat tärkeitä.

  • Tyhjät elementtitunnisteet ovat sallittuja, ja ne tulkitaan siten, että arvo määritetään tyhjäksi. Kirjoita avaava elementtimerkki ilman vastaavaa elementtimerkkiä ja lisää välilyönti ja vinoviiva ennen sulkeutuvaa hakasulkeista (>). Tässä esimerkissä profiilisääntö B on tyhjä:

     <Profile_Rule_B />

  • Tyhjää elementtitunnistetta voidaan käyttää estämään käyttäjän antamien arvojen korvaaminen uudelleensynkronoinnin aikana. Seuraavassa esimerkissä käyttäjän pikavalinta-asetukset säilyvät ennallaan:

     <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"/>

  • Käytä tyhjää arvoa asettaaksesi vastaavan parametrin tyhjäksi merkkijonoksi. Kirjoita avaava ja sulkeva elementti ilman niiden välissä olevaa arvoa. Seuraavassa esimerkissä GPP_A -parametrin arvoksi on asetettu tyhjä merkkijono.

      <GPP_A>    </GPP_A>

  • Tunnistamattomia elementtien nimiä ei oteta huomioon.

Parametrien ominaisuudet

Nämä ominaisuudet koskevat parametreja:

  • Kaikki parametrit, joita ei ole määritetty profiilissa, jätetään puhelimessa ennalleen.

  • Tunnistamattomat parametrit jätetään huomiotta.

  • Jos Avoin muoto -profiili sisältää useita saman parametrin tunnisteen esiintymiä, viimeinen tällainen esiintymä korvaa kaikki aiemmat. Jotta parametrin konfiguraatioarvoja ei voitaisi ohittaa tahattomasti, suosittelemme, että kussakin profiilissa määritetään enintään yksi parametrin esiintymä.

  • Viimeksi käsitelty profiili on etusijalla. Jos useat profiilit määrittävät saman konfigurointiparametrin, jälkimmäisen profiilin arvo on ensisijainen.

Merkkijonomuodot

Nämä ominaisuudet koskevat merkkijonojen muotoilua:

  • Kommentit ovat sallittuja tavallisen XML-syntaksin avulla.

  • Johtava ja perässä oleva valkoinen välilyönti sallitaan luettavuuden vuoksi, mutta se poistetaan parametrin arvosta.

  • Uudet viivat arvon sisällä muunnetaan välilyönneiksi.

  • XML-otsikko muodossa <? ?> on sallittu, mutta puhelin ei huomioi sitä.

  • Erikoismerkkejä voit syöttää käyttämällä XML:n perusmerkkien välilyöntejä, kuten seuraavassa taulukossa on esitetty.

    Erikoismerkki

    XML Escape Sequence

    & (jae)

    &

    < (alle)

    <

    > (suurempi kuin)

    >

    ' (apostrofi)

    '

    " (kaksinkertainen lainausmerkki)

    "

    Seuraavassa esimerkissä merkkien välilyönnit merkitsevät valintasuunnitelmasäännössä vaadittavia suurempi kuin- ja pienempi kuin -symboleita. Tässä esimerkissä määritellään vihjelinjan tiedotussuunnitelma, jossa parametrille <Dial_Plan_1_> (Admin Login > advanced > Voice > Ext (n)) asetetaan arvo (S0 ).

      <Dial_Plan_1_> (S0 ) </Dial_Plan_1_>

  • Numeeriset merkkien pakotteet, joissa käytetään desimaali- ja heksadesimaaliarvoja (s.a. ( ja .), käännetään.

  • Puhelimen laiteohjelmisto tukee vain ASCII-merkkejä.

Avoimen profiilin (XML) pakkaus ja salaus

Avoin konfigurointiprofiili voidaan pakata kokoonpanopalvelimen verkkokuormituksen vähentämiseksi. Profiili voidaan myös salata luottamuksellisten tietojen suojaamiseksi. Pakkausta ei vaadita, mutta sen on edeltävä salausta.

Avoimen profiilin puristus

Tuettu pakkausmenetelmä on gzip-deflate-algoritmi (RFC1951). Gzip-apuohjelma ja samaa algoritmia käyttävä pakkauskirjasto (zlib) ovat saatavilla Internet-sivustoilta.

Pakkauksen tunnistamiseksi puhelin odottaa, että pakattu tiedosto sisältää gzip-yhteensopivan otsikon. Alkuperäisen Open-profiilin gzip-apuohjelman kutsuminen tuottaa otsikon. Puhelin tutkii ladatun tiedoston otsikon tiedostomuodon määrittämiseksi.

Jos esimerkiksi profile.xml on kelvollinen profiili, myös tiedosto profile.xml.gz hyväksytään. Kumpikin seuraavista komennoista voi luoda tämän profiilityypin:

  • >gzip profile.xml

    Korvaa alkuperäisen tiedoston pakatulla tiedostolla.

  • >cat profile.xml | gzip > profile.xml.gz

    Jättää alkuperäisen tiedoston paikalleen ja tuottaa uuden pakatun tiedoston.

Avoimen profiilin salaus

Symmetrisen avaimen salausta voidaan käyttää avoimen konfigurointiprofiilin salaamiseen riippumatta siitä, onko tiedosto pakattu vai ei. Jos pakkausta käytetään, se on tehtävä ennen salausta.

Käyttöönottopalvelin käyttää HTTPS:ää puhelimen alustavaan käyttöönottoon käyttöönoton jälkeen. Määritysprofiilien esisalaaminen offline-tilassa mahdollistaa HTTP:n käytön profiilien myöhemmässä uudelleensynkronoinnissa. Tämä vähentää HTTPS-palvelimen kuormitusta laajamittaisissa asennuksissa.

Puhelin tukee kahta määritystiedostojen salausmenetelmää:

  • AES-256-CBC-salaus

  • RFC 8188:aan perustuva HTTP-sisällön salaus AES-128-GCM-salauksella.

Avain tai syöttöaineisto (Input Keying Material, IKM) on tallennettava laitteeseen aiemmin. Salaisen avaimen siirto voidaan toteuttaa turvallisesti HTTPS:ää käyttämällä.

Konfiguraatiotiedoston nimi ei vaadi tiettyä muotoa, mutta tiedostonimi, joka päättyy .cfg -päätteeseen, viittaa yleensä konfiguraatioprofiiliin.

AES-256-CBC-salaus

Puhelin tukee konfiguraatiotiedostojen AES-256-CBC-salausta.

Salaus voidaan suorittaa OpenSSL-salaustyökalulla, joka on ladattavissa eri Internet-sivustoilta. Tuki 256-bittiselle AES-salaukselle saattaa vaatia työkalun uudelleenkompilointia AES-koodin käyttöönottamiseksi. Laiteohjelmisto on testattu versiolla openssl-1.1.1d.

Salatun tiedoston osalta profiili odottaa, että tiedosto on samassa muodossa kuin seuraavan komennon tuottama tiedosto:

 # esimerkki salausavain = SecretPhrase1234 openssl enc -e -aes-256-cbc -k SecretPhrase1234 -in profile.xml -out profile.cfg # analoginen kutsu pakatulle xml-tiedostolle openssl enc -e -aes-256-cbc -k SecretPhrase1234 -in profile.xml.gz -out profile.cfg

Pieni -k-kirjain edeltää salaista avainta, joka voi olla mikä tahansa tavallinen tekstilause ja jota käytetään satunnaisen 64-bittisen suolan luomiseen. Kun salaisuus on määritetty -k-argumentilla, salaustyökalu johtaa satunnaisen 128-bittisen alkuvektorin ja varsinaisen 256-bittisen salausavaimen.

Kun tätä salausmuotoa käytetään konfigurointiprofiilissa, puhelimelle on ilmoitettava salaisen avaimen arvo tiedoston salauksen purkamiseksi. Tämä arvo määritetään profiilin URL-osoitteessa määritteenä. Syntaksi on seuraava, kun käytetään nimenomaista URL-osoitetta:

 [--key "SecretPhrase1234"] http://prov.telco.com/path/profile.cfg

Tämä arvo ohjelmoidaan käyttämällä yhtä Profile_Sääntö -parametreista.

Makrolaajennus

Useat määritysparametrit laajennetaan sisäisesti makroilla ennen niiden arviointia. Tämä ennakkoarviointivaihe tarjoaa enemmän joustavuutta puhelimen uudelleensynkronoinnin ja päivitystoimintojen ohjaamiseen.

Näille parametriryhmille tehdään makrolaajennus ennen evaluointia:

  • Resync_Trigger_*

  • Profile_Sääntö*

  • Log_xxx_Msg

  • Upgrade_sääntö

Tietyissä olosuhteissa myös jotkin yleiskäyttöiset parametrit (GPP_*) saavat makrolaajennuksen, kuten jäljempänä kohdassa Valinnaiset resynkronointiargumentit nimenomaisesti ilmoitetaan.

Makron laajentamisen aikana nimettyjen muuttujien sisältö korvaa lausekkeet muodossa $NAME ja $(NAME). Näihin muuttujiin kuuluvat yleiskäyttöiset parametrit, useat tuotetunnisteet, tietyt tapahtuma-ajastimet ja varaustilan arvot. Täydellinen luettelo on osoitteessa Makrolaajennusmuuttujat kohdassa Käyttöönottoparametrit.

Seuraavassa esimerkissä lauseketta $(MAU) käytetään lisäämään MAC-osoite 000E08012345.

Järjestelmänvalvoja kirjoittaa: $(MAU)config.cfg.

MAC-osoitteella 000E08012345 varustetun laitteen makrolaajennus on seuraava: 000E08012345config.cfg

Jos makron nimeä ei tunnisteta, se jää laajentamatta. Esimerkiksi nimeä STRANGE ei tunnisteta kelvolliseksi makronimeksi, kun taas MAU tunnistetaan kelvolliseksi makronimeksi.

Järjestelmänvalvoja kirjoittaa: $STRANGE$MAU.cfg.

MAC-osoitteella 000E08012345 varustetun laitteen makrolaajennus on seuraava: $STRANGE000E08012345.cfg

Makrolaajennusta ei käytetä rekursiivisesti. Esimerkiksi $$MAU" laajenee muotoon $MAU" ($$ laajennetaan), eikä tuloksena ole MAC-osoite.

Erityisparametrien sisältö, GPP_SA - GPP_SD, kuvataan makroilmaisuihin $SA - $SD. Nämä parametrit ovat vain makro laajennettuna --key , --uid ja --pwd -vaihtoehtojen argumentteina uudelleensynkronointi-URL:ssä.

Ehdolliset lausekkeet

Ehdolliset lausekkeet voivat käynnistää uudelleensynkronointitapahtumia ja valita vaihtoehtoisia URL-osoitteita uudelleensynkronointi- ja päivitystoimintoja varten.

Ehdolliset lausekkeet koostuvat vertailuista, jotka on erotettu toisistaan ja -operaattorilla. Kaikkien vertailujen on täytyttävä, jotta ehto on tosi.

Kukin vertailu voi liittyä johonkin seuraavista kolmesta literaalityypistä:

  • Kokonaislukuarvot

  • Ohjelmiston tai laitteiston versionumerot

  • Kaksoislauseiset merkkijonot

Versionumerot

Cisco Video Phone 8875:n ohjelmistoversio käyttää tätä muotoa (jossa BN on Build Number):

PHONEOSyyyy.1-0-1-0001-BN

jossa vvvv osoittaa puhelimen mallin tai puhelinsarjan; 1 on pääversio; 0 on pikkuversio; 1-0001 on mikroversio; ja BN on rakennelukumäärä.

Vertailevan merkkijonon on käytettävä samaa muotoa. Muussa tapauksessa tuloksena on muodon jäsentämisvirhe.

Ohjelmistoversiota verrattaessa pääversiota, pienempää versiota ja mikroversiota verrataan peräkkäin, ja vasemmanpuoleisimmat numerot ovat etusijalla jälkimmäisiin nähden. Kun versionumerot ovat identtiset, verrataan rakentamisnumeroa.

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ä, kun halutaan ilmaista tila Open format -profiilissa.

Operaattori

Vaihtoehtoinen syntaksi

Kuvaus

Sovelletaan kokonaisluku- ja versio-operaattoreihin

Sovelletaan lainattuihin merkkijono-operaattoreihin

=

eq

yhtä suuri kuin

Kyllä

Kyllä

!=

ne

ei ole yhtä suuri kuin

Kyllä

Kyllä

<

lt

alle

Kyllä

Ei

<=

Ie

pienempi tai yhtä suuri kuin

Kyllä

Ei

>

gt

suurempi kuin

Kyllä

Ei

>=

ge

suurempi tai yhtä suuri kuin

Kyllä

Ei

JA

ja

Kyllä

Kyllä

Makromuuttujat on tärkeää sulkea kaksinkertaisiin lainausmerkkeihin silloin, kun odotetaan merkkijonon kirjainta. Älä tee niin, kun odotetaan numeroa tai versionumeroa.

Kun ehdollisia lausekkeita käytetään Profile_Rule*- ja Upgrade_Rule -parametrien yhteydessä, ne on suljettava syntaksin "(expr)?" sisään, kuten tässä päivityssääntöesimerkissä. Muista korvata BN päivitettävän laiteohjelmiston versionumerolla.

($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 sulkeissa Resync_Trigger_* parametrien määrittämiseen.

URL-syntaksi

Määritä konfiguraatiotiedostojen ja laiteohjelmistojen latausten hakutapa Standard URL -syntaksilla Profile_Rule*- ja Upgrade_Rule -parametreissa. Syntaksi on seuraava:

[ scheme:// ] [ palvelin [:portti]] tiedostopolku

Jossa järjestelmä on yksi näistä arvoista:

  • tftp

  • http

  • https

Jos järjestelmä jätetään pois, oletuksena on tftp. Palvelin voi olla DNS-tunnistettu isäntänimi tai numeerinen IP-osoite. Portti on kohteen UDP- tai TCP-portin numero. Tiedostopolun on alettava 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 portti puuttuu, käytetään määritetyn järjestelmän standardiporttia. Tftp käyttää UDP-porttia 69, http TCP-porttia 80 ja https TCP-porttia 443.

Tiedostopolun on oltava läsnä. Sen ei välttämättä tarvitse viitata staattiseen tiedostoon, vaan se voi tarkoittaa CGI:n kautta saatua dynaamista sisältöä.

Makrolaajennusta sovelletaan URL-osoitteissa. 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

DHCP-vaihtoehtoa 66 käytettäessä päivityssäännöt eivät tue tyhjää syntaksia. Sitä voidaan soveltaa vain Profiilisääntöön*.

RFC 8188:aan perustuva HTTP-sisällön salaus

Puhelin tukee RFC 8188-pohjaista HTTP-sisällön salausta AES-128-GCM-salauksella asetustiedostojen osalta. Tämän salausmenetelmän avulla mikä tahansa taho voi lukea HTTP-viestin otsikot. Kuitenkin vain ne yksiköt, jotka tuntevat syöttöaineiston (IKM), voivat lukea hyötykuorman. Kun puhelin on otettu käyttöön IKM:n avulla, puhelin ja käyttöönottopalvelin voivat vaihtaa asetustiedostoja turvallisesti, mutta samalla kolmannen osapuolen verkkoelementit voivat käyttää viestien otsikoita analyysi- ja valvontatarkoituksiin.

XML-konfiguraatioparametri IKM_HTTP_Encrypt_Content pitää puhelimen IKM:n. Turvallisuussyistä tätä parametria ei voi käyttää puhelimen hallintasivulla. Se ei myöskään näy puhelimen määritystiedostossa, johon pääset käsiksi puhelimen IP-osoitteesta tai puhelimen määritysraporteista, jotka lähetetään määrityspalvelimelle.

Jos haluat käyttää RFC 8188 -pohjaista salausta, varmista seuraavat asiat:

  • Määritä puhelimen käyttöönotto IKM:llä määrittämällä IKM XML-parametrilla IKM_HTTP_Encrypt_Content määritystiedostossa, joka lähetetään käyttöönottopalvelimelta puhelimeen.

  • Jos tätä salausta sovelletaan määrityspalvelimelta puhelimeen lähetettäviin määritystiedostoihin, varmista, että määritystiedoston Content-Encoding HTTP-otsikossa on aes128gcm.

    Jos tätä otsikkoa ei ole, AES-256-CBC-menetelmä on etusijalla. Puhelin käyttää AES-256-CBC-purkua, jos profiilisäännössä on AES-256-CBC-avain IKM:stä riippumatta.

  • Jos haluat, että puhelin käyttää tätä salausta määrityspalvelimelle lähettämiinsä määritysraportteihin, varmista, että raporttisäännössä ei ole määritetty AES-256-CBC-avainta.

Valinnaiset uudelleensynkronointiargumentit

Valinnaiset argumentit, key, uid ja pwd, voivat edeltää parametreihin Profile_Rule* syötettyjä URL-osoitteita, jotka on suljettu hakasulkeisiin.

avain

--key -vaihtoehto kertoo puhelimelle, että määritystiedosto, jonka se vastaanottaa määrityspalvelimelta, on salattu AES-256-CBC-salauksella, ellei tiedoston Content-Encoding -otsikko ilmoita aes128gcm salausta. Itse avain määritetään merkkijonona termin --key jälkeen. Avain voidaan sulkea valinnaisesti hakasulkeisiin ("). Puhelin käyttää avainta määritystiedoston salauksen purkamiseen.

Käyttöesimerkkejä
 [--key VerySecretValue] [--key "my secret phrase"] [--key a37d2fb9055c1d04883a0745eb0917a4]

Suluissa olevat valinnaiset argumentit on laajennettu makroilla. Erityisparametrit, GPP_SA - GPP_SD, laajennetaan makroilla makromuuttujiksi $SA - $SD vain silloin, kun niitä käytetään avainvaihtoehtojen argumentteina. Katso nämä esimerkit:

[--key $SC] [--key "$SD"]

Open-formaatin profiileissa --key -vaihtoehdon argumentin on oltava sama kuin -k -vaihtoehdon argumentti, joka annetaan openssl-vaihtoehdolle.

uid ja pwd

uid ja pwd -vaihtoehdoilla voidaan määrittää käyttäjätunnus ja salasana, jotka lähetetään vastauksena HTTP:n Basic- ja Digest-todennushaasteisiin, kun määritettyä URL-osoitetta pyydetään. Suluissa olevat valinnaiset argumentit on laajennettu makroilla. Erityisparametrit, GPP_SA - GPP_SD, laajennetaan makroilla makromuuttujiksi $SA - $SD vain silloin, kun niitä käytetään avainvaihtoehtojen argumentteina. Katso nämä esimerkit:

GPP_SA = MyUserID GPP_SB = MySecretPassword (Salasana)

[--uid $SA --pwd $SB] https://provisioning_server_url/path_to_your_config/your_config.xml .xml

laajenisi sitten seuraavasti:

[--uid MyUserID --pwdMySecretPassword] https://provisioning_server_url/ /path_to_your_config/your_config.xml

Tietotyypit

Näitä tietotyyppejä käytetään konfigurointiprofiilin parametrien kanssa:

  • {a,b,c,...}-valinta seuraavista a, b, c, ...

  • Bool-Boolean-arvo, joka on joko "kyllä" tai "ei".

  • CadScript-miniskripti, joka määrittää signaalin kadenssiparametrit. Enintään 127 merkkiä.

    Syntaksi: S1[;S2], jossa:

    • Si=Di(oni,1/offi,1[,oni,2/offi,2[,oni,3/offi,3[,oni,4/off /offi,4[,oni,5/offi,5[,oni,6/offi,6]]]]]), ja sitä kutsutaan osuudeksi.

    • oni,j ja offi,j ovat segmentin on/off kesto sekunteina. i = 1 tai 2 ja j = 1-6.

    • Di on jakson kokonaiskesto sekunteina.

    Kaikissa kestoissa voi olla enintään kolme desimaalia, jolloin resoluutio on 1 ms. Jokerimerkki "*" tarkoittaa ääretöntä kestoa. Osiossa olevat segmentit soitetaan järjestyksessä ja toistetaan, kunnes koko kesto on soitettu.

    Esimerkki 1:

     60(2/4) Kadenssijaksojen lukumäärä = 1 Kadenssijakso 1: Jakson pituus = 60 s Segmenttien lukumäärä = 1 Segmentti 1: On=2s, Off=4s Kokonaisrenkaan pituus = 60s.

    Esimerkki 2 - erottuva rengas (lyhyt, lyhyt, lyhyt, pitkä):

     60(.2/.2,.2/.2,.2/.2,.2/.2,1/4) Kadenssijaksojen määrä = 1 Kadenssijakso 1: Poikkileikkauksen pituus = 60s Segmenttien lukumäärä = 4 Segmentti 1: On=0.2s, Off=0.2s Segmentti 2: On=0.2s, Off=0.2s Segmentti 3: On=0.2s, Off=0.2s Segmentti 4: On=1.0s, Off=4.0s Kokonaisrenkaan pituus = 60s.

  • DialPlanScript-skriptiosyntaksi, jota käytetään linja 1- ja linja 2 -valintasuunnitelmien määrittämiseen.

  • Float-liukulukuarvo, jossa on enintään n desimaalia.

  • FQDN-Fully Qualified Domain Name. 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äärittää äänen taajuus- ja tasoparametrit. Sisältää enintään 127 merkkiä.

    Syntaksi: F1@L1[,F2@L2[,F3@L3[,F4@L4[,F5@L5[,F6@L6]]]]], jossa:

    • F1-F6 ovat taajuuksia Hz:nä (vain merkitsemättömät kokonaisluvut).

    • L1-L6 ovat vastaavat tasot dBm:nä (yhden desimaalin tarkkuudella).

    Välilyönnit ennen ja jälkeen pilkun ovat sallittuja, mutta niitä ei suositella.

    Esimerkki 1-puhelun odotusääni:

     440@-10 Taajuuksien lukumäärä = 1 Taajuus 1 = 440 Hz -10 dBm:n taajuudella.

    Esimerkki 2-valintaääni:

     350@-19,440@-19 Taajuuksien määrä = 2 Taajuus 1 = 350 Hz -19 dBm:n taajuudella Taajuus 2 = 440 Hz -19 dBm:n taajuudella Taajuus 2 = 440 Hz -19 dBm:n taajuudella

  • IP- Kelvollinen IPv4-osoite muodossa x.x.x.x.x, jossa x on välillä 0-255. Esimerkki: 10.1.2.100.

  • UserID-käyttäjätunnus sellaisena kuin se näkyy URL-osoitteessa; enintään 63 merkkiä.

  • Phone-puhelinnumerosarja, 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. Kukin malli voi sisältää yhden tai useamman mallin, jotka erotetaan toisistaan pilkulla (,). Kunkin kuvion alussa olevaa valkoista tilaa ei oteta huomioon. "?" ja "*" ovat jokerimerkkejä. Jos haluat esittää kirjaimellisesti, käytä %xx. For example, %2a edustaa *. Malli voi sisältää enintään 39 merkkiä. Esimerkkejä: "1408*, 1510*", "1408123????, 555?1.".

  • Port-TCP/UDP-portin numero (0-65535). Se voidaan määrittää desimaali- tai heksamuodossa.

  • ProvisioningRuleSyntax-skriptiosyntaksi, jota käytetään kokoonpanon uudelleensynkronointi- ja laiteohjelmiston päivityssääntöjen määrittelyyn.

  • PwrLevel-Tehotaso ilmaistuna dBm:nä yhden desimaalin tarkkuudella, esimerkiksi -13,5 tai 1,5 (dBm).

  • RscTmplt-Malli SIP-vastauksen tilakoodista, kuten "404, 5*", "61?", "407, 408, 487, 481". Se voi sisältää enintään 39 merkkiä.

  • Sig-Signed n-bit value. Se voidaan määrittää desimaali- tai heksamuodossa. Negatiivisten arvojen edessä on oltava merkki "-". +-merkki ennen positiivisia arvoja on valinnainen.

  • Tähtikoodit - Lisäpalvelun aktivointikoodi, kuten *69. Koodi voi sisältää enintään 7 merkkiä.

  • Str-Yleinen merkkijono, jossa on enintään n varaamatonta merkkiä.

  • Time-Ajan kesto sekunteina, enintään n desimaalin tarkkuudella. Ylimääräiset desimaalierot jätetään huomiotta.

  • ToneScript-miniskripti, joka määrittää puhelun etenemisäänen taajuuden, tason ja tahdin parametrit. Käsikirjoitus voi sisältää enintään 127 merkkiä.

    Syntaksi: FreqScript;Z1[;Z2].

    Osa Z1 on samanlainen kuin CadScriptin osa S1 , paitsi että jokaista on/off-segmenttiä seuraa taajuuskomponenttiparametri: Z1 = D1(oni,1/offi,1/fi,1[,oni,2/offi,2/fi,2 [,oni,3/offi,3/fi,3 [,oni,4/offi,4/fi,4 [,oni,5/offi,5/fi,5

    • fi,j = n1[+n2]+n3[+n4[+n5[+n6]]]]].

    • 1 < nk < 6 määrittää FreqScriptin taajuuskomponentit, joita käytetään kyseisessä segmentissä.

    Jos segmentissä käytetään useampaa kuin yhtä taajuuskomponenttia, komponentit lasketaan yhteen.

    Esimerkki 1-valintaääni:

     350@-19,440@-19;10(*/0/1+2) Taajuuksien lukumäärä = 2 Taajuus 1 = 350 Hz -19 dBm:n taajuudella Taajuus 2 = 440 Hz -19 dBm:n taajuudella Kadenssijaksojen lukumäärä = 1 Kadenssijakso 1: Jakson pituus = 10 s Segmenttien lukumäärä = 1 Segmentti 1: Päällä = ikuisesti, taajuuksilla 1 ja 2 Äänen kokonaispituus = 10s.

    Esimerkki 2-Stutter-ääni:

     350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Taajuuksien lukumäärä = 2 Taajuus 1 = 350 Hz -19 dBm:n taajuudella Taajuus 2 = 440 Hz -19 dBm:n taajuudella Kadenssijaksojen lukumäärä = 2 Kadenssijakso 1: Osuuden pituus = 2s Segmenttien lukumäärä = 1 Segmentti 1: On=0.1s, Off=0.1s taajuuksilla 1 ja 2 Cadence Section 2: Jakson pituus = 10 s Segmenttien lukumäärä = 1 Segmentti 1: Päällä = ikuisesti, taajuuksilla 1 ja 2 Äänen kokonaispituus = 12s.

  • Uns-Esimerkitön n-bittinen arvo, jossa n = 8, 16 tai 32. Se voidaan määrittää desimaali- tai heksamuodossa, kuten 12 tai 0x18, kunhan arvo mahtuu n bittiin.

Pidä nämä mielessäsi:

  • edustaa konfigurointiparametrin nimeä. Profiilissa vastaava tunniste muodostetaan korvaamalla välilyönti alaviivalla "_", esimerkiksi Par_Nimi.
  • Tyhjä oletusarvokenttä merkitsee tyhjää merkkijonoa < “” >.
  • Puhelin käyttää edelleen viimeksi määritettyjä arvoja tunnisteille, joita ei ole tietyssä profiilissa.
  • Malleja verrataan annetussa järjestyksessä. Valitaan ensimmäinen, ei lähin, vastaavuus. Parametrin nimen on vastattava täsmälleen.
  • Jos profiilissa on annettu useampi kuin yksi määritelmä parametrille, puhelimessa otetaan käyttöön tiedoston viimeinen määritelmä.
  • Jos parametrin määrittelyssä on tyhjä parametrin arvo, parametri palautetaan oletusarvoonsa. Jos haluat määrittää sen sijaan tyhjän merkkijonon, käytä parametrin arvona tyhjää merkkijonoa "".