- Start
- /
- Artikel
Etableringsparametrar för telefonerna 9800 och 8877 (BroadWorks)
Den här hjälpartikeln gäller Cisco Desk Phone 9800-serien och Cisco Video Phone 8875 som är registrerade på Cisco BroadWorks. Informationen på den här sidan innehåller etableringsparametrarna och deras syntax.
Parametertyper för reservering
Det här avsnittet beskriver etableringsparametrarna ordnade i breda kategorier efter funktion.
Allmänna parametrar
De allmänna GPP_*-parametrarna (
) används som fria strängregister när du konfigurerar telefonen för interaktion med en viss etableringsserverlösning. GPP_*-parametrarna är tomma som standard. De kan konfigureras för att innehålla olika värden, bland annat följande:-
Krypteringsnycklar
-
Webbadresser
-
Statusinformation för multietablering.
-
Postbegärandemallar
-
Mappningar mellan parameternamn och alias
-
Partiella strängvärden som så småningom kopplas ihop till kompletta parametervärden.
GPP_*-parametrarna stöder makroexpandering inuti andra etableringsparametrar. För detta ändamål räcker det att använda makronamn med en versal bokstav (A till P) för att identifiera innehållet i GPP_A till och med GPP_P. Makronamnen med två versala bokstäver, SA till och med SD, identifierar också GPP_SA till och med GPP_SD i särskilda fall när de används som argument för följande URL-alternativ:
key, uid och pwd
Dessa parametrar kan användas som variabler i etablerings- och uppgraderingsregler. Du kan refererar till dem genom att lägga till ett ”$”-tecken först i variabelnamnet, t.ex. $GPP_A.
Aktivera parametrar
Parametrarna Provision_Enable och Upgrade_Enable styr alla åtgärder relaterade till profilomsynkronisering och uppgradering av fast programvara. Dessa parametrar styr omsynkroniseringar och uppgraderingar oberoende av varandra. Dessa parametrar styr även kommandon för omsynkroniserings- och uppgraderings-URL:er som skickas via administrationswebbservern. Standardinställningen för båda parametrarna är Yes.
Parametern Resync_From_SIP kontrollerar åtgärder relaterade till omsynkroniseringsförfrågningar. En SIP NOTIFY-händelse skickas från tjänsteleverantörens proxyserver till telefonen. Om den är aktiverad kan proxyservern begära en omsynkronisering. För att göra det skickar proxyservern ett SIP NOTIFY-meddelande som innehåller Event: resync-huvudet till enheten.
Enheten svarar på begäran med ett 401-svar (auktoriseringen avvisas för angivna inloggningsuppgifter). Enheten förväntar sig en autentiserad efterföljande begäran innan den godkänner omsynkroniseringsbegäran från proxyservern. Event: reboot_now- och Event: restart_now-huvudena utför kalla respektive varma omstarter, vilket också kräver autentiseringssvar.
De två återstående enable-parametrarna är Resync_On_Reset och Resync_After_Upgrade_Attempt. Dessa parametrar avgör om enheten utför en omsynkronisering efter en omstart av programvara och efter varje uppgraderingsförsök.
När Resync_On_Reset används lägger enheten till en slumpmässig fördröjning efter startsekvensen innan återställningen utförs. Fördröjningen är en slumpmässig tid upp till värdet som anges i Resync_Random_Delay (i sekunder). I en grupp med telefoner som startas samtidigt fördelar fördröjningen starttiderna för omsynkroniseringsförfrågningarna från varje enhet. Denna funktion kan vara bra i ett stort bostadsområde om det inträffar lokalt strömavbrott.
Utlösare
Telefonen stöder omsynkronisering vid specifika intervall eller vid en viss tid.
Omsynkronisering vid specifika intervall
Telefonen är utformad att med jämna mellanrum synkronisera med etableringsservern. Omsynkroniseringsintervallet konfigureras i Resync_Periodic (sekunder). Om det här värdet lämnas tomt synkroniseras inte enheten regelbundet.
Omsynkronisering sker typiskt när linjer är inaktiv. Om en röstlinje är aktiv när en omsynkronisering ska utföras, skjuter telefonen upp omsynkroniseringen tills linjen är ledig igen. En omsynkronisering kan resultera i att konfigurationsparametervärden ändras.
En omsynkronisering kan misslyckas om telefonen inte kan hämta en profil från servern, om den nedladdade filen är skadad eller på grund av ett internt fel. Enheten försöker synkronisera igen efter det antal sekunder som anges i Resync_Error_Retry_Delay (sekunder). Om Resync_Error_Retry_Delay har angetts till 0 försöker enheten inte synkronisera igen efter ett misslyckat omsynkroniseringsförsök.
Om en uppgradering misslyckas görs ett nytt försök efter det antal sekunder som anges i Upgrade_Error_Retry_Delay.
Det finns två parametrar som kan konfigureras för villkorsstyrd omsynkronisering: Resync_Trigger_1 och Resync_Trigger_2. Båda parametrarna kan programmeras med ett villkorsuttryck som makroexpanderas. När omsynkroniseringsintervallet går ut (tidpunkten för nästa omsynkronisering) förhindrar utlösarna, om sådana har angetts, omsynkroniseringen om inte en eller flera utlösare utvärderas som sanna.
Följande exempelvillkor utlöser en omsynkronisering. I exemplet har det senaste telefonuppgraderingsförsöket pågått i över 5 minuter (300 sekunder) och det har gått minst 10 minuter (600 sekunder) sedan det senaste omsynkroniseringsförsöket.
$UPGTMR gt 300 and $PRVTMR ge 600
Omsynkronisering vid en specifik tid
Parametern Resync_At gör att telefonen kan synkronisera vid en specifik tidpunkt. Den här parametern använder 24-timmarsformat (hhmm) för att ange tiden.
Parametern Resync_At_Random_Delay gör att telefonen kan synkronisera vid en ospecificerad tidfördröjning. I den här parametern används ett positivt heltal för att ange tiden.
Överbelastning av servern på grund av omsynkroniseringsförfrågningar från flera telefoner som konfigurerats att synkronisera samtidigt bör undvikas. För att göra det utlöser telefonen omsynkroniseringen upp till 10 minuter efter den angivna tiden.
Om du till exempel ställer in omsynkroniseringstiden på 1000 (dvs. kl. 10) utlöser telefonen omsynkroniseringen någon gång mellan 10:00 och 10:10.
Den här funktionen är inaktiverad som standard. Om parametern Resync_At har etablerats, ignoreras Resync_Periodic-parametern.
Konfigurerbara scheman
Du kan konfigurera scheman för regelbundna omsynkroniseringar och du kan ange intervall för omförsök vid omsynkroniserings- och uppdateringsfel genom att använda följande etableringsparametrar:
-
Resync_Periodic
-
Resync_Error_Retry_Delay
-
Upgrade_Error_Retry_Delay
Varje parameter stöder ett enskilt fördröjningsvärde (sekunder). Den nya utökade syntaxen stöder en kommateckenavgränsad lista med flera efterföljande fördröjningselement. Det sista elementet i sekvensen upprepas implicit för alltid.
Om du vill kan du infoga ett plustecken för att ange ett till numeriskt värde som lägger till en extra slumpmässig fördröjning.
Exempel 1
I detta exempel synkroniseras telefonen regelbundet varannan timme. Om det uppstår ett omsynkroniseringsfel gör enheten nya försök enligt följande intervall: 30 minuter, 1 timme, 2 timmar, 4 timmar. Enheten fortsätter att försöka i 4-timmarsintervall tills omsynkroniseringen lyckas.
Resync_Periodic=7200 Resync_Error_Retry_Delay=1800,3600,7200,14400
Exempel 2
I det här exemplet synkroniseras enheten regelbundet varje timme (plus en extra slumpmässig fördröjning på upp till 10 minuter). Om en omsynkronisering misslyckas gör enheten nya försök enligt följande intervall: 30 minuter (plus upp till 5 minuter). 1 timme (plus upp till 10 minuter), 2 timmar (plus upp till 15 minuter). Enheten fortsätter att försöka i 2-timmarsintervall (plus upp till 15 minuter) tills omsynkroniseringen lyckas.
Resync_Periodic=3600+600 Resync_Error_Retry_Delay=1800+300,3600+600,7200+900
Exempel 3
I det här exemplet, om en fjärruppgradering misslyckas, så gör enheten ett nytt uppgraderingsförsök 30 minuter senare, och sedan efter 1 timme och därefter efter 2 timmar. Om uppgraderingen fortfarande misslyckas gör enheten nya uppgraderingsförsök var fjärde till var femte timme tills uppgraderingen lyckas.
Upgrade_Error_Retry_Delay = 1800,3600,7200,14400+3600
Profilregler
Telefonen tillhandahåller flera profilparametrar för fjärrkonfiguration (Profile_Rule*). Det betyder att varje omsynkronisering kan hämta flera filer som hanteras av olika servrar.
I det enklaste scenariot synkroniseras enheten regelbundet mot en profil på en central server, som uppdaterar alla relevanta interna parametrar. Alternativt kan profilen delas upp mellan olika filer. En fil är gemensam för alla telefoner i en distribution. En separat, unik fil tillhandahålls för varje konto. Krypteringsnycklar och certifikatinformation kan tillhandahållas av en annan profil, som lagras på en separat server.
När det är dags för en omsynkronisering utvärderar telefonen de fyra Profile_Rule*-parametrarna i ordning:
-
Profile_Rule
-
Profile_Rule_B
-
Profile_Rule_C
-
Profile_Rule_D
Varje utvärdering kan resultera i att en profil hämtas från en fjärransluten etableringsserver, och kan leda till att vissa interna parametrar uppdateras. Om en utvärdering misslyckas avbryts omsynkroniseringssekvensen och ett nytt försök görs från början baserat på parametern Resync_Error_Retry_Delay (sekunder). Om alla utvärderingar lyckas väntar enheten det antal sekunder som anges i parametern Resync_Periodic och utför sedan en till omsynkronisering.
Innehållet i varje Profile_Rule*-parameter består av en uppsättning alternativ. Alternativen avgränsas med ett |-tecken (lodrätt streck). Varje alternativ består av ett villkorsuttryck, ett tilldelningsuttryck, en profil-URL och eventuella associerade URL-alternativ. Alla dessa komponenter är valfria inom varje alternativ. Följande är de giltiga kombinationerna, och den ordning som de måste anges i, om de används:
[ conditional-expr ] [ assignment-expr ] [[ options ] URL ]
Inom varje Profile_Rule*-parameter måste alla alternativ utom det sista ange ett villkorsuttryck. Det här uttrycket utvärderas och bearbetas på följande sätt:
-
Villkoren utvärderas från vänster till höger tills ett villkor hittas som utvärderas som sant (eller tills ett alternativ utan villkorsuttryck hittas).
-
Associerade tilldelningsuttryck utvärderas, om sådana finns.
-
Om en URL anges som en del av alternativet görs ett försök att hämta profilen som finns på den angivna URL:en. Systemet försöker uppdatera de interna parametrarna i enlighet.
Om alla alternativ har villkorsuttryck och inget utvärderas som sant (eller om hela profilregeln är tom) ignoreras hela Profile_Rule*-parametern. Nästa profilregelparameter i sekvensen utvärderas.
Exempel 1
Det här exemplet synkroniserar ovillkorligt till profilen på den angivna URL:en och utför en HTTP GET-begäran till den fjärranslutna etableringsservern:
http://remote.server.com/cisco/$MA.cfg
Exempel 2
I det här exemplet synkroniserar enheten till två olika URL:er, beroende på registreringsstatusen för linje 1. Om registreringen har gått förlorad kör enheten en HTTP POST-begäran till ett CGI-skript. Enheten skickar innehållet i den makroexpanderade GPP_A-parametern, som kan ge ytterligare information om enhetens status:
($PRVTMR ge 600)? http://p.tel.com/has-reg.cfg | [--inlägg a] http://p.tel.com/lost-reg?
Exempel 3
I det här exemplet synkroniserar enheten om till samma server. Enheten tillhandahåller ytterligare information om ett certifikat inte finns installerat på enheten (för äldre enheter före version 2.0):
("$CCERT" eq "Installerad")? https://p.tel.com/config? | https://p.tel.com/config?cisco$MAU
Exempel 4
I det här exemplet är linje 1 inaktiverad tills GPP_A anges till Provisioned via den första URL:en. Sedan synkroniserar enheten till den andra URL:en:
(“$A” ne “Provisioned”)? (Line_Enable_1_ = “No”;)! https://p.tel.com/init-prov| https://p.tel.com/configs
Exempel 5
I det här exemplet förväntas profilen som servern returnerar innehålla XML-elementtaggar. Dessa taggar måste mappas om till rätt parameternamn baserat på aliasmappningen i GPP_B:
[--alias b] https://p.tel.com/account/$PN$MA.xml
En omsynkronisering anses normalt misslyckad om en begärd profil inte tas emot från servern. Parametern Resync_Fails_On_FNF kan åsidosätta detta standardbeteende. Om Resync_Fails_On_FNF har värdet No accepterar enheten ett ”file-not-found”-svar från servern som en lyckad omsynkronisering. Standardvärdet för Resync_Fails_On_FNF är Yes.
Uppgraderingsregel
Uppgraderingsregeln uppmanar enheten att aktivera en ny inläsning och anger var den finns, om det behövs. Om inläsningsfilen redan finns på enheten försöker enheten inte hämta den. Inläsningsplatsens giltighet har därför ingen betydelse om inläsningen finns i den inaktiva partitionen.
Upgrade_Rule anger att fast programvara, om den skiljer sig från den befintliga, ska hämtas och användas om åtgärden inte begränsas av ett villkorsuttryck eller om Upgrade_Enable är inställt på Nej.
Telefonen tillhandahåller en konfigurerbar parameter för fjärruppgradering, Upgrade_Rule. Den här parametern stöder ungefär samma syntax som parametrarna för profilregeln. URL-alternativ stöds inte för uppgraderingar, men villkorsuttryck och tilldelningsuttryck kan användas. Om villkorsuttryck används kan flera alternativ, avgränsade med |-tecknet, anges i parametern. Syntaxen för respektive alternativ är som följer:
[ conditional-expr ] [ assignment-expr ] URL
Som i fallet med Profile_Rule*-parametrar utvärderar Upgrade_Rule-parametern varje alternativ tills ett villkorsuttryck uppfylls eller tills ett alternativet utan villkorsuttryck hittas. Associerade tilldelningsuttryck utvärderas om sådana finns. Sedan görs ett försök att uppgradera till den angivna URL:en.
Om Upgrade_Rule innehåller en URL utan något villkorsuttryck, uppgraderar enheten till den avbildning av den fasta programvaran som URL:en anger. Efter makroexpandering och utvärdering av regeln försöker enheten inte att uppgradera igen förrän regeln ändras eller kombinationen av schema + server + port + filsökväg ändras.
När enheten försöker uppgradera den fasta programvaran inaktiverar den ljudet i början av processen och startar om i slutet av processen. Enheten startar endast automatiska uppgraderingar baserat på innehållet i Upgrade_Rule om alla röstlinjer är inaktiva (lediga).
Till exempel,
https://10.73.10.223/firmware/PHONEOS-8875.1-0-1-0001-1.loads
I det här exemplet uppgraderar Upgrade_Rule den fasta programvaran till avbildningen som finns på den angivna URL:en.
Här följer ytterligare ett exempel:
(“$F” ne “beta-customer”)? http://p.tel.com/firmware/PHONEOS-8875.1-0-1-0001-1.loads| http://p.tel.com/firmware/PHONEOS-8875.1-0-1-0001-1.loads
Det här exemplet uppmanar enheten att läsa in en av två avbildningar, baserat på innehållet i en allmän parameter, GPP_F.
Etableringsparametrar
Etableringsparametrarna finns på fliken Etablering på telefonens webbsida.
Parametrar för konfigurationsprofilen
Följande tabell beskriver hur parametrarna i avsnittet Parametrar för konfigurationsprofil (Configuration Profile Parameters) på fliken Etablering fungerar och används.
Parameternamn |
Beskrivning och standardvärde |
---|---|
Provision Enable |
Kontrollerar alla omsynkroniseringsåtgärder oberoende av uppgraderingar av den fasta programvaran. Använd värdet Ja om du vill aktivera fjärretablering. Standardvärdet är Ja. |
Resync On Reset |
Utlöser en omsynkronisering efter varje omstart utom för omstarter orsakade av parameteruppdateringar och uppgraderingar av den fasta programvaran. Standardvärdet är Ja. |
Resync Random Delay |
En slumpmässig fördröjning efter startsekvensen innan du utför återställningen anges i sekunder. I en pool av IP-telefonienheter som är schemalagda att starta samtidigt införs en spridning i tider där varje enhet skickar en omsynkroniseringsbegäran till etableringsservern. Denna funktion kan vara bra i ett stort bostadsområde om det inträffar lokalt strömavbrott. Värdet för det här fältet måste vara ett heltal mellan 0 och 65 535. Standardvärdet är 2. |
Resync At (HHmm) |
Antalet timmar och minuter (HHmm) som enheten synkroniserar med etableringsservern. 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. Värdet är tomt som standard. Om värdet är ogiltigt ignoreras parametern. Om den här parametern anges med ett giltigt värde ignoreras Resync Periodic-parametern. |
Resync At Random Delay |
Förhindrar en överbelastning av etableringsservern när ett stort antal enheter startas 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). Till exempel, om den slumpmässiga fördröjningen = (Å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. 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 periodiska omsynkroniseringar med etableringsservern. Den associerade omsynkroniseringstimern aktiveras efter den första lyckade synkroniseringen med servern. Giltiga format är följande:
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 IP-telefonenheten 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 synkronisera igen efter en viss tid som anges i sekunder. Giltiga format är följande:
Om förseningen är 0 försöker enheten inte synkronisera igen efter ett misslyckat omsynkroniseringsförsök. |
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. Standardvärdet är 14 400 sekunder. |
Resync From SIP |
Tillåter att ett SIP NOTIFY-meddelande utlöser en omsynkronisering. Standardvärdet är 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. Standardvärdet är Ja. |
Resync Trigger 1, Resync Trigger 2 |
Konfigurerbara omsynkroniseringsutlösningsvillkor. En omsynkronisering utlöses när den logiska ekvationen i dessa parametrar utvärderas till TRUE. Standardvärdet är (tomt). |
Resync Fails On FNF |
En omsynkronisering anses misslyckad om en begärd profil inte tas emot från servern. Detta kan åsidosättas av den här parametern. Om värdet anges till Nej godtar enheten ett Standardvärdet är Ja. |
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. Standard: Om du applicerar CBC-AES-256-kryptering till konfigurationsfilerna, specificera krypteringsnyckel med nyckelordet till
Du kan också omsluta krypteringsnyckeln med dubbla citattecken (”). |
DHCP Option To Use |
DHCP-alternativ, avgränsade med kommatecken, som används för att hämta fast programvara och profiler. Standardvärdet är 66,160,159,150,60,43,125. |
Log Request Msg |
Den här parametern innehåller meddelandet som skickas till syslog-servern i början av ett omsynkroniseringsförsök. Standardvärdet är |
Log Success Msg |
Syslog-meddelandet som returneras efter ett lyckat omsynkroniseringsförsök. The default value is |
Log Failure Msg |
Syslog-meddelandet som returneras efter ett misslyckat omsynkroniseringsförsök. Standardvärdet är |
Användarkonfigurerbar omsynkning |
Tillåter en användare att synkronisera telefonen från IP-telefonens skärm. Standardvärdet är Ja. |
Parametrar för uppgradering av fast programvara
Följande tabell beskriver hur parametrarna i avsnittet Uppgradera fast programvara på fliken Etablering fungerar och används.
Parameternamn |
Beskrivning och standardvärde |
---|---|
Upgrade Enable |
Tillåter uppgradering av fast programvara oberoende av omsynkroniseringsåtgärder. Standardvärdet är Ja. Konfigurera den här parametern med någon av metoderna:
|
Upgrade Error Retry Delay |
Intervallet för nya uppgraderingsförsök (i sekunder) tillämpas om uppgraderingen misslyckas. Enheten har en feltimer för uppgradering av fast programvara som aktiveras efter en misslyckad uppgradering av den fasta programvaran. Timern initieras med värdet i den här parametern. Nästa uppgradering av den fasta programvaran sker när denna timer räknar ner till noll. Standardvärdet är 3 600 sekunder. Konfigurera den här parametern med någon av metoderna:
|
Upgrade Rule |
Ett uppgraderingsskript för den fasta programvaran som definierar uppgraderingsvillkor och tillhörande adresser till den fasta programvaran. Den använder samma syntax som profilregeln. Använd följande format för att ange uppgraderingsregeln:
Till exempel:
Om inget protokoll anges, antas TFTP. Om du inte anger något servernamn används värden som begär URL-adressen som servernamn. Om du inte anger någon port används standardporten (69 för TFTP, 80 för HTTP eller 443 för HTTPS). Värdet är tomt som standard. Konfigurera den här parametern med någon av metoderna:
|
Log Upgrade Request Msg |
Syslog-meddelande som skickas vid början av ett uppgraderingsförsök av den fasta programvaran. Standard: Konfigurera den här parametern med någon av metoderna:
|
Log Upgrade Success Msg |
Syslog-meddelande som utfärdas efter att ett lyckat uppgraderingsförsök av den fasta programvaran har slutförts. Standardvärdet är Konfigurera den här parametern med någon av metoderna:
|
Log Upgrade Failure Msg |
Syslog-meddelande som utfärdas efter att ett misslyckat uppgraderingsförsök av den fasta programvaran har slutförts. Standardvärdet är Konfigurera den här parametern med någon av metoderna:
|
Peer Firmware Sharing |
Aktiverar eller inaktiverar funktionen Peer Firmware Sharing (PFS). Välj Ja eller Nej för att aktivera eller inaktivera funktionen. Standard: Ja Konfigurera den här parametern med någon av metoderna:
|
Peer Firmware Sharing Log Server |
Anger IP-adressen och porten som UDP-meddelandet skickas till. Till exempel: 10.98.76.123:514 där 10.98.76.123 är IP-adressen och 514 är portnumret. Konfigurera den här parametern med någon av metoderna:
|
Allmänna parametrar
Följande tabell beskriver hur parametrarna i avsnittet Allmänna parametrar på fliken Etablering fungerar och används.
Parameternamn |
Beskrivning och standardvärde |
---|---|
GPP A - GPP P |
De allmänna GPP_*-parametrarna används som fria strängregister när telefonerna konfigureras för interaktion med en viss etableringsserverlösning. De kan konfigureras för att innehålla olika värden, bland annat följande:
Värdet är tomt som standard. |
Variabler för makroexpandering
Vissa makrovariabler identifieras i följande etableringsparametrar:
-
Profile_Rule
-
Profile_Rule_*
-
Resync_Trigger_*
-
Upgrade_Rule
-
Log_*
-
GPP_* (under särskilda omständigheter)
I dessa parametrar identifieras och expanderas syntaxtyper som $NAME eller $(NAME).
Understrängar i makrovariabler kan anges med notationen $(NAME:p) och $(NAME:p:q), där p och q är positiva heltal (tillgängligt i uppdatering 2.0.11 och senare). Den resulterande makroexpanderingen är delsträngen som börjar vid teckenförskjutning p, med längd q (eller till strängslutet om inte q har angetts). Om GPP_A exempelvis innehåller ABCDEF expanderar $(A:2) till CDEF och $(A:2:3) till CDE.
Ett okänt namn översätts inte och $NAME- eller $(NAME)-formatet ändras inte i parametervärdet efter expanderingen.
Parameternamn |
Beskrivning och standardvärde |
---|---|
$ |
Formatet $$ expanderas till ett enda $-tecken. |
A till och med P |
Ersätts med innehållet i de allmänna parametrarna GPP_A till och med GPP_P. |
SA till och med SD |
Ersätts med specialparametrarna GPP_SA till och med GPP_SD. Dessa parametrar innehåller knappar eller lösenord som används i etableringen. $SA till och med $SD känns igen som argument för den valfria URL-kvalificeraren för omsynkronisering, --knapp. |
MA |
MAC-adress med gemena hexadecimala tecken, t.ex. 000e08aabbcc. |
MAU |
MAC-adress med versala hexadecimala tecken, t.ex. 000E08AABBCC. |
MAC |
MAC-adress med gemena hexadecimala tecken och kolon som avgränsar hexadecimala sifferpar. Till exempel 00:0e:08:aa:bb:cc. |
PN |
Produktnamn. Till exempel CP-8875, DP-9851, DP-9871. |
PSN | Produktserienummer. Till exempel V03. |
SN |
Serienummersträng. Till exempel 88012BA01234. |
CCERT |
SSL-klientcertifikatstatus: installerat eller inte installerat. |
IP |
Telefonens IP-adress i det lokala subnätet. Till exempel 192.168.1.100. |
EXTIP |
Telefonens externa IP-adress, så som den visas på Internet. Till exempel 66.43.16.52. |
SWVER |
Programvaruversionssträng. Till exempel, PHONEOS.3-1-1-0104-37 |
HWVER |
Maskinvaruversionssträng. Till exempel 2.0.1 |
PRVST |
Etableringsstatus (en numerisk sträng): -1 = explicit omsynkroniseringsbegäran 0 = omsynkronisering vid start 1 = periodisk omsynkronisering 2 = omsynkronisering misslyckades, nytt försök |
UPGST |
Uppgraderingsstatus (en numerisk sträng): 1 = första uppgraderingsförsöket 2 = uppgradering misslyckades, nytt försök |
UPGERR |
Resultatmeddelande (ERR) för föregående uppgraderingsförsök, till exempel http_get misslyckades. |
PRVTMR |
Sekunder sedan senaste omsynkroniseringsförsök. |
UPGTMR |
Sekunder sedan senaste uppgraderingsförsök. |
REGTMR1 |
Sekunder sedan linje 1 förlorade registrering hos SIP-servern. |
REGTMR2 |
Sekunder sedan linje 2 förlorade registrering hos SIP-servern. |
UPGCOND |
Äldre makronamn. |
SCHEME |
Filåtkomstschemat (TFTP, HTTP eller HTTPS), så som det erhålls efter parsning av omsynkroniserings- eller uppgraderings-URL:en. |
SERV |
Begäran om målserverns värdnamn, så som det erhålls efter parsning av omsynkroniserings- eller uppgraderings-URL:en. |
SERVIP |
Begäran om målserverns IP-adress, så som den erhålls efter parsning av omsynkroniserings- eller uppgraderings-URL:en, möjligen efter en DNS-sökning. |
PORT |
Begäran om UDP-/TCP-målporten, så som den erhålls efter parsning av omsynkroniserings- eller uppgraderings-URL:en. |
PATH |
Begäran om målfilens sökväg, så som den erhålls efter parsning av omsynkroniserings- eller uppgraderings-URL:en. |
ERR |
Resultatmeddelande för omsynkroniserings- eller uppgraderingsförsök. Endast användbart vid generering av syslog-resultatmeddelanden. Värdet sparas i variabeln UPGERR vid uppgraderingsförsök. |
UIDn |
Innehållet i konfigurationsparametern Line n UserID. |
EMS |
Extension Mobility-status |
MUID |
Extension Mobility-användar-ID |
MPWD |
Extension Mobility-lösenord |
Interna felkoder
Telefonen definierar ett antal interna felkoder (X00–X99) som gör det enklare att styra enhetens beteende i samband med vissa feltillstånd.
Parameternamn |
Beskrivning och standardvärde |
---|---|
X00 |
Transportskiktsfel (eller ICMP-fel) när du skickar en SIP-begäran. |
X20 |
Tidsgränsen för SIP-begäran går ut i väntan på ett svar. |
X40 |
Allmänt SIP-protokollfel (till exempel ogiltig codec i SDP i 200 och ACK-meddelanden, eller timeout i väntan på ACK). |
X60 |
Ogiltigt uppringt nummer enligt den angivna uppringningsplanen. |