Типи параметрів підготовки

У цьому розділі описано параметри підготовки, упорядковані відповідно до функцій.

Параметри загального призначення

Параметри загального призначення GPP_* ("Вхід під обліковим записом адміністратора" > "Розширений" > "Голосовий зв’язок" > "Підготовка") використовуються як вільні регістри рядків під час налаштування телефону для взаємодії з певним рішенням сервера підготовки. Параметри GPP_* за замовчуванням пусті. Їх можна налаштувати так, щоб вони містили різноманітні значення, зокрема такі:

  • ключі шифрування;

  • URL-адреси

  • інформація про статус багатоетапної підготовки;

  • шаблони запитів POST;

  • карти псевдонімів імені параметра;

  • часткові значення рядків, зрештою об’єднані в повні значення параметрів.

Параметри GPP_* доступні для розкриття макросу в інших параметрах підготовки. Для цього достатньо імен макросів з однієї літери у верхньому регістрі (від A до P), щоб ідентифікувати зміст параметрів від GPP_A до GPP_P. Крім того, імена макросів із двох літер у верхньому регістрі від SA до SD ідентифікують параметри GPP_SA до GPP_SD як особливий випадок, коли вони використовуються як аргументи таких варіантів URL:

key, uid і pwd

Ці параметри можна використовувати як змінні в правилах підготовки та оновлення. На них посилаються, додаючи перед назвою змінної символ "$", наприклад $GPP_A.

Увімкнення параметрів

Параметри Provision_Enable і Upgrade_Enable регулюють усі операції повторної синхронізації профілю та оновлення мікропрограми. Ці параметри регулюють повторну синхронізацію та оновлення незалежно один від одного. Ці параметри також регулюють URL-команди повторної синхронізації та оновлення, які видаються через вебсервер адміністрування. Для обох цих параметрів за замовчуванням задано значення Yes.

Параметр Resync_From_SIP регулює запити на операції повторної синхронізації. Подія SIP NOTIFY надсилається із проксі-сервера постачальника послуг на телефон. Якщо цей параметр увімкнено, проксі-сервер може надіслати запит на повторну синхронізацію. Для цього проксі-сервер надсилає на пристрій повідомлення SIP NOTIFY, яке містить заголовок Event: resync.

Пристрій оскаржує запит і надає відповідь 401 (відмовлено в авторизації через використані облікові дані). Пристрій очікує на автентифікований наступний запит, перш ніж виконати запит на повторну синхронізацію від проксі-сервера. Заголовки Event: reboot_now і Event: restart_now виконують холодний і теплий перезапуск відповідно, які також оскаржуються.

Залишилися два параметри ввімкнення: Resync_On_Reset і Resync_After_Upgrade_Attempt. Ці параметри визначають, чи виконує пристрій операцію повторної синхронізації після перезавантаження програмного забезпечення та після кожної спроби оновлення.

Коли параметр Resync_On_Reset увімкнено, пристрій застосовує затримку випадкової тривалості від послідовності завантаження до скидання. Затримка – це випадковий час до значення, яке задає параметр Resync_Random_Delay (у секундах). У групі телефонів, які вмикаються одночасно, ця затримка розподіляє час початку надсилання запитів на повторну синхронізацію від кожного пристрою. Ця функція може бути корисною для розгортання в великих житлових масивах у разі збою електропостачання в регіоні.

Тригери

Телефон дає змогу виконувати повторну синхронізацію через конкретні проміжки часу або в конкретний час.

Повторна синхронізація через конкретні проміжки часу

У телефоні передбачена періодична повторна синхронізація із сервером підготовки. Інтервал до повторної синхронізації налаштовується в параметрі Resync_Periodic (у секундах). Якщо це значення не задати, пристрій не буде виконувати періодичну повторну синхронізацію.

Повторна синхронізація зазвичай відбувається, коли лінії голосового зв’язку перебувають у режимі очікування. Якщо на той час, коли запланована повторна синхронізація, лінія голосового зв’язку активна, телефон відкладає процедуру повторної синхронізації, доки лінія знову не перейде в режим очікування. Повторна синхронізація може призвести до зміни значень параметрів конфігурації.

Повторна синхронізація може завершитися помилкою, якщо телефон не може отримати профіль із сервера, завантажений файл пошкоджено або сталася внутрішня помилка. Пристрій намагається виконати повторну синхронізацію через проміжок часу, заданий у параметрі Resync_Error_Retry_Delay (в секундах). Якщо для параметра Resync_Error_Retry_Delay встановлено значення 0, пристрій не намагатиметься виконати повторну синхронізацію після невдалої спроби повторної синхронізації.

Якщо оновлення не буде успішним, повторна спроба виконується через проміжок часу, указаний у секундах для параметра Upgrade_Error_Retry_Delay.

Для умовного ініціювання повторної синхронізації є два настроювані параметри: Resync_Trigger_1 і Resync_Trigger_2. Кожен з них можна запрограмувати за допомогою умовного виразу, який розкривається за допомогою макросу. Коли закінчиться інтервал до повторної синхронізації (настане час наступної повторної синхронізації), тригери, якщо їх встановлено, запобігатимуть повторній синхронізації, якщо один або кілька тригерів не будуть оцінені як істинні.

У наведеному нижче прикладі виконання умови ініціює повторну синхронізацію. У прикладі від останньої спроби оновлення телефона минуло понад 5 хвилин (300 секунд), а від останньої спроби повторної синхронізації минуло принаймні 10 хвилин (600 секунд).

$UPGTMR gt 300 and $PRVTMR ge 600

Повторна синхронізація в конкретний час

Параметр Resync_At дає телефону змогу виконати повторну синхронізацію в конкретний час. У цьому параметрі використовується 24-годинний формат (ггхм), щоб задати час.

Параметр Resync_At_Random_Delay дає телефону змогу виконати повторну синхронізацію з невизначеною затримкою. Щоб задати час, у цьому параметрі використовується формат цілого додатного числа.

Слід уникати надсилання до сервера надмірної кількості запитів на повторну синхронізацію з багатьох телефонів, налаштованих на повторну синхронізацію в той самий час. Для цього телефон ініціює повторну синхронізацію із затримкою до 10 хвилин від вказаного часу.

Наприклад, якщо встановити час повторної синхронізації 1000 (10:00), телефон ініціює повторну синхронізацію в будь-який час з 10:00 до 10:10.

За замовчуванням цю функцію вимкнено. Якщо надано параметр Resync_At, параметр Resync_Periodic ігнорується.

Настроювані розклади

Можна налаштувати розклади періодичної повторної синхронізації та вказати інтервали між повторними спробами у разі помилок повторної синхронізації та оновлення за допомогою таких параметрів підготовки:

  • Resync_Periodic

  • Resync_Error_Retry_Delay

  • Upgrade_Error_Retry_Delay

Кожен параметр приймає одне значення затримки (у секундах). Новий розширений синтаксис дає змогу створити список послідовних елементів затримки, розділених комами. Вважається, що останній елемент у послідовності повторюється постійно.

За бажанням можна використовувати знак плюс, щоб задати інше числове значення, яке додає випадкову додаткову затримку.

Приклад 1

У цьому прикладі телефон періодично повторно синхронізується кожні 2 години. У разі помилки повторної синхронізації пристрій повторює спроби з такими інтервалами: 30 хвилин, 1 година, 2 години, 4 години. Пристрій продовжує спроби з 4-годинними інтервалами, доки не відбудеться успішна повторна синхронізація.

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

Приклад 2

У цьому прикладі пристрій періодично повторно синхронізується щогодини (плюс додаткова випадкова затримка до 10 хвилин). У разі помилки повторної синхронізації пристрій повторює спроби через такі проміжки часу: 30 хвилин (плюс до 5 хвилин), 1 година (плюс до 10 хвилин), 2 години (плюс до 15 хвилин). Пристрій продовжує спроби з 2-годинними інтервалами (плюс до 15 хвилин), доки не відбудеться успішна повторна синхронізація.

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

Приклад 3

У цьому прикладі, якщо спроба дистанційного оновлення не була успішною, пристрій повторює спробу оновлення через 30 хвилин, потім ще раз через годину, а потім через дві години. Якщо виконати оновлення все одно не вдається, пристрій повторює спроби кожні чотири-п’ять годин, доки не відбудеться успішне оновлення.

Upgrade_Error_Retry_Delay  =  1800,3600,7200,14400+3600

Правила профілю

Телефон надає кілька параметрів профілю віддаленої конфігурації (Profile_Rule*). Таким чином, для кожної операції повторної синхронізації може надійти кілька файлів, якими керують різні сервери.

У найпростішому сценарії пристрій періодично повторно синхронізується з одним профілем на центральному сервері, який оновлює всі відповідні внутрішні параметри. Як альтернативний варіант, профіль може бути розділений на різні файли. Один файл є спільним для всіх телефонів у розгортанні. Для кожного облікового запису надається окремий унікальний файл. Ключі шифрування та інформація про сертифікати можуть надаватися ще одним профілем, що зберігається на окремому сервері.

Щоразу, коли потрібно виконати операцію повторної синхронізації, телефон послідовно оцінює чотири параметри Profile_Rule*:

  1. Profile_Rule

  2. Profile_Rule_B

  3. Profile_Rule_C

  4. Profile_Rule_D

Кожне оцінювання може привести до отримання профілю із сервера віддаленої підготовки з можливим оновленням певної кількості внутрішніх параметрів. Якщо під час оцінювання сталася помилка, послідовність повторної синхронізації переривається, а повторна спроба починається через проміжок часу, заданий параметром Resync_Error_Retry_Delay (у секундах). Якщо всі оцінювання виконані успішно, пристрій чекає на секунду, задану параметром Resync_Periodic, а потім виконує ще одну повторну синхронізацію.

Кожен параметр Profile_Rule* складається з набору альтернатив. Альтернативи розділені знаком | (вертикальна риска). Кожна альтернатива складається з умовного виразу, виразу призначення, URL-адреси профілю та будь-яких пов’язаних варіантів URL-адреси. Усі ці компоненти є необов’язковими в кожній альтернативі. Нижче наведено допустимі комбінації та порядок, у якому вони мають бути вказані, якщо вони присутні:

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

У кожному параметрі Profile_Rule* для всіх альтернатив, крім останньої, має бути умовний вираз. Цей вираз оцінюється та обробляється в такому порядку.

  1. Умови оцінюються зліва направо, доки не буде знайдено одну, оцінену як істинна (або поки не буде знайдено одну альтернативу без умовного виразу).

  2. Оцінюється будь-який супровідний вираз призначення, якщо він є.

  3. Якщо URL-адресу вказано як частину цієї альтернативи, робиться спроба завантажити профіль, розташований за вказаною URL-адресою. Система намагається відповідно оновити внутрішні параметри.

Якщо всі альтернативи мають умовні вирази, і жодна не оцінена як істинна (або якщо все правило профілю пусте), то весь параметр Profile_Rule* пропускається. Оцінюється наступний параметр правила профілю в послідовності.

Приклад 1

В цьому прикладі відбувається без умови повторна синхронізація з профілем за вказаною URL-адресою та надсилається запит HTTP GET до віддаленого сервера підготовки:

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

Приклад 2

У цьому прикладі пристрій повторно синхронізується за двома різними URL-адресами, залежно від стану реєстрації лінії 1. У разі втрати реєстрації пристрій виконує команду HTTP POST до сценарію CGI. Пристрій надсилає вміст розкритого макросу GPP_A, який може надати додаткову інформацію про стан пристрою:

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

Приклад 3

У цьому прикладі пристрій повторно синхронізується з тим самим сервером. Пристрій надає додаткову інформацію, якщо в пристрої не встановлено сертифікат (для застарілих пристроїв до 2.0):

 ("$CCERT" eq "Встановлено")? https://p.tel.com/config? | https://p.tel.com/config?cisco$MAU

Приклад 4

У цьому прикладі лінію 1 вимкнено, доки для параметра GPP_A не буде встановлено значення Provisioned (Підготовлено) через першу URL-адресу. Після цього пристрій повторно синхронізується з другою URL-адресою:

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

Приклад 5

У цьому прикладі передбачається, що профіль, який надходить із сервера у відповідь на запит, містить теги елементів XML. Ці теги мають бути перепризначені на відповідні імена параметрів за допомогою карти псевдонімів, що зберігається в параметрі GPP_B:

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

Повторна синхронізація зазвичай вважається невдалою, якщо запитаний профіль не отримано від сервера. Параметр Resync_Fails_On_FNF може замінити цей порядок дій за замовчуванням. Якщо для параметра Resync_Fails_On_FNF встановлено значення No, пристрій приймає відповідь із сервера file-not-found (файл не знайдено) як успішну повторну синхронізацію. Значенням за замовчуванням для параметра Resync_Fails_On_FNF є Yes.

Правило оновлення

Правило оновлення полягає в тому, щоб дати команду пристрою активувати нове завантаження та вказати місце, звідки отримати завантаження, якщо це необхідно. Якщо завантаження вже на пристрої, він не намагатиметься отримати завантаження. Отже, дійсність розташування завантаження не має значення, коли потрібне завантаження знаходиться в неактивному розділі.

Upgrade_Rule визначає завантаження мікропрограми, яке, якщо воно відрізняється від поточного завантаження, буде завантажено та застосовано, якщо немає обмеження, установленого умовним виразом, або для параметра Upgrade_Enable не задано значення No.

Телефон надає один настроюваний параметр дистанційного оновлення Upgrade_Rule. Синтаксис цього параметра подібний до параметрів правила профілю. Варіанти URL-адреси не підтримуються для оновлень, але можна використовувати умовні вирази та вирази призначення. Якщо використовуються умовні вирази, параметр можна заповнити кількома альтернативами, розділеними знаком | (вертикальна риска). Синтаксис для кожної альтернативи такий:

[ conditional-expr ] [ assignment-expr ] URL

Як і у випадку з параметрами Profile_Rule*, параметр Upgrade_Rule оцінює кожну альтернативу, поки не буде виконано умовний вираз або не буде виявлено альтернативу без умовного виразу. Оцінюється супровідний вираз призначення, якщо його вказано. Потім виконується спроба оновлення за вказаною URL-адресою.

Якщо Upgrade_Rule містить URL-адресу без умовного виразу, пристрій оновлюється до образу мікропрограми, указаного в URL. Після розкриття макросу та оцінки правила пристрій не робить повторних спроб оновлення, доки правило не буде змінено або доки не зміниться ефективна комбінація scheme + server + port + filepath (схема + сервер + порт + шлях до файлу).

Щоб спробувати оновити мікропрограму, пристрій на початку процедури вимикає аудіо та перезавантажується в кінці процедури. Пристрій автоматично починає оновлення, яке керується вмістом параметра Upgrade_Rule, лише якщо всі лінії голосового зв’язку наразі неактивні.

Наприклад:

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

У цьому прикладі параметр Upgrade_Rule оновлює мікропрограму до образу, який зберігається за вказаною URL-адресою.

Інший приклад:

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

У цьому прикладі пристрій завантажує один з двох образів на основі вмісту параметра загального призначення GPP_F.

Параметри підготовки

Параметри підготовки можна знайти на вкладці "Підготовка" вебсторінки телефона.

Параметри профілю конфігурації

У наведеній нижче таблиці визначено функцію й використання кожного параметра в розділі "Параметри профілю конфігурації" на вкладці "Підготовка".

Таблиця 1. Параметри профілю конфігурації

Ім’я параметра

Опис і стандартне значення

Увімкнути підготовку

Регулює всі дії повторної синхронізації незалежно від дій оновлення мікропрограми. Потрібно встановити значення "Так", щоб увімкнути віддалену підготовку.

Значення за замовчуванням: "Так".

Повторна синхронізація після скидання

Ініціює повторну синхронізацію після кожного перезавантаження, за винятком перезавантажень, викликаних оновленням параметрів і оновленням мікропрограми.

Значення за замовчуванням: "Так".

Випадковий інтервал затримки повторної синхронізації

Випадкова затримка від послідовності завантаження до скидання, задана в секундах. У групі пристроїв IP-телефонії, для яких заплановано одночасне ввімкнення, це розносить у часі надсилання кожним пристроєм запиту на повторну синхронізацію на сервер підготовки. Ця функція може бути корисною для розгортання в великих житлових масивах у разі збою електропостачання в регіоні.

Значення цього поля має бути цілим числом у діапазоні від 0 до 65 535.

Значення за замовчуванням: 2.

Повторна синхронізація о (ГГхх)

Час (ГГхх), коли пристрій повторно синхронізується із сервером підготовки.

Значення в цьому полі має бути чотиризначним числом у діапазоні від 0000 до 2400, що означає час у форматі ГГхх. Наприклад, 0959 означає 9:59.

Значення за замовчуванням: пусто. Якщо значення недопустиме, параметр ігнорується. Якщо для цього параметра встановлено допустиме значення, параметр "Періодична повторна синхронізація" ігнорується.

Повторна синхронізація з випадковою тривалістю затримки

Запобігає перевантаженню сервера підготовки, коли велика кількість пристроїв вмикається одночасно.

Щоб не допустити надсилання до сервера надмірної кількості запитів на повторну синхронізацію від багатьох телефонів, телефон повторно синхронізується із затримкою в діапазоні від зазначеної кількості годин і хвилин до зазначеної кількості годин і хвилин плюс випадкова затримка (hhmm, hhmm+random_delay). Наприклад, якщо випадкова затримка = (Resync At Random Delay + 30)/60 хвилин, то введене значення в секундах перетворюється на хвилини з округленням до наступної хвилини, щоб розрахувати остаточний інтервал random_delay.

Діапазон допустимих значень: від 600 до 65 535.

Якщо значення менше 600, інтервал випадкової затримки становитиме від 0 до 600.

Значення за замовчуванням: 600 секунд (10 хвилин).

Періодична повторна синхронізація

Інтервал між періодичними процедурами повторної синхронізації із сервером підготовки. Пов’язаний таймер повторної синхронізації активується лише після першої успішної синхронізації із сервером.

Допустимі формати:

  • Ціле число

    Приклад: значення 3000 означає, що наступна повторна синхронізація відбудеться через 3000 секунд.

  • Кілька цілих чисел

    Приклад: значення 600,1200,300 означає, що перша повторна синхронізація відбудеться через 600 секунд, друга – через 1200 секунд після першої, а третя – через 300 секунд після другої.

  • Діапазон часу

    Приклад: значення 2400+30 означає, що наступна повторна синхронізація відбудеться через 2400–2430 секунд після успішної повторної синхронізації.

Установіть для цього параметра значення 0, щоб вимкнути періодичну повторну синхронізацію.

Значення за замовчуванням: 3600 секунд.

Затримка повторної спроби в разі помилки повторної синхронізації

Якщо операція повторної синхронізації не відбулася через те, що пристрою IP-телефонії не вдалось отримати профіль із сервера, або якщо завантажений файл пошкоджений, або через внутрішню помилку, пристрій намагатиметься повторно синхронізуватися через інтервал, указаний у секундах.

Допустимі формати:

  • Ціле число

    Приклад: значення 300 означає, що наступна спроба повторної синхронізації відбудеться через 300 секунд.

  • Кілька цілих чисел

    Приклад: значення 600,1200,300 означає, що перша повторна спроба відбудеться через 600 секунд після невдалої синхронізації, друга – через 1200 секунд після невдалої першої, а третя – через 300 секунд після невдалої другої.

  • Діапазон часу

    Приклад: значення 2400+30 означає, що наступна спроба повторної синхронізації відбудеться через 2400–2430 секунд після невдалої повторної синхронізації.

Якщо для затримки встановлено значення 0, пристрій більше не робитиме спроб повторної синхронізації після невдалої спроби.

Примусова затримка повторної синхронізації

Максимальний період затримки (у секундах), на який телефон робить паузу перед виконанням повторної синхронізації.

Пристрій не проводить повторну синхронізацію, поки одна з його телефонних ліній активна. Оскільки повторна синхронізація може тривати кілька секунд, перед повторною синхронізацією бажано зачекати, поки пристрій певний час побуде в режимі очікування. Це дасть змогу користувачеві здійснювати послідовні дзвінки без переривання роботи.

Пристрій має таймер, який починає зворотній відлік, коли всі його лінії переходять у режим очікування. Цей параметр є початковим значенням таймера. Події повторної синхронізації відкладаються, доки відлік часу в таймері не дійде до нуля.

Діапазон допустимих значень: від 0 до 65 535.

Значення за замовчуванням: 14 400 секунд.

Повторна синхронізація з SIP

Вмикає повторну синхронізацію, яка ініціюється повідомленням SIP NOTIFY.

Значення за замовчуванням: "Так".

Повторна синхронізація після спроби оновлення

Вмикає або вимикає операцію повторної синхронізації після будь-якого оновлення. Якщо вибрано "Так", синхронізація ініціюється.

Значення за замовчуванням: "Так".

"Тригер повторної синхронізації 1", "Тригер повторної синхронізації 2"

Настроювані умови тригера повторної синхронізації. Повторна синхронізація ініціюється, коли логічне рівняння в цих параметрах оцінюється як TRUE.

Значення за замовчуванням: (пусто).

Помилка повторної синхронізації в разі FNF

Повторна синхронізація вважається невдалою, якщо запитаний профіль не отримано від сервера. Такий порядок може бути змінено цим параметром. Коли встановлено значення "Ні", пристрій приймає відповідь від сервера file-not-found як успішну повторну синхронізацію.

Значення за замовчуванням: "Так".

Правило профілю

Правило профілю B

Правило профілю C

Правило профілю D

Кожне правило профілю інформує телефон про джерело, з якого слід отримати профіль (файл конфігурації). Під час кожної операції повторної синхронізації телефон послідовно застосовує всі профілі.

За замовчуванням: /$PSN.xml

Якщо до файлів конфігурації застосовується шифрування AES-256-CBC, укажіть ключ шифрування з ключовим словом --key:

[--key <encryption key>]

Ключ шифрування можна взяти в подвійні лапки ("), але це не обов’язково.

Параметр DHCP

Розділені комами параметри DHCP, що використовуються для отримання мікропрограми та профілів.

Значення за замовчуванням: 66,160,159,150,60,43,125.

Повідомлення журналу про запит

Параметр містить повідомлення, яке надсилається на сервер системного журналу на початку спроби повторної синхронізації.

Значення за замовчуванням: $PN $MAC –Requesting % $SCHEME://$SERVIP:$PORT$PATH.

Повідомлення журналу про успішну операцію

Повідомлення системного журналу, яке видається після успішної спроби повторної синхронізації.

Значення за замовчуванням: $PN $MAC –Successful Resync % $SCHEME://$SERVIP:$PORT$PATH -- $ERR.

Повідомлення журналу про помилку

Повідомлення системного журналу, яке видається після невдалої спроби повторної синхронізації.

Значення за замовчуванням: $PN $MAC -- Resync failed: $ERR.

Настроювана повторна синхронізація

Дає змогу користувачеві повторно синхронізувати телефон із меню на екрані IP-телефона.

Значення за замовчуванням: "Так".

Параметри оновлення мікропрограми

У наведеній нижче таблиці визначено функції та використання кожного параметра в розділі "Оновлення мікропрограми" вкладки "Підготовка".

Таблиця 2. Параметри оновлення мікропрограми

Ім’я параметра

Опис і стандартне значення

Увімкнути оновлення

Вмикає операції оновлення мікропрограми незалежно від дій повторної синхронізації.

Значення за замовчуванням: "Так".

Налаштуйте цей параметр одним із таких способів:

  • У файлі конфігурації телефону з XML(cfg.xml) введіть рядок у такому форматі: Upgrade_Enable ua="na">Так

  • На веб-сторінці адміністрування телефону встановіть для цього поля значення Так або Ні.

Затримка повторної спроби в разі помилки оновлення

Інтервал перед повторною спробою оновлення (у секундах), застосований у разі помилки оновлення. Пристрій має таймер помилки оновлення мікропрограми, який активується після невдалої спроби оновлення мікропрограми. Таймер починає відлік зі значення цього параметра. Наступна спроба оновлення мікропрограми відбувається, коли відлік часу в таймері дійде до нуля.

Значення за замовчуванням: 3600 секунд.

Налаштуйте цей параметр одним із таких способів:

  • У файлі конфігурації телефону з XML(cfg.xml) введіть рядок у такому форматі: <Upgrade_Error_Retry_Delay ua="na">3600</Upgrade_Error_Retry_Delay>

  • На веб-сторінці адміністрування телефону встановіть значення.

Правило оновлення

Сценарій оновлення мікропрограми, який визначає умови оновлення та пов’язані URL-адреси мікропрограми. У ньому використовується той самий синтаксис, що й у правилі профілю.

Використовуйте такий формат, щоб ввести правило оновлення:

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

Наприклад: 

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

Якщо протокол не вказано, передбачається, що це TFTP. Якщо ім’я сервера не вказано, головний комп’ютер, який надсилає запит URL-адреси, використовується як ім’я сервера. Якщо порт не вказано, використовується порт за замовчуванням (69 для TFTP, 80 для HTTP або 443 для HTTPS).

Значення за замовчуванням: пусто.

Налаштуйте цей параметр одним із таких способів:

  • У файлі конфігурації телефону з XML(cfg.xml) введіть рядок у такому форматі: <Upgrade_Rule ua="na">http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads</Upgrade_Rule>

  • На веб-сторінці адміністрування телефону введіть шлях до місця зберігання файлу завантаження.

Повідомлення журналу про запит на оновлення

Повідомлення системного журналу, видане на початку спроби оновлення мікропрограми.

За замовчуванням: $PN $MAC -- Requesting upgrade $SCHEME://$SERVIP:$PORT$PATH

Налаштуйте цей параметр одним із таких способів:

  • У файлі конфігурації телефону з XML(cfg.xml) введіть рядок у такому форматі: <Log_Upgrade_Request_Msg ua="na">$PN $MAC -- Запит на оновлення $SCHEME://$SERVIP:$PORT$PATH</Log_Upgrade_Request_Msg>

  • На веб-сторінці адміністрування телефону налаштуйте параметр за потреби.

Повідомлення журналу про успішне оновлення

Повідомлення системного журналу, видане після успішної спроби оновлення мікропрограми.

Значення за замовчуванням: $PN $MAC -- Successful upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERR

Налаштуйте цей параметр одним із таких способів:

  • У файлі конфігурації телефону з XML(cfg.xml) введіть рядок у такому форматі: <Log_Upgrade_Success_Msg ua="na">$PN $MAC -- Успішне оновлення $SCHEME://$SERVIP:$PORT$PATH -- $ERR</Log_Upgrade_Success_Msg>

  • На веб-сторінці адміністрування телефону налаштуйте параметр за потреби.

Повідомлення журналу про помилку оновлення

Повідомлення системного журналу, видане після невдалої спроби оновлення мікропрограми.

Значення за замовчуванням: $PN $MAC -- Upgrade failed: $ERR

Налаштуйте цей параметр одним із таких способів:

  • У файлі конфігурації телефону з XML(cfg.xml) введіть рядок у такому форматі: <Log_Upgrade_Failure_Msg ua="na">$PN $MAC -- Не вдалося оновити: $ERR</Log_Upgrade_Failure_Msg>

  • На веб-сторінці адміністрування телефону налаштуйте параметр за потреби.

Спільне використання прошивки між вузлами

Вмикає або вимикає функцію спільного використання прошивки між вузлами (PFS). Виберіть Так або Ні , щоб увімкнути або вимкнути функцію.

За замовчуванням: Так

Налаштуйте цей параметр одним із таких способів:

  • У файлі конфігурації телефону з XML(cfg.xml) введіть рядок у такому форматі: <Peer_Firmware_Sharing ua="na">Так</Peer_Firmware_Sharing>

  • На веб-сторінці адміністрування телефону встановіть для цього поля значення Так або Ні.

Сервер журналів спільного використання прошивки однорангового зв'язку

Вказує адресу IP та порт, на який надсилається повідомлення UDP.

Наприклад: 10.98.76.123:514, де 10.98.76.123 – це адреса IP, а 514 – номер порту.

Налаштуйте цей параметр одним із таких способів:

  • У файлі конфігурації телефону з XML(cfg.xml) введіть рядок у такому форматі: <Peer_Firmware_Sharing_Log_Server ua="na">10.98.76.123:514</Peer_Firmware_Sharing_Log_Server>

  • На веб-сторінці адміністрування телефону введіть адресу сервера журналів.

Параметри загального призначення

У наведеній нижче таблиці визначено функцію та використання кожного параметра в розділі "Параметри загального призначення" вкладки "Підготовка".

Таблиця 3. Параметри загального призначення

Ім’я параметра

Опис і стандартне значення

GPP A – GPP P

Параметри загального призначення GPP_* використовуються як вільні регістри рядків під час налаштування телефону для взаємодії з певним рішенням сервера підготовки. Їх можна налаштувати так, щоб вони містили різноманітні значення, зокрема такі:

  • ключі шифрування;

  • URL-адреси;

  • інформація про статус багатоетапної підготовки;

  • шаблони запитів POST;

  • карти псевдонімів імені параметра;

  • часткові значення рядків, зрештою об’єднані в повні значення параметрів.

Значення за замовчуванням: пусто.

Змінні розкриття макросів

Певні змінні макросів розпізнаються в таких параметрах підготовки:

  • Profile_Rule

  • Profile_Rule_*

  • Resync_Trigger_*

  • Upgrade_Rule

  • Log_*

  • GPP_* (за певних умов)

У цих параметрах розпізнаються та розкриваються типи синтаксису, наприклад $NAME або $(NAME).

Підрядки змінних макросів можна задати за допомогою позначення $(NAME:p) і $(NAME:p:q), де p і q – невід’ємні цілі числа (доступно у версії 2.0.11 і вище). В результаті розкриття макросу є підрядком, що починається зі зміщенням на p, довжиною q (або до кінця рядка, якщо q не задано). Наприклад, якщо параметр GPP_A містить ABCDEF, то вираз $(A:2) розкривається до CDEF, а $(A:2:3) – до CDE.

Нерозпізнане ім’я не перетворюється, а форма $NAME або $(NAME) після розкриття залишається в значенні параметра незмінною.

Ім’я параметра

Опис і стандартне значення

$

Форма $$ розкривається до одного символу $.

Від А до P

Замінено вмістом параметрів загального призначення від GPP_A до GPP_P.

Від SA до SD

Замінено на параметри спеціального призначення від GPP_SA до GPP_SD. Ці параметри містять ключі або паролі, які використовуються під час підготовки.

Вирази від $SA до $SD розпізнаються як аргументи додаткового кваліфікатора URL-адреси повторної синхронізації, --key.

MA

MAC-адреса з використанням шістнадцяткових цифр у нижньому регістрі, наприклад, 000e08aabbcc.

MAU

MAC-адреса з використанням шістнадцяткових цифр у верхньому регістрі, наприклад 000E08AABBCC.

MAC

MAC-адреса з використанням шістнадцяткових цифр у нижньому регістрі та двокрапки для розділення пар шістнадцяткових цифр. Наприклад 00:0e:08:aa:bb:cc.

PN

Назва продукту. Наприклад, CP-8875, DP-9851, DP-9871.

PSN

Номер серії продукту. Наприклад V03.

SN

Рядок серійного номера. Наприклад 88012BA01234.

CCERT

Статус сертифіката клієнта SSL Client Certificate status: встановлено чи не встановлено.

IP

IP-адреса телефона в його локальній підмережі. Наприклад 192.168.1.100.

EXTIP

Зовнішня IP-адреса телефона, яку видно в інтернеті. Наприклад 66.43.16.52.

SWVER

Рядок версії програмного забезпечення. Наприклад:

PHONEOS.3-1-1-0104-37

HWVER

Рядок версії обладнання. Наприклад 2.0.1.

PRVST

Стан підготовки (числовий рядок):

-1 = явний запит на повторну синхронізацію

0 = повторна синхронізація після ввімкнення живлення

1 = періодична повторна синхронізація

2 = помилка повторної синхронізації, повторіть спробу

UPGST

Стан оновлення (числовий рядок):

1 = перша спроба оновлення

2 = помилка оновлення, повторіть спробу

UPGERR

Повідомлення результату (ERR) попередньої спроби оновлення; наприклад http_get failed.

PRVTMR

Секунд після останньої спроби повторної синхронізації.

UPGTMR

Секунд після останньої спроби оновлення.

REGTMR1

Секунд після того, як лінія 1 втратила реєстрацію на сервері SIP.

REGTMR2

Секунд після того, як лінія 2 втратила реєстрацію на сервері SIP.

UPGCOND

Застаріле ім’я макросу.

SCHEME

Схема доступу до файлу, TFTP, HTTP або HTTPS, отримана після синтаксичного аналізу URL-адреси повторної синхронізації або оновлення.

SERV

Ім’я головного комп’ютера цільового сервера, на який надсилається запит, отримане після синтаксичного аналізу URL-адреси повторної синхронізації або оновлення.

SERVIP

IP-адреса цільового сервера, на який надсилається запит, отримана після синтаксичного аналізу URL-адреси повторної синхронізації або оновлення, можливо, після пошуку DNS.

PORT

Цільовий порт UDP/TCP, на який надсилається запит, отриманий після синтаксичного аналізу URL-адреси повторної синхронізації або оновлення.

PATH

Шлях до цільового файлу, на надання якого надсилається запит, отриманий після синтаксичного аналізу URL-адреси повторної синхронізації або оновлення.

ERR

Повідомлення про результат спроби повторної синхронізації або оновлення. Корисно лише для створення повідомлень системного журналу про результати. Значення зберігається в змінній UPGERR у разі спроб оновлення.

UIDn

Вміст параметра конфігурації Line n UserID.

EMS

Стан функції Extension Mobility

MUID

Ідентифікатор користувача в Extension Mobility

MPWD

Пароль в Extension Mobility

Коди внутрішніх помилок

Телефон визначає ряд кодів внутрішніх помилок (X00–X99), щоб полегшити налаштування та забезпечити точніше регулювання робочих характеристик пристрою за умов виникнення певних помилок.

Таблиця 4. Коди внутрішніх помилок

Ім’я параметра

Опис і стандартне значення

X00

Помилка транспортного рівня (або ICMP) під час надсилання запиту SIP.

X20

Вичерпано час очікування відповіді на запит SIP.

X40

Загальна помилка протоколу SIP (наприклад, неприйнятний кодек у SDP у повідомленнях 200 і ACK або вичерпано час очікування на повідомлення ACK).

X60

Набраний номер недійсний у заданій абонентській групі.