In dit artikel
dropdown icon
Typen inrichtingsparameters
    Parameters voor algemeen gebruik
    Parameters inschakelen
    Triggers
    Configureerbare planningen
    Regels voor het profiel
    Regel voor een upgrade
dropdown icon
Voorzieningsparameters
    Parameters van het configuratieprofiel
    Parameters voor de upgrade van de firmware
    Parameters voor algemeen gebruik
    Macro-uitbreidingsvariabelen
    Interne foutcodes

Inrichtingsparameters voor telefoons uit de 9800-serie en 8875 (BroadWorks)

list-menuIn dit artikel
list-menuFeedback?

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_* (Admin Login > Advanced > Voice > Provisioning) 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:

  1. Profile_Rule

  2. Profile_Rule_B

  3. Profile_Rule_C

  4. 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:

  1. 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).

  2. Elke begeleidende opdrachtuitdrukking wordt geëvalueerd, indien aanwezig.

  3. 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.

Tabel 1. Parameters van het configuratieprofiel

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:

  • Een geheel getal

    Voorbeeld: een invoer van 3000 geeft aan dat de volgende hersynchronisatie binnen 3000 seconden plaatsvindt.

  • Meerdere gehele getallen

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

  • Een tijdbereik

    Een invoer van 2400+30 geeft bijvoorbeeld aan dat de volgende hersynchronisatie plaatsvindt tussen 2400 en 2430 seconden na een succesvolle hersynchronisatie.

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:

  • Een geheel getal

    Voorbeeld: een invoer van 300 geeft aan dat de volgende poging om opnieuw te synchroniseren binnen 300 seconden plaatsvindt.

  • Meerdere gehele getallen

    Voorbeeld: Een invoer van 600.1200.300 geeft aan dat de eerste poging plaatsvindt binnen 600 seconden na de mislukking, de tweede poging binnen 1200 seconden na de mislukking van de eerste poging en de derde poging binnen 300 seconden na het mislukken van de tweede poging.

  • Een tijdbereik

    Een invoer van 2400+30 geeft bijvoorbeeld aan dat de volgende poging plaatsvindt tussen 2400 en 2430 seconden na een mislukte hersynchronisatie.

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 server dat niet is gevonden als een succesvolle hersynchronisatie.

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: /$psn.xml

Als u AES-256-CBC-versleuteling toepast op de configuratiebestanden, specificeer dan de coderingssleutel met het sleutelwoord --key als volgt:

[--sleutel] <encryption key>

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 $PN $MAC —Requesting% $SCHEME: //$SERVIP: $PORT$PATH.

Msg met succes in het logboek

Het syslogbericht dat wordt verzonden na succesvolle afronding van een poging tot hersynchronisatie.

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

Msg is een fout in het logboek

Het syslogbericht dat wordt uitgegeven na een mislukte hersynchronisatiepoging.

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

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.

Tabel 2. Parameters voor de upgrade van de firmware

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:

  • Voer in het configuratiebestand van de telefoon met XML (cfg.xml) een tekenreeks in dit formaat in: <Upgrade_Enable ua="na">Ja</Upgrade_Enable>

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

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:

  • Voer in het configuratiebestand van de telefoon met XML (cfg.xml) een tekenreeks in dit formaat in: <Upgrade_Error_Retry_Delay ua="na">3600</Upgrade_Error_Retry_Delay>

  • Stel de waarde in op de webpagina voor telefoonbeheer.

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:

<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 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:

  • Voer in het configuratiebestand van de telefoon 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.

Msg aanvraag voor een upgrade van het logboek

Syslogbericht uitgegeven aan het begin van een poging tot firmware-upgrade.

Standaard: $PN $MAC -- Een upgrade aanvragen $SCHEME: //$SERVIP: $PORT$PATH

Configureer deze parameter op een van de volgende manieren:

  • Voer in het configuratiebestand van de telefoon met XML (cfg.xml) een tekenreeks in deze indeling in: <Log_Upgrade_Request_Msg ua="na">$PN $MAC -- Request upgrade $SCHEME: //$SERVIP: $PORT$PATH</Log_Upgrade_Request_Msg>

  • Op de webpagina voor telefoonbeheer kunt u de parameter naar behoefte aanpassen.

De upgrade van het logboek is geslaagd, Msg

Syslogbericht dat verschijnt nadat een poging tot firmware-upgrade met succes is voltooid.

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

Configureer deze parameter op een van de volgende manieren:

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

  • Op de webpagina voor telefoonbeheer kunt u de parameter naar behoefte aanpassen.

Msg: Fout bij de upgrade van het logboek

Syslogbericht uitgegeven na een mislukte poging tot firmware-upgrade.

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

Configureer deze parameter op een van de volgende manieren:

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

  • Op de webpagina voor telefoonbeheer kunt u de parameter naar behoefte aanpassen.

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:

  • Voer in het configuratiebestand van de telefoon met XML (cfg.xml) een tekenreeks in dit formaat in: <Peer_Firmware_Sharing ua="na">Ja</Peer_Firmware_Sharing>

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

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:

  • Voer in het configuratiebestand van de telefoon met XML (cfg.xml) een tekenreeks in deze indeling in: <Peer_Firmware_Sharing_Log_Server ua="na">10.98.76</Peer_Firmware_Sharing_Log_Server>. 123:514

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

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.

Tabel 3. Parameters voor algemeen gebruik

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:

  • Encryptiesleutels.

  • URL's.

  • Informatie over de status van de levering in meerdere fasen.

  • Sjablonen voor een postadverzoek.

  • Parameternaam, alias maps.

  • Gedeeltelijke tekenreekswaarden, uiteindelijk gecombineerd tot volledige parameterwaarden.

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.

Tabel 4. Interne foutcodes

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.

Vond u dit artikel nuttig?
Vond u dit artikel nuttig?