Typy parametrů zřizování

V této části jsou popsány parametry zřizování zhruba roztříděné podle funkce.

Obecné parametry

Obecné parametry GPP_* (Přihlášení správce > pokročilé > Hlas > Zřizování) se při konfiguraci telefonu na komunikaci s konkrétním řešením zřizovacího serveru používají jako volné registry řetězců. Parametry GPP_* jsou ve výchozím nastavení prázdné. Je možné je nakonfigurovat tak, aby obsahovaly různé hodnoty, například tyto:

  • Šifrovací klíče

  • Adresy URL

  • Informace o stavu vícefázového zřizování.

  • Šablony požadavku Post

  • Mapy aliasů názvů proměnných

  • Částečné hodnoty řetězců, které se ve výsledku zkombinují do úplných hodnot parametrů.

Parametry GPP_* jsou k dispozic k rozšíření makrem v rámci ostatních parametrů zřizování. Pro tento účel se k identifikaci obsahu proměnných GPP_A až GPP_P používají názvy maker obsahují jedno velké písmeno (A až P). Kromě toho dvoupísmenné názvy maker SA až SD určují parametry GPP_SA až GPP_SD jako speciální případy při použití v následujících možnostech adresy URL:

key, uid a pwd

Tyto parametry lze v pravidlech zřizování a upgradu použít jako proměnné. Odkazuje se na ně tím, že se před název proměnné přidá znak „$“, např. $GPP_A.

Povolení parametrů

Parametry Provision_Enable a Upgrade_Enable řídí všechny operace resynchronizace profilu a upgradu firmwaru. Tyto parametry řídí resynchronizace a upgrady nezávisle na sobě. Tyto parametry také řídí příkazy adresy URL resynchronizace a upgradu, které jsou zadávány prostřednictvím webového serveru pro správu. Oba tyto parametry jsou ve výchozím nastavení Ano.

Parametr Resync_From_SIP řídí požadavky na operace resynchronizace. Událost SIP NOTIFY je odeslána ze serveru proxy poskytovatele služeb do telefonu. Pokud je tato možnost zapnutá, server proxy může vyžádat resynchronizaci. Proto server proxy zařízení odešle zprávu SIP NOTIFY, která obsahuje hlavičku Event: resync.

Zařízení zareaguje na požadavek odpovědí 401 (ověření bylo použité přihlašovací údaje zamítlo). Zařízení očekává ověřený následný požadavek, než požadavek na resynchronizaci od serveru proxy splní. Hlavičky Event: reboot_now a Event: restart_now provádějí studený a teplý restart, který může zařízení také napadnout.

Zbývající dva povolující parametry jsou Resync_On_Reset a Resync_After_Upgrade_Attempt. Tyto parametry určují, zda zařízení provede operaci resynchronizaci po softwarových restartech a po každém pokusu o upgrade.

Když je možnost Resync_On_Reset zapnutá, zařízení zavede náhodnou prodlevu po spouštění, než je proveden restart. Prodleva je náhodná doba až do hodnoty zadané v parametru Resync_Random_Delay (v sekundách). Ve fondu telefonů, které se spouští současně, tato prodleva u jednotlivých jednotek zavádí rozptyl času zahájení požadavků resynchronizace. Tato funkce se může hodit ve velkém nasazení do domácností v případě místního výpadku dodávky energie.

Spouštěcí události

Telefon umožňuje provádět resynchronizaci v určených intervalech nebo v konkrétní čas.

Resynchronizace v zadaných intervalech

Telefon je navržen tak, aby se pravidelně resynchronizoval se zřizovacím serverem. Interval resynchronizace je konfigurován parametrem Resync_Periodic (v sekundách). Pokud je tato hodnota prázdná, zařízení se pravidelně neresynchronizuje.

K resynchronizaci obvykle dochází, když jsou hlasové linky nečinné. Pokud je ve chvíli naplánované resynchronizace aktivní hlasová linka, telefon resynchronizaci odloží do doby, než je linka opět nečinná. Resynchronizace může způsobit změnu hodnot parametrů konfigurace.

Resynchronizace může selhat, protože telefon nedokáže načíst ze serveru profil, stažený soubor je poškozený nebo došlo k interní chybě. Zařízení se pokusí znovu resynchronizovat po době, která je určena parametrem Resync_Error_Retry_Delay (v sekundách). Pokud je parametr Resync_Error_Retry_Delay nastaven na 0, zařízení se po neúspěšném pokusu o resynchronizaci nepokusí ji provést znovu.

Pokud se nezdaří upgrade, je opakovaný pokus proveden po sekundách nastavených v parametru Upgrade_Error_Retry_Delay.

K podmíněnému spuštění resynchronizace jsou k dispozici dva konfigurovatelné parametry: Resync_Trigger_1 a Resync_Trigger_2. Každý parametr lze naprogramovat pomocí podmíněného výrazu, který podléhá rozšíření makra. Když interval resynchronizace vyprší (čas na další resynchronizaci), spouštěče, pokud jsou nastavené, zabrání resynchronizaci, pokud není alespoň jeden z nich vyhodnocen jako pravdivý.

V následujícím příkladu je resynchronizace spuštěna podmíněně. V tomto příkladu poslední pokus o upgrade telefonu vypršel před více než 5 minutami (300 sekund) a od posledního pokusu o resynchronizaci uplynulo alespoň 10 minut (600 sekund).

$UPGTMR gt 300 and $PRVTMR ge 600

Resynchronizace v zadaných časech

Parametr Resync_At umožňuje telefonu provádět resynchronizaci v určených intervalech nebo v konkrétní čas. Tento parametr využívá k zadání času 24hodinový formát (hhmm).

Parametr Resync_At_Random_Delay umožňuje telefonu provádět resynchronizaci po neurčité časové prodlevě. Tento parametr využívá k zadání času formát kladného celého čísla.

Je třeba předcházet zaplavení serveru požadavky na resynchronizaci od více telefonů, které jsou nastaveny na resynchronizaci ve stejný čas. Proto telefon spustí resynchronizaci až 10 minut po zadaném čase.

Pokud je například čas resynchronizace nastaven na 1000 (10.00), telefon spustí resynchronizaci kdykoliv mezi 10:00 a 10:10.

Ve výchozím nastavení je tato možnost vypnutá. Pokud je parametr Resync_At zřízen, je ignorován parametr Resync_Periodic.

Konfigurovatelné plány

Můžete nakonfigurovat plány pravidelných resynchronizací a zadat intervaly opakování při selhání resynchronizace a upgradu pomocí následujících parametrů:

  • Resync_Periodic

  • Resync_Error_Retry_Delay

  • Upgrade_Error_Retry_Delay

Do každého parametru je možné zadat jednu hodnotu prodlevy (v sekundách). Nová rozšířená syntax umožňuje využít seznam po sobě jdoucích prvků prodlevy oddělených čárkami. Poslední prvek v řadě se automaticky opakuje donekonečna.

Nebo můžete použít znaménko plus a zadat jinou číselnou hodnotu, která znamená náhodnou prodlevu navíc.

Příklad 1

V tomto příkladu se telefon pravidelně resynchronizuje každé 2 hodiny. Pokud dojde k selhání resynchronizace, zařízení pokus opakuje v těchto intervalech: 30 minut, 1 hodina, 2 hodiny, 4 hodiny. Zařízení pokusy opakuje ve 4hodinových intervalech, dokud se resynchronizace nepodaří.

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

Příklad 2

V tomto příkladu se zařízení pravidelně resynchronizuje každou hodinu (plus až 10minutová náhodná prodleva navíc). V případě selhání resynchronizace zařízení pokus opakuje v těchto intervalech: 30 minut (plus až 5 minut). 1 hodina (plus až 10 minut), 2 hodiny (plus až 15 minut). Zařízení pokusy opakuje ve 2hodinových (plus až 15 minut) intervalech, dokud se resynchronizace nepodaří.

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

Příklad 3

Pokud se v tomto příkladu nepodaří provést upgrade, zařízení se pokusí ho provést za 30 minut, poté znovu po jedné hodině a poté po dvou hodinách. Pokud se provedení upgradu nepodaří ani tehdy, zařízení pokusy opakuje každé čtyři až pět hodin, dokud se upgrade nepodaří.

Upgrade_Error_Retry_Delay  =  1800,3600,7200,14400+3600

Pravidla profilu

Telefon má více parametrů profilu vzdálené konfigurace (Profile_Rule*). Při každé operaci resynchronizace je tak možné načíst více souborů, které spravují různé servery.

V nejjednodušším scénáři se zařízení pravidelně resynchronizuje s jedním profilem na centrálním serveru, který aktualizuje všechny důležité interní parametry. Nebo lze profil rozdělit na dva různé soubory. Jeden soubor je společný pro všechny telefony v nasazení. Každý účet má zvláštní, jedinečný soubor. Šifrovací klíče a údaje certifikátu může dodávat ještě jiný profil uložený na zvláštním serveru.

Vždy, když má dojít k operaci resynchronizace, telefon čtyři parametry Profile_Rule* vyhodnotí v následujícím pořadí:

  1. Profile_Rule

  2. Profile_Rule_B

  3. Profile_Rule_C

  4. Profile_Rule_D

Každé vyhodnocení může vést k načtení profilu ze vzdáleného zřizovacího serveru s možnou aktualizací několika interních parametrů. Pokud se vyhodnocení nezdaří, je resynchronizace přerušena a opakována od začátku po prodlevě určené v parametru Resync_Error_Retry_Delay (v sekundách). Pokud se vyhodnocení podaří, zařízení počká tolik sekund, kolik je uvedeno v parametru Resync_Periodic, a poté zahájí další resynchronizaci.

Obsah jednotlivých parametrů Profile_Rule* sestává ze sady alternativ. Alternativy se oddělují znakem |. Jednotlivé alternativy sestávají z podmíněného výrazu, výrazu přiřazení, adresy URL profilu a všech přiřazených možností adresy URL. Všechny tyto komponenty jsou u všech alternativ volitelné. Toto jsou platné kombinace a pořadí, ve kterém musí být případně uvedeny:

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

Ve všech parametrech Profile_Rule* musí všechny alternativy kromě poslední obsahovat podmíněný výraz. Tento výraz je vyhodnocen a zpracován následovně:

  1. Podmínky jsou vyhodnocovány zleva doprava, dokud se nenarazí na takovou, která se vyhodnotí jako pravda (nebo dokud se nenajde alternativa, která podmíněný výraz nemá).

  2. V případě zadání jsou vyhodnoceny všechny doprovodné výrazy přiřazení.

  3. Pokud je jako součást dané alternativy zadána adresa URL, je proveden pokus o stažení profilu, který je na zadané adrese URL umístěn. Systém se pokusí příslušně aktualizovat interní parametry.

Pokud mají všechny alternativy podmíněný výraz a ani jeden není vyhodnocen jako pravda (nebo pokud je celé pravidlo profilu prázdné), je celý parametr Profile_Rule* přeskočen. Je vyhodnocen následující parametr pravidla profilu v pořadí.

Příklad 1

V tomto příkladu je provedena bezpodmínečná resynchronizace s profilem na zadané adrese URL a je odeslán požadavek HTTP GET na vzdálený zřizovací server:

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

Příklad 2

V tomto příkladu se zařízení resynchronizuje se dvěma různými adresami URL v závislosti na stavu registrace na řádku 1. V případě ztráty registrace zařízení provede příkaz HTTP POST do skriptu CGI. Zařízení odešle obsah proměnné GPP_A rozšířené makrem, která může poskytnout další informace o stavu zařízení:

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

Příklad 3

V tomto příkladu se zařízení resynchronizuje na stejný server. V případě, že v jednotce není nainstalovaný certifikát, zařízení poskytne další informace (u starších jednotek před verzí 2.0).

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

Příklad 4

V tomto příkladu je linka 1 zakázána, dokud proměnná GPP_A není první adresou URL nastavena na Zřízeno. Poté se resynchronizuje s druhou adresou URL:

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

Příklad 5

V tomto příkladu se předpokládá, že profil, který server vrátí, obsahuje značky elementu XML. Tyto značky musí pomocí aliasů uložených v proměnné GPP_B být přemapovány na odpovídající názvy parametrů:

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

Resynchronizace se obvykle považuje za neúspěšnou, pokud není ze serveru vyžádaný profil přijat. Pomocí parametru Resync_Fails_On_FNF je možné toto výchozí chování změnit. Když je parametr If Resync_Fails_On_FNF nastaven na Ne, zařízení přijme odpověď od serveru „file-not-found“ jako úspěšnou resynchronizaci. Výchozí hodnota parametru Resync_Fails_On_FNF je Ano.

Pravidlo upgradu

Pravidlo upgradu slouží jako pokyn zařízení, aby aktivovalo načtení a v případě potřeby informace, kde načtení získat. Pokud načtení v zařízení již je, zařízení se ho nepokusí získat. Když je požadované načtení v neaktivním oddílu, na platnosti umístění načtení tedy nezáleží.

Upgrade_Rule určuje načtení firmwaru, které bude staženo a použito, pokud se liší od aktuálního načtení a pokud není omezeno podmíněným výrazem nebo nastavením proměnné Upgrade_Enable na Ne.

Telefon poskytuje jeden konfigurovatelný parametr vzdáleného upgradu, Upgrade_Rule. Tento parametr má syntax obdobnou jako parametry pravidla profilu. Možnosti URL nejsou u upgradů podporovány, ale podmíněné výrazy a výrazy přiřazení použít lze. Pokud jsou používány podmíněné výrazy, je parametr možné naplnit více možnostmi, které se oddělují znakem |. Syntaxe pro jednotlivé alternativy je následující:

[ conditional-expr ] [ assignment-expr ] URL

Stejně jako u parametrů Profile_Rule* i u parametrů Upgrade_Rule se vyhodnocují jednotlivé varianty, dokud není splněn podmíněný výraz nebo nějaká alternativa žádný podmíněný výraz nemá. V případě zadání je vyhodnocen doprovodný výraz přiřazení. Poté je proveden pokus o upgrade na zadané adrese URL.

Pokud proměnná Upgrade_Rule obsahuje adresu URL bez podmíněného výrazu, zařízení se upgraduje na obraz firmwaru na zadané adrese URL. Po rozšíření makra a vyhodnocení pravidla se zařízení znovu nepokusí o upgrade, dokud není pravidlo upraveno nebo není změněna skutečná kombinace protokol + server + port + cesta k souboru.

Při pokusu o upgrade firmwaru zařízení na začátku procesu vypne zvuk a na konci se restartuje. Zařízení automaticky zahájí upgrade, který je řízený obsahem proměnné Upgrade_Rule, jen v případě, kdy jsou všechny hlasové linky aktuálně neaktivní.

Například:

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

V tomto příkladu Upgrade_Rule aktualizuje firmware na obraz, který je uložený na zadané adrese URL.

Zde je další příklad:

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

V tomto příkladu je zařízení dán příkaz načíst jeden ze dvou obrazů podle obsahu obecného parametru GPP_F.

Parametry zřizování

Parametry zřizování najdete na kartě Zřizování na webové stránce telefonu.

Parametry profilu konfigurace

V následující tabulce je definována funkce a použití jednotlivých parametrů v části Parametry profilu konfigurace karty Zřizování.

Tabulka 1. Parametry profilu konfigurace

Název parametru

Popis a výchozí hodnota

Povolit zřizování

Řídí všechny činnosti resynchronizace nezávisle na činnostech upgradu firmwaru. Pokud chcete povolit vzdálené zřizování, nastavte hodnotu Ano.

Výchozí hodnota je Ano.

Resynchronizace při restartování

Resynchronizace se spustí po každém restartování kromě restartování způsobených aktualizacemi parametru a upgrady firmwaru.

Výchozí hodnota je Ano.

Náhodná prodleva resynchronizace

Náhodná prodleva následující po spouštěcí sekvenci před provedením resetování udaná v sekundách. Ve fondu zařízení IP telefonie, u kterých je naplánováno současné spuštění, se tímto zavádí rozptyl v časech, kdy jednotlivé jednotky zřizovacímu serveru odešlou požadavek na resynchronizaci. Tato funkce se může hodit ve velkém nasazení do domácností v případě místního výpadku dodávky energie.

Hodnota tohoto pole musí být celé číslo v rozmezí 0 až 65 535.

Výchozí hodnota je 2.

Resynchronizace v (HHmm)

Čas (HHmm), kdy se zařízení se zřizovacím serverem resynchronizuje.

Hodnota tohoto pole musí být čtyřmístné číslo v rozmezí 0000 až 2 400 pro indikaci času ve formátu HHmm. Například 0959 znamená 09:59.

Výchozí hodnota je prázdná. Pokud je hodnota neplatná, parametr se ignoruje. Pokud je tento parametr nastaven na platnou hodnotu, je parametr Pravidelná resynchronizace ignorován.

Resynchronizace po náhodné prodlevě

Brání přetížení zřizovacího serveru, když se najednou spustí velký počet zařízení.

Aby se zabránilo zaplavení serveru požadavky na resynchronizaci z více telefonů, telefon se resynchronizuje v rozsahu hodin a minut a hodin a minut plus náhodná prodleva (hhmm, hhmm + náhodná_prodleva). Pokud je například náhodná prodleva = (resynchronizace po náhodné prodlevě + 30)/60 minut, pro výpočet konečného intervalu náhodné_prodlevy je vstupní hodnota v sekundách převedena na minuty a je zaokrouhlena na následující minutu.

Rozmezí platných hodnot je 0 až 65 535.

Pokud je hodnota menší než 600, je náhodné vnitřní zpoždění v rozmezí 0 až 600.

Výchozí hodnota je 600 sekund (10 minut).

Pravidelná resynchronizace

Časový interval mezi pravidelnými resynchronizacemi se zřizovacím serverem. Přiřazený časovač resynchronizace je aktivní až po první úspěšné resynchronizaci se serverem.

Platné formáty:

  • Celé číslo

    Příklad: Vstup 3000 značí, že další resynchronizace proběhne za 3 000 sekund.

  • Více celých čísel

    Příklad: Vstup 600,1200,300 znamená, že první resynchronizace nastane za 600 sekund, druhá resynchronizace za 1 200 sekund po první a třetí resynchronizace za 300 sekund po druhé.

  • Časový rozsah

    Příklad: Vstup 2400+30 znamená, že další resynchronizace nastane za 2 400 až 2 430 sekund po úspěšné resynchronizaci.

Pokud chcete pravidelnou resynchronizaci zakázat, nastavte tento parametr na nulu.

Výchozí hodnota je 3600 sekund.

Prodleva opakování po chybě resynchronizace

Pokud se resynchronizace nezdaří, protože zařízení IP telefonie nedokázalo ze serveru načíst profil, stažený soubor je poškozený nebo došlo k interní chybě, zařízení se po době v sekundách pokusí provést resynchronizaci znovu.

Platné formáty:

  • Celé číslo

    Příklad: Vstup 300 značí, že další pokus o resynchronizaci proběhne za 300 sekund.

  • Více celých čísel

    Příklad: Vstup 600,1200,300 znamená, že první pokus o resynchronizaci proběhne za 600 sekund po selhání, druhý pokus za 1 200 sekund po selhání prvního pokusu a třetí pokus za 300 po selhání druhého pokusu.

  • Časový rozsah

    Příklad: Vstup 2400+30 znamená, že další pokus proběhne za 2 400 až 2 430 sekund po neúspěšném pokusu o resynchronizaci.

Pokud je prodleva nastavena na 0, zařízení se po neúspěšném pokusu o resynchronizaci nepokusí ji provést znovu.

Prodleva nucené resynchronizace

Maximální prodleva (v sekundách), po kterou telefon čeká, než provede resynchronizaci.

Zařízení neprovede resynchronizaci, když je některá telefonní linka aktivní. Protože resynchronizace může trvat několik sekund, je před resynchronizací žádoucí počkat, než je zařízení po určitou dobu nečinné. Díky tomu může uživatel bez přerušení provádět více hovorů po sobě.

Zařízení má časovač, který začíná odpočet od chvíle, kdy jsou všechny linky nečinné. Tento parametr je výchozí hodnota čítače. Události resynchronizace jsou odloženy, dokud tento čítač neklesne na nulu.

Rozmezí platných hodnot je 0 až 65 535.

Výchozí hodnota je 14 400 sekund.

Resynchronizace ze SIP

Umožňuje spuštění resynchronizace prostřednictvím zprávy SIP NOTIFY.

Výchozí hodnota je Ano.

Resynchronizace po pokusu o upgrade

Zapíná a vypíná operaci resynchronizace po provedení upgradu. Pokud je zvolena možnost Ano, synchronizace se provede.

Výchozí hodnota je Ano.

Spouštěč resynchronizace 1, Spouštěč resynchronizace 2

Konfigurovatelné podmínky spuštění resynchronizace. Když je logická rovnice v těchto parametrech vyhodnocena jako PRAVDA, spustí se resynchronizace.

Výchozí hodnota je prázdná.

Resynchronizace se nezdaří při FNF

Resynchronizace se považuje za neúspěšnou, pokud není ze serveru přijat vyžádaný profil. To lze změnit pomocí tohoto parametru. Když je parametr nastaven na ne, zařízení bere odpověď file-not-found od serveru jako úspěšnou resynchronizaci.

Výchozí hodnota je Ano.

Pravidlo profilu

Pravidlo profilu B

Pravidlo profilu C

Pravidlo profilu D

Každé pravidlo profilu informuje telefon o zdroji, ze kterého lze získat profil (konfigurační soubor). Během každé resynchronizaci telefon postupně použije všechny profily.

Výchozí nastavení: /$PSN.xml

Pokud používáte na konfigurační soubory šifrování AES-256-CBC, zadejte následujícím způsobem šifrovací klíč s klíčovým slovem --key:

[--key <šifrovací klíč>]

Šifrovací klíč může být volitelně ve dvojitých uvozovkách (").

Použití možnost DHCP

Možnosti DHCP oddělené čárkami používané k načtení firmwaru a profilů.

Výchozí hodnota je 66,160,159,150,60,43,125.

Zpráva protokolu při požadavku

Tento parametr obsahuje zprávu, která se odešle na server syslog na začátku pokusu o resynchronizaci.

Výchozí hodnota je $PN $MAC –Requesting % $SCHEME://$SERVIP:$PORT$PATH

Zpráva protokolu při úspěchu

Zpráva syslog vydaná po úspěšném dokončení resynchronizace.

Výchozí hodnota je $PN $MAC –Successful Resync % $SCHEME://$SERVIP:$PORT$PATH -- $ERR

Zpráva protokolu při selhání

Zpráva syslog vydaná po neúspěšném dokončení resynchronizace.

Výchozí hodnota je $PN $MAC -- Resync failed: $ERR.

Uživatelsky konfigurovatelná resynchronizace

Umožňuje uživateli resynchronizovat telefon z obrazovky IP telefonu.

Výchozí hodnota je Ano.

Parametry upgradu firmwaru

V následující tabulce je definována funkce a použití jednotlivých parametrů v části Upgrade firmwaru karty Zřizování.

Tabulka 2. Parametry upgradu firmwaru

Název parametru

Popis a výchozí hodnota

Povolit upgrade

Povoluje operace upgradu firmwaru nezávisle na činnostech resynchronizace.

Výchozí hodnota je Ano.

Nakonfigurujte tento parametr jednou z metod:

  • V konfiguračním souboru telefonu s XML(cfg.xml) zadejte řetězec v tomto formátu: <Upgrade_Enable ua="na">Yes</Upgrade_Enable>

  • Na webové stránce správy telefonu nastavte toto pole na hodnotu Ano nebo Ne.

Prodleva opakování při chybě upgradu

Interval opakování upgradu (v sekundách) použitý v případě selhání upgradu. Zařízení má časovač chyby upgradu firmwaru, který se aktivuje po neúspěšném pokusu o upgrade firmwaru. Časovač se inicializuje na hodnotu v tomto parametru. Další pokus o upgrade firmwaru proběhne, když čítač dojde na nulu.

Výchozí hodnota je 3600 sekund.

Nakonfigurujte tento parametr jednou z metod:

  • V konfiguračním souboru telefonu s XML(cfg.xml) zadejte řetězec v tomto formátu: <Upgrade_Error_Retry_Delay ua="na">3600</Upgrade_Error_Retry_Delay>

  • Na webové stránce správy telefonu nastavte hodnotu.

Pravidlo upgradu

Skript upgradu firmwaru, který definuje podmínky upgradu a přiřazené adresy URL firmwaru. Využívá se v něm stejná syntax jako v pravidle profilu.

K zadání pravidla profilu použijte tento formátů

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

Příklad: 

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

Pokud není zadán žádný protokol, předpokládá se TFTP. Pokud není zadán název serveru, použije se jako název serveru hostitel, který požaduje adresu URL. Pokud není zadán žádný port, použije se výchozí port (69 pro TFTP, 80 pro HTTP nebo 443 pro HTTPS).

Výchozí hodnota je prázdná.

Nakonfigurujte tento parametr jednou z metod:

  • V konfiguračním souboru telefonu s XML(cfg.xml) zadejte řetězec v tomto formátu: <Upgrade_Rule ua="na">http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads</Upgrade_Rule>

  • Na webové stránce správy telefonu zadejte cestu, kde je uložen zavedený soubor.

Zpráva do protokolu při požadavku na upgrade

Zpráva syslog vydaná na začátku pokusu o upgrade firmwaru.

Výchozí hodnota: $PN $MAC -- Requesting upgrade $SCHEME://$SERVIP:$PORT$PATH

Nakonfigurujte tento parametr jednou z metod:

  • Do konfiguračního souboru telefonu s XML(cfg.xml) zadejte řetězec v tomto formátu: <Log_Upgrade_Request_Msg ua="na">$PN $MAC -- Žádost o upgrade $SCHEME://$SERVIP:$PORT$PATH</Log_Upgrade_Request_Msg>

  • Na webové stránce správy telefonu upravte parametr podle potřeby.

Zpráva do protokolu při úspěšném upgradu

Zpráva syslog vydaná po úspěšném dokončení upgradu firmwaru.

Výchozí hodnota je $PN $MAC -- Successful upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERR

Nakonfigurujte tento parametr jednou z metod:

  • Do konfiguračního souboru telefonu s XML(cfg.xml) zadejte řetězec v tomto formátu: <Log_Upgrade_Success_Msg ua="na">$PN $MAC -- Úspěšný upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERR</Log_Upgrade_Success_Msg>

  • Na webové stránce správy telefonu upravte parametr podle potřeby.

Zpráva do protokolu při neúspěšném upgradu

Zpráva syslog vydaná po neúspěšném dokončení upgradu firmwaru.

Výchozí hodnota je $PN $MAC -- Upgrade failed: $ERR

Nakonfigurujte tento parametr jednou z metod:

  • V konfiguračním souboru telefonu s XML(cfg.xml) zadejte řetězec v tomto formátu: <Log_Upgrade_Failure_Msg ua="na">$PN $MAC -- Upgrade se nezdařil: $ERR</Log_Upgrade_Failure_Msg>

  • Na webové stránce správy telefonu upravte parametr podle potřeby.

Sdílení firmwaru s druh. stranou

Povolí nebo zakáže funkci PFS (Peer Firmware Sharing). Funkci povolte nebo zakažte zvolením možnosti Ano nebo Ne.

Výchozí hodnota: Ano

Nakonfigurujte tento parametr jednou z metod:

  • V konfiguračním souboru telefonu s XML(cfg.xml) zadejte řetězec v tomto formátu: <Peer_Firmware_Sharing ua="na">Yes</Peer_Firmware_Sharing>

  • Na webové stránce správy telefonu nastavte toto pole na hodnotu Ano nebo Ne.

Server protokolování sdílení firmwaru s druhou stranou

Uvádí adresu IP a port, na které je odeslána zpráva UDP.

Příklad: 10.98.76.123:514, kde 10.98.76.123 je adresa IP a 514 číslo portu.

Nakonfigurujte tento parametr jednou z metod:

  • Do konfiguračního souboru telefonu s XML(cfg.xml) zadejte řetězec v tomto formátu: <Peer_Firmware_Sharing_Log_Server ua="na">10.98.76.123:514</Peer_Firmware_Sharing_Log_Server>

  • Na webové stránce správy telefonu zadejte adresu protokolovacího serveru.

Obecné parametry

V následující tabulce je definována funkce a použití jednotlivých parametrů v části Obecné parametry karty Zřizování.

Tabulka 3. Obecné parametry

Název parametru

Popis a výchozí hodnota

GPP A – GPP P

Obecné parametry GPP_* se při konfiguraci telefonu na komunikaci s konkrétním řešením zřizovacího serveru používají jako volné registry řetězců. Je možné je nakonfigurovat tak, aby obsahovaly různé hodnoty, například tyto:

  • Šifrovací klíče.

  • Adresy URL.

  • Informace o stavu vícefázového zřizování.

  • Šablony požadavku Post.

  • Mapy aliasů názvů proměnných.

  • Částečné hodnoty řetězců, které se ve výsledku zkombinují do úplných hodnot parametrů.

Výchozí hodnota je prázdná.

Proměnné rozšíření makra

Některé proměnné makra jsou rozpoznávány v rámci těchto parametrů zřizování:

  • Profile_Rule

  • Profile_Rule_*

  • Resync_Trigger_*

  • Upgrade_Rule

  • Log_*

  • GPP_* (za určitých podmínek)

V rámci těchto parametrů jsou rozpoznávány a rozšiřovány typy syntaxe $JMENO nebo $(JMENO).

Podřetězce proměnné makra lze zadat pomocí notace $(JMENO:p) a $(JMENO:p:q), kde p a q jsou nezáporná celá čísla (dostupné od verze 2.0.11). Výsledné rozšíření makra je podřetězec začínající p-tým znakem s délkou q (nebo do konce řetězce, pokud hodnota q není zadána). Pokud například GPP_A obsahuje ABCDEF, pak se $(A:2) rozšíří na CDEF a $(A:2:3) se rozšíří na CDE.

Nerozpoznaný název se nepřekládá a podoba $JMENO nebo $(JMENO) zůstává v hodnotě parametru po rozšíření beze změny.

Název parametru

Popis a výchozí hodnota

$

Zápis $$ se rozšíří na jeden znak $.

A až P

Nahrazuje se obsahem obecných parametrů GPP_A až GPP_P.

SA až SD

Nahrazuje se obsahem parametrů pro zvláštní účel GPP_SA až GPP_SD. V těchto parametrech jsou uloženy klíče a hesla používaná při zřizování.

$SA až $SD se považují za argumenty volitelného kvalifikátoru adresy URL resynchronizace, --key

MA

Adresa MAC v malých šestnáctkových číslech, například 000e08aabbcc.

MAU

Adresa MAC ve velkých šestnáctkových číslech, například 000E08AABBCC.

MAC

Adresa MAC v malých šestnáctkových číslech a se středníky oddělujícími páry šestnáctkových číslic. Například 00:0e:08:aa:bb:cc.

PN

Název produktu. Například CP-8875, DP-9851, DP-9871.

PSN

Číslo řady produktu. Například V03.

SN

Řetězec sériového čísla. Například 88012BA01234.

CCERT

Stav klientského certifikátu SSL: nainstalovaný, nebo nenainstalovaný.

IP

Adresa IP telefonu v místní podsíti. Například 192.168.1.100.

EXTIP

Externí adresa IP telefonu, jak je vidět z internetu. Například 66.43.16.52.

SWVER

Řetězec verze softwaru. Například:

PHONEOS.3-1-1-0104-37

HWVER

Řetězec verze hardwaru. Například 2.0.1

PRVST

Stav zřizování (číselný řetězec):

-1 = explicitní požadavek na resynchronizaci

0 = resynchronizace při spuštění

1 = pravidelná resynchronizace

2 = resynchronizace se nezdařila, opakování pokusu

UPGST

Stav upgradu (číselný řetězec):

1 = první pokus o upgrade

2 = upgrade se nezdařil, opakování pokusu

UPGERR

Zpráva výsledku (ERR) předchozího pokusu o upgrade, například „nezdařilo se provést http_get“.

PRVTMR

Počet sekund od posledního pokusu o resynchronizaci.

UPGTMR

Počet sekund od posledního pokusu o upgrade.

REGTMR1

Počet sekund od registrace ztráty linky 1 se serverem SIP.

REGTMR2

Počet sekund od registrace ztráty linky 2 se serverem SIP.

UPGCOND

Starší název makra.

SCHEME

Protokol pro přístup k souboru, TFTP, HTTP nebo HTTPS, zjištěný po analýze adresy URL resynchronizace nebo upgradu.

SERV

Název hostitele serveru cíle požadavku zjištěný po analýze adresy URL resynchronizace nebo upgradu.

SERVIP

Adresa IP serveru cíle požadavku zjištěná po analýze adresy URL resynchronizace nebo upgradu, možná po zjištění na serveru DNS.

PORT

Port UDP/TCP cíle požadavku zjištěný po analýze adresy URL resynchronizace nebo upgradu.

PATH

Cesta k souboru cíle požadavku zjištěný po analýze adresy URL resynchronizace nebo upgradu.

ERR

Zpráva výsledku pokusu o resynchronizaci nebo upgrade. Hodí se pouze při generování zpráv syslog výsledku. Hodnota se v případě pokusů o upgrade uchovává v proměnné UPGERR.

UIDn

Obsah parametru konfigurace UserID linky n.

EMS

Stav Extension Mobility

MUID

ID uživatele Extension Mobility

MPWD

Heslo Extension Mobility

Kódy interních chyb

Telefon k umožnění konfigurace definuje několik kódů interních chyb (X00–X99), čímž poskytuje lepší kontrolu nad chováním jednotky za určitých chybových stavů.

Tabulka 4. Kódy interních chyb

Název parametru

Popis a výchozí hodnota

X00

Chyba přenosové vrstvy nebo (ICMP) při odesílání požadavku SIP.

X20

Požadavek SIP při čekání na odpověď vypršel.

X40

Obecná chyba protokolu SIP (například nepřijatelný kodek v SDP ve zprávách 200 a ACK nebo vypršení platnosti při čekání na ACK).

X60

Vytočené číslo není podle daného plánu číslování platné.