Описание

Модуль Eltex-APB предназначен для обмена информацией между точками доступа. Обеспечивает:

Роуминг пользователей, подключившихся при помощи авторизации на WEB-портале,
Настройку и передачу списков белых адресов при портальной авторизации,
Автоматическое распределение излучаемой мощности и рабочих каналов между точками доступа (RRM).

Установка выполняется с помощью пакета eltex-apb.

Запуск/остановка

Сервис eltex-apb запускается автоматически при старте сервера.

Для остановки сервиса используется команда:

service eltex-apb stop

Для запуска сервиса после остановки используется команда:

service eltex-apb start

Для проверки — запущен ли сервис в данный момент или нет, используется команда:

service eltex-apb status

В ответ последует сообщение:

eltex-apb is running with pid <pid>

в случае если сервис запущен (где <pid> - это номер процесса),

или

eltex-apb is not running

в случае если сервис не запущен.

Конфигурация

/etc/default/eltex-apb

- содержит основные настройки сервиса:

Слушаемый порт:

PORT=8090

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

ACCEPT_QUEUE_SIZE=0

Настройка памяти, выделяемой на работу сервиса (память выделяется на сам процесс, а не на кэш, прописанный в /etc/eltex-apb/ehcache.xml):

JAVA_INIT_HEAP=128m
JAVA_MAX_HEAP=2048m

/etc/eltex-apb/apb.properties

- файл содержит настройки для подключения к сервису NBI, а также расположения необходимых файлов.

/etc/eltex-apb/ehcache.xml

- системные настройки хранения данных о Wi-Fi пользователей, подключенных на портале. При необходимости название и расположение файла может быть изменено в /etc/eltex-apb/apb.properties.

Количество оперативной памяти, выделяемое для хранения таблицы авторизованных пользователей настраивается в:

    <cache name="users"
           maxBytesLocalHeap="200M"
           eternal="false"
           timeToLiveSeconds="43200"
           memoryStoreEvictionPolicy="LRU">

параметр

maxBytesLocalHeap="200M"

Количество оперативной памяти, выделяемое для хранения таблицы с белыми списками в разделе:

    <cache name="hosts" maxBytesLocalHeap="128M" eternal="true">
        <persistence strategy="none"/>
    </cache>

параметр

maxBytesLocalHeap="128M"

/etc/eltex-apb/hosts.json

- файл в формате json, содержащий набор списков белых адресов. При необходимости название и расположение файла может быть изменено в /etc/eltex-apb/apb.properties. При установке пакета eltex-apb по дефолту будет добавлен список белых адресов, достаточный для подключения пользователей к yandex кассе. При необходимости его можно расширить, используя следующие примеры:

Белый список, общий для всех подключенных точек задается в формате:

  {
    "permitted-ip-list": [
        "esia-portal1.test.gosuslugi.ru",
        "esia.gosuslugi.ru",
    ]
  }

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

  {
    "mobility-domain-list": [
      {
        "mobility-domain": "nsk.ru",
        "radius-domain": "root",
        "ssid": "Eltex-Local"
      }
    ],
    "permitted-ip-list": [
      "eltex.nsk.ru",
      "eltex.org"
    ]
  }

Из конфигурации SSID на точках доступа с версии 1.10 удален параметр mobility-domain, вместо него используется ap-location, который полностью ему соответствует, но теперь находится в разделе сетевых настроек.

Настройка подключения точек доступа к сервису APB

Подключение к сервису APB на точке доступа можно настроить через GUI EMS.

Для настройки роуминга пользователей при портальной авторизации необходимо перейти в раздел Конфигурация → Captive Portal.Global, указать адрес Roaming Service URL =

ws://<IP адрес APB>:8090/apb/broadcast

где <IP адрес APB> - адрес APB, доступный из сети управления точками доступа.

Конфигурация сервиса RRM

Для работы Radio Resource Management (RRM) необходимо только настроить подключение точек доступа к сервису через GUI EMS, сервис будет работать с конфигурацией по умолчанию.

Для редактирования конфигурации сервиса RRM необходимо перейти на WEB страницу:

http://<IP адрес APB>:8090/apb/rrm.jsp

Enabled - Включение/отключение работы сервиса RRM.

Use Action frames - Использовать Action пакеты в качестве общения точек доступа (ТД) между собой. В момент оптимизации ТД одновременно встают на 1 (2.4ГГц) и 36 (5ГГц) каналы и посылают в эфир Action пакеты, соседние ТД увидевшие пакеты передают на сервер данные от какой ТД был принят пакет и с каким уровнем сигнала (RSSI). При выключенной галочке Use Action frames будет использоваться механизм обмена Probe Request/Response. Главное преимущество обмена с помощью Action frames это время оптимизации(не более полу минуты), а так же отсутствие помех в эфире от других устройств не подключенных к серверу(отсутствие Probe Response).

Enable TPC - Включение/отключение работы Transmit Power Control - алгоритм управления мощностью передачиков на ТД. Главная задача механизма это распределение излучаемой мощности с целью обеспечения равномерной зоны покрытия и минимизацией "конфликтных" областей между соседними ТД.

RSSI Threshold 2.4G - Порог уровня RSSI в диапазоне 2.4 ГГц. В соответствии от полученного уровня RSSI от соседней ТД, сервер будет сравнивать его с RSSI Treshold и рекомендовать уменьшить(RSSI_ТД > RSSI_Treshold), либо увеличить мощность передатчика(RSSI_ТД < RSSI_Treshold). По умолчанию порог -70dbm.

RSSI Threshold Hysteresis 2.4G - Гистерезис в диапазоне 2.4 ГГц. Разрешенная "погрешность" от порога, если полученный сигнал лежит в диапазоне RSSI Treshold+-2dbm, оптимизацию по мощности проводить не следует.

RSSI Threshold 5G - Порог уровня RSSI в диапазоне 5 ГГц. В соответствии от полученного уровня RSSI от соседней ТД, сервер будет сравнивать его с RSSI Treshold и рекомендовать уменьшить(RSSI_ТД > RSSI_Treshold), либо увеличить мощность передатчика(RSSI_ТД < RSSI_Treshold). По умолчанию порог -70dbm.

RSSI Threshold Hysteresis 5G - Гистерезис в диапазоне 5 ГГц. Разрешенная "погрешность" от порога, если полученный сигнал лежит в диапазоне RSSI Treshold+-2dbm, оптимизацию по мощности проводить не следует.

Optimization Interval - Интервал времени между циклами оптимизации в секундах. По умолчанию 0 – оптимизация мощности проводится 1 раз при подключении всех ТД к серверу, затем оптимизация будет проводиться только в случае отключения/подключения ТД к серверу.

Enable DCA - Включение/отключение работы Dynamic Channel Assignment - алгоритм назначения частотных каналов каждой подключенной к серверу ТД для минимизации интерференции между ними.

Reset APs - Функция сброса каналов и излучаемой мощности перед оптимизацией в дефолт.(Отладочная функция, использование на сети не рекомендуется)

Submit - Клавиша применения конфигурации, а так же ручного запуска оптимизации. При нажатии отправляет всем ТД команду на переподключение к сервису и началу новой оптимизации.

Важно: RRM сервис при автоматическом распределении излучаемой мощности и рабочих каналов учитывает только ТД подключенные к сервису.

Настройка подключения точек доступа к сервису RRM

Подключение к сервису RRM на точке доступа можно настроить через GUI EMS

Для настройки подключения точки с сервису RRM необходимо перейти в раздел Конфигурация → RRM сервис, указать адрес Service URL =

ws://<IP адрес APB>:8090/apb/rrm