Parametertypen für die Bereitstellung

In diesem Abschnitt werden die Bereitstellungsparameter grob nach Funktion sortiert erläutert.

Allgemeine Parameter

Die allgemeinen GPP_*-Parameter (Administratoranmeldung > 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. 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.

Die GPP_*-Parameter stehen für eine Makroerweiterung in anderen Bereitstellungsparametern zur Verfügung. Daher sind Makronamen mit einem Großbuchstaben (A bis P) ausreichend, um den Inhalt der Parameter GPP_A bis GPP_P zu ermitteln. Außerdem werden mit den Makronamen mit zwei Großbuchstaben SA bis SD die Parameter GPP_SA bis GPP_SD als Sonderfall identifiziert, wenn sie als Argumente der folgenden URL Optionen verwendet werden:

key, uid und pwd

Sie können diese Parameter als Variablen in Bereitstellungs- und Upgrade-Regeln verwenden. Zur Referenzierung wird dem Variablennamen das Zeichen „$“ vorangestellt, z. B. $GPP_A.

Parameter aktivieren

Die Parameter Provision_Enable und Upgrade_Enable steuern alle Profilresynchronisierungs- und Firmware-Upgrade-Vorgänge. Resynchronisierungen und Upgrades werden unabhängig voneinander gesteuert. Außerdem werden mit diesen Parametern Resynchronisierungs- und Upgrade-URL-Befehle gesteuert, die über den Verwaltungswebserver erteilt werden. Diese beiden Parameter sind standardmäßig auf Ja festgelegt.

Der Parameter Resync_From_SIP steuert Anforderungen für Resynchronisierungsvorgänge. Ein SIP NOTIFY-Ereignis wird vom Serviceanbieter-Proxyserver an das Telefon gesendet. Wenn aktiviert, kann der Proxy eine Resynchronisierung anfordern. Hierzu sendet der Proxy eine SIP NOTIFY-Nachricht an das Gerät, die das Ereignis zum Resynchronisieren enthält.

Das Gerät gibt auf die Anforderung eine 401-Antwort (Autorisierung für verwendete Anmeldeinformationen abgelehnt) zurück. Das Gerät erwartet eine authentifizierte nachfolgende Anforderung, bevor es die Resynchronisierungsanforderung des Proxy akzeptiert. Mit den Headern Event: reboot_now und Event: restart_now werden kalte bzw. warme Neustarts durchgeführt, die ebenfalls geprüft werden.

Die beiden verbleibenden Enable-Parameter lauten Resync_On_Reset und Resync_After_Upgrade_Attempt. Diese Parameter bestimmen, ob das Gerät nach dem Neustart der Software und nach jedem Upgrade-Versuch einen Resynchronisierungsvorgang ausführt.

Wenn Resync_On_Reset aktiviert ist, führt das Gerät nach dem Startvorgang eine zufällige Verzögerung ein, bevor es zurückgesetzt wird. Die Verzögerung ist eine zufällige Zeitangabe bis zu dem Wert, der für Resync_Random_Delay (in Sekunden) angegeben ist. In einem Pool von Telefonen, die gleichzeitig eingeschaltet werden, werden durch diese Verzögerung die Startzeiten der Resynchronisierungsanforderungen der einzelnen Geräte besser verteilt. Diese Funktion kann bei einer großen lokalen Bereitstellung nützlich sein, wenn ein Stromausfall auftritt.

Kaufanreize

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

In bestimmten Zeitintervallen resynchronisieren

Das Telefon ist darauf ausgelegt, regelmäßig eine Resynchronisierung mit dem Bereitstellungsserver durchzuführen. Das Intervall für die Resynchronisierung wird im Parameter Resync_Periodic (in Sekunden) konfiguriert. Wenn dieser Wert leer ist, führt das Gerät keine regelmäßigen Resynchronisierungen aus.

Eine erneute Synchronisierung wird normalerweise ausgeführt, wenn die Sprachleitungen inaktiv sind. Wenn eine Sprachleitung aktiv und eine Resynchronisierung fällig ist, verzögert das Telefon die Resynchronisierung, bis die Leitung wieder inaktiv ist. Eine Resynchronisierung kann eine Änderung der Konfigurationsparameter verursachen.

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 Zeitspanne, die in Resync_Error_Retry_Delay (in Sekunden) angegeben ist, zu wiederholen. Wenn Resync_Error_Retry_Delay auf 0 festgelegt ist, führt das Gerät keine neue Resynchronisierung aus, nachdem eine Resynchronisierung fehlgeschlagen ist.

Wenn ein Upgrade fehlschlägt, wird nach den in Upgrade_Error_Retry_Delay angegebenen Sekunden ein erneuter Versuch ausgeführt.

Es stehen zwei konfigurierbare Parameter für die bedingte Auslösung einer Resynchronisierung zur Verfügung: Resync_Trigger_1 und Resync_Trigger_2. Jeder Parameter kann mit einem Bedingungsausdruck programmiert werden, der eine Makroerweiterung durchläuft. Wenn das Intervall für die Resynchronisierung abläuft (Zeit für die nächste Resynchronisierung), verhindern die Auslöser, sofern sie festgelegt sind, die Resynchronisierung, es sei denn, mindestens ein Auslöser wird mit „True“ bewertet.

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

$UPGTMR gt 300 und $PRVTMR ge 600

Zu einem bestimmten Zeitpunkt resynchronisieren

Der Parameter Resync_At ermöglicht es dem Telefon, zu einem bestimmten Zeitpunkt eine Resynchronisierung durchzuführen. Dieser Parameter verwendet das 24-Stunden-Format (hhmm), um die Zeit festzulegen.

Der Parameter Resync_At_Random_Delay ermöglicht es dem Telefon, mit einer nicht spezifizierten Verzögerung zu resynchronisieren. Dieser Parameter verwendet ein positives Ganzzahl-Format, um die Zeit festzulegen.

Es sollte vermieden werden, den Server mit Resynchronisierungsanforderungen von mehreren Telefonen zu belasten, deren Resynchronisierung auf dieselbe Zeit festgelegt ist. Aus diesem Grund löst das Telefon die Resynchronisierung bis zu 10 Minuten nach dem angegebenen Zeitpunkt aus.

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

Diese Funktion ist standardmäßig deaktiviert. Wenn der Parameter Resync_At bereitgestellt wurde, 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_Periodic

  • Resync_Error_Retry_Delay

  • Upgrade_Error_Retry_Delay

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 in der Sequenz wird implizit unendlich 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 zwei Stunden. Wenn ein Resynchronisierungsfehler auftritt, erfolgen auf dem Gerät Wiederholungsversuche 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_Periodic=7200 Resync_Error_Retry_Delay=1800,3600,7200,14400

Beispiel 2

In diesem Beispiel erfolgt die Resynchronisierung des Geräts in regelmäßigen Abständen jede Stunde (mit einer zusätzlichen zufälligen Verzögerung von bis zu 10 Minuten). Bei einem Resynchronisierungsfehler erfolgen auf dem Gerät Wiederholungsversuche in den folgenden Intervallen: 30 Minuten (plus bis zu 5 Minuten). 1 Stunde (plus bis zu 10 Minuten), 2 Stunden (plus bis zu 15 Minuten). Das Gerät führt weitere Versuche in 2-Stunden-Intervallen durch (plus bis zu 15 Minuten), bis die Resynchronisierung erfolgreich ist.

 Resync_Periodic=3600+600 Resync_Error_Retry_Delay=1800+300,3600+600,7200+900

Beispiel 3

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

Upgrade_Error_Retry_Delay  =  1800,3600,7200,14400+3600

Profilregeln

Das Telefon bietet mehrere Remote-Konfigurationsprofilparameter (Profile_Rule*). Somit können mit jedem Resynchronisierungsvorgang mehrere Dateien abgerufen werden, die von verschiedenen Servern verwaltet werden.

Im einfachsten Fall erfolgt die Resynchronisierung des Geräts regelmäßig 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. Eine weitere, eindeutige Datei wird für jedes Konto bereitgestellt. Verschlüsselungscodes 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_Rule

  2. Profile_Rule_B

  3. Profile_Rule_C

  4. Profile_Rule_D

Jede Auswertung kann dazu führen, dass ein Profil von einem Remote-Bereitstellungsserver abgerufen wird und einige der internen Parameter möglicherweise aktualisiert werden. Wenn eine Auswertung fehlschlägt, wird die Resynchronisierungssequenz unterbrochen und entsprechend den Angaben für den Parameter Resync_Error_Retry_Delay Parameter (in Sekunden) erneut durchgeführt. Wenn alle Auswertungen erfolgreich sind, wartet das Gerät, bis die im Parameter Resync_Periodic angegebene Zeit erreicht ist, und führt dann eine weitere Resynchronisierung durch.

Der Inhalt der einzelnen Profile_Rule*-Parameter besteht aus einer Reihe von Alternativen. Die Alternativen werden durch einen senkrechten Strich | getrennt. Jede Alternative besteht aus einem Bedingungsausdruck, einem Zuweisungsausdruck, einer Profil-URL und allen zugeordneten URL-Optionen. All diese Komponenten sind innerhalb jeder Alternative optional. Im Folgenden sind die zulässigen Kombinationen und die Reihenfolge, in der sie ggf. erscheinen müssen, aufgeführt:

[ bedingter-Ausdruck ] [ Zuweisung-Ausdruck ] [[ Optionen ] URL ]

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

  1. Bedingungen werden von links nach rechts ausgewertet, bis eine gefunden wird, deren Auswertung „True“ ergibt (oder bis eine Alternative ohne Bedingungsausdruck gefunden wird).

  2. Alle zugehörigen Zuweisungsausdrücke werden ggf. ausgewertet.

  3. Wenn eine URL als Teil dieser Alternative angegeben ist, 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

In diesem Beispiel erfolgt eine unbedingte Resynchronisierung mit dem Profil unter der angegebenen URL, und es wird eine HTTP GET-Anforderung an den Remote-Bereitstellungsserver gesendet:

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

Beispiel 2

In diesem Beispiel erfolgt die Resynchronisierung des Geräts mit zwei unterschiedlichen URLs, abhängig vom Registrierungsstatus der Leitung 1. Im Falle einer verlorenen Registrierung führt das Gerät eine HTTP POST-Anforderung an ein CGI-Skript durch. Das Gerät sendet den Inhalt des makroerweiterten GPP_A-Parameters, der zusätzliche Informationen zum Gerätestatus enthalten kann:

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

Beispiel 3

In diesem Beispiel erfolgt die Resynchronisierung des Geräts mit demselben Server. Das Gerät bietet zusätzliche Informationen, 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 einen Wert gleich „Provisioned“ gesetzt wird. Anschließend erfolgt die Resynchronisierung mit der zweiten URL:

(“$A” ne “Provisioned”)? (Line_Enable_1_ = “No”;)! https://p.tel.com/init-prov| https://p.tel.com/configs

Beispiel 5

In diesem Beispiel wird angenommen, dass das Profil, das vom Server zurückgegeben wird, XML-Element-Tags enthält. Diese Tags müssen mithilfe der Alias-Zuordnung, die in GPP_B gespeichert ist, erneut den entsprechenden Parameternamen zugeordnet werden:

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

Eine Resynchronisierung wird normalerweise als fehlgeschlagen betrachtet, 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 „No“ festgelegt ist, akzeptiert das Gerät eine Datei-nicht-gefunden-Antwort vom Server als erfolgreiche Resynchronisierung. Der Standardwert für Resync_Fails_On_FNF lautet „Yes“.

Upgrade-Regel

Mithilfe der Upgrade-Regel wird das Gerät angewiesen, eine neue Software zu aktivieren, und ggf. informiert, wo diese Software abgerufen werden kann. Wenn die Software bereits auf dem Gerät vorhanden ist, versucht es nicht, sie abzurufen. Die Gültigkeit des Software-Speicherorts ist demnach nicht von Bedeutung, wenn sich die gewünschte Software auf der inaktiven Partition befindet.

Mit dem Parameter Upgrade_Rule wird eine Firmware angegeben, die, wenn sie sich von der aktuellen Firmware unterscheidet, heruntergeladen und angewendet wird, sofern dies nicht durch einen Bedingungsausdruck verhindert wird oder Upgrade_Enable auf No festgelegt wurde.

Das Telefon umfasst einen konfigurierbaren Remote-Upgrade-Parameter: 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 Alternativen, getrennt durch das |-Zeichen, angegeben werden. Die Syntax für die einzelnen Alternativen lautet wie folgt:

[ bedingter-Ausdruck ] [ Zuweisung-Ausdruck ] URL

Wie bei den Profile_Rule*-Parametern werden mit dem Parameter Upgrade_Rule alle Alternativen ausgewertet, bis ein Bedingungsausdruck erfüllt ist oder eine Alternative keinen Bedingungsausdruck aufweist. Der zugehörige Zuweisungsausdruck wird ausgewertet, sofern er angegeben wurde. Anschließend wird versucht, ein Upgrade über die angegebene URL durchzuführen.

Wenn Upgrade_Rule eine URL ohne einen Bedingungsausdruck enthält, wird das Gerät auf das Firmware-Image aktualisiert, das mit der URL angegeben wird. Nach der Makroerweiterung und Auswertung der Regel versucht das Gerät so lange nicht erneut, ein Upgrade durchzuführen, bis die Regel oder die effektive Kombination von „scheme + server + port + filepath” geändert wurde.

Um zu versuchen, ein Firmware-Upgrade durchzuführen, wird zu Beginn des Vorgangs die Audiofunktion auf dem Gerät deaktiviert, und am Ende des Vorgangs wird das Gerät neu gestartet. Das Gerät führt nur dann automatisch ein Upgrade durch, 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 wird mit Upgrade_Rule die Firmware auf das Image aktualisiert, das unter der angegebenen URL gespeichert ist.

Hier ist ein weiteres Beispiel:

(“$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 diesem Beispiel wird das Gerät angewiesen, basierend auf den Inhalten des allgemeinen Parameters GPP_F eines von zwei Images zu laden.

Bereitstellungsparameter

Die Bereitstellungsparameter befinden sich auf der Registerkarte Bereitstellung auf der Webseite des Telefons.

Konfigurationsprofilparameter

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

Tabelle 1. Konfigurationsprofilparameter

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.

Tabelle 2. Parameter für Firmware-Upgrades

Parametername

Beschreibung und Standardwert

Upgrade aktivieren

Mit dieser Option werden Firmware-Upgrade-Aktionen unabhängig von Resynchronisierungsaktionen aktiviert.

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">Ja</Upgrade_Enable>

  • Legen Sie dieses Feld auf der Webseite für die Telefonverwaltung auf Ja oder Nein fest.

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.

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">3600</Upgrade_Error_Retry_Delay>

  • Legen Sie den Wert auf der Webseite für die Telefonverwaltung fest.

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

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 für die Telefonverwaltung den Pfad ein, in dem die Softwaredatei gespeichert ist.

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

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 -- Requesting Upgrade $SCHEME://$SERVIP:$PORT$PATH</Log_Upgrade_Request_Msg>

  • Passen Sie den Parameter auf der Webseite für die Telefonverwaltung nach Bedarf an.

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.

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 -- $ERR</Log_Upgrade_Success_Msg>

  • Passen Sie den Parameter auf der Webseite für die Telefonverwaltung nach Bedarf an.

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.

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: $ERR</Log_Upgrade_Failure_Msg>

  • Passen Sie den Parameter auf der Webseite für die Telefonverwaltung 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. 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">Ja</Peer_Firmware_Sharing>

  • Legen Sie dieses Feld auf der Webseite für die Telefonverwaltung auf Ja oder Nein fest.

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.

Konfigurieren Sie diesen Parameter mit einer der folgenden Methoden:

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

  • Geben Sie auf der Webseite für die Telefonverwaltung die Adresse des Protokollservers ein.

Allgemeine Parameter

In der folgenden Tabelle werden die Funktion und 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. 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“.

Variablen für die Makroerweiterung

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.

$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. Beispiel: CP-8875, DP-9851, DP-9871.

PSN

Produktseriennummer. Beispiel: V03.

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:

PHONEOS.3-1-1-0104-37

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

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.

Tabelle 4. Interne Fehlercodes

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.