Описание
...
MAC Checker - сервис, который предоставляет API на основе REST, с помощью которого можно получить статус точки доступа ОТТ по ее MAC-адресу на сервере SoftWLC.
Точка доступа ОТТ может находиться в следующих состояниях:
Статус | Расшифровка | Что скорее всего произошлоПричина |
---|
No MAC detected | MAC-адрес не известен | Либо запросы от точки доступа не дошли до Сервис-Активатора, либо проблема в сертификате или ПО точки, либо точка вобще вообще не ОТТ. Нужно смотреть логи Сервис-Активатора. |
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.Настройка модуля производится в файле /etc/
Установка сервиса
Блок кода |
---|
|
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 | Сервис успешно остановлен
|
Перезапуск сервиса | 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
Блок кода |
---|
|
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
- Блок настройки пересылки логов в Graylog:
Блок кода |
---|
|
gelfHost = "udp:lab3-test.eltex.loc"
gelfPort = 12201
gelfLevel = off |
- Время ожидание ответа на запрос:
Блок кода |
---|
|
requestTimeout = 45 |
- Порт, на котором работает сервис:
- Адрес и порт для подключения к сервису EMS:
Блок кода |
---|
|
host = "localhost"
port = 8080 |
- Список доменов по умолчанию. В комментариях описаны способы задания:
Блок кода |
---|
|
default = [ "default.root" , "ott.root" ] |
Журнал работы находится в папке /var/log/eltex-ott-mac-checker.
q