Bereitstellungsparameter

Bereitstellungsparameter – Übersicht

In diesem Kapitel werden die Bereitstellungsparameter erläutert, die in Konfigurationsprofilskripts verwendet werden können.

Konfigurationsprofilparameter

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:

  • Eine Ganzzahl

    Beispiel: Die Eingabe von 3000 gibt an, dass die nächste erneute Synchronisierung in 3000 Sekunden stattfindet.

  • Mehrere Ganzzahlen

    Beispiel: Die Eingabe von 600, 1200, 300 gibt an, dass die erste erneute Synchronisierung in 600 Sekunden stattfindet, die zweite erneute Synchronisierung in 1200 Sekunden nach der ersten und die dritte erneute Synchronisierung in 300 Sekunden nach der zweiten.

  • Zeitraum

    Beispiel: Die Eingabe von 2400 + 30 gibt an, dass die nächste erneute Synchronisierung zwischen 2400 und 2430 Sekunden nach einer erfolgreichen erneuten Synchronisierung erfolgt.

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:

  • Eine Ganzzahl

    Beispiel: Die Eingabe von 300 gibt an, dass die nächste Wiederholung für die erneute Synchronisierung in 300 Sekunden auftritt.

  • Mehrere Ganzzahlen

    Beispiel: Die Eingabe von 600, 1200, 300 gibt an, dass die erste Wiederholung in 600 Sekunden nach dem Fehler stattfindet, die zweite Wiederholung in 1200 Sekunden nach dem Fehler der ersten Wiederholung und die dritte Wiederholung in 300 Sekunden nach dem Fehler der zweiten Wiederholung.

  • Zeitraum

    Beispiel: Die Eingabe von 2400 + 30 gibt an, dass die nächste Wiederholung zwischen 2400 und 2430 Sekunden nach einer fehlerhaften erneuten Synchronisierung stattfindet.

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 Datei nicht gefunden-Antwort vom Server als erfolgreiche Resynchronisierung.

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

Parameter für Firmware-Upgrades

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:

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

Zum Beispiel:

tftp://192.168.1.5/firmware/sip88xx.11-0-0MPP-321.loads
tftp://192.168.1.5/firmware/sip78xx.11-0-1MPP-321.loads
tftp://192.168.1.5/firmware/sip68xx.11-0-1MPP-321.loads

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.

Allgemeine Parameter

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

Die allgemeinen GPP_*-Parameter werden als freie Zeichenfolgen verwendet, die registriert werden, wenn die Telefone für die Interaktion mit einer bestimmten Bereitstellungsserverlösung konfiguriert werden. Die Parameter können mit verschiedenen Werten konfiguriert werden:
  • Verschlüsselungscodes.

  • URLs.

  • Statusinformationen für die mehrstufige Bereitstellung.

  • Vorlagen für POST-Anforderungen

  • Zuordnungen von Parameter-Namensaliasen.

  • Teilweise Zeichenfolgenwerte, die in vollständigen Parameterwerten zusammengefasst werden.

Der Standardwert ist „Leer“.

Makroerweiterungsvariablen

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.

Hinweis

 

$SA bis $SD werden als Argumente für den optionalen URL-Qualifizierer der Resynchronisierung erkannt, --Schlüssel.

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

Produktname. Zum Beispiel: CP-8841-3PCC.

Produktname. Zum Beispiel: CP-7832-3PCC.

Produktname. Zum Beispiel: CP-6841-3PCC.

PSN

Produktseriennummer. Beispiel: V03.

Produktseriennummer. Beispiel: 6841-3PCC.

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:

  • Für Firmware-Version 11.3(1)SR1 und früher: sip68xx.11-0-1MPP-312

  • Für Firmware-Version 11.3(2) und höher: sip68xx.11-3-2MPP0001-609

  • Für Firmware-Version 11.3(1)SR1 und früher: sip78xx.11-0-1MPP-312

  • Für Firmware-Version 11.3(2) und höher: sip78xx.11-3-2MPP0001-609

  • Für Firmware-Version 11.3(1)SR1 und früher: sip88xx.11-0-1MPP-312

  • Für Firmware-Version 11.3(2) und höher: sip88xx.11-3-2MPP0001-609

HWVER

Zeichenfolge der Hardware-Version. Beispiel: 2.0.1.

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

EMS

Extension Mobility-Status

MUID

Extension Mobility-Benutzer-ID

MPWD

Extension Mobility-Kennwort

ORIGTYPE

AUTHSTATUS

Steuert, ob das Telefon eine Lizenz anfordern muss.

Werte für
ORIGTYPE
sind: orig_ent, orig_mpp, none
Werte für
AUTHSTATUS
sind: classic, wxc, none
Fügen Sie die Variablen zur
  • Profilregel oder Aktualisierungsregel-Makroerweiterung und zum bedingten Ausdruck hinzu.

  • Makroerweiterung für Übergangs-Autorisierungsregel

Interne Fehlercodes

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.