Versions Compared

Key

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

...

Установка начинается с включения "пустой" виртуальной машины с Debian Linux 11.6 x64, в которой предварительно настроено имя хоста, а также заданы параметры TCP/IP подключения:

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

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

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

Протестированы на совместимость, и успешно работают, следующие модели устройств:

  • Gl-Inet AC1300LTE;
  • Gl-Inet B1300;
  • Aruba AP11d;
  • TP-Link EAP-615w;
  • Yuncore AX820 (рекомендуемая модель);
  • Yuncore FAP640 и FAP650;
  • Yuncore AX840;
  • Yuncore AX840-P2 (рекомендуемая модель);
  • Yuncore AX880 (рекомендуемая модель).

Если интересующая Вас точка доступа построена на чипсетах Mediatek MT7621, Qualcomm-Atheros IPQ 40xx, 60xx, 807x, то контроллер сможет с ними работать, когда наша команда соберет подходящую прошивку для них.

Предпочтительным является использование двухдиапазонных точек доступа с поддержкой электропитания PoE. При наличии консольного (UART) порта допускается подключение к нему для целей траблшутинга. В случае наличия второго и последующих сетевых (LAN) интерфейсов у точки доступа, последние могут применяться для локальной настройки/траблшутинга.

...

echo "deb [trusted=yes] https://packages.wnam.ru/download/debian/ ./" | tee /etc/apt/sources.list.d/wico.list
apt update


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

...

Путь

Содержимое

/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 стэка устройства. Процесс поиска и подключения ведется непрерывно и повторяется после разрыва связи. Если долго не удаётся установить соединение с контроллером, точка доступа автоматически перезапускается. Также точка доступа способна откатывать назад последние конфигурационные изменения, если они привели к потере связи с контроллером. В некоторых случая точка доступа способна сбрасывать собственную конфигурацию в шаблон "по умолчанию".

Для подключения к контроллеру точка доступа руководствуется следующими правилами:

1. Наибольшим приоритетом обладает IP-адрес, либо DNS-имя, указанное в конфигурации точки доступа:

Image Removed

В поле "Controller ip/host" вводится адрес контроллера без конвертации, в десятичном представлении или в виде DNS-имени. Кнопка "running" показывает статус работы агента на самой точке доступа, а также позволяет отключить и/или перезапустить агента управления. После ввода адреса необходимо применить его, нажав на кнопку "Save & Apply".

Также можно задать адрес непосредственно в интерфейсе командной строки:

uci set wda.settings.host='wdc1.wnam.ru'
uci commit
service restart wda

2. Если никакой адрес в настройках точки доступа не задан, то она ищет контроллер, получая его адрес из DHCP опции 43 (см. подраздел "Настройка поиска контроллера через протокол DHCP").

...

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

...