- Etusivu
- /
- Artikkeli
Määritä 9800-sarjan ja 8875-puhelimien (BroadWorks) profiiliasetukset
Tämä ohjeartikkeli on tarkoitettu Cisco Desk Phone 9800 -sarjoille ja Cisco-videopuhelimelle 8875, jotka on rekisteröity numeroon Cisco BroadWorks. Tämän sivun tiedot sisältävät profiilin uudelleensynkronoinnin, profiilin manuaalisen käyttämisen ja määrityssyntaksin.
Määritä puhelimen profiilin uudelleensynkronointi
Synkronoi puhelinprofiili uudelleen TFTP
Puhelin tukee useita verkkoprotokollia määritysprofiilien noutamisessa. Perusprofiilin siirtoprotokolla on TFTP (RFC1350). TFTP on laajalti käytetty verkkolaitteiden valmisteluun yksityisissä LAN-verkoissa. Vaikka TFTP ei ole suositeltava etäpisteiden käyttöönotolle Internetissä, se voi olla kätevä käyttöönotolle pienissä organisaatioissa, talon sisäiselle esiasennukselle sekä kehitykselle ja testaukselle. Seuraavassa profiilia muokataan sen jälkeen, kun tiedosto on ladattu TFTP-palvelimesta.
| 1 |
Liitä tietokone ja puhelin LÄHI-ympäristössä keskittimään, kytkimeen tai pieneen reitittimeen. |
| 2 |
Asenna ja aktivoi TFTP-palvelin tietokoneessa. |
| 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ä:
|
| 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ä TFTP-asiakasta, joka ei ole puhelin. Käytä mieluiten TFTP-asiakasta, joka toimii valmistelupalvelimen erillisessä isännässä. |
| 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:
|
| 6 |
Valitse Puheposti Tab ja tarkasta yleisluont. parametrien arvot GPP_A GPP_P. Näiden pitäisi olla tyhjiä. |
| 7 |
Synkronoi testipuhelin uudelleen luomaasi määritysprofiiliin avaamalla uudelleensynkronointi-URL Web-selaimessa. Esimerkki: Jos TFTP-palvelimen IP-osoite on 192.168.1.200, komennon tulee olla samanlainen kuin seuraavassa esimerkissä:
Kun puhelin vastaanottaa tämän komennon, osoite 192.168.1.100 pyytää määritysprofiilitiedoston |
| 8 |
Varmista, että parametri on päivitetty oikein. Päivitä hallinnan Web-sivu ja siirry Voice GPP_A-parametrin tulee nyt sisältää arvo 12345678. |
Puhelinkohtaisen profiilin luominen TFTP-palvelimeen
| 1 |
Hae puhelimen MAC-osoite tuotteen etiketistä. (MAC-osoite on numero, jossa käytetään numeroita ja alanumeroita, esimerkiksi 000e08abbcc. |
| 2 |
Nimeä määritystiedosto uudelleen tiedostoksi Esimerkki:
|
| 3 |
Siirrä uusi tiedosto TFTP-palvelimen virtuaaliseen päähakemistoon. |
| 4 |
Siirry puhelimen hallintaverkkosivulle. |
| 5 |
Valitse . |
| 6 |
Kirjoita profiilitiedoston polku Profiilisääntö-kenttään . Esimerkki: Oletetaan, että TFTP-palvelimen IP-osoite on 192.168.1.200 ja profiilitiedoston nimi
|
| 7 |
Valitse Submit All Changes. Tämä aiheuttaa välittömän uudelleenkäynnistyksen ja uudelleensynkronin. Kun seuraava uudelleensynkronointi tapahtuu, puhelin noutaa uuden tiedoston palauttamalla $MA-makrolausekkeen MAC-osoitteeseensa. |
Synkronoi puhelinprofiili uudelleen HTTP GET -toiminnolla
| 1 |
Http-palvelimen asentaminen paikalliselle tietokoneelle tai muulle käytettävissä olevalle isännälle. Avoimen lähdekoodin Apache-palvelimen voi ladata Internetistä. |
| 2 |
Lataa määritysprofiilitiedosto asennetun palvelimen virtuaalipäähakemistoon. |
| 3 |
Voit tarkistaa palvelimen oikean asennuksen ja käyttää profiilitiedostoa avaamalla profiilin Web-selaimella. |
| 4 |
Muokkaa testipuhelimen Profile_Rule osoittaaksesi HTTP-palvelimeen TFTP-palvelimen sijasta, jotta voit ladata sen profiilin määräajoin. Jos esimerkiksi oletetaan, että HTTP-palvelin on numerossa 192.168.1.300 ja profiilin tiedostonimi on basic.txt, anna seuraava arvo:
|
| 5 |
Valitse Submit All Changes. Tämä aiheuttaa välittömän uudelleenkäynnistyksen ja uudelleensynkronin. |
| 6 |
Puhelimen lähettämien syslog-viestien todentaminen. Säännöllisten uudelleensynkronointien on nyt poistettava profiili HTTP-palvelimesta. |
| 7 |
Kirjoita HTTP-palvelinlokeissa tieto siitä, miten testipuhelimen tunnistetiedot näkyvät käyttäjäedustajien lokissa. Näihin tietoihin tulee sisältyä valmistaja, tuotteen nimi, nykyinen laitteisto-ohjelmistoversio ja sarjanumero. |
Synkronoi puhelinprofiili automaattisesti uudelleen
Laite voi synkronoida säännöllisesti uudelleen provisiointipalvelimeen varmistaakseen, että palvelimella tehdyt profiilimuutokset välittyvät päätelaitteeseen (sen sijaan, että lähettäisivät uudelleensynkronointipyynnön päätepisteeseen).
Jos haluat puhelimen ajoittaisen uudelleensynkronoinnin palvelimeen, määritysprofiilin URL määritetään Profile_Rule-parametrin avulla ja uudelleensynkronointijakso määritetään Resync_Periodic-parametrilla.
| 1 |
Siirry puhelimen hallintaverkkosivulle. |
| 2 |
Valitse . |
| 3 |
Määritä Profile_Rule-parametri. Tässä esimerkissä oletetaan TFTP-palvelin IP192.168.1.200-osoite. |
| 4 |
Anna Uudelleensynkronointijakso-kenttään pieni testauksen arvo, esimerkiksi 30 sekuntia. |
| 5 |
Valitse Lähetä kaikki muutokset. Uusien parametriasetusten avulla puhelin synkronoi kahdesti minuutissa URL-osoitteen määrittämään määritystiedostoon. |
| 6 |
Syslog-seurannan tuloksena olevien viestien jäljitys. |
| 7 |
Varmista, että Uudelleensynkronointi nollauksen aikana -kentässä on Kyllä.
|
| 8 |
Puhelimen virransiirto pakottaa sen uudelleensynkronointiin provisiointipalvelimeen. Jos uudelleensynkronointitoiminto epäonnistuu jostain syystä, kuten jos palvelin ei vastaa, yksikkö odottaa (uudelleensynkronointivirheen uudelleen muodostamisen viiveessä määritettyjen sekuntien määrää), ennen kuin se yrittää uudelleensynkronoida. Jos uudelleensynkronointivirheen uudelleen muodostamisen viive on nolla, puhelin ei yritä synkronoida uudelleen epäonnistuneen uudelleensynkronointiyrityksen jälkeen. |
| 9 |
(Valinnainen) Määritä Uudelleensynkronointivirheen uudelleenyritysviive -kentän arvoksi pieni luku, esimerkiksi 30.
|
| 10 |
Poista TFTP-palvelin käytöstä ja tarkista syslog-tulosteen tulokset. |
Profiilin uudelleensynkronointiparametrit
Seuraavassa taulukossa on määritetty Puhelimen Web-sivun Puheposti> ProvisioningTab -kohdan Määritysprofiili-osan toiminta ja käyttö. Se määrittää myös puhelimen määritystiedostoon (cfg.XML) lisätyn merkkijonon syntaksin, jossa on XML-koodi parametrin määrittämiseksi.
|
Parametri |
Kuvaus |
|---|---|
|
Valmistelu käytössä |
Sallii tai hylkää määritysprofiilin uudelleensynkronointitoiminnot.
Oletusarvo: Kyllä |
|
Uudelleensynkronointi nollauksen aikana |
Määrittää, synkronoiko puhelin kokoonpanot uudelleen provisiointipalvelimen kanssa virran kytkemisen jälkeen ja jokaisen päivitysyrityksen jälkeen.
Oletusarvo: Kyllä |
|
Uud.synkronoinnin satunnaisviive |
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 arvo on 0–65535.
Oletusarvo on 2 (40 sekuntia). |
|
Synkronoi uudelleen (HHmm) |
Aika (HHmm), jonka puhelin synkronoituu uudelleen provisiointipalvelimen kanssa. Tämän kentän arvon on oltava nelinumeroinen luku, joka ilmaisee ajan HHmm-muodossa 0000 - 2400. Esimerkiksi 0959 tarkoittaa 09:59.
Oletusarvo on tyhjä. Jos arvo on virheellinen, parametri ohitetaan. Jos tälle parametrille on määritetty kelvollinen arvo, uudelleensynkronointijakson parametri ohitetaan. |
|
Uud.synkronoida random delay |
Estää provisiointipalvelimen ylilatauksen, kun suuri määrä laitteita käynnistyy yhtä aikaa. Jotta palvelimeen ei tulvisi uudelleensynkronointipyyntöjä useista puhelimista, puhelin synkronoituu uudelleen tuntien ja minuuttien välillä ja tunnit ja minuutit sekä satunnaisviiveen (hhmm, hhmm+random_delay). 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.
Kelvollinen arvo on 600–65535. Jos arvo on pienempi kuin 600, sisäinen satunnaisviive on 0–600. Oletusarvo on 600 sekuntia (10 minuuttia). |
|
Uud.synkronoinnin määräaikaisherätys |
Aikaväli provisiointipalvelimen kanssa ajoittaisen uudelleensynkronoinnin välillä. Liitetty uudelleensynkronoinnin ajastin on aktiivinen vasta, kun ensimmäinen onnistunut synkronointi palvelimen kanssa on onnistunut. Kelvolliset muodot ovat seuraavat:
Määritä tälle parametrille nolla, jotta säännöllinen uudelleensynkronointi voidaan poistaa käytöstä. Oletusarvo on 3600 sekuntia. |
|
Uudelleensynkronointivirheen uudelleenyritysten viive |
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:
Jos viiveen arvoksi on määritetty 0, laite ei yritä uudelleensynkronointiyritystä epäonnistuneen uudelleensynkronointiyrityksen jälkeen.
Oletus: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400 |
|
Pakotettu uudelleensynkronointiviive |
Puhelimen odottamien enimmäisviiveen (sekunteina) ennen uudelleensynkronoinnin suorittamista. Laite ei synkronoida uudelleen, kun yksi sen puhelinlinjoista on käytössä. Koska uudelleensynkronointi voi kestää useita sekunteja, on tarpeen odottaa, kunnes laite on ollut käyttämättömänä pitkään, ennen kuin se synkronoidaan uudelleen. Tällöin käyttäjä voi soittaa puheluita peräkkäin keskeytyksettä. Laitteessa on ajastin, joka alkaa laskea alas, kun kaikki sen linjat ovat käyttämätt. Tämä parametri on laskurin alkuarvo. Uudelleensynkronointitapahtumat ovat viivästettyjä, kunnes tämä laskurin arvo laskee nollaan. Kelvollinen arvo on 0–65535.
Oletusarvo on 14,400 sekuntia. |
|
Uudelleensynkronointi kohteesta SIP |
Hallitsee uudelleensynkronointitoimintojen pyyntöjä SIP NOTIFY -tapahtumalla, joka lähetetään palveluntarjoajan välityspalvelimesta puhelimeen. Jos välityspalvelin on otettu käyttöön, se voi pyytää uudelleensynkronointipyyntöä lähettämällä SIP NOTIFY -viestin, joka sisältää tapahtuman: synkronoi otsikko uudelleen laitteeseen.
Oletusarvo: Kyllä |
|
Synkronoi uudelleen päivitysyrityksen jälkeen |
Ottaa uudelleensynkronointitoiminnon käyttöön tai poistaa sen käytöstä päivityksen jälkeen. Jos Kyllä on valittu, synkronointi käynnistetään laitteisto-ohjelmiston päivityksen jälkeen.
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 -ilmoitus ohittaa nämä uudelleensynkronointi käynnistimet. Parametrit voidaan ohjelmoida makrolaajennusta käyttävällä, läpikäytetyllä ilmaisulla. Kelvollisia makrolaajennuksia on kohdassa Makron laajennusmuuttujat Valmistelu-parametreissa.
Oletus: tyhjä |
|
Käyttäjän määritettävä uudelleensynkronointi |
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.
Oletusarvo: Kyllä |
|
Uud.synkronoiminen epäonnistuu FNF:ssä |
Uudelleensynkronointi määritetään yleensä epäonnistuneeksi, jos pyydettyä profiilia ei vastaanoteta palvelimesta. Tämä parametri ohittaa tämän toiminnon. Kun asetukseksi on valittu Ei
Oletusarvo: Kyllä |
|
Profiilin todennustyyppi |
Määrittää profiilitilin todennuksessa käytettävät tunnistetiedot. Saatavilla olevat vaihtoehdot ovat:
Oletus: HTTP-perustodennus Lisätietoja on kohdassa Profiilin todennustyypin määrittäminen profiilin uudelleensynkronoimista varten -kohdassa. |
|
Profiilisääntö Profiilisääntö B Profiilisääntö C Profiilisääntö D |
Kukin profiilisääntö ilmoittaa puhelimesta lähteen, josta profiilin (määritystiedoston) hakeminen tulee. Jokaisen uudelleensynkronointitoiminnon aikana puhelin ottaa kaikki profiilit käyttöön järjestyksessä. Jos käytät määritystiedostoissa AES-256-CBC-salausta, määritä salausavain
Voit liittää salausavaimen lainausmerkein (") valinnaisesti.
Oletus: |
|
DHCP-asetus |
DHCP pilkuin eroteltuja asetuksia, joita käytetään laitteisto-ohjelmiston ja profiilien noutamiseen. Oletus: 66,160,159,150,60,43,125 |
|
Käytettävä DHCPv6-asetus |
DHCP pilkuin eroteltuja asetuksia, joita käytetään laitteisto-ohjelmiston ja profiilien noutamiseen. Oletus: 17,160,159 |
Provisiointi Cisco XML
Voit valmistella puhelimia Cisco XML-toiminnoilla.
Voit lähettää XML-objektin puhelimeen SIP Ilmoita -paketilla tai HTTP POST puhelimen CGI-käyttöliittymään: http://PhoneIPAddress/CGI/Execute.
CP-multiplex-3PCC laajentaa Cisco XML-ominaisuuden tukemaan provisiointia XML-objektin kautta:
<CP-multiplex-3PCCExsourceute> <ExsourceuteItem URL=Resync:[profiilisääntö]/> </CP-luokan-3PCCExpccExexpccute>
Kun puhelin vastaanottaa XML-objektin, se lataa valmistelutiedoston [profiilisäännöstä]. Tämä sääntö käyttää makroja XML-palvelusovelluksen kehittämisen helpottamiseen.
URL-resoluutio ja makrolaajennus
Alihakemistot, joilla on useita profiileja palvelimessa, ovat kätevä tapa hallita suurta määrää käyttöön otettuja laitteita. Profiilin URL voi sisältää:
-
Valmistelupalvelimen nimi tai pakollinen IP-osoite. Jos profiili määrittää provisiointipalvelimen nimeltä, puhelin suorittaa DNS-haun nimen selvittämiseksi.
-
Ei-vakiopalvelinportti, joka on määritetty URL-osoitteessa käyttämällä palvelimen nimeä seuraavaa vakiosyntaksi
:p orttia. -
Sen palvelimen virtuaalisen päähakemiston alihakemisto, jossa profiili on tallennettu. Se on määritetty käyttämällä vakio-URL-notaatiota ja jota hallitaan makrolaajennuksella.
Esimerkiksi seuraavat Profile_Rule pyytävät profiilitiedostoa ($PN.cfg) palvelimen alihakemistossa /Cisco/configTFTP-palvelimesta, jossa suoritetaan isäntää prov.telco.com kuuntelemassa portti 6900-porttiyhteyttä:
<Profile_Rule>
tftp://prov.telco.com:6900/cisco/config/$PN.cfg
</Profile_Rule>
Kunkin puhelimen profiili voidaan tunnistaa yleisluonteisessa parametrissa, jonka arvo on mainittu yleisessä profiilisäännössä makrolaajennuksen avulla.
Oletetaan esimerkiksi, että GPP_B on määritetty Nimellä Klo 6Lmp23Q.
Profile_Rule on arvo:
TFTP://prov.telco.com/cisco/$B/$MA.cfg
Kun laitteen uudelleensynkronoi ja makrot laajennetaan, puhelin, jonka MAC-osoite on 000e08012345 pyytää profiilia nimeltä, joka 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 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 . |
| 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 puhelinmäärityksissä XML-tiedostossa (cfg.XML) antamalla merkkijonon tässä muodossa:
Asetukset:
Oletus: HTTP-perustodennus |
| 4 |
Valitse Submit All Changes. |
Profiilin käyttäminen manuaalisesti puhelimessa
Lataa määritystiedosto puhelimeen TFTP-palvelimesta
Lataa määritystiedosto tietokoneen TFTP-palvelinsovellukseen näiden ohjeiden mukaisesti.
| 1 |
Liitä tietokone puhelimen LAN-porttiin. |
| 2 |
Suorita TFTP-palvelinsovellus tietokoneella ja varmista, että määritystiedosto on saatavilla TFTP-päähakemistossa. |
| 3 |
Anna Web-selaimessa puhelimen LAN IP -osoite, tietokoneen IP-osoite, tiedostonimi ja kirjautumisen tunnistetiedot. Käytä tätä muotoa:
Esimerkki:
|
Lataa määritystiedosto puhelimeen cURL-toiminnolla
Lataa määritykset puhelimeen cURL:lla seuraavasti. Tätä komentorivityökalua käytetään tietojen siirtämiseen URL-syntaksilla. Voit ladata cURL:n seuraavasti:
https://curl.haxx.se/download.html
Suosittelemme, ettet käytä cURL:a POST puhelimen määrityksiä, koska käyttäjänimi ja salasana saatetaan kaapata cURL:n käytön aikana.
| 1 |
Liitä tietokone puhelimen LAN-porttiin. |
| 2 |
Lataa määritystiedosto puhelimeen antamalla seuraava cURL-komento:
|
Profiilimääritysten viitetiedot
Puhelin hyväksyy XML -muodossa olevat kokoonpanot.
Tässä osassa olevissa esimerkeissä käytetään määritysprofiileja, joissa on XML-syntaksi.
Määritysprofiilin muodot
Määritysprofiili määrittää puhelimen parametrien arvot.
Määritysprofiilin XML-muodossa käytetään tavallisia XML-valmennustyökaluja parametrien ja arvojen kokoamiseen.
Kullakin puhelimella on eri toimintosarja ja siksi eri parametrisarja.
Avaa profiilin muoto
Avoin muotoprofiili on tekstitiedosto, jossa on XML-tyyppinen syntaksi elementtien hierarkiassa ja jossa on elementtimääritteitä ja -arvoja. Tämän muodon avulla voit luoda määritystiedoston vakiotyökaluilla. XML -määritystiedoston voi lähettää varaamispalvelimesta puhelimeen uudelleensynkronointitoiminnon aikana ilman kokoamista binääriobjektina.
Puhelin voi hyväksyä vakiotyökalujen luomia määritysmuotoja. Tämä toiminto helpottaa sellaisten back-end-provisiointipalvelinohjelmistojen kehittämistä, jotka luovat määritysprofiileja olemassa olevista tietokannoista.
Jotta määritysprofiilin luottamukselliset tiedot voidaan suojella, valmistelupalvelin toimittaa XML-määritystiedoston puhelimeen TLS suojaamalla kanavalla. Tiedosto voidaan valinnaisesti pakata gzip-tyhjennysalgoritmilla (RFC1951).
Tiedosto voidaan salata jollakin seuraavista salaustavoista:
-
AES-256-CBC-salaus
-
RFC-8188-pohjainen HTTP-sisällön salaus AES-128-GCM-salauksella
Määritystiedosto voi sisältää seuraavat osat:
-
Elementin tunnisteet
-
Määritteet
-
Parametrit
-
Toimintojen muotoileminen
-
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.
-
XML-valmistelumuoto ja Web-käyttöliittymä sallivat samojen asetusten määrittämisen. XML-tunnisteen nimet ja Web-käyttöliittymän kenttien nimet ovat samankaltaisia, mutta ne vaihtelevat XML-elementin nimirajoitusten vuoksi. Esimerkiksi XML-määritystiedoston alaviivoja ( _ ) Web-käyttöliittymän välilyöntien sijaan.
-
Puhelin tunnistaa osat, joilla on oikeat parametrien nimet ja jotka on kapseloitu erikoisprofiiliin
<flat-profiiliin>elementkiin. -
Elementtien nimet on suljettu kulmasulkeisiin.
-
Useimmat elementtien nimet ovat samankaltaisia puhelimen Web-käyttöliittymän kenttien nimien kanssa.
-
Elementtien nimet eivät saa sisältää 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>-osa edustaa Uudelleensynkronointi käynnistyy uudelleen -kenttää.
-
Kunkin elementin nimen on oltava yksilöivä. Puhelimen Web-käyttöliittymässä samat kentät voivat näkyä usealla Web-sivulla, esimerkiksi linja-, käyttäjä- ja alanumerosivuilla. Liitä
elementinnimiin sen merkiksi, mikä numero on sivulla Tab.Esimerkki: <Dial_Plan_1_>
elementi edustaa linjan 1 soittosuunnitelmaa .
-
-
Jokaisella avaavan elementin tunnisteella on oltava vastaava sulkemiselementin tunniste. 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> -
Elementtitunnisteet ovat kirjainkoon ja kirjaimen välillä.
-
Tyhjät elementin tunnisteet ovat sallittuja, ja ne tulkitaan siten, että arvo määritetään tyhjäksi. Anna alkuosatunniste, jossa ei ole vastaavaa elementtitunnistetta, ja Insert välilyöntiä ja eteen-vinoviivaa ennen sulkemiskulman hakasuljetta (>). Tässä esimerkissä profiilisääntö B on tyhjä:
<Profile_Rule_B/> -
Tyhjän elementin tunnisteen avulla voidaan estää käyttäjän toimittamien arvojen ylikytkeminen uudelleensynkronointitoiminnon aikana. Seuraavassa esimerkissä käyttäjän lyhytvalinta-asetukset eivät ole samat:
<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> -
Määritä vastaava parametri tyhjäksi merkkijonoksi käyttämällä tyhjää arvoa. Anna aukko- ja sulkemiselementti, jolla ei ole niiden välistä arvoa. Seuraavassa esimerkissä GPP_A-parametriksi on määritetty tyhjä merkkijono.
<profiili> <GPP_A> </GPP_A> </tasainen profiili> -
Tunnistamattomien elementtien nimet ohitetaan.
Parametrin ominaisuudet
Nämä ominaisuudet koskevat parametreja:
Kaikki parametrit, joita profiili ei ole määrittänyt, jäävät puhelimen käsiteltäväksi.
Tunnistamattomat parametrit ohitetaan.
Jos Avoimen muodon profiili sisältää useita saman parametritunnisteen esiintymiä, viimeisin tällainen tapahtuma ohittaa mitkään aikaisemmat. Jos haluat välttää parametrin määritysarvojen tahattoman ohituksen, suosittelemme, että kukin profiili määrittää suurimman osan parametrista.
Viimeisin käsitelty profiili on etusijalla. Jos sama määritysparametri on useassa profiilissa, jälkimmäisen profiilin arvo on etusijalla.
Merkkijonomuodot
Nämä ominaisuudet koskevat merkkijonojen muotoilua:
Kommentit sallitaan vakiosyntaksin XML kautta.
<!-- Kommentointi on kirjoitettu tähän -->Etu- ja jälkeen jäävä valkoinen tila on luettavuuden kannalta sallittu, mutta se poistetaan parametrin arvosta.
Arvon uudet linjat muunnetaan välilyönneiksi.
Muodon
XML-otsikko<? ?>on sallittu, mutta puhelin ohittaa sen.Anna erikoismerkkejä käyttämällä XML-perusmerkki karkureita seuraavassa taulukossa esitetyllä tavalla.
Erikoismerkki
XML-pakojärjestys
&ersand
& Ei vielä
< (pienempi kuin)
<
> (suurempi kuin)
>
' (heittomerkki)
'
" (lainausmerkki)
"
Seuraavassa esimerkissä annetaan merkkipainumia, jotka edustavat soittosuunnitelmasäännössä vaadittuja symboleja enemmän ja pienempiä. Tämä esimerkki määrittää kuuman linjan tietovalintasuunnitelman, joka määrittää <Dial_Plan_1_>-parametrin () 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.
(ja.) on käännetty.Puhelimen laitteisto-ohjelmisto tukee vain ASCII-merkkejä.
Avaa profiilin pakkaus
Tuettu pakkausmenetelmä on gzip-deflate-algoritmi (RFC1951). Samaa algoritmia (zlib) käyt. gzip-apuohjelma ja pakkauskirjasto ovat saatavilla Internet-sivustoilta.
Pakkausten tunnistamiseksi puhelin odottaa, että pakattu tiedosto sisältää gzip-yhteensopivan otsikon. Alkuperäisen Avoimen profiilin gzip-apuohjelman kutsuminen luo otsikon. Puhelin määrittää tiedostomuodon lataamalla tiedoston otsikolla.
Jos esimerkiksi profiili.XML on kelvollinen profiili, tiedosto profile.xml.gz myös hyväksytty. Jompikumpi seuraavista komennoista voi luoda tämän profiilityypin:
-
>gzip-profiili.XMLKorvaa alkuperäisen tiedoston pakatulla tiedostolla.
-
>kissaprofiili.XML | gzip-> profile.xml.gzJättää alkuperäisen tiedoston paikoilleen ja tuottaa uuden pakkaustiedoston.
Avaa profiilin salaus
Avoimen määritysprofiilin salaukseen voidaan käyttää symmetristä avaimen salausta, olipa tiedosto sitten pakattu tai ei. Jos pakkausta käytetään, se on otettava käyttöön ennen salausta.
Valmistelupalvelin käyttää HTTPS:tä puhelimen alkuvalmistelyn käsittelyyn käyttöönoton jälkeen. Ennen määritysprofiilien salausta offline-tilassa voit käyttää HTTP-protokollaa profiilien synkronoinnissa uudelleen. Tämä vähentää HTTPS-palvelimen kuormitusta suurissa käyttöönotoissa.
Puhelin tukee kahta määritystiedostojen salausmenetelmää:
-
AES-256-CBC-salaus
-
RFC 8188 -pohjainen HTTP-sisällön salaus AES-128-GCM-salauksella
Näppäin- tai syöteavainmateriaalin (IKM) on oltava esisijoitettu laitteeseen jo aiemmin. Salaavaimen saappas voidaan toteuttaa turvallisesti HTTPS-protokollalla.
Määritystiedoston nimi ei vaadi tiettyä muotoa, mutta tiedostonimi, joka päättyy.cfg-alanumeroon , ilmaisee tavallisesti määritysprofiilin.
AES-256-CBC-salaus
Puhelin tukee AES-256-CBC-salausta määritystiedostoille.
OpenSSL-salaustyökalu, joka on ladattavissa eri Internet-sivustoilta, voi suorittaa salauksen. 256-bittisen AES -salauksen tuki saattaa edellyttää työkalun uudelleenyhtämistä, jotta AES-koodi voidaan ottaa käyttöön. Laitteisto-ohjelmistoa on testattu versiota vastaan opensl-1.1.1d.
Salatun tiedoston profiili odottaa, että tiedoston muoto on sama kuin seuraavan komennon luoma:
# esimerkin salausavain = SecretPhrase1234 avaa enc –e –aes-256-cbc –k SecretPhrase1234 –profiilissa.XML –out profile.cfg # analoginen kutsu pakattuun XML -tiedostoon avaa enc –e –aes-256-cbc –k SecretPhrase1234 – in profile.xml.gz –out profile.cfg
Pieni ruutu -k on ennen salaista avainta, joka voi olla mikä tahansa tavallinen tekstilause ja jota käytetään satunnaisen 64-bittisen suolan luomiseen. K-argumentin määrittämällä salauksella salaustyökalu johtaa 128-bittisen alkuvectorin ja varsinaisen 256-bittisen salausavaimen.
Kun tätä salausmuotoa käytetään määritysprofiilissa, puhelimesta on ilmoitettava salausavaimen arvosta, jotta tiedoston salaus voidaan poistaa. Tämä arvo määritetään profiilin URL:n määritysten poistoksi. Syntaksi on seuraava:
[-avain "SecretPhrase1234"] http://prov.telco.com/path/profile.cfg
Arvo on ohjelmoitu käyttämällä jotakin Profile_Rule parametria.
Usealle valmisteluparametrille tehdään makrolaajennus sisäisesti ennen arviointia. Tämä esiarvostusvaihe lisää joustavuutta puhelimen uudelleensynkronointi- ja päivitystoimintojen hallinnassa.
Näihin parametriryhmiin tehdään makrolaajennus ennen 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ö korvaa muodon $NAME ja $(NAME) lausekkeet. Näitä muuttujia ovat yleisluoniset parametrit, useat tuotetunnisteet, tietyt tapahtumien ajastimet ja valmistelutilan arvot. Kattava luettelo on kohdassa Makrolaajennusmuuttujat Valmistelu-parametreissa.
Seuraavassa esimerkissä käytetään lauseketta $(MAU) Insert MAC-osoite 000E08012345.
Järjestelmänvalvoja antaa: $(MAU)config.cfg
Tuloksena oleva makrolaajennus laitteelle, jolla on MAC-osoite 000E08012345 on: 000E08012345config.cfg
Jos makron nimeä ei tunnisteta, sitä ei kirjata. Esimerkiksi STRANGE-nimeä ei tunnusteta kelvollisena makronimenä, kun taas MAU tunnustetaan kelvollisena makronimenä.
Järjestelmänvalvoja syöttää: $STRANGE$MAU.cfg
Tuloksena oleva makrolaajennus laitteelle, jolla on MAC-osoite 000E08012345 on: $STRANGE 000E08012345.cfg
Makrolaajennusta ei käytetä uudelleen. Esimerkiksi $$MAU" kasvaa $MAU" ($$ on laajennettu), eikä johda MAC-osoitteeseen.
Erityisparametrien sisältö GPP_SA läpi GPP_SD kartoitetaan makroilmaisuihin, jotka $SA $SD. Nämä parametrit ovat vain makroa, joka on laajennettu uudelleensynkronointi-URL-avaimen -, --uid- ja-pwd-vaihtoehtojen argumenttina.
Synkroniset lausekkeet voivat käynnistää uudelleensynkronointitapahtumia ja valita vaihtoehtoisista URL-osoitteista uudelleensynkronointi- ja päivitystoimintoja varten.
Ylistysilmaisut koostuvat vertailuluettelosta, jonka käyttäjä ja operaattori erottavat toisistaan. Kaikkien vertailujen on oltava tyytyväisiä, jotta ehto on tosi.
Jokainen vertailu voi liittyä joseen seuraavista kolmesta kirjaimesta:
-
Kokonaislukuarvot
-
Ohjelmisto- tai laitteistoversionumerot
-
Kaksinkertainen lainausmerkkijono
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 on käytettävä samaa muotoa. Muussa tapauksessa jäsennysvirheen muoto.
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
Lainausmerkkejä voidaan verrata tasa-arvoon tai eriarvoisuuteen. Kokonaislukuja ja versionumeroita voidaan myös verrata aritmeettisesti. Vertailun operaattorit voidaan ilmaista symboleina tai lyhenteinä. Lyhenteet ovat käteviä avoimen muodon profiilin ehdon ilmaisemiseen.
|
Operaattori |
Vaihtoehtoinen syntaksi |
Kuvaus |
Koskee kokonaislukua ja versiooopperaa |
Koskee lainausmerkkijonon oopperaa |
|---|---|---|---|---|
|
= |
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ää liittää makromuuttujat lainausmerkeihin, joissa odotetaan merkkijonoa kirjaimellinen. Älä tee sitä, jos odotat numeroa tai versionumeroa.
Kun sitä käytetään Profile_Rule* ja Upgrade_Rule-parametrien yhteydessä, poistoilmaisut on suljettava syntaksin "(expr)?" sisään, kuten tässä päivityssääntö esimerkissä. 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ä määritä Resync_Trigger_* -parametreja käyttämällä edellistä syntaksia sulkeiden kanssa.
Käytä Vakio-URL-syntaksia määrittääksesi, miten noudetaan määritystiedostoja ja laitteisto-ohjelmistolatauksia Profile_Rule* ja Upgrade_Rule parametreissa. Syntaksi on seuraava:
[scheme://] [ palvelin [:p ort]] tiedostopolku
Jos järjestelmä on jokin näistä arvoista:
-
TFTP
-
http
-
https
Jos mallia ei ole, oletetaan TFTP. Palvelin voi olla DNS-hyväksytty isäntänimi tai numeerinen IP-osoite. Portti on kohdenumero UDP tai TCP portin numero. Filepathin on alettava päähakemistosta (/); Sen täytyy olla absoluuttinen polku.
Jos palvelin puuttuu, käytetään TFTP-palvelinta, joka on määritetty DHCP -asetuksen (asetus 66) kautta.
Palvelin on määritettävä päivityssäännöille.
Jos portti puuttuu, käytetään määritetyn järjestelmän vakioporttia. TFTP käyttää UDP-porttia 69, http käyttää TCP -porttia 80, https käyttää TCP-porttia 443.
Tiedostopolku täytyy olla olemassa. Sen ei välttämättä tarvitse viitata staattiseen tiedostoon, vaan se voi viitata CGI:n kautta saatuun dynaamiseen sisältöön.
Makrolaajennus on käytössä URL-osoitteissa. Seuraavassa on kelvollisia URL-osoitteita:
/$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össä on DHCP-asetus 66, päivityssäännöt eivät tue tyhjää syntaksia. Se on käytettävissä vain profiilisäännölle*.
RFC 8188 -pohjainen HTTP-sisällön salaus
Puhelin tukee RFC 8188 -pohjaista HTTP-sisällön salausta AES-128-GCM-salakirjoitusta määritystiedostoja varten. Tällä salausmenetelmällä kuka tahansa taho voi lukea HTTP-viestin otsikot. Kuitenkin vain ne yhteisöt, jotka tietävät syöteavainmateriaalin (IKM), voivat lukea kuorman. Kun puhelin on varustettu IKM-palvelimella, puhelin ja valmistelupalvelin voivat vaihtaa määritystiedostoja turvallisesti ja sallia samalla kolmansien osapuolten verkkoelementtien käyttää viestiotsikoita analyyttisiin ja seurantatarkoituksiin.
XML-määritysparametrin IKM_HTTP_Encrypt_Content pitää IKM-parametrin puhelimessa. Suojaussyistä tätä parametria ei voi käyttää puhelimen hallinnan Web-sivulla. Se ei myöskään näy puhelimen määritystiedostossa, jota voit käyttää puhelimen IP-osoitteessa tai provisiointipalvelimelle lähetetyissä puhelimen määritysraporteissa.
Jos haluat käyttää RFC 8188 -pohjaista salausta, varmista seuraavat:
-
Provisioi puhelimen IKM-parametrin määrittämällä IKM-parametrin XML-parametrin
IKM_HTTP_Encrypt_Contentmääritystiedostossa, joka lähetetään provisiointipalvelimesta 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
.Jos tätä otsikkoa ei ole, AES-256-CBC-menetelmä annetaan etusijalle. Puhelin ottaa käyttöön AES-256-CBC-salauksen purkamisen, jos profiilisäännössä on AES-256-CBC-avain IKM-määrityksestä riippumatta.
-
Jos haluat puhelimen lisäävan tämän salauksen valmistelupalvelimelle lähettämiinsä määritysraportteihin, varmista, ettei raporttisäännössä ole määritettynä 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.
- avain-asetus kertoo puhelimelle, että sen provisiointipalvelimelta vastaanottama määritystiedosto on salattu AES-256-CBC-salauksella, ellei tiedoston sisällönkoodausotsikko osoita aes128gcm
Salaus. Itse näppäin määritetään merkkijonoksi termi-avaimen jälkeen. Näppäin voidaan sulkea lainausmerkein ("). Puhelin käyttää näppäintä määritystiedoston salauksen purkamiseen.
Käyttöesimerkit
[-avain VerySecretValue] [-avain "minun salainen lauseeni"] [-avain a37d2fb9055c1d04883a0745eb0917a4]
Sulkeissa olevat valinnaiset argumentit ovat makrolaajennettu. Erityisparametrit, GPP_SA kautta GPP_SD, ovat makrolaajennetaan makromuuttujiksi, $SA $SD vain, kun niitä käytetään avainvaihtoehtoina. Katso nämä esimerkit:
[-avain $SC] [-avain "$SD"]
Avoimessa muotoprofiileissa avaimen argumentin pitää olla sama kuin opensl-asetukselle annetun k-vaihtoehdon argumentti.
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. Sulkeissa olevat valinnaiset argumentit ovat makrolaajennettu. Erityisparametrit, GPP_SA kautta GPP_SD, ovat makrolaajennetaan makromuuttujiksi, $SA $SD vain, kun niitä käytetään avainvaihtoehtoina. 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
Laajennetaan sitten:
[-uid MyUserID --pwdMySecretPassword] https://provisioning_server_url/path_to_your_config/your_config.xml
Tietotyypit
Näitä tietotyyppejä käytetään määritysprofiiliparametrien kanssa:
-
{a,b,c,...}–Valinta a, b, c, ...
-
Bool – Boolean-arvo, joko Kyllä tai Ei.
-
CadScript – Miniscript, joka määrittää signaalin poljinnopeusparametrit. 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 se tunnetaan osiona.
-
I,j ja offi,j ovat segmentin on/off-kesto sekunteina. I = 1 tai 2 ja j = 1-6.
-
Di on osan kokonaiskesto sekunteina.
Kaikissa kestoissa voi olla enintään kolme desimaalia, jotta 1 ms-resoluutio voidaan antaa. Yleismerkki "*" tarkoittaa ääretöntä kestoa. Osion segmentit toistetaan järjestyksessä ja toistetaan, kunnes kokonaiskesto on tois.
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 = 60sEsimerkki 2 – Lyhennyssoittoääni (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 – Komentosarjan syntaksi, jota käytetään määritettäessä linja 1- ja linja 2 -soittosuunnitelmia.
-
Float<n> – Leijumispistearvo, jossa on enintään n desimaalia.
-
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 – Miniscript, joka määrittää äänen taajuus- ja tasoparametrit. Sisältää enintään 127 merkkiä.
Syntaksi: F1@L1[,F2@L2[,F3@L3[,F4@L4[,F5@L5[,F6@L6]]]]], missä:
-
F1–F6 on taajuus Hz:nä (vain allekirjoittamattomia kokonaislukuja).
-
L1–L6 on dBm:n vastaavia tasoja (enintään yksi desimaali).
Välilyönnit ennen pilkkua ja sen jälkeen ovat sallittuja, mutta niitä ei suositella.
Esimerkki 1 – Puhelu odottaa -ääni:
440@-10 Taajuudet = 1 taajuus 1 = 440 Hz taajuudessa –10 dBmEsimerkki 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.
-
Käyttäjätunnus – Käyttäjä ID siinä muodossa, jossa se näkyy URL-osoitteessa; enintään 63 merkkiä.
-
Puhelin – puhelinnumeron merkkijono, kuten 14081234567, *69, *72, 345678; tai yleinen URL, 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 usean pilkulla eroteltua mallia (,). Kunkin mallin alussa oleva välilyönti ohitetaan. "?" ja "*" edustavat yleismerkkejä. Edusta kirjaimellisesti painamalla %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 heksamuodossa.
-
ProvisioningRuleSyntax – Komentosarjan syntaksi, jota käytetään määritysten uudelleensynkronointi- ja laitteisto-ohjelmiston päivityssääntöjen määrittämiseen.
-
PwrLevel – Tehotaso dBm:nä esitettynä yhdellä desimaalilla, kuten –13,5 tai 1,5 (dBm).
-
RscTmplt – Malli SIP Vastaustilakoodi, kuten "404, 5*", "61?", "407, 408, 487, 481". Se voi sisältää enintään 39 merkkiä.
-
Sig<n> – Allekirjoitettu n-bitin arvo. Se voidaan määrittää desimaali- tai heksamuodossa. -merkin on oltava negatiivisten arvojen edellä. Myönteisten arvojen edessä oleva +-merkki on valinnainen.
-
Tähtikoodit – lisäpalvelun aktivointikoodi, kuten *69. Koodi voi sisältää enintään 7 merkkiä.
-
Riipus<n> – yleinen merkkijono, jossa on enintään n korvaamatonta merkkiä.
-
Aika<nn> — Kesto sekunteina ja enintään n desimaalia. Määritetyt lisädesimaalit ohitetaan.
-
ToneScript – Miniscript, joka määrittää puhelun edistymisäänen taajuus-, taso- ja poljinnopeusparametrit. Komentosarja voi sisältää enintään 127 merkkiä.
Syntaksi: FreqScript; Z1[; Z2].
Jakso Z1 on samanlainen kuin CadScriptin S1 -osa, paitsi että jokaista on/off-segmenttiä seuraa taajuusosien 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]]]]]), joissa:
-
fi,j = n1[+n2]+n3[+n4[+n5[+n6]]]]].
-
1 < nk < 6 määrittää freqscriptin taajuuskomponentit, joita käytetään kyseisessä segmentissä.
Jos segmentissä käytetään useampaa kuin yhtä taajuusosaa, komponentit lasketaan yhteen 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 = 10sEsimerkki 2 – Katkonainen ää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.
Pidä nämä tarkastelussa:
- <Par Name> edustaa määritysparametrin nimeä. Profiilissa vastaava tunniste muodostuu korvaamalla välilyönti alaviivalla "_", kuten Par_Name.
- Tyhjä oletusarvoinen kenttä, joka ilmaisee tyhjän merkkijonon < "" >.
- Puhelin käyttää edelleen viimeisimpiä määritettyjä arvoja tunnisteille, joita tietyssä profiilissa ei ole.
- Malleja verrataan annettuun järjestykseen. Ensimmäinen, ei lähin, ottelu valitaan. Parametrin nimen on täsmättävä täsmälleen.
- Jos profiiliin on annettu useita parametrien määrityksiä, viimeisin tällainen määritys tiedostossa on se, joka tulee voimaan puhelimessa.
- Tyhjällä parametriarvolla määritetty parametri pakottaa parametrin takaisin oletusarvoonsa. Määritä sen sijaan tyhjä merkkijono parametrin arvoksi tyhjällä merkkijonolla ".