v1.2.0Алгоритм работы автоматического обновления устройства на основе протоколa DHCP

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

Если выбрано значение «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.

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

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

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

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

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

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

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

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