Versions Compared

Key

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

Table of Contents
indent20
Точки доступа пробуют подключиться к

После установки ПО контроллера и подключения его в вашу локальную сеть вы можете начать подключение точек доступа к сети. Процесс подключения и начала работы точек доступа с контроллером следующий:

  1. После подключения питания к точкам доступа они загружают прошивку и после полной загрузки запускается ПО агента точки доступа; 
  2. После старта ПО агента точки пытаются подключиться к заданному одним из способов ниже контроллеру автоматически сразу после инициализации TCP/IP

...

  1. стека устройства;
  2. Точка доступа пытается подключиться к заданному одним из способов ниже контроллеру 3 раза с таймаутом между попытками в 5 секунд;
  3. При неуспешной попытке подключения точка доступа пытается выполнить подключение к следующему заданному по приоритету контроллеру;
  4. Если не удаётся установить соединение ни с

...

  1. одним из заданных контроллеров в течение заданного промежутка времени (

...

  1. 240 сек. по умолчанию), сетевые настройки точки автоматически сбрасываются для исключения проблем неправильной настройки сети на точке доступа;
  2. Процесс повторяется, начиная с п.3;

Процесс поиска контроллера и подключения к нему ведется непрерывно и повторяется после разрыва связи.

В кластерной конфигурации работает следующий механизм подключения:

  • точка подключается к одному из узлов кластера, получает от него адрес второго узла, подключается к нему и работает с двумя узлами сразу;
  • при обрыве связи с одним из узлов точка автоматически переподключается к нему;
  • если связь с приоритетным узлом была потеряна, а после восстановлена, то точка автоматически задает его обратно как приоритетный для себя узел;
  • если связь с обоими узлами кластера была потеряна, точка пробует выполнить переподключение, и если оно неуспешно, то точка пытается выполнять подключение к другим адресам контроллеров, заданным в настройках точки или в DHCP опциях до тех пор пока не будет выполнено подключение хотя бы к одному из узлов;
  • если ни один узел недоступен, то точка повторяет попытки подключения ко всем узлам сначала.

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

  • статическая настройка (см. раздел 6.1);
  • динамическое получение адреса из DHCP option 43 или 138 (CAPWAP) (см. раздел 6.2);

Для визуального отображения , затем снова выполняется попытка подключения. Для индикации текущего состояния точки доступа используется светодиодная индикация:

  • мигает красный - точка выполняет подключение к контроллеру;
  • мигает зеленый - промежуточная стадия подключения выполнена, ожидается ответ сервера контроллера управления на запрос о регистрации точки доступа;
  • горит красный - точка работает, клиент контроллера управления выключенагент взаимодействия с контроллером выключен или в данный момент не работает;
  • горит зеленый - подключение и регистрация с сервером контроллера управления контроллером выполнены успешно, точка работает в штатном режиме;
  • горит синий - к точке доступа подключен 1 один или более wifi Wi-Fi клиентов;
  • мигает желтый малиновый (фиолетовый) - в процессе регистрации точки доступа на сервере контроллера управления контроллере произошла ошибка, скорее всего - нет лицензии;
  • хоотично последовательно мигают красный, зеленый и синий светодиоды - включен сервисный режим "быстрое мигание".

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

  • статическая настройка (см. раздел 5.1);
  • динамическое получение адреса из DHCP (см. раздел 5.2);
  • контроллер по умолчанию (см. раздел 5.3).

и прочей информации, на точках доступа доступна утилита status, которую можно включить из UART консоли или по SSH. При запуске утилиты в консоли будет отображаться основная информация о статусе работе точки, к какому контроллеру она подключена, на какой версии ПО она работает, и т.д.. Также помимо основной информации о работе точке доступа в окне утилиты есть отображение текущей светодиодной индикации точки.

Image Added

Anchor
static_settings
static_settings
6.1 Статистическая настройка контроллера

...

Наибольшим приоритетом обладает IP-адрес, либо DNS-имя, указанное в конфигурации точки доступа. Через Его можно задать через веб-интерфейс точки , LuCi, его можно задать в главном меню (LuCi) в разделе "Controller":

Image Added

Image RemovedImage Added

В поле "Controller ip/host" введите адрес контроллера в десятичном представлении или в виде DNSIP-адреса или доменного имени. Возможно задание нескольких адресов, разделенных запятой (100.200.3.4,100.200.3. Кнопка "running" покажет 5). Кнопка под полем ввода отображает статус работы управляющего агента на самой точке доступа, а также позволит позволяет отключить и/или перезапустить агент управления. При запущенном агенте на кнопке отображается надпись "running", при отключенном - "inactive".

После ввода адреса примите примените внесенные изменения, нажав на кнопку "Save & Apply" внизу страницы.

Также адрес можно задать адрес непосредственно в CLI интерфейсе командной строки точки доступа (RS232, UART или SSH):

test_ap>enable
Entered privileged EXEC mode.
test_ap#configure terminal 
Entered terminal configuration mode.
test_ap(config)#controller get
error: controller host is not set
test_ap(config)#controller set 93.180.6.180
controller new host: 93.180.6.180 is set

test_ap(config)#controller get
Current controller host: 93.180.6.180

Или настроить напрямую из терминала при помощи команд UCI:

# Можно задать как доменное имя контроллера:
uci set wda.settings.host='wico-test1.wnam.ru''your.controller.ru'
# Так и IP-адрес контроллера:
uci set wda.settings.host='100.200.3.4'
# Возможно задание нескольких IP адресов контроллеров через запятую:
uci set wda.settings.host='100.200.3.4,100.200.3.5'
# После задания адреса сохраните настройки и перезапустите сервис агента
uci commit
service wda restart
Note

Задание статического адреса отключает получение адреса контроллера через DHCP опции, поэтому будьте внимательны и проверяйте правильность/доступность адресов из сети точки доступа.

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

Если Если никакой адрес в настройках точки доступа не задан статический адрес контроллера, то она ищет будет искать контроллер, получая его адрес их адреса из DHCP опции опций 43 .

...

или 138. Опция 43 имеет более высокий приоритет, т.е. если DHCP-сервером были предоставлены адреса контроллеров в опциях 43 и 138 одновременно, то точка доступа сначала будет пытаться выполнить подключение к адресам из опции 43, и если подключение будет неуспешным, то к адресам из опции 138.

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

  1. На вашем DHCP-сервере включите отправку опции 43 или 138, содержащей один или несколько IP-адрес вашего адресов контроллера(ов) (он будет передаваться в точку доступа при попытке получить собственный IP-адрес от DHCP сервера).
  2. Конвертируйте IPv4 адрес контроллера Для опции 43: конвертируйте один или несколько IPv4 адресов контроллера(ов) в шестнадцатеричное представление. Для этого воспользуйтесь калькулятором (в режиме "программиста") или сайтомонлайн-утилитой для конвертации IP адресов в формат опции 43, например,  https://shimi.net/services/opt43/ (например, для IP-адреса 172.16.100.1 представлением в HEX будет ac106401). 
    В настоящий момент мы поддерживаем только один адрес контроллера (не два или три), то есть длина блока адресов равна 04 байта.
    В качестве номера опции мы применяем 01 (как оборудование Huawei; Cisco применяет номер 241 или f1), таким образом, полное значение опции будет 0104ac106401, либо сделайте это вручную, использую документацию DHCP протокола, например https://datatracker.ietf.org/doc/html/rfc2132#section-8.4.
    • DHCP опция 43 позволяет задавать несколько адресов контроллера, и тогда точки доступа будут пытаться подключаться к ним по очереди (если не удалось подключиться к первому - пытаемся подключиться ко второму и т.д.).
    • В качестве номера опции мы используем 01, как для оборудования Huawei. Номер 241 (или f1), используемый для оборудования Cisco, не поддерживается.
  3. Для опции 138: большинство DHCP-серверов не требуют конвертации IP-адреса в шестнадцатеричный вид, и их можно указывать в обычном виде. Если это требуется для вашего DHCP-сервера, то сконвертируйте один или несколько IPv4 адресов контроллера(ов) в шестнадцатеричное представление.
    • DHCP опция 138 позволяет задавать несколько адресов контроллера, и тогда точки доступа будут пытаться подключаться к ним по очереди (если не удалось подключиться к первому - пытаемся подключиться ко второму и т.д.).
  4. Настройте свой DHCP-сервер (в разделах 5.2.1-5.2.6 представлены примеры для различных производителей).

...

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

Option 43:

 

...

6.2.2

...

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

# option 43
option 43 hex 0104ac106401

...

# option 43 2 адреса
option 43 hex 0108ac106401ac106402

6.2.3

...

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

# option 43
option WDCwico.server-address code 1 = array of ip-address;
option WDCwico.server-address 172.16.100.1;
# option 138
option capwap-ac-v4 100.10.10.1, 100.10.10.2;

...

6.2.4

...

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

Option 43:

...

6.2.5 Настройка DHCP-сервера dnsmasq

# option 43
dhcp-option=43,01:04:ac:10:64:01

...

#option 43 2 адреса
43,01:08:5d:b4:06:b4:5d:b4:06:b5
# option 138
dhcp-option=138,100.10.10.1,100.10.10.2

6.2.6 Настройка DHCP-сервера на самом контроллере

WiCo Сервис контроллера имеет встроенный DHCP - сервер, который может применяться для динамической выдачи IP-адресов беспроводным клиентам и точкам доступа. Он может быть востребован в небольших инсталляциях системыWi-Fi, а также на этапе тестирования. Раздел . Раздел документации 7.3.5 DHCP и TFTP данного руководства содержит  содержит информацию по настройке данного функционала.

Возможность отправки адреса самого контроллера включается при активации кнопки переключателя "Передавать адрес контроллера в DHCP Option 43".

Image Removed

5.3 Контроллер по умолчанию

 При активации опции встроенный DHCP сервер будет передавать точкам доступа собственный IP адрес.

В кластерной конфигурации, где каждый узел имеет собственный IP адрес, в опции 43 будет передаваться IP-адрес ноды контроллера, заданный при формировании кластера.

Image AddedЕсли в DHCP Option 43 адрес не приходит (либо DHCP в вашей сети с точками доступа не настроен), для подключения к контроллеру используется адрес, зашитый в код агента управления на стадии его сборки (обычно это default-controller-wico.pro). Он может отличаться в вашей партии точек доступа.