Overzicht van inrichtingsparameters
Dit hoofdstuk beschrijft de inrichtingsparameters die kunnen worden gebruikt in configuratieprofielscripts.
De documentatie van dit product is waar mogelijk geschreven met inclusief taalgebruik. Inclusief taalgebruik wordt in deze documentatie gedefinieerd als taal die geen discriminatie op basis van leeftijd, handicap, gender, etniciteit, seksuele oriëntatie, sociaaleconomische status of combinaties hiervan weerspiegelt. In deze documentatie kunnen uitzonderingen voorkomen vanwege bewoordingen die in de gebruikersinterfaces van de productsoftware zijn gecodeerd, die op het taalgebruik in de RFP-documentatie zijn gebaseerd of die worden gebruikt in een product van een externe partij waarnaar wordt verwezen. Lees meer over hoe Cisco gebruikmaakt van inclusief taalgebruik.
Cisco biedt voor sommige gebieden lokalisatie aan voor deze content. De vertalingen worden echter alleen aangeboden ter informatie. Als er sprake is van inconsistentie, heeft de Engelse versie van de content de voorkeur.
Dit hoofdstuk beschrijft de inrichtingsparameters die kunnen worden gebruikt in configuratieprofielscripts.
In de volgende tabel worden de functie en het gebruik van elke parameter in de sectie Configuratieprofielparameters van het tabblad Inrichting gedefinieerd.
Naam van parameter |
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:
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:
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 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: [--toets <encryption key>] 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. |
In de volgende tabel worden de functie en het gebruik van elke parameter in de sectie Firmware-upgrade van het tabblad Inrichting gedefinieerd.
Naam van parameter |
Beschrijving en standaardwaarde |
---|---|
Upgrade inschakelen |
Hiermee zijn firmware-upgradebewerkingen onafhankelijk van hersynchronisatieacties ingeschakeld. De standaardwaarde is Ja. |
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. |
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:
Bijvoorbeeld:
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. |
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 |
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 |
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 |
Peer firmware delen |
Hiermee schakelt u of de functie Peer firmware delen in of uit. Selecteer Ja of Nee om de functie in of uit te schakelen. Standaard: Ja |
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. |
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.
Naam van parameter |
Beschrijving en standaardwaarde |
---|---|
GPP A - GPP P |
De standaardwaarde is leeg. |
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.
|
||
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 |
|||
PSN |
|||
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:
|
||
HWVER |
|||
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). |
||
ORIGTYPE AUTHSTATUS |
Hiermee wordt bepaald of er voor de telefoon een licentie moet worden aangevraagd. zijn: orig_ent, orig_mpp, geen zijn: klassiek, wxc, geen
|
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.
Naam van parameter |
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. |