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

На данном этапе подразумевается, что нам известно следующее:

IP адрес точки доступа (ex: 10.30.40.209);
IP адрес или доменное имя, по которому доступна платформа (ex: 192.168.0.254);
ТД (точка доступа) может находится за NAT относительно расположения платформы.

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

статическая настройка;
настройка опции 43 DHCP;
настройка DNS resolution.

Статическая настройка используется для сети, в которой нет DHCP-сервера или необходимо указать ip адрес платформы вручную.

Опция DHCP 43 позволяет сообщать адрес платформы точке доступа динамически и централизованно во время получения ею IP адреса по протоколу DHCP.

Запись DNS позволяет передавать адрес платформы точке доступа централизованно путем DNS ответа на запрос точки доступа специального доменного имени.

Статическая настройка

Для подключения ТД к платформе необходимо выполнить следующие шаги:

Подключиться к ТД, используя протокол SSH (порт 51954 или 22), и ввести пароль.
Пример:

ssh wimark@10.30.40.209 -p 51954

Перейти в привилегированный режим, а затем в конфигурационный режим:

hostname> enable
Password:
            __
  __ __ __ |__| Just a better wireless_
 |  |  |  |.--.--.--.--.---.-..----.|  |.-.
 |  |  |  ||  |        |  -  ||   _||    <
 |________||__|__|__|__|___|_||__|  |__|__|
                        S  Y  S  T  E  M  S
 wimark.com
hostname# configure
hostname(configure)#

Используя команду конфигурации wcp ap, добавить контроллер. ТД может использовать до трех статически настроенных контроллеров в порядке уменьшения приоритета. При недоступности основного (primary) контроллера, управление переходит ко второму (secondary) контроллеру, при недоступности второго к третьему (tertiary) контроллеру.
Добавить основной контроллер (primary) следующей командой:
wcp ap primary-base <CON-NAME> <IP-ADDRESS>
При необходимости добавления второго контроллера (secondary), следует использовать команду:
wcp ap secondary-base <CON-NAME>> <IP-ADDRESS>
При необходимости добавления третьего контроллера (tertiary), использовать следующую команду:
wcp ap tertiary-base <CON-NAME> <IP-ADDRESS>
Где:
<CON-NAME> - имя контроллера;
<IP-ADDRESS> - ip адрес контроллера.
Пример добавления трёх контроллеров:
hostname(configure)# wcp ap primary-base HOST1 192.168.0.254 hostname(configure)# wcp ap secondary-base HOST2 192.168.0.253 hostname(configure)# wcp ap tertiary-base HOST3 192.168.0.252
Правильность настройки следует проверить в привилегированном режиме, используя команду show wcp client configuration.

Пример:

hostname# show wcp client configuration
Current controller name          : HOST1
Current controller IP            : Not configured
Primary controller name          : HOST1
Primary controller IP            : 192.168.0.254
Secondary controller name        : HOST2
Secondary controller IP          : 192.168.0.253
Tertiary controller name         : HOST3
Tertiary controller IP           : 192.168.0.252
Manufacturing controller name    : manufacturing
Manufacturing controller IP      : 10.30.40.105

Option 43 DHCP

Необходимо в конфигурации DHCP (Dynamic Host Configuration Protocol) сервера указать ip address или domain платформы. В этом случае ТД под управлением платформы принимают его адрес по DHCP опции 43.

Формат для DNSMASQ DHCP сервера

Расшифровка подопций (suboptions) 43 опции:

1 - ip address

2 - domain

Настройка опции (несколько IP адресов платформы указываются через запятую):

list dhcp_option 'vendor:wimark,1,10.10.3.1,10.10.3.2'

Либо один домен

list dhcp_option 'vendor:wimark,2,hotspot.beeline.ru'

Формат для ISC DHCP сервера

Пример формата для сервера ISC DHCP приведен ниже.

...
     ddns-update-style interim;
     allow bootp;
     option space WIMARK_AP;
     option WIMARK_AP.server-address code 241 = array of ip-address;
     subnet 192.168.247.0 netmask 255.255.255.0 {
     authoritative;
     option routers 192.168.247.1;
     option subnet-mask 255.255.255.0;
     option domain-name "domain.local";
     option domain-name-servers 192.168.247.2, 192.168.247.3;
     range dynamic-bootp 192.168.247.11 192.168.247.254;
     default-lease-time 300;
... 
class "Wimark_AP" {
       match if option vendor-class-identifier = "wimark";
       option vendor-class-identifier "wimark";
       vendor-option-space WIMARK_AP;
       option WIMARK_AP.server-address 192.168.247.5,192.168.247.6; }
}

Формат для KEA DHCP сервера

Пример конфигурации для сервера KEA DHCP.

{
"Dhcp4": {
    "authoritative": true,
    "option-def": [
        {
            "name": "server-address",
            "code": 241,
            "space": "wimark",
            "array": true,
            "type": "ipv4-address"
        }
    ],
    "client-classes": [
        {
            "name": "VENDOR_CLASS_wimark",
            "option-def": [
                {
                    "name": "vendor-encapsulated-options",
                    "code": 43,
                    "encapsulate": "wimark",
                    "type": "empty"
                }
            ],
            "option-data": [
                {
                    "name": "vendor-encapsulated-options",
                },
                {
                    "name": "server-address",
                    "space": "wimark",
                    "data": "192.168.247.5",
                    # или несколько: "data": "192.168.247.5,192.168.247.6",
                    "always-send": true
                },
            ]
        },
    ],
}

Теперь адрес платформы предполагается по IP адресу(ам) 192.168.247.5 (6).

DNS resolution

Для соединения ТД и платформы с помощью Domain Name System (DNS) resolution:

Необходимо создать ресурсную запись типа А на локальном DNS-сервере с именем <WIFI-CONTROLLER.localdomain> и указать ip адрес платформы.
Убедиться, что ip адрес DNS-сервера на ТД настроен верно, например, средствами DHCP-сервера в локальной сети.

Приоритеты подключения ТД

Подключение ТД к платформе осуществляется в соответствии с приоритетами. ТД будет циклично пытаться подключится к контроллеру в указанном порядке.

Primary controller;
Secondary controller;
Tertiary controller;
DHCP option 43;
Manufacturing controller (DNS resolution).

Переподключение ТД при смене контроллера, при наличии действующего, осуществится только после разрыва соединения (например, обновление ТД) при условии, что не задан контроллер более высокого приоритета.

Проверка статуса подключения ТД

Настройки и статус подключения ТД можно проверить в веб интерфейсе платформы. Благодаря графическим идентификаторам можно видеть состояние подключения ТД к платформе.

Состояние подключения в таблице ТД: подключено

На изображении ниже можно увидеть “зеленый” индикатор подключения, символизирующий о том, что точка доступа подключилась к платформе и готова к работе.

Документация Wimark > Wimark One: подключение точек доступа_1.12 > 1.png
Рисунок 1

Состояние подключения в таблице ТД: отключено

На изображении ниже можно увидеть “серый” индикатор отключения, символизирующий о том, что ТД отключилась от платформы WLC.

Документация Wimark > Wimark One: подключение точек доступа_1.12 > 2.png
Рисунок 2

Состояние подключения в таблице ТД: обновление ПО

На изображении ниже можно увидеть “голубой” индикатор обновления ПО.

Документация Wimark > Wimark One: подключение точек доступа_1.12 > 3.png
Рисунок 3