Versions Compared

Old Version 19

changes.mady.by.user Anton Vinokurov

Saved on

compared with

New Version Current

changes.mady.by.user Никита Фартуков

Saved on

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);

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

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

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

  • статическая настройка (см. раздел #статическая настройка);
  • динамическое получение адреса из 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-адреса или доменного имени. Кнопка "running" покажет . Возможно задание нескольких адресов, разделенных запятой (100.200.3.4,100.200.3.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.

...

опций 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 байта.
    Для кластерной конфигурации контроллеров задайте кластерный IP-адрес
    В качестве номера опции мы применяем 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 wico.server-address code 1 = array of ip-address;
option wico.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). Он может отличаться в вашей партии точек доступа.