Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

apt-get install openjdk-11-jdk nginx mosquitto mosquitto-clients
useradd -m -U -s /bin/false wdc

Настройка контроллера

Поддерживаемые точки доступа

Текущая версия контроллера поддерживает только точки доступа, работающие под управлением операционной системы OpenWrt. Потенциально контроллер способен поддерживать и сторонние «вендорские» точки доступа со штатными прошивками, управляемые по TR-069, SNMP, CLI, REST API, но данный функционал в настоящий момент заблокирован и активных работ в этом направлении не ведется.

...

Адрес контроллера задаётся статически, либо получается динамически по DHCP Option 43, в крайнем случае точка осуществляет подключение на «контроллер-по-умолчанию», заданный в её прошивке. Инфопанель статуса взаимодействия с контролером доступна в веб-интерфейсе точки доступа.

Системные требования контроллера

Контроллер работает под управлением операционной системы Linux (Debian, Astra Linux) и поставляется в форматах:

  • дистрибутив для установки на сервер при помощи скрипта-инсталлятора;
  • образ виртуальной машины (ovf, vmdk, qcow2).

Поддерживается работа в виртуальном окружении и на физическом сервере. Типичные требования к оборудованию: 2-4 vCPU, 8 Gb RAM, 50 Gb HDD. Для терминирования туннельного трафика VXLAN потребуется дополнительный сетевой интерфейс. Терминацию туннелей можно выполнять и на отдельном Linux-сервере.

Контроллер использует следующие каталоги на сервере:

Путь

Содержимое

/opt/wdcКонтроллер (ядро и бэк-энд)
/opt/wdc/logsЛог-файлы контроллера
/opt/wdc/dataФайлы базы данных контроллера
/opt/wdc/downloadПрошивки точек доступа, агентов и т.п.
/opt/h2/bin/СУБД Н2
/opt/agent-openwrt/Агент контроллера, работающий с точками OpenWrt
/opt/agent-openwrt/logsЛог-файлы агента контроллера
/opt/syslog/

Лог-файлы точек доступа, направленные по rsyslog, а также лог-файлы контроллера для просмотра через веб-интерфейс

Подключение точек доступа

Точки доступа пробуют подключиться к контроллеру автоматически сразу после инициализации TCP/IP стэка устройства. Процесс поиска и подключения ведется непрерывно и повторяется после разрыва связи. Если долго не удаётся установить соединение с контроллером, точка доступа автоматически перезапускается. Также точка доступа способна откатывать назад последние конфигурационные изменения, если они привели к потере связи с контроллером. В некоторых случая точка доступа способна сбрасывать собственную конфигурацию в шаблон "по умолчанию".

...

3. Если в DHCP Option 43 адрес не приходит (либо DHCP не настроен), для подключения используется адрес контроллера, зашитый в код агента управления (обычно это wdc.wnam.ru, и может отличаться в вашей партии точек доступа).

Настройка поиска контроллера через протокол DHCP

Для настройки поиска контроллера через протокол DHCP, необходимо

  1. На вашем DHCP-сервере включите отправку опции 43, содержащей IP адрес вашего контроллера. Он будет передаваться в точку доступа при попытке получить собственный IP-адрес. 
  2. Конвертируйте IPv4 адрес контроллера в шестнадцатеричное представление. Для этого можно воспользоваться калькулятором (в режиме "программиста"), или сайтом,например, https://shimi.net/services/opt43/ (например, для IP адреса 172.16.100.1 представлением в HEX будет ac106401). 
    В настоящий момент мы поддерживаем только один адрес контроллера (не два или три), то есть длина блока адресов равна 04 байта.
    В качестве номера опции мы применяем 01 (как оборудование Huawei; Cisco применяет номер 241 или f1).
    Таким образом, полное значение опции будет 0104ac106401.
  3. Настройте свой DHCP-сервер (ниже даны примеры для различных производителей).

Настройка DHCP-сервера ОС Mikrotik

 

Настройка DHCP-сервера ОС Cisco

option 43 hex 0104ac106401

Настройка DHCP-сервера ОС Linux ISC DHCP

option WDC.server-address code 1 = array of ip-address;
option WDC.server-address 172.16.100.1;

Настройка DHCP-сервера ОС Windows Server