Typer af klargøringsparametre

Dette afsnit beskriver de klargøringsparametre, der i store træk er organiseret efter funktion.

Parametre for generelle formål

Parametrene for generelle formål GPP_* (Administratorlogin > Avanceret > Tale > Klargøring) bruges som fri strenge og registreres ved konfiguration af telefonen for at interagere med en bestemt klargøringsserverløsning. Parametrene GPP_ * er som standard tomme. De kan konfigureres til at indeholde forskellige værdier, herunder følgende:

  • Krypteringsnøgler

  • URL-adresser

  • Oplysninger om status ved klargøring i flere faser.

  • Skabeloner for Post-anmodninger

  • Tilknytninger til alias for parameternavn

  • Delvise strengværdier, eventuelt samlet til komplette parameterværdier.

GPP_ * parametrene kan bruges til makroudvidelse i andre klargøringsparametre. Til dette formål er makronavne på ét bogstav (A til og med P) nok til at identificere indholdet af GPP_A til og med GPP_P. Derudover identificerer makronavne med to store bogstaver SA til og med SD GPP_SA som GPP_SD som et specialtilfælde ved brug som argumenter i følgende URL-adresseindstillinger:

key, uid og pwd

Disse parametre kan bruges som variabler i klargørings- og opgraderingsregler. Der refereres til dem ved at foranstille variabelnavnet med et '$'-tegn, f.eks. $GPP_A.

Aktivér parametre

Parametrene Provision_Enable (Aktivér klargøring) og Upgrade_Enable (Aktivér opgradering) styrer alle handlinger med gensynkronisering af profiler og firmwareopgraderinger. Disse parametre styrer gensynkroniseringer og opgraderinger uafhængigt af hinanden. Disse parametre styrer også UTL-kommandoer for gensynkronisering og opgradering, der udstedes gennem administrationswebserveren. Begge disse parametre er indstillet til Ja som standard.

Parameteren Resync_From_SIP (Gensynkroniser fra SIP) styrer anmodninger om gensynkronisering. En SIP NOTIFY-hændelse sendes fra tjenesteudbyderens proxyserver til telefonen. Hvis indstillingen er aktiveret, kan proxyen anmode om en gensynkronisering. For at kunne gøre dette sender proxyen en SIP NOTIFY-meddelelse, der indeholder hændelsen: gensynkroniser header til enheden.

Enheden udfordrer anmodningen med et 401-svar (godkendelse nægtet for anvendte legitimationsoplysninger). Enheden forventer en efterfølgende anmodning, der er godkendt, før den oveholder gensynkroniseringsanmodning fra proxyen. Headerne Hændelse: reboot_now (reboot nu) og Hændelse: restart_now (genstart nu) giver henholdsvis kolde og varme, hvilket også udfordres.

De to resterende aktiveringsfunktioner er Resync_On_Reset (Gensynkroniser ved nulstilling) og Resync_After_Upgrade_Attempt (Gensynkroniser efter opgraderingsforsøg). Disse parametre afgør, om enheden udfører en gensynkroniseringshandling, når den tændes, softwaren rebooter og efter hvert opgraderingsforsøg.

Når Resync_On_Reset (Gensynkroniser ved nulstilling) er aktiveret, introducerer enheden en vilkårlig forsinkelse, der følger startsekvensen, før nulstillingen udføres. Forsinkelsen er et vilkårligt tidspunkt op til den værdi, som Resync Random Delay (Vilkårlig forsinkelse på gensynkronisering) (i sekunder) angiver. I en gruppe af telefoner, der tændes samtidigt, spreder denne forsinkelse starttidspunkterne for gensynkroniseringsanmodningerne ud for hver enhed. Denne funktion kan være nyttig ved installationer i stort boligområde, hvis der skulle ske et strømnedbrud.

Udløsere

Telefonen giver dig mulighed at gensynkronisere efter bestemte intervaller eller på et bestemt tidspunkt.

Gensynkroniser efter bestemte intervaller

Telefonen er designet til periodisk at gensynkronisere med klargøringsserveren. Gensynkroniseringsintervallet er konfigureret i Resync_Periodic (Gensynkroniser periodisk) (sekunder). Hvis denne værdi er tom, gensynkroniseres enheden ikke periodisk.

Gensynkroniseringen sker typisk, når talelinjerne er inaktive. Når en talelinje er aktiv, når der skal ske en gensynkronisering, forsinker telefonen gensynkroniseringsproceduren, indtil linjen bliver inaktiv igen. En gensynkronisering kan medføre, at værdier i konfigurationsparametre ændres.

En gensynkroniseringshandling kan mislykkes, fordi telefonen ikke er i stand til at hente en profil fra serveren, den downloadede fil er beskadiget, eller der er opstået en intern fejl. Enheden forsøger at gensynkronisere igen efter et tidsrum, der er angivet i Resync Error Retry Delay (Forsinkelse ved nyt forsøg efter gensynkroniseringsfejl) (sekunder). Hvis Resync Error Retry Delay (Forsinkelse ved nyt forsøg efter gensynkroniseringsfejl) er indstillet til 0, forsøger enheden ikke at synkronisere igen efter et mislykket forsøg på gensynkronisering.

Hvis en opgradering mislykkes, udføres der et nyt forsøg efter en retry efter Upgrade Error Retry Delay (Forsinkelse på forsøg ved opgraderingsfejl) sekunder.

To konfigurerbare parametre er tilgængelige til betinget at udløse en gensynkronisering: Resync_Trigger_1 (Udløser 1 af gensynkronisering) og Resync_Trigger_2 (Udløser 2 af gensynkronisering). Hver parameter kan programmeres med et betinget udtryk, der udsættes for en makroudvidelse. Når gensynkroniseringsintervallet udløber (tid til den næste gensynkronisering), vil udløserne forhindre gensynkronisering, medmindre en eller flere udløsere evalueres som sande, hvis de er indstillet.

Det følgende eksempel udløser en betinget gensynkronisering. I eksemplet har det seneste forsøg på opgradering af telefonen varet mere end 5 minutter (300 sekunder), og mindst 10 minutter (600 sekunder) er gået, siden det sidste forsøg på gensynkronisering.

$UPGTMR gt 300 og $PRVTMR ge 600

Gensynkroniser på et bestemt tidspunkt

Parameteren Resync_At (Gensynkroniser kl.) giver telefonen mulighed for at gensynkronisere på et bestemt tidspunkt. Denne parameter bruger 24-timers formatet (ttmm) til at angive tid.

Parameteren Resync_At_Random_Delay (Vilkår forsinkelse på gensynkroniseringstidspunkt) giver telefonen mulighed for at gensynkronisere med en ukendt forsinkelse i tid. Denne parameter bruger et positivt heltalsformat til at angive tiden.

Det skal undgås at oversvømme serveren med gensynkroniseringsanmodninger fra flere telefoner, der er angivet til blive gensynkroniseret på samme tidspunkt. For at gøre det udløser telefonen gensynkroniseringen op til 10 minutter efter det angivne tidspunkt.

Hvis du f.eks. indstiller gensynkroniseringstiden til 1000 (10 om morgenen), udløser telefonen gensynkronisering på et hvilket som helst tidspunkt 10:00 og 10:10 om morgenen.

Denne funktion er som standard deaktiveret. Hvis parameteren Resync_At (Gensynkroniser kl.) er klargjort, ignoreres parameteren Resync_Periodic (Gensynkroniser periodisk).

Konfigurerbare tidsplaner

Du kan konfigurere tidsplaner for periodiske gensynkroniseringer, og du kan angive intervaller for nye forsøg på gensynkronisering og opgraderingsfejl ved hjælp af disse klargøringsparametre:

  • Resync Periodic (Gensynkroniser periodisk)

  • Resync Error Retry Delay (Forsinkelse ved nyt forsøg efter gensynkroniseringsfejl)

  • Upgrade Error Retry Delay (Forsinkelse på forsøg ved opgraderingsfejl)

Hver parameter accepterer en enkelt forsinkelsesværdi (sekunder). Den nye udvidede syntaks giver mulighed for en kommasepareret liste over på hinanden følgende forsinkelseselementer. Det sidste element i rækkefølgen vil implicit blive gentaget uden tidsbegrænsning.

Du kan også vælge at bruge et plustegn til at angive en anden numerisk værdi, der tilføjer en vilkårlig ekstra forsinkelse.

Eksempel 1

I dette eksempel gensynkroniserer telefonen periodisk hver 2. time. Hvis en gensynkronisering giver fejl, forsøger enheden efter følgende intervaller: 30 minutter, 1 time, 2 timer, 4 timer. Enheden fortsætter med at prøve efter 4-timers intervaller, indtil gensynkroniseringen lykkes.

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

Eksempel 2

I dette eksempel gensynkroniserer enheden hver time (plus en ekstra vilkårlig forsinkelse på op til 10 minutter). I tilfælde af en gensynkroniseringsfejl forsøger enheden efter disse følgende intervaller: 30 minutter (plus op til 5 minutter). 1 time (plus op til 10 minutter), 2 timer (plus op til 15 minutter). Enheden fortsætter med at prøve efter 2-timers intervaller (plus op til 15 minutter), indtil gensynkroniseringen lykkes.

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

Eksempel 3

I dette eksempel prøver enheden opgradering igen efter 30 minutter, hvis et eksternt forsøg på opgradering mislykkes, og derefter en gang mere efter en time og derefter efter to timer. Hvis opgraderingen stadig mislykkes, forsøges hver fjerde til femte time, indtil opgraderingen lykkes.

Upgrade_Error_Retry_Delay  =  1800,3600,7200,14400+3600

Profilregler

Telefonen har flere parametre for eksterne konfigurationsprofiler (Profile_Rule*) (Profilregel*). Hver enkelt gensynkronisering kan således hente flere filer, som administreres af forskellige servere.

I det mest enkle scenarie gensynkroniserer enheden periodisk til en enkelt brugerprofil på en central server, der opdaterer alle relevante interne parametre. Alternativt kan profilen blive delt mellem forskellige filer. En fil er fælles for alle telefoner i en installation. En separat entydig fil er angivet for hver konto. Krypteringsnøgler og certifikatoplysninger kan leveres af en helt anden stadig profil, der gemmes på en separat server.

Hver gang en gensynkronisering forfalder, evaluerer telefonen de fire Profile_Rule*-parametre efter hinanden:

  1. Profile_Rule (Profilregel)

  2. Profile_Rule_B (Profilregel_B)

  3. Profile_Rule_C (Profilregel_C)

  4. Profile_Rule_D (Profilregel_D)

Hver evaluering kan resultere i, at der hentes en profil fra en ekstern klargøringsserver og mulighed for opdatering af et antal interne parametre. Hvis en evaluering mislykkes, afbrydes sekvensen af gensynkroniseringer og forsøges igen forfra, hvilket er angivet i parameteren Resync Error Retry Delay (Forsinkelse ved nyt forsøg efter gensynkroniseringsfejl) (sekunder). Hvis alle evalueringer gennemføres, venter enheden på den anden, der er angivet ved hjælp af parameteren Resync_Periodic (Gensynkroniser periodisk), og udfører derefter en anden gensynkronisering.

Indholdet af hver parameter Profile_Rule* (Profilregel) består af et sæt alternativer. Alternativerne adskilles med tegnet| (pipe). Hvert alternativ består af et betinget udtryk, et tildelingsudtryk, en profil-URL-adresse og eventuelle tilknyttede URL-indstillinger. Alle disse komponenter er valgfri inden for de enkelte alternativer. Følgende er de gyldige kombinationer samt den rækkefølge, de skal vises i, hvis de findes:

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

Inden for hver Profile_Rule*-parameter skal alle alternativer, med undtagelse af den sidste, indeholde et betinget udtryk. Dette udtryk evalueres og behandles på følgende måde:

  1. Betingelser evalueres fra venstre mod højre, indtil der findes en, der evalueres som sand (eller indtil der findes et alternativ uden et betinget udtryk).

  2. Et eventuelt medfølgende tildelingsudtrykket evalueres, hvis det findes.

  3. Hvis en URL-adresse er angivet som en del af det pågældende alternativ, gøres der et forsøg på at hente den profil, der er placeret ved den angivne URL-adresse. Systemet forsøger at opdatere de interne parametre i overensstemmelse hermed.

Hvis alle alternativer har betingede udtryk, og ingen evalueres til at være sand (eller hvis det hele profilreglen er tom), ignoreres hele Profile_Rule*-parameteren. Den næste profilregelparameter i sekvensen er evalueres.

Eksempel 1

Dette eksempel gensynkroniserer ubetinget til profilen på den angivne URL-adresse og udfører en HTTP GET-anmodning til den eksterne klargøringsserver:

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

Eksempel 2

I dette eksempel synkroniserer enheden til to forskellige URL-adresser, afhængigt af registreringstilstanden for linje 1. I tilfælde af mistet registrering udfører enheden en HTTP POST på et CGI-script. Enheden sender indholdet af den makroudvidede udvidet GPP_A, hvilket kan angive yderligere oplysninger om enhedens tilstand:

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

Eksempel 3

I dette eksempel gensynkroniserer enheden til den samme server. Enheden giver yderligere oplysninger, hvis et certifikat ikke er installeret på enheden (for ældre enheder før 2.0):

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

Eksempel 4

I dette eksempel er linje 1 deaktiveret, indtil GPP_A indstilles til lig med klargjort via den første URL-adresse. Derefter gensynkroniseres den til den anden URL-adresse:

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

Eksempel 5

I dette eksempel antages det, at den profil, som serveren returnerer, indeholder XML-elementkoder. Disse mærker skal gentilknyttes til de rigtige parameternavne af den aliastilknytning, der er gemt i GPP_B:

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

En gensynkronisering anses typisk for at være mislykket, hvis en anmodet profil ikke modtages fra serveren. Parameteren Resync_Fails_On_FNF (Gensynkronisering mislykkes ved FNF) kan tilsidesætte denne standardvirkemåde. Hvis Resync_Fails_On_FNF (Gensynkronisering mislykkes ved FNF) er indstillet til Nej, accepterer enheden svaret "fil ikke fundet" fra serveren som en gennemført gensynkronisering. Standardværdien for Resync_Fails_On_FNF (Gensynkronisering mislykkes ved FNF) er Ja.

Opgraderingsregel

Opgraderingsregel fortæller enheden, at en ny load skal aktiveres, og hvor loaden kan hentes, hvis det er nødvendigt. Hvis loaden allerede er på enheden, forsøger den ikke at hente loaden. Det betyder altså, at gyldigheden af loadplaceringen ikke har nogen betydning, når de ønskede loads er i den inaktive partition.

Upgrade_Rule (Opgraderingsregel) angiver en firmwareload, der overføres og anvendes, hvis den er forskellig fra den aktuelle load, medmindre den er begrænset af et betinget udtryk, eller Upgrade_Enable (Aktivér opgradering) er indstillet til Nej.

Telefonen har en konfigurerbar ekstern opgraderingsparameter, Upgrade_Rule (Opgraderingsregel). Denne parameter accepterer syntaks svarende til profilregelparametrene. Indstillinger for URL-adresser understøttes ikke for opgraderinger, men betingede udtryk og tildelingsudtryk kan bruges. Hvis der bruges betingede udtryk, kan parameteren udfyldes med flere alternativer adskilt af tegnet |. Syntaksen for hvert alternativ er som følger:

[ conditional-expr ] [ assignment-expr ] URL

Som det også var tilfældet med parametrene Profile_Rule* (Profilregel*), evaluerer parameteren Upgrade_Rule (Opgraderingsregel) hvert enkelt alternativ, indtil det betingede udtryk er opfyldet, eller et alternativ ikke har et betinget udtryk. Det medfølgende tildelingsudtryk evalueres, hvis det angives. Derefter forsøges en opgradering til den angivne URL-adresse.

Hvis Upgrade_Rule (Opgraderingsregel) indeholder en URL-adresse uden et betinget udtryk, opgraderer enheden til den firewareafbildning, der angiver URL-adressen. Efter makroudvidelse og evaluering af reglen forsøger enheden ikke på at opgradere igen, før reglen ændres eller den gældende kombination af skemaet + server + port + filsti ændres.

Enheden deaktiverer lyden i starten af proceduren for at forsøge en opgradering af firmware og genstarter i slutningen af proceduren. Enheden starter kun en opgradering, der styres af indholdet af i Upgrade_Rule (Opgraderingsregel) automatisk, hvis alle talelinjerne er inaktive i øjeblikket.

F.eks.

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

I dette eksempel opgraderer Upgrade_Rule (Opgraderingsregel) firmwaren til den afbildning, der er lagret på den angivne URL-adresse.

Her er et andet 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 eksempel får enheden til at indlæse et af to billeder, baseret på indholdet af en parameter for generelle formål GPP_F.

Klargøringsparametre

Du kan finde klargøringsparametre på fanen Klargøring på telefonens webside.

Konfigurationsprofilparametre

Følgende tabel definerer funktionen og brugen af hver parameter i afsnittet Konfigurationsprofilparametre under fanen Klargøring.

Tabel 1. Konfigurationsprofilparametre

Parameternavn

Beskrivelse og standardværdi

Provision Enable (Aktivér klargøring)

Styrer alle gensynkroniseringshandlinger uafhængigt af firmwareopgraderingshandlinger. Indstil til Ja for at aktivere ekstern klargøring.

Standardværdien er Ja.

Resync On Reset (Gensynkronisering ved nulstilling)

Udløser en gensynkronisering efter hver genstart, bortset ved genstarter, der skyldes parameteropdateringer og firmwareopgraderinger.

Standardværdien er Ja.

Resync Random Delay (Vilkårlig forsinkelse på gensynkronisering)

En vilkårlig forsinkelse efter startsekvensen før nulstillingen udføres; angivet i sekunder. I en gruppe enheder med IP-telefoni, der er planlagt til at skulle starte samtidigt, giver dette en spredning i de tidspunkter, hvor hver enkelt enhed sender en gensynkroniseringsanmodning til klargøringsserveren. Denne funktion kan være nyttig ved installationer i stort boligområde, hvis der skulle ske et strømnedbrud.

Værdien for dette felt skal være et heltal mellem 0 og 65535.

Standardværdien er 2.

Resync At (HHmm) (Gensynkroniser kl. (TTmm))

Tiden (TTmm), hvor enheden igen synkroniseres med klargøringsserveren.

Værdien for dette felt skal være et tal på fire cifre lige fra 0000 til 2400, der angiver tiden i TTmm-formatet. 0959 angiver f.eks. 09:59.

Standardværdien er tom. Hvis værdien er ugyldig, ignoreres parameteren. Hvis denne parameter er angivet med en gyldig værdi, ignoreres parameteren Resync Periodic (Gensynkroniser periodisk).

Resync At Random Delay (Gensynkronisering ved vilkårlig forsinkelse)

Forhindrer en overbelastning af klargøringsserveren, når et stort antal enheder tændes samtidigt.

For at undgå at oversvømme serveren med gensynkroniseringsanmodninger fra flere telefoner, gensynkroniseres telefonen i intervallet mellem timerne og minutter, og timerne og minutter plus vilkårlig forsinkelse (ttmm, ttmm+random_delay (vilkårlig forsinkelse)). Hvis f.eks. den vilkårlige forsinkelse = (synkroniser igen ved vilkårlig forsinkelse + 30)/60 minutter, konverteres inputværdien i sekunder til minutter og afrundes til næste minut for at beregne det endelige vilkårlige forsinkelsesinterval.

Gyldig værdi er i intervallet mellem 600 og 65535.

Hvis værdien er mindre end 600, er den interne tilfældige forsinkelse mellem 0 og 600.

Standardværdien er 600 sekunder (10 minutter).

Resync Periodic (Gensynkroniser periodisk)

Tidsintervallet mellem periodiske gensynkroniseringer med klargøringsserveren. Den tilknyttede tidsindstilling for gensynkronisering er kun aktiv, efter den første synkronisering med serveren er gennemført.

De gyldige formater er som følger:

  • Et heltal

    Eksempel: Et input på 3000 angiver, at næste gensynkronisering sker om 3000 sekunder.

  • Flere heltal

    Eksempel: Input af 600,1200,300 angiver, at den første gensynkronisering sker om 600 sekunder, den anden gensynkronisering sker 1200 sekunder efter den første, og den tredje gensynkronisering sker 300 sekunder efter den anden.

  • Et tidsinterval

    Et input på 2400+30 angiver, at den næste gensynkronisering sker mellem 2400 og 2430 sekunder efter en gennemført gensynkronisering.

Indstil denne parameter til nul for at deaktivere periodisk gensynkroniseringen.

Standardværdien er 3600 sekunder.

Resync Error Retry Delay (Forsinkelse ved nyt forsøg efter gensynkroniseringsfejl)

Hvis en gensynkronisering mislykkes, fordi enheden med IP-telefon ikke kunne hente en profil fra serveren, eller den downloadede fil er beskadiget, eller der sker en intern fejl, forsøger enheden at synkronisere igen efter et tidsrum, der er angivet i sekunder.

De gyldige formater er som følger:

  • Et heltal

    Eksempel: Et input på 300 angiver, at næste forsøg på gensynkronisering sker om 300 sekunder.

  • Flere heltal

    Eksempel: Et input på 600,1200,300 angiver, at det første forsøg sker 600 sekunder efter fejlen, det andet forsøg sker 1200 sekunder efter fejlen i det første forsøg, og det tredje forsøg sker 300 sekunder efter fejlen i det andet forsøg.

  • Et tidsinterval

    Et input på 2400+30 angiver, at det næste forsøg sker mellem 2400 og 2430 sekunder efter en mislykket gensynkronisering.

Hvis forsinkelsen er indstillet til 0, forsøger enheden ikke at synkronisere igen efter et mislykket forsøg på gensynkronisering.

Forced Resync Delay (Tvungen forsinkelse på gensynkronisering)

Maksimal forsinkelse (i sekunder), telefonen venter, før der udføres en gensynkronisering.

Enheden gensynkroniserer igen, når en af dens telefonlinjer er aktiv. Da en gensynkronisering kan tage adskillige sekunder, er det bedst at vente, indstil enheden har været inaktiv i længere tid før gensynkronisering. Dette giver en bruger mulighed for at foretage opkald efter hinanden uden afbrydelse.

Enheden har en tidsindstilling, der begynder at tælle ned, når alle dens linjer bliver ledige. Denne parameter er startværdien for tælleren. Gensynkroniseringshændelser forsinkes, før denne tæller når nul.

Gyldig værdi er i intervallet mellem 0 og 65535.

Standardværdien er 14.400 sekunder.

Resync From SIP (Gensynkronisering fra SIP)

Giver mulighed for, at en gensynkronisering kan udløses via en SIP NOTIFY-meddelelse.

Standardværdien er Ja.

Resync efter forsøg på opgradering (Synkroniser igen efter opgraderingsforsøg)

Aktiverer eller deaktiverer gensynkroniseringshandlingen, når der opstår en opgradering. Hvis Ja er valgt, udløses synkronisering.

Standardværdien er Ja.

Resync Trigger 1 (Udløser 1 af gensynkronisering), Resync Trigger 2 (Udløser 2 af gensynkronisering)

Konfigurerbare betingelser for udløsning af gensynkronisering. En gensynkronisering udløses, når den logiske ligning i disse parameter giver SAND.

Standardværdien er (tom).

Resync Fails On FNF (Gensynkronisering mislykkes ved FNF)

En gensynkronisering anses for at være mislykket, hvis en anmodet profil ikke modtages fra serveren. Parameteren kan tilsidesætte dette. Når den er indstillet til Nej, accepterer enheden svaret fil ikke fundet fra serveren som en gennemført gensynkronisering.

Standardværdien er Ja.

Profilregel

Profile Rule B (Profilregel B)

Profile Rule C (Profilregel C)

Profile Rule D (Profilregel D)

Hver profilregel giver telefonen besked om den kilde, der skal hentes en profil (konfigurationsfilen) fra. For hver gensynkronisering anvender telefonen alle profilerne i rækkefølge.

Standard: /$PSN.xml

Hvis du anvender AES-256-CBC-kryptering til konfigurationsfilerne, skal du angive krypteringsnøglen med nøgleordet --key på følgende måde:

[--key <krypteringsnøgle>]

Nøglen kan eventuelt angives i dobbelte anførselstegn (").

DHCP Option To Use (DHCP-indstilling i brug)

DHCP-indstillinger, adskilt med kommaer, bruges til at hente firmware og profiler.

Standardværdien er 66,160,159,150,60,43,125.

Log Request Msg (Meddelelse om logføringsanmodning)

Denne parameter indeholder den meddelelse, der sendes til syslog-serveren ved start af forsøg på gensynkronisering.

Standardværdien er $PN $MAC – anmoder % $SCHEME://$SERVIP:$PORT$PATH.

Log Success Msg (Meddelelse om logføring gennemført)

Den syslog-meddelelse, der udstedes ved gennemførelse af forsøg på gensynkronisering.

Standardværdien er $PN $MAC – gennemført gensynkronisering % $SCHEME://$SERVIP:$PORT$PATH -- $ERR.

Log Failure Msg (Meddelelse om logføring mislykket)

Den syslog-meddelelse, der udstedes efter mislykket forsøg på gensynkronisering.

Standardværdien er $PN $MAC – gensynkronisering mislykkedes: $ERR.

User Configurable Resync (Gensynkronisering, bruger kan konfigurere)

Giver en bruger mulighed for gensynkronisere telefonen via IP-telefonskærmen.

Standardværdien er Ja.

Firmwareopgraderingsparametre

Følgende tabel definerer funktionen og brugen af hver parameter i afsnittet Firmwareopgradering under fanen Klargøring.

Tabel 2. Firmwareopgraderingsparametre

Parameternavn

Beskrivelse og standardværdi

Upgrade Enable (Opgradering aktiveret)

Giver mulighed for firmwareopgradering uafhængigt af gensynkroniseringshandlinger.

Standardværdien er Ja.

Konfigurer denne parameter med en af metoderne:

  • I telefonkonfigurationsfilen med XML(cfg.xml) skal du angive en streng i dette format: <Upgrade_Enable ua="na">Ja</Upgrade_Enable>

  • Indstil dette felt til Ja eller Nej på websiden til telefonadministration.

Upgrade Error Retry Delay (Forsinkelse på forsøg ved opgraderingsfejl)

Intervallet for nyt forsøg på opgradering (i sekunder), der benyttes ved en opgraderingsfejl. Enheden har en tidsindstilling for firmwareopgradering, der aktiveres efter et mislykket forsøg på firmwareopgradering. Tidsindstillingen initialiseres med værdien i denne parameter. Det næste forsøg på firmwareopgradering sker, når denne tidsindstilling tæller ned til nul.

Standardværdien er 3600 sekunder.

Konfigurer denne parameter med en af metoderne:

  • I telefonkonfigurationsfilen med XML(cfg.xml) skal du angive en streng i formatet : <Upgrade_Error_Retry_Delay ua="na">3600</Upgrade_Error_Retry_Delay>

  • Indstil værdien på websiden til telefonadministration.

Opgraderingsregel

Et script til firmwareopgradering, der definerer opgraderingsbetingelser og tilknyttede firmware-URL-adresser. Den bruger samme syntaks som profilreglen.

Brug følgende format til at angive opgraderingsreglen:

<tftp|http|https>://<ip-adresse><:port>/<sti>/<filnavn>

For 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 der ikke er angivet en protokol, antages det, at TFTP skal bruges. Hvis der ikke er angivet et servernavn, bruges den vært, der anmoder om URL-adressen, som servernavnet. Hvis der ikke er angivet en port, bruges standardporten (69 for TFTP, 80 for HTTP eller 443 for HTTPS).

Standardværdien er tom.

Konfigurer denne parameter med en af metoderne:

  • I telefonkonfigurationsfilen med XML(cfg.xml) skal du angive en streng i dette format: <Upgrade_Rule ua="na">http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads</Upgrade_Rule>

  • På websiden til telefonadministration skal du angive stien, hvor indlæsningsfilen er gemt.

Log Upgrade Request Msg (Meddelelse om logføring af opgraderingsanmodning)

Syslog-meddelelse, der udstedes ved start af et forsøg på opgradering af firmware.

Standard: $PN $MAC – anmoder om opgradering $SCHEME://$SERVIP:$PORT$PATH

Konfigurer denne parameter med en af metoderne:

  • I telefonkonfigurationsfilen med XML(cfg.xml) skal du angive en streng i dette format: <Log_Upgrade_Request_Msg ua="na">$PN $MAC -- Anmoder om opgradering $SCHEME://$SERVIP:$PORT$PATH</Log_Upgrade_Request_Msg>

  • På websiden til telefonadministration skal du tilpasse parameteren efter behov.

Log Upgrade Success Msg (Meddelelse om logføring af gennemført opgradering)

Syslog-meddelelse, der udstedes, efter at et forsøg på opgradering af firmwaren er gennemført.

Standardværdien er $PN $MAC – gennemført opgradering $SCHEME://$SERVIP:$PORT$PATH -- $ERR

Konfigurer denne parameter med en af metoderne:

  • I telefonkonfigurationsfilen med XML(cfg.xml) skal du angive en streng i formatet: <Log_Upgrade_Success_Msg ua="na">$PN $MAC -- Vellykket opgradering $SCHEME://$SERVIP:$PORT$PATH -- $ERR</Log_Upgrade_Success_Msg>

  • På websiden til telefonadministration skal du tilpasse parameteren efter behov.

Log Upgrade Failure Msg (Meddelelse om logføring af mislykket opgradering)

Syslog-meddelelse, der udstedes efter mislykket forsøg på opgradering af firmware.

Standardværdien er $PN $MAC – opgraderingen er mislykket: $ERR

Konfigurer denne parameter med en af metoderne:

  • I telefonkonfigurationsfilen med XML(cfg.xml) skal du angive en streng i dette format: <Log_Upgrade_Failure_Msg ua="na">$PN $MAC -- Opgraderingen mislykkedes: $ERR</Log_Upgrade_Failure_Msg>

  • På websiden til telefonadministration skal du tilpasse parameteren efter behov.

Peer-firmwaredeling

Aktiverer eller deaktiverer PFS-funktionen (Peer Firmware Sharing). Vælg Ja eller Nej for at aktivere eller deaktivere funktionen.

Standard: ja

Konfigurer denne parameter med en af metoderne:

  • I telefonkonfigurationsfilen med XML(cfg.xml) skal du angive en streng i formatet : <Peer_Firmware_Sharing ua="na">Ja</Peer_Firmware_Sharing>

  • Indstil dette felt til Ja eller Nej på websiden til telefonadministration.

Logserver for peer-firmwaredeling

Angiver IP-adressen og porten, som UDP-meddelelsen sendes til.

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

Konfigurer denne parameter med en af metoderne:

  • I telefonkonfigurationsfilen med XML(cfg.xml) skal du angive en streng i dette format: <Peer_Firmware_Sharing_Log_Server ua="na">10.98.76.123:514</Peer_Firmware_Sharing_Log_Server>

  • Angiv logserveradressen på websiden til telefonadministration.

Parametre for generelle formål

Følgende tabel definerer funktionen og brugen af hver parameter i afsnittet Parametre for generelle formål under fanen Klargøring.

Tabel 3. Parametre for generelle formål

Parameternavn

Beskrivelse og standardværdi

GPP A - GPP P

Parametrene for generelle formål (GPP_*) bruges som frie strengregistre, når telefonerne konfigureres til at interagere med en bestemt klargøringsserverløsning. De kan konfigureres til at indeholde forskellige værdier, herunder følgende:

  • Krypteringsnøgler.

  • URL-adresser.

  • Oplysninger om status ved klargøring i flere faser.

  • Skabeloner for Post-anmodninger.

  • Tilknytninger til alias for parameternavn

  • Delvise strengværdier, eventuelt samlet til komplette parameterværdier.

Standardværdien er tom.

Makroudvidelsesvariabler

Visse makrovariabler genkendes i følgende klargøringsparametre:

  • Profile_Rule (Profilregel)

  • Profile_Rule_* (Profilregel_*)

  • Resync_Trigger_* (Udløser 1 af gensynkronisering_*)

  • Opgraderingsregel

  • Log_*

  • GPP_* (under visse betingelser)

I disse parametre genkendes og udvides syntakstyper som f.eks. $NAME eller $(NAME).

Understrenge i makrovariable kan angives med notationen $(NAME:p) og $(NAME:p:q), hvor p og q er ikke-negative heltal (tilgængelig i revision 2.0.11 og derover). Den resulterende makroudvidelse i understrengen, startende ved tegnforskydning p, med længde q (eller indtil afslutningen af streng, hvis q ikke er angivet). Hvis GPP_A f.eks. indeholder ABCDEF, så udvides $(A:2) til CDEF, og $(A:2:3) udvides til CDE.

En ukendt navn er ikke oversat, og formen $NAME eller $(NAME) forbliver uændret i parameterværdien efter udvidelse.

Parameternavn

Beskrivelse og standardværdi

$

Formen $$ udvides til et enkelt $-tegn.

A til og med P

Erstattet af indholdet af parametrene for generelle formål GPP_A til og med GPP_P.

SA til og med SD

Erstattes af parametrene GPP_SA til og med GPP_SD til særlige formål. Disse parametre opbevarer nøgler eller adgangskoder, der bruges ved klargøring.

$SA til og med $SD genkendes som argumenter til den valgfri URL-kvalifikationer til gensynkronisering, --key.

MA

MAC-adresse, der bruger hexidecimale cifre med små bogstaver, f.eks. (000e08aabbcc).

MAU

MAC-adresse, der bruger hexidecimale cifre med store bogstaver, f.eks. (000E08AABBCC).

MAC

MAC-adresse, der bruger hexidecimale cifre med små bogstaver og koloner for at adskille par af hexidecimale cifre. For eksempel 00:0e:08:aa:bb:cc.

PN

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

PSN

Produktserienummer. For eksempel V03.

SN

Serienummerstreng, f.eks. 88012BA01234.

CCERT

Status for SSL-klientcertifikat: installeret eller ikke installeret.

IP

IP-adressen på telefonen i det lokale undernet. For eksempel 192.168.1.100.

EXTIP

Ekstern IP for telefonen som set på internettet. For eksempel 66.43.16.52.

SWVER

Softwareversionsstreng. F.eks.

PHONEOS.3-1-1-0104-37

HWVER

Hardwareversionsstreng. For eksempel 2.0.1

PRVST

Klargøringstilstand (en numerisk streng):

-1 = eksplicit anmodning om gensynkronisering

0 = gensynkronisering ved start

1 = periodisk gensynkronisering

2 = gensynkronisering er mislykket, antal nye forsøg

UPGST

Opgraderingstilstand (en numerisk streng):

1 = første opgraderingsforsøg

2 = opgradering er mislykket, antal nye forsøg

UPGERR

Resulterende meddelelse (ERR) om tidligere opgraderingsforsøg; f.eks. http_get er mislykket.

PRVTMR

Sekunder siden sidste forsøg gensynkronisering.

UPGTMR

Sekunder siden sidste forsøg opgradering

REGTMR1

Sekunder siden linje 1 mistede registrering med SIP-server.

REGTMR2

Sekunder siden linje 2 mistede registrering med SIP-server.

UPGCOND

Tidligere makronavn.

SCHEME

Filadgangsskema, en af TFTP, HTTP eller HTTPS, som hentet efter parsing af URL-adresse til gensynkronisering eller opgradering.

SERV

Anmod om destinationsservers værtsnavn, som hentet efter under parsing af URL-adresse til gensynkronisering eller opgradering.

SERVIP

Anmod om destinationsservers IP-adresse, som hentet efter parsing af URL-adresse til gensynkronisering eller opgradering, muligvis efter DNS-opslag.

PORT

Anmod om destinations-UDP/TCP-port, som hentet efter parsing af URL-adresse til gensynkronisering eller opgradering.

PATH

Anmod om filsti, som hentet efter under parsing af URL-adresse til gensynkronisering eller opgradering.

ERR

Resulterende meddelelse om forsøg på gensynkronisering eller opgradering. Kun nyttig ved generering af resulterende syslog-meddelelser. Værdien bevares i variablen UPGERR i tilfælde af forsøg på opgradering.

UIDn

Indholdet af linje UserID-konfigurationsparameteren for linje n.

EMS

Extension Mobility Status (status for mobilitet af lokalnummer)

MUID

Extension Mobility User ID (Bruger-id for mobilitet af lokalnummer)

MPWD

Extension Mobility Password (Adgangskode for mobilitet af lokalnummer)

Interne fejlkoder

Telefonen definerer et antal interne fejlkoder (X00 – X 99) for at lette konfigurationen ved at give en finere styring af enhedens funktionsmåde under visse fejlbetingelser.

Tabel 4. Interne fejlkoder

Parameternavn

Beskrivelse og standardværdi

X00

Transportlagsfejl (eller ICMP) ved afsendelse af en SIP-anmodning.

X20

Timeout for SIP-anmodning, mens der ventes på et svar.

X40

Generel SIP-protokolfejl (f.eks. et ikke-acceptabelt codec i SDP i 200 og kvitteringsmeddelelser, eller der er timeout, mens der ventes på kvittering).

X60

Det opkaldt nummer er ugyldigt i henhold til den angivne opkaldsplan.