Bereitstellungsparameter – Übersicht
In diesem Kapitel werden die Bereitstellungsparameter erläutert, die in Konfigurationsprofilskripts verwendet werden können.
In dem Dokumentationssatz für dieses Produkt wird die Verwendung inklusiver Sprache angestrebt. Für die Zwecke dieses Dokumentationssatzes wird Sprache als „inklusiv“ verstanden, wenn sie keine Diskriminierung aufgrund von Alter, körperlicher und/oder geistiger Behinderung, Geschlechtszugehörigkeit und -identität, ethnischer Identität, sexueller Orientierung, sozioökonomischem Status und Intersektionalität impliziert. Dennoch können in der Dokumentation stilistische Abweichungen von diesem Bemühen auftreten, wenn Text verwendet wird, der in Benutzeroberflächen der Produktsoftware fest codiert ist, auf RFP-Dokumentation basiert oder von einem genannten Drittanbieterprodukt verwendet wird. Hier erfahren Sie mehr darüber, wie Cisco inklusive Sprache verwendet.
Cisco kann in einigen Regionen Übersetzungen dieses Inhalts in die Landessprache bereitstellen. Bitte beachten Sie, dass diese Übersetzungen nur zu Informationszwecken zur Verfügung gestellt werden. Bei Unstimmigkeiten hat die englische Version dieses Inhalts Vorrang.
In diesem Kapitel werden die Bereitstellungsparameter erläutert, die in Konfigurationsprofilskripts verwendet werden können.
In der folgenden Tabelle werden die Funktion und Verwendung der einzelnen Parameter im Abschnitt Konfigurationsprofilparameter auf der Registerkarte Bereitstellung definiert.
Parametername |
Beschreibung und Standardwert |
---|---|
Provision Enable (Bereitstellung aktivieren) |
Alle Resynchronisierungsaktionen werden unabhängig von Firmware-Upgrade-Aktionen gesteuert. Wählen Sie Ja aus, um die Remotebereitstellung zu aktivieren. Der Standardwert ist „Ja“. |
Resync On Reset (Resynchronisierung nach Neustart) |
Nach jedem Neustart wird eine Neusynchronisierung ausgelöst. Ausnahmen sind Neustarts als Folge von Parameteraktualisierungen und Firmware-Upgrades. Der Standardwert ist „Ja“. |
Resync Random Delay (Zufällige Resynchronisierungsverzögerung) |
Eine zufällige Verzögerung (in Sekunden) nach dem Einschalten bevor der Neustart ausgeführt wird. In einem Pool mit IP-Telefoniegeräten, die planmäßig gleichzeitig gestartet werden, werden die Zeiten verteilt, zu denen jede Einheit eine Resynchronisierungsanforderung an den Bereitstellungsserver sendet. Diese Funktion kann bei einer großen lokalen Bereitstellung nützlich sein, wenn ein Stromausfall auftritt. Der Wert für dieses Feld muss eine Ganzzahl zwischen 0 und 65535 sein. Der Standardwert ist 2. |
Erneute Synchronisierung um (HHmm) |
Die Zeitdauer der erneuten Synchronisierung des Geräts mit dem Bereitstellungsserver in Stunden und Minuten (HHmm). Der Wert für dieses Feld muss eine vierstellige Zahl im Bereich von 0000 bis 2400 sein, um die Uhrzeit im Format HHmm anzugeben. Beispielsweise steht 0959 für 09:59. Der Standardwert ist leer. Wenn der Wert ungültig ist, wird der Parameter ignoriert. Falls dieser Parameter auf einen gültigen Wert festgelegt ist, wird der Parameter Periodische Neusynchronisierung ignoriert. |
Resync At Random Delay (Zufällige Verzögerung für die erneute Synchronisierung) |
Verhindert eine Überlastung des Bereitstellungsservers, wenn eine große Anzahl an Geräten gleichzeitig eingeschaltet wird. Um zu verhindern, dass der Server mit Anforderungen für Resynchronisierungen von mehreren Telefonen überlastet wird, startet das Telefon die Resynchronisierung innerhalb des Bereichs der angegebenen Stunden und Minuten, plus ggf. die zufällige Verzögerungszeit (hhmm, hhmm + zufällige Verzögerung). Wenn beispielsweise die zufällige Verzögerung = (Erneute Synchronisierung bei zufälliger Verzögerung + 30)/60 Minuten beträgt, wird der eingegebene Wert in Sekunden in Minuten umgewandelt und auf die nächste volle Minute aufgerundet, um das endgültige Intervall der zufälligen Verzögerung zu berechnen. Der gültige Wert liegt zwischen 600 und 65535. Wenn der Wert kleiner als 600 ist, liegt das Intervall der zufälligen Verzögerung zwischen 0 und 600. Der Standardwert ist 600 Sekunden (10 Minuten). |
Resync Periodic (Periodische Resynchronisierung) |
Zeitintervall zwischen periodischen Resynchronisierungen mit dem Bereitstellungsserver. Der zugehörige Timer für die Resynchronisierung wird erst nach der ersten erfolgreichen Synchronisierung mit dem Server aktiviert. Dies sind die gültigen Formate:
Setzen Sie diesen Parameter auf 0, um die regelmäßige Resynchronisierung zu deaktivieren. Der Standardwert ist 3600 Sekunden. |
Resync Error Retry Delay (Wiederholungsverzögerung bei fehlgeschlagener Resynchronisierung) |
Wenn eine Resynchronisierung fehlschlägt, weil das IP-Telefoniegerät kein Profil vom Server abrufen konnte, die heruntergeladene Datei beschädigt ist oder ein interner Fehler auftritt, versucht das Gerät, erneut eine Resynchronisierung nach der in Sekunden festgelegten Zeitdauer auszuführen. Dies sind die gültigen Formate:
Wenn die Verzögerung auf 0 festgelegt ist, führt das Gerät keine erneute Synchronisierung aus, nachdem eine erneute Synchronisierung fehlgeschlagen ist. |
Forced Resync Delay (Erzwungene Resynchronisierungsverzögerung) |
Höchstwert für die Verzögerung (in Sekunden), bis das Telefon eine Resynchronisierung durchführt. Das Gerät führt keine Resynchronisierung durch, solange eine der Telefonleitungen aktiv ist. Da eine Resynchronisierung mehrere Sekunden dauern kann, sollte das Gerät vor der Resynchronisierung längere Zeit inaktiv gewesen sein. So können Benutzer mehrere Anrufe nacheinander tätigen, ohne unterbrochen zu werden. Das Gerät verfügt über einen Timer, der rückwärts zu laufen beginnt, sobald alle Leitungen inaktiv sind. Dieser Parameter ist der Anfangswert des Zählers. Resynchronisierungen erfolgen erst, wenn der Zähler bei 0 angelangt ist. Der gültige Wert liegt zwischen 0 und 65535. Der Standardwert ist 14.400 Sekunden. |
Resync From SIP (Resynchronisierung über SIP) |
Eine Resynchronisierung kann von einer SIP-NOTIFY-Nachricht ausgelöst werden. Der Standardwert ist „Ja“. |
Resync After Upgrade Attempt (Resynchronisierung nach versuchtem Upgrade) |
Aktiviert oder deaktiviert den Resynchronisierungsvorgang nach einem Upgrade. Wenn „Ja“ ausgewählt ist, wird eine Synchronisierung ausgelöst. Der Standardwert ist „Ja“. |
Resync Trigger 1, Resync Trigger 2 (Resynchronisierungs-Trigger 1, Resynchronisierungs-Trigger 2) |
Konfigurierbare Bedingungen zum Auslösen einer Resynchronisierung. Eine Resynchronisierung wird ausgelöst, wenn die logische Gleichung in diesen Parametern TRUE ergibt. Der Standardwert ist „Leer“. |
Resync Fails On FNF (Fehlgeschlagene Resynchronisierung aufgrund von FNF) |
Eine erneute Synchronisierung wird als fehlgeschlagen betrachtet, wenn ein angefordertes Profil vom Server nicht empfangen
wird. Dies kann mit diesem Parameter überschrieben werden. Wenn Sie Nein festlegen, akzeptiert das Gerät eine Der Standardwert ist „Ja“. |
Profilregel Profile Rule B (Profilregel B) Profile Rule C (Profilregel C) Profile Rule D (Profilregel D) |
Jede Profilregel teilt dem Telefon eine Quelle mit, über die das Telefon ein Profil (Konfigurationsdatei) erhalten kann. Bei jedem erneuten Synchronisierungsvorgang wendet das Telefon alle Profile nacheinander an. Standard: /$PSN.xml Wenn Sie die AES-256-CBC-Verschlüsselung auf die Konfigurationsdateien anwenden, geben Sie den Verschlüsselungscode mit dem Schlüsselwort --key wie folgt an: [--key <encryption key>] Sie können den Verschlüsselungscode optional in Anführungszeichen (") einschließen. |
DHCP Option To Use (Zu verwendende DHCP-Option) |
Durch Kommas getrennte DHCP-Optionen, die zum Abrufen der Firmware und Profile verwendet werden. Der Standardwert ist 66,160,159,150,60,43,125. |
Log Request Msg (Protokollmeldung über Anfragen) |
Dieser Parameter enthält die Nachricht, die zu Beginn eines Resynchronisierungsversuchs an den Syslog-Server gesendet wird. Der Standardwert ist $PN $MAC –Requesting % $SCHEME://$SERVIP:$PORT$PATH. |
Protokollmeldung über erfolgreiche Synchronisierung |
Die syslog-Meldung, die nach dem erfolgreichen Abschluss eines Resynchronisierungsversuchs ausgegeben wird. Der Standardwert ist $PN $MAC –Successful Resync % $SCHEME://$SERVIP:$PORT$PATH -- $ERR. |
Protokollmeldung über fehlgeschlagene Synchronisierung |
Die Syslog-Meldung, die nach dem Fehlschlagen eines Resynchronisierungsversuchs ausgegeben wird. Der Standardwert ist $PN $MAC -- Resync failed: $ERR. |
User Configurable Resync (Vom Benutzer konfigurierbare erneute Synchronisierung) |
Erlaubt dem Benutzer, das Telefon über den IP-Telefonbildschirm erneut zu synchronisieren. Der Standardwert ist „Ja“. |
In der folgenden Tabelle werden die Funktion und Verwendung der einzelnen Parameter im Abschnitt Firmware-Upgrade der Registerkarte Bereitstellung definiert.
Parametername |
Beschreibung und Standardwert |
---|---|
Upgrade aktivieren |
Mit dieser Option werden Firmware-Upgrade-Aktionen unabhängig von Resynchronisierungsaktionen aktiviert. Der Standardwert ist „Ja“. |
Wiederholungsverzögerung bei Upgrade-Fehler |
Das Upgrade-Intervall (in Sekunden), das nach einem fehlgeschlagenen Upgrade angewendet wird. Das Gerät verfügt über einen Timer für fehlgeschlagene Firmware-Upgrades. Dieser wird nach einem fehlgeschlagenen Firmware-Upgrade-Versuch aktiviert wird. Der Wert dieses Parameters dient zur Initialisierung des Timers. Der nächste Firmware-Upgrade-Versuch erfolgt, wenn der Timer bei 0 angelangt ist. Der Standardwert ist 3600 Sekunden. |
Upgrade-Regel |
Ein Skript für das Firmware-Upgrade, das die Upgrade-Bedingungen und zugehörigen Firmware-URLs definiert. Das Skript verwendet die gleiche Syntax wie die Profilregel. Geben Sie die Upgrade-Regel im folgenden Format ein:
Zum Beispiel:
Wenn kein Protokoll angegeben ist, wird TFTP verwendet. Wenn kein Servername angegeben ist, wird der Host, der die URL anfordert, als Servername verwendet. Wenn kein Port angegeben ist, wird der Standardport verwendet (69 für TFTP, 80 für HTTP oder 443 für HTTPS). Der Standardwert ist „Leer“. |
Log Upgrade Request Msg (Protokollmeldung über Upgrade-Anfragen) |
Diese Syslog-Meldung wird zu Beginn eines Firmware-Upgrade-Versuchs ausgegeben. Standard: $PN $MAC -- Anfrage für Upgrade $SCHEME://$SERVIP:$PORT$PATH |
Protokollmeldung über erfolgreiches Firmware-Upgrade |
Diese Syslog-Meldung wird nach erfolgreichem Abschluss eines Firmware-Upgrade-Versuchs ausgegeben. Der Standardwert ist $PN $MAC -- Successful upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERR. |
Log Upgrade Failure Msg (Protokollmeldung über fehlgeschlagenes Firmware-Upgrade) |
Diese Syslog-Meldung wird nach einem fehlgeschlagenen Firmware-Upgrade-Versuch ausgegeben. Der Standardwert ist $PN $MAC -- Upgrade fehlschlagen: $ERR. |
Peer-Firmware-Freigabe |
Aktiviert oder deaktiviert die Peer-Firmware-Freigabefunktion. Wählen Sie Ja oder Nein aus, um die Funktion zu aktivieren bzw. deaktivieren. Standard: Ja |
Peer-Firmware-Freigabe-Log-Server |
Gibt die IP-Adresse und den Port an, an die bzw. den die UDP-Nachricht gesendet wird. Beispiel: 10.98.76.123:514, dabei steht 10.98.76.123 für die IP-Adresse und 514 für die Portnummer. |
In der folgenden Tabelle werden die Funktion und Verwendung der einzelnen Parameter im Abschnitt Allgemeine Parameter der Registerkarte Bereitstellung definiert.
Parametername |
Beschreibung und Standardwert |
---|---|
GPP A – GPP P |
Der Standardwert ist „Leer“. |
Bestimmte Makrovariablen werden in den folgenden Bereitstellungsparametern erkannt:
Profile_Rule
Profile_Rule_*
Resync_Trigger_*
Upgrade_Rule
Log_*
GPP_* (unter bestimmten Bedingungen)
In diesen Parametern werden Syntaxarten wie $NAME oder $(NAME) erkannt und erweitert.
Unterzeichenfolgen von Makrovariablen können mit der Schreibweise $(NAME:p) und $(NAME:p:q) angegeben werden, wobei p und q nicht-negative Ganzzahlen sind (ab Version 2.0.11 verfügbar). Die resultierende Makroerweiterung erfolgt so, dass die Unterzeichenfolge ab Zeichenversatz p beginnt und eine Länge von q aufweist (bzw. bis zum Ende der Zeichenfolge verläuft, wenn q nicht angegeben ist). Wenn GPP_A beispielsweise ABCDEF enthält, wird $(A:2) zu CDEF und $(A:2:3) zu CDE erweitert.
Ein nicht erkannter Name wird nicht übersetzt, und die Form $NAME oder $(NAME) bleibt nach der Erweiterung unverändert im Parameterwert bestehen.
Parametername |
Beschreibung und Standardwert |
||
---|---|---|---|
$ |
$$ wird auf ein einzelnes $-Zeichen erweitert. |
||
A bis P |
Durch den Inhalt der allgemeinen Parameter GPP_A bis GPP_P ersetzt. |
||
SA bis SD |
Durch spezielle Parameter GPP_SA bis GPP_SD ersetzt. Diese Parameter enthalten Schlüssel oder Kennwörter, die in der Bereitstellung verwendet werden.
|
||
MA |
MAC-Adresse mit Hexadezimalzeichen in Kleinbuchstaben, z. B. 000e08aabbcc. |
||
MAU |
MAC-Adresse mit Hexadezimalzeichen in Großbuchstaben, z. B. 000E08AABBCC. |
||
MAC |
MAC-Adresse mit Hexadezimalzeichen in Kleinbuchstaben und Doppelpunkten, um die Hexadezimalzeichenpaare zu trennen. Zum Beispiel: 00:0e:08:aa:bb:cc. |
||
PN |
|||
PSN |
|||
SN |
Zeichenfolge der Seriennummer. Beispiel: 88012BA01234. |
||
CCERT |
SSL-Client-Zertifikatstatus: installiert oder nicht installiert. |
||
IP |
IP-Adresse des Telefons innerhalb des lokalen Subnetzes. Beispiel: 192.168.1.100. |
||
EXTIP |
Externe IP-Adresse des Telefons, wie sie im Internet angezeigt wird. Beispiel: 66.43.16.52. |
||
SWVER |
Zeichenfolge der Software-Version, Beispiel:
|
||
HWVER |
|||
PRVST |
Bereitstellungsstatus (numerische Zeichenfolge): -1 = explizite Anforderung für Resynchronisierung 0 = Resynchronisierung durchführen 1 = regelmäßige Resynchronisierung 2 = Resynchronisierung fehlgeschlagen, Neuversuch |
||
UPGST |
Upgrade-Status (numerische Zeichenfolge): 1 = erster Upgrade-Versuch 2 = Upgrade fehlgeschlagen, Neuversuch |
||
UPGERR |
Ergebnisnachricht (ERR) des vorherigen Upgrade-Versuchs; beispielsweise „http_get failed“. |
||
PRVTMR |
Sekunden seit dem letzten Resynchronisierungsversuch. |
||
UPGTMR |
Sekunden seit dem letzten Upgrade-Versuch. |
||
REGTMR1 |
Sekunden, die vergangen sind, seitdem die Registrierung von Leitung 1 beim SIP-Server verloren ging. |
||
REGTMR2 |
Sekunden, die vergangen sind, seitdem die Registrierung von Leitung 2 beim SIP-Server verloren ging. |
||
UPGCOND |
Name des älteren Makros. |
||
SCHEME |
Dateizugriffsschema (entweder TFTP, HTTP oder HTTPS, ermittelt nach der Analyse der URL für die Resynchronisierung oder das Upgrade). |
||
SERV |
Host-Name des Anforderungszielservers, ermittelt nach der Analyse der URL für die Resynchronisierung oder das Upgrade. |
||
SERVIP |
IP-Adresse des Anforderungszielservers, ermittelt nach der Analyse der URL für die Resynchronisierung oder das Upgrade, möglicherweise nach der DNS-Suche. |
||
Port |
UDP-/TCP-Port des Anforderungsziels, ermittelt nach der Analyse der URL für die Resynchronisierung oder das Upgrade. |
||
PATH |
Dateipfad des Anforderungsziels, ermittelt nach der Analyse der URL für die Resynchronisierung oder das Upgrade. |
||
ERR |
Ergebnisnachricht bei Versuch der Resynchronisierung oder eines Upgrades. Nur bei der Generierung von Ergebnis-syslog-Nachrichten hilfreich. Der Wert wird im Falle von Upgrade-Versuchen in der Variablen UPGERR beibehalten. |
||
UIDn |
Der Wert des Benutzer-ID-Konfigurationsparameters für Leitung n |
Auf dem Telefon werden eine Reihe von internen Fehlercodes (X00–X99) definiert, um die Konfiguration für eine genauere Kontrolle über das Verhalten des Geräts unter bestimmten Fehlerbedingungen zu erleichtern.
Parametername |
Beschreibung und Standardwert |
---|---|
X00 |
Transport Layer- (oder ICMP-)Fehler beim Senden einer SIP-Anforderung. |
X20 |
Zeitüberschreitung der SIP-Anforderung beim Warten auf Antwort. |
X40 |
Allgemeiner SIP-Protokollfehler (z. B. ungültiger Codec in SDP bei 200- und ACK-Nachrichten oder Zeitüberschreitung beim Warten auf ACK). |
X60 |
Gewählte Nummer laut vorliegendem Rufnummernplan ungültig. |