Konfigurera telefonen för omsynkronisering av profil

Synkronisera om telefonprofilen över TFTP

Telefonen stöder flera nätverksprotokoll för att hämta konfigurationsprofiler. De mest grundläggande profilöverföringsprotokollet är TFTP (RFC1350). TFTP används ofta för etablering av nätverksenheter i privata, lokala nätverk. Även om det inte rekommenderas för distribution av fjärrslutpunkter via Internet kan TFTP vara användbart för distribution inom små organisationer, för intern företablering och för utveckling och testning. I följande procedur ändras en profil när en fil har hämtats från en TFTP-server.

1

Anslut datorn och telefonen till en hubb, switch eller liten router i en LAN-miljö.

2

Installera och aktivera en TFTP-server på datorn.

3

Använd en textredigerare för att skapa en konfigurationsprofil.

Det går att ange vissa värden som markeringar för att senare kontrollera om profilen har tilldelats telefonen. Ange till exempel värdet för GPP_A som 12345678 enligt följande exempel:
<flat-profile>
  <GPP_A> 12345678
  </GPP_A>
</flat-profile>
4

Spara XML-konfigurationsfilen i TFTP-serverns rotkatalog.

Det går att kontrollera att TFTP-servern är korrekt konfigurerad genom att begära konfigurationsprofilfilen genom en annan TFTP-klient än telefonen. Använd helst en TFTP-klient som körs på en annan värd än etableringsservern.

5

Öppna administrationssidan i webbläsaren på datorn. Anta till exempel att telefonens IP-adress är 192.168.1.100 och öppna följande webbadress i webbläsaren:

http://192.168.1.100/admin/advanced
6

Välj fliken Röst > Etablering och kontrollera värdena för de allmänna parametrarna GPP_A till och med GPP_P. De bör vara tomma.

7

Synkronisera om testtelefonen med konfigurationsprofilen som du skapade genom att öppna omsynkroniseringsadressen i webbläsaren.

Exempel:

Om TFTP-serverns IP-adress är 192.168.1.200 bör kommandot likna det i följande exempel:

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

När telefonen får det här kommandot, begär enheten på adress 192.168.1.100 konfigurationsprofilfilen basic.txt från TFTP-servern på IP-adressen 192.168.1.200. Telefonen parsar sedan den hämtade filen och uppdaterar parametern GPP_A med värdet 12345678.

8

Kontrollera att parametern har uppdaterats korrekt. Uppdatera administrationswebbsidan och öppna Röst > Etablering.

Nu innehåller parametern GPP_A värdet 12345678.

Reservera en telefonspecifik profil på en TFTP-server
1

Leta upp telefonens MAC-adress på produktetiketten för telefonen. (MAC-adressen är numret som innehåller siffror och gemena hexadecimala siffror, t.ex. 000e08aabbcc.)

2

Byt namn på konfigurationsfilen till CP-xxxx mac-adress.cfg (ersätt xxxx med modellnumret och macaddress med telefonens MAC-adress).

Exempel:

CP-8875 000e08aabbcc.cfg

3

Flytta den nya filen till TFTP-serverns virtuella rotkatalog.

4

Öppna webbsidan för telefonadministration.

5

Välj Röst > Etablering.

6

Ange sökvägen till profilfilen i fältet Profilregel.

Exempel: Anta att TFTP-serverns IP-adress är 192.168.1.200 och att profil filnamnet är 

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

Klicka på Submit All Changes. Detta utlöser en omedelbar omstart och omsynkronisering.

När nästa omsynkronisering utförs hämtar telefonen den nya filen genom att expandera $MA-makrouttrycket till MAC-adressen.

Synkronisera om telefonprofilen med HTTP GET
1

Installera en HTTP-server på den lokala datorn eller en annan tillgänglig värd.

Apache-servern med öppen källkod kan hämtas från Internet.

2

Överför konfigurationsprofilfilen till den installerade serverns virtuella rotkatalog.

3

Kontrollera att serverinstallationen slutförts korrekt och att du har åtkomst till profilfilen genom att öppna profilen i en webbläsare.

4

Ändra Profile_Rule för testtelefonen så att den pekar på HTTP-servern i stället för på TFTP-servern, så att profilen hämtas regelbundet.

Anta till exempel att HTTP-servern har adressen 192.168.1.300 och att profilfilens namn är basic.txt och ange följande värde:

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

Klicka på Submit All Changes. Detta utlöser en omedelbar omstart och omsynkronisering.

6

Observera syslog-meddelandena som telefonen skickar. Nu bör profilen hämtas från HTTP-servern vid de regelbundna omsynkroniseringarna.

7

Granska HTTP-serverloggarna och se hur informationen som identifierar testtelefonen visas i användaragentloggen.

Informationen bör innehålla tillverkaren, produktnamnet, den aktuella versionen av den fasta programvaran och serienumret.

Synkronisera om telefonprofilen automatiskt

En enhet kan regelbundet synkroniseras mot etableringsservern för att säkerställa att eventuella profiländringar på servern distribueras till slutpunktsenheten (i stället för att en uttrycklig omsynkroniseringsbegäran skickas till slutpunkten).

Du kan konfigurera telefonen så att den regelbundet synkroniseras med en server genom att definiera en URL för konfigurationsprofilen med hjälp av parametern Profile_Rule, och en omsynkroniseringsperiod med hjälp av parametern Resync_Periodic.

1

Öppna webbsidan för telefonadministration.

2

Välj Röst > Etablering.

3

Definiera parametern Profile_Rule. I det här exemplet är TFTP-serverns IP-adress 192.168.1.200.

4

Ange ett lågt värde för testning i fältet Resync Periodic, t.ex. 30 sekunder.

5

Klicka på Verkställ alla ändringar.

Med de nya parameterinställningarna synkroniserar telefonen två gånger per minut med konfigurationsfilen som anges i URL:en.

6

Observera de resulterande meddelandena i syslog-spårningen.

7

Kontrollera att värdet i fältet Resync On Reset är Yes.

<Resync_On_Reset>Yes</Resync_On_Reset>
8

Stäng av telefonen för att framtvinga en omsynkronisering till etableringsservern.

Om omsynkroniseringen misslyckas av någon anledning, t.ex. om servern inte svarar, så väntar enheten (det antal sekunder som konfigurerats i Resync Error Retry Delay) innan den försöker synkronisera igen. Om Resync Error Retry Delay är 0 försöker telefonen inte synkronisera igen efter ett misslyckat omsynkroniseringsförsök.

9

(Valfritt) Ange ett lågt värde i fältet Resync Error Retry Delay, t.ex. 30.

<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>
10

Inaktivera TFTP-servern och observera resultatet som returneras av syslog.

Parametrar för omsynkronisering av profil

Följande tabell definierar hur parametrarna för omsynkronisering av profil i avsnittet Konfigurationsprofil på fliken Röst > Etablering på telefonens webbsida fungerar och används. Den definierar även syntax för strängen som läggs till i telefonens konfigurationsfil (cfg.xml) med XML-kod för att konfigurera en parameter.

Tabell 1. Parametrar för omsynkronisering av profil

Parameter

Beskrivning

Provision Enable

Tillåter eller nekar omsynkroniseringsåtgärder för profil.

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

  • På telefonens webbsida ställer du in fältet som Ja för att tillåta omsynkroniseringsåtgärder eller på Nej för att blockera omsynkroniseringsåtgärder.

Standard: Ja

Resync On Reset

Anger om telefonen omsynkroniserar konfigurationer med reserveringsservern efter start och efter varje uppgraderingsförsök.

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

  • På telefonens webbsida ställer du in fältet som Ja för att tillåta omsynkronisering vid start eller återställning eller på Nej för att blockera omsynkronisering vid start eller återställning.

Standard: Ja

Resync Random Delay

Förhindrar en överbelastning av reserveringsservern när ett stort antal enheter startas samtidigt och försöker med initial konfiguration. Fördröjningen gäller bara för det initiala konfigurationsförsöket, efter en enhets start eller återställning.

Parametern är det maximala tidsintervall som enheten väntar innan den kontaktar reserveringsservern. Faktisk fördröjning är ett pseudo-slumpmässigt värde mellan 0 och det här värdet.

Parametern är i enheter om 20 sekunder.

Det giltiga värdet är i intervallet mellan 0 och 65 535.

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

  • På telefonens webbsida anger du antal enheter (20 sekunder) telefonen ska fördröja omsynkronisering efter att den startats eller återställts.

Standardvärde är 2 (40 sekunder).

Resync At (HHmm)

Tidpunkt (HHmm) som telefonen omsynkroniserar med reserveringsservern.

Värdet för det här fältet måste vara fyra siffror mellan 0000 och 2 400 för att ange tiden i formatet HHmm. Till exempel anger 0959 09:59.

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

  • Gå till telefonens webbsida och ange tidpunkt i TTMM-format för telefonen att starta omsynkronisering.

Värdet är tomt som standard. Om värdet är ogiltigt ignoreras parametern. Om den här parametern har ställts in med ett giltigt värde ignoreras parametern Resync Periodic.

Resync At Random Delay

Förhindrar överbelastning av reserveringsservern när ett stort antal enheter startar samtidigt.

För att undvika att servern överbelastas med omsynkroniseringsförfrågningar från flera telefoner synkroniserar telefonen i intervallet mellan timmarna och minuterna, och timmarna och minuterna plus den slumpmässiga fördröjningen (hhmm, hhmm + random_delay). Om den slumpmässiga fördröjningen till exempel = (Återsynka vid Slumpmässig fördröjning + 30)/60 minuter, omvandlas indatavärdet i sekunder till minuter och avrundas uppåt till nästa minut för att beräkna det slutliga random_delay-intervallet.

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

  • På telefonens webbsida anger du tidsperioden i sekunder.

Giltigt värde är mellan 600 och 65535.

Om värdet är mindre än 600 är slumpmässig intern fördröjning mellan 0 och 600.

Standardvärdet är 600 sekunder (10 minuter).

Resync Periodic

Tidsintervallet mellan regelbundna omsynkroniseringar med reserveringsservern. Den associerade omsynkroniseringstimern aktiveras efter den första lyckade synkroniseringen med servern.

Giltiga format är följande:

  • Ett heltal

    Exempel: En inmatning av 3000 anger att nästa omsynkronisering sker om 3 000 sekunder.

  • Flera heltal

    Exempel: En inmatning av 600,1200,300 anger att första omsynkroniseringen inträffar efter 600 sekunder, andra omsynkroniseringen sker 1 200 sekunder efter den första, och den tredje omsynkroniseringen äger rum 300 sekunder efter den andra.

  • Ett tidsintervall

    Exempel, en inmatning av 2400 + 30 anger att nästa omsynkronisering sker mellan 2 400 och 2 430 sekunder efter en godkänd omsynkronisering.

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

  • På telefonens webbsida anger du tidsperioden i sekunder.

Ange den här parametern till noll om du vill inaktivera periodisk omsynkronisering.

Standardvärdet är 3 600 sekunder.

Resync Error Retry Delay

Om en omsynkronisering misslyckas, t.ex. om telefonen inte kunde hämta en profil från servern, om den hämtade filen är skadad eller om det har uppstått ett internt fel, försöker enheten omsynkronisera efter en viss tid som anges i sekunder.

Giltiga format är följande:

  • Ett heltal

    Exempel: En inmatning av 300 anger att nästa försök för omsynkronisering inträffar om 300 sekunder.

  • Flera heltal

    Exempel: En inmatning av 600,1200,300 anger att det första försöket inträffar 600 sekunder efter misslyckandet, det andra försöket sker 1 200 sekunder efter misslyckandet av det första försöket, och det tredje försöket äger rum 300 sekunder efter misslyckandet av det andra försöket.

  • Ett tidsintervall

    Exempel: En inmatning av 2400 + 30 anger att nästa försök sker mellan 2 400 och 2 430 sekunder efter en misslyckad omsynkronisering.

Om förseningen är 0 försöker enheten inte synkronisera igen efter ett misslyckat omsynkroniseringsförsök.

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

  • På telefonens webbsida anger du tidsperioden i sekunder.

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

Forced Resync Delay

Den längsta fördröjning (i sekunder) som telefonen väntar innan den utför en omsynkronisering.

Enheten påbörjar inte omsynkroniseringen om någon av dess telefonlinjer är aktiv. Eftersom en omsynkronisering kan ta flera sekunder är det bäst att vänta tills enheten har varit inaktiv en längre tid innan omsynkroniseringen utförs. På så sätt kan användaren ringa samtal utan avbrott.

Enheten har en timer som börjar nedräkningen när alla telefonens linjer blivit inaktiva. Den här parametern är räknarens första värde. Omsynkroniseringshändelser skjuts upp tills räknaren når noll.

Det giltiga värdet är i intervallet mellan 0 och 65 535.

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

  • På telefonens webbsida anger du tidsperioden i sekunder.

Standardvärdet är 14,400 sekunder.

Resync From SIP

Kontrollerar förfrågningar om omsynkroniseringsåtgärder via en SIP NOTIFY-händelse som skickas från tjänstleverantörens proxyserver till telefonen. Om detta är aktiverat kan proxyn begära en omsynkronisering genom att skicka ett SIP-meddelande som innehåller Event: resync-sidhuvudet till enheten.

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

  • På telefonens webbsida väljer du Ja för att aktivera den här funktionen eller Nej för att inaktivera den.

Standard: Ja

Resync After Upgrade Attempt

Aktiverar eller inaktiverar omsynkroniseringsåtgärden när en uppgradering har inträffat. Om Ja väljs utlöses synkronisering efter en uppgradering av fast programvara.

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

  • På telefonens webbsida väljer du Ja för att utlösa omsynkronisering efter en uppgradering av fast programvara eller Nej för att inte omsynkronisera.

Standard: Ja

Resync Trigger 1

Resync Trigger 2

Om den logiska ekvationen i dessa parametrar utvärderas som FALSE, utlöses inte omsynkronisering även om Resync On Reset anges som TRUE. Enbart omsynkronisering via direkt åtgärds-URL och SIP-meddelande ignorerar dessa utlösare av omsynkronisering.

Parametrarna kan programmeras med ett villkorsuttryck som makroexpanderas. Information om giltiga makroutvidgningar finns i Makroexpansionsvariabler under Etableringsparametrar.

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

    <Resync_Trigger_2 ua="na"/>

  • Ange utlösare på telefonens webbsida.

Standard: Tom

Användarkonfigurerbar omsynkning

Gör att användare kan omsynkronisera telefonen från menyn på telefonskärmen. Om inställt som Ja kan en användare omsynkronisera telefonkonfigurationen genom att ange profilregeln från telefonen. Om värdet är Nej visas inte parametern för Profilregel i menyn på telefonskärmen.

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

  • På telefonens webbsida väljer du Ja för att visa parametern för Profilregeln på telefonens meny eller välj Nej för att dölja denna parameter.

Standard: Ja

Resync Fails On FNF

En omsynkronisering anses normalt misslyckad om en begärd profil inte tas emot från servern. Den här parametern åsidosätter den här funktionen. Om inställt på Nej accepterar enheten svaret file-not-found från servern som en godkänd omsynkning.

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

  • På telefonens webb sida väljer du Ja för att ta emot ett file-not-found-svar som en misslyckad omsynkning eller Nej för att file-not-found-svar som en lyckad omsynkning.

Standard: Ja

Typ av profilautentisering

Anger referenserna som används för autentisering av profilkonto. De alternativ som finns är:

  • Inaktiverad: Inaktiverar funktionen för profilkonto. När den här funktionen är inaktiverad visas inte menyn Profilkontokonfigurering på telefonskärmen.

  • Grundläggande HTTP-autentisering: HTTP-inloggningsuppgifterna används för att autentisera profilkontot.

  • XSI-autentisering: XSI- eller XSI SIP-inloggningsuppgifter används för att autentisera profilkontot. Inloggningsuppgifterna för autentisering är beroende av XSI-autentiseringstypen för telefonen:

    • När XSI-autentiseringstypen för telefonen är inställd på inloggningsuppgifter, används XSI-inloggningsuppgifterna.

    • När XSI-autentiseringstypen för telefonen är inställd på SIP-inloggningsuppgifter, används XSI SIP-inloggningsuppgifter.

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

  • På telefonens webbsida väljer du ett alternativ i listan för att telefonen ska autentisera om synkning av en profil.

Standard: Grundläggande http-autentisering

Mer information finns i Ange profilautentiseringstyp under Ange telefonen för profilomsynkronisering.

Profilregel

Profilregel B

Profilregel C

Profilregel D

Varje profilregel informerar telefonen om en källa från vilken den kan erhålla en profil (konfigurationsfil). Under varje återsynkronisering applicerar telefonen alla profiler i följd.

Om du applicerar CBC-AES-256-kryptering till konfigurationsfilerna, specificera krypteringsnyckel med nyckelordet till – key på följande sätt:

[--key <krypteringsnyckel>]

Du kan också omsluta krypteringsnyckeln med dubbla citattecken (”).

  • I telefonens konfigurationsfil med XML (cfg.xml) anger du en sträng i det här formatet:

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

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • På telefonens webbsida anger du profilregeln.

Standard: /$PSN.xml

DHCP Option To Use

DHCP-alternativ, avgränsade med kommatecken, som används för att hämta fast programvara och profiler.

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

DHCPv6-alternativ att använda

DHCP-alternativ, avgränsade med kommatecken, som används för att hämta fast programvara och profiler.

Standard: 17 160 159

Etablering genom Cisco XML

Det går att etablera telefoner genom Cisco XML-funktioner.

Det går att skicka ett XML-objekt till telefonen med ett SIP Notify-paket eller HTTP Post till telefonens CGI-gränssnitt: http://PhoneIPAddress/CGI/Execute.

CP-xxxx-3PCC utökar Cisco XML-funktionen för att ge stöd för etablering via ett XML-objekt:

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

När telefonen tar emot XML-objektet hämtar den etableringsfilen från [profile-rule]. Den här regeln använder makron för att underlätta utvecklingen av XML-tjänstprogrammet.

URL-matchning med makroexpansion

Underkataloger med flera profiler på servern gör det enkelt att hantera ett stort antal distribuerade enheter. Profilens URL kan innehålla:

  • Etableringsserverns namn eller en explicit IP-adress. Om profilen identifierar etableringsservern baserat på dess namn utför telefonen en DNS-sökning för att matcha namnet.

  • En annan serverport än standardporten som anges i URL:en, som anges med standardsyntaxen :port efter servernamnet.

  • Underkatalogen i serverns virtuella rotkatalog där profilen lagras, som anges med URL-standardnotation och som hanteras med makroexpandering.

Exempelvis begär följande Profile_Rule profilfilen ($PN.cfg), i underkatalogen /cisco/config på servern, från TFTP-servern som körs på värden prov.telco.com och som lyssnar efter en anslutning på port 6900: 

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

En profil för varje telefon kan identifieras i en allmän parameter, där makroexpandering används för att referera till dess värde i en gemensam profilregel.

Anta till exempel att GPP_B definierats som Dj6Lmp23Q.

Profile_Rule har värdet:

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

När enheten synkroniseras och makrona expanderas begär telefonen med MAC-adressen 000e08012345 profilen med namnet som innehåller enhetens MAC-adress på följande URL:

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

Med profilautentisering kan telefonanvändare synkronisera etableringsprofilen till telefonen. Autentiseringsinformationen krävs när telefonen försöker omsynkronisera och hämta konfigurationsfilen för första gången och får ett HTTP- eller HTTPS401-autentiseringsfel. När du aktiverar den här funktionen visas skärmen Profilkontokonfigurering på telefonskärmen för följande situationer:

  • När autentiseringsfel 401 för HTTP eller HTTPS inträffar under etablering första gången när telefonen har startats om

  • När profilkontot med användarnamn och lösenord är tomt

  • När användarnamn och lösenord saknas i profilregeln

Om skärmen för Profilkontokonfigurering missas eller ignoreras kan användaren även komma åt installationsskärmen via telefonskärmsmenyn, eller den programstyrda knappen Inställningar som endast visas när ingen linje på telefonen är registrerad.

När du inaktiverar funktionen visas inte skärmen Profilkontokonfigurering på telefonen.

Användarnamn och lösenord i profilregeln har högre prioritet än profilkontot.

  • När du anger en korrekt URL i fältet Profilregel utan användarnamn och lösenord begär telefonen autentisering eller digest för att omsynkronisera profilen. Med korrekt profilkonto godkänns autentiseringen. Med fel profilkonto misslyckas autentiseringen.

  • När du anger en korrekt URL i fältet Profilregel utan användarnamn och lösenord begär telefonen autentisering eller digest för att omsynkronisera profilen. Profilkontot används inte för telefonens omsynkronisering. Inloggningen genomförs.

  • När du anger en korrekt URL i fältet Profilregel med ogiltigt användarnamn och lösenord begär telefonen autentisering eller digest för att omsynkronisera profilen. Profilkontot används inte vid omsynkronisering av telefonen. Inloggningen genomförs inte.

  • När du anger fel URL i fältet Profilregel misslyckas inloggningen alltid.

Du kan även konfigurera parametrarna i telefonens konfigurationsfil (cfg.xml) med XML-kod.

Du kan ange typ av profilautentisering på webbsidan för telefonadministration.

1

Öppna webbsidan för telefonadministration.

2

Välj Röst > Etablering.

3

I avsnittet Konfigurationsprofil ställer du in parametern Profil för autentiseringstyp för att ange de autentiseringsuppgifter som ska användas för autentisering av profilkonto.

Du kan konfigurera den här parametern i telefonens konfigurationsfil (cfg.xml) genom att ange en sträng i det här formatet:

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

Alternativ

  • Inaktiverad: Inaktiverar profilkontofunktionen. Om funktionen är inaktiverad visas inte menyn Inställning av profilkonto på telefonskärmen.

  • Grundläggande HTTP-autentisering: HTTP-inloggningsuppgifterna används för att autentisera profilkontot.

  • XSI-autentisering: XSI- eller XSI SIP-inloggningsuppgifter används för att autentisera profilkontot. Inloggningsuppgifterna för autentisering är beroende av XSI-autentiseringstypen för telefonen:

    När XSI-autentiseringstypen för telefonen är inställd på inloggningsuppgifter, används XSI-inloggningsuppgifterna.

    När XSI-autentiseringstypen för telefonen är inställd på SIP-inloggningsuppgifter, används XSI SIP-inloggningsuppgifter.

Standard: Grundläggande http-autentisering

4

Klicka på Submit All Changes.

Koppla en profil till telefonen manuellt

Hämta konfigurationsfilen till telefonen från en TFTP-server

Följ stegen nedan för att hämta konfigurationsfilen till ett TFTP-serverprogram på datorn.

1

Anslut datorn till telefonens LAN-port.

2

Kör ett TFTP-serverprogram på datorn och kontrollera att konfigurationsfilen finns i TFTP-rotkatalogen.

3

Öppna en webbläsare och ange IP-adressen för telefonens lokala nätverk, datorns IP-adress, filnamnet och inloggningsuppgifterna. Använd det här formatet:

http://<WAN_IP-adress>/admin/resync?tftp://<Datorns_IP-adress>/<filnamn>&xuser=admin&xpassword=<lösenord>

Exempel: 

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin
Hämta konfigurationsfilen till telefonen med cURL

Följ stegen nedan för att hämta konfigurationen till telefonen med hjälp av cURL. Det här kommandoradsverktyget används för att överföra data med URL-syntax. Om du vill hämta cURL går du till:

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

Vi rekommenderar att du inte använder cURL till att publicera konfigurationen till telefonen eftersom användarnamnet och lösenordet kan fångas upp när du använder cURL.

1

Anslut datorn till telefonens LAN-port.

2

Hämta konfigurationsfilen till telefonen genom att ange följande cURL-kommando:

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

Konfigurationsprofiler

Telefonen stöder konfigurationer i XML-format.

Exemplen i det här avsnittet använder konfigurationsprofiler med XML-syntax.

Format för konfigurationsprofil

Konfigurationsprofilen definierar parametervärdena för telefonen.

XML-formatet för konfigurationsprofiler använder XML-standardverktyg för att kompilera parametrarna och värdena.

Endast UTF-8 teckenuppsättningen stöds. Om du ändrar profilen i en redigerare är det viktigt att du inte ändrar kodningsformatet. I så fall kan telefonen inte identifiera filen.

Varje telefon har en egen funktionsuppsättning och därför även en egen uppsättning parametrar.

Öppet profilformat

En profil med öppet format är en textfil med XML-liknande syntax i en elementhierarki med elementattribut och elementvärden. Med det här formatet kan du använda standardverktyg för att skapa konfigurationsfilen. Det går att skicka en XML-konfigurationsfil från etablerings servern till telefonen under en omsynkronisering, utan kompilering som ett binärt objekt.

Telefonen stöder konfigurationsformat som genereras av standardverktyg. Den här funktionen underlättar utvecklingen av program för backend-etableringsservrar som genererar konfigurationsprofiler från befintliga databaser.

Etableringsservern skyddar konfidentiell information i konfigurationsprofilen genom att skicka XML-konfigurationsfilen till telefonen över en TLS-skyddad kanal. Filen kan också komprimeras med hjälp av gzip-komprimeringsalgoritmen (RFC1951).

Filen kan krypteras med någon av dessa krypteringsmetoder:

  • AES-256-CBC kryptering

  • RFC-8188 baserat HTTP innehåll kryptering med AES-128-GCM chiffrering

En konfigurationsfil kan innehålla följande komponenter:

  • Elementtaggar

  • Attribut

  • Parametrar

  • Formateringsfunktioner

  • XML-kommentarer

Exempel: Öppna 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>

Elementtaggen <flat-profile> innesluter alla parameterelement som telefonen identifierar.

Egenskaper för elementtagg

Tänk på följande när du skapar eller uppdaterar konfigurationsfilen.

  • XML-etableringsformatet och webbanvändargränssnittet stöder konfiguration av samma inställningar. XML-taggnamn och fältnamn i webbanvändargränssnittet liknar varandra, men varierar på grund av begränsningar i XML-elementnamn. Till exempel understreck (_) i XML-konfigurationsfilen i stället för mellanslag i webbgränssnittet.

  • Telefonen identifierar element med rätt parameternamn som är inkapslade i det särskilda <flat-profile>-elementet.

  • Elementnamn omges av vinkelparenteser.

  • De flesta elementnamnen liknar fältnamnen i telefonens webbgränssnitt, med följande ändringar:

    • Elementnamn får inte innehålla blanksteg eller specialtecken. Härled elementnamnet från webbfältnamnet webbsidorna genom, att ersätta alla blanksteg eller specialtecknen [, ], (, ) eller / med ett understreck.

      Exempel: Elementet <Resync_On_Reset> representerar fältet Resync On Reset.

    • Alla elementnamn måste vara unika. I telefonens webbgränssnitt kan samma fält visas på flera webbsidor, till exempel på sidorna Linje, Användare och Anslutning. Lägg till [n] i elementnamnet för att indikera numret som visas på sidfliken.

      Exempel: Elementet <Dial_Plan_1_> representerar Nummeradministration för Linje 1.

  • Varje inledande elementtagg måste ha en matchande avslutande elementtagg. Till exempel:

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

  • Elementtaggar är skiftlägeskänsliga.

  • Tomma elementtaggar tillåts och tolkas som att värdet ska vara tomt. Infoga den inledande elementtaggen utan en matchande elementtagg och infoga ett blanksteg och ett snedstreck innan du stänger vinkelparentesen (>). I det här exemplet är profilregel B tom:

    <Profile_Rule_B />

  • En tom elementtagg kan användas för att förhindra överskrivning av värden som anges av användaren under en omsynkronisering. I följande exempel förblir användarens snabbvalsinställningar oförändrade:

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

  • Använd ett tomt värde om du vill att den associerade parametern ska vara en tom sträng. Infoga ett inledande och ett avslutande element utan något värde mellan dem. I följande exempel är parametern GPP_A en tom sträng.

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

  • Elementnamn som inte kan identifieras ignoreras.

Parameteregenskaper

Dessa egenskaper gäller för följande parametrar:

  • Parametrar som inte anges i en profil lämnas oförändrade på telefonen.

  • Okända parametrar ignoreras.

  • Om profilen med öppet format innehåller flera förekomster av samma parametertagg åsidosätter den sista förekomsten tidigare förekomster. För att undvika oavsiktlig åsidosättning av en parameters konfigurationsvärden rekommenderar vi att högst en instans av en parameter anges i en profil.

  • Den sista profilen som bearbetas prioriteras. Om flera profiler definierar samma konfigurationsparameter prioriteras den sista profilens värde.

Strängformat

Följande gäller för formateringen av strängarna:

  • Kommentarer som följer XML-standardsyntax tillåts.

    <!-- Min kommentar skrivs här -->

  • Inledande och avslutande blanksteg tillåts för att underlätta läsningen, men tas bort från parametervärdet.

  • Nya rader inuti ett värde omvandlas till blanksteg.

  • Ett XML-sidhuvud med format <? ?> tillåts, men ignoreras av telefonen.

  • Om du vill infoga specialtecken använder du vanliga escape-tecken för XML (se tabellen nedan).

    Specialtecken

    XML-escape-sekvens

    & (et-tecken)

    &amp;

    < (mindre än)

    &lt;

    > (större än)

    &gt;

    ’ (apostrof)

    &apos;

    ” (dubbelt citattecken)

    &quot;

    I följande exempel används escape-tecken för att representera symbolerna för större än och mindre än, som krävs i en regel för en uppringningsplan. I det här exemplet definieras en uppringningsplan för en hotline som konfigurerar parametern <Dial_Plan_1_> (ADMIN-inloggning > Avancerat > Röst > Ankn (n)) som (S0 <:18005551212>).

    <flat-profile> <Dial_Plan_1_> (S0 &lt;:18005551212&gt;) </Dial_Plan_1_></flat-profile>

  • Numeriskt teckenavbrott översätts med decimala och hexadecimala värden (såsom &#40; och &#x2e;).

  • Telefonens fasta programvara stöder endast ASCII-tecken.

Komprimering och kryptering av öppen profil (XML)

Du kan komprimera den öppna konfigurationsprofilen för att minska nätverksbelastningen på etableringsservern. Profilen kan också krypteras för att skydda hemlig information. Komprimering är inte obligatoriskt, men måste ske före kryptering.

Komprimering av öppen profil

Den komprimeringsmetod som stöds är gzip-komprimeringsalgoritmen (RFC1951). Verktyget gzip och komprimeringsbiblioteket som implementerar samma algoritm (zlib) är tillgängliga från webbplatser på Internet.

För att kunna identifiera komprimering förväntar sig telefonen att den komprimerade filen innehåller ett huvud som är kompatibelt med gzip. Huvudet genereras via ett anrop till gzip-verktyget i den ursprungliga öppna profilen. Telefonen kontrollerar filhuvudet som hämtats för att fastställa filformatet.

Om till exempel profil.xml är en giltig profil, så accepteras även filen profil.xml.gz. Den här profiltypen kan genereras med något av följande kommandon:

  • >gzip profil.xml

    Ersätter den ursprungliga filen med den komprimerade filen.

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

    Den ursprungliga filen lämnas kvar och genererar en ny komprimerad fil.

Kryptering av öppen profil

Kryptering med symmetriska nycklar kan användas för att kryptera en öppen konfigurationsprofil oavsett om filen är komprimerad eller inte. Komprimering, om tillämpad, måste tillämpas före kryptering.

Etableringsservern använder HTTPS för att hantera den första etableringen av telefonen efter distributionen. Konfigurationsprofiler offline krypterade i förväg tillåter användning av HTTP för att synkronisera om profiler senare. Det här minskar belastningen på HTTPS-servern i storskaliga distributioner.

Telefonen stöder två metoder av kryptering för konfigurationsfiler:

  • AES-256-CBC kryptering

  • RFC 8188-baserat HTTP-innehållskryptering med AES-128-GCM chiffrering

Nyckeln eller Input Keying Material (IKM) måste ha blivit företablerad till enheten vid en tidigare tidpunkt. Initieringen (bootstrap) av den hemliga nyckeln kan utföras på ett säkert sätt med HTTPS.

Konfigurationsfilens namn kräver inget särskilt format, men ett filnamn som slutar med tillägget .cfg visar normalt att det rör sig om en konfigurationsprofil.

AES-256-CBC kryptering

Telefonen stöder AES-256-CBC kryptering för konfigurationsfiler.

Krypteringen kan utföras med krypteringsverktyget OpenSSL, som kan hämtas från olika webbplatser på Internet. Stöd för 256-bitars AES-kryptering kan kräva omkompilering av verktyget för att aktivera AES-koden. Den fasta programvaran har testats mot versionen openssl-1.1.1d.

För en krypterad fil förväntar sig profilen att filen har samma format som det format som genereras med följande kommando:

 # exempel krypteringsnyckel = SecretPhrase1234 openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg # analogt anrop för en komprimerad xml-fil openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg

Ett gement -k föregår den hemliga nyckeln, som kan vara en oformaterad textfras, och som används för att generera en slumpmässig 64-bitars saltsträng. Med hemligheten som anges av argumentet -k hämtar krypteringsverktyget en slumpmässig första 128-bitarsvektor och själva 256-bitarskrypteringsnyckeln.

När den här formen av kryptering används med en konfigurationsprofil måste telefonen informeras om den hemliga nyckelns värde för att kunna dekryptera filen. Det här värdet anges som en kvalificerare i profil-URL:en. Syntaxen är som följer, och använder en explicit URL:

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

Det här värdet programmeras med hjälp av någon av Profile_Rule-parametrarna.

Makroexpandering

Flera etableringsparametrar genomgår intern makroexpandering innan de utvärderas. Det här förutvärderingssteget ger större flexibilitet vid omsynkroniserings- och uppgraderingsaktiviteter på telefonen.

Följande parametergrupper genomgår makroexpandering före utvärderingen:

  • Resync_Trigger_*

  • Profile_Rule*

  • Log_xxx_Msg

  • Upgrade_Rule

Under vissa förhållanden genomgår vissa allmänna parametrar (GPP_*) även makroexpansion, vilket uttryckligen anges i avsnittet Valfria omsynkroniseringsargument nedan.

Under makroexpanderingen ersätter innehållet i de namngivna variablerna uttryck i formatet $NAME och $(NAME). Dessa variabler omfattar allmänna parametrar, flera produktidentifierare, vissa händelsetimers och värden för etableringsstatus. En fullständig lista finns i Makroexpansionsvariabler under Etableringsparametrar.

I följande exempel används uttrycket $(MAU) för att infoga MAC-adressen 000E08012345.

Administratören anger: $(MAU)config.cfg

Den resulterande makroexpanderingen för en enhet med MAC-adressen 000E08012345 är: 000E08012345config.cfg

Om ett makronamn inte kan identifieras, sker ingen expandering. Exempelvis identifieras inte namnet STRANGE som ett giltigt makronamn, men det gör däremot MAU.

Administratören anger: $STRANGE$MAU.cfg

Den resulterande makroexpanderingen för en enhet med MAC-adressen 000E08012345 är: $STRANGE000E08012345.cfg

Makroexpandering tillämpas inte rekursivt. Exempelvis expanderas $$MAU” till $MAU” ($$ expanderas) och resulterar inte i MAC-adressen.

Innehållet i specialparametrarna, GPP_SA till och med GPP_SD, mappas till makrouttrycken $SA till och med $SD. Dessa parametrar makroexpanderas endast som argumentet för alternativen --key , --uid och --pwd i en omsynkroniserings-URL.

Villkorsuttryck

Villkorsuttryck kan utlösa omsynkroniseringshändelser och välja bland alternativa URL:er för omsynkroniserings- och uppgraderingsåtgärder.

Ett villkorsuttryck består av en lista med jämförelser, avgränsade med och operatorn. Alla jämförelser måste uppfyllas för att villkoret ska vara sant.

Varje jämförelse kan relatera till någon av följande tre typer av litteraler:

  • Heltalsvärden

  • Versionsnummer för program- eller maskinvara

  • Strängar inom dubbla citattecken

Versionsnummer

Program versionen för Cisco video Phone 8875 använder det här formatet (där BN är versionsnumret):

PHONEOSyyyy.1-0-1-0001-BN

där yyyy indikerar telefonmodellen eller telefonserien. 1 är huvudversionen, 0 är delversionen, 1-0001 är mikroversionen och BN är byggnumret.

Jämförelsesträngen måste använda samma format. Annars returneras ett formatparsningsfel.

När programvaruversionen jämförs, jämförs huvudversion, delversion och mikroversion i följd, och siffrorna längst till vänster ges företräde framför de till höger. Om versionsnumren är identiska jämförs build-numret.

Exempel på giltigt versionsnummer

PHONEOS-8875.1-0-1-0001-19

Jämförelse

Strängar inom citattecken kan jämföras för att identifiera likheter eller olikheter. Heltal och versionsnummer kan även jämföras aritmetiskt. Jämförelseoperatorerna kan anges som symboler eller som akronymer. Akronymer är praktiska för att ange villkoret i en profil med öppet format.

Operatör

Alternativ syntax

Beskrivning

Gäller för heltals- och versionsoperander

Gäller för strängoperander inom citattecken

=

eq

lika med

Ja

Ja

!=

ne

inte lika med

Ja

Ja

<

lt

mindre än

Ja

Nej

<=

le

mindre än eller lika med

Ja

Nej

>

gt

större än

Ja

Nej

>=

ge

större än eller lika med

Ja

Nej

AND

och

Ja

Ja

Det är viktigt att makrovariabler omges med dubbla citattecken där en stränglitteral förväntas. Undvik om ett nummer eller versionsnummer förväntas.

När villkorsuttryck används med Profile_Rule*- och Upgrade_Rule-parametrar måste de inneslutas i syntaxen ”(expr)?” som i det här exemplet på en uppgraderingsregel. Kom ihåg att ersätta BNmed build-numret för den fasta programvaran som det ska uppgraderas till.

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

Använd inte föregående syntax med parenteser för att konfigurera Resync_Trigger_*-parametrar.

URL-syntax

Använd URL-standardsyntax för att ange hur konfigurationsfiler och fast programvara ska hämtas i Profile_Rule*- respektive Upgrade_Rule-parametrar. Syntaxen ser ut så här:

[ scheme:// ] [ server [:port]] filsökväg

Där scheme är något av följande värden:

  • tftp

  • http

  • https

Om scheme utelämnas används tftp. Servern kan vara ett DNS-identifierat värdnamn eller en numerisk IP-adress. Porten är UDP- eller TCP-målportnumret. Filsökvägen måste börja med rotkatalogen (/) och måste vara en absolut sökväg.

Om server saknas används tftp-servern som angetts via DHCP (alternativ 66).

Servern måste anges för uppgraderingsregler.

Om port saknas används standardporten för det angivna schemat. Tftp använder UDP-port 69, http använder TCP-port 80 och https använder TCP-port 443.

En filsökväg måste anges. Den måste inte nödvändigtvis referera till en statisk fil, utan kan ange dynamiskt innehåll som hämtas via CGI.

Makroexpandering används i URL:er. Följande är exempel på giltiga URL:er:

 /$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 använder DHCP-alternativ 66 stöds inte tom syntax av några uppgraderingsregler. Det är bara tillämpligt för profilregel*.

RFC 8188-baserad HTTP-innehållskryptering

Telefonen stöder RFC 8188-baserat HTTP-innehållskryptering med AES-128-GCM chiffrering för konfigurationsfiler. Med den här metoden för kryptering kan alla enheter läsa sidhuvudena för HTTP-meddelandena. Dock kan endast de enheter som känner till Input Keying Material (IKM) läsa lasten. När telefonen är etablerad med IKM kan telefonen och etableringsservern utbyta konfigurationsfiler på ett säkert sätt, samtidigt som nätverkselement från tredje part tillåts använda meddelandenas sidhuvuden för analytiska syften och övervakningssyften.

Parametern för XML-konfiguration IKM_HTTP_Encrypt_Content innehåller IKM på telefonen. Den här parametern är inte tillgänglig på websidan för telefonadministration av säkerhetsskäl. Det är inte heller synligt i telefonens konfigurationsfil vilken du kan komma åt från telefonens IP-adress eller från telefonens konfigurationsrapporter som skickats till etableringsservern.

Om du vill använda den RFC 8188-baserade krypteringen ska du kontrollera följande:

  • Förse telefonen med IKM genom att specificera IKM med XML-parametern IKM_HTTP_Encrypt_Content i konfigurationsfilen som skickats från etableringsservern till telefonen.

  • Om den här krypteringen appliceras på konfigurationsfilerna som skickats från etableringsservern till telefonen, kan du kontrollera att HTTP-sidhuvudet för Innehållskodning i konfigurationsfilen har aes128gcm.

    I avsaknad av detta sidhuvud får metoden AES-256-CBC prioritet. Telefonen tillämpar AES-256-CBC dekryptering om en AES-256-CBC-nyckel finns i en profilregel, oavsett IKM.

  • Se till att det inte finns någon specificerad AES-256-CBC-nyckel i rapportregeln om du vill att telefonen ska applicera denna kryptering till de konfigurationsrapporter som skickas till etableringsservern.

Valfria omsynkroniseringsargument

Valfria argument såsom key, uid och pwd, kan föregå URL som anges i Profile_Rule*-parametrar och omges av hakparenteser.

key

Alternativet --key instruerar telefonen att konfigurationsfilen den tar emot från etableringsservern är krypterad med AES-256-CBC-kryptering, såvida inte sidhuvudet i filen för Innehållskodning anger aes128gcm-kryptering . Själva nyckeln anges som en sträng efter termen --key. Nyckeln kan också omslutas med dubbla citattecken (”). Telefonen använder nyckeln för att dekryptera konfigurationsfilen.

Användningsexempel
[--key VerySecretValue][--key “my secret phrase”][--key a37d2fb9055c1d04883a0745eb0917a4]

De valfria argumenten inom hakparenteser makroexpanderas. Specialparametrar, GPP_SA till och med GPP_SD, makroexpanderas endast till makrovariabler, $SA till och med $SD, om de används som argument till alternativet key. Se följande exempel:

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

I profiler med öppet format måste argumentet för --key vara samma som argumentet för alternativet -k som skickas till openssl.

uid och pwd

Alternativen uidoch pwd kan användas för att ange användar-ID och lösenord som skickas som svar på undersökningar för grundläggande HTTP-autentisering och autentisering för sammanfattning när angiven URL begärs. De valfria argumenten inom hakparenteser makroexpanderas. Specialparametrar, GPP_SA till och med GPP_SD, makroexpanderas endast till makrovariabler, $SA till och med $SD, om de används som argument till alternativet key. Se följande exempel:

GPP_SA = MyUserID GPP_SB = MySecretPassword

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

expanderas till:

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

Datatyper

Följande datatyper används med konfigurationsprofilparametrar:

  • {a, b, c, ...} – Val mellan a, b, c ...

  • Bool – Ett booleskt värde, antingen ”yes” eller ”no”.

  • CadScript – Ett miniskript som anger kadensparametrarna för en signal. Upp till 127 tecken.

    Syntax: S1[;S2], där:

    • 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]]]]]) och kallas för ett avsnitt.

    • oni,j och offi,j är on/off-varaktigheten i sekunder för ett segment. i = 1 eller 2, och j = 1 till 6.

    • Di är avsnittets totala varaktighet i sekunder.

    Alla varaktigheter kan ha upp till tre decimaler för en precision på 1 ms. Jokertecknet ”*” representerar en oändlig varaktighet. Segmenten i ett avsnitt körs i ordning och upprepas tills värdet för den totala varaktigheten nås.

    Exempel 1:

     60(2/4) Antal kadenssektioner = 1 kadens Sektion 1: Sektionslängd = 60 s Antal segment = 1 segment 1: på=2s, av=4s Total ringlängd = 60s

    Exempel 2 – Olika ringsignaler (kort, kort, kort, lång):

     60(.2/.2,.2/.2,.2/.2,1/4) Antal kadenssektioner = 1 kadens Avsnitt 1: Sektionslängd = 60s Antal segment = 4 Segment 1: På=0,2s, Av=0,2s Segment 2: På=0,2s, Av=0,2s Segment 3: På=0,2s, Av=0,2s Segment 4: På=1,0s, Av=4,0s Total ringlängd = 60s

  • DialPlanScript – Skriptsyntax som används för att ange uppringningsplaner för linje 1 och linje 2.

  • Float <n> – Ett flyttalsvärde med upp till n decimaler.

  • FQDN – fullständigt kvalificerat domännamn. Det kan innehålla upp till 63 tecken. Några exempel är:

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

    • sip.Cisco.com eller 109.12.14.12

  • FreqScript – Ett miniskript som anger parametrarna för frekvens och nivå för en ton. Innehåller upp till 127 tecken.

    Syntax: F1@L1[,F2@L2[,F3@L3[,F4@L4[,F5@L5[,F6@L6]]]]], där:

    • F1–F6 är frekvensen i Hz (endast osignerade heltal).

    • L1–L6 är motsvarande nivåer i dBm (med upp till en decimal).

    Blanksteg före och efter kommatecknet är tillåtet men rekommenderas inte.

    Exempel 1 – Signal för samtal väntar:

     440@-10 Antal frekvenser = 1 frekvens 1 = 440 Hz vid –10 dBm

    Exempel 2 – Kopplingston:

     350@-19,440@-19 Antal frekvenser = 2 Frekvens 1 = 350 Hz vid –19 dBm Frekvens 2 = 440 Hz vid –19 dBm

  • IP – Giltig IPv4-adress i formatet x.x.x.x, där x är ett värde mellan 0 och 255. Exempel: 10.1.2.100.

  • UserID – Användar-ID:t så som det visas i en URL. Kan innehålla upp till 63 tecken.

  • Phone – En telefonnummersträng, till exempel 14081234567, *69, *72 eller 345678, eller en allmän URL, till exempel 1234@10.10.10.100:5068 eller jsmith@Cisco.com. Strängen kan innehålla upp till 39 tecken.

  • PhTmplt – En telefonnummermall. Varje mall kan innehålla ett eller flera mönster som avgränsas med komma (,). Blanksteg i början av varje mönster ignoreras. ”?” och ”*” representerar jokertecken. Använd %xx för att representera litteraler. Exempelvis representerar %2a *. Mallen kan innehålla upp till 39 tecken. Exempel: “1408*, 1510*”, “1408123????, 555?1.”.

  • Port – TCP/UDP-portnummer (0-65535). Den kan anges i decimalformat eller i hexadecimalt format.

  • ProvisioningRuleSyntax – Skriptsyntax som används för att definiera regler för konfigurationsomsynkronisering och uppgraderingsregler för fast programvara.

  • PwrLevel – Strömnivå uttryckt i dBm med en decimal, till exempel –13.5 eller 1.5 (dBm).

  • RscTmplt – En mall för statuskoder för SIP-svar, t.ex. “404, 5*”, “61?”, “407, 408, 487, 481”. Den kan innehålla upp till 39 tecken.

  • Sig<n> – Signerat n-bitars värde. Den kan anges i decimalformat eller i hexadecimalt format. Negativa värden måste föregås av ett ”-”-tecken. Ett ”+”-tecken före positiva värden är valfritt.

  • Stjärnkoder – Aktiveringskod för en extra tjänst, t.ex. *69. Koden kan innehålla upp till 7 tecken.

  • Str<n> – En allmän sträng med upp till n icke-reserverade tecken.

  • Time<n> – Tid i sekunder, med upp till n decimaler. Extra decimaler ignoreras.

  • ToneScript – Ett miniskript som anger frekvens-, nivå- och kadensparametrarna för en samtalsförloppston. Skriptet kan innehålla upp till 127 tecken.

    Syntax: FreqScript;Z1[;Z2].

    Avsnitt Z1 liknar avsnitt S1 i ett CadScript, förutom att varje on/off-segment åtföljs av en parameter för frekvenskomponenter: 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]]]]]) där:

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

    • 1 < nk < 6 anger frekvenskomponenterna i FreqScript som används i det segmentet.

    Om mer än en frekvenskomponent används i ett segment summeras komponenterna.

    Exempel 1 – Kopplingston:

     350@-19,440@-19; 10(*/0/1+2) Antal frekvenser = 2 Frekvens 1 = 350 Hz vid –19 dBm Frekvens 2 = 440 Hz vid –19 dBm Antal kadenssektioner = 1 kadens Avsnitt 1: Sektionslängd = 10 s Antal segment = 1 Segment 1: På = för alltid, med frekvenserna 1 och 2 Total tonlängd = 10s

    Exempel 2 – Oregelbunden ton:

     350@-19,440@-19; 2(.1/.1/1+2); 10(*/0/1+2) Antal frekvenser = 2 Frekvens 1 = 350 Hz vid –19 dBm Frekvens 2 = 440 Hz vid –19 dBm Antal kadenssektioner = 2 Kadens Avsnitt 1: Sektionslängd = 2s Antal segment = 1 Segment 1: På=0,1s, Av=0,1s med frekvenserna 1 och 2 Kadens Avsnitt 2: Sektionslängd = 10s Antal segment = 1 Segment 1: På = för alltid, med frekvenserna 1 och 2 Total tonlängd = 12s

  • Uns<n> – Osignerat n-bitarsvärde, där n = 8, 16 eller 32. Det kan anges i decimalt eller hexadecimalt format, såsom 12 eller 0x18, så länge värdet får plats i n bitar.

Ha följande i åtanke:

  • <Par Name> representerar ett konfigurations parameter namn. I en profil skapas motsvarande etikett genom att ersätta blanksteget med understreck "_", till exempel Par_Name.
  • Ett tomt standardvärdefält innebär en tom sträng, < “” >.
  • Telefonen fortsätter att använda de senaste konfigurerade värdena för taggar som inte finns i en viss profil.
  • Mallar jämförs i den angivna ordningen. Den första, inte den närmaste, matchningen väljs. Parameternamnet måste matcha exakt.
  • Om flera definitioner för en parameter anges i en profil, används den sista av dessa definitioner i filen på telefonen.
  • En parameterspecifikation med ett tomt parametervärde återställer parametern till dess standardvärde. Om du i stället vill ange en tom sträng, använder du den tomma strängen ”” som parametervärdet.