Konfigurer profilindstillinger for 9800-serien og 8875-telefoner (BroadWorks)

Konfigurer din telefon til profilsynkronisering

Synkroniser telefonprofilen igen via TFTP

Telefonen understøtter flere netværksprotokoller til hentning af konfigurationsprofiler. Den mest basale profiloverførselsprotokol er TFTP (RFC1350). TFTP bruges i vid udstrækning til levering af netværksenheder inden for private LAN-netværk. Selvom det ikke anbefales til udrulning af eksterne slutpunkter på internettet, kan TFTP være praktisk til implementering i små organisationer, til intern præprovisionering og til udvikling og test. I den følgende procedure ændres en profil efter download af en fil fra en TFTP-server.

1	Inden for et LAN-miljø skal du forbinde din computer og telefonen til en hub, switch eller lille router.
2	På computeren skal du installere og aktivere en TFTP-server.
3	Brug en teksteditor til at oprette en konfigurationsprofil. Hvis du vil kontrollere, om profilen er blevet klargjort til din telefon senere, kan du angive nogle af værdierne som mærker. Indstil f.eks. værdien for GPP_A til 12345678 som vist i følgende eksempel: `<flat-profile>  <GPP_A> 12345678  </GPP_A> </flat-profile>`
4	Gem XML-konfigurationsfilen i rodmappen på TFTP-serveren. Du kan kontrollere, at TFTP-serveren er korrekt konfigureret: anmode om konfigurationsprofilfilen ved hjælp af en anden TFTP-klient end telefonen. Brug helst en TFTP-klient, der kører på en separat vært fra klargøringsserveren.
5	Åbn administrationswebsiden i webbrowseren på din computer. Antag for eksempel, at telefonens IP-adresse er 192.168.1.100, åbn følgende URL i din webbrowser: `http://192.168.1.100/admin/advanced`
6	Vælg fanen Voice > Provisioning, og kontroller værdierne for de generelle parametre GPP_A til GPP_P. Disse skal være tomme.
7	Synkroniser testtelefonen igen til den konfigurationsprofil, du oprettede, ved at åbne resync-URL-adressen i en webbrowser. Eksempel: Hvis IP-adressen på TFTP-serveren er 192.168.1.200, skal kommandoen svare til følgende eksempel: `http://192.168.1.100/admin/resync?tftp://192.168.1.200/basic.txt` Når telefonen modtager denne kommando, anmoder enheden på adressen 192.168.1.100 om konfigurationsprofilfilen `basic.txt` fra TFTP-serveren på IP-adresse 192.168.1.200. Telefonen analyserer derefter den downloadede fil og opdaterer GPP_A-parameteren med værdien 12345678.
8	Kontroller, at parameteren blev opdateret korrekt. Opdater administrationswebsiden, og gå til Voice > Provisioning. Parameteren GPP_A skal nu indeholde værdien 12345678.

Oprette en telefonspecifik profil på en TFTP-server

1	Få telefonens MAC-adresse fra produktetiketten. (MAC-adressen er tallet ved hjælp af tal og små hex-cifre, f.eks. 000e08aabbcc.
2	Omdøb din konfigurationsfil til `CP-xxxx macaddress.cfg` (erstatte `xxxx` med modelnummeret og `macaddress med telefonens MAC` -adresse). Eksempel: `CP-8875 000e08aabbcc.cfg`
3	Flyt den nye fil til den virtuelle rodmappe på TFTP-serveren.
4	Få adgang til telefonadministrationswebsiden.
5	Vælg Stemme > Til veje bringelse.
6	Indtast stien til profilfilen i feltet Profilregel. Eksempel: Antag, at TFTP-serverens IP-adresse er 192.168.1.200, og profilfilnavnet er `<Profile_Rule> tftp://192.168.1.200/CP-8875$MA.cfg </Profile_Rule>`
7	Klik på Send alle ændringer. Dette medfører en øjeblikkelig genstart og gensynkronisering. Når den næste gensynkronisering finder sted, henter telefonen den nye fil ved at udvide $MA-makroudtrykket til sin MAC-adresse.

Synkroniser telefonprofilen igen med HTTP GET

1	Installer en HTTP-server på den lokale computer eller en anden tilgængelig vært. Open source Apache-serveren kan downloades fra internettet.
2	Upload konfigurationsprofilfilen til den virtuelle rodmappe på den installerede server.
3	For at kontrollere korrekt serverinstallation og adgang til profilfilen skal du åbne profilen med en webbrowser.
4	Rediger testtelefonens Profile_Rule for at pege på HTTP-serveren i stedet for TFTP-serveren for at downloade dens profil med jævne mellemrum. Hvis du f.eks. antager, at HTTP-serveren er på 192.168.1.300, og profilfilnavnet er basic.txt, skal du indtaste følgende værdi: `<Profile_Rule> http://192.168.1.200/basic.txt </Profile_Rule>`
5	Klik på Send alle ændringer. Dette medfører en øjeblikkelig genstart og gensynkronisering.
6	Overhold de syslog-meddelelser, som telefonen sender. De periodiske gensynkroniseringer skal nu hente profilen fra HTTP-serveren.
7	I HTTP-serverlogfilerne skal du observere, hvordan oplysninger, der identificerer testtelefonen, vises i logfilen for brugeragenter. Disse oplysninger skal omfatte producenten, produktnavn, aktuelle firmwareversion og serienummer.

Synkroniser telefonprofilen automatisk

En enhed kan synkronisere med jævne mellemrum til klargøringsserveren for at sikre, at eventuelle profilændringer, der foretages på serveren, overføres til slutpunktsenheden (i modsætning til at sende en eksplicit anmodning om gensynkronisering til slutpunktet).

For at få telefonen til at synkronisere med en server med jævne mellemrum defineres en URL-adresse til konfigurationsprofil ved hjælp af parameteren Profile_Rule, og en resync-periode defineres ved hjælp af parameteren Resync_Periodic.

1	Få adgang til telefonadministrationswebsiden.
2	Vælg Stemme > Til veje bringelse.
3	Definer parameteren Profile_Rule. Dette eksempel antager en TFTP-server-IP-adresse på 192.168.1.200.
4	I feltet Synkroniser periodisk igen skal du angive en lille værdi til test, f.eks. 30 sekunder.
5	Klik på Send alle ændringer. Med de nye parameterindstillinger synkroniseres telefonen to gange om minuttet til den konfigurationsfil, som URL'en angiver.
6	Overhold de resulterende meddelelser i syslog-sporingen.
7	Sørg for, at feltet Synkroniser igen ved nulstilling er indstillet til Ja. `<Resync_On_Reset>Yes</Resync_On_Reset>`
8	Tænd for telefonen for at tvinge den til at synkronisere igen med klargøringsserveren. Hvis gensynkroniseringshandlingen mislykkes af en eller anden grund, f.eks. hvis serveren ikke reagerer, venter enheden (i det antal sekunder, der er konfigureret i Gensynkroniserings fejl Genforsøgsforsinkelse), før den forsøger at gen synkronisere igen. Hvis gen synkroniseringsfejl Genforsøgsforsinkelse er nul, forsøger telefonen ikke at gensynkronisere efter et mislykket gensynkroniseringsforsøg.
9	(Valgfrit) Indstil værdien i feltet Forsinkelse af forsøg igen på gen synkronisering til et lille tal, f.eks. 30. `<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>`
10	Deaktiver TFTP-serveren, og se resultaterne i syslog-output.

Parametre for gensynkronisering af profil

Følgende tabel definerer funktionen og brugen af profilgensynkroniseringsparametrene i afsnittet Konfigurationsprofil under fanen Tale > K largøring på telefonens webside. Det definerer også syntaksen for strengen, der tilføjes i telefonkonfigurationsfilen (cfg.xml) med XML-kode for at konfigurere en parameter.

Tabel 1. Parametre for gensynkronisering af profil
Parameter	Beskrivelse
Aktiver bestemmelse	Tillader eller nægter gensynkroniseringshandlinger for konfigurationsprofil. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<Provision_Enable ua="na">Ja</Provision_Enable>` På telefonens webside skal du angive dette felt til Ja for at tillade gensynkron iseringshandlinger eller Nej for at blokere gensynkroniseringshandlinger. Standard: Ja
Synkroniser igen ved nulstilling	Angiver, om telefonen gensynkroniserer konfigurationer med klargøringsserveren efter opstart og efter hvert opgraderingsforsøg. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<Resync_On_Reset ua="na">Ja</Resync_On_Reset>` På telefonens webside skal du angive dette felt til Ja for at tillade gensynkronisering ved opstart eller nulstilling eller Nej for at blokere gensynkronisering ved opstart eller nulstilling. Standard: Ja
Gensynkroniser tilfældig forsinkelse	Forhindrer overbelastning af klargøringsserveren, når et stort antal enheder tændes samtidigt og forsøger at konfigurere den første gang. Denne forsinkelse er kun effektiv ved det indledende konfigurationsforsøg, efter at enheden er tændt eller nulstillet. Parameteren er det maksimale tidsinterval, som enheden venter, før den kontakter klargøringsserveren. Den faktiske forsinkelse er et pseudo-tilfældigt tal mellem 0 og denne værdi. Denne parameter er i enheder på 20 sekunder. Den gyldige værdi ligger mellem 0 og 65535. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<Resync_Random_Delay ua="na">2</Resync_Random_Delay>` På telefonens webside skal du angive antallet af enheder (20 sekunder), som telefonen skal forsinke gensynkroniseringen efter opstart eller nulstilling. Standardværdien er 2 (40 sekunder).
Gensynkronisering ved (HHmm)	Det tidspunkt (HHmm), som telefonen synkroniserer igen med klargøringsserveren. Værdien for dette felt skal være et firecifret tal fra 0000 til 2400 for at angive klokkeslættet i HHmm-format. For eksempel angiver 0959 09:59. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>` På telefonens webside skal du angive tiden i HHMM-format for telefonen til at starte gensynkronisering. Standardværdien er tom. Hvis værdien er ugyldig, ignoreres parameteren. Hvis denne parameter er indstillet med en gyldig værdi, ignoreres parameteren Resync Perio dic.
Gensynkronisering ved tilfældig forsinkelse	Forhindrer overbelastning af klargøringsserveren, når et stort antal enheder tændes samtidigt. For at undgå oversvømmelse af anmodninger om gensynkronisering til serveren fra flere telefoner gensynkroniseres telefonen i intervallet mellem timer og minutter og timer og minutter plus den tilfældige forsinkelse (hhmm, hhmm+random_delay). For eksempel, hvis den tilfældige forsinkelse = (Resync At Random Delay + 30) /60 minutter, konverteres inputværdien i sekunder til minutter, afrundes til næste minut for at beregne det endelige random_delay interval. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>` På telefonens webside skal du angive tidsperioden i sekunder. Den gyldige værdi ligger mellem 600 og 65535. Hvis værdien er mindre end 600, er den tilfældige forsinkelse interne mellem 0 og 600. Standardværdien er 600 sekunder (10 minutter).
Periodisk gensynkronisering	Tidsintervallet mellem periodisk gensynkronisering med klargøringsserveren. Den tilknyttede resync-timer er kun aktiv efter den første vellykkede synkronisering med serveren. De gyldige formater er som følger: Et heltal Eksempel: Et input på `3000` angiver, at den næste gensynkronisering finder sted på 3000 sekunder. Flere heltal Eksempel: Et input på `600.1200.300` indikerer, at den første resync finder sted på 600 sekunder, den anden resync sker i 1200 sekunder efter den første, og den tredje resync sker i 300 sekunder efter den anden. Et tidsinterval Et eksempel angiver et input på `2400+30`, at den næste gensynkronisering finder sted mellem 2400 og 2430 sekunder efter en vellykket gensynkronisering. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<Resync_Periodic ua="na">3600</Resync_Periodic>` På telefonens webside skal du angive tidsperioden i sekunder. Indstil denne parameter til nul for at deaktivere periodisk resynkronisering. Standardværdien er 3600 sekunder.
Gensynkroniseringsfejl Forsinkelse for gentagelse	Hvis en gensynkronisering mislykkes, fordi telefonen ikke kunne hente en profil fra serveren, eller den downloadede fil er beskadiget, eller der opstår en intern fejl, forsøger telefonen at synkronisere igen efter en tid, der er angivet i sekunder. De gyldige formater er som følger: Et heltal Eksempel: Et input på `300` angiver, at det næste forsøg på gensynkronisering finder sted om 300 sekunder. Flere heltal Eksempel: Et input på `600,1200.300` angiver, at det første genforsøg finder sted 600 sekunder efter fejlen, det andet forsøg sker i 1200 sekunder efter fejlen i det første genforsøg, og det tredje genforsøg finder sted i 300 sekunder efter fejlen i det andet forsøg. Et tidsinterval Eksempel: Et input på `2400+30` angiver, at det næste forsøg igen finder sted mellem 2400 og 2430 sekunder efter en gensynkroniseringsfejl. Hvis forsinkelsen er indstillet til 0, forsøger enheden ikke at gensynkronisere igen efter et mislykket gensynkroniseringsforsøg. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<Resync_Error_Retry_Delay ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,8640.8640.86400</Resync_Error_Retry_Delay>` På telefonens webside skal du angive tidsperioden i sekunder. Standard: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400
Tvunget gensynkroniseringsforsinkelse	Maksimal forsinkelse (i sekunder), telefonen venter, før der udføres en gensynkronisering. Enheden synkroniseres ikke igen, mens en af dens telefonlinjer er aktiv. Da en gensynkronisering kan tage flere sekunder, er det ønskeligt at vente, indtil enheden har været inaktiv i en længere periode, før den gensynkroniseres. Dette giver en bruger mulighed for at foretage opkald i rækkefølge uden afbrydelse. Enheden har en timer, der begynder at tælle ned, når alle dens linjer bliver inaktive. Denne parameter er den oprindelige værdi af tælleren. Resync-hændelser forsinkes, indtil denne tæller falder til nul. Den gyldige værdi ligger mellem 0 og 65535. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>` På telefonens webside skal du angive tidsperioden i sekunder. Standardværdien er 14.400 sekunder.
Resync fra SIP	Styrer anmodninger om gensynkronisering via en SIP NOTIFY-hændelse, der sendes fra tjenesteudbyderens proxyserver til telefonen. Hvis dette er aktiveret, kan proxyen anmode om en gensynkronisering ved at sende en SIP NOTIFY-meddelelse, der indeholder Event: resync-overskriften til enheden. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<Resync_From_SIP ua="na">Ja</Resync_From_SIP>` På telefonens webside skal du vælge Ja for at aktivere denne funktion eller Nej for at deaktivere den. Standard: Ja
Synkroniser igen efter opgraderingsforsøg	Aktiverer eller deaktiverer gensynkroniseringshandlingen, når der er foretaget en opgradering. Hvis Ja er valgt, udløses synkronisering efter en firmwareopgradering. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<Resync_After_Upgrade_Attempt ua="na">Ja</Resync_After_Upgrade_Attempt>` På telefonens webside skal du vælge Ja for at udløse gensynkronisering efter en firmwareopgradering eller Nej for ikke at synkron isere igen. Standard: Ja
Gensynkronisering Trigger 1 Gensynkronisering Trigger 2	Hvis den logiske ligning i disse parametre evalueres til FALSE, udløses gensynkronisering ikke, selv når Resync On Reset er indstillet til TRUE. Kun resync via URL til direkte handling og SIP-notifikation ignorerer disse gensynkroniseringsudløsere. Parametrene kan programmeres med et betinget udtryk, der gennemgår makroudvidelse. For de gyldige makroudvidelser, se Makroudvidelses variabler under K largøringsparam etre. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<Resync_Trigger_1 ua="na">$ UPGTMR gt 300 og $ PRVTMR ge 600</Resync_Trigger_1>` `<Resync_Trigger_2 ua="na"/>` An@@ giv triggerne på telefonens webside. Standard: Tom
Brugerkonfigurerbar gensynkronisering	Tillader en bruger at synkronisere telefonen igen fra telefonens skærmmenu. Når den er indstillet til Ja, kan en bruger synkronisere telefonkonfigurationen igen ved at indtaste profilreglen fra telefonen. Når den er ind stillet til Nej, vises parameteren Profilregel ikke på telefonens skærmmenu. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<User_Configurable_Resync ua="na">Ja</User_Configurable_Resync>` På telefonens webside skal du vælge Ja for at vise parameteren Profilregel i telefonmenuen, eller vælg Nej for at skjule denne parameter. Standard: Ja
Resync mislykkes på FNF	En gensynkronisering betragtes typisk som mislykket, hvis en anmodet profil ikke modtages fra serveren. Denne parameter tilsidesætter denne adfærd. Når den er indstillet til Nej, accepterer enheden et `fil-unt-fund-` svar fra serveren som en vellykket gensynkronisering. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<Resync_Fails_On_FNF ua="na">Ja</Resync_Fails_On_FNF>` På telefonens webside skal du vælge Ja for at tage et `fil-ikke-fundet-svar som en mislykket gensynkronisering, eller vælg Nej for at tage et fil -ikke-fundet` svar som en vellykket gensynkronisering. Standard: Ja
Profilgodkendelsestype	Angiver de legitimationsoplysninger, der skal bruges til profilkontogodkendelse. De tilgængelige muligheder er: Deaktiver et: Deaktiverer profilkontofunktionen. Når denne funktion er deaktiveret, vises menuen Opsætning af profilkonto ikke på telefonskærmen. Grundlæggende HTTP-godkendelse: HTTP-loginoplysningerne bruges til at godkende profilkontoen. XSI-godkendelse: XSI-loginoplysninger eller XSI SIP-legitimationsoplysninger bruges til at godkende profilkontoen. Godkendelseslegitimationsoplysningerne afhænger af telefon ens XSI-godken delsestype: Når XSI-godkendelsestypen for telefonen er indstillet til Loginoplysninger, bruges XSI-loginoplysningerne. Når XSI-godkendelsestypen for telefonen er indstillet til SIP-legitimationsoplysninger, bruges XSI SIP-legitimationsoplysningerne. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<Profile_Authentication_Type ua="na">Grundlæggende Http-godkendelse</Profile_Authentication_Type>` På telefonens webside skal du vælge en indstilling på listen for telefonen for at godkende profilsynkronisering. Standard: Grundlæggende HTTP-godkendelse Du kan finde flere oplysninger under Angiv profilgodkendelsesty pen under Angiv telefonen til profilsynkronisering.
Profilregel Profilregel B Profilregel C Profilregel D	Hver profilregel informerer telefonen om en kilde, hvorfra en profil skal hentes (konfigurationsfil). Under hver gensynkronisering anvender telefonen alle profilerne i rækkefølge. `Hvis du anvender AES-256-CBC-kryptering på konfigurationsfilerne, skal du angive krypteringsnøglen med nøgleordet --key som følger:` `[--nøgle]` <encryption key> Du kan indsætte krypteringsnøglen med dobbelte anførselstegn („) valgfrit. I telefonkonfigurationsfilen (cfg.xml) med XML skal du indtaste en streng i dette format: `<Profile_Rule ua="na">/$psn.xml</Profile_Rule>` `<Profile_Rule_B ua="na"/>` `<Profile_Rule_C ua="na"/>` `<Profile_Rule_D ua="na"/>` An@@ giv profilreglen på telefonens webside. Standard: `/$psn.xml`
DHCP-mulighed, der skal bruges	DHCP-indstillinger, afgrænset af kommaer, bruges til at hente firmware og profiler. Standard: 66,160,159,150,60,43,125
DHCPv6 Mulighed at bruge	DHCP-indstillinger, afgrænset af kommaer, bruges til at hente firmware og profiler. Standard: 17,160,159

Tilvejebringelse via Cisco XML

Du kan levere telefoner via Cisco XML-funktioner.

Du kan sende et XML-objekt til telefonen via en SIP Notificy-pakke eller en HTTP-post til telefonens CGI-grænseflade: http://PhoneIPAddress/CGI/Execute.

CP-xxxx-3PCC udvider Cisco XML-funktionen til at understøtte klargøring via et XML-objekt:


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

Når telefonen har modtaget XML-objektet, downloader den klargøringsfilen fra [profilregel]. Denne regel bruger makroer til at forenkle udviklingen af XML-tjenesteprogrammet.

URL-opløsning med makroudvidelse

Undermapper med flere profiler på serveren giver en bekvem metode til styring af et stort antal implementerede enheder. Profilens URL kan indeholde:

Et klargøringsservernavn eller en eksplicit IP-adresse. Hvis profilen identificerer klargøringsserveren ved navn, udfører telefonen et DNS-opslag for at løse navnet.
En ikke-standard serverport, der er angivet i URL-adressen ved hjælp af standardsyntax:port efter servernavnet.
Undermappen til serverens virtuelle rodmappe, hvor profilen er gemt, angivet ved hjælp af standard URL-notation og administreret af makroudvidelse.

Følgende Profil_Rule anmoder f.eks. om profilfilen ($PN.cfg) i serverundermappen /cisco/config fra den TFTP-server, der kører på host prov.telco .com, og lytter efter en forbindelse på port 6900:


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

En profil for hver telefon kan identificeres i en generel parameter, med dens værdi henvist inden for en fælles profilregel ved hjælp af makroudvidelse.

Antag for eksempel, at GPP_B er defineret som Dj6Lmp23Q.

Profile_Rule har værdien:


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

Når enheden gensynkroniseres, og makroerne udvides, anmoder telefonen med en MAC-adresse på 000e08012345 om profilen med det navn, der indeholder enhedens MAC-adresse på følgende URL:


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

Angiv profilgodkendelsestypen

Profilgodkendelse giver telefonbrugere mulighed for at synkronisere klargøringsprofilen på telefonen igen. Der kræves godkendelsesoplysninger, mens telefonen forsøger at synkronisere og downloade konfigurationsfilen for første gang og får en HTTP- eller HTTPS 401-godkendelsesfejl. Når du aktiverer denne funktion, vises skærmbilledet Konfiguration af profilkonto på telefonen i følgende situationer:

Når HTTP- eller HTTPs 401-godkendelsesfejlen opstår under førstegangstildeling, efter at telefonen genstarter
Når brugernavnet og adgangskoden til profilkontoen er tomme
Når der ikke er noget brugernavn og adgangskode i profilreglen

Hvis skærmbilledet Opsætning af profilkonto misses eller ignoreres, kan brugeren også få adgang til opsætningsskærmen via telefonskærmmenuen eller programtasten Ops ætning, som kun vises, når der ikke er registreret nogen linje på telefonen.

Når du deaktiverer funktionen, vises skærmbilledet Konfiguration af profilkonto ikke på telefonen.

Brugernavnet og adgangskoden i feltet Profilregel har højere prioritet end profilkontoen.

Når du angiver en korrekt webadresse i feltet Profilregel uden brugernavn og adgangskode, kræver telefonen godkendelse eller sammendrag for at synkronisere profilen igen. Med den korrekte profilkonto passerer godkendelsen. Med en forkert profilkonto mislykkes godkendelsen.
Når du angiver en korrekt webadresse i feltet Profilregel med et korrekt brugernavn og adgangskode, kræver telefonen godkendelse eller sammendrag for at synkronisere profilen igen. Profilkontoen bruges ikke til telefonsynkronisering. Login er vellykket.
Når du angiver en korrekt webadresse i feltet Profilregel med et forkert brugernavn og en forkert adgangskode, kræver telefonen godkendelse eller sammenfatning for at synkronisere profilen igen. Profilkontoen bruges ikke til telefonsynkronisering. Login mislykkes altid.
Når du angiver en forkert webadresse i feltet Profilregel, mislykkes login altid.

Du kan også konfigurere parametrene i telefonkonfigurationsfilen med XML (cfg.xml) kode.

Du kan angive profilgodkendelsestypen fra telefonadministrationswebsiden.

1	Få adgang til telefonadministrationswebsiden.
2	Vælg Stemme > Til veje bringelse.
3	I afsnittet Konfigurationsprofil skal du angive parameteren Profilgodkendelsestype for at angive de legitimationsoplysninger, der skal bruges til profilkontogodkendelse. Du kan konfigurere denne parameter i telefonkonfigurationens XML-fil (cfg.xml) ved at indtaste en streng i dette format: `<Profile_Authentication_Type ua="na">Disabled</Profile_Authentication_Type>` Valgmuligheder: Deaktiver et: Deaktiverer profilkontofunktionen. Når denne funktion er deaktiveret, vises menuen Konfiguration af profilkonto ikke på telefonskærmen. Grundlæggende HTTP-godkendelse: HTTP-loginoplysningerne bruges til at godkende profilkontoen. XSI-godkendelse: XSI-loginoplysninger eller XSI SIP-legitimationsoplysninger bruges til at godkende profilkontoen. Godkendelseslegitimationsoplysningerne afhænger af telefonens XSI-godkendelsestype: Når XSI-godkendelsestypen for telefonen er indstillet til Loginoplysninger, bruges XSI-loginoplysningerne. Når XSI-godkendelsestypen for telefonen er indstillet til SIP-legitimationsoplysninger, bruges XSI SIP-legitimationsoplysningerne. Standard: Grundlæggende HTTP-godkendelse
4	Klik på Send alle ændringer.

Manuelt anvende en profil på din telefon

Download konfigurationsfilen til telefonen fra en TFTP-server

Udfør disse trin for at downloade konfigurationsfilen til et TFTP-serverprogram på din pc.

1	Tilslut din computer til LAN-porten på telefonen.
2	Kør et TFTP-serverprogram på computeren, og sørg for, at konfigurationsfilen er tilgængelig i TFTP-rodmappen.
3	I en webbrowser skal du indtaste telefonens LAN-IP-adresse, computerens IP-adresse, filnavnet og loginoplysningerne. Brug dette format: `http://<WAN_IP_Address>/admin/resync?tftp://<PC_IP_Address>/<file_name>&xuser=admin&xpassword=<password>` Eksempel: `http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin`

Download konfigurationsfilen til telefonen med cURL

Udfør disse trin for at downloade konfigurationen til telefonen ved hjælp af cURL. Dette kommandolinjeværktøj bruges til at overføre data med en URL-syntaks. For at downloade cURL skal du besøge:

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

Vi anbefaler, at du ikke bruger cURL til at sende konfigurationen til telefonen, fordi brugernavnet og adgangskoden muligvis bliver fanget, mens du bruger cURL.

1	Tilslut din computer til LAN-porten på telefonen.
2	Download konfigurationsfilen til telefonen ved at indtaste følgende cURL-kommando: `curl –d @my_config.xml “http://192.168.15.1/admin/config.xml&xuser=admin&xpassword=admin”`

Referencer til profilkonfiguration

Telefonen accepterer konfigurationer i XML-format.

Eksemplerne i dette afsnit bruger konfigurationsprofiler med XML-syntaks.

Konfigurationsprofilformater

Konfigurationsprofilen definerer parameterværdierne for telefonen.

Konfigurationsprofilens XML-format bruger standard XML-redigeringsværktøjer til at kompilere parametrene og værdierne.

Kun UTF-8-tegnsættet understøttes. Hvis du ændrer profilen i en editor, skal du ikke ændre kodningsformatet. Ellers kan telefonen ikke genkende filen.

Hver telefon har et andet funktionssæt og derfor et andet sæt parametre.

Åbn profilformat

Den åbne formatprofil er en tekstfil med XML-lignende syntaks i et hierarki af elementer, med elementattributter og værdier. Dette format giver dig mulighed for at bruge standardværktøjer til at oprette konfigurationsfilen. En XML-konfigurationsfil kan sendes fra klargøringsserveren til telefonen under en gensynkronisering uden kompilering som et binært objekt.

Telefonen kan acceptere konfigurationsformater, som standardværktøjer genererer. Denne funktion letter udviklingen af back-end-klargøringsserversoftware, der genererer konfigurationsprofiler fra eksisterende databaser.

For at beskytte fortrolige oplysninger i konfigurationsprofilen leverer klargøringsserveren XML-konfigurationsfilen til telefonen via en kanal, der er sikret af TLS. Eventuelt kan filen komprimeres ved hjælp af gzip deflate algoritmen (RFC1951).

Filen kan krypteres med en af disse krypteringsmetoder:

AES-256-CBC-kryptering
RFC-8188-baseret HTTP-indholdskryptering med AES-128-GCM-kryptering

En konfigurationsfil kan indeholde følgende komponenter:

Elementmærker
Attributter
Parametre
Formateringsfunktioner
XML kommentarer

Eksempel: Åbn profilformat


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

E <flat-profile>lementmærket omslutter alle parameterelementer, som telefonen genkender.

Egenskaber for elementmærke

Husk følgende regler, når du opretter eller opdaterer konfigurationsfilen.

XML-klargøringsformatet og webbrugergrænsefladen tillader konfiguration af de samme indstillinger. XML-mærkenavnene og feltnavnene i webbrugergrænsefladen ligner hinanden, men varierer på grund af begrænsninger i XML-elementnavne. For eksempel understregninger (_) i XML-konfigurationsfilen i stedet for mellemrum på webbrugergrænsefladen.

<flat-profile>Telefonen genkender elementer med korrekte parameternavne, der er indkapslet i det specielle element.

Elementnavne er omgivet af vinkelparenteser.

De fleste elementnavne ligner feltnavnene på telefonens webbrugergrænseflade med følgende ændringer:

Elementnavne må ikke indeholde mellemrum eller specialtegn. Hvis du vil udlede elementnavnet fra webfeltnavnet, skal du erstatte en understregning for hvert mellemrum eller specialtegnene [,], (,) eller/.

Eksempel: <Resync_On_Reset>Elementet repræsenterer feltet Gen synkronisering ved nulstilling.

Hvert elementnavn skal være unikt. I telefonens webbrugergrænseflade kan de samme felter vises på flere websider, f.eks. siderne Linje, Bruger og Udvidelse. Tilføj [n] til elementnavnet for at angive det nummer, der vises i sidefanen.

Eksempel: <Dial_Plan_1_>Elementet repræsenterer op kaldsplanen for linje 1.

Hvert åbningselementmærke skal have et matchende lukningselementmærke. For eksempel:

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

Elementtags skelner mellem store og små bogstaver.

Tomme elementmærker er tilladt og vil blive fortolket som at konfigurere værdien til at være tom. Indtast åbningselementmærket uden et tilsvarende elementmærke, og indsæt et mellemrum og en skråstreg foran den afsluttende vinkelparentes (>). I dette eksempel er profilregel B tom:

<Profile_Rule_B />

Et tomt elementmærke kan bruges til at forhindre overskrivning af eventuelle brugerleverede værdier under en gensynkronisering. I følgende eksempel er brugerens hurtigopkaldsindstillinger uændrede:

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

Brug en tom værdi til at indstille den tilsvarende parameter til en tom streng. Indtast et åbnings- og lukningselement uden nogen værdi mellem dem. I det følgende eksempel er parameteren GPP_A indstillet til en tom streng.

<flat-profile> <GPP_A> </GPP_A> </flat-profile>

Ikke-genkendte elementnavne ignoreres.

Parameteregenskaber

Disse egenskaber gælder for parametrene:
Eventuelle parametre, der ikke er angivet af en profil, forbliver uændrede i telefonen.
Ikke-genkendte parametre ignoreres.
Hvis profilen Åbent format indeholder flere forekomster af det samme parametertag, tilsidesætter den sidste sådan forekomst tidligere. For at undgå utilsigtet tilsidesættelse af konfigurationsværdier for en parameter anbefaler vi, at hver profil højst angiver én forekomst af en parameter.
Den sidst behandlede profil har forrang. Hvis flere profiler angiver den samme konfigurationsparameter, har værdien af sidstnævnte profil forrang.

Strengformater

Disse egenskaber gælder for formatering af strengene:
Kommentarer er tilladt via standard XML-syntaks.

Indledende og efterfølgende hvide mellemrum er tilladt for læsbarhed, men fjernes fra parameterværdien.
Nye linjer inden for en værdi konverteres til mellemrum.
En XML-header af formularen <? ? > er tilladt, men telefonen ignorerer det.
Hvis du vil indtaste specialtegn, skal du bruge grundlæggende XML-tegnescapes, som vist i nedenstående tabel.
Specialtegn
XML Escape-sekvens
& (ampersand)
&
< (mindre end)
<
> (større end)
>
'(apostrof)
'
“ (dobbelt citat)
„
I det følgende eksempel indtastes tegneskift for at repræsentere symbolerne for større end og mindre end, der kræves i en opkaldsplanregel. Dette eksempel definerer en opkaldsplan <Dial_Plan_1_>for informationsholine-opkaldsplan, der angiver parameteren (Admin Login > avanceret > Voice > Ext (n)) lig med (S0 <:18005551212>).
<flat-profile> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </flat-profile>
Numeriske tegnudgange ved hjælp af decimal- og hexadecimale værdier (s.a. (og.) oversættes.
Telefonens firmware understøtter kun ASCII-tegn.

Specialtegn	XML Escape-sekvens
& (ampersand)	&
< (mindre end)	<
> (større end)	>
'(apostrof)	'
“ (dobbelt citat)	„

Åbn profilkomprimering

Den understøttede komprimeringsmetode er gzip deflate algoritmen (RFC1951). Gzip-værktøjet og komprimeringsbiblioteket, der implementerer den samme algoritme (zlib), er tilgængelige fra internetsider.

For at identificere komprimering forventer telefonen, at den komprimerede fil indeholder en gzip-kompatibel header. Påkaldelse af gzip-værktøjet på den oprindelige Open-profil genererer overskriften. Telefonen inspicerer den downloadede filheader for at bestemme filformatet.

Hvis profile.xml f.eks. er en gyldig profil, accepteres filen profil.xml.g z også. En af følgende kommandoer kan generere denne profiltype:

> gzip profile.xml

Erstatter originalfil med komprimeret fil.

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

Efterlader originalfilen på plads og producerer ny komprimeret fil.

Åben profilkryptering

Symmetrisk nøglekryptering kan bruges til at kryptere en åben konfigurationsprofil, uanset om filen er komprimeret eller ej. Komprimering, hvis anvendt, skal anvendes før kryptering.

Klargøringsserveren bruger HTTPS til at håndtere den første klarering af telefonen efter installationen. Forkryptering af konfigurationsprofiler offline tillader brug af HTTP til gensynkronisering af profiler efterfølgende. Dette reducerer belastningen på HTTPS-serveren i store implementeringer.

Telefonen understøtter to metoder til kryptering til konfigurationsfiler:

AES-256-CBC-kryptering

RFC 8188-baseret HTTP-indholdskryptering med AES-128-GCM-kryptering

Nøglen eller Input Keying Material (IKM) skal være forudindstillet til enheden på et tidligere tidspunkt. Bootstrap af den hemmelige nøgle kan udføres sikkert ved hjælp af HTTPS.

Konfigurationsfilnavnet kræver ikke et bestemt format, men et filnavn, der slutter med filtypenavnet .cfg, angiver normalt en konfigurationsprofil.

AES-256-CBC-kryptering

Telefonen understøtter AES-256-CBC-kryptering til konfigurationsfiler.

OpenSSL-krypteringsværktøjet, der kan downloades fra forskellige internetsider, kan udføre krypteringen. Understøttelse af 256-bit AES-kryptering kan kræve genkompilering af værktøjet for at aktivere AES-koden. Firmwaren er blevet testet mod version openssl-1.1.1d.

For en krypteret fil forventer profilen, at filen har det samme format som genereret af følgende kommando:

# 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

Et lille bogstav -k går forud for den hemmelige nøgle, som kan være en hvilken som helst almindelig tekstsætning, og som bruges til at generere et tilfældigt 64-bit salt. Med den hemmelighed, der er angivet af argumentet -k, udleder krypteringsværktøjet en tilfældig 128-bit initialvektor og den faktiske 256-bit krypteringsnøgle.

Når denne form for kryptering bruges på en konfigurationsprofil, skal telefonen informeres om den hemmelige nøgleværdi for at dekryptere filen. Denne værdi er angivet som en kvalifikator i profilens URL-adresse. Syntaksen er som følger ved hjælp af en eksplicit URL:

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

Denne værdi programmeres ved hjælp af en af parametrene Profile_Rule.

Flere klargøringsparametre gennemgår makroudvidelse internt, inden de evalueres. Dette forhåndsvurderingstrin giver større fleksibilitet i styringen af telefonens gensynkronisering og opgraderingsaktiviteter.

Disse parametergrupper gennemgår makroudvidelse før evaluering:

Gensynkroniser_trigger_*

Profil_Regel*

Log_XXX_MSG

Opgradering_regel

Under visse betingelser gennemgår nogle generelle parametre (GPP_*) også makroudvidelse, som udtrykkeligt angivet i afsnittet Valg fri gensynkroniseringsargumenter nedenfor.

Under makroudvidelse erstatter indholdet af de navngivne variabler udtryk for formen $NAME og $ (NAME). Disse variabler omfatter generelle parametre, flere produktidentifikatorer, visse hændelsestimere og klargøringstilstandsværdier. For en komplet liste, se Makroudvidelsesvariabler under Klarg øringspar ametre.

I det følgende eksempel bruges udtrykket $ (MAU) til at indsætte MAC-adressen 000E08012345.

Administratoren indtaster: $ (MAU) config.cfg

Den resulterende makroudvidelse for en enhed med MAC-adresse 000E08012345 er: 000E08012345config.cfg

Hvis et makronavn ikke genkendes, forbliver det ikke udvidet. For eksempel genkendes navnet STRANGE ikke som et gyldigt makronavn, mens MAU genkendes som et gyldigt makronavn.

Administratoren indtaster: $strange$mau.cfg

Den resulterende makroudvidelse til en enhed med MAC-adresse 000E08012345 er: $ Strange000E08012345.cfg

Makroudvidelse anvendes ikke rekursivt. For eksempel udvides $$MAU“ til $MAU“ ($$ udvides) og resulterer ikke i MAC-adressen.

Indholdet af de særlige formålsparametre, GPP_SA til GPP_SD, er kortlagt til makroudtrykkene $SA til $SD. Disse parametre er kun makroudvidet som argumentet for indstillingerne --key, -- uid og -- pwd i en resync-URL.

Betingede udtryk kan udløse gensynkroniseringshændelser og vælge mellem alternative webadresser til gensynkronisering og opgradering.

Betingede udtryk består af en liste over sammenligninger, adskilt af oper atoren og. Alle sammenligninger skal være opfyldt for at betingelsen er sand.

Hver sammenligning kan vedrøre en af følgende tre typer bogstaver:

Heltalsværdier

Software- eller hardwareversionsnumre

Dobbeltciterede strenge

Versionsnumre

Softwareversionen til Cisco Video Phone 8875 bruger dette format (hvor BN er build-nummeret):

PHONEOS åååå. 1-0-1-0001 - DK

hvor yyyy angiver telefonmodellen eller telefonserien; 1 er hovedversionen; 0 er den mindre version; 1-0001 er mikroversionen; og BN er build-nummeret.

Sammenligningsstrengen skal bruge det samme format. Ellers opstår der en formatparseringsfejl.

Når man sammenligner softwareversionen, sammenlignes hovedversionen, den mindre version og mikroversionen i rækkefølge, og de venstre cifre har forrang frem for sidstnævnte. Når versionsnumre er identiske, sammenlignes build-nummeret.

Eksempler på gyldigt versionsnummer

PHONEOS-8875.1-0-1-0001-19

Sammenligning

Citerede strenge kan sammenlignes for lighed eller ulighed. Heltal og versionsnumre kan også sammenlignes aritmetisk. Sammenligningsoperatørerne kan udtrykkes som symboler eller som akronymer. Akronymer er praktiske til at udtrykke tilstanden i en profil i åbent format.

Operatør

Alternativ syntaks

Beskrivelse

Gælder for heltal- og versionsoperander

Gælder for citerede strengoperander

=

eq

lig med

Ja

Ja

!=

no

ikke lig med

Ja

Ja

<

lt

mindre end

Ja

Nej

<=

le

mindre end eller lig med

Ja

Nej

>

gt

større end

Ja

Nej

>=

ge

større end eller lig med

Ja

Nej

AND

og

Ja

Ja

Det er vigtigt at vedlægge makrovariabler i dobbelte anførselstegn, hvor der forventes en strengbogstavelig tekst. Gør det ikke, hvor der forventes et nummer eller et versionsnummer.

Når de bruges i sammenhæng med parametrene Profile_Rule* og Upgrade_Rule, skal betingede udtryk være indesluttet i syntaksen „(expr)?“ som i dette eksempel på opgraderingsregel. Husk at erstatte BN med build-nummeret på din firmwarebelastning, du skal opgradere til.

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

Brug ikke den foregående syntaks med parenteser til at konfigurere parametrene Resync_Trigger_*.

Operatør	Alternativ syntaks	Beskrivelse	Gælder for heltal- og versionsoperander	Gælder for citerede strengoperander
=	eq	lig med	Ja	Ja
!=	no	ikke lig med	Ja	Ja
<	lt	mindre end	Ja	Nej
<=	le	mindre end eller lig med	Ja	Nej
>	gt	større end	Ja	Nej
>=	ge	større end eller lig med	Ja	Nej
AND		og	Ja	Ja

Brug standard-URL-syntaksen til at angive, hvordan konfigurationsfiler og firmwareindlæsninger hentes i henholdsvis Profile_Rule* og Upgrade_Rule parametre. Syntaksen er som følger:

[skema://] [server [:port]] filsti

Hvor ordningen er en af disse værdier:

tftp

http

https

Hvis ordningen udelades, antages tftp. Serveren kan være et DNS-genkendt værtsnavn eller en numerisk IP-adresse. Porten er destinationens UDP- eller TCP-portnummer. Filvejen skal begynde med rodmappen (/); det skal være en absolut sti.

Hvis serveren mangler, anvendes den tftp-server, der er angivet via DHCP (valgmulighed 66).

For opgraderingsregler skal serveren angives.

Hvis porten mangler, bruges standardporten til det angivne skema. Tftp bruger UDP-port 69, http bruger TCP-port 80, https bruger TCP-port 443.

En filsti skal være til stede. Det behøver ikke nødvendigvis henvise til en statisk fil, men kan indikere dynamisk indhold opnået gennem CGI.

Makroudvidelse gælder inden for URL'er. Følgende er eksempler på gyldige webadresser:

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

Når du bruger DHCP-indstilling 66, understøttes den tomme syntaks ikke af opgraderingsreglerne. Det gælder kun for profilreglen*.

RFC 8188-baseret HTTP-indholdskryptering

Telefonen understøtter RFC 8188-baseret HTTP-indholdskryptering med AES-128-GCM-kryptering til konfigurationsfiler. Med denne krypteringsmetode kan enhver enhed læse HTTP-meddelelsesoverskrifterne. Det er dog kun de enheder, der kender Input Keying Material (IKM), der kan læse nyttelasten. Når telefonen er forsynet med IKM, kan telefonen og provisioneringsserveren udveksle konfigurationsfiler sikkert, samtidig med at tredjeparts netværkselementer kan bruge meddelelsesoverskrifterne til analyse- og overvågningsformål.

XML-konfigurationsparameteren IKM_HTTP_EncryptContent holder IKM på telefonen. Af sikkerhedsmæssige årsager er denne parameter ikke tilgængelig på telefonadministrationswebsiden. Det er heller ikke synligt i telefonens konfigurationsfil, som du kan få adgang til fra telefonens IP-adresse eller fra telefonens konfigurationsrapporter sendt til klargøringsserveren.

Hvis du vil bruge RFC 8188-baseret kryptering, skal du sørge for følgende:

Klargør telefonen med IKM ved at angive IKM med XML-parameteren IKM_HTTP_EncryptContent i den konfigurationsfil, der sendes fra klargøringsserveren til telefonen.

Hvis denne kryptering anvendes på de konfigurationsfiler, der sendes fra klargøringsserveren til telefonen, skal du sikre dig, at HTTP-overskriften Content-Encoding i konfigurationsfilen har aes128gcm.

I mangel af denne overskrift gives AES-256-CBC-metoden forrang. Telefonen anvender AES-256-CBC-dekryptering, hvis en AES-256-CBC-nøgle er til stede i en profilregel, uanset IKM.

Hvis telefonen skal anvende denne kryptering på de konfigurationsrapporter, den sender til klargøringsserveren, skal du kontrollere, at der ikke er nogen AES-256-CBC-nøgle angivet i rapportreglen.

Valgfri resync-argumenter

Valgfrie argumenter, nøgle, uid og pwd, kan gå forud for de URL'er, der er indtastet i Profile_Rule* parametrene, samlet omgivet af firkantede parenteser.

nøgle
uid og pwd

Indstill ingen --key fortæller telefonen, at den konfigurationsfil, den modtager fra klargøringsserveren, er krypteret med AES-256-CBC-kryptering, medmindre Content-Encoding header i filen angiver aes128gcm-kryptering. Selve nøglen er angivet som en streng efter udtrykket --key. Nøglen kan eventuelt omsluttes med dobbelte anførselstegn („). Telefonen bruger nøglen til at dekryptere konfigurationsfilen.

Eksempler på brug

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

De valgfrie argumenter i parentes er makroudvidet. Specielle formålsparametre, GPP_SA til GPP_SD, er makroudvidet til makrovariabler, $ SA til $ SD, kun når de bruges som nøgleoptionsargumenter. Se disse eksempler:

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

I åbne formatprofiler skal argumentet til --key være det samme som argumentet for indstillingen -k, der er givet til openssl.

Inds tillingerne uid og pwd kan bruges til at specificere det brugerID og adgangskode, der sendes som svar på HTTP Basic- og Digest-godkendelsesudfordringer, når den angivne URL anmodes om. De valgfrie argumenter i parentes er makroudvidet. Specielle formålsparametre, GPP_SA til GPP_SD, er makroudvidet til makrovariabler, $ SA til $ SD, kun når de bruges som nøgleoptionsargumenter. Se disse eksempler:

GPP_SA = MyUserID GPP_SB = MySecretPassword

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

vil derefter udvides til:

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

Datatyper

Disse datatyper bruges sammen med konfigurationsprofilparametre:

{a, b, c,...} - Et valg mellem a, b, c,...

Bool—boolsk værdi af enten „ja“ eller „nej“.

CADScript — et miniscript, der angiver kadenceparametrene for et signal. Op til 127 tegn.

Syntaks: S ₁ [; S ₂], hvor:

_{_{_{_{S _i =D _i (på _{i,1 /off i,1} [, på _i, 2 /off i, _{2 [, på i,} 3 /off _i, _{3 [, på i,4 /off i,} _{4 [, på _{i,5 /off i} ,5 [, på i} ,6 /off _i ,6]]]]) og er kendt som en sektion.}}}}

på _{i, j} og fra _{i, j} er tænd/sluk-varigheden i sekunder af et segment. i = 1 eller 2, og j = 1 til 6.

D _i er sektionens samlede varighed i sekunder.

Alle varigheder kan have op til tre decimaler for at give 1 ms opløsning. Jokertegnet „*“ står for uendelig varighed. Segmenterne i en sektion afspilles i rækkefølge og gentages, indtil den samlede varighed er afspillet.

Eksempel 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

Eksempel 2 - Særlig ring (kort, kort, kort, lang):

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 — Scriptsyntaks, der bruges til at angive opkaldsplaner for linje 1 og linje 2.

Flo <n>at —En flydende værdi med op til n decimaler.

FQDN — Fuldt kvalificeret domænenavn. Det kan indeholde op til 63 tegn. Eksempler er som følger:
sip.cisco.com:5060 eller 109.12.14. 12:12345
Sip.cisco.com eller 109.12.14.12

FreqScript - et miniscript, der specificerer frekvens- og niveauparametrene for en tone. Indeholder op til 127 tegn.

Syntaks: F ₁ _{@L 1} [, F ₂ _{@L 2} [, F ₃ _{@L 3} [, F ₄ _{@L 4} [, F ₅ _{@L 5} [, F ₆ _{@L 6}]]]], hvor:

F ₁ —F ₆ er frekvens i Hz (kun usignerede heltal).

L ₁ —L ₆ er tilsvarende niveauer i dBm (med op til en decimal).

Hvide mellemrum før og efter kommaet er tilladt, men anbefales ikke.

Eksempel 1 - Ventetone til opkald:

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

Eksempel 2 — Opkaldstone:

350@-19,440@-19 Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm

IP- Gyldig IPv4-adresse i form af x.x.x.x, hvor x er mellem 0 og 255. Eksempel: 10.1.2.100.

Brugerid — bruger-id, som det vises i en webadresse; op til 63 tegn.

Telefon — En telefonnummerstreng, f.eks. 14081234567, *69, *72, 345678; eller en generisk webadresse, f.eks. 1234 @10 .10.10. 100:5068 eller jsmith@Cisco.com. Strengen kan indeholde op til 39 tegn.

PHTMPLT - en telefonnummerskabelon. Hver skabelon kan indeholde et eller flere mønstre, der er adskilt af et komma (,). Hvidt mellemrum i begyndelsen af hvert mønster ignoreres. „?“ og „*“ repræsenterer jokertegn. Hvis du vil repræsentere bogstaveligt, skal du bruge %xx. For eksempel repræsenterer% 2a *. Skabelonen kan indeholde op til 39 tegn. Eksempler: „1408*, 1510*“, „1408123???? , 555? 1.“.

Port — TCP/UDP-portnummer (0-65535). Det kan specificeres i decimal- eller hex-format.

ProvisioningRuleSyntax — Scripting-syntaks, der bruges til at definere regler for gensynkronisering af konfiguration og firmwareopgradering.

PWRLevel — effektniveau udtrykt i dBm med én decimal, f.eks. —13,5 eller 1,5 (dBm).

RSCTMPLT — en skabelon for SIP-svarstatuskode, f.eks. „404, 5*“, „61?“ , „407, 408, 487, 481“. Det kan indeholde op til 39 tegn.

Sig <n>—Signeret n-bit-værdi. Det kan specificeres i decimal- eller hex-format. Et „-“ -tegn skal gå forud for negative værdier. Et +-tegn før positive værdier er valgfrit.

Stjernekoder — Aktiveringskode for en supplerende tjeneste, f.eks. *69. Koden kan indeholde op til 7 tegn.

Str <n>—En generisk streng med op til n ikke-reserverede tegn.

T <n>id — Tidsvarighed i sekunder, med op til n decimaler. Ekstra specificerede decimaler ignoreres.

ToneScript — et miniscript, der angiver frekvens-, niveau- og kadenceparametre for en opkaldsstatustone. Scriptet kan indeholde op til 127 tegn.

Syntaks: FreqScript; Z ₁ [; Z ₂].

_{_{_{_{_{_{_{_{_{Afsnittet Z ₁ svarer til S 1-sektionen i et CADscript, bortset fra at hvert tænd/sluk-segment efterfølges af en frekvenskomponentparameter: Z _{1 = D 1 (på i,1 /off i,1} _{/f i, ₁ [, på i,} 2/off i,2 /f _i, _{2 [, på _i, 3 /off i, 3 /f i,} _{3 [, på i,4 /off _i, 4 /f _i, 4 [, på i,5 /af i} ,5 /f i,5 [, på _i ,6 /af _i ,6 /f}}}}}}}}} _i,6]]]]), hvor:

f _{i, j} = n ₁ [+n ₂] +n ₃ [+n ₄ [+n ₅ [+n ₆]]]].

1 < n _k < 6 angiver frekvenskomponenterne i FreqScript, der bruges i det segment.

Hvis der anvendes mere end én frekvenskomponent i et segment, summeres komponenterne sammen.

Eksempel 1 - Opkaldstone:

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

Eksempel 2 - Stammetone:

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>—Usigneret n-bit-værdi, hvor n = 8, 16 eller 32. Det kan specificeres i decimal- eller hex-format, såsom 12 eller 0x18, så længe værdien kan passe ind i n bit.

Hold disse under overvejelse:

<Par Name>repræsenterer et konfigurationsparameternavn. I en profil dannes det tilsvarende tag ved at erstatte mellemrummet med en understregning „_“, f.eks. Par _Name.
Et tomt standardværdifelt indebærer en tom streng < „“ >.
Telefonen fortsætter med at bruge de sidst konfigurerede værdier for tags, der ikke findes i en given profil.
Skabeloner sammenlignes i den givne rækkefølge. Det første, ikke det nærmeste, match vælges. Parameternavnet skal matche nøjagtigt.
Hvis der er angivet mere end én definition for en parameter i en profil, er den sidste definition i filen den, der træder i kraft i telefonen.
En parameterspecifikation med en tom parameterværdi tvinger parameteren tilbage til standardværdien. Hvis du vil angive en tom streng i stedet, skal du bruge den tomme streng „“ som parameterværdi.

Cisco AI Assistant

Tak for din feedback.