Eltex Documentation
Дерево страниц
Перейти к концу метаданных
Переход к началу метаданных

Описание

MAC Checker - сервис, который предоставляет API на основе REST, с помощью которого можно получить статус точки доступа ОТТ по ее MAC-адресу на сервере SoftWLC.

Точка доступа ОТТ может находиться в следующих состояниях:

СтатусРасшифровкаПричина
No MAC detectedMAC-адрес не известенЛибо запросы от точки доступа не дошли до Сервис-Активатора, либо проблема в сертификате или ПО точки, либо точка вообще не ОТТ. Нужно смотреть логи Сервис-Активатора.
No init linkТочка в песочницеСервис-Активатор успешно получил и обработал запросы от точки доступа, но в SoftWLC для точки не создана привязка правила инициализации и не создана "ott_default" привязка (см. документацию по ОТТ).
No OTT linkнет OTT привязкиВ домене, который указан в привязке правила инициализации для точки, отсутствует OTT ESR с привязанным OTT профилем.
Default Domainточка в домене из списка defaultТочка успешно проинициализировалась и попала в домен, указанный в конфигурации MAC Checker, как дефолтный.
Region Domainточка в домене не из списка defaultТочка успешно проинициализировалась и попала в домен, НЕ указанный в конфигурации MAC Checker, как дефолтный.

MAC Checker должен быть запущен на отдельном сервере, к которому есть доступ из сети Интернет (имеет белый IP-адрес или на него проброшен порт).

По умолчанию сервис запускается на порту 8088. Сервис принимает запросы от клиента на проверку MAC-адреса, направляет соответствующие запросы в ядро через EMS NBI, принимает ответ от ядра и формирует JSON-ответ для клиента. В ответе содержится:

  • текущее время,
  • нормализованный MAC-адрес, 
  • статус принадлежности, 
  • имя домена,
  • возникшая в процессе обработки ошибка.

Сервис должен иметь IP-связность с сервисом EMS по порту 8080.


Управление сервисом

Установка сервиса

apt-get install eltex-ott-mac-checker


Способы запуска/остановки

ДействиеКомандаОтвет
Проверка состоянияservice eltex-ott-mac-checker status

Сервис запущен

Active: active (running)

Cервис не запущен

Active: failed

Запуск сервисаservice eltex-ott-mac-checker start

Сервис успешно запущен

Active: active (running)

Остановка сервисаservice eltex-ott-mac-checker stop

Сервис успешно остановлен

Active: failed

Перезапуск сервисаservice eltex-ott-mac-checker restart

Сервис успешно перезапущен

Active: active (running)

Пример запроса

Пример запроса к сервису с помощью утилиты curl:

curl -g http://192.168.42.197:8088/ottChecker/checkMac?mac=a8:f9:4b:22:22:22 --header "Accept: application/json"

Ответ:

{"time":1536304889422,"macAddress":"a8:f9:4b:22:22:22","status":"No MAC detected","information":null,"error":{"code":null,"description":null}}


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

/etc/eltex-ott-mac-checker/application.conf

/etc/eltex-ott-mac-checker/application.conf 
service {
    # One of: debug, info, warn, error
    logLevel = info
    gelfHost = "udp:lab3-test.eltex.loc"
    gelfPort = 12201
    gelfLevel = off
}

server {
    # Таймаут запросов
    requestTimeout = 45

    # Порт для прослушивания
    port = 8088
}

ems {
    # Адрес EMS-сервера
    host = "localhost"

    # Порт для связи с EMS
    port = 8080
}

domain {
    # Список доменов по умолчанию
    #
    # Массивом
    # default = [ "default.root" , "ott.root" ]
    #
    # Через запятую
    # default = "default.root,ott.root"
    #
    # Через точку с запятой
    # default = "default.root;ott.root"
    #
    # Или просто строкой
    # default = "ott.default"

    default = [ "default.root" , "ott.root" ]
  • Уровень логирования. Может принимать значения: debug, info, warn, error
logLevel = info
  • Блок настройки пересылки логов в Graylog:
    gelfHost = "udp:lab3-test.eltex.loc"
    gelfPort = 12201
    gelfLevel = off
  • Время ожидание ответа на запрос:
requestTimeout = 45
  • Порт, на котором работает сервис:
port = 8088
  • Адрес и порт для подключения к сервису EMS:
    host = "localhost"
    port = 8080
  • Список доменов по умолчанию. В комментариях описаны способы задания:
default = [ "default.root" , "ott.root" ]


Журнал работы находится в папке /var/log/eltex-ott-mac-checker.



  • Нет меток