Алгоритм работы процедуры автоматического обновления устройства определяется значением параметра «Приоритет параметров из».
Если выбрано значение «Static settings», то из параметров «Файл конфигурации» и «Файл ПО» определяется полный путь (включая протокол доступа и адрес сервера) к файлам конфигурации и программного обеспечения. Полный путь указывается в формате 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)
Автоконфигурирование по протоколу TR-069 не поддержано в версии 1.4.0. Рекомендуется при использовании опции 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-память. Данные действия приведут к частичной записи ПО, что равноценно порче загрузочного раздела устройства. Дальнейшая работа устройства будет невозможна.