Typen von Bereitstellungsparametern

In diesem Abschnitt werden die Bereitstellungsparameter grob nach Funktion sortiert beschrieben.

Allgemeine Parameter

Die allgemeinen Parameter GPP_* (Admin-Anmeldung > erweitert > Sprache > Bereitstellung) werden als freie Zeichenfolgen verwendet, die registriert werden, wenn das Telefon für die Interaktion mit einer bestimmten Bereitstellungsserverlösung konfiguriert wird. Die GPP_*-Parameter sind standardmäßig leer. Sie können so konfiguriert werden, dass sie verschiedene Werte enthalten, einschließlich der folgenden:

  • Verschlüsselungsschlüssel

  • URLs

  • Statusinformationen zur mehrstufigen Bereitstellung.

  • Vorlagen für Post-Anfragen

  • Zuordnungen von Parameternamensaliasen

  • Teilweise Zeichenfolgenwerte, die schließlich zu vollständigen Parameterwerten kombiniert werden.

Die GPP_*-Parameter stehen für eine Makroerweiterung innerhalb anderer Bereitstellungsparameter zur Verfügung. Zu diesem Zweck sind Makronamen mit einem Großbuchstaben (A bis P) ausreichend, um den Inhalt von GPP_A bis GPP_P zu identifizieren. Außerdem identifizieren die Makronamen mit zwei Großbuchstaben SA bis SD GPP_SA bis GPP_SD als Sonderfall, wenn sie als Argumente der folgenden URL-Optionen verwendet werden:

key, uid und pwd

Diese Parameter können als Variablen in Bereitstellungs- und Upgrade-Regeln verwendet werden. Sie werden referenziert, indem dem Variablennamen das Zeichen „$“ vorangestellt wird, z. B. $GPP_A.

Parameter aktivieren

Die Parameter „Provision_Enable“ und „Upgrade_Enable“ steuern alle Profilresynchronisierungs- und Firmware-Upgrade-Vorgänge. Diese Parameter steuern Resynchronisierungen und Upgrades unabhängig voneinander. Diese Parameter steuern auch die Resynchronisierungs- und Upgrade-URL-Befehle, die über den Verwaltungswebserver ausgegeben werden. Beide Parameter sind standardmäßig auf Ja festgelegt.

Der Resync_From_SIP-Parameter steuert Anforderungen für Resynchronisierungsvorgänge. Ein SIP NOTIFY-Ereignis wird vom Proxyserver des Serviceanbieters an das Telefon gesendet. Wenn diese Option aktiviert ist, kann der Proxy eine erneute Synchronisierung anfordern. Dazu sendet der Proxy eine SIP NOTIFY-Nachricht, die das Ereignis enthält: Resynchronisierungskopfzeile mit dem Gerät.

Das Gerät fordert die Anforderung mit einer 401-Antwort an (Autorisierung für verwendete Anmeldeinformationen abgelehnt). Das Gerät erwartet eine authentifizierte nachfolgende Anforderung, bevor es die Resynchronisierungsanforderung vom Proxy akzeptiert. Das Event: reboot_now und Event: restart_now Header führen kalte bzw. warme Neustarts durch, die ebenfalls in Frage gestellt werden.

Die beiden verbleibenden Funktionen sind Resync_On_Reset und Resync_After_Upgrade_Attempt. Diese Parameter bestimmen, ob das Gerät nach dem Neustart der Hochladesoftware und nach jedem Upgrade-Versuch eine Resynchronisierung durchführt.

Wenn das Resync_On_Reset aktiviert ist, führt das Gerät eine zufällige Verzögerung ein, die der Startsequenz folgt, bevor das Zurücksetzen durchgeführt wird. Die Verzögerung ist eine zufällige Zeit bis zu dem Wert, den die Resync_Random_-Verzögerung (in Sekunden) angibt. In einem Pool von Telefonen, die gleichzeitig eingeschaltet werden, werden durch diese Verzögerung die Startzeiten der Resynchronisierungsanforderungen der einzelnen Geräte verteilt. Diese Funktion kann bei einer großen lokalen Bereitstellung nützlich sein, wenn ein Stromausfall auftritt.

Auslöser

Das Telefon ermöglicht Ihnen die Resynchronisierung in bestimmten Intervallen oder zu einem bestimmten Zeitpunkt.

In bestimmten Intervallen resynchronisieren

Das Telefon ist so konzipiert, dass es regelmäßig eine Resynchronisierung mit dem Bereitstellungsserver durchführt. Das Intervall für die Resynchronisierung wird in Resync_Periodisch (Sekunden) konfiguriert. Wenn dieser Wert leer gelassen wird, führt das Gerät keine regelmäßigen Resynchronisierungen durch.

Die erneute Synchronisierung erfolgt normalerweise, wenn die Sprachleitungen inaktiv sind. Wenn eine Sprachleitung aktiv ist, wenn eine Resynchronisierung fällig ist, verzögert das Telefon die Resynchronisierung, bis die Leitung wieder inaktiv ist. Eine Resynchronisierung kann dazu führen, dass sich die Konfigurationsparameterwerte ändern.

Eine Resynchronisierung kann fehlschlagen, weil das Telefon kein Profil vom Server abrufen kann, die heruntergeladene Datei beschädigt ist oder ein interner Fehler aufgetreten ist. Das Gerät versucht, die Resynchronisierung nach einer in „Resync_Error_Retry_-Verzögerung“ angegebenen Zeit (in Sekunden) erneut durchzuführen. Wenn die Resync_Error_Retry_Verzögerung auf 0 festgelegt ist, versucht das Gerät nach einer fehlgeschlagenen Resynchronisierung nicht erneut, eine erneute Synchronisierung durchzuführen.

Wenn ein Upgrade fehlschlägt, wird nach Upgrade_Error_Retry_-Verzögerungssekunden ein erneuter Versuch durchgeführt.

Es sind zwei konfigurierbare Parameter verfügbar, um eine Resynchronisierung bedingt auszulösen: Resync_Trigger_1 und Resync_Trigger_2. Jeder Parameter kann mit einem bedingten Ausdruck programmiert werden, der einer Makroerweiterung unterliegt. Wenn das Intervall für die Resynchronisierung abläuft (Zeit für die nächste Resynchronisierung), verhindern die Auslöser (sofern festgelegt) die Resynchronisierung, es sei denn, mindestens ein Auslöser wird mit „true“ bewertet.

Die folgende Beispielbedingung löst eine Resynchronisierung aus. Im Beispiel ist der letzte Versuch des Telefon-Upgrades mehr als 5 Minuten (300 Sekunden) und mindestens 10 Minuten (600 Sekunden) seit dem letzten Resynchronisierungsversuch vergangen.

$UPGTMR gt 300 und $PRVTMR ge 600

Resynchronisierung zu einem bestimmten Zeitpunkt

Mit dem Resync_At-Parameter kann sich das Telefon zu einem bestimmten Zeitpunkt erneut synchronisieren. Dieser Parameter verwendet das 24-Stunden-Format (hhmm), um die Zeit festzulegen.

Der Parameter „Resync_At_Random_Delay“ ermöglicht es dem Telefon, sich mit einer nicht angegebenen Verzögerung erneut zu synchronisieren. Dieser Parameter verwendet ein positives Ganzzahl-Format, um die Zeit anzugeben.

Das Überfluten des Servers mit Resynchronisierungsanforderungen von mehreren Telefonen, die auf die gleichzeitige Resynchronisierung eingestellt sind, sollte vermieden werden. Dazu löst das Telefon die Resynchronisierung bis zu 10 Minuten nach der angegebenen Zeit aus.

Wenn Sie die Resynchronisierungszeit beispielsweise auf 1000 (10:00 Uhr) festlegen, löst das Telefon die Resynchronisierung jederzeit zwischen 10:00 Uhr und 10:10 Uhr aus.

Standardmäßig ist diese Funktion deaktiviert. Wenn der Parameter Resync_At bereitgestellt wird, wird der Parameter Resync_Periodic ignoriert.

Konfigurierbare Zeitpläne

Mithilfe der folgenden Bereitstellungsparameter können Sie Zeitpläne für regelmäßige Resynchronisierungen konfigurieren und die Wiederholungsintervalle für Resynchronisierungs- und Upgrade-Fehler angeben:

  • Resync_periodisch

  • Resync_Error_Retry_-Verzögerung

  • Upgrade_Error_Retry_-Verzögerung

Jeder Parameter akzeptiert einen einzelnen Verzögerungswert (in Sekunden). Die neue erweiterte Syntax ermöglicht eine durch Komma getrennte Liste von aufeinanderfolgenden Verzögerungselementen. Das letzte Element der Sequenz wird implizit für immer wiederholt.

Optional können Sie ein Pluszeichen verwenden, um einen anderen numerischen Wert anzugeben, der eine zusätzliche zufällige Verzögerung festlegt.

Beispiel 1

In diesem Beispiel erfolgt die Resynchronisierung des Telefons in regelmäßigen Abständen alle 2 Stunden. Wenn ein Resynchronisierungsfehler auftritt, wiederholt das Gerät Versuche in den folgenden Intervallen: 30 Minuten, 1 Stunde, 2 Stunden, 4 Stunden. Das Gerät führt weitere Versuche in 4-Stunden-Intervallen durch, bis die Resynchronisierung erfolgreich ist.

 Resync_Periodisch=7200 Resync_Error_Retry_Verzögerung=1800,3600,7200,14400 

Beispiel 2

In diesem Beispiel erfolgt die Resynchronisierung des Geräts in regelmäßigen Abständen jede Stunde (plus eine zusätzliche zufällige Verzögerung von bis zu 10 Minuten). Bei einem Resynchronisierungsfehler werden die Versuche des Geräts in den folgenden Intervallen wiederholt: 30 Minuten (plus bis zu 5 Minuten). 1 Stunde (plus bis zu 10 Minuten), 2 Stunden (plus bis zu 15 Minuten). Das Gerät versucht es weiterhin in 2-Stunden-Intervallen (plus bis zu 15 Minuten), bis die Resynchronisierung erfolgreich ist.

 Resync_Periodisch=3600+600 Resync_Error_Retry_Verzögerung=1800+300,3600+600,7200+900 

Beispiel 3

Wenn in diesem Beispiel ein Remote-Upgrade-Versuch fehlschlägt, versucht das Gerät das Upgrade nach 30 Minuten, dann erneut nach einer weiteren Stunde und dann nach zwei Stunden. Wenn das Upgrade weiterhin fehlschlägt, versucht das Gerät alle vier bis fünf Stunden erneut, bis das Upgrade erfolgreich war.

 Upgrade_Error_Retry_Verzögerung  =  1800,3600,7200,14400+3600 

Profilregeln

Das Telefon stellt mehrere Remote-Konfigurationsprofilparameter bereit (Profile_Rule*). Somit kann jeder Resynchronisierungsvorgang mehrere Dateien abrufen, die von verschiedenen Servern verwaltet werden.

Im einfachsten Szenario erfolgt die Resynchronisierung des Geräts in regelmäßigen Abständen mit einem einzelnen Profil auf einem zentralen Server, der alle relevanten internen Parameter aktualisiert. Alternativ kann das Profil auf verschiedene Dateien aufgeteilt werden. Eine Datei gilt für alle Telefone in einer Bereitstellung. Für jedes Konto wird eine separate, eindeutige Datei bereitgestellt. Verschlüsselungsschlüssel und Zertifikatinformationen können von einem weiteren Profil bereitgestellt werden, das auf einem separaten Server gespeichert ist.

Wenn eine Resynchronisierung fällig ist, wertet das Telefon die vier Profile_Rule*-Parameter nacheinander aus:

  1. Profile_Regel

  2. rofile_Rule_B

  3. rofile_Rule_Ü

  4. rofile_Rule_D

Jede Auswertung kann dazu führen, dass ein Profil von einem Remote-Bereitstellungsserver abgerufen wird und einige interne Parameter möglicherweise aktualisiert werden. Wenn eine Auswertung fehlschlägt, wird die Resynchronisierungssequenz unterbrochen und von dem im Parameter Resync_Error_Retry_Delay (Sekunden) angegebenen Beginn erneut versucht. Wenn alle Auswertungen erfolgreich sind, wartet das Gerät auf die im Parameter Resync_Periodic angegebene Sekunde und führt dann eine weitere Resynchronisierung durch.

Der Inhalt jedes Profile_Rule*-Parameters besteht aus einer Reihe von Alternativen. Die Alternativen werden durch das Zeichen | (pipe) getrennt. Jede Alternative besteht aus einem Bedingungsausdruck, einem Zuweisungsausdruck, einer Profil-URL und allen zugehörigen URL-Optionen. Alle diese Komponenten sind in jeder Alternative optional. Im Folgenden sind die gültigen Kombinationen und die Reihenfolge aufgeführt, in der sie, falls vorhanden, angezeigt werden müssen:

 [ conditional-expr ] [ assignment-expr ] [[ options ] URL ] 

Innerhalb jedes Profile_Rule*-Parameters müssen alle Alternativen mit Ausnahme der letzten einen Bedingungsausdruck bereitstellen. Dieser Ausdruck wird ausgewertet und wie folgt verarbeitet:

  1. Bedingungen werden von links nach rechts ausgewertet, bis eine gefunden wird, die als wahr ausgewertet wird (oder bis eine Alternative ohne Bedingungsausdruck gefunden wird).

  2. Alle zugehörigen Zuweisungsausdrücke werden, sofern vorhanden, ausgewertet.

  3. Wenn eine URL als Teil dieser Alternative angegeben wird, wird versucht, das Profil herunterzuladen, das sich unter der angegebenen URL befindet. Das System versucht, die internen Parameter entsprechend zu aktualisieren.

Wenn alle Alternativen über Bedingungsausdrücke verfügen und keine Auswertung „true“ ergibt (oder wenn die gesamte Profilregel leer ist), wird der gesamte Profile_Rule*-Parameter übersprungen. Der nächste Profilregelparameter in der Sequenz wird ausgewertet.

Beispiel 1

Dieses Beispiel führt eine bedingungslose Resynchronisierung mit dem Profil unter der angegebenen URL durch und führt eine HTTP GET-Anforderung an den Remote-Bereitstellungsserver durch:


http://remote.server.com/cisco/$MA.cfg

Beispiel 2

In diesem Beispiel erfolgt die Resynchronisierung des Geräts mit zwei verschiedenen URLs, je nach Registrierungsstatus von Leitung 1. Bei verlorener Registrierung führt das Gerät einen HTTP POST für ein CGI-Skript durch. Das Gerät sendet den Inhalt des makroerweiterten GPP_A, der zusätzliche Informationen zum Gerätestatus enthalten kann:

 ($PRVTMR ge 600)? http://p.tel.com/has-reg.cfg | [--posten a] http://p.tel.com/lost-reg? 

Beispiel 3

In diesem Beispiel erfolgt die Resynchronisierung des Geräts mit demselben Server. Das Gerät stellt zusätzliche Informationen bereit, wenn kein Zertifikat auf der Einheit installiert ist (für ältere Einheiten vor 2.0):

 („$CCERT“ eq „installiert“)? https://p.tel.com/config? | https://p.tel.com/config?cisco$MAU 

Beispiel 4

In diesem Beispiel ist Leitung 1 deaktiviert, bis GPP_A über die erste URL auf den Wert „Provisioned“ gesetzt wird. Anschließend erfolgt die Resynchronisierung mit der zweiten URL:

 („$A“ oder „Bereitgestellt“)? (Line_Enable_1_ = „Nein“;)! https://p.tel.com/init-prov | https://p.tel.com/configs 

Beispiel 5

In diesem Beispiel wird angenommen, dass das Profil, das der Server zurückgibt, XML-Element-Tags enthält. Diese Tags müssen mithilfe der in GPP_B gespeicherten Aliase-Zuordnung wieder den entsprechenden Parameternamen zugeordnet werden:

 [--alias b] https://p.tel.com/account/$PN$MA.xml 

Eine Resynchronisierung gilt normalerweise als nicht erfolgreich, wenn ein angefordertes Profil vom Server nicht empfangen wird. Der Parameter Resync_Fails_On_FNF kann dieses Standardverhalten überschreiben. Wenn Resync_Fails_On_FNF auf „Nein“ festgelegt ist, akzeptiert das Gerät eine „Datei nicht gefunden“-Antwort vom Server als erfolgreiche Resynchronisierung. Der Standardwert für Resync_Fails_On_FNF ist „Yes“ (Ja).

Upgrade-Regel

Mit der Upgrade-Regel wird das Gerät angewiesen, eine neue Software zu aktivieren und ggf. von wo aus die Software abgerufen werden kann. Wenn sich die Software bereits auf dem Gerät befindet, wird nicht versucht, die Software abzurufen. Die Gültigkeit des Software-Standorts spielt also keine Rolle, wenn sich die gewünschte Software in der inaktiven Partition befindet.

Die Upgrade_Regel gibt eine Firmware-Version an, die, wenn sie sich von der aktuellen Version unterscheidet, heruntergeladen und angewendet wird, sofern sie nicht durch einen Bedingungsausdruck eingeschränkt ist oder Upgrade_Aktivieren auf Nein gesetzt ist.

Das Telefon stellt einen konfigurierbaren Remote-Upgrade-Parameter bereit: Upgrade_Rule. Dieser Parameter akzeptiert eine ähnliche Syntax wie die Profilregelparameter. URL-Optionen werden für Upgrades nicht unterstützt, aber Bedingungsausdrücke und Zuweisungsausdrücke können verwendet werden. Wenn Bedingungsausdrücke verwendet werden, können für den Parameter mehrere durch das | Zeichen getrennte Alternativen angegeben werden. Die Syntax für jede Alternative lautet wie folgt:

 [ conditional-expr ] [ assignment-expr ] URL 

Wie bei den Profile_Rule*-Parametern wertet der Upgrade_Rule-Parameter jede Alternative aus, bis ein Bedingungsausdruck erfüllt ist oder eine Alternative keinen Bedingungsausdruck aufweist. Der zugehörige Zuweisungsausdruck wird ausgewertet, falls angegeben. Anschließend wird versucht, ein Upgrade auf die angegebene URL durchzuführen.

Wenn die Upgrade_Regel eine URL ohne Bedingungsausdruck enthält, wird das Gerät auf das in der URL angegebene Firmware-Image aktualisiert. Nach der Makroerweiterung und Auswertung der Regel versucht das Gerät erst dann erneut, ein Upgrade durchzuführen, wenn die Regel oder die effektive Kombination aus scheme + server + port + filepath geändert wurde.

Um zu versuchen, ein Firmware-Upgrade durchzuführen, deaktiviert das Gerät die Audiofunktion zu Beginn des Vorgangs und wird am Ende des Vorgangs neu gestartet. Das Gerät startet nur dann automatisch ein Upgrade, das durch den Inhalt von Upgrade_Rule gesteuert wird, wenn alle Sprachleitungen derzeit inaktiv sind.

Beispiel:


https://10.73.10.223/firmware/PHONEOS-8875.1-0-1-0001-1.loads

In diesem Beispiel aktualisiert die Upgrade_Regel die Firmware auf das Image, das unter der angegebenen URL gespeichert ist.

Ein weiteres Beispiel:

 („$F“ oder „Beta-Kunde“)? 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 diesem Beispiel wird das Gerät angewiesen, basierend auf dem Inhalt des allgemeinen Parameters GPP_F eines von zwei Bildern zu laden.

Bereitstellungsparameter

Die Bereitstellungsparameter finden Sie auf der Registerkarte Bereitstellung auf der Telefon-Webseite.

Konfigurationsprofilparameter

In der folgenden Tabelle werden die Funktionen und die Verwendung der einzelnen Parameter im Abschnitt Konfigurationsprofilparameter auf der Registerkarte Bereitstellung definiert.

Tabelle 1. Konfigurationsprofilparameter

Parametername

Beschreibung und Standardwert

Bereitstellung aktivieren

Steuert alle Resynchronisierungsaktionen unabhängig von Firmware-Upgrade-Aktionen. Legen Sie Ja fest, um die Remotebereitstellung zu aktivieren.

Der Standardwert ist „Ja“.

Erneute Synchronisierung Beim Zurücksetzen

Nach jedem Neustart wird eine Resynchronisierung ausgelöst, mit Ausnahme von Neustarts, die durch Parameteraktualisierungen und Firmware-Upgrades verursacht werden.

Der Standardwert ist „Ja“.

Zufällige Verzögerung bei der Resynchronisierung

Eine zufällige Verzögerung nach der Startsequenz vor dem Zurücksetzen, die in Sekunden angegeben ist. In einem Pool von IP-Telefoniegeräten, die planmäßig gleichzeitig eingeschaltet 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 Zeit (HHmm), in der sich das Gerät mit dem Bereitstellungsserver neu synchronisiert.

Der Wert für dieses Feld muss eine vierstellige Zahl im Bereich von 0000 bis 2400 sein, um die Zeit 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. Wenn dieser Parameter auf einen gültigen Wert festgelegt ist, wird der Parameter „Periodische Neusynchronisierung“ ignoriert.

Erneute Synchronisierung mit zufälliger Verzögerung

Verhindert eine Überlastung des Bereitstellungsservers, wenn eine große Anzahl von Geräten gleichzeitig eingeschaltet wird.

Um zu vermeiden, dass Resynchronisierungsanforderungen von mehreren Telefonen an den Server überflutet werden, führt das Telefon die Resynchronisierung im Bereich zwischen den Stunden und Minuten sowie den Stunden und Minuten plus der zufälligen Verzögerung durch (hhmm, hhmm+random_delay). Beispiel: Wenn die zufällige Verzögerung = (Erneute Synchronisierung bei zufälliger Verzögerung + 30)/60 Minuten ist, wird der Eingabewert in Sekunden in Minuten umgewandelt und auf die nächste Minute aufgerundet, um das endgültige random_delay Intervall zu berechnen.

Der gültige Wert liegt zwischen 600 und 65535.

Wenn der Wert kleiner als 600 ist, liegt die zufällige interne Verzögerung zwischen 0 und 600.

Der Standardwert ist 600 Sekunden (10 Minuten).

Periodische Resynchronisierung

Das Zeitintervall zwischen regelmäßigen Resynchronisierungen mit dem Bereitstellungsserver. Der zugehörige Timer für die Resynchronisierung ist erst nach der ersten erfolgreichen Synchronisierung mit dem Server aktiv.

Die gültigen Formate sind wie folgt:

  • Eine Ganzzahl

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

  • Mehrere ganze Zahlen

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

  • Ein 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 stattfindet.

Legen Sie diesen Parameter auf Null fest, um die periodische Resynchronisierung zu deaktivieren.

Der Standardwert ist 3600 Sekunden.

Wiederholungsverzögerung für Resynchronisierungsfehler

Wenn eine erneute Synchronisierung 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, die erneute Synchronisierung nach der in Sekunden festgelegten Zeitdauer durchzuführen.

Die gültigen Formate sind wie folgt:

  • Eine Ganzzahl

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

  • Mehrere ganze Zahlen

    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.

  • Ein Zeitraum

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

Wenn die Verzögerung auf 0 festgelegt ist, versucht das Gerät nicht, sich nach einem fehlgeschlagenen Resynchronisierungsversuch erneut zu synchronisieren.

Erzwungene Resynchronisierungsverzögerung

Maximale Verzögerung (in Sekunden), die das Telefon wartet, bevor eine erneute Synchronisierung durchgeführt wird.

Das Gerät führt keine Resynchronisierung durch, während 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. Auf diese Weise können Benutzer Anrufe nacheinander tätigen, ohne unterbrochen zu werden.

Das Gerät verfügt über einen Timer, der rückwärts läuft, wenn alle Leitungen inaktiv sind. Dieser Parameter ist der Anfangswert des Zählers. Resynchronisierungsereignisse werden verzögert, bis dieser Zähler auf Null reduziert wird.

Der gültige Wert liegt zwischen 0 und 65535.

Der Standardwert ist 14.400  Sekunden.

Erneute Synchronisierung von SIP

Ermöglicht, dass eine Resynchronisierung über eine SIP NOTIFY-Nachricht ausgelöst wird.

Der Standardwert ist „Ja“.

Erneute Synchronisierung nach dem Upgrade-Versuch

Aktiviert oder deaktiviert den Resynchronisierungsvorgang nach einem Upgrade. Wenn „Ja“ ausgewählt ist, wird die Synchronisierung ausgelöst.

Der Standardwert ist „Ja“.

Resynchronisierungsauslöser 1, Resynchronisierungsauslöser 2

Konfigurierbare Bedingungen für den Resynchronisierungsauslöser. Eine Resynchronisierung wird ausgelöst, wenn die logische Gleichung in diesen Parametern TRUE ergibt.

Der Standardwert ist (leer).

Resynchronisierung schlägt bei FNF fehl

Eine Resynchronisierung gilt als nicht erfolgreich, wenn ein angefordertes Profil vom Server nicht empfangen wird. Dies kann durch diesen Parameter überschrieben werden. Wenn die Einstellung auf Nein festgelegt ist, akzeptiert das Gerät die Antwort file-not-found vom Server als erfolgreiche Resynchronisierung.

Der Standardwert ist „Ja“.

Profilregel

Profilregel B


Profilregel C


Profilregel D

Jede Profilregel informiert das Telefon über eine Quelle, von der aus ein Profil (Konfigurationsdatei) abgerufen werden kann. Bei jeder erneuten Synchronisierung 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üsselungsschlüssel mit dem Schlüsselwort --key wie folgt an:

[--Schlüssel ]

Sie können den Verschlüsselungscode optional in Anführungszeichen (") einschließen.

Zu verwendende DHCP-Option

Durch Komma getrennte DHCP-Optionen, die zum Abrufen von Firmware und Profilen verwendet werden.

Der Standardwert ist 66,160,159,150,60,43,125.

Protokollmeldung über Anforderung

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 Aufzeichnungen

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 Protokolle

Die Syslog-Meldung, die nach einem fehlgeschlagenen Resynchronisierungsversuch ausgegeben wird.

Der Standardwert ist $PN $MAC -- Resynchronisierung fehlgeschlagen: $ERR.

Vom Benutzer konfigurierbare Resynchronisierung

Ermöglicht einem Benutzer, das Telefon über den IP-Telefonbildschirm erneut zu synchronisieren.

Der Standardwert ist „Ja“.

Firmware-Upgrade-Parameter

In der folgenden Tabelle werden die Funktionen und die Verwendung der einzelnen Parameter im Abschnitt Firmware-Upgrade der Registerkarte Bereitstellung definiert.

Tabelle 2: Firmware-Upgrade-Parameter

Parametername

Beschreibung und Standardwert

Upgrade aktivieren

Aktiviert Firmware-Upgrade-Vorgänge unabhängig von Resynchronisierungsaktionen.

Der Standardwert ist „Ja“.

Konfigurieren Sie diesen Parameter mit einer der folgenden Methoden:

  • Geben Sie in der Telefonkonfigurationsdatei mit XML(cfg.xml) eine Zeichenfolge in folgendem Format ein: <Upgrade_Enable ua="na">JaEnable>pgrade_

  • Legen Sie auf der Webseite der Telefonverwaltung dieses Feld auf „Ja“ oder „Nein“ fest.

Wiederholungsverzögerung für Upgrade-Fehler

Das Upgrade-Wiederholungsintervall (in Sekunden), das bei einem fehlgeschlagenen Upgrade angewendet wird. Das Gerät verfügt über einen Timer für Fehler beim Firmware-Upgrade, der nach einem fehlgeschlagenen Firmware-Upgrade-Versuch aktiviert wird. Der Timer wird mit dem Wert in diesem Parameter initialisiert. Der nächste Firmware-Update wird durchgeführt, wenn dieser Timer auf Null fällt.

Der Standardwert ist 3600 Sekunden.

Konfigurieren Sie diesen Parameter mit einer der folgenden Methoden:

  • Geben Sie in der Telefonkonfigurationsdatei mit XML(cfg.xml) eine Zeichenfolge in folgendem Format ein: <Upgrade_Error_Retry_Delay ua="na">3600Error_Retry_Delay>pgrade_

  • Legen Sie auf der Webseite der Telefonverwaltung den Wert fest.

Upgrade-Regel

Ein Skript für das Firmware-Upgrade, das die Upgrade-Bedingungen und die zugehörigen Firmware-URLs definiert. Sie verwendet dieselbe Syntax wie die Profilregel.

Geben Sie die Upgrade-Regel im folgenden Format ein:

<tftp|http|https>:////

Beispiel:

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

Wenn kein Protokoll angegeben ist, wird TFTP angenommen. Wenn kein Servername angegeben wird, 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.

Konfigurieren Sie diesen Parameter mit einer der folgenden Methoden:

  • Geben Sie in der Telefonkonfigurationsdatei mit XML(cfg.xml) eine Zeichenfolge in folgendem Format ein: <Upgrade_Rule ua="na">http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads</Upgrade_Rule>

  • Geben Sie auf der Webseite zur Telefonverwaltung den Pfad ein, unter dem die Lastdatei gespeichert wird.

Protokollmeldung über Upgrade-Anfrage

Syslog Nachricht wurde am Beginn eines Firmware Upgradungsversuchs veröffentlicht.

Standard: $PN $MAC -- Anfrage für Upgrade $SCHEME://$SERVIP:$PORT$PATH

Konfigurieren Sie diesen Parameter mit einer der folgenden Methoden:

  • Geben Sie in der Telefonkonfigurationsdatei mit XML(cfg.xml) eine Zeichenfolge in folgendem Format ein: <Log_Upgrade_Request_Msg ua="na">$PN $MAC -- Anfordern des Upgrades $SCHEME://$SERVIP:$PORT$PATHUpgrade_Request_Msg>og_

  • Passen Sie auf der Webseite der Telefonverwaltung den Parameter nach Bedarf an.

Protokollmeldung über erfolgreiche Aktualisierung

Die nach Abschluss eines Firmware-Update ausgegebene syslog Nachricht wird erfolgreich abgeschlossen.

Der Standardwert ist $PN $MAC -- Erfolgreiches Upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERR

Konfigurieren Sie diesen Parameter mit einer der folgenden Methoden:

  • Geben Sie in der Telefonkonfigurationsdatei mit XML(cfg.xml) eine Zeichenfolge in folgendem Format ein: <Log_Upgrade_Success_Msg ua="na">$PN $MAC -- Erfolgreiches Upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERRUpgrade_Success_Msg>og_

  • Passen Sie auf der Webseite der Telefonverwaltung den Parameter nach Bedarf an.

Protokollmeldung über fehlgeschlagene Aktualisierung

Syslog Nachricht wird nach einem fehlgeschlagenen Firmware-Update veröffentlicht.

Der Standardwert ist $PN $MAC -- Upgrade fehlgeschlagen: $ERR

Konfigurieren Sie diesen Parameter mit einer der folgenden Methoden:

  • Geben Sie in der Telefonkonfigurationsdatei mit XML(cfg.xml) eine Zeichenfolge in folgendem Format ein: <Log_Upgrade_Failure_Msg ua="na">$PN $MAC -- Upgrade fehlgeschlagen: $ERRUpgrade_Failure_Msg>og_

  • Passen Sie auf der Webseite der Telefonverwaltung den Parameter nach Bedarf an.

Peer-Firmware-Freigabe

Aktiviert oder deaktiviert die PFS-Funktion (Peer Firmware Sharing). Wählen Sie Ja oder Nein aus, um die Funktion zu aktivieren bzw. zu deaktivieren.

Standard: Ja

Konfigurieren Sie diesen Parameter mit einer der folgenden Methoden:

  • Geben Sie in der Telefonkonfigurationsdatei mit XML(cfg.xml) eine Zeichenfolge in folgendem Format ein: <Peer_Firmware_Sharing ua="na">JaFirmware_Sharing>eer_

  • Legen Sie auf der Webseite der Telefonverwaltung dieses Feld auf „Ja“ oder „Nein“ fest.

Peer-Firmware-Freigabe-Protokollserver

Gibt die IP-Adresse und den Port an, an den die UDP-Nachricht gesendet wird.

Beispiel: 10.98.76.123:514, wobei 10.98.76.123 die IP-Adresse und 514 die Portnummer ist.

Konfigurieren Sie diesen Parameter mit einer der folgenden Methoden:

  • Geben Sie in der Telefonkonfigurationsdatei mit XML(cfg.xml) eine Zeichenfolge in folgendem Format ein: <Peer_Firmware_Sharing_Log_Server ua="na">10.98.76.123:514Firmware_Sharing_Log_Server>eer_

  • Geben Sie auf der Webseite zur Telefonverwaltung die Adresse des Protokollservers ein.

Allgemeine Parameter

In der folgenden Tabelle werden die Funktionen und die Verwendung der einzelnen Parameter im Abschnitt Allgemeine Parameter der Registerkarte Bereitstellung definiert.

Tabelle 3: Allgemeine Parameter

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. Sie können so konfiguriert werden, dass sie verschiedene Werte enthalten, einschließlich der folgenden:

  • Verschlüsselungscodes.

  • URLs.

  • Statusinformationen zur mehrstufigen Bereitstellung.

  • Vorlagen für Post-Anfragen.

  • Zuordnungen von Parameternamensaliasen.

  • Teilweise Zeichenfolgenwerte, die schließlich zu vollständigen Parameterwerten kombiniert werden.

Der Standardwert ist leer.

Makroerweiterungsvariablen

Bestimmte Makrovariablen werden in den folgenden Bereitstellungsparametern erkannt:

  • Profile_Regel

  • rofile_Rule_*

  • Resync_Trigger_*

  • Upgrade_Regel

  • Log_*

  • GPP_* (unter bestimmten Bedingungen)

Innerhalb dieser Parameter werden Syntaxtypen 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 beginnt bei der Zeichenverschiebung p mit der Länge q (oder bis zum Ende der Zeichenfolge, 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.

Parametername

Beschreibung und Standardwert

$

Das Formular $$ wird auf ein einzelnes $ Zeichen erweitert.

A bis P

Ersetzt durch den Inhalt der allgemeinen Parameter GPP_A bis GPP_P.

SA bis SD

Ersetzt durch spezielle Parameter GPP_SA bis GPP_SD. Diese Parameter enthalten Schlüssel oder Kennwörter, die in der Bereitstellung verwendet werden.

$SA bis $SD werden als Argumente für den optionalen URL-Qualifizierer für die 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. Beispiel: 00:0e:08:aa:bb:cc.

PN

Produktname. Beispiel: CP-8875-CC-C-9K.

PSN

Produktseriennummer. Beispiel: V03.

SN

Zeichenfolge der Seriennummer. beispielsweise 88012BA01234.

CCERT

Status des SSL-Clientzertifikats: 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 im Internet dargestellt. Beispiel: 66.43.16.52.

schwingen

Zeichenfolge der Softwareversion. Beispiel:

Telefon-8875.1-0-1-0001-1

hwver

Zeichenfolge der Hardware-Version. Beispiel: 2.0.1

prvst

Bereitstellungsstatus (numerische Zeichenfolge):

-1 = explizite Anfrage zur erneuten Synchronisierung

0 = Resynchronisierung einschalten

1 = regelmäßige Neusynchronisierung

2 = Resynchronisierung fehlgeschlagen, Wiederholungsversuch

upgst

Upgrade-Status (numerische Zeichenfolge):

1 = erster Upgrade-Versuch

2 = Upgrade fehlgeschlagen, Wiederholungsversuch

aktualisieren

Ergebnismeldung (ERR) des vorherigen Upgrade-Versuchs; beispielsweise http_get fehlgeschlagen.

prvtmr

Sekunden seit dem letzten Resynchronisierungsversuch.

UPGTMR

Sekunden seit dem letzten Upgrade-Versuch.

REGTMR1

Sekunden, die vergangen sind, seit die Registrierung von Leitung 1 beim SIP-Server verloren ging.

REGTMR2

Sekunden, die vergangen sind, seit die Registrierung von Leitung 2 beim SIP-Server verloren ging.

upgcond

Name des älteren Makros.

Schema

Dateizugriffsschema (TFTP, HTTP oder HTTPS), ermittelt nach der Analyse der URL für die Resynchronisierung oder das Upgrade.

Serv

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

Pfad

Dateipfad des Anforderungsziels, ermittelt nach der Analyse der URL für die Resynchronisierung oder das Upgrade.

Fehler

Ergebnismeldung des Resynchronisierungs- oder Upgrade-Versuchs. Nur nützlich beim Generieren von Ergebnis-Syslog-Meldungen. Der Wert wird bei Upgrade-Versuchen in der UPGERR-Variablen beibehalten.

UID

Der Inhalt des Benutzer-ID-Konfigurationsparameters für Leitung n.

Ems

Extension-Mobility-Status

MUID

Extension Mobility-Benutzer-ID

mpwd

Extension Mobility-Passwort

Interne Fehlercodes

Das Telefon definiert eine Reihe interner Fehlercodes (X00–X99), um die Konfiguration zu erleichtern, um unter bestimmten Fehlerbedingungen eine genauere Kontrolle über das Verhalten des Geräts zu ermöglichen.

Tabelle 4: Interne Fehlercodes

Parametername

Beschreibung und Standardwert

X00

Transport Layer- (oder ICMP-)Fehler beim Senden einer SIP-Anforderung.

X20

Zeitüberschreitung bei der SIP-Anforderung, während auf eine Antwort gewartet wird.

X40

Allgemeiner SIP-Protokollfehler (z. B. inakzeptabler Codec in SDP in 200- und ACK-Nachrichten oder Zeitüberschreitung beim Warten auf ACK).

X60

Gewählte Nummer gemäß gegebenem Wählplan ungültig.