| Table of Contents | ||||
|---|---|---|---|---|
|
Установка программного обеспечения
Программное обеспечение контроллера можно установить:
- из образа виртуальной машины в форматах OVF/VMDK или QCOW2
- на пустую виртуальную машину при помощи скрипта-инсталлятора
- на пустую виртуальную машину вручную
Ниже представлена инструкция установки на пустую виртуальную машину вручную.
Установка начинается с включения "пустой" виртуальной машины с Debian Linux 11.6 x64, в которой предварительно настроено имя хоста, а также заданы параметры TCP/IP подключения:
apt-get install openjdk-11-jdk nginx mosquitto mosquitto-clientsuseradd -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
- Yuncore AX840
- Yuncore AX840-P2 (рекомендуемая модель)
- Yuncore AX880 (рекомендуемая модель)
Если интересующая вас точка доступа построена на чипсетах Mediatek MT7621, Qualcomm-Atheros IPQ 40xx, 60xx, 807x, то наш контроллер сможет с ними работать, если наша компания соберет прошивку для данных чипсетов.
Подключение точек доступа
Точки доступа пробуют подключиться к контроллеру автоматически сразу после инициализации TCP/IP стэка устройства. Процесс поиска и подключения ведется непрерывно и повторяется после разрыва связи. Если долго не удаётся установить соединение с контроллером, точка доступа автоматически перезапускается. Также точка доступа способна откатывать назад последние конфигурационные изменения, если они привели к потере связи с контроллером. В некоторых случая точка доступа способна сбрасывать собственную конфигурацию в шаблон "по умолчанию".
Для подключения к контроллеру точка доступа руководствуется следующими правилами:
1. Наибольшим приоритетом обладает IP-адрес, либо DNS-имя, указанное в конфигурации точки доступа:
В поле "Controller ip/host" вводится адрес контроллера без конвертации, в десятичном представлении или в виде DNS-имени. Кнопка "running" показывает статус работы агента на самой точке доступа, а также позволяет отключить и/или перезапустить агента управления. После ввода адреса необходимо применить его, нажав на кнопку "Save & Apply".
Также можно задать адрес непосредственно в интерфейсе командной строки:
uci set wda.settings.host='wdc1.wnam.ru'uci commitservice restart wda
2. Если никакой адрес в настройках точки доступа не задан, то она ищет контроллер, получая его адрес из DHCP опции 43 (см. подраздел "Настройка поиска контроллера через протокол DHCP").
3. Если в DHCP Option 43 адрес не приходит (либо DHCP не настроен), для подключения используется адрес контроллера, зашитый в код агента управления (обычно это wdc.wnam.ru, и может отличаться в вашей партии точек доступа).
Настройка поиска контроллера через протокол DHCP
Для настройки поиска контроллера через протокол DHCP, необходимо
- На вашем DHCP-сервере включите отправку опции 43, содержащей IP адрес вашего контроллера. Он будет передаваться в точку доступа при попытке получить собственный IP-адрес.
- Конвертируйте IPv4 адрес контроллера в шестнадцатеричное представление. Для этого можно воспользоваться калькулятором (в режиме "программиста"), или сайтом,например, https://shimi.net/services/opt43/ (например, для IP адреса 172.16.100.1 представлением в HEX будет ac106401).
В настоящий момент мы поддерживаем только один адрес контроллера (не два или три), то есть длина блока адресов равна 04 байта.В качестве номера опции мы применяем 01 (как оборудование Huawei; Cisco применяет номер 241 или f1).Таким образом, полное значение опции будет 0104ac106401. - Настройте свой 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
|
Программное обеспечение контроллера беспроводных точек доступа Wi-Fi "WiCo" состоит из двух компонентов:
- Управляющий агент для точки доступа (firmware точки).
- Управляющий контроллер (ядро контроллера, коммуникационный агент, веб-интерфейс, СУБД и т.д).
2.1 Системные требования
Контроллер работает под управлением операционной системы Linux. Поддерживается работа в виртуальном окружении и на физическом сервере.
Типичные требования к оборудованию:
- 2 vCPU или больше;
- 4Gb RAM или больше;
- 20Gb свободного места на диске или больше;
- (опционально) дополнительный сетевой интерфейс для терминирования туннельного трафика VXLAN или GRE. Также терминацию туннелей можно выполнять и на отдельном Linux-сервере.
Контроллер использует следующие каталоги на сервере:
Путь | Содержимое |
|---|---|
| /opt/controller | Контроллер (ядро и бэк-энд) |
| /opt/controller/backup | Файлы бэкапов базы данных контроллера |
| /opt/controller/data | Файлы базы данных контроллера |
| /opt/controller/download | Прошивки точек доступа, агентов и т.п. |
| /opt/ui | Веб-интерфейс контроллера (html, js файлы) |
| /opt/agent | Агент контроллера, работающий с точками OpenWrt |
| /opt/syslog | Лог-файлы точек доступа, собираемые с помощью rsyslog, а также лог-файлы контроллера и агента контроллера |
Все компоненты контроллера запускаются из-под непривилегированного пользователя с логином controller (интерактивный вход запрещён).
2.2 Установка программного обеспечения
Программное обеспечение контроллера можно установить:
- из образа виртуальной машины в форматах:
- OVF/VMDK (VMware, Hyper-V);
- QCOW2 (KVM);
- на пустую виртуальную машину с OC Debian Linux или другой ОС на ее основе с использованием менеджера пакетов.
| Info |
|---|
Для получения программного обеспечения для установки обратитесь в нашу службу технической поддержки с указанием Вашего лицензионного ключа, и мы предоставим ссылку для загрузки дистрибутива или пакетов того или иного типа. |
В качестве эталонной системы для сборки пакетов и создания образов мы используем OC Debian Linux x64, версии 12.1. Также по запросу возможна сборка пакетов или образов с адаптацией под другие дистрибутивы и форматы распространения.
После получения установочных файлов установите их путем развертывания образа виртуальной машины или с помощью менеджера пакетов apt-get. ПО контроллера имеет минимальные стандартные настройки и готово к использованию сразу после установки.
После установки вы можете произвести дополнительные настройки контроллера (настроить параметры TCP/IP, DNS, кластерной конфигурации) при помощи терминального интерфейса, описанного в разделе 8.7 Графический терминальный интерфейс контроллера.