Алгоритм работы процедуры автоматического обновления устройства определяется значением параметра «Приоритет параметров из».
Если выбрано значение «Static settings», то из параметров «Файл конфигурации» и «Файл ПО» определяется полный путь (включая протокол доступа и адрес сервера) к файлам конфигурации и программного обеспечения. Полный путь указывается в формате URL:
<protocol>://<server address>/<path to file>, где
- <protocol> — протокол, используемый для загрузки соответствующего файла с сервера;
- <server address> — адрес сервера, с которого необходимо загрузить файл (доменное имя или IPv4);
- <path to file> — путь к файлу на сервере, файл должен иметь расширение tar.gz.
В URL допускается использование следующих макросов (зарезервированные слова, вместо которых устройство подставляет определенные значения):
- $MA — 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(p)/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;
для имени файла программного обеспечения: vp17.fw;
- для имени файла Manifest: vp17.manifest.
Таким образом, если поля «Файл конфигурации» и «Файл ПО» оставить пустыми, и по протоколу DHCP не будут получены опции 43 или 66, 67 с указанием местоположения этих файлов — URL файла конфигурации будет иметь вид:
tftp://update.local/A8.F9.4B.00.11.22.cfg,
URL файла ПО:
tftp://update.local/ vp17.fw,
URL файла Manifest:
tftp://update.local/ vp17.manifest.
Если выбрано значение «DHCP options», URL файлы конфигурации и файлы программного обеспечения извлекаются из DHCP-опций 43 (Vendor specific info) или 66 (TFTP server) и 67 (Boot file name). Для этого в услуге Интернет должно быть установлено получение адреса по протоколу DHCP (формат и анализ DHCP-опций будет приведен ниже). Если из DHCP-опций не удается определить какой-либо параметр URL — для него используется заданное значение по умолчанию:
для протокола: tftp;
для адреса сервера: update.local;
для имени файла конфигурации: $MA.cfg;
для имени файла программного обеспечения: vp17.fw;
- для имени файла Manifest: vp17.manifest.
- Несмотря на имя файла конфигурации $MA.cfg, формат файла должен быть .tar.gz
- Несмотря на имя файла прошивки vp17.fw, формат файла должен быть .tar.gz
- Возможна загрузка текстового файла конфигурации, расширение файла при этом обязательно должно быть .json
Формат опции 43 (Vendor specific info)
Автоконфигурирование по протоколу TR-069 не поддержано в версии 1.3.1. Рекомендуется при использовании опции 43 для автоконфигурирования устройства VP-17P прописывать 5, 6, 7 и 9 подопции.
1|<acs_url>|2|<pcode>|3|<username>|4|<password>|5|<server_url>|6|<config.file>|7|<firmware.file>|9|<manifest>
1 — код адреса сервера автоконфигурирования по протоколу TR-069;
2 — код для указания параметра Provisioning code;
3 — код имени пользователя для авторизации на сервере TR-069;
4 — код пароля для авторизации на сервере TR-069;
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-память. Данные действия приведут к частичной записи ПО, что равноценно порче загрузочного раздела устройства. Дальнейшая работа устройства будет невозможна.