I den här artikeln
dropdown icon
Tillhandahållande av parametertyper
    Allmänna parametrar
    Aktivera parametrar
    Utlösare
    Konfigurerbara scheman
    Profilregler
    Uppgraderingsregel
dropdown icon
Tilldelningsparametrar
    Konfigurationsprofilparametrar
    Uppgraderingsparametrar för firmware
    Allmänna parametrar
    Makroexpansionsvariabler
    Interna felkoder

Provisioneringsparametrar för 9800-serien och 8875-telefoner (BroadWorks)

list-menuI den här artikeln
list-menuHar du feedback?

Den här hjälpartikeln är för Cisco Desk Phone 9800-serien och Cisco Video Phone 8875 registrerade på Cisco BroadWorks. Informationen på den här sidan innehåller provisioneringsparametrarna och deras syntax.

Tillhandahållande av parametertyper

I det här avsnittet beskrivs provisioneringsparametrarna i stort sett organiserade efter funktion.

Allmänna parametrar

De allmänna parametrarna GPP_* (Administratörsinloggning > avancerat > Röst > Provisioning) används som fria strängregister när telefonen konfigureras för att interagera med en viss provisioneringsserverlösning. Parametrarna GPP_* är tomma som standard. De kan konfigureras för att innehålla olika värden, inklusive följande:

  • Krypteringsnycklar

  • URLs

  • Statusinformation för flerstegsprovisionering.

  • Mallar för postförfrågan

  • Aliasmappningar för parameternamn

  • Partiella strängvärden, så småningom kombinerade till fullständiga parametervärden.

Parametrarna GPP_* är tillgängliga för makroexpansion inom andra provisioneringsparametrar. För detta ändamål räcker makronamn med stora bokstäver (A till och med P) för att identifiera innehållet i GPP_A till GPP_P. Makronamnen på två bokstäver SA till SD identifierar också GPP_SA till GPP_SD som ett specialfall när de används som argument för följande URL-alternativ:

nyckel, uid och pwd

Dessa parametrar kan användas som variabler i etablerings- och uppgraderingsregler. De refereras genom att prefixera variabelnamnet med ett ”$” -tecken, till exempel $ GPP_A.

Aktivera parametrar

Parametrarna Provision_Enable och Upgrade_Enable styr alla åtgärder för återsynkronisering av profil och uppgradering av firmware. Dessa parametrar styr omsynkroniseringar och uppgraderingar oberoende av varandra. Dessa parametrar styr också URL-kommandon för återsynkronisering och uppgradering som utfärdas via administrationswebbservern. Båda dessa parametrar är inställ da på Ja som standard.

Parametern resync_from_SIP styr begäranden om återsynkroniseringsåtgärder. En SIP NOTIFY-händelse skickas från tjänsteleverantörens proxyserver till telefonen. Om aktiverat kan proxyservern begära en omsynkronisering. För att göra det skickar proxyn ett SIP NOTIFY-meddelande som innehåller Event: resync-rubriken till enheten.

Enheten utmanar begäran med ett 401-svar (godkännande vägras för använda referenser). Enheten förväntar sig en autentiserad efterföljande begäran innan den godkänner återsynkroniseringsbegäran från proxyservern. Rubrikerna Event: reboot_now och Event: restart_now utför kalla respektive varma omstarter, som också utmanas.

De två återstående aktiveringarna är Resync_On_Reset och Resync_After_Upgrade_Attempt. Dessa parametrar avgör om enheten utför en återsynkronisering efter omstart av programvaran och efter varje uppgraderingsförsök.

När Resync_On_Reset är aktiverat introducerar enheten en slumpmässig fördröjning som följer uppstartssekvensen innan återställningen utförs. Fördröjningen är en slumpmässig tid upp till det värde som Resync_Random_Delay (i sekunder) anger. I en pool av telefoner som slås på samtidigt sprider denna fördröjning starttiderna för omsynkroniseringsförfrågningarna från varje enhet. Den här funktionen kan vara användbar i en stor bostadsdistribution, vid ett regionalt strömavbrott.

Utlösare

Telefonen låter dig synkronisera igen med specifika intervall eller vid en viss tidpunkt.

Synkronisera igen med specifika intervall

Telefonen är utformad för att synkronisera med provisioneringsservern med jämna mellanrum. Återsynkroniseringsintervallet konfigureras i Resync_Periodic (sekunder). Om det här värdet lämnas tomt synkroniseras inte enheten med jämna mellanrum.

Återsynkroniseringen sker vanligtvis när röstlinjerna är inaktiva. Om en röstlinje är aktiv när en omsynkronisering ska ske, fördröjer telefonen återsynkroniseringsproceduren tills linjen blir inaktiv igen. En omsynkronisering kan orsaka att konfigurationsparametervärden ändras.

En återsynkronisering kan misslyckas eftersom telefonen inte kan hämta en profil från servern, den nedladdade filen är skadad eller ett internt fel inträffade. Enheten försöker synkronisera igen efter en tid som anges i Resync_Error_Retry_Delay (sekunder). Om Resync_Error_Retry_Delay är inställt på 0 försöker enheten inte synkronisera igen efter ett misslyckat återsynkroniseringsförsök.

Om en uppgradering misslyckas utförs ett nytt försök efter Upgrade_Error_Retry_Delay sekunder.

Två konfigurerbara parametrar är tillgängliga för att villkorligt utlösa en omsynkronisering: Resync_Trigger_1 och Resync_Trigger_2. Varje parameter kan programmeras med ett villkorligt uttryck som genomgår makroexpansion. När återsynkroniseringsintervallet löper ut (tid för nästa omsynkronisering) kommer utlösare, om de är inställda, att förhindra återsynkronisering såvida inte en eller flera triggers utvärderas till true.

Följande exempelvillkor utlöser en återsynkronisering. I exemplet har det senaste telefonuppgraderingsförsöket gått mer än 5 minuter (300 sekunder) och minst 10 minuter (600 sekunder) har förflutit sedan det senaste återsynkroniseringsförsöket.

$UPGTMR gt 300 and $PRVTMR ge 600

Synkronisera igen vid en viss tidpunkt

Parametern Resync_At tillåter telefonen att synkronisera igen vid en viss tidpunkt. Denna parameter använder 24-timmarsformatet (hhmm) för att ange tiden.

Parametern Resync_At_Random_Delay tillåter telefonen att synkronisera om med en ospecificerad tidsfördröjning. Den här parametern använder ett positivt heltalsformat för att ange tiden.

Att översvämma servern med återsynkroniseringsbegäranden från flera telefoner som är inställda på att synkronisera på samma gång bör undvikas. För att göra det utlöser telefonen återsynkroniseringen upp till 10 minuter efter den angivna tiden.

Om du till exempel ställer in omsynkroniseringstiden till 1000 (10:00) utlöser telefonen återsynkroniseringen när som helst mellan 10:00 och 10:10.

Som standard är den här funktionen inaktiverad. Om parametern Resync_At är etablerad ignoreras parametern Resync_Periodic.

Konfigurerbara scheman

Du kan konfigurera scheman för periodiska återsynkroniseringar, och du kan ange intervaller för omsynkronisering och uppgraderingsfel med hjälp av följande provisioneringsparametrar:

  • Återsync_Periodisk

  • Återsynkronisering_Error_Återskrivningsfördröjning

  • Uppgradering_Error_Retry_Delay

Varje parameter accepterar ett enda fördröjningsvärde (sekunder). Den nya utökade syntaxen möjliggör en kommaseparerad lista över på varandra följande fördröjningselement. Det sista elementet i sekvensen upprepas implicit för alltid.

Alternativt kan du använda ett plustecken för att ange ett annat numeriskt värde som lägger till en slumpmässig extra fördröjning.

Exempel 1

I det här exemplet synkroniseras telefonen regelbundet varannan timme. Om ett återsynkroniseringsfel inträffar försöker enheten igen med dessa intervall: 30 minuter, 1 timme, 2 timmar, 4 timmar. Enheten fortsätter att försöka med 4 timmars intervall tills den synkroniseras igen.


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). Vid ett återsynkroniseringsfel försöker enheten igen med dessa 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 med två timmars intervall (plus upp till 15 minuter) tills den synkroniseras igen.


Resync_Periodic=3600+600
Resync_Error_Retry_Delay=1800+300,3600+600,7200+900

Exempel 3

I det här exemplet, om ett fjärruppgraderingsförsök misslyckas, försöker enheten uppgraderingen om 30 minuter, sedan igen efter ytterligare en timme och sedan om två timmar. Om uppgraderingen fortfarande misslyckas försöker enheten igen var fjärde till femte timme tills uppgraderingen lyckas.


Upgrade_Error_Retry_Delay  =  1800,3600,7200,14400+3600

Profilregler

Telefonen tillhandahåller flera parametrar för fjärrkonfigurationsprofil (Profile_Rule*). Således kan varje återsynkroniseringsoperation hämta flera filer som olika servrar hanterar.

I det enklaste scenariot synkroniseras enheten regelbundet till en enda 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 ännu en profil som lagras på en separat server.

När en återsynkroniseringsåtgärd ska genomföras utvärderar telefonen de fyra Profile_Rule* parametrarna i följd:

  1. Profil_Rule

  2. Profil_Regel_B

  3. Profil_Rule_C

  4. Profil_Rule_D

Varje utvärdering kan resultera i en profilhämtning från en fjärrprovisioneringsserver, med en eventuell uppdatering av ett antal interna parametrar. Om en utvärdering misslyckas avbryts återsynkroniseringssekvensen och försöks igen från början som anges av parametern Resync_Error_Retry_Delay (sekunder). Om alla utvärderingar lyckas väntar enheten på den andra som anges av parametern Resync_Periodic och utför sedan en ny synkronisering.

Innehållet i varje Profile_Rule* parameter består av en uppsättning alternativ. Alternativen är åtskilda av tecknet | (pipe). Varje alternativ består av ett villkorligt uttryck, ett tilldelningsuttryck, en profil-URL och eventuella tillhörande URL-alternativ. Alla dessa komponenter är valfria inom varje alternativ. Följande är de giltiga kombinationerna och i vilken ordning de måste visas, om de finns:


[ conditional-expr ] [ assignment-expr ] [[ options ] URL ]

Inom varje Profile_Rule* parameter måste alla alternativ utom det sista tillhandahålla ett villkorligt uttryck. Detta uttryck utvärderas och bearbetas enligt följande:

  1. Villkor utvärderas från vänster till höger tills en hittas som utvärderas som sann (eller tills ett alternativ hittas utan villkorligt uttryck).

  2. Eventuellt tillhörande uppdragsuttryck utvärderas, om det finns.

  3. Om en URL anges som en del av det alternativet görs ett försök att ladda ner profilen som finns på den angivna webbadressen. Systemet försöker uppdatera de interna parametrarna i enlighet därmed.

Om alla alternativ har villkorliga uttryck och inget utvärderas till true (eller om hela profilregeln är tom), hoppar hela parametern Profile_Rule* över. Nästa profilregelparameter i sekvensen utvärderas.

Exempel 1

Det här exemplet synkroniseras villkorslöst till profilen på den angivna webbadressen och utför en HTTP GET-begäran till fjärrprovisioneringsservern:


http://remote.server.com/cisco/$MA.cfg

Exempel 2

I det här exemplet synkroniseras enheten igen till två olika webbadresser, beroende på registreringsstatus för rad 1. Vid förlorad registrering utför enheten en HTTP POST till ett CGI-skript. Enheten skickar innehållet i det expanderade makrot GPP_A, vilket kan ge ytterligare information om enhetens tillstånd:


($PRVTMR ge 600)? http://p.tel.com/has-reg.cfg
| [--post a] http://p.tel.com/lost-reg?

Exempel 3

I det här exemplet synkroniseras enheten igen till samma server. Enheten ger ytterligare information om ett certifikat inte är installerat i enheten (för äldre enheter före 2.0):


(“$CCERT” eq “Installed”)? https://p.tel.com/config?
| https://p.tel.com/config?cisco$MAU

Exempel 4

I det här exemplet är rad 1 inaktiverad tills GPP_A är lika med Tillhandahållen via den första webbadressen. Efteråt synkroniseras den till den andra webbadressen:


(“$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 antas profilen som servern returnerar innehålla XML-elementtaggar. Dessa taggar måste mappas om till korrekta parameternamn av aliaskartan lagrad i GPP_B:


[--alias b] https://p.tel.com/account/$PN$MA.xml

En omsynkronisering anses vanligtvis vara 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 är inställt på Nej, accepterar enheten ett svar som inte hittades av filen från servern som en lyckad återsynkronisering. Standardvärdet för resync_fails_on_fnf är Ja.

Uppgraderingsregel

Uppgraderingsregel är att berätta för enheten att aktivera till en ny last och varifrån man ska hämta lasten, om det behövs. Om lasten redan finns på enheten försöker den inte få lasten. Så giltigheten för lastplatsen spelar ingen roll när önskad belastning finns i den inaktiva partitionen.

Upgrade_Rule anger en inläsning av fast programvara som, om den skiljer sig från den aktuella belastningen, kommer att hämtas och tillämpas såvida den inte begränsas av ett villkorligt uttryck eller Upgrade_Enable är inställd på Nej.

Telefonen tillhandahåller en konfigurerbar fjärruppgraderingsparameter, Upgrade_Rule. Den här parametern accepterar syntax som liknar parametrarna för profilregeln. URL-alternativ stöds inte för uppgraderingar, men villkorliga uttryck och tilldelningsuttryck kan användas. Om villkorliga uttryck används kan parametern fyllas i med flera alternativ, åtskilda av tecknet |. Syntaxen för varje alternativ är följande:


[ conditional-expr ] [ assignment-expr ] URL

Som i fallet med Profile_Rule* parametrar utvärderar parametern Upgrade_Rule varje alternativ tills ett villkorligt uttryck är uppfyllt eller ett alternativ inte har något villkorligt uttryck. Det medföljande tilldelningsuttrycket utvärderas, om det anges. Därefter försöker man uppgradera till den angivna webbadressen.

Om Upgrade_Rule innehåller en URL utan ett villkorligt uttryck uppgraderas enheten till den firmware-avbildning som URL-adressen anger. Efter makroexpansion och utvärdering av regeln försöker enheten inte uppgradera igen förrän regeln har ändrats eller den effektiva kombinationen av schema + server + port + filväg har ändrats.

För att försöka uppgradera firmware inaktiverar enheten ljud i början av proceduren och startar om i slutet av proceduren. Enheten startar automatiskt en uppgradering som drivs av innehållet i Upgrade_Rule endast om alla röstlinjer för närvarande är inaktiva.

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 den bild som lagras på den angivna webbadressen.

Här är ett annat 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

I det här exemplet uppmanas enheten att ladda en av två bilder, baserat på innehållet i en allmän parameter, GPP_F.

Tilldelningsparametrar

Du hittar provisioneringsparametrarna på fliken Provisioning på telefonens webbsida.

Konfigurationsprofilparametrar

Följande tabell definierar funktionen och användningen av varje parameter i avsnittet Konfigurationsprofilparametrar under fliken Provisioning.

Tabell 1. Konfigurationsprofilparametrar

Parameternamn

Beskrivning och standardvärde

Aktivera tillhandahållande

Styr alla återsynkroniseringsåtgärder oberoende av uppgraderingsåtgärder för firmware. Ställ in på Ja för att aktivera fjärrprovisionering.

Standardvärdet är Ja.

Synkronisera igen vid återställning

Utlöser en omsynkronisering efter varje omstart förutom omstart som orsakas av parameteruppdateringar och firmwareuppgraderingar.

Standardvärdet är Ja.

Återsynkronisera slumpmässig fördröjning

En slumpmässig fördröjning efter uppstartssekvensen innan återställningen utförs, specificerad i sekunder. I en pool av IP-telefoni-enheter som är schemalagda att starta samtidigt introduceras en spridning i de tider då varje enhet skickar en begäran om återsynkronisering till provisioneringsservern. Den här funktionen kan vara användbar i en stor bostadsdistribution, vid ett regionalt strömavbrott.

Värdet för det här fältet måste vara ett heltal mellan 0 och 65535.

Standardvärdet är 2.

Synkronisera igen vid (HHmm)

Tiden (HHmm) som enheten synkroniserar på nytt med provisioneringsservern.

Värdet för detta fält måste vara ett fyrsiffrigt tal som sträcker sig från 0000 till 2400 för att indikera tiden i HHmm-format. Till exempel indikerar 0959 09:59.

Standardvärdet är tomt. Om värdet är ogiltigt ignoreras parametern. Om parametern är inställd med ett giltigt värde ignoreras parametern Resync Periodic.

Synkronisera igen vid slumpmässig fördröjning

Förhindrar en överbelastning av provisioneringsservern när ett stort antal enheter slås på samtidigt.

För att undvika översvämning av omsynkroniseringsförfrågningar till servern från flera telefoner synkroniseras telefonen om i intervallet mellan timmar och minuter och timmar och minuter plus slumpmässig fördröjning (hhmm, hhmm+random_delay). Till exempel, om den slumpmässiga fördröjningen = (Återsynkronisera vid slumpmässig fördröjning + 30) /60 minuter, omvandlas ingångsvärdet i sekunder till minuter, avrundas upp till nästa minut för att beräkna det slutliga random_delay intervallet.

Det giltiga värdet varierar mellan 600 och 65535.

Om värdet är mindre än 600 är den slumpmässiga interna fördröjningen mellan 0 och 600.

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

Återsynkronisera periodisk

Tidsintervallet mellan periodiska återsynkroniseras med provisioneringsservern. Den tillhörande återsynkroniseringstimern är aktiv först efter den första lyckade synkroniseringen med servern.

De giltiga formaten är följande:

  • Ett heltal

    Exempel: En ingång på 3000 indikerar att nästa återsynkronisering sker på 3000 sekunder.

  • Flera heltal

    Exempel: En ingång på 600,1200,300 indikerar att den första återsynkroniseringen sker på 600 sekunder, den andra återsynkroniseringen sker på 1200 sekunder efter den första och den tredje återsynkroniseringen sker på 300 sekunder efter den andra.

  • Ett tidsintervall

    Exempelvis indikerar en ingång på 2400+30 att nästa omsynkronisering sker mellan 2400 och 2430 sekunder efter en lyckad omsynkronisering.

Ställ in den här parametern till noll för att inaktivera periodisk återsynkronisering.

Standardvärdet är 3600 sekunder.

Återsynkroniseringsfel Fördröjning för försök igen

Om en återsynkronisering misslyckas på grund av att IP-telefoni-enheten inte kunde hämta en profil från servern, eller den nedladdade filen är skadad eller ett internt fel uppstår, försöker enheten synkronisera igen efter en tid som anges i sekunder.

De giltiga formaten är följande:

  • Ett heltal

    Exempel: En ingång på 300 indikerar att nästa försök för återsynkronisering sker på 300 sekunder.

  • Flera heltal

    Exempel: En ingång på 600 200 300 indikerar att det första omförsöket inträffar inom 600 sekunder efter felet, det andra försöket inträffar på 1200 sekunder efter misslyckandet i det första omförsöket och det tredje försöket inträffar på 300 sekunder efter misslyckandet i det andra försöket.

  • Ett tidsintervall

    Exempelvis indikerar en inmatning på 2400+30 att nästa försök inträffar mellan 2400 och 2430 sekunder efter ett återsynkroniseringsfel.

Om fördröjningen är inställd på 0 försöker enheten inte synkronisera igen efter ett misslyckat återsynkroniseringsförsök.

Tvingad återsynkroniseringsfördröjning

Maximal fördröjning (i sekunder) telefonen väntar innan en återsynkronisering utförs.

Enheten synkroniseras inte igen medan en av dess telefonlinjer är aktiv. Eftersom en omsynkronisering kan ta flera sekunder är det önskvärt att vänta tills enheten har varit inaktiv under en längre period innan den synkroniseras igen. Detta gör det möjligt för en användare att ringa samtal i följd utan avbrott.

Enheten har en timer som börjar räkna ner när alla dess linjer blir inaktiva. Denna parameter är räknarens initiala värde. Återsynkroniseringshändelser försenas tills denna räknare minskar till noll.

Det giltiga värdet ligger mellan 0 och 65535.

Standardvärdet är 14 400 sekunder.

Återsynkronisera från SIP

Aktiverar att en återsynkronisering kan utlösas via ett SIP NOTIFY-meddelande.

Standardvärdet är Ja.

Synkronisera igen efter uppgraderingsförsök

Aktiverar eller inaktiverar återsynkroniseringsåtgärden efter en uppgradering. Om Ja är markerat aktiveras synkroniseringen.

Standardvärdet är Ja.

Återsynkronisera utlösare 1, återsynkronisera utlösare 2

Konfigurerbara återsynkroniseringsutlösningsförhållanden. En återsynkronisering utlöses när den logiska ekvationen i dessa parametrar utvärderas till SANT.

Standardvärdet är (tomt).

Resync misslyckas på FNF

En omsynkronisering anses misslyckad om en begärd profil inte tas emot från servern. Detta kan åsidosättas av denna parameter. När den är inställd på nej accepterar enheten ett file-not-fun n-svar från servern som en lyckad återsynkronisering.

Standardvärdet är Ja.

Profilregel

Profilregel B


Profilregel C


Profilregel D

Varje profilregel informerar telefonen om en källa från vilken en profil ska hämtas (konfigurationsfil). Under varje återsynkronisering tillämpar telefonen alla profiler i följd.

Standard: /$psn.xml

Om du använder AES-256-CBC-kryptering på konfigurationsfilerna anger du krypteringsnyckeln med nyckelordet --key enligt följande:

[--nyckel] <encryption key>

Du kan bifoga krypteringsnyckeln med dubbla citattecken (”) valfritt.

DHCP-alternativ att använda

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

Standardvärdet är 66,160,159,150,60,43,125.

Loggförfrågan Meddelande

Den här parametern innehåller meddelandet som skickas till syslog-servern i början av ett återsynkroniseringsförsök.

Standardvärdet är $PN $MAC —Begär% $SCHEME: //$SERVIP: $PORT$PATH.

Logga framgångsmeddelande

Det syslog-meddelande som utfärdas när ett återsynkroniseringsförsök har slutförts.

Standardvärdet är $PN $MAC —Successful Resync% $SCHEME: //$SERVIP: $PORT$PATH -- $ERR.

Meddelande om loggfel

Det syslog-meddelande som utfärdas efter ett misslyckat återsynkroniseringsförsök.

Standardvärdet är $PN $MAC -- Återsynkronisering misslyckades: $ERR.

Användarkonfigurerbar återsynkronisering

Tillåter en användare att synkronisera telefonen igen från IP-telefonskärmen.

Standardvärdet är Ja.

Uppgraderingsparametrar för firmware

Följande tabell definierar funktionen och användningen av varje parameter i avsnittet Firmware Upgrade på fliken Provisioning.

Tabell 2. Uppgraderingsparametrar för firmware

Parameternamn

Beskrivning och standardvärde

Uppgradera Aktivera

Aktiverar uppgradering av firmware oberoende av återsynkroniseringsåtgärder.

Standardvärdet är Ja.

Konfigurera den här parametern med en av metoderna:

  • I telefonkonfigurationsfilen med XML (cfg.xml) anger du en sträng i detta format: <Upgrade_Enable ua="na">Ja</Upgrade_Enable>

  • På webbsidan för telefonadministration ställer du in det här fältet till Ja eller Nej.

Uppgraderingsfel Fördröjning för nytt försök

Upgraderingsförsöksintervallet (i sekunder) tillämpas om uppgraderingen misslyckades. Enheten har en feltimer för firmwareuppgradering som aktiveras efter ett misslyckat uppgraderingsförsök till firmware. Timern initieras med värdet i denna parameter. Nästa uppgraderingsförsök till firmware inträffar när timern räknar ner till noll.

Standardvärdet är 3600 sekunder.

Konfigurera den här parametern med en av metoderna:

  • I telefonkonfigurationsfilen med XML (cfg.xml) anger du en sträng i detta format: <Upgrade_Error_Retry_Delay ua="na">3600</Upgrade_Error_Retry_Delay>

  • Ställ in värdet på telefonadministrationens webbsida.

Uppgraderingsregel

Ett skript för uppgradering av firmware som definierar uppgraderingsvillkor och tillhörande webbadresser för firmware. Den använder samma syntax som profilregel.

Använd följande format för att ange uppgraderingsregeln:

<tftp|http|https>://<ip address><:port>/<path>/<load name>

Till exempel:

tftp://192.168.1.5/firmware/PHONEOS-8875.1-0-1-0001-1.loads
http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads

Om inget protokoll anges antas TFTP. Om inget servernamn anges används den värd som begär webbadressen som servernamn. Om ingen port anges används standardporten (69 för TFTP, 80 för HTTP eller 443 för HTTPS).

Standardvärdet är tomt.

Konfigurera den här parametern med en av metoderna:

  • I telefonkonfigurationsfilen med XML (cfg.xml) anger du en sträng i detta format: <Upgrade_Rule ua="na">http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads</Upgrade_Rule>

  • På webbsidan för telefonadministration anger du sökvägen där laddningsfilen lagras.

Logga Uppgraderingsbegäran Msg

Syslog-meddelande utfärdat i början av ett firmwareuppgraderingsförsök.

Standard: $PN $MAC -- Begär uppgradering $SCHEME: //$SERVIP: $PORT$PATH

Konfigurera den här parametern med en av metoderna:

  • I telefonkonfigurationsfilen med XML (cfg.xml) anger du en sträng i följande format: <Log_Upgrade_Request_Msg ua="na">$PN $MAC -- Begär uppgradering $SCHEME: //$SERVIP: $PORT$PATH</Log_Upgrade_Request_Msg>

  • Anpassa parametern efter behov på telefonadministrationens webbsida.

Meddelande om framgångsrik uppgradering av loggfiler

Syslog-meddelande utfärdat efter att ett försök till uppgradering av fast programvara har slutförts framgångsrikt.

Standardvärdet är $PN $MAC -- Lyckad uppgradering $SCHEME: //$SERVIP: $PORT$PATH -- $ERR

Konfigurera den här parametern med en av metoderna:

  • I telefonkonfigurationsfilen med XML (cfg.xml) anger du en sträng i detta format: <Log_Upgrade_Success_Msg ua="na">$PN $MAC -- Lyckad uppgradering $SCHEME: //$SERVIP: $PORT$PATH -- $ERR</Log_Upgrade_Success_Msg>

  • Anpassa parametern efter behov på telefonadministrationens webbsida.

Meddelande om fel vid logguppgradering

Syslog-meddelande utfärdat efter ett misslyckat uppgraderingsförsök till firmware.

Standardvärdet är $PN $MAC -- Uppgraderingen misslyckades: $ERR

Konfigurera den här parametern med en av metoderna:

  • Ange en sträng i följande format i telefonkonfigurationsfilen med XML (cfg.xml): <Log_Upgrade_Failure_Msg ua="na">$PN $MAC -- Uppgraderingen misslyckades: $</Log_Upgrade_Failure_Msg> ERR

  • Anpassa parametern efter behov på telefonadministrationens webbsida.

Delning av inbyggd programvara

Aktiverar eller inaktiverar funktionen PFS (Peer Firmware Sharing). Välj Ja eller Nej för att aktivera eller inaktivera funktionen.

Standard: Ja

Konfigurera den här parametern med en av metoderna:

  • I telefonkonfigurationsfilen med XML (cfg.xml) anger du en sträng i detta format: <Peer_Firmware_Sharing ua="na">Ja</Peer_Firmware_Sharing>

  • På webbsidan för telefonadministration ställer du in det här fältet till Ja eller Nej.

Loggserver för delning av inbyggd programvara

Anger IP-adressen och porten till vilken UDP-meddelandet skickas.

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 en av metoderna:

  • I telefonkonfigurationsfilen med XML (cfg.xml) anger du en sträng i detta format: <Peer_Firmware_Sharing_Log_Server ua="na">10.98.</Peer_Firmware_Sharing_Log_Server> 76. 123:514

  • Ange loggserverns adress på webbsidan för telefonadministration.

Allmänna parametrar

Följande tabell definierar funktionen och användningen av varje parameter i avsnittet Allmänna parametrar på fliken Provisioning.

Tabell 3. Allmänna parametrar

Parameternamn

Beskrivning och standardvärde

GPP A - GPP P

De allmänna parametrarna GPP_* används som fria strängregister när telefonerna konfigureras för att interagera med en viss provisioneringsserverlösning. De kan konfigureras för att innehålla olika värden, inklusive följande:

  • Krypteringsnycklar.

  • Webbadresser.

  • Statusinformation för flerstegsprovisionering.

  • Mallar för postförfrågan.

  • Parameternamns aliasmappningar.

  • Partiella strängvärden, så småningom kombinerade till fullständiga parametervärden.

Standardvärdet är tomt.

Makroexpansionsvariabler

Vissa makrovariabler identifieras inom följande provisioneringsparametrar:

  • Profil_Rule

  • Profil_regel_*

  • Återsynkronisera utlösare_*

  • Uppgradering_regel

  • Logg_*

  • GPP_* (under särskilda villkor)

Inom dessa parametrar identifieras och utvidgas syntaxtyper, till exempel $NAME eller $ (NAME).

Makrovariabel-delsträngar kan specificeras med notationen $ (Namn:P) och $ (Namn:P: Q), där p och q är icke-negativa heltal (tillgängliga i version 2.0.11 och högre). Den resulterande makroexpansionen är delsträngen som börjar vid teckenförskjutning p, med längd q (eller annars till slutet av strängen om q inte anges). Om GPP_A till exempel innehåller ABCDEF expanderar $ (A:2) till CDEF och $ (A: 2:3) till CDE.

Ett okänt namn översätts inte och formen $NAME eller $ (NAME) förblir oförändrad i parametervärdet efter expansion.

Parameternamn

Beskrivning och standardvärde

$

Formuläret $$ expanderar till ett enda $ tecken.

A till och med P

Ersätts av innehållet i de allmänna parametrarna GPP_A till GPP_P.

SA genom SD

Ersätts av specialparametrar GPP_SA genom GPP_SD. Dessa parametrar innehåller nycklar eller lösenord som används vid etablering.

$SA till $SD identifieras som argument för den valfria resync-URL- kvalificeraren, --key.

MA

MAC-adress med små hexsiffror, till exempel 000e08aabbcc.

MAU

MAC-adress med stora hexsiffror, till exempel 000E08AABBCC.

MAC

MAC-adress med små hexsiffror och kolon för att separera hexsifferpar. Till exempel 00:0 e: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

Status för SSL-klientcertifikat: Installerat eller Ej installerat.

IP

IP-adressen för telefonen inom dess lokala delnät. Till exempel 192.168.1.100.

EXTIP

Extern IP på telefonen, som ses på Internet. Till exempel 66.43.16.52.

SWVER

Programversionsträng. Till exempel

PHONEOS.3-1-1-0104-37

HWVER

Hårdvaruversionsträng. Till exempel 2.0.1

PRVST

Tilldelningstillstånd (en numerisk sträng):

-1 = uttrycklig återsynkroniseringsbegäran

0 = återsynkronisering av uppstart

1 = periodisk återsynkronisering

2 = omsynkronisering misslyckades, försök igen

UPGST

Uppgraderingstillstånd (en numerisk sträng):

1 = första uppgraderingsförsöket

2 = uppgraderingen misslyckades, försök igen

UPGERR

Resultatmeddelande (ERR) från tidigare uppgraderingsförsök; till exempel http_get misslyckades.

PRVTMR

Sekunder sedan senaste återsynkroniseringsförsök.

UPGTMR

Sekunder sedan senaste uppgraderingsförsöket.

REGTMR1

Sekunder sedan linje 1 förlorade registreringen med SIP-servern.

REGTMR2

Sekunder sedan Line 2 förlorade registreringen med SIP-servern.

UPGCOND

Äldre makronamn.

SCHEME

Filåtkomstschema, ett av TFTP, HTTP eller HTTPS, som erhållits efter att ha analyserat resync eller uppgraderings-URL.

SERV

Begär värdnamn för målservern, som erhållits efter att ha analyserat resync- eller uppgraderings-URL.

SERVIP

Begär målserverns IP-adress, som erhållits efter att ha analyserat resync- eller uppgraderings-URL, eventuellt efter DNS-sökning.

PORT

Begär mål-UDP/TCP-port, som erhållits efter att ha analyserat resync- eller uppgraderings-URL.

PATH

Begär sökväg för målfilen, som erhållits efter att ha analyserat resync eller uppgraderings-URL.

ERR

Resultatmeddelande om återsynkronisering eller uppgraderingsförsök. Endast användbart för att generera resultatsyslog-meddelanden. Värdet bevaras i variabeln UPGERR vid uppgraderingsförsök.

UIDn

Innehållet i konfigurationsparametern Line n UserID.

EMS

Extension MobilityStatus

MUID

Extension MobilityAnvändar-ID

MPWD

Extension MobilityLösenord

Interna felkoder

Telefonen definierar ett antal interna felkoder (X00—X99) för att underlätta konfigurationen för att ge finare kontroll över enhetens beteende under vissa felförhållanden.

Tabell 4. Interna felkoder

Parameternamn

Beskrivning och standardvärde

X00

Transportlager (eller ICMP) fel när du skickar en SIP-förfrågan.

X20

SIP-förfrågan går ut medan du väntar på svar.

X40

Allmänt SIP-protokollfel (till exempel oacceptabel codec i SDP i 200- och ACK-meddelanden, eller tidsavbrott medan du väntar på ACK).

X60

Uppringt nummer ogiltigt enligt angiven uppringningsplan.

Var den här artikeln användbar?
Var den här artikeln användbar?