Määritä puhelimen profiilin uudelleensynkronointi

Synkronoi puhelinprofiili uudelleen TFTP

Puhelin tukee useiden verkkoprotokollien käyttämistä konfigurointiprofiilien noutamisessa. Profiilien perussiirtoprotokolla on TFTP (RFC1350). TFTP-protokolla on yleisesti käytössä verkkolaitteiden valmistelussa yksityisissä lähiverkoissa. TFTP-protokollaa ei suositella käytettäväksi Internetin kautta tehtävien päätelaitteiden etävalmisteluun, mutta protokolla voi olla erittäin kätevä vaihtoehto pienille organisaatioille, sisäiseen esivalmisteluun sekä kehitys- ja testaustöihin. Seuraavissa ohjeissa profiilia muokataan, kun sen tiedosto on ladattu TFTP-palvelimelta.

1

Liitä tietokone ja puhelin LÄHI-ympäristössä keskittimään, kytkimeen tai pieneen reitittimeen.

2

Asenna ja aktivoi TFTP palvelin tietokoneeseen.

3

Kokoonpanoprofiilin luominen tekstieditorilla.

Voit tarkistaa, onko profiili valmistettu puhelimeesi myöhemmin, määrittämällä osa arvoista merkeiksi. Määritä esimerkiksi GPP_A arvoksi 12345678 seuraavassa esimerkissä:
 <profiili>
 <GPP_A> 12345678
 </GPP_A>
<-profiili>
4

Tallenna XML määritystiedosto TFTP-palvelimen päähakemistoon.

Voit tarkistaa, että TFTP-palvelin on määritetty oikein: pyydä määritysprofiilitiedostoa käyttämällä toista TFTP asiakasta kuin puhelinta. Jos mahdollista, käytä TFTP-asiakasta, jota suoritetaan eri isäntäkoneessa kuin valmistelupalvelinta.

5

Avaa tietokoneen Web-selaimessa Hallinta-Web-sivu. Oletetaan esimerkiksi, että puhelimen IP-osoite on 192.168.1.100, avaa seuraava URL-osoite Web-selaimessasi:

 http://192.168.1.100/admin/advanced
6

Valitse Voice > Provisioning-välilehti ja tarkista yleisluont.parametrien arvot, GPP_A GPP_P. Niiden pitäisi olla tyhjät.

7

Synkronoi testipuhelin uudelleen luomaasi määritysprofiiliin avaamalla uudelleensynkronointi-URL Web-selaimessa.

Esimerkki:

Komennon pitäisi olla seuraavan esimerkin kaltainen, jos TFTP-palvelimen IP-osoite on 192.168.1.200:

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

Kun puhelin vastaanottaa tämän komennon, osoite 192.168.1.100 pyytää määritysprofiilitiedoston basic.txt TFTP-palvelimesta osoitteessa 192.168.1.200 IP. Tämän jälkeen puhelin jäsentää ladatun tiedoston ja päivittää GPP_A-parametrin arvoksi 12345678.

8

Varmista, että parametri on päivitetty oikein. Päivitä hallinnan Web-sivu ja siirry Voice >Provisioningiin.

GPP_A-parametrin tulee nyt sisältää arvo 12345678.

Puhelinkohtaisen profiilin luominen TFTP-palvelimeen

1

Tarkista puhelimen MAC-osoite sen tuotetarrasta. (MAC-osoite on numero, jossa käytetään numeroita ja alanumeroita, esimerkiksi 000e08abbcc.

2

Nimeä määritystiedosto uudelleen arvoksi CP-sähköposti macaddress.cfg (korvaamalla määritystiedoston mallinumerolla ja macaddressilla puhelimen MAC osoitteella).

Esimerkki:

CP-8875 000e08aabbcc.cfg

3

Siirrä uusi tiedosto TFTP-palvelimen virtuaaliseen päähakemistoon.

4

Siirry puhelimen hallintaverkkosivulle.

5

Valitse Puheposti  > Provisioning.

6

Kirjoita profiilitiedoston polku Profiilisääntö-kenttään .

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

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

Valitse Submit All Changes. Tämä aiheuttaa välittömän uudelleenkäynnistyksen ja uudelleensynkronoinnin.

Kun seuraava uudelleensynkronointi tapahtuu, puhelin noutaa uuden tiedoston laajentamalla $MA-makrolaajennuksen puhelimen MAC-osoitteeksi.

Synkronoi puhelinprofiili uudelleen HTTP GET -toiminnolla

1

Http-palvelimen asentaminen paikalliselle tietokoneelle tai muulle käytettävissä olevalle isännälle.

Internetistä voi ladata avoimen lähdekoodin Apache-palvelimen.

2

Lataa määritysprofiilitiedosto asennetun palvelimen virtuaalipäähakemistoon.

3

Voit tarkistaa palvelimen oikean asennuksen ja käyttää profiilitiedostoa avaamalla profiilin Web-selaimella.

4

Muokkaa testipuhelimella Profile_Rule-sääntö viittaamaan HTTP-palvelimeen TFTP-palvelimen sijasta, jolloin puhelin lataa profiilin ajoittain.

Jos esimerkiksi oletetaan, että HTTP-palvelin on numerossa 192.168.1.300 ja profiilin tiedostonimi on basic.txt, anna seuraava arvo:

<Profile_Rule> http://192.168.1.200/basic.txt </Profile_Rule>
5

Valitse Submit All Changes. Tämä aiheuttaa välittömän uudelleenkäynnistyksen ja uudelleensynkronoinnin.

6

Tarkkaile puhelimen lähettämiä syslog-viestejä. Säännöllisten uudelleensynkronointien pitäisi nyt tuottaa profiili HTTP-palvelimelta.

7

Tarkista HTTP-palvelinlokeista, miten testipuhelimen tunnistetiedot näkyvät käyttäjäagenttien lokissa.

Tiedoissa pitäisi olla valmistaja, tuotenimi, nykyinen laiteohjelmaversio ja sarjanumero.

Synkronoi puhelinprofiili automaattisesti uudelleen

Laite voidaan uudelleensynkronoida valmistelupalvelimen kanssa säännöllisesti. Näin varmistetaan, että palvelimelle tehdyt profiilimuutokset välittyvät päätelaitteisiin automaattisesti (sen sijaan, että päätelaitteet käyttäisivät erillisiä uudelleensynkronointipyyntöjä).

Puhelimen säännöllinen uudelleensynkronointi palvelimen kanssa otetaan käyttöön määrittämällä konfigurointiprofiilin URL-osoite Profile_Rule-parametriin ja uudelleensynkronointiväli Resync_Periodic-parametriin.

1

Siirry puhelimen hallintaverkkosivulle.

2

Valitse Puheposti  > Provisioning.

3

Määritä Profile_Rule-parametri. 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

Valitse Lähetä kaikki muutokset.

uuden parametriasetuksen mukaan puhelin tekee uudelleensynkronoinnin URL-osoitteen mukaisella konfigurointitiedostolla kahdesti minuutissa.

6

Syslog-seurannan tuloksena olevien viestien jäljitys.

7

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

 <Resync_On_Reset>Yes</Resync_On_Reset>
8

Pakota puhelin tekemään uudelleensynkronointi valmistelupalvelimen kanssa sammuttamalla ja kytkemällä puhelimen päälle.

Jos uudelleensynkronointi epäonnistuu jostakin syystä (palvelin ei esimerkiksi vastaa), yksikkö odottaa Resync Error Retry Delay -parametrin arvoksi määritetyn sekuntimäärän ennen uudelleensynkronoinnin yrittämistä uudelleen. Jos Resync Error Retry Delay-arvona on nolla, puhelin ei yritä uudelleensynkronointia uudelleen epäonnistuneen uudelleensynkronoinnin jälkeen.

9

(Valinnainen) Aseta Resync Error Retry Delay -kentän arvo pieneksi, esimerkiksi 30.

 <Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>
10

Poista TFTP-palvelin käytöstä ja tarkkaile syslog-tulosteen tuloksia.

Profiilin uudelleensynkronointiparametrit

Seuraavassa taulukossa määritetään Puhelimen Web-sivun Puheposti>Profiilin uudelleensynkronointiparametrien toiminta ja käyttö Kokoonpanoprofiili-osassa . Se määrittää myös puhelimen määritystiedostoon (cfg.xml) lisätyn merkkijonon syntaksin, jossa on XML koodi parametrin määrittämiseksi.

Taulukko 1. Profiilin uudelleensynkronointiparametrit

Parametri

Kuvaus

Provision Enable

Sallii tai hylkää määritysprofiilin uudelleensynkronointitoiminnot.

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

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

  • Määritä puhelimen Web-sivulla tälle kentälle Kyllä , jos haluat sallia uudelleensynkronointitoimet, tai Ei , jos haluat estää uudelleensynkronointitoimet.

Oletusarvo: Kyllä

Resync On Reset

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

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

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

  • Määritä puhelimen Web-sivulla tälle kentälle Kyllä , jos haluat sallia uudelleensynkronin virran kytkemisen tai nollauksen aikana, tai Ei , jos haluat estää uudelleensynkronin virran kytkemisen tai palauttamisen.

Oletusarvo: Kyllä

Resync Random Delay

Estää provisiointipalvelimen ylilatauksen, kun suuri määrä laitteita käynnistyy samanaikaisesti ja yrittää määrittää alusta. Tämä viive tulee voimaan vain ensimmäisellä määritysyrityksellä laitteen käynnistymisen tai palauttamisen jälkeen.

Parametri on enimmäisaika, jonka laite odottaa ennen yhteydenottoa valmistelupalvelimeen. Varsinainen viive on pseudo random -luku 0:n ja tämän arvon välillä.

Parametri on 20 sekunnin yksiköissä.

Kelvollinen arvoväli on 0–65535.

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

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

  • Määritä puhelimen Web-sivulla, kuinka monta yksikköä (20 sekuntia) puhelin käyttää uudelleensynkronointiin virran kytkemisen tai nollauksen jälkeen.

Oletusarvo on 2 (40 sekuntia).

Resync At (HHmm)

Aika (HHmm), jonka puhelin synkronoituu uudelleen provisiointipalvelimen kanssa.

Tämän kentän arvon on oltava nelinumeroinen numero 0000–2400. Numerot ilmaisevat ajan HHmm-muodossa (tunnit ja minuutit). Esimerkiksi 0959 vastaa kellonaikaa 9.59.

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

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

  • Määritä puhelimen Web-sivulla aika HHMM-muodossa, jolloin puhelin aloittaa uudelleensynkronointi.

Oletusarvo on tyhjä. Jos arvo on virheellinen, parametri ohitetaan. Jos tälle parametrille on määritetty kelvollinen arvo, uudelleensynkronointijakson parametri ohitetaan.

Resync At Random Delay

Estää provisiointipalvelimen ylilatauksen, kun suuri määrä laitteita käynnistyy yhtä aikaa.

Jotta puhelimet eivät lähettäisi palvelimelle liikaa pyyntöjä, puhelimille voidaan määrittää uudelleensynkronoinnin aikaväli määrittämällä tunteina ja minuutteina ilmaistu uudelleensynkronointiaika sekä satunnainen viive (hhmm, hhmm+satunnainen_viive). Jos esimerkiksi satunnaisviive = (Resync At Random Delay + 30) / 60 minuuttia, syötearvo sekunteina muunnetaan minuutiksi pyöristymällä seuraavaan minuuttiin asti laskemalla lopullinen random_delay ajanjakso.

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

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

  • Määritä ajanjakso puhelimen Web-sivulla sekunteina.

Kelvollinen arvoväli on 600–65535.

Jos arvo on pienempi kuin 600, sisäinen satunnaisviive on 0–600.

Oletusarvo on 600 sekuntia (10 minuuttia).

Resync Periodic

Aikaväli provisiointipalvelimen kanssa ajoittaisen uudelleensynkronoinnin välillä. Tähän liittyvä uudelleensynkronointiajastin aktivoituu vasta, kun synkronointi palvelimen kanssa onnistuu ensimmäisen kerran.

Kelvolliset muodot ovat seuraavat:

  • Kokonaisluku

    Esimerkki: syöte 3000 määrittää, että seuraava uudelleensynkronointi tehdään 3000 sekunnin kuluttua.

  • Usea kokonaisluku

    Esimerkki: syöte 600,1200,300 määrittää, että ensimmäinen uudelleensynkronointi tehdään 600 sekunnin kuluttua, toinen 1 200 sekuntia ensimmäisen jälkeen ja kolmas 300 sekuntia toisen jälkeen.

  • Aikaväli

    Esimerkki: syöte 2400+30 määrittää, että seuraava uudelleensynkronointi tehdään 2 400–2 430 sekuntia onnistuneen uudelleensynkronoinnin jälkeen.

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

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

  • Määritä ajanjakso puhelimen Web-sivulla sekunteina.

Aseta tämän parametrin arvoksi nolla, jos haluat poistaa säännöllisen uudelleensynkronoinnin käytöstä.

Oletusarvo on 3600 sekuntia.

Resync Error Retry Delay

Jos uudelleensynkronointitoiminto epäonnistuu, koska puhelin ei pystynyt noutamaan profiilia palvelimesta tai ladattu tiedosto on vioittunut tai ilmenee sisäinen virhe, puhelin yrittää synkronoida uudelleen sekunteina määritetyn ajan jälkeen.

Kelvolliset muodot ovat seuraavat:

  • Kokonaisluku

    Esimerkki: syöte 300 määrittää, että uudelleensynkronointia yritetään uudelleen seuraavaksi 300 sekunnin kuluttua.

  • Usea kokonaisluku

    Esimerkki: syöte 600,1200,300 määrittää, että uudelleensynkronointia yritetään uudelleen ensin 600 sekunnin kuluttua, toisen kerran 1 200 sekuntia ensimmäisen epäonnistuneen uudelleenyrityksen jälkeen ja kolmannen kerran 300 sekuntia toisen epäonnistuneen uudelleenyrityksen jälkeen.

  • Aikaväli

    Esimerkki: syöte 2400+30 määrittää, että uudelleensynkronointia yritetään uudelleen 2 400–2 430 sekuntia uudelleensynkronoinnin epäonnistumisen jälkeen.

Jos viiveeksi asetetaan 0, laite ei yritä uudelleensynkronointia uudelleen epäonnistuneen uudelleensynkronoinnin jälkeen.

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

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

  • Määritä ajanjakso puhelimen Web-sivulla sekunteina.

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

Forced Resync Delay

Enimmäisviive (sekunteina), jonka puhelin odottaa ennen uudelleensynkronointia.

Laite ei tee uudelleensynkronointia, kun jokin puhelinlinjoista on aktiivisena. Koska uudelleensynkronointi voi kestää useita sekunteja, on suositeltavaa, että uudelleensynkronointi aloitetaan, kun laite on ollut käyttämättä pidempään. Tällä varmistetaan, että käyttäjä voi soittaa peräkkäisiä puheluja ilman häiriöitä.

Laitteessa on ajastin, joka alkaa laskea alaspäin, kun kaikki linjat vapautuvat. Tämä parametri määrittää tämän ajastimen aloitusarvon. Uudelleensynkronointitapahtumia viivytetään siihen asti, että ajastin laskee nollaan.

Kelvollinen arvoväli on 0–65535.

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

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

  • Määritä ajanjakso puhelimen Web-sivulla sekunteina.

Oletusarvo on 14,400 sekuntia.

Resync From SIP

Hallitsee uudelleensynkronointitoimintojen pyyntöjä SIP NOTIFY -tapahtumalla, joka on lähetetty palveluntarjoajan välityspalvelimesta puhelimeen. Jos välityspalvelin on otettu käyttöön, se voi pyytää uudelleensynkronointia lähettämällä SIP NOTIFY -viestin, joka sisältää tapahtuman: synkronoi otsikko uudelleen laitteeseen.

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

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

  • Ota tämä toiminto käyttöön valitsemalla puhelimen Web-sivulla Kyllä tai poista se käytöstä Ei .

Oletusarvo: Kyllä

Resync After Upgrade Attempt

Ottaa käyttöön minkä tahansa päivityksen jälkeen tehtävät uudelleensynkronoinnit tai poistaa ne käytöstä. Jos Kyllä on valittu, synkronointi käynnistetään laitteisto-ohjelmiston päivityksen jälkeen.

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

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

  • Valitsepuhelimen Web-sivulla Kyllä , jos haluat käynnistää uudelleensynkronin laitteisto-ohjelmiston päivityksen jälkeen tai ei , jos haluat olla synkronoimatta uudelleen.

Oletusarvo: Kyllä

Uud.synkronoinnin käynnistin 1

Uud.synkronoinnin käynnistin 2

Jos näiden parametrien looginen uudelleensynkronointi arvioidaan epätodeksi, uudelleensynkronointi ei käynnisty, vaikka Uudelleensynkronointi nollauksen yhteydessä -arvoksi on valittu TOSI. Vain uudelleensynkronointi suoralla toiminnolla URL ja SIP-ilmoituksella ohittaa nämä uudelleensynkronointikäynnisteet.

Parametrit voidaan ohjelmoida makrolaajennusta käyttävällä, läpikäytetyllä ilmaisulla. Kelvollisia makrolaajennuksia on kohdassa Makron laajennusmuuttujat Valmistelu-parametreissa.

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

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

    <Resync_Trigger_2 ua="na"/>

  • Määritä käynnistimet puhelimen Web-sivulla.

Oletus: tyhjä

User Configurable Resync

Mahdollistaa puhelimen synkronoinnin uudelleen puhelimen näyttövalikosta. Kun asetukseksi on valittu Kyllä, käyttäjä voi synkronoida puhelimen määritykset uudelleen antamalla profiilisäännön puhelimesta. Kun asetukseksi on valittu Ei, Profiilisääntöparametri ei näy puhelimen näyttövalikossa.

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

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

  • Näytä profiilisääntöparametri puhelimen Web-sivulla tai piilota parametri valitsemalla Ei .

Oletusarvo: Kyllä

Resync Fails On FNF

Uudelleensynkronoinnin katsotaan yleensä epäonnistuneen, jos palvelimelta ei saada pyydettyä profiilia. Tämä parametri ohittaa tämän toiminnon. Kun asetukseksi on valittu Ei , laite hyväksyy palvelimesta tiedoston löytämättömän vastauksen onnistuneena uudelleensynkronointina.

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

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

  • Valitse puhelimen Web-sivulla Kyllä , jos haluat ottaa tiedostoa ei löydy -vastauksen epäonnistuneena uudelleensynkronointina tai valitse Ei , jos haluat ottaa tiedostoa löytämättä olevan vastauksen onnistuneena uudelleensynkronointina.

Oletusarvo: Kyllä

Profiilin todennustyyppi

Määrittää profiilitilin todennuksessa käytettävät tunnistetiedot. Vaihtoehtoja ovat:

  • Ei käytössä: Poistaa profiilitilitoiminnon käytöstä. Kun tämä toiminto ei ole käytössä, Profiilitilin määritys -valikko ei näy puhelimen näytössä.

  • HTTP-perustodennus: HTTP-kirjautumisen tunnistetietoja käytetään profiilitilin todennukseen.

  • XSI-todennus: Profiilitilin todennukseen käytetään XSI-kirjautumisen tunnistetietoja tai XSI SIP -tunnistetietoja. Todennustunnistetiedot määräytyvät puhelimen XSI-todennustyypin mukaan:

    • Kun puhelimen XSI-todennustyypiksi on määritetty Kirjautumisen tunnistetiedot, käytetään XSI-kirjautumisen tunnistetietoja.

    • Kun puhelimen XSI-todennustyypiksi on määritetty SIP-tunnistetiedot, käytetään XSI SIP -tunnistetietoja.

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

    <Profile_Authentication_Type ua="na">Basic http -todennus</Profile_Authentication_Type>

  • Valitse puhelimen Web-sivulta vaihtoehto, jolla puhelin todentaa profiilin uudelleensynkronointi.

Oletus: HTTP-perustodennus

Lisätietoja on kohdassa Profiilin todennustyypin määrittäminen profiilin uudelleensynkronoimista varten -kohdassa .

Profile Rule

Profile Rule B

Profile Rule C

Profile Rule D

Kussakin profiilisäännössä määritetään puhelimelle lähde, josta profiili on haettava (konfigurointitiedosto). Puhelin ottaa kaikki profiilin käyttöön järjestyksessä kunkin uudelleensynkronoinnin yhteydessä.

Jos käytät konfigurointitiedostoissa AES-256-CBC-salausta, määritä salausavain --key-parametrin arvoksi seuraavasti:

[--key <salausavain>]

Salausavaimen voi valinnaisesti kirjoittaa lainausmerkkeihin (").

  • Kirjoita XML puhelimen määritystiedostoon (cfg.xml) merkkijono seuraavasti:

    <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ä profiilisääntö puhelimen Web-sivulla.

Oletusarvo: /$PSN.xml

DHCP Option To Use

Määrittää pilkuin erotellut DHCP-valinnat, joita käytetään laiteohjelmiston ja profiilien noutamisessa.

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

Käytettävä DHCPv6-asetus

Määrittää pilkuin erotellut DHCP-valinnat, joita käytetään laiteohjelmiston ja profiilien noutamisessa.

Oletus: 17,160,159

Valmistelu Cisco XML

Voit valmistella puhelimia Cisco XML -toimintojen avulla.

Voit lähettää puhelimen CGI-käyttöliittymään XML objektin SIP Notify -paketilla tai HTTP-postilla: http://PhoneIPAddress/CGI/Execute.

CP-xxxx-3PCC laajentaa Cisco XML -toiminnon valmistelutuen myös XML-objektit kattavaksi:

 <CP-multiplex-3PCCExsourceute> <ExsourceuteItem URL=Resync:[profiilisääntö]/> </CP-luokan-3PCCExpccExexpccute>

Kun puhelin vastaanottaa XML-objektin, se lataa valmistelutiedoston [profile-rule]-arvon mukaisesta profiilisäännöstä. Tämä sääntö käyttää makroja XML-palvelusovelluksen käyttöönoton helpottamiseen.

URL-resoluutio ja makrolaajennus

Alikansiot helpottavat suurten laitemäärien hallintaa, kun palvelimella on säilytettävä useita profiileja. Profiilin URL-osoite voi sisältää seuraavat osat:

  • Valmistelupalvelimen nimi tai tarkka IP-osoite. Jos profiiliin on määritetty valmistelupalvelimen nimi, puhelin selvittää nimeä vastaavan osoitteen DNS-haulla.

  • Normaalista poikkeava palvelimen portti määritettynä URL-osoitteeseen muodossa :portti ennen palvelimen nimeä.

  • Palvelimen virtuaalisen päähakemiston alihakemisto, johon profiili on tallennettu. Tämä määritetään normaalilla URL-syntaksilla ja selvitetään makrolaajennuksella.

Esimerkiksi seuraavalla Profile_Rule-määrityksellä haetaan profiilitiedosto ($PN.cfg), joka sijaitsee isäntäkoneessa host prov.telco.com suoritettavan ja porttia 6900 kuuntelevan TFTP-palvelimen alihakemistossa /cisco/config: 

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

Kunkin puhelimen profiilin voi määrittää yleiskäyttöparametrin arvoksi ja tähän arvoon voidaan viitata yleisellä, makrolaajennuksen avulla luotavalla profiilisäännöllä.

Oletetaan esimerkiksi, että GPP_B-parametrin arvo on Dj6Lmp23Q.

Profile_Rule-arvo on seuraava:

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

Kun laite tekee uudelleensynkronoinnin ja makrot laajennetaan, MAC-osoitetta 000e08012345 vastaava puhelin pyytää profiilia laitteen MAC-osoitteen sisältävällä nimellä 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 valmisteluprofiilin uudelleen puhelimeen. Todennustiedot vaaditaan, kun puhelin yrittää synkronoida ja ladata määritystiedostoa ensimmäistä kertaa, ja näyttöön tulee HTTP- tai HTTPS 401 -todennusvirhe. Kun tämä toiminto on otettu käyttöön, Profiilitilin määritys -näyttö näkyy puhelimessa seuraavissa tilanteissa:

  • Kun HTTP- tai HTTPs 401 -todennusvirhe ilmenee ensimmäisen valmistelun aikana puhelimen uudelleenkäynnistyksen jälkeen

  • Kun profiilitilin käyttäjänimi ja salasana ovat tyhjiä

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

Jos Profiilitilin määritys - näyttö jää väliin tai se ohitetaan, käyttäjä voi käyttää asetusnäyttöä myös puhelimen näyttövalikon tai Asetukset-toimintonäppäimen avulla, joka näkyy vain, kun yhtään linjaa puhelimessa ei ole rekisteröity.

Kun toiminto poistetaan käytöstä, Profiilitilin määritys -näyttö ei näy puhelimessa.

Profiilisääntökentän käyttäjänimen ja salasanan tärkeys on suurempi kuin profiilitilin.

  • Kun annat oikean URL-osoitteen profiilisääntökentässä ilman käyttäjänimeä ja salasanaa, puhelin edellyttää todennusta tai koontia, jotta profiili voidaan synkronoida uudelleen. Oikealla profiilitilillä todennus menee läpi. Jos profiilitili on virheellinen, todennus epäonnistuu.

  • Kun annat profiilisääntökentässä oikean URL-osoitteen , jossa on oikea käyttäjänimi ja salasana, puhelin edellyttää todennusta tai koontia, jotta profiili voidaan synkronoida uudelleen. Profiilitiliä ei käytetä puhelimen uudelleensynkronointiin. Kirjautuminen onnistui.

  • Kun annat profiilisääntökentässä oikean URL-osoitteen , jossa on virheellinen käyttäjänimi ja salasana, puhelin edellyttää todennusta tai koontia, jotta profiili voidaan synkronoida uudelleen. Profiilitiliä ei käytetä puhelimen uudelleensynkronointiin. Sisäänkirjaus epäonnistuu aina.

  • Kun annat profiilisääntökentässä virheellisen URL-osoitteen, sisäänkirjaus epäonnistuu aina.

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

Voit määrittää profiilin todennustyypin puhelimen hallinnan Web-sivulta.

1

Siirry puhelimen hallintaverkkosivulle.

2

Valitse Puheposti > Provisioning.

3

Määritä Määritysprofiili-osassa Profiilin todennustyyppi - parametri määrittämään profiilitilin todennuksessa käytettävät tunnistetiedot.

Voit määrittää tämän parametrin puhelimen määritystiedostossa XML (cfg.xml) kirjoittamalla merkkijonon tässä muodossa:

<Profile_Authentication_Type ua="na">Disabled</Profile_Authentication_Type>

Vaihtoehtoja:

  • Ei käytössä: Poistaa profiilitilitoiminnon käytöstä. Kun tämä toiminto ei ole käytössä, Profiilitilin määritys -valikko ei näy puhelimen näytössä.

  • HTTP-perustodennus: HTTP-kirjautumisen tunnistetietoja käytetään profiilitilin todennukseen.

  • XSI-todennus: Profiilitilin todennukseen käytetään XSI-kirjautumisen tunnistetietoja tai XSI SIP -tunnistetietoja. Todennustunnistetiedot määräytyvät puhelimen XSI-todennustyypin mukaan:

    Kun puhelimen XSI-todennustyypiksi on määritetty Kirjautumisen tunnistetiedot, käytetään XSI-kirjautumisen tunnistetietoja.

    Kun puhelimen XSI-todennustyypiksi on määritetty SIP-tunnistetiedot, käytetään XSI SIP -tunnistetietoja.

Oletus: HTTP-perustodennus

4

Valitse Submit All Changes.

Profiilin käyttäminen manuaalisesti puhelimessa

Lataa määritystiedosto puhelimeen TFTP-palvelimesta

Voit ladata konfigurointitiedoston PC-tietokoneesi TFTP-palvelinsovellukseen näiden vaiheiden mukaisesti.

1

Liitä tietokone puhelimen LAN-porttiin.

2

Suorita TFTP-palvelinsovellus tietokoneella ja varmista, että määritystiedosto on saatavilla TFTP päähakemistossa.

3

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

http://<WAN-verkon_IP-osoite>/admin/resync?tftp://<PC:n_IP-osoite>/<tiedostonimi>&xuser=admin&xpassword=<salasana>

Esimerkki: 

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin

Lataa määritystiedosto puhelimeen cURL-toiminnolla

Voit ladata konfigurointitiedoston puhelimeen cURL-työkalua käyttämällä. Se on komentoriviltä käytettävä työkalu, jonka avulla voi siirtää tietoja URL-syntaksia käyttämällä. Voit ladata cURL-työkalun seuraavasta osoitteesta:

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


 

Suosittelemme, ettet lähetä määrityksiä puhelimeen cURL:n avulla, koska käyttäjänimi ja salasana saatetaan kaapata cURL:n käytön aikana.

1

Liitä tietokone puhelimen LAN-porttiin.

2

Lataa konfigurointitiedosto puhelimeen antamalla seuraava cURL-komento:

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

Määritysprofiilit

Puhelin hyväksyy kokoonpanot XML muodossa.

Tässä osassa olevissa esimerkeissä käytetään määritysprofiileja, joissa on XML syntaksi.

Määritysprofiilin muodot

Konfiguraatioprofiili määrittää puhelimen parametriarvot.

Konfiguraatioprofiilin XML-muodossa käytetään XML-perusluontityökaluja parametrien ja arvojen kokoamiseen.


 
Vain UTF-8-merkistö on tuettu. Jos muokkaat profiilia editorissa, älä muuta koodausmuotoa. Muutoin puhelin ei tunnista tiedostoa.

Kussakin puhelimessa on erilaiset toiminnot ja tämän vuoksi myös erilaiset parametrit.

Avaa profiilin muoto

Avoimen muodon profiili on tekstitiedosto, jonka elementtihierarkian syntaksi on XML:n kaltainen ja jossa käytetään määritteitä ja arvoja. Tämän muodon ansiosta voit käyttää konfigurointitiedoston luomiseen perustyökaluja. XML -määritystiedoston voi lähettää provisiointipalvelimesta puhelimeen uudelleensynkronointitoiminnon aikana ilman kokoamista binääriobjektina.

Puhelin hyväksyy perustyökaluilla luotavissa olevat konfigurointimuodot. Tämä ominaisuus helpottaa sellaisten taustaverkon valmistelupalvelinohjelmistojen kehittämistä, jotka luovat konfigurointiprofiileja olemassa olevista tietokannoista.

Jotta määritysprofiilin luottamukselliset tiedot voidaan suojella, valmistelupalvelin toimittaa XML -määritystiedoston puhelimeen TLS suojaamalla kanavalla. Vaihtoehtoisesti tiedoston voi pakata gzip-algoritmilla (RFC1951).

Tiedosto voi olla salattu seuraavilla salausmenenetelmillä:

  • AES-256-CBC-salaus

  • RFC-8188-pohjainen HTTP-sisällön salaus AES-128-GCM-salausavaimella

Konfigurointitiedostossa voi olla seuraavia osia:

  • Elementtitunnisteet

  • Määritteet

  • Parametrit

  • Muotoiluominaisuudet

  • XML-kommentit

Esimerkki: Avaa profiilin muoto

 <flat-profiili> <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> </flat-profile>

< flat-profiilin> elementtitunniste sisältää kaikki parametrit, jotka puhelin tunnistaa.

Elementtitunnisteen ominaisuudet

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

  • Voit määrittää XML-valmistelumuodon ja verkkokäyttöliittymän avulla samoja asetuksia. XML-tunnisteen nimet ja Web-käyttöliittymän kenttien nimet ovat samankaltaisia, mutta vaihtelevat XML elementin nimirajoitusten vuoksi. Esimerkiksi web-käyttöliittymän välilyöntejä XML määritystiedoston alaviivoja ( _ ).

  • Puhelin tunnistaa osat, joilla on oikeat parametrien nimet ja jotka on kapseloitu erikoisprofiiliin <flat-profiiliin> elementkiin.

  • Elementtien nimet on kirjoitettava kulmasulkeisiin.

  • Useimmat elementtien nimet ovat samankaltaisia puhelimen Web-käyttöliittymän kenttien nimien kanssa.

    • Elementtien nimissä ei saa olla välilyöntejä tai erikoismerkkejä. Jos haluat johtaa elementin nimen Web-kentän nimestä, korvaa jokaisen tilan tai erikoismerkkien alaviiva[, ], (, )tai /.

      Esimerkki: <Resync_On_Reset>-elementti vastaa kenttää Resync On Reset (Uudelleensynkronointi nollattaessa).

    • Kunkin elementin nimen on oltava yksilöllinen. Puhelimen Web-käyttöliittymässä samat kentät voivat näkyä usealla Web-sivulla, esimerkiksi linja-, käyttäjä- ja alanumerosivuilla. Elementti kohdistetaan tiettyyn sivuun liittämällä elementin nimeen [n], jossa n on sivun välilehdessä näkyvä numero.

      Esimerkki: <Dial_Plan_1_> elementi edustaa linjan 1 soittosuunnitelmaa .

  • Kullakin avaavalla elementtitunnisteella on oltava vastaava sulkeva elementtitunniste. Esimerkki:

     <flat-profiili> <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> </flat-profile>

  • Kirjainkoko on merkitsevä elementtitunnisteissa.

  • Elementtitunnisteet voivat olla tyhjiä. Ne tulkitaan arvon määrittämiseksi tyhjäksi. Kirjoita avaava elementtitunniste ilman elementtitunnistearvoa ja lisää välilyönti ja vinoviiva (/) sulkevan kulmasulkeen (>) edelle. Seuraavassa esimerkissä profiilisääntö B (Profile Rule B) on tyhjä:

     <Profile_Rule_B/>

  • Tyhjän elementtitunnisteen avulla voidaan estää käyttäjän määrittämien arvojen korvaaminen uudelleensynkronoinnissa. Seuraavassa esimerkissä käyttäjän pikavalinta-asetukset pysyvät muuttumattomina:

    <flat-profiili> <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"/> </tasainen profiili>

  • Tyhjän arvon avulla voit määrittää vastaavan parametrin arvoksi tyhjän merkkijonon. Kirjoita avaava ja sulkeva elementti ilman niiden välistä arvoa. Seuraavassa esimerkissä GPP_A-parametrin arvoksi määritetään tyhjä merkkijono.

     <profiili> <GPP_A> </GPP_A> </tasainen profiili>

  • Tunnistamattomat elementtien nimet ohitetaan.

Parametrin ominaisuudet

Parametreihin liittyy seuraavia sääntöjä:

  • Parametrit, joita ei ole määritetty profiiliin, jätetään ennalleen puhelimessa.

  • Tunnistamattomat parametrit ohitetaan.

  • Jos avoimen muodon profiilissa on useita identtisiä parametritunnisteita, viimeinen tunniste on ensisijainen sitä edeltäviin verrattuna. Jotta parametrin konfigurointiarvot eivät korvautuisi tahattomasti, suosittelemme käyttämään kussakin profiilissa vain yhtä parametrin ilmentymää.

  • Viimeksi käsitelty profiili on ensisijainen. Jos sama määrittelyparametri on määritetty useaan profiilin, viimeisen käsiteltävän profiilin arvo on ensisijainen.

Merkkijonomuodot

Merkkijonojen muotoiluun liittyy seuraavia sääntöjä:

  • Kommentteja voi käyttää normaalin XML-syntaksin mukaisesti.

    <!-- Kommentointi on kirjoitettu tähän -->

  • Luettavuutta voi parantaa käyttämällä tyhjämerkkejä (välilyöntejä) voi käyttää ennen merkkijonoa ja sen jälkeen, mutta ne poistetaan parametrin arvosta.

  • Arvon rivinvaihdot muunnetaan tyhjämerkeiksi.

  • Lomake XML-otsikko<? ?> on sallittu, mutta puhelin ohittaa sen.

  • Erikoismerkit voi syöttää käyttämällä normaaleja XML-koodinvaihtomerkkejä seuraavan taulukon mukaisesti.

    Erikoismerkki

    XML-koodinvaihto

    & (et-merkki)

    & Ei vielä

    < (pienempi kuin)

    <

    > (suurempi kuin)

    >

    ’ (heittomerkki)

    '

    ” (lainausmerkki)

    "

    Seuraavassa esimerkissä käytetään koodinvaihtomerkkejä numerointisuunnitelmasäännössä tarvittavien suurempi kuin- ja pienempi kuin -merkkien tilalla. Tämä esimerkki määrittää kuuman linjan tietovalintasuunnitelman, joka määrittää <Dial_Plan_1_>-parametrin (Admin Login > advanced > Voice > Ext (n)) vastaa (S0 <:18005551212>).

     <flat-profiili> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </tasaisen profiilin>

  • Numeerinen merkki pakenee käyttäen desimaali- ja heksadesimaaliarvoja (s.a. &#40; ja &#x2e;) on käännetty.

  • Puhelimen laiteohjelmisto tukee vain ASCII-merkkejä.

Avaa profiilin (XML) pakkaus ja salaus

Avoimen konfigurointiprofiilin voi pakata. Pakkaus pienentää valmistelupalvelimen verkkokuormitusta. Profiilin voi myös salata, jos sen sisältämät luottamukselliset tiedot halutaan suojata. Pakkaus ei ole pakollista, mutta jos sitä käytetään, se on tehtävä ennen salaamista.

Avaa profiilin pakkaus

Tuettu pakkaustapa on gzip-algoritmi (RFC1951). gzip-apuohjelma ja samaa algoritmia käyttävä pakkauskirjasto (zlib) ovat saatavilla Internet-sivustoista.

Puhelin tunnistaa pakkauksen siitä, että pakatussa tiedostossa on gzip-yhteensopiva ylätunniste. Ylätunniste luodaan, kun gzip-apuohjelmaa kutsutaan alkuperäisessä avoimessa profiilissa. Puhelin tarkastaa ladatun tiedostoylätunnisteen ja määrittää tiedostomuodon sen perusteella.

Jos esimerkiksi profile.xml on kelvollinen profiili, myös tiedosto profile.xml.gz hyväksytään. Tämän profiilityypin voi luoda seuraavilla komennoilla:

  • >gzip profile.xml

    Korvaa alkuperäisen tiedoston pakatulla tiedostolla.

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

    Jättää alkuperäisen tiedoston paikoilleen ja tuottaa uuden pakkaustiedoston.

Avaa profiilin salaus

Symmetristä avainsalausta voidaan käyttää avoimen konfigurointiprofiilin salaamiseen riippumatta siitä, onko tiedosto pakattu. Jos pakkausta käytetään, pakkaus on tehtävä ennen salausta.

Valmistelupalvelin käyttää HTTPS:ää puhelimen alkuvalmisteluun käyttöönoton jälkeen. Ennen määritysprofiilien salausta offline-tilassa voit käyttää HTTP-protokollaa profiilien synkronoinnissa uudelleen. Tämä ominaisuus vähentää HTTPS-palvelimen kuormitusta suurimittaisissa käyttöönotoissa.

Puhelin tukee konfigurointitiedostojen salausta kahdella eri salausmenetelmällä:

  • AES-256-CBC-salaus

  • RFC-8188-pohjainen HTTP-sisällön salaus AES-128-GCM-salausavaimella

Avain tai IKM-arvo (Input Keying Material) on esivalmisteltava yksikköön ennakkoon. Salaisen avaimen bootstrap saadaan suojatusti HTTPS:n avulla.

Määritystiedoston nimi ei vaadi tiettyä muotoa, mutta tiedostonimi, joka päättyy.cfg-alanumeroon , ilmaisee tavallisesti määritysprofiilin.

AES-256-CBC-salaus

Puhelin tukee konfigurointitiedostojen AES-256-CBC-salausta.

Salauksen voi tehdä OpenSSL-salaustyökalulla, joka on ladattavissa erinäisistä Internet-sivustoista. 256-bittisen AES-salauksen tuki saattaa edellyttää työkalun uudelleenkokoamista, jotta AES-koodi voidaan ottaa käyttöön. Laitteisto-ohjelmistoa on testattu versiota vastaan opensl-1.1.1d.

Profiili odottaa, että salatun tiedoston muoto on sama kuin seuraavalla komennolla luotu muoto:

 # esimerkin salausavain = SecretPhrase1234 avaa enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –Out profile.cfg # analoginen kutsumus pakattuun xml-tiedostoon avaa enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg

Pienellä kirjoitettu -k asetetaan salaisen avaimen eteen. Avain voi olla mikä tahansa tavallinen tekstilauseke, jota käytetään satunnaisen 64-bittisen salt-arvon luomiseen. Kun salainen avain on määritetty -k-argumentilla, salaustyökalu johtaa avaimesta satunnaisen 128-bittisen alkuvektorin ja todellisen 256-bittisen salausavaimen.

Kun tätä salausmuotoa käytetään konfigurointiprofiilissa, puhelimelle on ilmoitettava salaisen avaimen arvo, jotta tiedoston salauksen voi purkaa. Tämä arvo on määritetty URL-profiiliosoitteen tarkenteeksi. Tarkkaa URL-osoitetta käytettäessä syntaksi on seuraava:

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

Arvo on ohjelmoitu käyttämällä jotakin Profile_Rule parametria.

Makrolaajennus

Monet valmisteluparametrit käsitellään sisäisellä makrolaajennuksella ennen niiden arviointia. Tämä esiarviointivaihe parantaa puhelimen uudelleensynkronointi- ja päivitystoimien hallinnan joustavuutta.

Seuraavat parametrit käsitellään makrolaajennuksella ennen niiden arviointia:

  • Resync_Trigger_*

  • Profile_Rule*

  • Log_xxx_Msg

  • Upgrade_Rule

Joissakin yleisluonteisissa parametreissa (GPP_*) käytetään myös makrolaajennusta, kuten jäljempänä olevassa Valinnaiset uudelleensynkronointi -argumentit -osassa todetaan.

Makrolaajennuksen aikana nimettyjen muuttujien sisältö korvataan lausekkeille, joiden muoto on $NIMI ja $(NIMI). Tällaisia muuttujia ovat yleiskäyttöparametrit, useat tuotetunnisteet, tietyt tapahtuma-ajastimet ja valmistelutilojen arvot. Kattava luettelo on kohdassa Makrolaajennusmuuttujat Valmistelu-parametreissa.

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

Järjestelmänvalvoja syöttää lausekkeen $(MAU)config.cfg

MAC-osoitetta 000E08012345 vastaavan laitteen makrolaajennuksella käsitelty lauseke on 000E08012345config.cfg

Jos makron nimeä ei tunnisteta, sitä ei laajenneta. Esimerkiksi nimi STRANGE ei ole kelvollinen makron nimi, mutta on MAU on.

Järjestelmänvalvoja syöttää lausekkeen $STRANGE$MAU.cfg

MAC-osoitetta 000E08012345 vastaavan laitteen makrolaajennuksella käsitelty lauseke on $STRANGE000E08012345.cfg

Makrolaajennus ei toimi sisäkkäisesti. Esimerkiksi $$MAU” laajennetaan muotoon $MAU” (laajennus tehdään merkkiyhdistelmälle $$), joten tuloksena ei ole MAC-osoite.

Tietyille erikoisparametreille välillä GPP_SA–GPP_SD on määritetty vastaavat makrolausekkeet $SA–$SD. Nämä parametrit makrolaajennetaan vain, jos ne ovat uudelleensynkronoinnin URL-osoitteen valintojen --key , --uid ja --pwd argumentteina.

Ehdollisten ilmaisujen lausekkeet

Ehdollisilla lausekkeilla voi käynnistää uudelleensynkronointitapahtumia ja valita vaihtoehtoisia URL-osoitteita uudelleensynkronointi- ja päivitystoimintoja.

Ehdolliset lausekkeet sisältävät vertailuarvoluettelon, jossa arvot on erotettu and-operaattorilla. Kaikkien vertailuehtojen on täytyttävä, jotta lauseke arvioidaan todeksi.

Kussakin vertailussa voi käyttää yhtä seuraavista kolmesta literaalityypistä:

  • Kokonaislukuarvot

  • Ohjelmiston tai laitteiston versionumerot

  • Lainausmerkkeihin kirjoitetut merkkijonot

Versionumerot

Cisco Video Phone 8875 -ohjelmistoversio käyttää tätä muotoa (jossa BN on koontinumero):

PHONEOSyyyy.1-0-1-0001-BN

missä yyyy osoittaa puhelinmallia tai puhelinsarjaa; 1 on pääversio; 0 on aliversio; 1-0001 on mikroversio ja BN on koontinumero.

Vertailumerkkijonon muodon on oltava sama. Muutoin tuloksena on muotoilun jäsennysvirhe.

Ohjelmistoversiota verrattaessa pääversiota, aliversiota ja mikroversiota verrataan järjestyksessä, ja vasemmat numerot menevät jälkimmäisen edelle. Kun versionumerot ovat samat, koontinumeroa verrataan.

Kelvollisen versionumeron esimerkkejä

PHONEOS-8875.1-0-1-0001-19

Vertailu

Lainausmerkkeihin kirjoitettujen merkkijonojen vertailussa voidaan verrata niiden vastaavuutta tai vastaamattomuutta. Kokonaislukuja ja versionumeroita voi verrata myös aritmeettisesti. Vertailuoperaattorit voi määrittää joko symboleina tai lyhenteinä. Lyhenteet ovat kätevä tapa ehdon ilmaisemiseen avoimen muodon profiilissa.

Operaattori

Vaihtoehtoinen syntaksi

Kuvaus

Tukee operandeina kokonaislukuja ja versionumeroita

Tukee operandeina lainausmerkkeihin kirjoitettuja merkkijonoja

=

eq

yhtä suuri kuin

Kyllä

Kyllä

!=

ne

eri suuri kuin

Kyllä

Kyllä

<

lt

pienempi kuin

Kyllä

Ei

<=

le

yhtä suuri tai pienempi kuin

Kyllä

Ei

>

gt

suurempi kuin

Kyllä

Ei

>=

ge

yhtä suuri tai suurempi kuin

Kyllä

Ei

JA

ja

Kyllä

Kyllä

On tärkeää, että makron muuttujat kirjoitetaan lainausmerkkeihin, kun odotettu arvo on merkkijonoliteraali. Älä tee sitä, jos odotat numeroa tai versionumeroa.

Profile_Rule*- ja Upgrade_Rule-parametreissa ehdolliset lausekkeet on rajattava “(lauseke)?”-syntaksiin seuraavan päivityssääntöesimerkin mukaisesti. Muista korvata luettelonumero laitteisto-ohjelmistolatauksen koontinumerolla, jotta voit päivittää siihen.

($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ä edellä kuvattua sulkeellista syntaksia Resync_Trigger_*-parametrien määrittämiseen.

URL-syntaksi

Käytä URL-osoitteiden perussyntaksia konfigurointitiedostojen noutojen määrittämiseen Profile_Rule*-parametriin ja laiteohjelmistolatausten määrittämiseen Upgrade_Rule-parametriin. Syntaksi on seuraava:

[ protokolla:// ] [ palvelin [:portti]] tiedostopolku

Protokolla on jokin seuraavista arvoista:

  • tftp

  • http

  • https

Jos protokolla jätetään määrittämättä, oletusarvo on "tftp". Palvelin-arvo voi olla DNS:n tunnistama isäntänimi tai numeromuotoinen IP-osoite. Portti on UDP- tai TCP-kohdeportin numero. Tiedostopolku on määritettävä absoluuttisena päähakemistosta (/) alkaen.

Jos palvelin jätetään määrittämättä, oletusarvo on tftp-palvelin ja DHCP (valinta 66).


 

Päivityssääntöihin on määritettävä palvelin.

Jos portti jätetään määrittämättä, oletusarvo on protokollan vakioportti. TFTP-protokolla käyttää UDP-porttia 69, HTTP TCP-porttia 80 ja HTTPS TCP-porttia 443.

Tiedostopolku on pakollinen. Sen ei tarvitse viitata staattiseen tiedostoon vaan tiedosto voidaan määrittää dynaamisesti CGI-komentosarjan avulla.

URL-osoitteissa käytetään makrolaajennusta. 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-valintaa 66 käytettäessä päivityssäännöt eivät tue tyhjää syntaksia. Sitä voi käyttää vain Profile Rule*-parametrissa.

RFC 8188-pohjainen HTTP-sisällön salaus

Puhelin tukee konfigurointitiedostojen RFC 8188 -pohjaista HTTP-sisällön salausta AES-128-GCM -salausavaimella. Tätä salausmenetelmää käytettäessä HTTP-viestiotsikot ovat vapaasti luettavissa. Sisällön voi kuitenkin lukea vain, jos tietää IKM-arvon. Jos IKM-arvo on valmisteltu puhelimeen, puhelin ja valmistelupalvelin voivat siirtää konfigurointitiedostot välillään turvallisesti samalla, kun viestien ylätunnisteita voidaan hyödyntää analysoinnissa ja valvonnassa kolmansien osapuolten verkkoelementeillä.

IKM-arvo tallennetaan puhelimeen XML-konfigurointiparametrilla IKM_HTTP_Encrypt_Content. Tietoturvasyistä tämä parametri ei ole käytettävissä puhelimen verkkohallintasivulla. Lisäksi se ei näy puhelimen konfigurointitiedostossa, jota käytetään puhelimen IP-osoitteen tai valmistelupalvelimeen lähetettyjen puhelimen konfigurointiraporttien kautta.

Jos halaut käyttää RFC 8188 -pohjaista salausta, varmista seuraavat seikat:

  • Valmistele IKM-arvo puhelimeen määrittämällä se XML-parametrin IKM_HTTP_Encrypt_Content arvoksi konfigurointitiedostoon, jonka valmistelupalvelimen lähettää puhelimeen.

  • Jos tätä salausta käytetään määritystiedostoille, jotka lähetetään provisiointipalvelimesta puhelimeen, varmista, että määritystiedoston sisällönkoodaus-HTTP-otsikko on aes128gcm.

    Mikäli tätä ylätunnistearvoa ei ole määritetty, järjestelmä käyttää AES-256-CBC-salausmenetelmää. Jos profiilisäännössä on AES-256-CBC-avain, puhelin käyttää AES-256-CBC-salausta IKM-arvosta riippumatta.

  • Jos haluat puhelimen käyttävän tätä salausta valmistelupalvelimeen lähetettävissä konfiugrointiraporteissa, varmista, ettei raporttisääntöön ole määritetty AES-256-CBC-avainta.

Valinnaiset uudelleensynkronointiargumentit

Valinnaiset argumentit,avain, uid japwd voivat olla ennen Profile_Rule*-parametreihin syötettyjä URL-osoitteita, jotka on suljettu sulkeilla.

key

- avain-asetus kertoo puhelimelle, että sen provisiointipalvelimelta vastaanottama määritystiedosto on salattu AES-256-CBC-salauksella, ellei tiedoston sisällönkoodausotsikko osoita aes128gcm Salaus. Varsinainen avain määritetään --key-parametrivalintaa seuraavassa merkkijonossa. Avaimen voi valinnaisesti kirjoittaa lainausmerkkeihin ("). Puhelin purkaa konfigurointitiedoston avainarvoa käyttämällä.

Käyttöesimerkit
 [-avain VerySecretValue] [-avain "minun salainen lauseeni"] [-avain a37d2fb9055c1d04883a0745eb0917a4]

Kulmasulkeissa olevat valinnaiset argumentit makrolaajennetaan. Erikoisparametrit välillä GPP_SA–GPP_SD makrolaajennetaan makromuuttujiksi $SA–$SD vain, jos niitä käytetään key-valinnan argumentteina. Katso seuraavat esimerkit:

[-avain $SC] [-avain "$SD"]

Avoimessa muotoprofiileissa avaimen argumentin pitää olla sama kuin opensl-asetukselle annetun k-vaihtoehdon argumentti.

uid ja pwd

Uid - ja pwd-asetuksilla voidaan määrittää käyttäjätunnus ja salasana, jotka lähetetään HTTP Basic- ja Koonti-todennus haasteiden seurauksena, kun määritettyä URL-osoitetta pyydetään. Kulmasulkeissa olevat valinnaiset argumentit makrolaajennetaan. Erikoisparametrit välillä GPP_SA–GPP_SD makrolaajennetaan makromuuttujiksi $SA–$SD vain, jos niitä käytetään key-valinnan argumentteina. Katso seuraavat esimerkit:

GPP_SA = MyUserID-GPP_SB = MySecretPassword

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

laajentuisi muotoon

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

Tietotyypit

Konfigurointiprofiilin parametreissa käytetään seuraavia datatyyppejä:

  • {a,b,c,…} – Vaihtoehto a, b, c jne.

  • Bool – Totuusarvo yes (kyllä) tai no (ei).

  • CadScript – Minikomentosarja, 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/offi,4[,oni,5/offi,5[,oni,6/offi,6]]]]]) ja jota kutsutaan osaksi.

    • oni,j ja offi,j ovat on/off-kestot sekunteina segmentille. i = 1 tai 2 ja j = 1–6.

    • Di on osan kokonaiskesto sekunteina.

    Kaikki kestot voi määrittää enintään kolmen desimaalin eli 1 ms:n tarkkuudella. Yleismerkki "*" tarkoittaa ikuista kestoa. Osan segmentit käsitellään järjestyksessä ja niitä toistetaan, kunnes kokonaiskesto on käyty läpi.

    Esimerkki 1:

     60(2/4) Poljinnopeusjaksojen määrä = 1 Poljinnopeusjakso 1: Jakson pituus = 60 s Segmenttien määrä = 1 Segmentti 1: On=2s, Off=4s Soittoäänen kokonaispituus = 60s

    Esimerkki 2 – Erottuva soittoääni (lyhyt, lyhyt, lyhyt, pitkä):

     60(.2/.2,.2/.2,2,2,1/4) Poljinnopeusjaksojen määrä = 1 Kadeisuusjakso 1: Jakson pituus = 60-luvun segmenttien mää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 Soittoäänen kokonaispituus = 60s

  • DialPlanScript – Komentosarjasyntaksi, jota käytetään linjojen 1 ja 2 numerointisuunnitelman määrittämiseen.

  • Float<n> – Liukulukuarvo enintään n desimaalin tarkkuudella.

  • FQDN – täydellinen toimialueen nimi. Se voi sisältää enintään 63 merkkiä. Esimerkkejä:

    • sip.Cisco.com:5060 tai 109.12.14.12:12345

    • sip.Cisco.com tai 109.12.14.12

  • FreqScript – Minikomentosarja, joka määrittää soittoäänen taajuus- ja äänentasoparametrit. Enintään 127 merkkiä.

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

    • F1–F6 ovat taajuusarvot hertseinä (vain etumerkittömiä kokonaislukuja).

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

    Ennen pilkkua ja sen jälkeen voi olla tyhjämerkit, mutta niiden käyttöä ei suositella.

    Esimerkki 1 – odottavan puhelun merkkiääni:

     440@-10 Taajuudet = 1 taajuus 1 = 440 Hz taajuudessa –10 dBm

    Esimerkki 2 – soittoääni:

     350@-19,440@-19 Taajuudet = 2 Taajuus 1 = 350 Hz –19 dBm Taajuus 2 = 440 Hz klo -19 dBm

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

  • UserID – Käyttäjätunnus URL-osoitteen mukaisessa muodossa. Enimmäispituus 63 merkkiä.

  • Phone – Puhelinnumero merkkijonona. Esimerkiksi 14081234567, *69, *72, 345678 tai geneerinen URL-osoite kuten 1234@10.10.10.100:5068 tai jsmith@Cisco.com. Merkkijonon enimmäispituus on 39 merkkiä.

  • PhTmplt – Puhelinnumeromalli. Kukin malli voi sisältää yhden tai useamman mallin pilkulla (,) eroteltuina. Kunkin mallin alussa olevat tyhjämerkit jätetään huomiotta. "?" ja "*" ovat yleismerkkejä. Jos haluat määrittää ne tavallisina merkkeinä, käytä muotoa %xx. Esimerkki %2a on *. Mallin enimmäispituus on 39 merkkiä. Esimerkkejä: "1408*, 1510*", "1408123????, 555?1".

  • Port – TCP-/UDP-portin numero (0–65535). Arvon voi määrittää desimaali- tai heksadesimaalimuodossa.

  • ProvisioningRuleSyntax – Komentosarjasyntaksi, jota käytetään kokoonpanon uudelleensynkronoinnin ja laiteohjelmistopäivityksen sääntöjen määrittämiseen.

  • PwrLevel – Äänenvoima dBm-yksiköinä yhden desimaalin tarkkuudella, esimerkiksi –13.5 tai 1.5 (dBm).

  • RscTmplt – SIP-vastaustilakoodin malli, kuten "404, 5*", "61?", "407, 408, 487, 481". Enimmäispituus on 39 merkkiä.

  • Sig<n> – Allekirjoitettu n-bittinen arvo. Arvon voi määrittää desimaali- tai heksadesimaalimuodossa. Negatiivisten arvojen eteen on lisättävä "-". Positiivisten arvojen etumerkki "+" on valinnainen.

  • Tähtikoodit – Lisäpalvelun aktivointikoodi, kuten *69. Koodin enimmäispituus on 7 merkkiä.

  • Str<n> – Yleinen, enintään n:n ei-varatun merkin pituinen merkkijono.

  • Time<n> – Aikamääre sekunteina enintään n desimaalin tarkkuudella. Rajoituksen ylittävät desimaalit jätetään huomiotta.

  • ToneScript – Minikomentosarja, joka määrittää käynnissä olevan puhelun merkkiäänen taajuuden, äänentason ja kadenssin. Komentosarjan enimmäispituus on 127 merkkiä.

    Syntaksi: FreqScript;Z1[;Z2].

    Osa Z1 on vastaava kuin CadScipt-datatyypin S1-osa sillä poikkeuksella, että kunkin on/off-segmentin perässä on taajuuskomponentit määrittävä parametri: 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 [,oni,6/offi,6/fi,6]]]]]), jossa:

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

    • 1 < nk < 6 määrittää FreqScript-datatyypin kyseisessä segmentissä käytetyt taajuuskomponentit.

    Jos segmentissä on useampi kuin yksi taajuuskomponentti, komponentit lasketaan yhteen.

    Esimerkki 1 – soittoääni:

     350@-19,440@-19; 10(*/0/1+2) Taajuuksien määrä = 2 Taajuus 1 = 350 Hz –19 dBm Taajuudella 2 = 440 Hz taajuudella –19 dBm kadehtivuusosien määrä = 1 Kadehtivuusjakso 1: Jakson pituus = 10 s Segmenttien määrä = 1 Segmentti 1: On=forever, Taajuudet 1 ja 2 Äänen kokonaispituus = 10s

    Esimerkki 2 – merkkiääni:

     350@-19,440@-19; 2(.1/.1/1+2); 10(*/0/1+2) Taajuuksien määrä = 2 Taajuus 1 = 350 Hz at –19 dBm Taajuus 2 = 440 Hz taajuudella –19 dBm Kadehtivuusosien määrä = 2 Poljinnopeusjakso 1: Jakson pituus = 2s Segmenttien määrä = 1 Segmentti 1: On=0.1s, Off=0.1s ja Taajuudet 1 ja 2 Poljinnopeus 2: Jakson pituus = 10s Segmenttien määrä = 1 Segmentti 1: On=forever, Taajuudet 1 ja 2 Äänen kokonaispituus = 12s

  • Ei<n> – allekirjoittamaton n-bitin arvo, jossa n = 8, 16 tai 32. Se voidaan määrittää desimaali- tai heksamuodossa, kuten 12 tai 0x18, kunhan arvo mahtuu n bittiin.


 

Huomioi seuraavat:

  • <Par Name> edustaa määritysparametrin nimeä. Profiilissa vastaava tunniste muodostuu korvaamalla välilyönti alaviivalla "_", kuten Par_Name.
  • Tyhjä oletusarvokenttä tarkoittaa tyhjää merkkijonoa < “” >.
  • Puhelin jatkaa viimeksi määritettyjen arvojen käyttöä niissä tunnisteissa, joita ei ole määritetty profiiliin.
  • Malleja verrataan niiden määritysjärjestyksessä. Ensimmäinen, ei lähin, vastine valitaan. Parametrin nimen on täsmättävä tarkalleen.
  • Jos profiiliin on määritetty useampi määritelmä, puhelimessa käytetään tiedoston viimeistä tällaista määritelmää.
  • Tyhjän parametriarvon sisältävä parametrimääritys pakottaa parametrin käyttämään oletusarvoa. Käytä tällaisen määrityksen sijasta tyhjää merkkijonoa ("") parametriarvona.