Page tree
Skip to end of metadata
Go to start of metadata


Общее описание, причины создания и кейсы применения TR-069


В роутерах SNR реализовано множество механизмов удаленного управления и диагностики, одним из которых является TR-069

Протокол TR-069, известен как "CWMP" - (CPE WAN Management Protocol), был создан в 2004 году некоммерческой организацией Broadband-forum (BBF) из-за растущего числа CPE, требовавших унификации, стандартизации обслуживания, настройки и мониторинга на сети у операторов связи. Протокол определяет принципы взаимодействия между абонентскими устройствами и сервером автоконфигурации (ACS).

  • Автоматическая настройка оборудования при его установке;
  • Мониторинг устройств на наличие неполадок;
  • Конфигурирования Wi-Fi CPE;
  • Установки и обновления ПО на CPE;
  • etc...

Одним из возможных решений для удаленного управления является GenieACS, выпускаемое под лицензией с открытым исходным кодом и не являющееся проприетарным.
Подробнее о GenieACS вы можете узнать по ссылке: https://genieacs.com

При использовании GenieACS, в разделе Devices отображаются CPE, прошедшие авторизацию на ACS.
Нажатие на CPE из списка даст доступ к подробной информации о самой CPE и о ее параметрах.

Далее, на примере GenieACS, рассмотрим часто используемый функционал CWMP.


Автоматическая настройка CPE


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

С помощью добавления скрипта в разделе Admin → Provisions → New в GenieACS, можно задать необходимые настройки по умолчанию.

Например, в заводской конфигурации SNR-CPE задан 44 канал в Wi-Fi 5 ГГц. В примере показано условие для скрипта, которое изменит параметр на "Автовыбор".

Добавьте параметр и его состояние для скрипта в разделе Admin → Provision кнопкой New.

Затем добавьте предустановку Admin → Presets, нажав кнопку New. 

При указании события 0 BOOTSTRAP, применение параметра "Автовыбор" для канала Wi-Fi 5 ГГц произойдет при первичной установке роутера у пользователя.


Ручная настройка CPE


Аналогично настройкам в WEB UI, изменение параметров доступно в ACS через CWMP. 

Как пример, через ACS можно изменить все опции Wi-Fi на CPE, воспользовавшись веткой:

InternetGatewayDevice.LANDevice.{i}.WLANConfiguration.{i}

WEB UICWMP

.RadioEnabled

.Name

.Standart

.AutoChannelEnable

.AutoChannelEnableBased

.AutoChannelEnableInterval

.OperatingChannelBandwidth

.TransmitPower

.WPAAuthenticationMode

.KeyPassphrase


Диагностика подключенных Wi-Fi-устройств


С помощью CWMP можно выполнять диагностику, мониторинг радиоэфира и состояние параметров подключенных клиентов.

Рассмотрим ветку параметров Wi-Fi подключенного WLAN клиента:

InternetGatewayDevice.LANDevice.{i}.WLANConfiguration.{i}.AssociatedDevice.{i}

WEB UIСWMP

.X.SSID
.X_SNR_WLAN_BAND

.AssociatedDeviceMACAddress

.X_SNR_RSSI

.X_SNR_Uptime

.X_SNR_LastDataReceiveRate
.X_SNR_LastDataTransmitMode
.X_SNR_LastDataReceiveMode


Мониторинг и диагностика подключений


При обращении клиента, оператор связи может выполнить диагностику LAN и WAN подключений с помощью утилит ping и traceroute в WEB UI.

Эти же действия можно выполнить централизованно через CWMP-параметры:

InternetGatewayDevice.IPPingDiagnostics

InternetGatewayDevice.TraceRouteDiagnostics

Для запуска диагностики нужно указать значения в параметрах:
  • .Host - URL или IP-адрес
  • .DiagnosticState - статус "Requested"
  • .Interface - интерфейс (прим. "ra0")

После применения этих значений, обновите всю ветку повторно. Статус .DiagnosticState изменится на "Complete".

Для диагностики ping и traceroute выполняются идентичные действия, но для вывода результатов последней потребуется больше времени.

PingTraceroute




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


Чтобы обновлять группу устройств не по отдельности, а массово и централизованно, можно установить образ прошивки на ACS, затем обновить вручную, либо через provision-скрипт.

Для загрузки ПО на сервер:

  1. В разделе Admin → Files кнопкой New загрузите образ с локального устройства.
  2. В пункте Type выберите 1 Firmware Upgrade Image, пункты OUI, Product Class, Version можно оставить пустыми.
  3. В пункте File выберите бинарный образ прошивки, который хотите загрузить на ACS-сервер.
  4. Нажмите Save.
    image2021-8-25_16-14-56.png

Для установки образа ПО на подключенные к ACS роутеры есть 2 способа:

В разделе Devices отображаются CPE, которые успешно прошли авторизацию на ACS.

image2021-8-26_11-52-27.png

С помощью Filter выбираем нужные нам CPE, в примере это SNR-CPE-ME2-Lite. 

image2021-8-26_11-53-45.png

С помощью кнопки Push File выберите загруженную на ACS прошивку, нажмите Queue и Commit, после чего произойдет обновление прошивки на CPE.

Создадим скрипт в AdminProvisions → New, укажем в нем ранее добавленный файл прошивки.

declare("Downloads.[FileType:1 Firmware Upgrade Image]", {path: 1}, {path: 1});
declare("Downloads.[FileType:1 Firmware Upgrade Image].FileName", {value: 1}, {value: "SNR-CPE-firmware.bin"});
declare("Downloads.[FileType:1 Firmware Upgrade Image].Download", {value: 1}, {value: Date.now()});

  • const now = Date.now() - объявляем константу now, которая обозначает текущий отрезок времени;
  • declare - задаем параметру значение которое он должен принять;
  • FileType - параметр указания типа передаваемого файла.

Создадим предустановку в Admin → Presets → New, указав ранее созданный скрипт, условие учета наименования модели, события 1 BOOT, условие учета текущей версии на роутере и параметр учета времени срабатывания раз в сутки с 4:00 до 4:59 в формате cron.

  • No labels