- Start
- /
- Artikel
Inrichtingsparameters voor telefoons uit de 9800-serie en 8875 (BroadWorks)
Dit Help-artikel is voor Cisco Desk Phone 9800 Series en Cisco Video Phone 8875 geregistreerd bij Cisco BroadWorks. De informatie op deze pagina bevat de inrichtingsparameters en hun syntaxis.
Typen inrichtingsparameters
In dit gedeelte worden de inrichtingsparameters beschreven die in grote lijnen zijn ingedeeld volgens functie.
Parameters voor algemeen gebruik
De algemene parameters GPP_* () worden gebruikt als vrije stringregisters bij het configureren van de telefoon voor interactie met een bepaalde provisioning serveroplossing. De parameters GPP_* zijn standaard leeg. Ze kunnen zo worden geconfigureerd dat ze verschillende waarden bevatten, waaronder de volgende:
-
Encryptiesleutels
-
URL's
-
Informatie over de status van de levering in meerdere fasen.
-
Sjablonen voor een aanvraag na de aanvraag
-
Parameternaam, aliaskaarten
-
Gedeeltelijke tekenreekswaarden, uiteindelijk gecombineerd tot volledige parameterwaarden.
De GPP_*-parameters zijn beschikbaar voor macro-uitbreiding binnen andere inrichtingsparameters. Voor dit doel zijn macronamen van één letter in hoofdletters (A tot en met P) voldoende om de inhoud van GPP_A tot en met GPP_P te identificeren. De macronamen SA tot en met SD van twee letters in hoofdletters identificeren ook GPP_SA tot en met GPP_SD als een speciaal hoofdletter wanneer ze worden gebruikt als argument voor de volgende URL-opties:
sleutel, uid en pwd
Deze parameters kunnen worden gebruikt als variabelen in de bevoorradings- en upgraderegels. Er wordt naar ze verwezen door de naam van de variabele vooraf te laten gaan door een '$' teken, zoals $GPP_A.
Parameters inschakelen
De parameters Provision_Enable en Upgrade_Enable regelen alle bewerkingen voor het opnieuw synchroniseren van profielen en het upgraden van de firmware. Deze parameters regelen hersynchronisaties en upgrades onafhankelijk van elkaar. Deze parameters regelen ook het opnieuw synchroniseren en upgraden van URL-opdrachten die via de beheerserver worden uitgegeven. Beide parameters zijn standaard ingesteld op Ja.
De parameter ReSync_from_SIP beheert aanvragen voor hersynchronisatiebewerkingen. Er wordt een SIP NOTIFY-gebeurtenis verzonden van de proxyserver van de serviceprovider naar de telefoon. Indien ingeschakeld, kan de proxy een hersynchronisatie aanvragen. Hiervoor stuurt de proxy een SIP NOTIFY-bericht met de header Event: resync naar het apparaat.
Het apparaat betwist het verzoek met een 401-antwoord (autorisatie geweigerd voor gebruikte inloggegevens). Het apparaat verwacht een geverifieerd vervolgverzoek voordat het hersynchronisatieverzoek van de proxy wordt gehonoreerd. De headers Event: reboot_now en Event: restart_now voeren respectievelijk koude en warme herstarts uit, die ook worden uitgedaagd.
De twee resterende mogelijkheden zijn Resync_On_Reset en Resync_After_Upgrade_Attempt. Deze parameters bepalen of het apparaat opnieuw wordt gesynchroniseerd nadat de software opnieuw is opgestart en na elke upgradepoging.
Wanneer Resync_On_Reset is ingeschakeld, introduceert het apparaat een willekeurige vertraging die volgt op de opstartvolgorde voordat de reset wordt uitgevoerd. De vertraging is een willekeurige tijd tot de waarde die de Resync_Random_Delay (in seconden) specificeert. In een pool van telefoons die tegelijkertijd worden opgestart, spreidt deze vertraging de starttijden van de hersynchronisatieverzoeken van elk toestel. Deze functie kan nuttig zijn in een grote residentiële omgeving, in het geval van een regionale stroomuitval.
Triggers
Met de telefoon kunt u met bepaalde tussenpozen of op een bepaald tijdstip opnieuw synchroniseren.
Met specifieke tussenpozen opnieuw synchroniseren
De telefoon is ontworpen om periodiek opnieuw te synchroniseren met de provisioningsserver. Het hersynchronisatie-interval wordt ingesteld in Resync_Periodic (seconden). Als deze waarde leeg blijft, wordt het apparaat niet regelmatig opnieuw gesynchroniseerd.
De hersynchronisatie vindt meestal plaats wanneer de spraaklijnen niet worden gebruikt. Als een spraaklijn actief is wanneer opnieuw moet worden gesynchroniseerd, stelt de telefoon de hersynchronisatieprocedure uit tot de lijn weer inactief wordt. Een hersynchronisatie kan ertoe leiden dat de waarden van de configuratieparameters veranderen.
Een hersynchronisatie kan mislukken omdat de telefoon geen profiel van de server kan ophalen, het gedownloade bestand beschadigd is of er een interne fout is opgetreden. Het apparaat probeert opnieuw te synchroniseren na een tijd die is gespecificeerd in Resync_Error_Retry_Delay (seconden). Als Resync_Error_Retry_Delay is ingesteld op 0, probeert het apparaat niet opnieuw te synchroniseren na een mislukte hersynchronisatiepoging.
Als een upgrade mislukt, wordt een nieuwe poging uitgevoerd na enkele seconden Upgrade_Error_Retry_Delay.
Er zijn twee configureerbare parameters beschikbaar om een hersynchronisatie voorwaardelijk te activeren: Resync_Trigger_1 en Resync_Trigger_2. Elke parameter kan worden geprogrammeerd met een voorwaardelijke expressie die een macro-uitbreiding ondergaat. Wanneer het hersynchronisatie-interval verstrijkt (tijd voor de volgende hersynchronisatie), zullen de triggers, indien ingesteld, de hersynchronisatie voorkomen, tenzij een of meer triggers op true uitvallen.
De volgende voorbeeldvoorwaarde activeert een hersynchronisatie. In het voorbeeld is de laatste poging tot upgrade van de telefoon meer dan 5 minuten (300 seconden) verstreken en zijn er minstens 10 minuten (600 seconden) verstreken sinds de laatste poging tot hersynchronisatie.
$UPGTMR gt 300 and $PRVTMR ge 600
Op een bepaald tijdstip opnieuw synchroniseren
Met de parameter Resync_At kan de telefoon op een bepaald tijdstip opnieuw synchroniseren. Deze parameter gebruikt het 24-uurs formaat (hhmm) om de tijd aan te geven.
Met de parameter Resync_At_Random_Delay kan de telefoon opnieuw synchroniseren met een onbepaalde vertraging. Deze parameter gebruikt een positief geheel getal om de tijd aan te geven.
Voorkom dat de server wordt overspoeld met hersynchronisatieverzoeken van meerdere telefoons die zijn ingesteld om tegelijkertijd opnieuw te synchroniseren. Om dit te doen, activeert de telefoon de hersynchronisatie tot 10 minuten na de opgegeven tijd.
Als u bijvoorbeeld de hersynchronisatietijd instelt op 1000 (10.00 uur), activeert de telefoon de hersynchronisatie op elk moment tussen 10.00 en 10.10 uur.
Deze functie is standaard uitgeschakeld. Als de Resync_At-parameter is ingesteld, wordt de parameter Resync_Periodic genegeerd.
Configureerbare planningen
U kunt planningen configureren voor periodieke hersynchronisaties en u kunt de intervallen voor het opnieuw synchroniseren en upgraden specificeren met behulp van de volgende inrichtingsparameters:
-
Resync_Periodic
-
Resync_Error_Retry_Delay
-
Upgrade_Error_Retry_Delay
Elke parameter accepteert een enkele vertragingswaarde (seconden). De nieuwe uitgebreide syntaxis maakt een door komma's gescheiden lijst van opeenvolgende delay-elementen mogelijk. Het laatste element in de reeks wordt impliciet voor altijd herhaald.
Optioneel kunt u een plusteken gebruiken om een andere numerieke waarde aan te geven die een willekeurige extra vertraging toevoegt.
Voorbeeld 1
In dit voorbeeld wordt de telefoon periodiek elke twee uur opnieuw gesynchroniseerd. Als de hersynchronisatie mislukt, probeert het apparaat het opnieuw met deze tussenpozen: 30 minuten, 1 uur, 2 uur, 4 uur. Het apparaat blijft proberen met tussenpozen van 4 uur totdat het opnieuw is gesynchroniseerd.
Resync_Periodic=7200
Resync_Error_Retry_Delay=1800,3600,7200,14400
Voorbeeld 2
In dit voorbeeld wordt het apparaat elk uur periodiek opnieuw gesynchroniseerd (plus een extra willekeurige vertraging van maximaal 10 minuten). In het geval van een hersynchronisatiefout probeert het apparaat het opnieuw met deze tussenpozen: 30 minuten (plus maximaal 5 minuten). 1 uur (plus maximaal 10 minuten), 2 uur (plus maximaal 15 minuten). Het apparaat blijft proberen met tussenpozen van 2 uur (plus maximaal 15 minuten) totdat het opnieuw is gesynchroniseerd.
Resync_Periodic=3600+600
Resync_Error_Retry_Delay=1800+300,3600+600,7200+900
Voorbeeld 3
In dit voorbeeld, als een poging tot upgrade op afstand mislukt, probeert het apparaat de upgrade over 30 minuten opnieuw, dan opnieuw na nog een uur en dan over twee uur. Als de upgrade nog steeds mislukt, probeert het apparaat elke vier tot vijf uur opnieuw totdat de upgrade slaagt.
Upgrade_Error_Retry_Delay = 1800,3600,7200,14400+3600
Regels voor het profiel
De telefoon biedt meerdere parameters voor het configuratieprofiel op afstand (Profile_Rule*). Elke hersynchronisatiebewerking kan dus meerdere bestanden ophalen die door verschillende servers worden beheerd.
In het eenvoudigste scenario wordt het apparaat periodiek opnieuw gesynchroniseerd met één profiel op een centrale server, waarbij alle relevante interne parameters worden bijgewerkt. Als alternatief kan het profiel over verschillende bestanden worden verdeeld. Eén bestand is gebruikelijk voor alle telefoons in een implementatie. Voor elke account is een apart, uniek bestand beschikbaar. Coderingssleutels en certificaatinformatie kunnen worden aangeleverd door nog een ander profiel, dat op een aparte server wordt opgeslagen.
Telkens wanneer een hersynchronisatie moet worden uitgevoerd, evalueert de telefoon de vier parameters van Profile_Rule* achter elkaar:
-
Profile_Rule
-
Profile_Rule_B
-
Profile_Rule_C
-
Profile_Rule_D
Elke evaluatie kan resulteren in een opvraging van een profiel van een externe provisioningsserver, met een mogelijke update van een aantal interne parameters. Als een evaluatie mislukt, wordt de hersynchronisatiesequentie onderbroken en vanaf het begin opnieuw geprobeerd, zoals gespecificeerd door de parameter Resync_Error_Retry_Delay (seconden). Als alle evaluaties succesvol zijn, wacht het apparaat op de seconde die wordt gespecificeerd door de Resync_Periodic parameter en voert vervolgens een nieuwe synchronisatie uit.
De inhoud van elke Profile_Rule* parameter bestaat uit een reeks alternatieven. De alternatieven worden gescheiden door het teken | (pipe). Elk alternatief bestaat uit een voorwaardelijke expressie, een toewijzingsuitdrukking, een profiel-URL en eventuele bijbehorende URL-opties. Al deze componenten zijn optioneel binnen elk alternatief. De volgende zijn de geldige combinaties en de volgorde waarin ze moeten verschijnen, indien aanwezig:
[ conditional-expr ] [ assignment-expr ] [[ options ] URL ]
Binnen elke parameter Profile_Rule* moeten alle alternatieven, behalve de laatste, een voorwaardelijke expressie bevatten. Deze uitdrukking wordt als volgt geëvalueerd en verwerkt:
-
De voorwaarden worden van links naar rechts geëvalueerd, totdat er een wordt gevonden die als waar wordt beoordeeld (of totdat er een alternatief is gevonden zonder voorwaardelijke expressie).
-
Elke begeleidende opdrachtuitdrukking wordt geëvalueerd, indien aanwezig.
-
Als een URL is opgegeven als onderdeel van dat alternatief, wordt geprobeerd het profiel te downloaden dat zich op de opgegeven URL bevindt. Het systeem probeert de interne parameters dienovereenkomstig bij te werken.
Als alle alternatieven voorwaardelijke expressies bevatten en geen van de alternatieven op true evalueert (of als de hele profielregel leeg is), wordt de volledige parameter Profile_Rule* overgeslagen. De volgende parameter voor de profielregel in de reeks wordt geëvalueerd.
Voorbeeld 1
In dit voorbeeld wordt onvoorwaardelijk opnieuw gesynchroniseerd met het profiel op de opgegeven URL, en wordt een HTTP GET-verzoek naar de externe provisioningsserver uitgevoerd:
http://remote.server.com/cisco/$MA.cfg
Voorbeeld 2
In dit voorbeeld wordt het apparaat opnieuw gesynchroniseerd met twee verschillende URL's, afhankelijk van de registratiestatus van lijn 1. In geval van verloren registratie voert het apparaat een HTTP POST uit naar een CGI-script. Het apparaat verzendt de inhoud van de uitgebreide macroversie GPP_A, die mogelijk aanvullende informatie geeft over de status van het apparaat:
($PRVTMR ge 600)? http://p.tel.com/has-reg.cfg
| [--post a] http://p.tel.com/lost-reg?
Voorbeeld 3
In dit voorbeeld wordt het apparaat opnieuw gesynchroniseerd met dezelfde server. Het apparaat geeft aanvullende informatie als er geen certificaat in het apparaat is geïnstalleerd (voor oudere eenheden van vóór 2.0):
(“$CCERT” eq “Installed”)? https://p.tel.com/config?
| https://p.tel.com/config?cisco$MAU
Voorbeeld 4
In dit voorbeeld is regel 1 uitgeschakeld totdat GPP_A via de eerste URL gelijk is ingesteld aan Provisioned. Daarna wordt het opnieuw gesynchroniseerd met 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 aangenomen dat het profiel dat de server retourneert tags voor XML-elementen bevat. Deze tags moeten opnieuw worden toegewezen aan de juiste parameternamen op basis van de aliasenkaart die is opgeslagen in GPP_B:
[--alias b] https://p.tel.com/account/$PN$MA.xml
Een hersynchronisatie wordt doorgaans 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 een antwoord van de server dat niet is gevonden als een succesvolle hersynchronisatie. De standaardwaarde voor ReSync_Fails_on_fnf is Yes.
Regel voor een upgrade
De upgraderegel is om het apparaat te laten activeren naar een nieuwe lading en waar het de lading vandaan moet halen, indien nodig. Als het apparaat al is geladen, wordt niet geprobeerd de lading te krijgen. De geldigheid van de laadlocatie maakt dus niet uit wanneer de gewenste belasting zich op de inactieve partitie bevindt.
De Upgrade_Rule specificeert een firmwarebelasting die, indien anders dan de huidige belasting, zal worden gedownload en toegepast, tenzij beperkt door een voorwaardelijke expressie of Upgrade_Enable is ingesteld op Nee.
De telefoon biedt één configureerbare upgradeparameter op afstand, namelijk Upgrade_Rule. Deze parameter accepteert een syntaxis die vergelijkbaar is met de parameters van de profielregel. URL-opties worden niet ondersteund voor upgrades, maar voorwaardelijke expressies en toewijzingsuitdrukkingen kunnen wel 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 de parameters Profile_Rule* evalueert de parameter Upgrade_Rule elk alternatief totdat aan een voorwaardelijke expressie is voldaan of een alternatief geen voorwaardelijke expressie bevat. De bijbehorende opdrachtuitdrukking wordt geëvalueerd, indien gespecificeerd. Vervolgens wordt een upgrade naar de opgegeven URL geprobeerd.
Als de Upgrade_Rule een URL bevat zonder een voorwaardelijke expressie, wordt het apparaat geüpgraded naar de firmware-image die de URL specificeert. Na macro-uitbreiding en evaluatie van de regel probeert het apparaat niet opnieuw te upgraden totdat de regel is gewijzigd, of de effectieve combinatie van schema + server + poort + bestandspad is gewijzigd.
Om een firmware-upgrade uit te voeren, schakelt het apparaat audio uit aan het begin van de procedure en start het opnieuw op aan het einde van de procedure. Het apparaat start alleen automatisch een upgrade die wordt aangedreven door de inhoud van Upgrade_Rule als alle spraaklijnen momenteel niet actief zijn.
Bijvoorbeeld
https://10.73.10.223/firmware/PHONEOS-8875.1-0-1-0001-1.loads
In dit voorbeeld wordt met de Upgrade_Rule de firmware geüpgraded naar de afbeelding die is opgeslagen op de aangegeven URL.
Hier is nog een 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 apparaat gevraagd een van de twee afbeeldingen te laden, op basis van de inhoud van een algemene parameter, GPP_F.
Voorzieningsparameters
U kunt de inrichtingsparameters vinden op het tabblad Provisioning op de webpagina van de telefoon.
Parameters van het configuratieprofiel
De volgende tabel definieert de functie en het gebruik van elke parameter in de sectie Configuratieprofielparameters op het tabblad Inrichting.
|
Parameternaam |
Beschrijving en standaardwaarde |
|---|---|
|
Voorziening inschakelen |
Regelt alle hersynchronisatieacties, onafhankelijk van acties voor het upgraden van de firmware. Stel in op Ja om levering op afstand mogelijk te maken. De standaardwaarde is Ja. |
|
Opnieuw synchroniseren bij het opnieuw instellen |
Activeert een hersynchronisatie na elke herstart, met uitzondering van herstarts als gevolg van parameterupdates en firmware-upgrades. De standaardwaarde is Ja. |
|
Willekeurige vertraging opnieuw synchroniseren |
Een willekeurige vertraging na de opstartvolgorde voordat de reset wordt uitgevoerd, gespecificeerd in seconden. In een pool van IP-telefonieapparaten die gepland zijn om tegelijkertijd op te starten, zorgt dit voor een spreiding in de tijdstippen waarop elke eenheid een hersynchronisatieverzoek naar de provisioningserver stuurt. Deze functie kan nuttig zijn in een grote residentiële omgeving, in het geval van een regionale stroomuitval. De waarde voor dit veld moet een geheel getal zijn tussen 0 en 65535. De standaardwaarde is 2. |
|
Opnieuw synchroniseren (Hmm) |
Het tijdstip (HHmm) dat het apparaat opnieuw synchroniseert met de provisioningsserver. De waarde voor dit veld moet een viercijferig getal zijn, variërend van 0000 tot 2400 om de tijd aan te geven in HHMM-formaat. 0959 betekent bijvoorbeeld 09:59 uur. 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 genegeerd. |
|
Met willekeurige vertraging opnieuw synchroniseren |
Voorkomt overbelasting van de provisioningsserver wanneer een groot aantal apparaten tegelijkertijd wordt ingeschakeld. Om te voorkomen dat hersynchronisatieverzoeken vanaf meerdere telefoons naar de server worden overspoeld, wordt de telefoon opnieuw gesynchroniseerd tussen de uren en minuten, en de uren en minuten plus de willekeurige vertraging (hhmm, hhmm+random_delay). Als de willekeurige vertraging bijvoorbeeld = (Resync At Random Delay + 30) /60 minuten, wordt de invoerwaarde in seconden omgezet in minuten, waarbij naar boven wordt afgerond naar de volgende minuut om het uiteindelijke random_delay interval te berekenen. De geldige waarde ligt tussen 600 en 65535. Als de waarde lager is dan 600, ligt de willekeurige interne vertraging tussen 0 en 600. De standaardwaarde is 600 seconden (10 minuten). |
|
Periodiek opnieuw synchroniseren |
Het tijdsinterval tussen de periodieke hersynchronisatie met de provisioningsserver. De bijbehorende hersynchronisatietimer is pas actief na de eerste succesvolle synchronisatie met de server. De geldige formaten zijn als volgt:
Zet deze parameter op nul om periodieke hersynchronisatie uit te schakelen. De standaardwaarde is 3600 seconden. |
|
Fout bij opnieuw synchroniseren, opnieuw proberen, vertraging |
Als een hersynchronisatie mislukt omdat het IP-telefonieapparaat geen profiel van de server kon ophalen, of als het gedownloade bestand beschadigd is, of als er een interne fout optreedt, probeert het apparaat opnieuw te synchroniseren na een tijd die is opgegeven in seconden. De geldige formaten zijn als volgt:
Als de vertraging is ingesteld op 0, probeert het apparaat niet opnieuw te synchroniseren na een mislukte hersynchronisatiepoging. |
|
Vertraging van gedwongen hersynchronisatie |
Maximale vertraging (in seconden) wanneer de telefoon wacht voordat een hersynchronisatie wordt uitgevoerd. Het apparaat wordt niet opnieuw gesynchroniseerd terwijl een van de telefoonlijnen actief is. Omdat een hersynchronisatie enkele seconden kan duren, is het wenselijk om te wachten tot het apparaat langere tijd niet actief is geweest alvorens opnieuw te synchroniseren. Dit stelt een gebruiker in staat om zonder onderbreking achter elkaar te bellen. Het apparaat heeft een timer die begint af te tellen wanneer alle lijnen niet worden gebruikt. Deze parameter is de beginwaarde van de teller. Hersynchronisatiegebeurtenissen worden uitgesteld tot deze teller op nul is gedaald. De geldige waarde ligt tussen 0 en 65535. De standaardwaarde is 14.400 seconden. |
|
Opnieuw synchroniseren vanuit SIP |
Maakt het mogelijk om een hersynchronisatie te activeren via een SIP NOTIFY-bericht. De standaardwaarde is Ja. |
|
Opnieuw synchroniseren na een upgradepoging |
Schakelt de hersynchronisatie in of uit nadat een upgrade heeft plaatsgevonden. Als Ja is geselecteerd, wordt de synchronisatie geactiveerd. De standaardwaarde is Ja. |
|
Trigger 1 opnieuw synchroniseren, Trigger 2 opnieuw synchroniseren |
Configureerbare triggervoorwaarden voor hersynchronisatie. Een hersynchronisatie wordt geactiveerd wanneer de logische vergelijking in deze parameters op TRUE uitmondt. De standaardwaarde is (leeg). |
|
Hersynchronisatie mislukt op FNF |
Een hersynchronisatie wordt als mislukt beschouwd als een aangevraagd profiel niet van de server wordt ontvangen. Dit kan met deze parameter worden overschreven. Als de waarde op nee is ingesteld, accepteert het apparaat een antwoord van De standaardwaarde is Ja. |
|
Profielregel Profielregel B Profielregel C Profielregel D |
Elke profielregel informeert de telefoon over een bron waar hij een profiel kan verkrijgen (configuratiebestand). Tijdens elke hersynchronisatie past de telefoon alle profielen achter elkaar toe. Standaard:
U kunt de coderingssleutel optioneel tussen dubbele aanhalingstekens plaatsen („). |
|
DHCP-optie om te gebruiken |
DHCP-opties, gescheiden door komma's, die worden gebruikt om firmware en profielen op te halen. De standaardwaarde is 66.160.159.150,60,43,125. |
|
Msg voor logboekaanvraag |
Deze parameter bevat het bericht dat naar de syslogserver wordt gestuurd bij het begin van een hersynchronisatiepoging. De standaardwaarde is |
|
Msg met succes in het logboek |
Het syslogbericht dat wordt verzonden na succesvolle afronding van een poging tot hersynchronisatie. De standaardwaarde is |
|
Msg is een fout in het logboek |
Het syslogbericht dat wordt uitgegeven na een mislukte hersynchronisatiepoging. De standaardwaarde is |
|
Door de gebruiker configureerbare hersynchronisatie |
Hiermee kan een gebruiker de telefoon opnieuw synchroniseren vanaf het IP-telefoonscherm. De standaardwaarde is Ja. |
Parameters voor de upgrade van de firmware
De volgende tabel definieert de functie en het gebruik van elke parameter in de sectie Firmware Upgrade van het tabblad Provisioning.
|
Parameternaam |
Beschrijving en standaardwaarde |
|---|---|
|
Upgrade inschakelen |
Maakt het mogelijk om de firmware te upgraden, onafhankelijk van hersynchronisatieacties. De standaardwaarde is Ja. Configureer deze parameter op een van de volgende manieren:
|
|
Upgrade-fout, opnieuw proberen, vertraging |
Het interval voor het opnieuw proberen van de upgrade (in seconden) is van toepassing in geval van een mislukte upgrade. Het apparaat heeft een fouttimer voor de firmware-upgrade die wordt geactiveerd na een mislukte poging tot firmware-upgrade. De timer wordt geïnitialiseerd met de waarde in deze parameter. De volgende poging tot firmware-upgrade vindt plaats wanneer deze timer tot nul aftelt. De standaardwaarde is 3600 seconden. Configureer deze parameter op een van de volgende manieren:
|
|
Regel voor een upgrade |
Een script voor de upgrade van de firmware dat de upgradevoorwaarden en bijbehorende firmware-URL's definieert. Het gebruikt dezelfde syntaxis als Profile Rule. Gebruik de volgende indeling om de upgraderegel in te voeren:
Bijvoorbeeld:
Als er geen protocol is gespecificeerd, wordt uitgegaan van TFTP. 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 blanco. Configureer deze parameter op een van de volgende manieren:
|
|
Msg aanvraag voor een upgrade van het logboek |
Syslogbericht uitgegeven aan het begin van een poging tot firmware-upgrade. Standaard: Configureer deze parameter op een van de volgende manieren:
|
|
De upgrade van het logboek is geslaagd, Msg |
Syslogbericht dat verschijnt nadat een poging tot firmware-upgrade met succes is voltooid. De standaardwaarde is Configureer deze parameter op een van de volgende manieren:
|
|
Msg: Fout bij de upgrade van het logboek |
Syslogbericht uitgegeven na een mislukte poging tot firmware-upgrade. De standaardwaarde is Configureer deze parameter op een van de volgende manieren:
|
|
Firmware delen met collega's |
Schakelt de functie Peer Firmware Sharing (PFS) in of uit. Selecteer Ja of Nee om de functie in of uit te schakelen. Standaard: Ja Configureer deze parameter op een van de volgende manieren:
|
|
Logserver voor het delen van firmware door collega's |
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 op een van de volgende manieren:
|
Parameters voor algemeen gebruik
De volgende tabel definieert de functie en het gebruik van elke parameter in de sectie Parameters voor algemene doeleinden van het tabblad Inrichting.
|
Parameternaam |
Beschrijving en standaardwaarde |
|---|---|
|
GPP A - GPP P |
De algemene parameters GPP_* worden gebruikt als vrije tekenreeksen wanneer de telefoons worden geconfigureerd voor interactie met een bepaalde provisioning-serveroplossing. Ze kunnen zo worden geconfigureerd dat ze verschillende waarden bevatten, waaronder de volgende:
De standaardwaarde is blanco. |
Macro-uitbreidingsvariabelen
Bepaalde macrovariabelen worden herkend binnen de volgende inrichtingsparameters:
-
Profile_Rule
-
Profile_Rule_*
-
Resync_Trigger_*
-
Upgrade_Rule
-
Log_*
-
GPP_* (onder specifieke voorwaarden)
Binnen deze parameters worden syntaxistypen, zoals $NAME of $ (NAME), herkend en uitgebreid.
Subtekenreeksen voor macrovariabelen kunnen worden gespecificeerd met de notatie $ (Name:P) en $ (Name: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 de tekenverschuiving p, met de lengte q (of anders tot het einde van de tekenreeks als q niet is gespecificeerd). Als GPP_A bijvoorbeeld ABCDEF bevat, dan wordt $ (A:2) uitgebreid naar CDEF en $ (A: 2:3) naar CDE.
Een onbekende naam wordt niet vertaald en de vorm $NAME of $ (NAME) blijft na uitbreiding ongewijzigd in de parameterwaarde.
|
Naam van de parameter |
Beschrijving en standaardwaarde |
|---|---|
|
$ |
Het formulier $$ kan worden uitgebreid tot één $-teken. |
|
A tot en met P |
Vervangen door de inhoud van de algemene parameters GPP_A tot en met GPP_P. |
|
SA tot en met SD |
Vervangen door speciale parameters GPP_SA tot en met GPP_SD. Deze parameters bevatten sleutels of wachtwoorden die bij de bevoorrading worden gebruikt. $SA tot en met $SD worden herkend als argumenten voor de optionele hersynchronisatie-URL-kwalificatie, --key. |
|
MA |
MAC-adres met hexadecimale cijfers in kleine letters, bijvoorbeeld 000e08aabbcc. |
|
MAU |
MAC-adres met hexadecimale hoofdletters, bijvoorbeeld 000E08AABBCC. |
|
MAC |
MAC-adres met hexadecimale cijfers in kleine letters en dubbele punten om hexadecimale cijferparen van elkaar te scheiden. Bijvoorbeeld 00:0 e:08:aa:bb:cc. |
|
PN |
Productnaam. Bijvoorbeeld CP-8875, DP-9851, DP-9871. |
|
PSN | Serienummer van het product. Bijvoorbeeld V03. |
|
SN |
Serienummerreeks. Bijvoorbeeld 88012BA01234. |
|
CCERT |
Status van het 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 te zien op het internet. Bijvoorbeeld 66.43.16.52. |
|
SWVER |
Tekenreeks voor de softwareversie. Bijvoorbeeld PHONEOS.3-1-1-0104-37 |
|
HWVER |
String van de hardwareversie. Bijvoorbeeld 2.0.1 |
|
PRVST |
Provisioning State (een numerieke tekenreeks): -1 = expliciete hersynchronisatieverzoek 0 = opstarten en opnieuw synchroniseren 1 = periodieke hersynchronisatie 2 = opnieuw synchroniseren is mislukt, probeer het opnieuw |
|
UPGST |
Upgradestatus (een numerieke tekenreeks): 1 = eerste poging tot upgrade 2 = de upgrade is mislukt, probeer het opnieuw |
|
UPGERR |
Resultaatbericht (ERR) van een vorige upgradepoging; http_get is bijvoorbeeld mislukt. |
|
PRVTMR |
Enkele seconden sinds de laatste poging tot hersynchronisatie. |
|
UPGTMR |
Enkele seconden sinds de laatste upgradepoging. |
|
REGTMR1 |
Enkele seconden sinds Line 1 de registratie op de SIP-server verloor. |
|
REGTMR2 |
Enkele seconden sinds Line 2 de registratie op de SIP-server verloor. |
|
UPGCOND |
Oude macronaam. |
|
SCHEME |
Schema voor toegang tot bestanden, een schema van TFTP, HTTP of HTTPS, zoals verkregen na het parseren, hersynchroniseren of upgraden van de URL. |
|
SERV |
De hostnaam van de doelserver aanvragen, zoals verkregen na het parseren van de URL voor hersynchronisatie of upgrade. |
|
SERVIP |
Het IP-adres van de doelserver opvragen, zoals verkregen na het parseren van de URL voor hersynchronisatie of upgrade, mogelijk na een DNS-zoekopdracht. |
|
PORT |
Verzoek de UDP/TCP-doelpoort, zoals verkregen na het parseren van de URL voor hersynchronisatie of upgrade. |
|
PATH |
Het doelbestandspad aanvragen, zoals verkregen na het parseren van de URL voor hersynchronisatie of upgrade. |
|
ERR |
Bericht over het resultaat van een hersynchronisatie of een upgradepoging. Alleen nuttig voor het genereren van syslogberichten met resultaten. De waarde blijft behouden in de variabele UPGERR in het geval van een upgradepoging. |
|
UiDN |
De inhoud van de configuratieparameter Line n UserID. |
|
EMS |
Extension MobilityStatus |
|
MUID |
Extension MobilityGebruikers-ID |
|
MPWD |
Extension MobilityWachtwoord |
Interne foutcodes
De telefoon definieert een aantal interne foutcodes (X00—X99) om de configuratie te vergemakkelijken en zo een betere controle te bieden over het gedrag van het apparaat onder bepaalde foutomstandigheden.
|
Parameternaam |
Beschrijving en standaardwaarde |
|---|---|
|
X00 |
Fout in de transportlaag (of ICMP) bij het verzenden van een SIP-aanvraag. |
|
X20 |
Er loopt een time-out bij een SIP-aanvraag in afwachting van een antwoord. |
|
X40 |
Algemene fout in het SIP-protocol (bijvoorbeeld een onacceptabele codec in SDP in 200 en ACK-berichten, of een time-out tijdens het wachten op ACK). |
|
X60 |
Het gekozen nummer is volgens het gegeven belplan ongeldig. |