Parametertypen instellen

Deze sectie beschrijft de inrichtingsparameter op volgorde van functie.

Parameters voor algemene doeleinden

De GPP_*-parameters voor algemene doeleinden (Beheerdersaanmelding > Geavanceerd > Spraak > Inrichting) worden gebruikt als vrije tekenreeks en worden geregistreerd bij het configureren van telefoon om met een bepaalde inrichtingsserveroplossing te werken. De GPP_ *-parameters zijn standaard leeg. Ze kunnen zo worden geconfigureerd dat ze diverse waarden bevatten, zoals de volgende:

  • Coderingssleutels

  • URL's

  • Statusinformatie voor inrichting met meerdere fasen

  • Plaatsingsaanvraagsjablonen

  • Parameternaamaliastoewijzingen

  • Gedeeltelijke tekenreekswaarden, uiteindelijk gecombineerd in complete parameterwaarden.

De parameters GPP_ * zijn beschikbaar voor macro-uitbreiding binnen andere inrichtingsparameters. Voor dit doel zijn macronamen met één hoofdletter (A tot P) voldoende om de inhoud van GPP_A tot GPP_P te identificeren. De macronamen met twee hoofdletters, SA tot SD, identificeren bovendien GPP_SA tot GPP_SD als een speciaal geval wanneer deze worden gebruikt als argumenten van de volgende URL-opties:

key, uid en pwd

Deze parameters kunnen worden gebruikt als variabelen in inrichtings- en upgraderegels. Er wordt naar verwezen door een '$'-teken toe te voegen voorafgaand aan de variabele naam, zoals $GPP_A.

Parameters inschakelen

Met de parameters Provision_Enable en Upgrade_Enable worden alle bewerkingen voor profielhersynchronisatie en firmware-upgrade beheerd. Deze parameters beheren hersynchronisaties en upgrades onafhankelijk van elkaar. Deze parameters beheren ook URL-opdrachten voor hersynchronisatie en upgrades die worden uitgegeven via de beheerwebserver. Beide van deze parameters zijn standaard ingesteld op Ja.

De parameter Resync_From_SIP bepaalt verzoeken voor hersynchronisatie. Een SIP NOTIFY-gebeurtenis wordt vanuit de proxyserver van de serviceprovider naar de telefoon verzonden. Indien ingeschakeld kan de proxy een hersynchronisatie verzoeken. Hiervoor verzendt de proxy een SIP NOTIFY-bericht met 'Gebeurtenis: koptekst hersynchroniseren' naar het apparaat.

Het apparaat daagt het verzoek uit met een 401-antwoord (autorisatie geweigerd voor gebruikte referenties). Het apparaat verwacht een geverifieerd volgend verzoek voordat deze het verzoek tot hersynchronisatie van de proxy inwilligt. De kopteksten 'Gebeurtenis: reboot_now' en 'Gebeurtenis: restart_now' voeren koud en warm opnieuw opstarten uit, en worden ook uitgedaagd.

De twee overgebleven inschakelbare parameters zijn Resync_On_Reset en Resync_After_Upgrade_Attempt. Deze parameters bepalen of een apparaat hersynchroniseert na software opnieuw opstarten en na elke upgradepoging.

Als Resync_On_Reset is ingeschakeld, introduceert het apparaat een willekeurige vertraging die de opstartprocedure opvolgt voordat het resetten wordt uitgevoerd. De vertraging is een willekeurige tijd tot maximaal de waarde die wordt gespecificeerd door Resync_Random_Delay (in seconden). In een pool met telefoons die tegelijkertijd opstarten, verspreidt deze vertraging de begintijd van de verzoeken tot hersynchronisatie van elk toestel. Deze functie kan handig zijn in een grote huisinstallatie, in het geval van een regionale stroomstoring.

Actie

Met de telefoon kunt u op specifieke intervallen of op een bepaald tijdstip hersynchroniseren.

Hersynchroniseren op specifieke intervallen

De telefoon is ontworpen om periodiek met de inrichtingsserver te hersynchroniseren. Het hersynchronisatie-interval wordt geconfigureerd in Resync_Periodic (seconden). Als deze waarde leeg wordt gelaten, hersynchroniseert het apparaat niet periodiek.

De hersynchronisatie vindt meestal plaats wanneer de spraaklijnen inactief zijn. Wanneer een spraaklijn actief is wanneer een hersynchronisatie moet plaatsvinden, vertraagt de telefoon de hersynchronisatieprocedure tot de lijn weer inactief wordt. Door een hersynchronisatie kunnen waarden van configuratieparameters worden veranderd.

Een hersynchronisatie kan mislukken omdat de telefoon een profiel niet kan ophalen van de server, omdat het gedownloade bestand corrupt is of omdat er een interne fout is opgetreden. Het apparaat probeert opnieuw te hersynchroniseren na de tijd die is gespecificeerd in Resync_Error_Retry_Delay (seconden). Als Resync_Error_Retry_Delay is ingesteld op 0, probeert het apparaat niet nogmaals te hersynchroniseren na een mislukte hersynchronisatiepoging.

Als een upgrade mislukt, wordt dit opnieuw geprobeerd na het aantal seconden dat is gespecificeerd met Upgrade_Error_Retry_Delay.

Er zijn twee configureerbare parameters beschikbaar om onder bepaalde voorwaarden een hersynchronisatie te veroorzaken: Resync_Trigger_1 en Resync_Trigger_2. Elke parameter kan worden geprogrammeerd met een voorwaardelijke expressie die macro-uitbreiding ondergaat. Wanneer het hersynchronisatie-interval verloopt (de tijd tot de volgende hersynchronisatie) voorkomen deze parameters, indien ingesteld, de hersynchronisatie tenzij één of meerdere voorwaarden als waar wordt geëvalueerd.

In het volgende voorbeeld wordt er bij de voorwaarde een hersynchronisatie veroorzaakt. In het voorbeeld is de laatste poging om de telefoon te upgraden meer dan 5 minuten geleden (300 seconden) en zijn er tenminste 10 minuten (600 seconden) verstreken sinds de laatste hersynchronisatiepoging.

$UPGTMR gt 300 en $PRVTMR ge 600

Hersynchroniseren op een specifiek tijdstip

Met de parameter Resync_At kan de telefoon op een bepaald tijdstip hersynchroniseren. Deze parameter gebruikt de 24-uursnotatie (uumm) om de tijd te specificeren.

Met de parameter Resync_At_Random_Delay kan de telefoon op een niet-gespecificeerde vertraging in de tijd hersynchroniseren. Deze parameter gebruikt een positief geheel getal om de tijd te specificeren.

Overbelasting van de server met verzoeken voor hersynchronisatie van meerdere telefoons die zijn ingesteld om op dezelfde tijd te hersynchroniseren moet worden vermeden. Daarom zal de telefoon de hersynchronisatie tot 10 minuten na de gespecificeerde tijd activeren.

Bijvoorbeeld, als u de tijd voor hersynchronisatie instelt op 1000 (10:00 uur), activeert de telefoon de hersynchronisatie ergens tussen 10:00 en 10:10 uur.

Deze functie is standaard uitgeschakeld. Wanneer de parameter Resync_At wordt ingericht, wordt de parameter Resync_Periodic genegeerd.

Configureerbare planningen

U kunt planningen voor periodiek hersynchroniseren configureren en u kunt de intervallen voor opnieuw proberen voor hersynchronisatie- en upgradefouten opgeven via deze inrichtingsparameters:

  • Periodiek hersynchroniseren

  • Vertraging nieuwe poging na hersynchronisatiefout

  • Vertraging nieuwe poging na upgradefout

Elke parameter accepteert een enkele vertragingswaarde (seconden). De nieuwe uitgebreide syntaxis maakt het mogelijk om een door komma's gescheiden lijst met opeenvolgende vertragingselementen te maken. Het laatste element in de reeks wordt impliciet eindeloos herhaald.

Indien gewenst, kunt u een plusteken (+) gebruiken om een andere numerieke waarde te specificeren die als een willekeurige extra vertraging wordt toegevoegd.

Voorbeeld 1

In dit voorbeeld hersynchroniseert de telefoon regelmatig elke 2 uur. Als er een fout bij hersynchroniseren optreedt, probeert het apparaat het met deze intervallen opnieuw: 30 minuten, 1 uur, 2 uur, 4 uur. Het apparaat blijft het met intervallen van 4 uur proberen totdat het met succes hersynchroniseert.

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

Voorbeeld 2

In dit voorbeeld hersynchroniseert het apparaat regelmatig elk uur (plus een extra willekeurige vertraging van maximaal 10 minuten). In het geval van een fout bij hersynchroniseren, probeert het apparaat het opnieuw met deze intervallen: 30 minuten (plus maximaal 5 minuten). 1 uur (plus maximaal 10 minuten), 2 uur (plus maximaal 15 minuten). Het apparaat blijft het met intervallen van 2 uur proberen (plus maximaal 15 minuten) totdat het met succes hersynchroniseert.

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

Voorbeeld 3

In dit voorbeeld, als een externe upgrade mislukt, probeert het apparaat de upgrade opnieuw na 30 minuten, vervolgens na één uur, vervolgens na twee uur. Als de upgrade nog steeds mislukt, probeert het apparaat dit opnieuw elke vier tot vijf uur totdat de upgrade is gelukt.

Upgrade_Error_Retry_Delay  =  1800,3600,7200,14400+3600

Profielregels

De telefoon biedt meerdere profielparameters voor externe configuratie (Profile_Rule*). Daardoor kunnen met elke hersynchronisatiebewerking meerdere bestanden worden opgehaald die door verschillende servers worden beheerd.

In het meeste eenvoudige scenario hersynchroniseert het apparaat periodiek naar een enkel profiel op een centrale server, waarmee alle belangrijke interne parameters worden bijgewerkt. Een profiel kan ook worden opgesplitst tussen verschillende bestanden. Eén bestand is gemeenschappelijk voor alle telefoons in een implementatie. Een ander, uniek bestand wordt aangeboden voor elk account. Coderingssleutels en certificaatinformatie kan door weer een ander profiel worden aangeboden, opgeslagen op een afzonderlijke server.

Wanneer er een hersynchronisatie moet worden uitgevoerd, evalueert de telefoon de vier Profile_Rule*-parameters op volgorde:

  1. Profile_Rule

  2. Profile_Rule_B

  3. Profile_Rule_C

  4. Profile_Rule_D

Elke evaluatie kan resulteren in het ophalen van een profiel van een externe inrichtingsserver, met een mogelijke update van een aantal interne parameters. Als een evaluatie mislukt, wordt de hersynchronisatie onderbroken, en wordt dit opnieuw geprobeerd vanaf het begin dat is aangegeven met de parameter Resync_Error_Retry_Delay (in seconden). Als alle evaluaties slagen, wacht het apparaat het aantal seconden dat is gespecificeerd door de parameter Resync_Periodic en voert het nog een hersynchronisatie uit.

De inhoud van elke parameter Profile_Rule* bestaat uit een aantal alternatieven. De alternatieven worden gescheiden door het teken |. Elk alternatief bestaat uit een voorwaardelijke expressie, een toewijzingsexpressie, een profiel-URL en eventuele gekoppelde URL-opties. Al deze onderdelen zijn optioneel binnen elk alternatief. Hieronder ziet u geldige combinaties en de volgorde waarin deze moeten voorkomen indien ze aanwezig zijn:

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

Binnen elke parameter Profile_Rule* moeten alle alternatieven behalve de laatste een voorwaardelijke expressie aanbieden. Deze expressie wordt als volgt geëvalueerd en verwerkt:

  1. Voorwaarden worden van links naar rechts geëvalueerd, tot er een is gevonden die als waar wordt geëvalueerd (of tot er een alternatief is gevonden zonder voorwaardelijke expressie).

  2. Een eventuele bijgaande toewijzingsexpressie wordt geëvalueerd, indien aanwezig.

  3. Als er een URL wordt gespecificeerd als onderdeel van dat alternatief, wordt geprobeerd het profiel te downloaden dat zich bevindt op de gespecificeerde URL. Het systeem probeert de interne parameters vervolgens bij te werken.

Als alle alternatieven voorwaardelijke expressies bevatten en er wordt er geen als waar geëvalueerd (of als de volledige profielregel leeg is) wordt de volledige parameter Profile_Rule* overgeslagen. De volgende profielregelparameter in de reeks wordt geëvalueerd.

Voorbeeld 1

In dit voorbeeld wordt onvoorwaardelijk gehersynchroniseerd naar het profiel op de gespecificeerde URL en wordt een HTTP GET-verzoek uitgevoerd naar de externe inrichtingsserver:

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

Voorbeeld 2

In dit voorbeeld wordt afhankelijk van de registratiestatus van lijn 1 het apparaat opnieuw gesynchroniseerd met twee verschillende URL's. Wanneer de registratie is zoekgeraakt, voert het apparaat een HTTP POST uit naar een CGI-script. Het apparaat verzendt de inhoud van GPP_A na macro-uitbreiding. Deze inhoud kan aanvullende informatie over de apparaatstatus bevatten:

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

Voorbeeld 3

In dit voorbeeld hersynchroniseert het apparaat naar dezelfde server. Het apparaat levert aanvullende informatie als een certificaat niet is geïnstalleerd op het toestel (voor oude toestellen vòòr 2.0):

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

Voorbeeld 4

In dit voorbeeld is lijn 1 uitgeschakeld tot GPP_A gelijk is ingesteld aan Ingericht via de eerste URL. Na afloop hersynchroniseert het naar de tweede URL:

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

Voorbeeld 5

In dit voorbeeld wordt er aangenomen dat het profiel dat wordt teruggezonden door de server XML-element-tags bevat. Deze tags moeten opnieuw worden vastgelegd met correcte parameternamen in de map met aliassen die is opgeslagen in GPP_B:

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

Een hersynchronisatie wordt meestal als mislukt beschouwd als een aangevraagd profiel niet van de server wordt ontvangen. De parameter Resync_Fails_On_FNF kan dit standaardgedrag overschrijven. Als Resync_Fails_On_FNF is ingesteld op Nee, accepteert het apparaat File-Not-Found-antwoord van de server als een succesvolle hersynchronisatie. De standaardwaarde voor Resync_Fails_On_FNF is Ja.

Upgraderegel

De upgraderegel is om het apparaat te vertellen om een nieuwe versie te activeren en waar deze versie moet worden opgehaald, indien nodig. Als de versie al op het apparaat staat, wordt deze niet opgehaald. De geldigheid van de locatie van de versie is dus niet van belang wanneer de gewenste versie in de inactieve partitie is.

De Upgrade_Rule (upgraderegel) specificeert een firmwareversie die, als deze verschilt van de huidige versie, wordt gedownload en wordt toegepast tenzij dit wordt beperkt door een voorwaardelijke expressie of als Upgrade_Enable (upgrade inschakelen) is ingesteld op Nee.

De telefoon biedt een configureerbare externe upgradeparameter, Upgrade_Rule. Deze parameter accepteert syntaxis die overeenkomt met de parameters van de profielregel. URL-opties worden niet ondersteund voor upgrades, maar voorwaardelijke expressies en toewijzingsexpressies kunnen worden gebruikt. Als voorwaardelijke expressies worden gebruikt, kan de parameter worden ingevuld met meerdere alternatieven, gescheiden door het |-teken. De syntaxis voor elk alternatief is als volgt:

[ conditional-expr ] [ assignment-expr ] URL

Net als in het geval van Profile_Rule*-parameters evalueert de parameter Upgrade_Rule elk alternatief totdat een voorwaardelijke expressie is voldaan of een alternatief geen voorwaardelijke expressie heeft. De bijbehorende toewijzingsexpressie wordt geëvalueerd, indien deze is gespecificeerd. Vervolgens wordt een upgrade naar de gespecificeerde URL geprobeerd.

Als de Upgrade_Rule een URL zonder een voorwaardelijke expressie bevat, wordt het apparaat bijgewerkt naar de firmware-image die door de URL wordt gespecificeerd. Na macro-uitbreiding en evaluatie van de regel probeert het apparaat niet opnieuw te upgraden tot de regel is aangepast, of tot de effectieve combinatie van schema + server + poort + bestandspad wordt gewijzigd.

Als u een firmware-upgrade wilt proberen, schakelt het apparaat audio uit aan het begin van de procedure en start het opnieuw op aan het einde van de procedure. Het apparaat begint automatisch een upgrade die wordt bepaald door de inhoud van Upgrade_Rule, alleen als alle spraaklijnen momenteel inactief zijn.

Bijvoorbeeld:

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

In dit voorbeeld zorgt de Upgrade_Rule ervoor dat er een firmware-upgrade wordt uitgevoerd naar de image die is opgeslagen op de aangegeven URL.

Hieronder volgt een ander voorbeeld:

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

In dit voorbeeld wordt het toestel aangestuurd om een van de twee images te laden, op basis van de inhoud van een parameter voor algemene doeleinden, GPP_F.

Inrichtingsparameters

U vindt de inrichtingsparameters op het tabblad Inrichting op de webpagina van de telefoon.

Configuratieprofielparameters

In de volgende tabel worden de functie en het gebruik van elke parameter in de sectie Configuratieprofielparameters van het tabblad Inrichting gedefinieerd.

Tabel 1. Configuratieprofielparameters

Parameternaam

Beschrijving en standaardwaarde

Inrichting inschakelen

Hiermee worden alle acties voor hersynchronisatie onafhankelijk van acties voor firmware-upgrade beheerd. Ingesteld op Ja om externe inrichting in te schakelen.

De standaardwaarde is Ja.

Hersynchroniseren bij reset

Hiermee wordt hersynchronisatie geactiveerd na elke keer opnieuw opstarten, met uitzondering van opnieuw opstarten dat wordt veroorzaakt door parameterupdates en firmware-upgrades.

De standaardwaarde is Ja.

Resync Random Delay (Willekeurige vertraging hersynchr.)

Een willekeurige vertraging na de opstartreeks alvorens de reset, opgegeven in seconden, uit te voeren. In een pool van IP-telefonieapparaten die zijn ingepland om tegelijkertijd te worden opgestart, zorgt dit voor een spreiding in de tijden waarop elk toestel een hersynchronisatieverzoek verzendt naar de inrichtingsserver. Deze functie kan handig zijn in een grote huisinstallatie, in het geval van een regionale stroomstoring.

De waarde voor dit veld moet een geheel getal zijn tussen 0 en 65535.

De standaardwaarde is 2.

Resync At (HHmm) (Hersynchroniseren om (UUmm))

De uren en minuten (UUmm) waarop het apparaat hersynchroniseert met de inrichtingsserver.

De waarde voor dit veld moet een viercijferig nummer zijn van 0000 tot 2400 om de tijd in de indeling UUmm aan te geven. 0959 geeft bijvoorbeeld 09:59 aan.

De standaardwaarde is leeg. Als de waarde ongeldig is, wordt de parameter genegeerd. Als deze parameter met een geldige waarde is ingesteld, wordt de parameter Resync Periodic (Periodiek hersynchroniseren) genegeerd.

Resync At Random Delay (Hersynchr. bij willekeurige vertraging)

Hiermee wordt overbelasting van de inrichtingsserver voorkomen wanneer een groot aantal apparaten tegelijk opstart.

Om te voorkomen dat de server overbelast raakt met verzoeken voor hersynchronisatie van meerdere telefoons, wordt de telefoon gehersynchroniseerd binnen het bereik van de uren en minuten, en de uren en minuten plus de willekeurige vertraging (hhmm, hhmm + random_delay). Bijvoorbeeld bij: willekeurige vertraging = (Hersynchroniseren bij willekeurige vertraging +30)/60 minuten, wordt de ingevoerde waarde in seconden geconverteerd naar minuten, met afronding naar boven tot de volgende minuut om het uiteindelijke random_delay-interval te berekenen.

Geldige waarden zijn van 600 tot 65535.

Als de waarde lager is dan 600, wordt de interne willekeurige vertraging tussen 0 en 600.

De standaardwaarde is 600 seconden (10 minuten).

Resync Periodic (Periodiek hersynchroniseren)

Het tijdsinterval tussen periodieke hersynchronisatie met de inrichtingsserver. De gekoppelde hersynchronisatietimer is alleen actief na de eerste geslaagde synchronisatie met de server.

De geldige indelingen zijn als volgt:

  • Een geheel getal

    Voorbeeld: een invoer van 3000 geeft aan dat de volgende hersynchronisatie over 3000 seconden optreedt.

  • Meerdere gehele getallen

    Voorbeeld: een invoer van 600,1200,300 geeft aan dat de eerste hersynchronisatie optreedt over 600 seconden, de tweede hersynchronisatie 1200 seconden na de eerste en de derde hersynchronisatie 300 seconden na de tweede.

  • Een tijdsbereik

    Bijvoorbeeld, een invoer van 2400+30 geeft aan dat de volgende hersynchronisatie tussen 2400 en 2430 seconden na een geslaagde hersynchronisatie optreedt.

Stel deze parameter in op nul om periodieke hersynchronisatie uit te schakelen.

De standaardwaarde is 3600 seconden.

Resync Error Retry Delay (Vertraging nieuwe poging na hersynchronisatiefout)

Als een hersynchronisatiebewerking mislukt omdat het IP-telefonieapparaat geen profiel van de server kan ophalen, omdat het gedownloade bestand beschadigd is of omdat er een interne fout optreedt, probeert het apparaat opnieuw te hersynchroniseren na een in seconden gespecificeerde tijd.

De geldige indelingen zijn als volgt:

  • Een geheel getal

    Voorbeeld: een invoer van 300 geeft aan dat de volgende poging tot hersynchronisatie over 300 seconden optreedt.

  • Meerdere gehele getallen

    Voorbeeld: een invoer van 600,1200,300 geeft aan dat de eerste poging optreedt over 600 seconden na de fout, de tweede poging 1200 seconden nadat de eerste poging is mislukt en de derde poging 300 seconden nadat de tweede poging is mislukt.

  • Een tijdsbereik

    Bijvoorbeeld, een invoer van 2400+30 geeft aan dat de volgende poging tussen 2400 en 2430 seconden na een mislukte hersynchronisatie optreedt.

Als de vertraging wordt ingesteld op 0, probeert het apparaat niet nogmaals te hersynchroniseren na een mislukte hersynchronisatiepoging.

Forced Resync Delay (Geforceerde vertraging hersynchronisatie)

Maximale vertraging (in seconden) die de telefoon wacht voordat een hersynchronisatie wordt uitgevoerd.

Het apparaat voert geen hersynchronisatie uit terwijl een van de telefoonlijnen actief is. Omdat een hersynchronisatie enkele seconden kan duren, is het gewenst om te wachten totdat het apparaat gedurende langere tijd inactief is voordat hersynchronisatie wordt uitgevoerd. Hierdoor kan een gebruiker zonder onderbreking oproepen blijven plaatsen.

Het apparaat heeft een timer die begint af te tellen wanneer alle lijnen inactief worden. Deze parameter is de eerste waarde van de teller. Hersynchronisaties worden uitgesteld tot deze teller op nul staat.

Geldige waarden zijn van 0 tot 65535.

De standaardwaarde is 14,400 seconden.

Resync From SIP (Hersynchroniseren via SIP)

Hiermee kan een hersynchronisatie worden geactiveerd via een SIP NOTIFY-bericht.

De standaardwaarde is Ja.

Resync After Upgrade Attempt (Hersynchroniseren na upgradepoging)

Hiermee schakelt u of de hersynchronisatiebewerking in of uit nadat een upgrade is uitgevoerd. Als u Ja selecteert, wordt de synchronisatie gestart.

De standaardwaarde is Ja.

Hersynchronisatietrigger 1, hersynchronisatietrigger 2

Configureerbare hersynchronisatietriggervoorwaarden. Een hersynchronisatie wordt geactiveerd wanneer de logische vergelijking in deze parameters TRUE retourneert.

De standaardwaarde is (leeg).

Resync Fails On FNF (Hersynchronisatie bij FNF)

Een hersynchronisatie wordt als mislukt beschouwd als een aangevraagd profiel niet van de server wordt ontvangen. Dit kan door deze parameter worden opgeheven. Wanneer deze instelling wordt ingesteld op nee, accepteert het apparaat een File-Not-Found-antwoord van de server als een succesvolle hersynchronisatie.

De standaardwaarde is Ja.

Profielregel

Profielregel B

Profielregel C

Profielregel D

Elke profielregel informeert de telefoon over een bron waarvan hij een profiel kan halen (configuratiebestand). Tijdens elke hersynchronisatie past de telefoon alle profielen achtereenvolgens toe.

Standaard: /$PSN.xml

Als u AES-256-CBC-codering op de configuratiebestanden toepast, geef de coderingssleutel dan als volgt op met het trefwoord --sleutel:

[--sleutel <coderingssleutel>]

U kunt de coderingssleutel optioneel tussen dubbele aanhalingstekens (") plaatsen.

DHCP Option To Use (Te gebruiken DHCP-optie)

DHCP-opties, gescheiden door komma's, gebruikt om firmware en profielen op te halen.

De standaardwaarde is 66,160,159,150,60,43,125.

Aanvraagbericht registreren

Deze parameter bevat het bericht dat wordt verzonden naar de syslog-server bij de start van een poging tot hersynchroniseren.

De standaardwaarde is 1$PN $MAC –Aanvragen % $SCHEME://$SERVIP:$PORT$PATH.

Succesbericht registreren

Het Syslog-bericht dat wordt uitgegeven na een succesvolle voltooiing van een hersynchronisatiepoging.

De standaardwaarde is $PN $MAC –Geslaagde hersynchronisatie % $SCHEME://$SERVIP:$PORT$PATH -- $ERR.

Foutbericht registreren

Het Syslog-bericht dat wordt uitgegeven na een mislukte hersynchronisatiepoging.

De standaardwaarde is $PN $MAC -- Hersynchronisatie mislukt: $ERR.

Door gebruiker configureerbare hersynchronisatie

Hiermee kan een gebruiker de telefoon hersynchroniseren via het scherm van de IP-telefoon.

De standaardwaarde is Ja.

Firmware-upgradeparameters

In de volgende tabel worden de functie en het gebruik van elke parameter in de sectie Firmware-upgrade van het tabblad Inrichting gedefinieerd.

Tabel 2. Firmware-upgradeparameters

Parameternaam

Beschrijving en standaardwaarde

Upgrade inschakelen

Hiermee zijn firmware-upgradebewerkingen onafhankelijk van hersynchronisatieacties ingeschakeld.

De standaardwaarde is Ja.

Configureer deze parameter met een van de volgende methoden:

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze indeling in: <Upgrade_Enable ua="na">Ja</Upgrade_Enable>

  • Stel op de webpagina voor telefoonbeheer dit veld in op Ja of Nee.

Vertraging nieuwe poging na upgradefout

Het interval voor opnieuw proberen te upgraden (in seconden) wordt toegepast in het geval van een fout bij de upgrade. Het apparaat heeft een fouttimer voor de firmware-upgrade die wordt geactiveerd nadat een firmware-upgrade mislukt. De timer wordt met de waarde in deze parameter geïnitialiseerd. De volgende firmware-upgradepoging vindt plaats wanneer naar nul wordt afgeteld.

De standaardwaarde is 3600 seconden.

Configureer deze parameter met een van de volgende methoden:

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in de volgende indeling in: <Upgrade_Error_Retry_Delay ua="na">3600</Upgrade_Error_Retry_Delay>

  • Stel de waarde in op de webpagina voor telefoonbeheer.

Upgraderegel

Een firmware-upgradescript waarmee upgradevoorwaarden en gekoppelde firmware-URL's worden gedefinieerd. Hierbij wordt dezelfde syntaxis als bij profielregel gebruikt.

Gebruik de volgende indeling om de upgraderegel in te voeren:

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

Bijvoorbeeld: 

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

Als er geen protocol wordt opgegeven, wordt TFTP verondersteld. Als er geen servernaam is opgegeven, wordt de host die de URL opvraagt, als servernaam gebruikt. Als er geen poort is opgegeven, wordt de standaardpoort gebruikt (69 voor TFTP, 80 voor HTTP of 443 voor HTTPS).

De standaardwaarde is leeg.

Configureer deze parameter met een van de volgende methoden:

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze indeling in: <Upgrade_Rule ua="na">http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads</Upgrade_Rule>

  • Voer op de webpagina voor telefoonbeheer het pad in waar het laadbestand is opgeslagen.

Log Upgrade Request Msg (Aanvraagbericht upgrade registreren)

Syslog-bericht dat wordt afgegeven bij de start van een firmware-upgradepoging.

Standaard: $PN $MAC -- Upgradeverzoek $SCHEME://$SERVIP:$PORT$PATH

Configureer deze parameter met een van de volgende methoden:

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in deze indeling in: <Log_Upgrade_Request_Msg ua="na">$PN $MAC -- Upgrade aanvragen $SCHEME://$SERVIP:$PORT$PATH</Log_Upgrade_Request_Msg>

  • Pas de parameter naar wens aan op de webpagina voor telefoonbeheer.

Log Upgrade Success Msg (Succesbericht upgrade registreren)

Syslog-bericht dat wordt afgegeven nadat de firmware-upgradepoging met succes is voltooid.

De standaardwaarde is $PN $MAC-- Succesvolle upgrade $SCHEME://$SERVIP:$PORT$PATH--$ERR

Configureer deze parameter met een van de volgende methoden:

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in de volgende indeling in: <Log_Upgrade_Success_Msg ua="na">$PN $MAC -- Succesvolle upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERR</Log_Upgrade_Success_Msg>

  • Pas de parameter naar wens aan op de webpagina voor telefoonbeheer.

Log Upgrade Failure Msg (Foutbericht upgrade registreren)

Syslog-bericht dat wordt afgegeven nadat de firmware-upgradepoging is mislukt.

De standaardwaarde is $PN $MAC -- Upgrade mislukt: $ERR

Configureer deze parameter met een van de volgende methoden:

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in de volgende indeling in: <Log_Upgrade_Failure_Msg ua="na">$PN $MAC -- Upgrade mislukt: $ERR</Log_Upgrade_Failure_Msg>

  • Pas de parameter naar wens aan op de webpagina voor telefoonbeheer.

Peer firmware delen

Hiermee schakelt u de Peer Firmware Sharing (PFS)-functie in of uit. Selecteer Ja of Nee om de functie in of uit te schakelen.

Standaard: Ja

Configureer deze parameter met een van de volgende methoden:

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in de volgende indeling in: <Peer_Firmware_Sharing ua="na">Ja</Peer_Firmware_Sharing>

  • Stel op de webpagina voor telefoonbeheer dit veld in op Ja of Nee.

Peer Firmware Sharing Log Server (Peer Firmware Sharing-logserver)

Geeft het IP-adres en de poort aan waarnaar het UDP-bericht wordt verzonden.

Bijvoorbeeld: 10.98.76.123:514 waarbij 10.98.76.123 het IP-adres is en 514 het poortnummer.

Configureer deze parameter met een van de volgende methoden:

  • Voer in het telefoonconfiguratiebestand met XML (cfg.xml) een tekenreeks in de volgende indeling in: <Peer_Firmware_Sharing_Log_Server ua="na">10.98.76.123:514</Peer_Firmware_Sharing_Log_Server>

  • Voer op de webpagina voor telefoonbeheer het adres van de logserver in.

Parameters voor algemene doeleinden

In de volgende tabel worden de functie en het gebruik van elke parameter in de sectie Parameters voor algemene doeleinden van het tabblad Inrichting gedefinieerd.

Tabel 3. Parameters voor algemene doeleinden

Parameternaam

Beschrijving en standaardwaarde

GPP A - GPP P

De GPP_*-parameters voor algemene doeleinden worden gebruikt als vrije tekenreeks en worden geregistreerd bij het configureren van telefoons om met een bepaalde inrichtingsserveroplossing te werken. Ze kunnen zo worden geconfigureerd dat ze diverse waarden bevatten, zoals de volgende:

  • Coderingssleutels.

  • URL's.

  • Statusinformatie voor inrichting met meerdere fasen

  • Plaatsingsaanvraagsjablonen.

  • Parameternaamaliastoewijzingen.

  • Gedeeltelijke tekenreekswaarden, uiteindelijk gecombineerd in complete parameterwaarden.

De standaardwaarde is leeg.

Variabelen voor macro-uitbreiding

Bepaalde macro-variabelen worden herkend binnen de volgende inrichtingsparameters:

  • Profile_Rule

  • Profile_Rule_*

  • Resync_Trigger_*

  • Upgrade_Rule

  • Log_ *

  • GPP_* (onder bepaalde omstandigheden)

Syntaxistypen zoals $NAME of $(NAME), worden herkend en uitgebreid binnen deze parameters.

Macro-variabele subtekenreeksen kunnen worden opgegeven met de notatie $(NAME:p) en $(NAAM:p:q), waarbij p en q niet-negatieve gehele getallen zijn (beschikbaar in revisie 2.0.11 en hoger). De resulterende macro-uitbreiding is de subtekenreeks die begint bij tekenverschuiving p, met lengte q (of anders tot het einde van de tekenreeks als q niet is gespecificeerd). Bijvoorbeeld, als GPP_A ABCDEF bevat, wordt $(A:2) uitgebreid naar CDEF en wordt $(A:2:3) uitgebreid naar CDE.

Een niet-herkende naam wordt niet vertaald en de vorm $NAME of $(NAME) blijft ongewijzigd in de parameterwaarde na uitbreiding.

Naam van parameter

Beschrijving en standaardwaarde

$

De vorm $$ wordt uitgebreid tot één teken $.

A tot en met P

Vervangen door de inhoud van de parameters voor algemene doeleinden GPP_A tot GPP_P.

SA tot SD

Wordt vervangen door de speciale parameters GPP_SA tot en met GPP_SD. Deze parameters bevatten toetsen of wachtwoorden voor inrichting.

$SA tot en met $SD worden herkend als argumenten voor de optionele URL-kwalificatie voor opnieuw synchroniseren, --toets.

MA

MAC-adres met kleine letters hexadecimale tekens, bijvoorbeeld 000e08aabbcc.

MAU

MAC-adres met grote hexadecimale tekens, bijvoorbeeld 000E08AABBCC.

MAC

MAC-adres met kleine hexadecimale tekens en dubbele punten om hexadecimale tekenparen van elkaar te scheiden. Bijvoorbeeld 00:0e:08:aa:bb:cc.

PN

Productnaam. Bijvoorbeeld CP-8875, DP-9851, DP-9871.

PSN

Productserienummer. Bijvoorbeeld V03.

SN

Tekenreeks voor serienummer, bijvoorbeeld 88012BA01234.

CCERT

Status SSL-clientcertificaat: geïnstalleerd of niet geïnstalleerd.

IP

IP-adres van de telefoon binnen het lokale subnet. Bijvoorbeeld 192.168.1.100.

EXTIP

Extern IP-adres van de telefoon, zoals weergegeven op het internet. Bijvoorbeeld 66.43.16.52.

SWVER

Tekenreeks softwareversie. Bijvoorbeeld:

TELEFOON.3-1-1-0104-37

HWVER

Tekenreeks hardwareversie. Bijvoorbeeld 2.0.1

PRVST

Ppovisioningstatus (een reeks cijfers):

-1 = expliciete aanvraag hersynchroniseren

0 = opstarten hersynchroniseren

1 = periodiek hersynchroniseren

2 = synchroniseren is mislukt, nieuwe poging

UPGST

Status van upgrade (een reeks cijfers):

1 = eerste upgradepoging

2 = upgrade is mislukt, nieuwe poging

UPGERR

Resultaatbericht (ERR) van de vorige upgradepoging; bijvoorbeeld http_get is mislukt.

PRVTMR

Seconden sinds de laatste hersynchronisatiepoging.

UPGTMR

Seconden sinds de laatste upgradepoging.

REGTMR1

Seconden sinds registratie lijn 1 met SIP-server is verbroken.

REGTMR2

Seconden sinds registratie lijn 2 met SIP-server is verbroken.

UPGCOND

Oude macronaam

SCHEME

Bestandstoegangsschema, TFTP, HTTP of HTTPS, zoals verkregen na het parseren van hersynchronisatie- of upgrade-URL.

SERV

Aanvraag doelserverhostnaam, zoals verkregen na het parseren van de hersynchronisatie- of upgrade-URL.

SERVIP

Aanvraag doelserver IP-adres, zoals verkregen na het parseren van de hersynchronisatie- of upgrade-URL, mogelijk na een DNS-zoekopdracht.

PORT

Aanvraag doel UDP/TCP-poort, zoals verkregen na het parseren van de hersynchronisatie- of upgrade-URL.

PATH

Aanvraag doelbestandspad, zoals verkregen na het parseren van de hersynchronisatie- of upgrade-URL.

ERR

Resultaatbericht van hersynchronisatie- of upgradepoging. Alleen nuttig bij het genereren van resultaat syslog-berichten. De waarde wordt behouden in de variabele UPGERR in het geval van upgrade-pogingen.

UIDn

De inhoud van de configuratieparameter Line n UserID (gebruikers-id voor lijn n).

EMS

Extension Mobility-status

MUID

Extension Mobility-gebruikers-id

MPWD

Extension Mobility-wachtwoord

Interne foutcodes

De telefoon definieert een aantal interne foutcodes (X00 - X99) om configuratie te faciliteren door betere controle over het gedrag van het toestel te bieden bij bepaalde foutomstandigheden.

Tabel 4. Interne foutcodes

Parameternaam

Beschrijving en standaardwaarde

X00

Transportlaagfout (of ICMP-fout) bij het verzenden van een SIP-verzoek.

X20

Er ontstaat een time-out met het SIP-verzoek terwijl er wordt gewacht op antwoord.

X40

Algemene SIP-protocolfout (bijvoorbeeld een onacceptabele codec in SDP in 200- en ACK-berichten, of er ontstaat een time-out bij het wachten op ACK).

X60

Gekozen nummer is ongeldig volgens het gegeven kiesplan.