Оглавление |
---|
Описание
Сервис Модуль 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
где <IP адрес APB> - адрес APB, доступный из сети управления точками доступа.
Мониторинг сервиса RRM
Для мониторинга сервиса RRM необходимо перейти на WEB страницу:
http://<IP адрес APB>:8090/apb/rrm.jsp
- Domain - Географический домен точек доступа (AP-location). Оптимизация проводится между ТД в рамках одного домена.
- Mac - Mac адрес точки доступа.
- Board - Название устройства.
- HW rev - Ревизия платы устройства.
- Serial - Серийный номер устройства.
- Session - Обозначение сессии ТД с APB сервером.
- Radios - В данной колонке отображаются сведения о подключенной ТД (Статус радиоинтерфейса, текущая и максимальная мощность, номер канала, ширина используемой полосы)
- Visible members - При нажатии клавиши отображаются сведения о видимых ТД (Mac адрес устройства, уровень сигнала, номер канала, ширина используемой полосы)