Parametry obsługi administracyjnej

W tej części opisano parametry obsługi administracyjnej, ogólnie uporządkowane według funkcji.

Parametry ogólnego przeznaczenia

Parametry ogólnego przeznaczenia GPP_* (Logowanie administratora > Zaawansowane > Głos > Obsługa administracyjna) pełnią rolę tekstowych pól używanych podczas konfigurowania współpracy telefonu z określonym serwerem obsługi administracyjnej. Parametry GPP_* są domyślnie puste. Można skonfigurować przechowywanie w nich różnych wartości, w tym następujących:

  • Klucze szyfrowania

  • Adresy URL

  • Informacje o stanie wielostopniowej obsługi administracyjnej

  • Szablony żądań POST

  • Mapy aliasów nazw parametrów

  • Częściowe wartości ciągów łączone w kompletne wartości parametrów

Parametry GPP_* mogą być rozwijane w makra wewnątrz innych parametrów obsługi administracyjnej. W tym kontekście do identyfikowania zawartości parametrów od GPP_A do GPP_P wystarczają nazwy makr w postaci pojedynczych wielkich liter (od A do P). Ponadto nazwy makr składające się z dwóch wielkich liter od SA do SD identyfikują parametry od GPP_SA do GPP_SD w szczególnych przypadkach, gdy są używane jako argumenty w następujących opcjach adresów URL:

key, uid i pwd

Te parametry mogą pełnić rolę zmiennych w regułach obsługi administracyjnej i uaktualniania. Odwołania do nich tworzy się przed dodanie prefiksu „$” do nazwy zmiennej, np. $GPP_A.

Parametry uruchamiania

Parametry Provision_Enable i Upgrade_Enable sterują wszystkimi operacjami ponownej synchronizacji profili i uaktualniania oprogramowania sprzętowego. Działają one niezależnie od siebie. Ponadto sterują poleceniami ponownej synchronizacji i uaktualniania adresów URL wysyłanymi za pośrednictwem administracyjnego serwera WWW. Oba parametry mają domyślnie ustawioną wartość Tak (Yes).

Parametr Resync_From_SIP steruje żądaniami ponownej synchronizacji. Zdarzenie SIP NOTIFY jest wysyłane z serwera proxy dostawcy usług do telefonu. Jeśli na serwerze proxy są włączone odpowiednie funkcje, może się pojawić żądanie ponownej synchronizacji. W tym celu do urządzenia jest wysyłany komunikat SIP NOTIFY zawierający nagłówek Event: resync.

Żądanie jest kwestionowane przez urządzenie za pomocą odpowiedzi 401 (odmowa autoryzacji użytych poświadczeń). Żądanie ponownej synchronizacji z serwera proxy zostanie zrealizowane w urządzeniu po otrzymaniu uwierzytelnionego następnego żądania. Nagłówki Event: reboot_now i Event: restart_now powodują odpowiednio ponowny rozruch sprzętowy i programowy; one również są kwestionowane.

Dwa pozostałe włączniki to Resync_On_Reset i Resync_After_Upgrade_Attempt. Parametry te decydują o tym, czy w urządzeniu jest wykonywana operacja ponownej synchronizacji po każdym ponownym uruchomieniu programowym i po każdej próbie uaktualnienia.

Jeżeli parametr Resync_On_Reset jest włączony, wówczas po sekwencji rozruchu, a przed wykonaniem resetu w urządzeniu jest dodawane losowe opóźnienie. Czas trwania opóźnienia jest losowy, jednak nie dłuższy niż wartość określona w parametrze Resync_Random_Delay (w sekundach). W puli telefonów włączanych jednocześnie to opóźnienie powoduje różnicowanie czasów rozpoczęcia wykonywania żądań ponownej synchronizacji z każdego urządzenia. Funkcja może być przydatna w dużych wdrożeniach na terenach mieszkalnych w razie awarii lokalnej sieci elektrycznej.

Wyzwalacze

Telefon umożliwia ponowne synchronizowanie w określonych odstępach czasu lub określonych godzinach.

Ponowna synchronizacja w określonych odstępach czasu

Telefon powinien się okresowo synchronizować z serwerem obsługi administracyjnej. Interwał ponownej synchronizacji jest ustawiany w parametrze Resync_Periodic (w sekundach). Jeśli ta wartość jest pusta, urządzenie nie synchronizuje się okresowo.

Zazwyczaj ponowna synchronizacja odbywa się w okresie bezczynności linii głosowych. Jeśli linia głosowa jest aktywna w momencie, gdy powinna zostać wykonana ponowna synchronizacja, telefon opóźnia procedurę synchronizacji do czasu, aż linia znów będzie bezczynna. Ponowna synchronizacja może spowodować zmianę wartości parametrów konfiguracyjnych.

Operacja ponownej synchronizacji może się nie udać, jeśli telefon nie jest w stanie pobrać profilu z serwera, pobrany plik jest uszkodzony lub wystąpił błąd wewnętrzny. Urządzenie ponowi próbę synchronizacji po czasie określonym w parametrze Resync_Error_Retry_Delay (w sekundach). Ustawienie w parametrze Resync_Error_Retry_Delay wartości 0 spowoduje, że urządzenie nie będzie próbować ponownej synchronizacji po jednej nieudanej próbie.

W przypadku nieudanego uaktualnienia system ponawia próbę po liczbie sekund ustawionej w parametrze Upgrade_Error_Retry_Delay.

Istnieją dwa konfigurowalne parametry umożliwiające warunkowe inicjowanie ponownej synchronizacji: Resync_Trigger_1 i Resync_Trigger_2. W każdym parametrze można zaprogramować wyrażenie warunkowe rozwijane do makra. Po upływie interwału ponownej synchronizacji (czasu do następnej synchronizacji) wyzwalacze (jeśli zostały ustawione) uniemożliwią ponowną synchronizację, jeżeli nie jest spełniony warunek co najmniej jednego z nich.

W przykładzie poniżej warunek powoduje zainicjowanie ponownej synchronizacji. Tutaj od ostatniej próby uaktualnienia telefonu upłynęło ponad 5 minut (300 sekund), a co najmniej 10 minut (600 sekund) upłynęło od ostatniej próby ponownej synchronizacji.

$UPGTMR gt 300 i $PRVTMR ge 600

Ponowna synchronizacja o określonej godzinie

Parametr Resync_At umożliwia synchronizowanie telefonu o konkretnie wybranej godzinie. Godzina jest ustalana na podstawie zegara w formacie 24-godzinnym (ggmm).

Parametr Resync_At_Random_Delay umożliwia synchronizowanie telefonu z nieokreślonym opóźnieniem czasowym. Do określania czasu wykorzystywana jest dodatnia liczba całkowita.

Należy unikać zalewania serwera żądaniami ponownej synchronizacji z wielu telefonów, dla których ustawiono synchronizowanie w tym samym czasie. Aby zapobiec temu zjawisku, ponowna synchronizacja telefonu może być inicjowana nawet 10 minut po wyznaczonej godzinie.

Jeśli na przykład ustawisz godzinę ponownej synchronizacji na 1000 (10 rano), synchronizacja rozpocznie się w dowolnym momencie między 10:00 a 10:10.

Domyślnie ta funkcja jest wyłączona. Włączenie parametru Resync_At powoduje ignorowanie parametru Resync_Periodic.

Konfigurowalne harmonogramy

Za pomocą poniższych parametrów obsługi administracyjnej można skonfigurować harmonogramy okresowych ponownych synchronizacji oraz określić odstępy czasu między kolejnymi próbami po niepowodzeniach ponownej synchronizacji i uaktualniania:

  • Resync_Periodic

  • Resync_Error_Retry_Delay

  • Upgrade_Error_Retry_Delay

Każdy parametr może zawierać jedną wartość opóźnienia (w sekundach). Nowa rozszerzona składnia umożliwia wprowadzenie listy kolejnych elementów opóźnienia oddzielonych przecinkami. Ostatni element sekwencji jest domyślnie powtarzany bezterminowo.

Opcjonalnie za pomocą znaku plusa można podać inną wartość liczbową, która dodaje losowe dodatkowe opóźnienie.

Przykład 1

W tym przykładzie telefon synchronizuje się ponownie regularnie co 2 godziny. Jeśli w trakcie ponownej synchronizacji wystąpi błąd, urządzenie będzie ponawiać próby w następujących odstępach: 30 minut, 1 godzina, 2 godziny i 4 godziny. Potem urządzenie będzie nadal próbować co 4 godziny do czasu, aż ponowna synchronizacja się powiedzie.

 Resync_Periodic=7200 Resync_Error_Retry_Delay=1800,3600,7200,14400

Przykład 2

W tym przykładzie urządzenie synchronizuje się ponownie co godzinę (plus dodatkowe losowe opóźnienie wynoszące maksymalnie 10 minut). W razie błędu ponownej synchronizacji urządzenie będzie ponawiać próby w następujących odstępach: 30 minut (plus maksymalnie 5 minut). 1 godzina (plus maksymalnie 10 minut), 2 godziny (plus maksymalnie 15 minut). Potem urządzenie będzie nadal próbować co 2 godziny (plus maksymalnie 15 minut) do czasu, aż ponowna synchronizacja się powiedzie.

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

Przykład 3

W tym przykładzie w razie niepowodzenia próby zdalnego uaktualnienia urządzenie ponowi próbę po 30 minutach, następnie ponownie po 1 godzinie, a następnie po kolejnych 2 godzinach. Jeśli uaktualnienie nadal się nie uda, urządzenie będzie próbować co 4-5 godzin do momentu, aż uaktualnienie się powiedzie.

Upgrade_Error_Retry_Delay  =  1800,3600,7200,14400+3600

Reguły profili

Telefon zawiera wiele parametrów zdalnych profili konfiguracji (Profile_Rule*). W efekcie podczas każdej operacji ponownej synchronizacji może być pobieranych wiele plików zarządzanych przez różne serwery.

W najprostszym scenariuszu urządzenie jest ponownie synchronizowane co pewien czas za pomocą jednego profilu na centralnym serwerze, co powoduje aktualizuję wszystkich odpowiednich wewnętrznych parametrów. Alternatywnie profil może być podzielony między różne pliki. Jeden plik jest wspólny dla wszystkich telefonów we wdrożeniu. Dodatkowo dla każdego konta istnieje oddzielny, unikatowy plik. Klucze szyfrowania i dane certyfikatów mogą być dostarczane przez jeszcze inny profil, przechowywany na osobnym serwerze.

Za każdym razem, gdy zbliża się operacja ponownej synchronizacji, telefon ocenia cztery parametry Profile_Rule* w następującej kolejności:

  1. Profile_Rule

  2. Profile_Rule_B

  3. Profile_Rule_C

  4. Profile_Rule_D

Każda ocena może spowodować pobranie profilu ze zdalnego serwera obsługi administracyjnej, a następnie aktualizację niektórych parametrów wewnętrznych. Jeżeli wynik będzie negatywny, sekwencja ponownej synchronizacji zostanie przerwana i rozpocznie się od nowa po czasie określonym przez parametr Resync_Error_Retry_Delay (w sekundach). Jeśli wszystkie oceny będą pozytywne, urządzenie czeka przez liczbę sekund określoną parametrem Resync_Periodic, a następnie wykonuje kolejną synchronizację.

Każdy parametr Profile_Rule* zawiera zbiór wartości alternatywnych. Wartości alternatywne są oddzielone znakiem | (potoku). Każda wartość alternatywna składa się z wyrażenia warunkowego, wyrażenia przypisania, adresu URL profilu i powiązanych opcji w adresie URL. Wszystkie te składniki są opcjonalne w każdej wartości alternatywnej. Poniżej wymieniono prawidłowe kombinacje oraz kolejność, w jakiej muszą być uszeregowane, jeśli występują:

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

W każdym parametrze Profile_Rule* wszystkie wartości alternatywne (poza ostatnią) muszą zawierać wyrażenie warunkowe. To wyrażenie jest oceniane i przetwarzane w następujący sposób:

  1. Warunki są oceniane w kolejności od lewej do prawej strony do czasu, aż zostanie znaleziony warunek dający rezultat Prawda (lub do momentu znalezienia wartości alternatywnej bez wyrażenia warunkowego).

  2. Wtedy następuje ocena towarzyszącego wyrażenia przypisania, jeśli takie występuje.

  3. Jeśli częścią wartości alternatywnej jest adres URL, następuje próba pobrania profilu znajdującego się pod tym adresem. Następnie system próbuje odpowiednio zaktualizować parametry wewnętrzne.

Jeśli wszystkie wartości alternatywne zawierają wyrażenia warunkowe, a żadna z nich po ocenie nie daje rezultatu Prawda (lub jeśli cała reguła profilu jest pusta), cały parametr Profile_Rule* jest pomijany. Wtedy rozpoczyna się ocena następnego w kolejności parametru reguły profilu.

Przykład 1

W tym przykładzie następuje bezwarunkowa ponowna synchronizacja z profilem pod wskazanym adresem URL oraz wysłanie żądania HTTP GET do zdalnego serwera obsługi administracyjnej:

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

Przykład 2

W tym przykładzie urządzenie resynchronizuje się z dwoma różnymi adresami URL, w zależności od stanu rejestracji linii 1. W przypadku utraty rejestracji urządzenie wykonuje polecenie HTTP POST do skryptu CGI. Urządzenie wysyła zawartość parametru GPP_A rozwiniętego w makro, która może obejmować dodatkowe informacje o stanie urządzenia:

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

Przykład 3

W tym przykładzie urządzenie synchronizuje się z tym samym serwerem. Jeśli na urządzeniu (z wersją oprogramowania starszą niż 2.0) nie jest zainstalowany certyfikat, przekazuje ono dodatkowe informacje:

 ("$CCERT" eq "Zainstalowany")? https://p.tel.com/config? | https://p.tel.com/config?cisco$MAU

Przykład 4

W tym przykładzie linia 1 jest wyłączona do momentu, aż parametr GPP_A zostanie ustawiony na obsługę administracyjną z pierwszego adresu URL. Później następuje ponowna synchronizacja z drugim adresem URL:

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

Przykład 5

W tym przykładzie zakłada się, że profil zwracany przez serwer zawiera znaczniki elementów XML. Znaczniki należy przyporządkować odpowiednim nazwom parametrów zgodnie z mapą aliasów przechowywaną w parametrze GPP_B:

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

Ponowna synchronizacja jest zazwyczaj uznawana za nieudaną, jeśli urządzenie nie otrzyma żądanego profilu z serwera. To domyślne zachowanie można zastąpić parametrem Resync_Fails_On_FNF. Ustawienie wartości Nie (No) w parametrze Resync_Fails_On_FNF spowoduje, że urządzenie potraktuje odpowiedź „Nie znaleziono pliku” otrzymaną z serwera jako pomyślną ponowną synchronizację. Domyślna wartość parametru Resync_Fails_On_FNF to Tak (Yes).

Reguła uaktualniania (Upgrade Rule)

Reguła uaktualniania określa, że urządzenie ma zostać uaktywnione przy użyciu nowego pakietu oprogramowania sprzętowego, oraz w razie potrzeby wskazuje, gdzie można uzyskać ten pakiet. Jeśli pakiet już znajduje się na urządzeniu, próba pobrania nie nastąpi. Oznacza to, że prawidłowość lokalizacji pakietu oprogramowania sprzętowego nie ma znaczenia, jeżeli pakiet znajduje się na nieaktywnej partycji.

Parametr Upgrade_Rule określa pakiet oprogramowania sprzętowego, który — jeśli różni się od bieżącego pakietu — zostanie pobrany i zastosowany, chyba że wyrażenie warunkowe nakłada pewne ograniczenia albo w parametrze Upgrade_Enable ustawiono wartość No.

Telefon udostępnia jeden konfigurowalny parametr zdalnego uaktualniania — Upgrade_Rule. Parametr akceptuje wartości o składni podobnej jak w parametrach reguł profilu. W uaktualnianiu w adresach URL nie można podawać opcji, natomiast można używać wyrażeń warunkowych i wyrażeń przypisania. W przypadku stosowania wyrażeń warunkowych parametr można wypełnić wieloma wartościami alternatywnymi, rozdzielając je znakiem |. Składnia każdej alternatywnej wartości wygląda następująco:

[ conditional-expr ] [ assignment-expr ] URL

Podobnie jak w przypadku parametrów Profile_Rule*, parametr Upgrade_Rule ocenia każdą wartość alternatywną do momentu, aż zostanie spełnione wyrażenie warunkowe lub wartość alternatywna nie będzie mieć wyrażenia warunkowego. Wtedy następuje ocena towarzyszącego wyrażenia przypisania, jeśli jest ono określone. Następnie system próbuje wykonać uaktualnienie z podanego adresu URL.

Jeśli parametr Upgrade_Rule zawiera adres URL bez wyrażenia warunkowego, urządzenie uaktualni się do obrazu oprogramowania sprzętowego wskazanego przez adres URL. Po rozwinięciu do makra i ocenie reguły urządzenie nie ponawia prób uaktualnienia do momentu, aż reguła zostanie zmodyfikowana lub realnie zmieni się kombinacja schemat + serwer + port + ścieżka pliku.

Podczas próby uaktualnienia oprogramowania sprzętowego urządzenie wyłącza dźwięk na początku procedury i uruchomiania się ponownie po jej zakończeniu. Urządzenie automatycznie rozpoczyna uaktualnienie wymuszone zawartością parametru Upgrade_Rule tylko wtedy, gdy wszystkie linie głosowe są nieaktywne.

Na przykład:

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

W tym przykładzie parametr Upgrade_Rule powoduje uaktualnienie oprogramowania sprzętowego do obrazu zapisanego w ścieżce wskazanej przez adres URL.

Poniżej kolejny przykład:

(“$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

W tym przykładzie urządzenie otrzymuje instrukcję wczytania jednego z dwóch obrazów na podstawie zawartości parametru ogólnego przeznaczenia GPP_F.

Parametry obsługi administracyjnej

Parametry provisioningu można znaleźć na karcie Obsługa administracyjna na stronie internetowej telefonu.

Parametry profilu konfiguracji

Poniższa tabela zawiera informacje na temat przeznaczenia i zastosowania parametrów znajdujących się w części Parametry profilu konfiguracji (Configuration Profile Parameters) na karcie Obsługa administracyjna (Provisioning).

Tabela 1. Parametry profilu konfiguracji

Nazwa parametru

Opis i wartość domyślna

Włącz obsługę administracyjną (Provision Enable)

Steruje wszystkimi operacjami ponownej synchronizacji niezależnie od operacji uaktualniania oprogramowania sprzętowego. Ustaw wartość Tak (Yes), aby umożliwić zdalną obsługę administracyjną.

Wartość domyślna to Tak.

Ponowna synchronizacja po zresetowaniu (Resync On Reset)

Inicjuje ponowną synchronizację po każdym ponownym uruchomieniu, poza restartami spowodowanymi aktualizacją parametrów i uaktualnieniami oprogramowania układowego.

Wartość domyślna to Tak.

Losowe opóźnienie ponownej synchronizacji (Resync Random Delay)

Losowe opóźnienie po sekwencji rozruchu, a przed wykonaniem resetu, podawane w sekundach. W puli urządzeń telefonii IP, które mają zaplanowane równoczesne uruchomienie, ta funkcja wprowadza pewną rozpiętość czasową wysyłania żądań ponownej synchronizacji z poszczególnych urządzeń do serwera obsługi administracyjnej. Funkcja może być przydatna w dużych wdrożeniach na terenach mieszkalnych w razie awarii lokalnej sieci elektrycznej.

Wartość tego pola musi być liczbą całkowitą z zakresu od 0 do 65535.

Wartość domyślna to 2.

Ponowna synchronizacja o (GGmm) (Resync At (HHmm))

Godzina (GGmm), o której urządzenie ponownie się synchronizuje z serwerem obsługi administracyjnej.

Wartość tego pola musi być czterocyfrową liczbą z zakresu od 0000 do 2400, wskazującą godzinę w formacie GGmm. Na przykład 0959 oznacza 09:59.

Wartością domyślną jest puste pole. Nieprawidłowa wartość powoduje ignorowanie parametru. Jeżeli w parametrze zostanie ustawiona prawidłowa wartość, parametr Okresowa ponowna synchronizacja jest ignorowany.

Ponowna synchronizacja z losowym opóźnieniem (Resync At Random Delay)

Zapobiega przeciążeniu serwera obsługi administracyjnej podczas włączania dużej liczby urządzeń równocześnie.

Aby uniknąć zalewania serwera żądaniami ponownej synchronizacji z wielu telefonów, telefon synchronizuje się ponownie w przedziale między godziną i minutą a godziną i minutą powiększoną o losowe opóźnienie (ggmm, ggmm+random_delay). Jeśli na przykład random_delay = (Resynchronizacja przy opóźnieniu losowym + 30)/60 minut, w celu obliczenia ostatecznego interwału random_delay wprowadzona wartość w sekundach jest przeliczana na minuty z zaokrąglaniem do najbliższej minuty.

Prawidłowy zakres wartości należy do przedziału od 0 do 65535.

Jeśli wartość jest mniejsza niż 600, wartość określająca Opóźnienie losowe wynosi od 0 do 600.

Wartość domyślna to 600 sekund (10 minut).

Okresowa ponowna synchronizacja (Resync Periodic)

Odstęp czasu między okresowymi ponownymi synchronizacjami z serwerem obsługi administracyjnej. Skojarzony zegar ponownej synchronizacji jest aktywowany dopiero po pierwszej pomyślnej synchronizacji z serwerem.

Prawidłowe są następujące formaty:

  • Liczba całkowita

    Przykład: dane wejściowe 3000 oznaczają, że następna resynchronizacja nastąpi za 3000 sekund.

  • Wiele liczb całkowitych

    Przykład: dane wejściowe z 600,1200,300 oznaczają, że pierwsza resynchronizacja nastąpi za 600 sekund, druga resynchronizacja nastąpi 1200 sekund po pierwszej, a trzecia resynchronizacja nastąpi 300 sekund po drugiej.

  • Przedział czasu

    Przykład: dane wejściowe 2400+30 oznaczają, że następna resynchronizacja nastąpi w przedziale między 2400 i 2430 sekund po pomyślnej resynchronizacji.

Ustawienie w tym parametrze wartości zero spowoduje wyłączenie okresowego ponownego synchronizowania.

Wartość domyślna to 3600 sekund.

Opóźnienie kolejnych prób po błędzie synchronizacji (Resync Error Retry Delay)

Jeśli operacja ponownej synchronizacji nie udaje się, ponieważ urządzenie telefonii IP nie może pobrać profilu z serwera, pobrany plik jest uszkodzony lub występuje błąd wewnętrzny, urządzenie próbuje zsynchronizować się ponownie po czasie podanym w sekundach.

Prawidłowe są następujące formaty:

  • Liczba całkowita

    Przykład: dane wejściowe 300 oznaczają, że następna próba resynchronizacji nastąpi za 300 sekund.

  • Wiele liczb całkowitych

    Przykład: dane wejściowe z 600,1200,300 oznaczają, że pierwsza próba nastąpi w 600 sekund po niepowodzeniu, druga próba nastąpi 1200 sekund po niepowodzeniu pierwszej próby, a trzecia próba nastąpi 300 sekund po niepowodzeniu drugiej próby.

  • Przedział czasu

    Przykład: dane wejściowe z 2400+30 oznaczają, że następna próba nastąpi w przedziale między 2400 i 2430 sekund po niepowodzeniu resynchronizacji.

Ustawienie opóźnienia równego 0 spowoduje, że urządzenie nie będzie próbować ponownej synchronizacji po jednej nieudanej próbie.

Opóźnienie wymuszonej ponownej synchronizacji (Forced Resync Delay)

Maksymalne opóźnienie (w sekundach), po jakim telefon wykonuje ponowną synchronizację.

Urządzenie nie synchronizuje się, gdy którakolwiek z jego linii telefonicznych jest aktywna. Ponieważ ponowna synchronizacja może potrwać kilka sekund, najlepiej poczekać z rozpoczęciem synchronizacji, aż urządzenie będzie bezczynne przez dłuższy czas. Dzięki temu użytkownik będzie mógł wykonywać połączenia jedno po drugim bez zakłóceń.

Urządzenie zawiera zegar, który rozpoczyna odliczanie z chwilą przejścia wszystkich linii w stan bezczynności. Ten parametr jest początkową wartością licznika. Zdarzenia ponownej synchronizacji są opóźnione do momentu, aż wartość tego licznika spadnie do zera.

Prawidłowy zakres wartości należy do przedziału od 0 do 65535.

Wartość domyślna to 14 400 sekund.

Ponowna synchronizacja przy użyciu protokołu SIP (Resync From SIP)

Umożliwia inicjowanie ponownej synchronizacji za pomocą komunikatu SIP NOTIFY.

Wartość domyślna to Tak.

Ponowna synchronizacja po próbie uaktualnienia (Resync After Upgrade Attempt)

Włącza lub wyłącza operację ponownej synchronizacji po każdym uaktualnieniu. Wartość Tak oznacza, że synchronizacja jest uruchamiana.

Wartość domyślna to Tak.

Wyzwalacz ponownej synchronizacji 1 (Resync Trigger 1), Wyzwalacz ponownej synchronizacji 2 (Resync Trigger 2)

Konfigurowalne warunki inicjowania ponownej synchronizacji. Ponowna synchronizacja jest inicjowana, gdy równanie logiczne w tych parametrach daje wynik PRAWDA.

Wartością domyślną jest puste pole.

Niepowodzenie ponownej synchronizacji z powodu nieznalezienia pliku (Resync Fails On FNF)

Ponowna synchronizacja jest uznawana za nieudaną, jeśli urządzenie nie otrzyma żądanego profilu z serwera. To domyślne zachowanie może zostać zastąpione przez ten parametr. Ustawienie wartości Nie (No) spowoduje, że urządzenie potraktuje odpowiedź Nie znaleziono pliku otrzymaną z serwera jako pomyślną ponowną synchronizację.

Wartość domyślna to Tak.

Reguła profilu

Reguła profilu B (Profile Rule B)

Reguła profilu C (Profile Rule C)

Reguła profilu D (Profile Rule D)

Każda reguła profilu informuje telefon o źródle, z którego należy uzyskać profil (plik konfiguracyjny). Podczas każdej operacji ponownej synchronizacji telefon stosuje wszystkie profile kolejno.

Wartość domyślna: /$PSN.xml

Jeśli do plików konfiguracyjnych chcesz zastosować szyfrowanie metodą AES-256-CBC, określ klucz szyfrowania ze słowem kluczowym --key w następujący sposób:

[--key <klucz szyfrowania>]

Opcjonalnie klucz szyfrowania można ująć w podwójny cudzysłów (").

Opcja DHCP do użycia (DHCP Option To Use)

Opcje protokołu DHCP, rozdzielone przecinkami, używane do pobierania oprogramowania sprzętowego i profili.

Wartość domyślna to 66,160,159,150,60,43,125.

Komunikat o żądaniu jest już w dzienniku (Log Request Msg)

Ten parametr zawiera komunikat wysyłany do serwera dziennika systemu na początku próby ponownej synchronizacji.

Wartość domyślna to $PN $MAC –Żądanie % $SCHEME://$SERVIP:$PORT$PATH.

Komunikat o pomyślnym zakończeniu jest już w dzienniku (Log Success Msg)

Komunikat dziennika systemowego wysyłany po pomyślnym zakończeniu próby ponownej synchronizacji.

Wartość domyślna to $PN $MAC –Pomyślna ponowna synchronizacja % $SCHEME://$SERVIP:$PORT$PATH -- $ERR.

Komunikat o niepowodzeniu jest już w dzienniku (Log Failure Msg)

Komunikat dziennika systemowego wysyłany po nieudanej próbie ponownej synchronizacji.

Wartość domyślna to $PN $MAC -- Ponowna synchronizacja nie powiodła się: $ERR.

Ponowna synchronizacja konfigurowana przez użytkownika (User Configurable Resync)

Umożliwia użytkownikowi ponowne synchronizowanie telefonu IP z jego ekranu.

Wartość domyślna to Tak.

Parametry uaktualniania oprogramowania sprzętowego

Poniższa tabela zawiera informacje na temat przeznaczenia i zastosowania parametrów znajdujących się w części Uaktualnianie oprogramowania sprzętowego (Firmware Upgrade) na karcie Obsługa administracyjna (Provisioning).

Tabela 2. Parametry uaktualniania oprogramowania sprzętowego

Nazwa parametru

Opis i wartość domyślna

Włącz uaktualnianie (Upgrade Enable)

Umożliwia wykonywanie operacji uaktualniania oprogramowania sprzętowego niezależnie od operacji ponownej synchronizacji.

Wartość domyślna to Tak.

Skonfiguruj ten parametr za pomocą jednej z następujących metod:

  • W pliku konfiguracyjnym telefonu z XML(cfg.xml) wprowadź ciąg w formacie: <Upgrade_Enable ua="na">Tak</Upgrade_Enable>

  • Na stronie WWW administracji telefonu ustaw w tym polu wartość Tak lub Nie.

Opóźnienie kolejnych prób po błędzie uaktualniania (Upgrade Error Retry Delay)

Odstęp czasu (w sekundach) między kolejnymi próbami uaktualnienia stosowany w razie błędu uaktualniania. Urządzenie ma specjalny zegar, który aktywuje się po niepowodzeniu próby uaktualnienia. Inicjowaniem zegara steruje wartość tego parametru. Następna próba uaktualnienia rozpocznie się po odliczeniu do zera w tym zegarze.

Wartość domyślna to 3600 sekund.

Skonfiguruj ten parametr za pomocą jednej z następujących metod:

  • W pliku konfiguracyjnym telefonu z XML(cfg.xml) wprowadź ciąg w formacie: <Upgrade_Error_Retry_Delay ua="na">3600</Upgrade_Error_Retry_Delay>

  • Na stronie WWW administracji telefonu ustaw wartość.

Reguła uaktualniania (Upgrade Rule)

Skrypt uaktualniania oprogramowania sprzętowego, który określa warunki uaktualniania oraz powiązane adresy URL oprogramowania sprzętowego. Używa takiej samej składni, jak reguła profilu.

Aby wprowadzić regułę uaktualniania, zastosuj następujący format:

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

Na przykład: 

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

Jeśli protokół nie zostanie podany, domyślnie będzie używany protokół TFTP. Jeśli nie podano nazwy serwera, jako nazwa serwera zostanie użyta nazwa hosta żądająca tego adresu jeśli nie określono portu, używany jest port domyślny (69 dla TFTP, 80 dla HTTP lub 443 for HTTPS).

Wartością domyślną jest puste pole.

Skonfiguruj ten parametr za pomocą jednej z następujących metod:

  • W pliku konfiguracyjnym telefonu z XML(cfg.xml) wprowadź ciąg w formacie: <Upgrade_Rule ua="na">http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads</Upgrade_Rule>

  • Na stronie WWW administracji telefonu wprowadź ścieżkę, gdzie jest przechowywany plik obciążenia.

Komunikat o żądaniu uaktualnienia w dzienniku (Log Upgrade Request Msg)

Komunikat dziennika systemowego wysyłany na początku próby uaktualnienia oprogramowania sprzętowego.

Wartość domyślna: $PN $MAC -- Żądanie uaktualnienia $SCHEME://$SERVIP:$PORT$PATH

Skonfiguruj ten parametr za pomocą jednej z następujących metod:

  • W pliku konfiguracyjnym telefonu z XML(cfg.xml) wprowadź ciąg w formacie: <Log_Upgrade_Request_Msg ua="na">$PN $MAC -- Żądanie aktualizacji $SCHEME://$SERVIP:$PORT$PATH</Log_Upgrade_Request_Msg>

  • Na stronie WWW administracji telefonu dostosuj parametr stosownie do potrzeb.

Komunikat o powodzeniu uaktualnienia w dzienniku (Log Upgrade Success Msg)

Komunikat dziennika systemu wysyłany po pomyślnym ukończeniu próby uaktualnienia oprogramowania sprzętowego.

Wartość domyślna to $PN $MAC -- Pomyślne uaktualnienie $SCHEME://$SERVIP:$PORT$PATH -- $ERR.

Skonfiguruj ten parametr za pomocą jednej z następujących metod:

  • W pliku konfiguracyjnym telefonu z XML(cfg.xml) wprowadź ciąg znaków w formacie: <Log_Upgrade_Success_Msg ua="na">$PN $MAC -- Aktualizacja powiodła się $SCHEME://$SERVIP:$PORT$PATH -- $ERR</Log_Upgrade_Success_Msg>

  • Na stronie WWW administracji telefonu dostosuj parametr stosownie do potrzeb.

Komunikat o niepowodzeniu uaktualnienia w dzienniku (Log Upgrade Failure Msg)

Komunikat dziennika systemowego wysyłany po nieudanej próbie uaktualnienia oprogramowania sprzętowego.

Wartość domyślna to $PN $MAC -- Uaktualnienie nie powiodło się: $ERR.

Skonfiguruj ten parametr za pomocą jednej z następujących metod:

  • W pliku konfiguracyjnym telefonu z XML(cfg.xml) wprowadź ciąg w formacie: <Log_Upgrade_Failure_Msg ua="na">$PN $MAC -- Aktualizacja nie powiodła się: $ERR</Log_Upgrade_Failure_Msg>

  • Na stronie WWW administracji telefonu dostosuj parametr stosownie do potrzeb.

Oprogramowanie sprzętowe dystybuowane przez P2P

Włącza lub wyłącza funkcję Peer Firmware Sharing (PFS). Wybierz opcję Tak lub Nie, aby odpowiednio włączyć lub wyłączyć tę funkcję.

Wartość domyślna: Tak

Skonfiguruj ten parametr za pomocą jednej z następujących metod:

  • W pliku konfiguracyjnym telefonu z XML(cfg.xml) wprowadź ciąg w formacie: <Peer_Firmware_Sharing ua="na">Tak</Peer_Firmware_Sharing>

  • Na stronie WWW administracji telefonu ustaw w tym polu wartość Tak lub Nie.

Serwer dziennika mechanizmu równego dostępu do oprogramowania sprzętowego

Wskazuje adres IP i port, pod który zostanie wysłany komunikat UDP.

Na przykład: 10.98.76.123:514, gdzie 10.98.76.123 jest adresem IP, a 514 numerem portu.

Skonfiguruj ten parametr za pomocą jednej z następujących metod:

  • W pliku konfiguracyjnym telefonu z XML(cfg.xml) wprowadź ciąg w formacie: <Peer_Firmware_Sharing_Log_Server ua="na">10.98.76.123:514</Peer_Firmware_Sharing_Log_Server>

  • Na stronie WWW administracji telefonu wprowadź adres serwera dziennika.

Parametry ogólnego przeznaczenia

Poniższa tabela zawiera informacje na temat przeznaczenia i zastosowania parametrów znajdujących się w sekcji Parametry ogólnego przeznaczenia (General Purpose Parameters) na karcie Obsługa administracyjna (Provisioning).

Tabela 3. Parametry ogólnego przeznaczenia

Nazwa parametru

Opis i wartość domyślna

GPP_A - GPP_P

Parametry ogólnego przeznaczenia GPP_* pełnią rolę pól tekstowych używanych podczas konfigurowania współpracy telefonów z konkretnym serwerem obsługi administracyjnej. Można skonfigurować przechowywanie w nich różnych wartości, w tym następujących:

  • Klucze szyfrowania

  • Adresy URL

  • Informacje o stanie wielostopniowej obsługi administracyjnej

  • Szablony żądań POST

  • Mapy aliasów nazw parametrów

  • Częściowe wartości ciągów łączone w kompletne wartości parametrów

Wartością domyślną jest puste pole.

Zmienne rozwijane w makra

Niektóre zmienne makr są rozpoznawane wewnątrz następujących parametrów obsługi administracyjnej:

  • Profile_Rule

  • Profile_Rule_*

  • Resync_Trigger_*

  • Upgrade_Rule

  • Log_*

  • GPP_* (w określonych warunkach)

Wewnątrz tych parametrów są rozpoznawane i rozwijane typy składni takie jak $NAZWA lub $(NAZWA).

Podciągi zmiennych makr można definiować za pomocą zapisu $(NAZWA:p) i $(NAZWA:p:q), gdzie „p” i „q” są nieujemnymi liczbami całkowitymi (funkcjonalność dostępna w wersji 2.0.11 i nowszych). Powstałe rozwinięcie w makro jest podciągiem rozpoczynającym się na przesunięciu znaku p i mającym długość q (lub sięgającym do końca ciągu, jeśli atrybut q nie został określony). Na przykład jeśli parametr GPP_A zawiera wartość ABCDEF, to ciąg podrzędny $(A:2) powoduje rozwinięcie do danych wyjściowych CDEF, a ciąg podrzędny $(A:2:3) rozwinięcie do danych wyjściowych CDE.

Nierozpoznawana nazwa nie jest przekształcana, a po rozwinięciu w makro zapis $NAZWA lub $(NAZWA) pozostaje niezmieniony jako wartość parametru.

Nazwa parametru

Opis i wartość domyślna

$

Zapis $$ rozwija się do jednego znaku $.

Od A do P

Zastępowane wartościami parametrów ogólnego przeznaczenia od GPP_A do GPP_P.

Od SA do SD

Zastępowane wartościami parametrów specjalnego przeznaczenia od GPP_SA do GPP_SD. W tych parametrach są przechowywane klucze lub hasła używane w obsłudze administracyjnej.

Parametry od $SA do $SD są rozpoznawane jako argumenty opcjonalnego kwalifikatora adresu URL ponownej synchronizacji — --key.

MA

Adres MAC zapisany kodem szesnastkowym z małymi literami, na przykład 000e08aabbcc.

MAU

Adres MAC zapisany kodem szesnastkowym z wielkimi literami, na przykład 000E08AABBCC.

MAC

Adres MAC zapisany kodem szesnastkowym z małymi literami, gdzie pary znaków szesnastkowych są rozdzielane dwukropkami. Na przykład: 00:0e:08:aa:bb:cc.

PN

Nazwa produktu. Na przykład CP-8875, DP-9851, DP-9871.

PSN

Numer seryjny produktu. Na przykład: V03.

SN

Ciąg określający numer seryjny, na przykład 88012BA01234.

CCERT

Stan certyfikatu SSL klienta: Zainstalowano lub Nie zainstalowano.

IP

Adres IP telefonu wewnątrz jego lokalnej podsieci. Na przykład: 192.168.1.100.

EXTIP

Zewnętrzny adres IP telefonu widoczny w Internecie. Na przykład: 66.43.16.52.

SWVER

Ciąg określający wersję oprogramowania. Na przykład:

PHONEOS.3-1-1-0104-37

HWVER

Ciąg określający wersję sprzętu. Na przykład: 2.0.1.

PRVST

Stan obsługi administracyjnej (ciąg liczbowy):

-1 = jawne żądanie ponownej synchronizacji

0 = ponowna synchronizacja podczas włączania zasilania

1 = okresowa ponowna synchronizacja

2 = ponowna synchronizacja nie powiodła się, kolejna próba

UPGST

Stan uaktualniania (ciąg liczbowy):

1 = pierwsza próba uaktualnienia

2 = uaktualnianie nie powiodło się, kolejna próba

UPGERR

Komunikat o wyniku (ERR) poprzedniej próby uaktualnienia, na przykład „wykonanie żądania http_get nie powiodło się”.

PRVTMR

Liczba sekund od ostatniej próby ponownej synchronizacji.

UPGTMR

Liczba sekund od ostatniej próby uaktualnienia.

REGTMR1

Liczba sekund od utraty przez linię 1 rejestracji na serwerze SIP.

REGTMR2

Liczba sekund od utraty przez linię 2 rejestracji na serwerze SIP.

UPGCOND

Starsza nazwa makra.

SCHEME

Schemat dostępu do pliku (TFTP, HTTP lub HTTPS) ustalony po analizie adresu URL polecenia ponownej synchronizacji lub uaktualnienia.

SERV

Nazwa hosta docelowego serwera żądania ustalona po analizie adresu URL polecenia ponownej synchronizacji lub uaktualnienia.

SERVIP

Adres IP docelowego serwera żądania ustalony po analizie adresu URL polecenia ponownej synchronizacji lub uaktualnienia, być może po wyszukiwaniu w usłudze DNS.

PORT

Docelowy port UDP/TCP żądania ustalony po analizie adresu URL polecenia ponownej synchronizacji lub uaktualnienia.

PATH

Docelowa ścieżka pliku żądania ustalona po analizie adresu URL polecenia ponownej synchronizacji lub uaktualnienia.

ERR

Komunikat o wyniku próby ponownej synchronizacji lub uaktualnienia. Ten parametr służy tylko do generowania komunikatów o wynikach zapisywanych w dzienniku systemu. W przypadku prób uaktualnienia wartość jest zapisywana w zmiennej UPGERR.

UIDn

Wartość parametru konfiguracyjnego identyfikatora użytkownika na linii n (Line n UserID).

EMS

Stan funkcji Extension Mobility

MUID

Identyfikator użytkownika funkcji Extension Mobility

MPWD

Hasło funkcji Extension Mobility

Kody błędów wewnętrznych

W telefonie zdefiniowano szereg kodów błędów wewnętrznych (X00–X99), które umożliwiają bardziej precyzyjną kontrolę zachowania urządzenia w pewnych sytuacjach problemowych.

Tabela 4. Kody błędów wewnętrznych

Nazwa parametru

Opis i wartość domyślna

X00

Błąd warstwy transportowej (lub protokołu ICMP) podczas wysyłania żądania SIP.

X20

Upłynął limit czasu żądania SIP podczas oczekiwania na odpowiedź.

X40

Ogólny błąd protokołu SIP (na przykład nieakceptowalny kodek w protokole SDP w komunikatach 200 i potwierdzenia lub upłynął limit czasu podczas oczekiwania na potwierdzenie).

X60

Wybrany numer jest nieprawidłowy zgodnie z obowiązującym planem wybierania.