Описание

Сервис 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 

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

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

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