Просмотреть исходный

Алгоритм работы процедуры автоматического обновления устройства определяется значением параметра «Приоритет параметров из».

Если выбрано значение «Static settings», то из параметров «Файл конфигурации» и «Файл ПО» определяется полный путь (включая протокол доступа и адрес сервера) к файлам конфигурации и программного обеспечения.

Внимание! Если попытка получить файлы по указанным ссылкам в параметрах «Файл конфигурации» и «Файл ПО» не завершится успешно, то следующими по очереди будут опрошены резеврные сервера, имена параметров которых имеют индексы "2" и "3".

Пример:

Запрос по URL-ссылке из параметра Файл конфигурации, искомый файл не был получен телефоном, переход на резервный сервер;
Запрос по URL-ссылке из параметра Файл конфигурации 2, искомый файл не был получен телефоном, переход на резервный сервер;
Запрос по URL-ссылке из параметра Файл конфигурации 3, искомый файл получен, конфигурация применена.

Полный путь указывается в формате URL:

<protocol>://<server address>/<path to file>, где

<protocol> — протокол, используемый для загрузки соответствующего файла с сервера;
<server address> — адрес сервера, с которого необходимо загрузить файл (доменное имя или IPv4);
<path to file> — путь к файлу на сервере, файл должен иметь расширение tar.gz.

В URL допускается использование следующих макросов (зарезервированные слова, вместо которых устройство подставляет определенные значения):

$MA, $MAC — MAC address — вместо данного макроса в URL файла устройство подставляет собственный MAC-адрес, без разделителей;
$SN — Serial number — вместо данного макроса в URL файла устройство подставляет собственный серийный номер;
$PN — Product name — вместо данного макроса в URL файла устройство подставляет название модели (например, VP-17P);
$SWVER — Software version — вместо данного макроса в URL файла устройство подставляет номер версии программного обеспечения;
$HWVER — Hardware version — вместо данного макроса в URL файла устройство подставляет номер аппаратной версии устройства.

MAC-адрес, серийный номер и название модели можно узнать на странице мониторинга в разделе «Устройство».

Примеры URL:

tftp://download.server.loc/firmware.tar.gz,

http://192.168.25.34/configs/VP-17/mycfg.tar.gz,

tftp://server.tftp/$PN/config/$SN.tar.gz,

http://server.http/$PN/firmware/$MA.tar.gz и т. д.

Если из URL-файла конфигурации или программного обеспечения не удаётся извлечь все необходимые для загрузки файла параметры (протокол, адрес сервера или путь к файлу на сервере), будет произведена попытка извлечь неизвестный параметр из DHCP-опций 43 (Vendor specific info) или 66 (TFTP server) и 67 (Boot file name), если в услуге Интернет установлено получение адреса по протоколу DHCP (формат и анализ DHCP-опций будет приведён ниже). Если из DHCP-опций не получается извлечь недостающий параметр, будет использоваться заданное значение по умолчанию:

для протокола: tftp;
для адреса сервера: update.local;
для имени файла конфигурации: $MA.cfg;
для имени файла программного обеспечения: VP-17.fw;
для имени файла Manifest: VP-17.manifest.

Таким образом, если поля «Файл конфигурации» и «Файл ПО» оставить пустыми, и по протоколу DHCP не будут получены опции 43 или 66, 67 с указанием местоположения этих файлов — URL файла конфигурации будет иметь вид:

tftp://update.local/A8F94B001122.cfg,

URL файла ПО:

tftp://update.local/VP-17.fw,

URL файла Manifest:

tftp://update.local/VP-17.manifest.

Внимание! Начиная с версии 1.3.2 были внесены изменения относительно использования макросов $MA и $MAC. Разделители в имени запрашиваемого файла больше не используются. Например, если MAC-адрес вашего устройства имеет значение «E4:5A:D5:F3:5D:58», то в запрашиваемом имени файла будет указано «E45AD5F35D58»:

Download file: «tftp://update.local/E45AD5F35D58.cfg»

Если выбрано значение «DHCP options», URL файлы конфигурации и файлы программного обеспечения извлекаются из DHCP-опций 43 (Vendor specific info) или 66 (TFTP server) и 67 (Boot file name). Для этого в услуге Интернет должно быть установлено получение адреса по протоколу DHCP (формат и анализ DHCP-опций будет приведен ниже). Если из DHCP-опций не удается определить какой-либо параметр URL — для него используется заданное значение по умолчанию:

для протокола: tftp;
для адреса сервера: update.local;
для имени файла конфигурации: $MA.cfg;
для имени файла программного обеспечения: VP-17.fw;
для имени файла Manifest: VP-17.manifest.

Несмотря на имя файла конфигурации $MA.cfg, формат файла должен быть .tar.gz
Несмотря на имя файла прошивки VP-17.fw, формат файла должен быть .tar.gz
Возможна загрузка текстового файла конфигурации, расширение файла при этом обязательно должно быть .json

Формат опции 43 (Vendor specific info)

5\|<server_url>\|6\|<config.file>\|7\|<firmware.file>\|9\|<manifest>

5 — код адреса сервера; адрес сервера задается в формате URL: tftp://address или http://address. В первом варианте указан адрес сервера TFTP, во втором — HTTP;

6 — код имени файла конфигурации;

7 — код имени файла ПО;

9 — код имени файла Manifest.

«|» — обязательный разделительный символ между кодами и значениями подопций.

Алгоритм определения параметров URL файлов конфигурации и ПО из DHCP-опций 43 и 66

Инициализация DHCP-обмена.
После загрузки устройство инициирует DHCP-обмен.
Анализ опции 43.
При получении опции 43 выполняется анализ подопций с кодами 5, 6, 7 и 9 с целью определения адреса сервера и имён файлов конфигурации, программного обеспечения и Manifest.
Анализ опции 66.
Если опция 43 от DHCP-сервера не получена либо получена, но из неё не удалось извлечь адрес сервера — осуществляется поиск опции 66. Если имя файла ПО также не удалось получить — осуществляется поиск опции 67. Из них извлекаются соответственно адрес сервера TFTP и путь к файлу ПО. Далее файлы конфигурации и программного обеспечения будут загружаться с адреса из опции 66 по протоколу TFTP.

Особенности обновления конфигурации

Файл конфигурации должен иметь формат .tar.gz (в данном формате происходит сохранение конфигурации через web-интерфейс во вкладке «Система» → «Управление конфигурацией»). Загруженная с сервера конфигурация применяется автоматически без перезагрузки устройства.

Особенности обновления программного обеспечения

Файл программного обеспечения должен иметь формат .tar.gz. После загрузки файла ПО осуществляется его распаковка и проверка версии (по содержимому файла version в tar.gz-архиве).

Если текущая версия программного обеспечения совпадает с версией файла, полученного по протоколу DHCP, обновление ПО производиться не будет. Обновление производится только в случае несовпадения версий. О запущенном процессе записи образа программного обеспечения во flash-память устройства свидетельствует появление экрана «Идет обновление ПО...» на дисплее телефона.

Не отключайте питание и не перезагружайте устройство во время записи образа во flash-память. Данные действия приведут к частичной записи ПО, что равноценно порче загрузочного раздела устройства. В случае, если такое произошло, восстановите питание устройства, и оно загрузится с резервного образа ПО.

Восстановить испорченный образ можно двумя способами:

1. Произвести повторное обновление ПО;
2. Подождать 10 минут после успешной загрузки с резервного образа (повторное обновление ПО при этом не понадобится, образы синхронизируется автоматически).

Если на момент обновления резервная область ПО была также повреждена, то восстановление работоспособности устройства возможно только в специализированном сервисном центре.