Klargjøringsparametertyper

Dette området beskriver klargjøringsparametere bredt organisert i henhold til funksjon.

Generelle parametere

Generelle parametere GPP_* (Administratorpålogging > avansert > Stemme > Klargjøring) brukes som frie strengeregistre ved konfigurasjon av telefonen for å samhandle med en bestemt løsning for klargjøringsserver. GPP_*-parametrene er som standard tomme. De kan konfigureres til å inneholde forskjellige verdier, inkludert følgende:

  • krypteringsnøkler

  • URL-er

  • statusinformasjon om flertrinnsklargjøring

  • POST-forespørselsmaler

  • aliasmatriser for parameternavn

  • delvise strengverdier, eventuelt satt sammen til fullstendige parameterverdier

GPP_*-parametrene er tilgjengelige for makroutvidelse i andre klargjøringsparametre. Til dette er makronavn med én stor bokstav (A til P) tilstrekkelig til å identifisere innholdet i GPP_A til GPP_P. Makronavnene med to store bokstaver fra SA til SD identifiserer dessuten GPP_SA til GPP_SD som et spesielt tilfelle når de brukes som argumenter i følgende URL-alternativ:

key, uid og pwd

Disse parametrene kan brukes som variabler i klargjørings- og oppgraderingsregler. De kan refereres til ved at man setter et '$'-tegn, som for eksempel $GPP_A, foran variabelnavnet.

Aktivere parametere

Parametrene Provision_Enable og Upgrade_Enable styrer all resynkronisering av profiler og oppgradering av fastvare. Disse parameterne styrer resynkronisering og oppgraderinger uavhengig av hverandre. Disse parametrene styrer også URL-kommandoer for resynkronisering og oppgradering som utstedes gjennom administrasjonsnettserveren. Begge disse parametrene angis til Yes (Ja) som standard.

Parameteren Resync_From_SIP styrer resynkroniseringsforespørsler. Det sendes en SIP-varslingshendelse fra tjenesteleverandørens proxyserver til telefonen. Hvis dette er aktivert, kan proxyserveren be om resynkronisering. Proxyserveren gjør dette ved å sende en SIP-varslingsmelding som inneholder hodet Event: resync, til enheten.

Enheten utfordrer forespørselen med et 401-svar (godkjenning avvist for benyttet påloggingsinformasjon). Enheten forventer en godkjent påfølgende forespørsel før den oppfyller resynkroniseringsforespørselen fra proxyserveren. Hodene Event: reboot_now og Event: restart_now utfører henholdsvis kalde og varme omstarter, som også blir utfordret.

De to gjenstående aktiveringsparametrene er Resync_On_Reset og Resync_After_Upgrade_Attempt. Disse parametrene bestemmer om enheten skal utføre resynkronisering etter at oppstartsprogramvaren har startet på nytt, og etter hvert oppgraderingsforsøk.

Når Resync_On_Reset aktiveres, introduserer enheten en tilfeldig forsinkelse som kommer etter oppstartssekvensen, før tilbakestillingen utføres. Forsinkelsen er en tilfeldig tidsverdi opptil verdien som Resync_Random_Delay (i sekunder) angir. I en gruppe telefoner som slås på samtidig, sprer denne forsinkelsen starttidspunktene for de enkelte enhetenes resynkroniseringsforespørsler. Funksjonen kan være nyttig ved store distribusjoner i boligområder hvis det oppstår strømbrudd.

Utløserparametre

Telefonen kan resynkronisere med bestemte mellomrom eller på et bestemt tidspunkt.

Resynkronisere ved bestemte intervaller

Telefonen er laget for å resynkronisere regelmessig med klargjøringsserveren. Resynkroniseringsintervallet konfigureres i Resync_Periodic (sekunder). Hvis verdien blir stående tom, resynkroniserer ikke enheten regelmessig.

Resynkroniseringen foregår vanligvis mens talelinjene er ledige. Hvis en talelinje er aktiv når det er tid for en resynkronisering, utsetter telefonen resynkroniseringen til linjen blir ledig igjen. En resynkronisering kan føre til at konfigurasjonsparameterverdiene endres.

En resynkroniseringsoperasjonen kan mislykkes fordi telefonen ikke kan hente en profil fra serveren, fordi den nedlastede filen er skadet, eller fordi det har oppstått en intern feil. Enheten prøver å resynkronisere på nytt etter et intervall som angis i Resync_Error_Retry_Delay (sekunder). Hvis Resync_Error_Retry_Delay angis til 0, prøver ikke enheten å resynkronisere på nytt etter et mislykket resynkroniseringsforsøk.

Hvis en oppgradering mislykkes, utføres et nytt forsøk etter Upgrade_Error_Retry_Delay sekunder.

To konfigurerbare parametere er tilgjengelige for betinget utløsing av resynkroniseringer: Resync_Trigger_1 og Resync_Trigger_2. Hver parameter kan programmeres med et betingelsesuttrykk som gjennomgår makroutvidelse. Når resynkroniseringsintervallet utløper (tid for neste resynkronisering), hindrer eventuelle utløsere resynkroniseringen med mindre én eller flere utløsere vurderes som sanne.

Følgende eksempelbetingelse utløser en resynkronisering. I eksempelet har siste forsøk på telefonoppgradering oversteget 5 minutter (300 sekunder), og minst 10 minutter (600 sekunder) har gått siden siste resynkroniseringsforsøk.

$UPGTMR gt 300 og $PRVTMR ge 600

Resynkronisere på et bestemt tidspunkt

Parameteren Resync_At gjør det mulig for telefonen å resynkronisere på et angitt tidspunkt. Denne parameteren bruker 24-timersformat (ttmm) til å angi tidspunktet.

Parameteren Resync_At_Random_Delay gjør det mulig for telefonen å resynkronisere etter en ikke nærmere angitt forsinkelse. Parameteren bruker et positivt heltall til å angi tidspunktet.

Man bør unngå å oversvømme serveren med resynkroniseringsforespørsler fra mange telefoner som er satt til å resynkronisere på det samme tidspunktet. For å gjøre dette utløser telefonen resynkroniseringen opptil 10 minutter etter det angitte tidspunktet.

Hvis for eksempel du angir resynkroniseringstidspunktet til 1000 (kl. 10), utløser telefonen resynkroniseringen en gang mellom kl. 10 og kl. 10.10.

Funksjonen er som standard deaktivert. Hvis parameteren Resync_At blir klargjort, ignoreres parameteren Resync_Periodic.

Konfigurerbare planer

Du kan konfigurere tidsplaner for regelmessig resynkronisering, og du kan angi omprøvingsintervaller for resynkroniserings- og oppgradingsfeil ved hjelp av disse klargjøringsparametrene:

  • Resync_Periodic

  • Resync_Error_Retry_Delay

  • Upgrade_Error_Retry_Delay

Hver parameter godtar en enkelt forsinkelsesverdi (sekunder). Den nye utvidede syntaksen tillater en kommadelt liste over påfølgende forsinkelseselementer. Det siste elementet i sekvensen gjentas implisitt i det uendelige.

Du kan dessuten bruke et plusstegn til å angi en annen tallverdi som legger til en tilfeldig ekstra forsinkelse.

Eksempel 1

I dette eksemplet resynkroniserer telefonen regelmessig annenhver time. Hvis det oppstår en resynkroniseringsfeil, prøver enheten på nytt med disse intervallene: 30 minutter, 1 time, 2 timer, 4 timer. Enheten fortsetter å prøve med 4-timers intervaller til resynkroniseringen fullføres.

 Resync_Periodic=7200 Resync_Error_Retry_Delay=1800,3600,7200,14400

Eksempel 2

I dette eksemplet resynkroniserer enheten regelmessig hver time (pluss en ekstra tilfeldig forsinkelse på opptil 10 minutter). Hvis det oppstår en resynkroniseringsfeil, prøver enheten på nytt med disse intervallene: 30 minutter (pluss opptil 5 minutter). 1 time (pluss opptil 10 minutter), 2 timer (pluss opptil 15 minutter). Enheten fortsetter å prøve med 2-timers intervaller (pluss opptil 15 minutter) til resynkroniseringen fullføres.

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

Eksempel 3

Hvis et forsøk på ekstern oppgradering mislykkes, prøver enheten å oppgradere på nytt etter 30 minutter, deretter på nytt etter nok en time og deretter etter to timer. Hvis oppgraderingen fremdeles mislykkes, forsøker enheten på nytt hver fjerde til femte time helt til oppgraderingen fullføres.

Upgrade_Error_Retry_Delay  =  1800,3600,7200,14400+3600

Profilregler

Telefonen har flere profilparametre for ekstern konfigurasjon (Profile_Rule*). På denne måten kan hver resynkroniseringsoperasjon hente flere filer administrert av ulike servere.

I det enkleste scenarioet resynkroniserer enheten regelmessig til en enkelt profil på en sentral server som oppdaterer alle relevante interne parametre. Profilen kan eventuelt deles mellom forskjellige filer. Én fil er felles for alle telefonene i en distribusjon. En egen, unik fil gis til hver konto. Krypteringsnøkler og sertifikatinformasjon kan leveres av en annen profil, lagret på en separat server.

Når det er tid for en resynkroniseringsoperasjon, evaluerer telefonen de fire Profile_Rule*-parametrene i rekkefølge:

  1. Profile_Rule

  2. Profile_Rule_B

  3. Profile_Rule_C

  4. Profile_Rule_D

Hver evaluering kan føre til at det hentes en profil fra en ekstern klargjøringsserver, med en eventuell oppdatering av noen interne parametre. Hvis en evaluering mislykkes, avbrytes resynkroniseringssekvensen, og den prøves på nytt fra begynnelsen som angitt av parameteren Resync_Error_Retry_Delay (sekunder). Hvis alle evalueringer lykkes, venter enheten på den neste som angitt av parameteren Resync_Periodic og utfører deretter en ny resynkronisering.

Innholdet i hver Profile_Rule*-parameter består av et sett med alternativer. Alternativene er atskilt med tegnet | . Hvert alternativ består av et betingelsesuttrykk, et tilordningsuttrykk, en profil-URL-adresse og eventuelle tilknyttede URL-alternativer. Alle disse komponentene er valgfrie innenfor hvert alternativ. Nedenfor finner du gyldige kombinasjoner og rekkefølgen som de må vises i, hvis de er til stede:

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

Innenfor hver Profile_Rule*-parameter må alle alternativer bortsett fra det siste angi et betingelsesuttrykk. Dette uttrykket evalueres og behandles som følger:

  1. Betingelser evalueres fra venstre mot høyre helt til det blir funnet én som vurderes som sann (eller til det blir funnet ett alternativ uten betingelsesuttrykk).

  2. Eventuelle medfølgende tilordningsuttrykk evalueres.

  3. Hvis en URL-adresse er angitt som en del av dette alternativet, blir det gjort forsøk på å laste ned profilen som ligger på den angitte URL-adressen. Systemet forsøker å oppdatere interne parametrene i samsvar med dette.

Hvis alle alternativer har betingelsesuttrykk og ingen vurderes som sanne (eller hvis hele profilregelen er tom), blir hele Profile_Rule*-parameteren hoppet over. Den neste profilregelparameteren i sekvensen evalueres.

Eksempel 1

Dette eksemplet resynkroniserer uten betingelser til profilen på den angitte URL-adressen og utfører en HTTP GET-forespørsel til den eksterne klargjøringsserveren:

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

Eksempel 2

I dette eksempelet resynkroniseres enheten til to ulike URL-er, avhengig av registreringstilstanden for Linje 1. Ved tapt registrering utfører enheten en HTTP POST til et CGI-skript. Enheten sender innholdet i den makroutvidede GPP_A, som kan gi ytterligere informasjon om enhetstilstanden:

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

Eksempel 3

I dette eksemplet resynkroniserer enheten til den samme serveren. Enheten gir mer informasjon hvis det ikke er installert et sertifikat i enheten (for eldre enheter før 2.0):

 ("$CCERT" eq "Installert")? https://p.tel.com/config? | https://p.tel.com/config?cisco$MAU

Eksempel 4

I dette eksemplet deaktiveres linje 1 inntil GPP_A angis lik Provisioned (Klargjort) i den første URL-adressen. Etterpå resynkroniserer den til den andre URL-adressen:

(“$A” ne “Provisioned”)? (Line_Enable_1_ = “No”;)! https://p.tel.com/init-prov| https://p.tel.com/configs

Eksempel 5

Dette eksemplet forutsetter at profilen som serveren returnerer, inneholder XML-elementkoder. Disse kodene må tilordnes gyldige parameternavn ved hjelp av aliasmatrisen lagret i GPP_B:

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

En resynkronisering regnes vanligvis som mislykket hvis det ikke mottas en forespurt profil fra serveren. Parameteren Resync_Fails_On_FNF kan overstyre denne standardvirkemåten. Hvis Resync_Fails_On_FNF settes til No (Nei), godtar enheten et finner ikke filen-svar fra serveren som en vellykket resynkronisering. Standard verdi for Resync_Fails_On_FNF er Yes (Ja).

Oppgraderingsregel

En oppgraderingsregel gir enheten beskjed om å aktivere en nedlasting og eventuelt hvor lasten skal hentes. Hvis belastningen allerede er på enheten, vil den ikke forsøke å få belastningen. Gyldigheten til belastningsplasseringen betyr ikke noe når ønsket belastning er i den inaktive delingen.

Upgrade_Rule angir en fastvarenedlasting som, hvis den er ulik den eksisterende lasten, blir lastet ned og tatt i bruk, med mindre handlingen hindres av et betingelsesuttrykk, eller Upgrade_Enable er satt til No (Nei).

Telefonen har én konfigurerbar parameter for ekstern oppgradering, Upgrade_Rule. Parameteren godtar syntaks som er lik syntaksen til profilregelparametrene. URL-alternativer støttes ikke for oppgraderinger, men betingelsesuttrykk og tilordningsuttrykk kan brukes. Hvis det brukes betingelsesuttrykk, kan parameteren fylles med flere alternativer, atskilt med tegnet |. Syntaksen for hver alternativ er som følger:

[ conditional-expr ] [ assignment-expr ] URL

Som ved Profile_Rule*-parametre evaluerer Upgrade_Rule-parameteren hvert alternativ inntil et betingelsesuttrykk er oppfylt eller et alternativ ikke har noe betingelsesuttrykk. Eventuelle medfølgende tilordningsuttrykk evalueres. Deretter gjøres det forsøk på å oppgradere med den angitte URL-adressen.

Hvis Upgrade_Rule inneholder en URL-adresse uten et betingelsesuttrykk, oppgraderer enheten til fastvarebildet som URL-adressen angir. Etter makroutvidelse og evaluering av regelen forsøker ikke enheten å oppgradere enheten på nytt til regelen er endret, eller til den effektive kombinasjonen av plan + server + port + filbane er endret.

Ved forsøk på oppgradering av fastvaren deaktiverer enheten lyd ved starten av prosedyren og starter opp på nytt ved slutten av prosedyren. Enheten starter automatisk en oppgradering som drives av innholdet i Upgrade_Rule bare dersom alle talelinjer er inaktive for øyeblikket.

Eksempel:

https://10.73.10.223/firmware/PHONEOS-8875.1-0-1-0001-1.loads

I dette eksemplet oppgraderer Upgrade_Rule fastvaren til bildet som er lagret på den angitte URL-adressen.

Her er et annet eksempel:

(“$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

Dette eksemplet gir enheten beskjed om å laste ned ett av to bilder, basert på innholdet i en generell parameter, GPP_F.

Klargjøringsparametere

Du finner klargjøringsparametere i fanen Klargjøring på telefonens nettside.

Parametere for konfigurasjonsprofil

Følgende tabell definerer funksjon og bruk av hver parameter i delen Configuration Profile Parameters (Konfigurasjonsprofilparametre) på fanen Provisioning (Klargjøring).

Tabell 1. Parametere for konfigurasjonsfil

Parameternavn

Beskrivelse og standard verdi

Provision Enable

Styrer alle resynkroniseringer uavhengig av fastvareoppgraderinger. Angitt til Yes (Ja) for å aktivere ekstern klargjøring.

Standard verdi er Yes (Ja).

Resync On Reset

Utløser en resynkronisering etter hver omstart, unntatt etter omstarter forårsaket av parameteroppdateringer og fastvareoppgraderinger.

Standard verdi er Yes (Ja).

Resync Random Delay

En tilfeldig forsinkelse etter oppstartssekvensen før tilbakestillingen utføres, angitt i sekunder. I en samling IP-telefonienheter med planlagt samtidig oppstart gir dette en spredning av tidspunktene da hver enhet sender resynkroniseringsforespørsel til klargjøringsserveren. Funksjonen kan være nyttig ved store distribusjoner i boligområder hvis det oppstår strømbrudd.

Verdien for dette feltet må være et heltall mellom 0 og 65535.

Standard verdi er 2.

Resync At (TTmm)

Klokkeslettet (TTmm) da enheten resynkroniserer med klargjøringsserveren.

Verdien i dette feltet må være et firesifret tall mellom 0000 til 2400 som angir klokkeslettet i formatet TTmm. 0959 angir for eksempel 09:59.

Standard verdi er tom. Hvis verdien er ugyldig, ignoreres parameteren. Hvis parameteren angis med en gyldig verdi, ignoreres Resync Periodic-parameteren (Resynkroniser regelmessig).

Resync At Random Delay

Forhindrer overbelastning av klargjøringsserveren når et stort antall enheter slås på samtidig.

For å unngå at serveren oversvømmes med resynkroniseringsforespørsler fra flere telefoner, resynkroniserer telefonen i perioden mellom timer og minutter og timer og minutter pluss den tilfeldige forsinkelsen (hhmm, hhmm + random_delay). Hvis for eksempel den tilfeldige forsinkelsen = (Resync At Random Delay + 30)/60 minutter, konverteres den angitte verdien i sekunder til minutter og avrundes til neste minutt for å beregne det endelige random_delay-intervallet.

Verdier i området mellom 600 og 65535 er gyldige.

Hvis verdien er mindre enn 600 vil intervallet for tilfeldig forsinkelse være mellom 0 og 600.

Standard verdi er 600 sekunder (10 minutter).

Resync Periodic

Tidsintervallet mellom regelmessige resynkroniseringer med klargjøringsserveren. Den tilhørende resynkroniseringstidtakeren aktiveres bare etter den første vellykkede synkroniseringen med serveren.

Følgende formater er gyldige:

  • Et heltall

    Eksempel: Verdien 3000 betyr at den neste resynkroniseringen finner sted om 3000 sekunder.

  • Flere heltall

    Eksempel: Verdien 600,1200,300 betyr at den første resynkroniseringen finner sted om 600 sekunder, den andre resynkroniseringen finner sted 1200 sekunder etter den første, og den tredje resynkroniseringen finner sted 300 sekunder etter den andre.

  • En tidsperiode

    Eksempel: Verdien 2400+30 betyr at den neste resynkroniseringen finner sted mellom 2400 og 2430 sekunder etter en vellykket resynkronisering.

Hvis du vil deaktivere regelmessig resynkronisering, angir du parameteren til null.

Standard verdi er 3600 sekunder.

Resync Error Retry Delay

Hvis en resynkroniseringsoperasjon mislykkes fordi IP-telefonienheten ikke kan hente en profil fra serveren, eller fordi den nedlastede filen er skadet, eller det har oppstått en intern feil, prøver enheten å resynkronisere på nytt etter en tidsperiode som er angitt i sekunder.

Følgende formater er gyldige:

  • Et heltall

    Eksempel: Verdien 300 betyr at det neste forsøket på resynkronisering finner sted om 300 sekunder.

  • Flere heltall

    Eksempel: Verdien 600,1200,300 betyr at det første nye forsøket på resynkronisering finner sted 600 sekunder etter en mislykket resynkronisering, det andre forsøket finner sted 1200 sekunder etter at det første nye forsøket mislykkes, og det tredje forsøket finner sted 300 sekunder etter at det andre nye forsøket mislykkes.

  • En tidsperiode

    Eksempel: Verdien 2400+30 betyr at det neste nye forsøket finner sted mellom 2400 og 2430 sekunder etter en mislykket resynkronisering.

Hvis forsinkelsen angis til 0, prøver ikke enheten å resynkronisere på nytt etter et mislykket resynkroniseringsforsøk.

Forced Resync Delay

Maksimumsintervallet (i sekunder) som telefonen venter før den utfører en resynkronisering.

Enheten resynkroniserer ikke mens noen av dens telefonlinjer er aktive. Siden en resynkronisering kan ta flere sekunder, er det ønskelig å vente til enheten har vært ledig en stund, før resynkroniseringen utføres. På denne måten kan en bruker foreta anrop etter hverandre uten avbrudd.

Enheten har en tidtaker begynner nedtellingen når alle linjene blir ledige. Denne parameteren er den første verdien til telleren. Resynkroniseringer utsettes til tidtakeren har telt ned til null.

Verdier i området mellom 0 og 65535 er gyldige.

Standard verdi er 14 400 sekunder.

Resync From SIP

Gjør det mulig å utløse en resynkronisering via en SIP-varslingsmelding.

Standard verdi er Yes (Ja).

Resync After Upgrade Attempt

Aktiverer eller deaktiverer resynkronisering etter en oppgradering. Hvis Yes (Ja) velges, utløses synkronisering.

Standard verdi er Yes (Ja).

Resync Trigger 1, Resync Trigger 2

Konfigurerbare betingelser for utløsing av resynkronisering. En resynkronisering utløses når logikkformelen i disse parametrene beregnes til SANN.

Standard verdi er (tom).

Resync Fails On FNF

En resynkronisering regnes som mislykket hvis det ikke mottas en forespurt profil fra serveren. Dette kan overstyres av denne parameteren. Når den angis til no (nei), godtar enheten et finner ikke filen-svar fra serveren som en vellykket resynkronisering.

Standard verdi er Yes (Ja).

Profilregel

Profile Rule B

Profile Rule C

Profile Rule D

Hver profilregel informerer telefonen om en kilde som den kan hente en profil (konfigurasjonsfil) fra. Under hver ny synkroniseringsoperasjon tar telefonen i bruk alle profiler i rekkefølge.

Standard: /$PSN.xml

Hvis du tar i bruk AES-256-CBC-kryptering på konfigurasjonsfilene, angir du krypteringsnøkkel med --key-nøkkelordet på følgende måte:

[--key <krypteringsnøkkel>]

Krypteringsnøkkelen kan eventuelt settes i doble anførselstegn (").

DHCP-alternativ å bruke

DHCP-alternativer, atskilt med komma, brukes til å hente fastvare og profiler.

Standard verdi er 66,160,159,150,60,43,125.

Log Request Msg

Denne parameteren inneholder meldingen som sendes til syslog-serveren ved starten av et nytt resynkroniseringsforsøk.

Standard verdi er $PN $MAC –Requesting % $SCHEME://$SERVIP:$PORT$PATH.

Log Success Msg

Syslog-melding som genereres når et resynkroniseringsforsøk lykkes.

Standard verdi er $PN $MAC –Successful Resync % $SCHEME://$SERVIP:$PORT$PATH -- $ERR.

Log Failure Msg

Syslog-melding som genereres etter et mislykket forsøk på resynkronisering.

Standard verdi er $PN $MAC -- Resync failed: $ERR.

User Configurable Resync

Gjør det mulig for en bruker å resynkronisere telefonen fra IP-telefonskjermen.

Standard verdi er Yes (Ja).

Parametere for fastvareoppgradering

Følgende tabell definerer funksjon og bruk av hver parameter i delen Firmware Upgrade (Fastvareoppgradering) på fanen Provisioning (Klargjøring).

Tabell 2. Parametere for fastvareoppgradering

Parameternavn

Beskrivelse og standard verdi

Upgrade Enable

Aktiverer fastvareoppgraderinger uavhengig av resynkroniseringer.

Standard verdi er Yes (Ja).

Konfigurer denne parameteren med en av metodene:

  • I telefonkonfigurasjonsfilen med XML(cfg.xml), skriv inn en streng i dette formatet: <Upgrade_Enable ua="na">Ja</Upgrade_Enable>

  • På websiden for telefonadministrasjon setter du dette feltet til Ja eller Nei.

Upgrade Error Retry Delay

Forsinkelsesintervallet før nytt oppgraderingsforsøk (i sekunder) ved en mislykket oppgradering. Enheten har en tidtaker for fastvareoppgraderingsfeil som aktiveres etter et mislykket forsøk på å oppgradere fastvaren. Tidtakeren er initialisert med verdien i denne parameteren. Det neste forsøket på fastvareoppgradering finner sted når tidtakeren teller ned til null.

Standard verdi er 3600 sekunder.

Konfigurer denne parameteren med en av metodene:

  • I telefonkonfigurasjonsfilen med XML(cfg.xml), skriv inn en streng i dette formatet: <Upgrade_Error_Retry_Delay ua="na">3600</Upgrade_Error_Retry_Delay>

  • Angi verdien på websiden for telefonadministrasjon.

Oppgraderingsregel

Et fastvareoppgraderingsskript som angir betingelsene for oppgradering og de tilhørende URL-adressene for fastvare. Den bruker den samme syntaksen som Profile Rule (Profilregel).

Bruk følgende format til å angi oppgraderingsregelen:

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

Eksempel: 

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

Hvis ingen protokoll angis, antas TFTP. Hvis ikke serverenavn er angitt, vil verten som ber om URL brukes som serverenavnet. Hvis ingen port er angitt, vil standard port brukes (69 for TFTP, 80 for HTTP eller 443 for HTTPS).

Standard verdi er tom.

Konfigurer denne parameteren med en av metodene:

  • I telefonkonfigurasjonsfilen med XML(cfg.xml), skriv inn en streng i dette formatet: <Upgrade_Rule ua="na">http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads</Upgrade_Rule>

  • På websiden for telefonadministrasjon angir du banen der innlastingsfilen er lagret.

Log Upgrade Request Msg

Syslog-melding som genereres ved starten av et forsøk på fastvareoppgradering.

Standard: $PN $MAC -- Requesting upgrade $SCHEME://$SERVIP:$PORT$PATH

Konfigurer denne parameteren med en av metodene:

  • I telefonkonfigurasjonsfilen med XML(cfg.xml), skriv inn en streng i dette formatet: <Log_Upgrade_Request_Msg ua="na">$PN $MAC -- Ber om oppgradering $SCHEME://$SERVIP:$PORT$PATH</Log_Upgrade_Request_Msg>

  • På websiden for telefonadministrasjon tilpasser du parameteren etter behov.

Log Upgrade Success Msg

Syslog-melding som genereres etter at en fastvareoppgradering er fullført.

Standard verdi er $PN $MAC -- Successful upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERR

Konfigurer denne parameteren med en av metodene:

  • I telefonkonfigurasjonsfilen med XML(cfg.xml), skriv inn en streng i dette formatet: <Log_Upgrade_Success_Msg ua="na">$PN $MAC -- Vellykket oppgradering $SCHEME://$SERVIP:$PORT$PATH -- $ERR</Log_Upgrade_Success_Msg>

  • På websiden for telefonadministrasjon tilpasser du parameteren etter behov.

Log Upgrade Failure Msg

Syslog-melding som genereres etter et mislykket forsøk på fastvareoppgradering.

Standard verdi er $PN $MAC -- Upgrade failed: $ERR

Konfigurer denne parameteren med en av metodene:

  • I telefonkonfigurasjonsfilen med XML(cfg.xml), skriv inn en streng i dette formatet: <Log_Upgrade_Failure_Msg ua="na">$PN $MAC -- Oppgradering mislyktes: $ERR</Log_Upgrade_Failure_Msg>

  • På websiden for telefonadministrasjon tilpasser du parameteren etter behov.

Peer-fastvaredeling

Aktiverer eller deaktiverer funksjonen Peer Firmware Sharing (PFS). Velg Ja (Yes) eller Nei (No) for å aktivere eller deaktivere funksjonen.

Standard: Ja

Konfigurer denne parameteren med en av metodene:

  • I telefonkonfigurasjonsfilen med XML(cfg.xml), skriver du inn en streng i dette formatet: <Peer_Firmware_Sharing ua="na">Yes</Peer_Firmware_Sharing>

  • På websiden for telefonadministrasjon setter du dette feltet til Ja eller Nei.

Loggserver for peer-fastvaredeling

Angir IP-adressen og porten som UDP-meldingen sendes til.

For eksempel: 10.98.76.123:514, der 10.98.76.123 er IP-adressen og 514 er portnummeret.

Konfigurer denne parameteren med en av metodene:

  • I telefonkonfigurasjonsfilen med XML(cfg.xml), skriv inn en streng i dette formatet: <Peer_Firmware_Sharing_Log_Server ua="na">10.98.76.123:514</Peer_Firmware_Sharing_Log_Server>

  • Skriv inn loggserveradressen på websiden for telefonadministrasjon.

Generelle parametere

Følgende tabell definerer funksjon og bruk av hver parameter i delen General Purpose Parameters (Generelle parametre) på fanen Provisioning (Klargjøring).

Tabell 3. Generelle parametere

Parameternavn

Beskrivelse og standard verdi

GPP A til GPP P

De generelle parametrene GPP_* brukes som frie strengregistre når telefoner konfigureres til å samhandle med en bestemt klargjøringsserverløsning. De kan konfigureres til å inneholde forskjellige verdier, inkludert følgende:

  • krypteringsnøkler

  • URL-er

  • statusinformasjon om flertrinnsklargjøring

  • POST-forespørselsmaler

  • aliasmatriser for parameternavn

  • delvise strengverdier, eventuelt satt sammen til fullstendige parameterverdier

Standard verdi er tom.

Makroutvidelsesvariabler

Enkelte makrovariabler gjenkjennes i følgende klargjøringsparametre:

  • Profile_Rule

  • Profile_Rule_*

  • Resync_Trigger_*

  • Upgrade_Rule

  • Log_*

  • GPP_* (i bestemte situasjoner)

Innenfor disse parametrene gjenkjennes og utvides syntakstyper, som $NAME eller $(NAME).

Makrovariabeldelstrenger kan angis med notasjonen $(NAME:p) og $(NAME:p:q), der p og q er positive heltall (tilgjengelig i revisjon 2.0.11 og høyere). Makroutvidelsen blir delstrengen som starter med tegnforskyvning p, med lengden q (eller til slutten av strengen hvis q ikke er angitt). Hvis for eksempel GPP_A inneholder ABCDEF, utvides $(A:2) til CDEF, og $(A:2:3) utvides til CDE.

En navn som ikke gjenkjennes, oversettes ikke, og $NAME- eller $(NAME)-skjemaet forblir uendret i parameterverdien etter utvidelsen.

Parameternavn

Beskrivelse og standardverdi

$

Skjemaet $$ utvides til et enkelt $-tegn.

A til P

Erstattes av innholdet i de generelle parametrene GPP_A til GPP_P.

SA til SD

Erstattes med spesialparametrene GPP_SA til GPP_SD. Disse parametrene inneholder nøkler eller passord som brukes i klargjøringen.

$SA til $SD gjenkjennes som argumenter til den valgfrie kvalifikatoren for resynkroniserings-URL-en, --nøkkel.

MA

MAC-adresse som bruker heksadesimale sifre med små bokstaver, for eksempel 000e08aabbcc.

MAU

MAC-adresse som heksadesimale sifre med store bokstaver, for eksempel 000E08AABBCC.

MAC

MAC-adresse som bruker heksadesimale sifre med små bokstaver og kolon til å skille heksadesimale sifferpar. For eksempel 00:0e:08:aa:bb:cc.

PN

Produktnavn. For eksempel CP-8875, DP-9851, DP-9871.

PSN

Produktets serienummer. For eksempel V03.

SN

Serienummerstreng. For eksempel 88012BA01234.

CCERT

Status for SSL-klientsertifikat: installert eller ikke installert.

IP

IP-adressen til telefonen i det lokale subnettet. For eksempel 192.168.1.100.

EXTIP

Telefonens eksterne IP-adresse, som vist på Internett. For eksempel 66.43.16.52.

SWVER

Programvareversjonsstreng. Eksempel:

PHONEOS.3-1-1-0104-37

HWVER

Maskinvareversjonsstreng. For eksempel 2.0.1

PRVST

Klargjøringstilstand (numerisk streng):

-1 = eksplisitt resynkroniseringsforespørsel

0 = resynkronisering ved oppstart

1 = regelmessig resynkronisering

2 = mislykket synkronisering, nytt forsøk

UPGST

Oppgraderingstilstand (numerisk streng):

1 = første oppgraderingsforsøk

2 = mislykket oppgradering, nytt forsøk

UPGERR

Resultatmelding (ERR) for forrige oppgraderingsforsøk; for eksempel http_get mislyktes.

PRVTMR

Sekunder siden forrige resynkroniseringsforsøk.

UPGTMR

Sekunder siden forrige oppgraderingsforsøk.

REGTMR1

Sekunder siden linje 1 mistet registrering med SIP-server.

REGTMR2

Sekunder siden linje 2 mistet registrering med SIP-server.

UPGCOND

Eldre makronavn.

SKJEMA

Filtilgangsskjema, enten TFTP, HTTP eller HTTPS, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en.

SERV

Vertsnavnet til målserver for forespørsler, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en.

SERVIP

IP-adressen til målserver for forespørsler, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en, muligens etter DNS-oppslag.

PORT

UDP/TCP-porten til målserver for forespørsler, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en.

PATH

Filbanen til målserver for forespørsler, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en.

ERR

Resultatmelding for resynkroniserings- eller oppgraderingsforsøk. Benyttes bare til å generere syslog-meldinger. Verdien beholdes i variabelen UPGERR til bruk ved oppgraderingsforsøk.

UIDn

Innholdet i konfigurasjonsparameteren Line n UserID.

EMS

Extension Mobility-status

MUID

Bruker-ID for Extension Mobility

MPWD

Extension Mobility-passord

Interne feilkoder

Telefonen definerer en rekke internfeilkoder (X00–X99) for å forenkle konfigurasjonen gjennom å gi mer detaljert kontroll over virkemåten til enheten i visse feilsituasjoner.

Tabell 4. Interne feilkoder

Parameternavn

Beskrivelse og standard verdi

X00

Transportlagfeil (eller ICMP) under sending av SIP-forespørsel.

X20

SIP-forespørselen får tidsavbrudd under venting på svar.

X40

Generelle SIP-protokollfeil (for eksempel uakseptabel kodek i SDP i 200- og ACK-meldinger, eller tidsavbrudd under venting på ACK).

X60

Det oppringte nummeret er ugyldig ifølge den angitte oppringingsplanen.