Tässä artikkelissa
dropdown icon
Määritä puhelimesi profiilin uudelleensynkronointia varten
    Synkronoi puhelinprofiili uudelleen TFTP: n kautta
    Puhelinkohtaisen profiilin luominen TFTP-palvelimella
    Synkronoi puhelinprofiili uudelleen HTTP GET: n kanssa
    Synkronoi puhelinprofiili uudelleen automaattisesti
    Profiilin uudelleensynkronointiparametrit
    Provisiointi Cisco XML: n kautta
    URL-tarkkuus makrolaajennuksella
    Määritä profiilin todennustyyppi
dropdown icon
Profiilin käyttäminen puhelimeen manuaalisesti
    Lataa määritystiedosto puhelimeen TFTP-palvelimelta
    Lataa määritystiedosto puhelimeen cURL-ohjelmalla
dropdown icon
Viitteet profiilin määritykseen
    Kokoonpanoprofiilin muodot
    Avaa profiilin pakkaus
    Avaa profiilin salaus
    Valinnaiset uudelleensynkronointiargumentit
    Tietotyypit

Määritä profiiliasetukset 9800-sarjan ja 8875-puhelimille (BroadWorks)

list-menuTässä artikkelissa
list-menuOnko sinulla palautetta?

Tämä ohjeartikkeli koskee Cisco BroadWorksiin rekisteröityjä Cisco Desk Phone 9800 -sarjaa ja Cisco Video Phone 8875 -puhelinta. Tämän sivun tiedot sisältävät profiilin uudelleensynkronoinnin, profiilin manuaalisen käytön ja määrityssyntaksin.

Määritä puhelimesi profiilin uudelleensynkronointia varten

Synkronoi puhelinprofiili uudelleen TFTP: n kautta

Puhelin tukee useita verkkoprotokollia kokoonpanoprofiilien hakemiseksi. Perusprofiilin siirtoprotokolla on TFTP (RFC1350). TFTP: tä käytetään laajalti verkkolaitteiden tarjoamiseen yksityisissä LAN-verkoissa. Vaikka TFTP:tä ei suositella etäpäätepisteiden käyttöönottoon Internetissä, se voi olla kätevä käyttöönottoon pienissä organisaatioissa, sisäiseen esivalmisteluun sekä kehittämiseen ja testaukseen. Seuraavassa menettelyssä profiilia muokataan sen jälkeen, kun tiedosto on ladattu TFTP-palvelimelta.

1

Yhdistä LAN-ympäristössä tietokone ja puhelin keskittimeen, kytkimeen tai pieneen reitittimeen.

2

Asenna ja aktivoi TFTP-palvelin tietokoneessa.

3

Luo määritysprofiili tekstieditorilla.

Voit tarkistaa, onko profiili lisätty puhelimeesi myöhemmin, asettamalla jotkin arvot merkkeiksi. Aseta GPP_A: n arvoksi esimerkiksi 12345678 seuraavan esimerkin mukaisesti:

<flat-profile>
  <GPP_A> 12345678
  </GPP_A>
</flat-profile>
4

Tallenna XML-määritystiedosto TFTP-palvelimen juurihakemistoon.

Voit tarkistaa, että TFTP-palvelin on määritetty oikein: pyydä määritysprofiilitiedostoa käyttämällä muuta TFTP-asiakasohjelmaa kuin puhelinta. Käytä mieluiten TFTP-asiakasohjelmaa, joka on käynnissä erillisessä isännässä kuin provisiointipalvelimesta.

5

Avaa tietokoneen verkkoselaimessa hallinnan verkkosivu. Oletetaan esimerkiksi, että puhelimen IP-osoite on 192.168.1.100, avaa seuraava URL-osoite selaimessasi:


http://192.168.1.100/admin/advanced

6

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

7

Synkronoi testipuhelin uudelleen luomaasi määritysprofiiliin avaamalla uudelleensynkronoinnin URL-osoite verkkoselaimessa.

Esimerkki:

Jos TFTP-palvelimen IP-osoite on 192.168.1.200, komennon tulisi olla samanlainen kuin seuraava esimerkki:


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ää määritysprofiilitiedostoa basic.txt TFTP-palvelimelta IP-osoitteessa 192.168.1.200. Puhelin jäsentää sitten ladatun tiedoston ja päivittää GPP_A-parametrin arvolla 12345678.

8

Varmista, että parametri on päivitetty oikein. Päivitä hallinnan verkkosivu ja siirry kohtaan Ääni > Provisioning.

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

Puhelinkohtaisen profiilin luominen TFTP-palvelimella

1

Hanki puhelimen MAC-osoite tuotteen etiketistä. (MAC-osoite on numero, jossa käytetään numeroita ja pieniä heksadesimerkkejä, esimerkiksi 000e08aabbcc.

2

Nimeä määritystiedosto uudelleen muotoon CP-xxxx macaddress.cfg (korva amalla xxxx mallinumerolla ja macaddress puhelimen MAC -osoitteella).

Esimerkki:

CP-8875 000e08aabbcc.cfg

3

Siirrä uusi tiedosto TFTP-palvelimen virtuaaliseen juurihakemistoon.

4

Siirry puhelimen hallinnan verkkosivulle.

5

Valitse Ä äni > Provisioning.

6

Kirjoita profiilitiedoston polku Profiilisään tö-kent tään.

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


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

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

Kun seuraava uudelleensynkronointi tapahtuu, puhelin hakee uuden tiedoston laajentamalla $MA-makrolausekkeen MAC-osoitteeseensa.

Synkronoi puhelinprofiili uudelleen HTTP GET: n kanssa

1

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

Avoimen lähdekoodin Apache-palvelin voidaan ladata Internetistä.

2

Lataa määritysprofiilitiedosto asennetun palvelimen virtuaaliseen juurihakemistoon.

3

Voit tarkistaa palvelimen asianmukaisen asennuksen ja profiilitiedoston käytön avaamalla profiili verkkoselaimella.

4

Muokkaa testipuhelimen Profile_Rule osoittamaan HTTP-palvelimeen TFTP-palvelimen sijasta, jotta sen profiili ladataan säännöllisesti.

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

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

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

6

Tarkkaile puhelimen lähettämät syslog-viestit. Jaksollisten uudelleensynkronointien pitäisi nyt hankkia profiili HTTP-palvelimelta.

7

Tarkkaile HTTP-palvelinlokeissa, miten testipuhelimen tunnistavat tiedot näkyvät käyttäjäagenttien lokiin.

Näihin tietoihin tulee sisältyä valmistaja, tuotteen nimi, nykyinen laiteohjelmistoversio ja sarjanumero.

Synkronoi puhelinprofiili automaattisesti uudelleen

Laite voi synkronoida säännöllisesti uudelleen varmennuspalvelimeen varmistaakseen, että palvelimessa tehdyt profiilimuutokset leviävät päätepistelaitteeseen (sen sijaan, että päätelaitteeseen lähetettäisiin nimenomainen uudelleensynkronointipyyntö).

Jotta puhelin synkronoituu ajoittain uudelleen palvelimeen, määritysprofiilin URL-osoite määritetään Profile_Rule -parametrilla ja uudelleensynkronointijakso määritetään Resync_Periodic -parametrilla.

1

Siirry puhelimen hallinnan verkkosivulle.

2

Valitse Ä äni > Provisioning.

3

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

4

Syötä säännöllinen synkronointi uudelleen -kenttään pieni testauksen arvo, kuten 30 sekuntia.

5

Klik kaa Lähetä kaikki muutokset.

Uusilla parametriasetuksilla puhelin synkronoituu kahdesti minuutissa URL-osoitteen määrittämään määritystiedostoon.

6

Tarkkaile tuloksena olevia viestejä syslog-jäljityksessä.

7

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


<Resync_On_Reset>Yes</Resync_On_Reset>

8

Käynnistä puhelin virran kytkemällä virta pakottaaksesi sen synkronoimaan uudelleen käyttöönottopalvelimeen.

Jos uudelleensynkronointitoiminto epäonnistuu jostain syystä, esimerkiksi jos palvelin ei vastaa, yksikkö odottaa (uudelleensynkronointi virheen uudelleenyrittämisviiveessä määritettyjen sekuntien määrän) ennen kuin se yrittää synkronoida uudelleen. Jos uudelleensynkronointivirheen uudelleenkokeiluviive on nolla, puhelin ei yritä synkronoida uudelleen epäonnistuneen uudelleensynkronointiyrityksen jälkeen.

9

(Valinnainen) Aseta Synkron ointivirheen uudelleenyrityksen viive -kentän arvoksi pieni luku, kuten 30.


<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 Kokoon panoprofiili -osiossa Pu he > Provisioning -välilehdessä. Se määrittelee myös merkkijonon syntaksin, joka lisätään puhelimen määritystiedostoon (cfg.xml) XML-koodilla parametrin määrittämiseksi.

Taulukko 1. Profiilin uudelleensynkronointiparametrit

Parametri

Kuvaus

Varaus Ota käyttöön

Sallii tai kieltää määritysprofiilin uudelleensynkronointitoiminnot.

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

    <Provision_Enable ua="na">Kyllä</Provision_Enable>
  • Määritä puhelimen verkkosivulla tämän kentän arvoksi Kyllä, jos haluat sallia uudelleensynkronointitoiminnot, tai Ei, jos haluat estää uudelleen synkronointitoiminnot.

Oletus: Kyllä

Synkronoi uudelleen nollauksen yhteydessä

Määrittää, synkronoidaanko puhelin määritykset uudelleen varmennuspalvelimen kanssa käynnistyksen jälkeen ja jokaisen päivitysyrityksen jälkeen.

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

    <Resync_On_Reset ua="na">Kyllä</Resync_On_Reset>
  • Määritä 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ä.

Oletus: Kyllä

Synkronoi uudelleen satunnainen viive

Estää varmennuspalvelimen ylikuormituksen, kun suuri määrä laitteita käynnistyy samanaikaisesti ja yritetään määrittää alkuasetukset. Tämä viive on voimassa vain alkuperäisessä määritysyrityksessä laitteen käynnistyksen tai nollauksen jälkeen.

Parametri on suurin aikaväli, jonka laite odottaa ennen yhteydenottoa varmennuspalvelimeen. Todellinen viive on näennäissatunnaisluku välillä 0 ja tämän arvon.

Tämä parametri on 20 sekunnin yksikköinä.

Kelvollinen arvo vaihtelee välillä 0 ja 65535.

  • 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 yksiköiden lukumäärä (20 sekuntia), jotta puhelin viivästyttää uudelleensynkronointia käynnistyksen tai nollauksen jälkeen.

Oletusarvo on 2 (40 sekuntia).

Synkronoi uudelleen (HHmm)

Aika (HHmm), jonka puhelin synkronoi uudelleen alustavan palvelimen kanssa.

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

  • 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 aika HHMM-muodossa, jolloin puhelin aloittaa uudelleensynkronoinnin.

Oletusarvo on tyhjä. Jos arvo on virheellinen, parametri jätetään huomiotta. Jos tälle parametrille on asetettu kelvollinen arvo, Resync Perio dic -parametri ohitetaan.

Synkronoi uudelleen satunnaisella viiveellä

Estää varmennuspalvelimen ylikuormituksen, kun suuri määrä laitteita käynnistyy samanaikaisesti.

Jotta vältetään uudelleensynkronointipyyntöjen tulva palvelimelle useista puhelimista, puhelin synkronoituu uudelleen tuntien ja minuuttien sekä tuntien ja minuuttien sekä satunnaisen viiveen välillä (hhmm, hhmm+random_delay). Jos esimerkiksi satunnainen viive = (Resync At Random Delay + 30) /60 minuuttia, syöttöarvo sekunteina muunnetaan minuuteiksi pyöristämällä seuraavaan minuuttiin lopullisen random_delay -välin laskemiseksi.

  • 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 verkko sivulla ajanjakso sekunteina.

Kelvollinen arvo vaihtelee välillä 600 ja 65535.

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

Oletusarvo on 600 sekuntia (10 minuuttia).

Säännöllinen uudelleensynkronointi

Aikaväli jaksollisen uudelleensynkronoinnin välillä varautumispalvelimen kanssa. Liittyvä uudelleensynkronointiajastin on aktiivinen vasta ensimmäisen onnistuneen synkronoinnin jälkeen palvelimen kanssa.

Voimassa olevat muodot ovat seuraavat:

  • Kokonaisluku

    Esimerkki: Syöttö 3000 osoittaa, että seuraava uudelleensynkronointi tapahtuu 3000 sekunnissa.

  • Useita kokonaislukuja

    Esimerkki: Syött ö 600 200 300 osoittaa, että ensimmäinen uudelleensynkronointi tapahtuu 600 sekunnissa, toinen uudelleensynkronointi tapahtuu 1200 sekunnissa ensimmäisen jälkeen ja kolmas uudelleensynkronointi tapahtuu 300 sekunnissa toisen jälkeen.

  • Aikaväli

    Esimerkiksi syöttö 2400+30 osoittaa, 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 verkko sivulla ajanjakso sekunteina.

Aseta tämä parametri nollaksi poistaaksesi säännöllisen synkronoinnin käytöstä.

Oletusarvo on 3600 sekuntia.

Uudelleensynkronointivirhe Yrityksen viive uudelleen

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

Voimassa olevat muodot ovat seuraavat:

  • Kokonaisluku

    Esimerkki: Syött ö 300 osoittaa, että seuraava uudelleensynkronointiyritys tapahtuu 300 sekunnissa.

  • Useita kokonaislukuja

    Esimerkki: Syöttö 600 200 300 osoittaa, että ensimmäinen uusintayritys tapahtuu 600 sekunnin kuluttua epäonnistumisesta, toinen uusintayritys tapahtuu 1200 sekunnissa ensimmäisen uudelleenyrityksen epäonnistumisen jälkeen ja kolmas uudelleenyritys tapahtuu 300 sekunnin kuluttua toisen uudelleenyrityksen epäonnistumisesta.

  • Aikaväli

    Esimerkiksi syöttö 2400+30 osoittaa, että seuraava uudelleenyritys tapahtuu 2400—2430 sekunnin kuluttua uudelleensynkronointivirheestä.

Jos viiveeksi on asetettu 0, laite ei yritä synkronoida uudelleen uudelleen epäonnistuneen uudelleensynkronointiyrityksen 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,8640.8640.86400</Resync_Error_Retry_Delay>
  • Määritä puhelimen verkko sivulla ajanjakso sekunteina.

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

Pakotettu uudelleensynkronointiviive

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

Laite ei synkronoi uudelleen, kun yksi sen puhelinlinjoista on aktiivinen. Koska uudelleensynkronointi voi kestää useita sekunteja, on toivottavaa odottaa, kunnes laite on ollut käyttämättömänä pitkään ennen uudelleensynkronointia. Tämän avulla käyttäjä voi soittaa puheluita peräkkäin keskeytyksettä.

Laitteessa on ajastin, joka alkaa laskea alaspäin, kun kaikki sen rivit ovat tyhjäkäynnillä. Tämä parametri on laskurin alkuarvo. Uudelleensynkronointitapahtumat viivästyvät, kunnes tämä laskuri laskee nollaan.

Kelvollinen arvo vaihtelee välillä 0 ja 65535.

  • 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 verkko sivulla ajanjakso sekunteina.

Oletusarvo on 14 400 sekuntia.

Synkronoi uudelleen SIP: stä

Ohjaa uudelleensynkronointipyyntöjä SIP NOTIFY -tapahtuman kautta, joka lähetetään palveluntarjoajan välityspalvelimelta puhelimeen. Jos tämä on käytössä, välityspalvelin voi pyytää uudelleensynkronointia lähettämällä laitteelle SIP NOTIFY -viestin, joka sisältää Event: resync -otsikon.

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

    <Resync_From_SIP ua="na">Kyllä</Resync_From_SIP>
  • Ota tämä ominaisuus käyttöön valitsemalla puhelimen verkkosivulla Kyllä tai Poista se käytöstä Ei.

Oletus: Kyllä

Synkronoi uudelleen päivitysyrityksen jälkeen

Ottaa uudelleen synkronointitoiminnon käyttöön tai poistaa sen käytöstä päivityksen jälkeen. Jos Kyllä on valittuna, synkronointi käynnistyy laiteohjelmiston päivityksen jälkeen.

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

    <Resync_After_Upgrade_Attempt ua="na">Kyllä</Resync_After_Upgrade_Attempt>
  • Valitse puhelimen verkkosivulla Kyllä, jos haluat käynnistää uudelleen synkronoinnin laiteohjelmiston päivityksen jälkeen, tai Ei, jos haluat synkronoida uudelleen.

Oletus: Kyllä

Synkronoi uudelleen liipaisin 1

Synkronoi uudelleen liipaisin 2

Jos näiden parametrien loogisen yhtälön arvo on FALSE, uudelleensynkronointia ei käynnisty, vaikka Resync On Reset -asetukseksi on asetettu TOSI. Vain uudelleensynkronointi suoratoiminnon URL-osoitteen ja SIP-ilmoituksen kautta ohittaa nämä uudelleensynkronoinnin laukaisimet.

Parametrit voidaan ohjelmoida ehdollisella lausekkeella, joka laajenee makro. Kelvolliset makrolaajennukset on kohdassa Makron laajennusmuuttujat kohdasta Provision-parametrit.

  • 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ä laukaisimet puhelimen verkkosivulla.

Oletus: Tyhjä

Käyttäjän konfiguroitava uudelleensynkronointi

Antaa käyttäjän synkronoida puhelimen uudelleen puhelimen näytön valikosta. Kun asetus on Kyllä, käyttäjä voi synkronoida puhelimen määritykset uudelleen syöttämällä profiilisäännön puhelimesta. Kun asetus on Ei, Profiilisään töparametria ei näytetä puhelimen näytön valikossa.

  • 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ä, jos haluat näyttää Profiilisääntö parametrin puhelinvalikossa, tai piilota tämä parametri valitsemalla Ei.

Oletus: Kyllä

Uudelleensynkronointi epäonnistuu FNF: ssä

Uudelleensynkronointia pidetään tyypillisesti epäonnistuneena, jos pyydettyä profiilia ei vastaanota palvelimelta. Tämä parametri ohittaa tämän toiminnon. Kun asetus on Ei, laite hyväksyy palvelimelta tiedoston löytä mättömän vastauksen onnistune ena uudelleensynkronoinnina.

  • 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 ottaa tiedoston löytämättömän vastauksen epäonnist uneeksi uudelleensynkronoinniksi, tai valitse Ei, jos haluat ottaa tiedoston löytämättömän vastauksen onnistuneeksi uudelleensynkronoinniksi.

Oletus: Kyllä

Profiilin todennustyyppi

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

  • Pois käytöstä: Poistaa profiilitilin ominaisuuden käytöstä. Kun tämä ominaisuus on poistettu käytöstä, Profiilitilin aset usvalikko ei näy puhelimen näytöllä.

  • Perus HTTP-toden nus: HTTP-kirjautumistietoja käytetään profiilitilin todentamiseen.

  • XSI-todennus: Profiilitilin todentamiseen käytetään XSI-kirjautumistietoja tai XSI SIP -tunnistetietoja. Todennustiedot riippuvat puhelimen XSI-todennusty ypistä:

    • Kun puhelimen XSI-todennustyyppi on määritetty kirjautumistunnuk siksi, käytetään XSI-kirjautumistietoja.

    • Kun puhelimen XSI-todennustyyp iksi on asetettu SIP-tunnistetied ot, käytetään XSI SIP -tunnistetietoja.

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

    <Profile_Authentication_Type ua="na">Perus Http-todennus</Profile_Authentication_Type>
  • Valitse puhelimen verkkosivulla luettelosta vaihtoehto, jolla puhelin todentaa profiilin uudelleensynkronoinnin.

Oletus: Perus HTTP-todennus

Lisätietoja on kohdassa Profiilin todennustyypin määrittäminen kohdassa Määr itä puhelin profiilin uudelleensynkronointia varten.

Profiilisääntö

Profiilin sääntö B

Profiilin sääntö C

Profiilin sääntö D

Jokainen profiilisäännö ilmoittaa puhelimelle lähteestä, josta profiili hankitaan (määritystiedosto). Jokaisen uudelleensynkronointitoiminnon aikana puhelin käyttää kaikkia profiileja peräkkäin.

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

[--avain] <encryption key>

Voit liittää salausavaimen lainausmerkkeihin (”) valinnaisesti.

  • 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ä profiilin sääntö puhelimen verkkosivulla.

Oletus: /$psn.xml

Käytettävä DHCP-vaihtoehto

DHCP-asetukset, jotka on erotettu pilkuilla, käytetään laiteohjelmiston ja profiilien hakemiseen.

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

DHCPv6 Käytettävä Vaihtoehto

DHCP-asetukset, jotka on erotettu pilkuilla, käytetään laiteohjelmiston ja profiilien hakemiseen.

Oletus: 17,160,159

Provisiointi Cisco XML: n kautta

Voit tarjota puhelimia Cisco XML -toimintojen kautta.

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

CP-xxxx-3PCC laajentaa Cisco XML -ominaisuutta tukemaan XML-objektin kautta tapahtuvaa provisiointia:


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

Kun puhelin on vastaanottanut XML-objektin, se lataa alustustiedoston osoitteesta [profiili-sääntö]. Tämä sääntö käyttää makroja XML-palvelusovelluksen kehittämisen yksinkertaistamiseen.

URL-tarkkuus makrolaajennuksella

Alihakemistot, joissa on useita profiileja palvelimella, tarjoavat kätevän menetelmän suuren määrän käyttöönotettujen laitteiden hallintaan. Profiilin URL-osoite voi sisältää:

  • Varmistuspalvelimen nimi tai nimenomainen IP-osoite. Jos profiili tunnistaa valmistelupalvelimen nimen perusteella, puhelin suorittaa DNS-haun nimen selvittämiseksi.

  • Epätavallinen palvelinportti, joka määritetään URL-osoitteessa käyttämällä palvelimen nimen jälkeistä vakiosyntax:port -merkkiä.

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

Esimerkiksi seuraava Profile_Rule pyytää profiilitiedostoa ($PN.cfg) palvelimen alihakemistossa /cisco/config TFTP-palvelimelta, joka on käynnissä host prov.telco .com ja kuuntelee yhteyttä porttiin 6900-porttiin:


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

Kunkin puhelimen profiili voidaan tunnistaa yleiskäyttöisestä parametrista, jonka arvo viitataan yhteisessä profiilisäännössä makrolaajennuksen avulla.

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

Profile_Rule -toiminnolla on arvo:


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

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


tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg

Määritä profiilin todennustyyppi

Profiilin todennuksen avulla puhelimen käyttäjät voivat synkronoida varausprofiilin uudelleen puhelimeen. Todennustiedot vaaditaan, kun puhelin yrittää synkronoida uudelleen ja ladata määritystiedoston ensimmäistä kertaa ja saa HTTP- tai HTTPS 401 -todennusvirheen. Kun otat tämän ominaisuuden käyttöön, Profiilitilin asetukset -näyttö tulee näkyviin puhelimessa seuraavissa tilanteissa:

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

  • Kun profiilin käyttäjätunnus ja salasana ovat tyhjät

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

Jos Profiilitilin asetusnäyttö jää huomaamatta tai sitä ei oteta huomioon, käyttäjä voi käyttää asetusnäyttöä myös puhelimen näytön valikosta tai Aset ukset-toimintonäppäimestä, joka tulee näkyviin vain, kun puhelimessa ei ole rekisteröity linjaa.

Kun poistat ominaisuuden käytöstä, Profiilitilin aset usnäyttö ei näy puhelimessa.

Profi ilisääntö-kentän käyttäjätunnuksella ja salasanalla on korkeampi prioriteetti kuin profiilitilillä.

  • Kun annat oikean URL-osoitteen Profiilisääntö-kenttään ilman käyttäjänimeä ja salasanaa, puhelin vaatii todennuksen tai yhteenvedon profiilin synkronoimiseksi uudelleen. Oikealla profiilitilillä todennus läpäisee. Virheellisellä profiilitilillä todennus epäonnistuu.

  • Kun annat oikean URL-osoitteen Profiilisääntö-kenttään oikealla käyttäjänimellä ja salasanalla, puhelin vaatii todennuksen tai yhteenvedon profiilin synkronoimiseksi uudelleen. Profiilitiliä ei käytetä puhelimen uudelleensynkronointiin. Sisäänkirjautuminen onnistui.

  • Kun annat oikean URL-osoitteen Profiilisääntö-kenttään virheellisellä käyttäjänimellä ja salasanalla, puhelin vaatii todennuksen tai yhteenvedon profiilin synkronoimiseksi uudelleen. Profiilitiliä ei käytetä puhelimen uudelleensynkronointiin. Sisäänkirjautuminen epäonnistuu aina.

  • Kun annat väärän URL-osoitteen Profiilisääntö- kenttään, kirjautuminen epäonnistuu aina.

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

Voit määrittää profiilin todennustyypin puhelimen hallinnan verkkosivulta.

1

Siirry puhelimen hallinnan verkkosivulle.

2

Valitse Ä äni > Provisioning.

3

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

Voit määrittää tämän parametrin puhelimen kokoonpanon XML-tiedostossa (cfg.xml) kirjoit tamalla merkkijonon tässä muodossa:

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

Vaihtoehdot:

  • Pois käytöstä: Poistaa profiilitilin ominaisuuden käytöstä. Kun tämä ominaisuus on poistettu käytöstä, Profiilitilin asetus valikko ei näy puhelimen näytöllä.

  • Perus HTTP-toden nus: HTTP-kirjautumistietoja käytetään profiilitilin todentamiseen.

  • XSI-todennus: Profiilitilin todentamiseen käytetään XSI-kirjautumistietoja tai XSI SIP -tunnistetietoja. Todennuksen tunnistetiedot riippuvat puhelimen XSI-todennustyypistä:

    Kun puhelimen XSI-todennustyyppi on määritetty kirjautumistunnuksiksi, käytetään XSI-kirjautumistietoja.

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

Oletus: Perus HTTP-todennus

4

Valitse Lähetä kaikki muutokset.

Profiilin käyttäminen puhelimeen manuaalisesti

Lataa määritystiedosto puhelimeen TFTP-palvelimelta

Suorita nämä vaiheet ladataksesi määritystiedoston tietokoneesi TFTP-palvelinsovellukseen.

1

Liitä tietokone puhelimen LAN-porttiin.

2

Suorita TFTP-palvelinsovellus tietokoneessa ja varmista, että määritystiedosto on käytettävissä TFTP-juurihakemistossa.

3

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

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

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-ohjelmalla

Suorita nämä vaiheet ladataksesi kokoonpanon puhelimeen cURL-ohjelmalla. Tätä komentorivityökalua käytetään tietojen siirtämiseen URL-syntaksilla. Jos haluat ladata cURL, käy osoitteessa:

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

Suosittelemme, että et käytä cURL-ohjelmaa määrityksen lähettämiseen puhelimeen, koska käyttäjänimi ja salasana saatetaan kaapata cURL-toiminnon aikana.

1

Liitä tietokone puhelimen LAN-porttiin.

2

Lataa määritystiedosto puhelimeen kirjoittamalla seuraava cURL-komento:

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

Viitteet profiilin määritykseen

Puhelin hyväksyy kokoonpanot XML-muodossa.

Tämän osan esimerkeissä käytetään määritysprofiileja, joissa on XML-syntaksi.

Kokoonpanoprofiilin muodot

Määritysprofiili määrittelee puhelimen parametriarvot.

Määritysprofiilin XML-muoto käyttää tavanomaisia XML-luontityökaluja parametrien ja arvojen kokoamiseen.

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

Jokaisella puhelimella on erilainen ominaisuusjoukko ja siten erilainen parametrijoukko.

Avaa profiilin muoto

Avoimen muotoinen profiili on tekstitiedosto, jossa on XML-tyyppinen syntaksi elementtien hierarkiassa, elementtien määritteillä ja arvoilla. Tämän muodon avulla voit luoda määritystiedoston vakiotyökaluilla. XML-määritystiedosto voidaan lähettää provisiointipalvelimelta puhelimeen uudelleensynkronointitoiminnon aikana ilman koostamista binääriobjektina.

Puhelin voi hyväksyä vakiotyökalujen luomat kokoonpanomuodot. Tämä ominaisuus helpottaa taustapalvelinohjelmistojen kehittämistä, joka luo määritysprofiileja olemassa olevista tietokannoista.

Määritysprofiilin luottamuksellisten tietojen suojaamiseksi varmennuspalvelin toimittaa XML-määritystiedoston puhelimeen TLS-suojaaman kanavan kautta. Valinnaisesti tiedosto voidaan pakata käyttämällä gzip deflate -algoritmia (RFC1951).

Tiedosto voidaan salata jollakin seuraavista salausmenetelmistä:

  • AES-256-CBC-salaus

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

Määritystiedosto voi sisältää seuraavat komponentit:

  • Elementtitunnisteet

  • Ominaisuudet

  • Parametrit

  • Muotoiluominaisuudet

  • XML-kommentit

Esimerkki: Avaa profiilin muoto


<flat-profile>
<Resync_On_Reset> Yes </Resync_On_Reset>
<Resync_Periodic> 7200 </Resync_Periodic>
<Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule>
</flat-profile>

Element <flat-profile>titunniste sisältää kaikki parametrielementit, jotka puhelin tunnistaa.

Elementtitunnisteen ominaisuudet

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

  • XML-valmistelumuoto ja Web-käyttöliittymä mahdollistavat samojen asetusten määrittämisen. Web-käyttöliittymän XML-tunnisteiden nimet ja kenttien nimet ovat samankaltaisia, mutta vaihtelevat XML-elementtien nimirajoitusten vuoksi. Esimerkiksi alaviivat (_) XML-määritystiedostossa Web-käyttöliittymän välilyöntien sijaan.

  • <flat-profile>Puhelin tunnistaa elementit, joilla on oikeat parametrien nimet, jotka on kapseloitu erity iseen elementtiin.

  • Elementtien nimet on suljettu kulmasulkeisiin.

  • Useimmat elementtien nimet ovat samanlaisia kuin puhelimen Web-käyttöliittymän kenttien nimet, seuraavilla muutoksilla:

    • Elementtien nimissä ei saa olla välilyöntejä tai erikoismerkkejä. Jos haluat saada elementin nimen verkkokentän nimestä, korvaa jokaiselle välilyönnille tai erikoismerkkeille [,], (,) tai/alaviiva.

      Esimerkki: E <Resync_On_Reset>lementti edustaa Resync Reset -kenttää.

    • Jokaisen elementin nimen on oltava yksilöllinen. Puhelimen Web-käyttöliittymässä samat kentät voivat näkyä useilla verkkosivuilla, kuten Linja-, Käyttäjä- ja Laajennussivuilla. Lisää [n] elementin nimeen osoittaaksesi sivun välilehdessä näkyvän numeron.

      Esimerkki: E <Dial_Plan_1_>lementti edustaa lin jan 1 valintasuunnitel maa.

  • Jokaisella avautuvan elementin tunnisteella on oltava vastaava sulkemiselementtitunniste. Esimerkiksi:

    
    <flat-profile>
    <Resync_On_Reset> Yes
      </Resync_On_Reset>
    <Resync_Periodic> 7200
      </Resync_Periodic>
    <Profile_Rule>tftp://prov.telco.com: 6900/cisco/config/CP_xxxx_MPP.cfg
      </Profile_Rule>
    </flat-profile>
    
  • Elementtitunnisteet erottavat isot ja pienet kirjaimet.

  • Tyhjien elementtien tunnisteet ovat sallittuja, ja ne tulkitaan määrittävän arvon tyhjäksi. Kirjoita avauselementin tunniste ilman vastaavaa elementtitunnistetta ja lisää välilyönti ja eteenpäin viiva sulkemiskulman sulkeeseen (>). Tässä esimerkissä profiilin sääntö B on tyhjä:

    
    <Profile_Rule_B />
    
  • Tyhjää elementtitunnistetta voidaan käyttää estämään käyttäjän antamien arvojen korvaaminen uudelleensynkronointitoiminnon aikana. Seuraavassa esimerkissä käyttäjän pikavalinnan asetukset eivät muutu:

    <flat-profile>
    <Speed_Dial_2_Name ua="rw"/>
    <Speed_Dial_2_Number ua="rw"/>
    <Speed_Dial_3_Name ua="rw"/>
    <Speed_Dial_3_Number ua="rw"/>
    <Speed_Dial_4_Name ua="rw"/>
    <Speed_Dial_4_Number ua="rw"/>
    <Speed_Dial_5_Name ua="rw"/>
    <Speed_Dial_5_Number ua="rw"/>
    <Speed_Dial_6_Name ua="rw"/>
    <Speed_Dial_6_Number ua="rw"/>
    <Speed_Dial_7_Name ua="rw"/>
    <Speed_Dial_7_Number ua="rw"/>
    <Speed_Dial_8_Name ua="rw"/>
    <Speed_Dial_8_Number ua="rw"/>
    <Speed_Dial_9_Name ua="rw"/>
    <Speed_Dial_9_Number ua="rw"/>
    </flat-profile>
    
  • Aseta vastaava parametri tyhjäksi merkkijonoksi tyhjällä arvolla. Syötä avautuva ja sulkeutuva elementti ilman arvoa niiden välillä. Seuraavassa esimerkissä GPP_A-parametri on asetettu tyhjäksi merkkijonoksi.

    
    <flat-profile>
    <GPP_A>
      </GPP_A>
    </flat-profile>
    
  • Tunnistamattomat elementtien nimet jätetään huomiotta.

Parametriominaisuudet

Nämä ominaisuudet koskevat parametreja:

  • Kaikki parametrit, joita profiili ei ole määrittänyt, jätetään muuttumattomiksi puhelimessa.

  • Tunnistamattomat parametrit jätetään huomiotta.

  • Jos Avoin muoto -profiili sisältää useita saman parametritunnisteen esiintymiä, viimeinen tällainen esiintymä ohittaa aiemmat. Parametrin määritysarvojen tahattoman ohituksen välttämiseksi suosittelemme, että jokainen profiili määrittää enintään yhden parametrin esiintymän.

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

Merkkijonomuodot

Nämä ominaisuudet koskevat merkkijonojen muotoilua:

  • Kommentit ovat sallittuja standardin XML-syntaksin kautta.

    <!-- My comment is typed here -->
  • Läpi- ja loppuväli sallitaan luettavuuden vuoksi, mutta se poistetaan parametriarvosta.

  • Arvon uudet rivit muunnetaan välilyönneiksi.

  • Lomakkeen XML-otsikko <? ? > on sallittu, mutta puhelin jättää sen huomiotta.

  • Jos haluat kirjoittaa erikoismerkkejä, käytä XML-perusmerkkejä seuraavassa taulukossa esitetyllä tavalla.

    Erikoismerkki

    XML Escape -sekvenssi

    & (ampersandi)

    &

    < (vähemmän kuin)

    <

    > (suurempi kuin)

    >

    '(heittomerkki)

    '

    ” (kaksinkertainen lainaus)

    ”

    Seuraavassa esimerkissä merkkien väänteet merkitään valintasuunnitelmasäännössä vaadittavia suurempia kuin- ja pienempiä symboleja. Tässä esimerkissä määritellään vihjelinjan puhelinsuunnitelma, joka asettaa <Dial_Plan_1_>parametrin (Järjestel mänvalvojan sisäänkirjaut uminen > Lisäasetukset > Ääni > Ext (n)) arvok si (S0 <:18005551212>).

    
    <flat-profile>
     <Dial_Plan_1_>
      (S0 &lt;:18005551212&gt;)
     </Dial_Plan_1_>
    </flat-profile>
  • Numeeriset merkkipakot käännetään desimaali- ja heksadesimaalisten arvo jen avulla (s.a. (ja.).

  • Puhelimen laiteohjelmisto tukee vain ASCII-merkkejä.

Avaa profiilin pakkaus

Tuettu pakkausmenetelmä on gzip deflate -algoritmi (RFC1951). Gzip-apuohjelma ja pakkauskirjasto, joka toteuttaa saman algoritmin (zlib), ovat saatavilla Internet-sivustoilta.

Pakkauksen tunnistamiseksi puhelin odottaa pakatun tiedoston sisältävän gzip-yhteensopivan otsikon. Gzip-apuohjelman kutsuminen alkuperäiseen Open-profiiliin luo otsikon. Puhelin tarkistaa ladatun tiedoston otsikon tiedostomuodon määrittämiseksi.

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

  • > gzip profile.xml

    Korvaa alkuperäisen tiedoston pakatulla tiedostolla.

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

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

Avaa profiilin salaus

Symmetrisen avaimen salausta voidaan käyttää avoimen kokoonpanoprofiilin salaamiseen riippumatta siitä, onko tiedosto pakattu vai ei. Pakkaus, jos sitä käytetään, on sovellettava ennen salausta.

Varmistuspalvelin käyttää HTTPS-protokollaa puhelimen alustavan käyttöönoton jälkeen. Määritysprofiilien esisalaus offline-tilassa mahdollistaa HTTP: n käytön profiilien synkronointiin myöhemmin. Tämä vähentää HTTPS-palvelimen kuormitusta laajamittaisissa käyttöönotoissa.

Puhelin tukee kahta salausmenetelmää kokoonpanotiedostoille:

  • AES-256-CBC-salaus

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

Avain tai syöttöavaimen materiaali (IKM) on esiasetettava yksikköön aikaisemmin. Salaisen avaimen käynnistys voidaan suorittaa turvallisesti HTTPS: n avulla.

Määritystiedoston nimi ei vaadi tiettyä muotoa, mutta tiedostonimi, joka päättyy .cfg-tunnisteeseen, ilmais ee yleensä määritysprofiilin.

AES-256-CBC-salaus

Puhelin tukee AES-256-CBC-salausta kokoonpanotiedostoille.

OpenSSL-salaustyökalu, joka on ladattavissa eri Internet-sivustoilta, voi suorittaa salauksen. 256-bittisen AES-salauksen tuki saattaa vaatia työkalun uudelleenkokoamista AES-koodin ottamiseksi käyttöön. Laiteohjelmisto on testattu versiota openssl-1.1.1d vastaan.

Salatussa tiedostossa profiilissa oletetaan, että tiedoston muoto on sama kuin seuraavalla komennolla:


# example encryption key = SecretPhrase1234

openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg

# analogous invocation for a compressed xml file

openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg

Pieni kirjain -k edeltää salaista avainta, joka voi olla mikä tahansa pelkkä tekstilause, ja jota käytetään satunnaisen 64-bittisen suolan luomiseen. -k-argumentin määrittämällä salaisuudella salaustyökalu saa satunnaisen 128-bittisen alkuvektorin ja todellisen 256-bittisen salausavaimen.

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


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

Tämä arvo ohjelmoidaan käyttämällä jotakin Profile_Rule-parametreista.

Useat provisiointiparametrit laajenevat makroa sisäisesti ennen niiden arviointia. Tämä ennakkoarviointivaihe tarjoaa suuremman joustavuuden puhelimen uudelleensynkronointi- ja päivitystoimintojen hallinnassa.

Nämä parametriryhmät laajenevat makro ennen arviointia:

  • Synkronoi uudelleen laukaisija_*

  • Profiili_sääntö*

  • Log_xxx_MSG

  • Päivityssääntö

Tietyissä olosuhteissa jotkin yleiskäyttöiset parametrit (GPP_*) laajennetaan myös makroa, kuten alla olevassa Val innaiset uudelleensynkronointiargumentit -osiossa on nimenomaisesti osoitettu.

Makrojen laajennuksen aikana nimettyjen muuttujien sisältö korvaa lomakkeen $NAME ja $ (NAME) lausekkeet. Näitä muuttujia ovat yleiskäyttöiset parametrit, useita tuotetunnisteita, tietyt tapahtuma-ajastimet ja alustavan tilan arvot. Täydellinen luettelo on kohdassa Makron laajennusmuuttujat kohdasta Provision-parametrit.

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

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

Tuloksena oleva makrolaajennus laitteelle, jolla on MAC-osoite 000E08012345, on: 000E08012345config.cfg

Jos makron nimeä ei tunnisteta, sitä ei laajenneta. Esimerkiksi nimeä STRANGE ei tunnisteta kelvolliseksi makronimeksi, kun taas MAU tunnistetaan kelvolliseksi makronimeksi.

Järjestelmänvalvoja kirjoittaa: $strange$mau.cfg

Tuloksena oleva makrolaajennus laitteelle, jolla on MAC-osoite 000E08012345, on: $ Strange000E08012345.cfg

Makrolaajennusta ei käytetä rekursiivisesti. Esimerkiksi $$MAU ”laajenee muotoon $MAU” ($$ laajennetaan) eikä johda MAC-osoitteeseen.

Erikoiskäyttöparametrien, GPP_SA - GPP_SD, sisältö yhdistetään makrolausekkeisiin $SA - $SD. Nämä parametrit ovat vain makroa laajennettu --key-, -- uid- ja --pwd-asetusten argumenttina resync-URL-osoitteessa.

Ehdolliset lausekkeet voivat laukaista uudelleensynkronointitapahtumia ja valita vaihtoehtoisista URL-osoitteista uudelleensynkronointi- ja päivitystoimintoja varten.

Ehdolliset lausekkeet koostuvat vertailuluettelosta, joka on erotettu operaattorilla ja. Kaikkien vertailujen on täytyttävä, jotta ehto on totta.

Jokainen vertailu voi liittyä johonkin seuraavista kolmesta kirjaintyypistä:

  • Kokonaislukuarvot

  • Ohjelmisto- tai laitteistoversioiden numerot

  • Kaksinkertaisesti lainatut merkkijonot

Versionumerot

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

PHONEOS vvvv. 1-0-1-0001 - BN

missä vvv v ilmaisee puhelinmallin tai puhelinsarjan; 1 on pääversio; 0 on alempi versio; 1-0001 on mikroversio; ja BN on koontinumero.

Vertaileva merkkijono on käytettävä samaa muotoa. Muussa tapauksessa tuloksena on muodon jäsentämisvirhe.

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

Esimerkkejä kelvollisesta versionumerosta

PHONEOS-8875.1-0-1-0001-19

Vertailu

Lainattuja merkkijonoja voidaan verrata tasa-arvon tai epätasa-arvon suhteen. Kokonaislukuja ja versionumeroita voidaan verrata myös aritmeettisesti. Vertailuoperaattorit voidaan ilmaista symboleina tai lyhenteinä. Lyhenteet ovat käteviä ilmaisemaan ehto avoimen muodon profiilissa.

Operaattori

Vaihtoehtoinen syntaksi

Kuvaus

Sovelletaan kokonaisluku- ja versiooperandeihin

Sovelletaan lainattuihin merkkijonooperandeihin

=

ekv

yhtä suuri kuin

Joo

Joo

!=

no

ei yhtä suuri kuin

Joo

Joo

<

lt

vähemmän kuin

Joo

Ei

<=

le

pienempi tai yhtä suuri kuin

Joo

Ei

>

gt

suurempi kuin

Joo

Ei

>=

ge

suurempi tai yhtä suuri kuin

Joo

Ei

AND

ja

Joo

Joo

On tärkeää sisällyttää makromuuttujat kaksoislainausmerkkeihin, joissa merkkijonon kirjaimellinen odotetaan. Älä tee niin siellä, missä numero tai versionumero on odotettavissa.

Kun niitä käytetään Profile_Rule*- ja Upgrade_Rule -parametrien yhteydessä, ehdolliset lausekkeet on sisällytettävä syntaksiin ”(expr)?” kuten tässä päivityssäännön esimerkissä. Muista korvata BN päivitetyn laiteohjelmistokuorman koontinumerolla.

($SWVER ne PHONEOS-8875.1-0-1-0001-19)? http://ps.tell.com/sw/PHONEOS-8875.1-0-1-0001-BN.loads

Älä käytä edellistä syntaksia sulkeilla Resync_Trigger_* -parametrien määrittämiseen.

Käytä vakioURL-syntaksia määrittääksesi, miten määritystiedostot ja laiteohjelmiston lataukset haetaan Profile_Rule*- ja Upgrade_Rule -parametreissa. Syntaksi on seuraava:

[kaavio://] [palvelin [:portti]] tiedostopolku

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

  • tftp

  • http

  • https

Jos järjestelmä jätetään pois, oletetaan tftp: n. Palvelin voi olla DNS-tunnistettu isäntänimi tai numeerinen IP-osoite. Portti on kohdeportin UDP- tai TCP-portin numero. Tiedostoreitin on aloitettava juurihakemistolla (/); sen on oltava absoluuttinen polku.

Jos palvelin puuttuu, käytetään DHCP:n kautta määritettyä tftp-palvelinta (vaihtoehto 66).

Päivityssääntöjä varten palvelin on määritettävä.

Jos por tti puuttuu, käytetään määritetyn järjestelmän vakioporttia. Tftp käyttää UDP-porttia 69, http TCP-porttia 80, https TCP-porttia 443.

Tiedostoreitin on oltava läsnä. Sen ei tarvitse välttämättä viitata staattiseen tiedostoon, mutta se voi osoittaa dynaamista sisältöä, joka on saatu CGI: n kautta.

Makrojen laajennus koskee URL-osoitteita. Seuraavassa on esimerkkejä kelvollisista URL-osoitteista:


/$MA.cfg
/cisco/cfg.xml
192.168.1.130/profiles/init.cfg
tftp://prov.call.com/cpe/cisco$MA.cfg
http://neptune.speak.net:8080/prov/$D/$E.cfg
https://secure.me.com/profile?Linksys

Kun käytät DHCP-vaihtoehtoa 66, päivityssäännöt eivät tue tyhjää syntaksia. Se koskee vain profiilisääntöä*.

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

Puhelin tukee RFC 8188-pohjaista HTTP-sisällön salausta AES-128-GCM-salauksella määritystiedostoille. Tällä salausmenetelmällä kuka tahansa entiteetti voi lukea HTTP-viestin otsikot. Kuitenkin vain ne entiteetit, jotka tuntevat syöttöavaimen materiaalin (IKM), voivat lukea hyötykuorman. Kun puhelimeen on asennettu IKM, puhelin ja provisiointipalvelin voivat vaihtaa määritystiedostoja turvallisesti, samalla kun kolmannen osapuolen verkkoelementit voivat käyttää viestin otsikoita analytiikka- ja seurantatarkoituksiin.

XML-määritysparametri IKM_HTTP_EncryptContent pitää IKM: n puhelimessa. Turvallisuussyistä tämä parametri ei ole käytettävissä puhelimen hallinnan verkkosivulla. Se ei myöskään näy puhelimen määritystiedostossa, jota voit käyttää puhelimen IP-osoitteesta tai puhelimen määritysraporteista, jotka lähetetään varauspalvelimelle.

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

  • Asenna puhelin IKM:llä määrittämällä IKM XML-parametrilla IKM_HTTP_EncryptContent määritystiedostossa, joka lähet etään alustuspalvelimelta puhelimeen.

  • Jos tätä salausta käytetään määrityspalvelimelta puhelimeen lähetetyissä määritystiedostoissa, varmista, että määritystiedoston Content-Encoding HTTP-otsikossa on aes128gcm.

    Tämän otsikon puuttuessa AES-256-CBC-menetelmä on etusijalla. Puhelin käyttää AES-256-CBC-salauksen purkua, jos AES-256-CBC-avain on läsnä profiilisäännössä IKM: stä riippumatta.

  • Jos haluat puhelimen käyttävän tätä salausta määritysraporteissa, jotka se lähettää käyttöönottopalvelimelle, varmista, että raporttisäännössä ei ole määritetty AES-256-CBC-avainta.

Valinnaiset uudelleensynkronointiargumentit

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

--key -asetus kertoo puhelimelle, että sen käyttöönottopalvelimelta vastaanottama määritystiedosto on salattu AES-256-CBC-salauksella, ellei tiedoston Content-Encoding -otsikko osoita aes128gcm-salausta. Itse avain määritetään merkkijonona termin --key jälkeen. Avain voidaan liittää kaksoislainausmerkkeihin (”) valinnaisesti. Puhelin käyttää avainta kokoonpanotiedoston purkamiseen.

Käyttöesimerkkejä


[--key VerySecretValue]
[--key “my secret phrase”]
[--key a37d2fb9055c1d04883a0745eb0917a4]

Sulkeissa olevat valinnaiset argumentit ovat makrolaajennettuja. Erityiskäyttöparametrit, GPP_SA - GPP_SD, laajennetaan makromuuttujiksi, $ SA - $ SD, vain silloin, kun niitä käytetään keskeisinä vaihtoehtoargumentteina. Katso nämä esimerkit:

[--key $SC]
[--key “$SD”]

Avoimen muodon profiileissa --key -argumentin on oltava sama kuin -k- vaihtoehdon argumentti, joka annetaan openssl: lle.

Uid- ja pwd-asetuksilla voidaan määrittää käyttäjätunnus ja salasana, jotka lähetetään vastauksena HTTP Basic- ja Digest -todennushaasteisiin, kun määritettyä URL-osoitetta pyydetään. Sulkeissa olevat valinnaiset argumentit ovat makrolaajennettuja. Erityiskäyttöparametrit, GPP_SA - GPP_SD, laajennetaan makromuuttujiksi, $ SA - $ SD, vain silloin, kun niitä käytetään keskeisinä vaihtoehtoargumentteina. Katso nämä esimerkit:

GPP_SA = MyUserID
GPP_SB = MySecretPassword

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

laajenisi sitten seuraavaan:

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

Tietotyypit

Näitä tietotyyppejä käytetään kokoonpanoprofiiliparametrien kanssa:

  • {a, b, c,...} - Valinta välillä a, b, c,...

  • Bool—Boolen arvo joko ”kyllä” tai ”ei”.

  • CADscript - miniskripti, joka määrittää signaalin poljinnopeusparametrit. Jopa 127 merkkiä.

    Syntaksi: S 1 [; S 2], jossa:

    • S i =D i (päällä i,1 /off i,1 [, päällä i, 2 /off i, 2 [, päällä i, 3 /off i, 3 [, päällä i,4 /off i, 4 [, päällä i,5 /off i ,5 [, päällä i ,6 /off i ,6]]]]) ja tunnetaan nimellä osio.

    • päällä i, j ja pois i, j ovat segmentin päälle/pois-kesto sekunteina. i = 1 tai 2 ja j = 1 - 6.

    • D i on osion kokonaiskesto sekunteina.

    Kaikilla kestoilla voi olla enintään kolme desimaalipaikkaa 1 ms: n tarkkuuden aikaansaamiseksi. Jokerimerkki ”*” tarkoittaa ääretöntä kestoa. Osion segmentit toistetaan järjestyksessä ja toistetaan, kunnes kokonaiskesto on toistettu.

    Esimerkki 1:

    
    60(2/4)
    
    Number of Cadence Sections = 1
    Cadence Section 1: Section Length = 60 s
    Number of Segments = 1
    Segment 1: On=2s, Off=4s
    
    Total Ring Length = 60s
    
    

    Esimerkki 2 — Erottuva rengas (lyhyt, lyhyt, lyhyt, pitkä):

    
    60(.2/.2,.2/.2,.2/.2,1/4)
    
    Number of Cadence Sections = 1
    Cadence Section 1: Section Length = 60s
    Number of Segments = 4
    Segment 1: On=0.2s, Off=0.2s
    Segment 2: On=0.2s, Off=0.2s
    Segment 3: On=0.2s, Off=0.2s
    Segment 4: On=1.0s, Off=4.0s
    
    Total Ring Length = 60s
    
    
  • DialPlanScript — komentosarjojen syntaksi, jota käytetään rivin 1 ja 2 valintasuunnitelmien määrittämiseen.

  • Flo <n>at —Liukuarvo enintään n desimaalin tarkkuudella.

  • FQDN — Täysin pätevä verkkotunnus. Se voi sisältää enintään 63 merkkiä. Esimerkkejä ovat seuraavat:

    • sip.cisco.com:5060 tai 109.12.14. 12:12345

    • Sip.cisco.com tai 109.12.14.12

  • FreqScript - miniskripti, joka määrittelee äänen taajuus- ja tasoparametrit. Sisältää jopa 127 merkkiä.

    Syntaksi: F 1 @L 1 [, F 2 @L 2 [, F 3 @L 3 [, F 4 @L 4 [, F 5 @L 5 [, F 6 @L 6]]]], missä:

    • F 1 —F 6 ovat taajuuksia Hz (vain allekirjoittamattomat kokonaisluvut).

    • L 1 —L 6 ovat vast aavia tasoja dBm:ssä (enintään yhdellä desimaalilla).

    Valkoiset välilyönnit ennen pilkkua ja sen jälkeen ovat sallittuja, mutta niitä ei suositella.

    Esimerkki 1 — Puhelun odotusääni:

    
    440@-10
    
    Number of Frequencies = 1
    Frequency 1 = 440 Hz at –10 dBm
    
    

    Esimerkki 2 — Soittoääni:

    
    350@-19,440@-19
    
    Number of Frequencies = 2
    Frequency 1 = 350 Hz at –19 dBm
    Frequency 2 = 440 Hz at –19 dBm
    
  • IP— Voimassa oleva IPv4-osoite muodossa x.x.x.x, jossa x on välillä 0 ja 255. Esimerkki: 10.1.2.100.

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

  • Puhelin — puhelinnumeron merkkijono, kuten 14081234567, *69, *72, 345678, tai yleinen URL-osoite, kuten 1234 @10 .10.10. 100:5068 tai jsmith@Cisco.com. Merkkijono voi sisältää enintään 39 merkkiä.

  • PHTMPLT - puhelinnumeromalli. Jokainen malli voi sisältää yhden tai useamman kuvion, jotka on erotettu pilkulla (,). Jokaisen kuvion alussa oleva valkoinen tila jätetään huomiotta. ”?” ja ”*” edustavat yleismerkkejä. Jos haluat esittää kirjaimellisesti, käytä %xx. Esimerkiksi %2a edustaa *. Malli voi sisältää enintään 39 merkkiä. Esimerkkejä: ”1408*, 1510*”, ”1408123???? , 555? 1.”.

  • Portti — TCP/UDP-portin numero (0—65535). Se voidaan määrittää desimaali- tai heksadesimuodossa.

  • ProvisioningRuleSyntax — komentosarjojen syntaksi, jota käytetään määritysten uudelleensynkronointi- ja laiteohjelmiston päivityssääntöjen määrittämiseen.

  • PWRLevel — Tehotaso, joka ilmaistaan dBm:inä yhdellä desimaalilla, kuten —13,5 tai 1,5 (dBm).

  • RSCTMPLT — SIP-vastaustilakoodin malli, kuten ”404, 5*”, ”61?” , ”407, 408, 487, 481”. Se voi sisältää jopa 39 merkkiä.

  • Sig <n>- Allekirjoitettu n-bittinen arvo. Se voidaan määrittää desimaali- tai heksadesimuodossa. ”-” -merkin on edeltävä negatiivisia arvoja. +-merkki ennen positiivisia arvoja on valinnainen.

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

  • Str <n>—Yleinen merkkijono, jossa on enintään n varaamatonta merkkiä.

  • A <n>ika —Ajan kesto sekunteina, enintään n desimaalin tarkkuudella. Ylimääräiset desimaalit jätetään huomiotta.

  • Tonescript—miniskripti, joka määrittää puhelun etenemisäänen taajuuden, tason ja poljinnopeusparametrit. Komentosarja voi sisältää enintään 127 merkkiä.

    Syntaksi: FreqScript; Z 1 [; Z 2].

    Osa Z 1 on samanlainen kuin CADscriptin S 1 -osa, paitsi että kutakin päälle/pois-segmenttiä seuraa taajuuskomponenttien parametri: Z 1 = D 1 (päällä i,1 /off i,1 /f i, 1 [, i,2/off i,2 /f i, 2 /f i, 2 [, päällä i,3 /off i, 3 /f i,3 [, päällä i, 4 /off i, 4 /f i, 4 /f /f i, 4 [, päällä i,5 /pois i ,5 /f i,5 [, päällä i ,6 /pois i ,6 /f i,6]]]]), jossa:

    • f i, j = n 1 [+n 2] +n 3 [+n 4 [+n 5 [+n 6]]]].

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

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

    Esimerkki 1 — Soittoääni:

    
    350@-19,440@-19;10(*/0/1+2)
    
    Number of Frequencies = 2
    Frequency 1 = 350 Hz at –19 dBm
    Frequency 2 = 440 Hz at –19 dBm
    Number of Cadence Sections = 1
    Cadence Section 1: Section Length = 10 s
    Number of Segments = 1
    Segment 1: On=forever, with Frequencies 1 and 2
    
    Total Tone Length = 10s
    
    

    Esimerkki 2 - Stutter-ääni:

    
    350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2)
    
    Number of Frequencies = 2
    Frequency 1 = 350 Hz at –19 dBm
    Frequency 2 = 440 Hz at –19 dBm
    Number of Cadence Sections = 2
    Cadence Section 1: Section Length = 2s
    Number of Segments = 1
    Segment 1: On=0.1s, Off=0.1s with Frequencies 1 and 2
    Cadence Section 2: Section Length = 10s
    Number of Segments = 1
    Segment 1: On=forever, with Frequencies 1 and 2
    
    Total Tone Length = 12s
    
    
  • Uns <n>—Merkitsemätön n-bittinen arvo, jossa n = 8, 16 tai 32. Se voidaan määrittää desimaali- tai heksadesimuodossa, kuten 12 tai 0x18, kunhan arvo mahtuu n bittiin.

Pidä nämä huomioon:

  • <Par Name>edustaa määritysparametrin nimeä. Profiilissa vastaava tunniste muodostetaan korvaamalla välilyönti alaviivulla ”_”, kuten Par _Name.
  • Tyhjä oletusarvokenttä merkitsee tyhjää merkkijonoa < ”” >.
  • Puhelin käyttää edelleen viimeisiä määritettyjä arvoja tunnisteille, joita ei ole tietyssä profiilissa.
  • Malleja verrataan annetussa järjestyksessä. Ensimmäinen, ei lähin, ottelu valitaan. Parametrin nimen on vastattava tarkasti.
  • Jos profiilissa annetaan useampi kuin yksi parametrin määritelmä, viimeinen tällainen määritelmä tiedostossa on se, joka tulee voimaan puhelimessa.
  • Parametrimääritys, jossa on tyhjä parametriarvo, pakottaa parametrin takaisin oletusarvoonsa. Jos haluat määrittää tyhjän merkkijonon sen sijaan, käytä tyhjää merkkijonoa ”” parametrin arvona.
Oliko tästä artikkelista apua?
Oliko tästä artikkelista apua?