Конфигурационные файлы

/usr/lib/eltex-ems/conf/config.txt

Файл содержит настройки пулов для подключения к базам данных. Для примера рассмотрим настройку пула для подключения к БД радиус:

# DB  radius(alias=radius)
poolName9=radius
radius.jdbc.driver=org.gjt.mm.mysql.Driver
radius.jdbc.dbUrl=jdbc:mysql://localhost/radius?useUnicode=true&characterEncoding=utf8&relaxAutoCommit=true&connectTimeout=5000
radius.jdbc.username=javauser
radius.jdbc.password=javapassword
radius.jdbc.maxPoolSize=40
radius.jdbc.inUse=yes
# remote db host access with su privileges
# radius.ssh.login=
# radius.ssh.password=
# radius.ssh.port=

Параметры на которые нужно обратить внимание:

poolName9 - название базы данных.

radius.jdbc.dbUrl - адрес для подключения к базе данных.

radius.jdbc.username - логин для подключения к базе данных.

radius.jdbc.password - пароль для подключения к базе данных.

radius.jdbc.maxPoolSize - количество коннектов, которые сервер EMS может открыть для подключения к БД. Необходимое количество коннектов зависит от нагрузки на сервер, таблица для расчета приведена в настройках базы данных MySQL. Если не планируется поддержка устройств ONT или CPE, то количество коннектов для пулов ont, cpe, cmds, inf, cache следует установить равным 0.

Группа настроек для подключения к серверу БД по ssh приведена для того, чтобы сервер EMS имел возможность выгружать некоторые дампы и файлы непосредственно с сервера БД.

/usr/lib/eltex-ems/conf/log4j2.xml

Конфигурация логгера EMS сервера. Файлы логов сервера EMS ограничиваются по размеру,

    <properties>
        <property name="basedir">/var/log/eltex-ems</property>
        <property name="maxSize">20 MB</property>
        <property name="maxCount">20</property>
        <property name="defaultPattern">%d{ISO8601} [%t] %-5p %logger{12} %x %C{1}.%M(line:%L). %m%n</property>
        <property name="monitorPattern">%d{ISO8601} [%t] %-5p %logger{12} %C{1}.%M(line:%L). %m%n</property>
    </properties>

basedir - основная директория для хранения лог-файлов.

maxSize - максимальный размер логфайла. При превышении этого размера лог-файл архивируется и начинает записываться новый.

maxCount - количество хранимых архивов лог-фалов (за день).

/usr/lib/eltex-ems/conf/system-config.txt

Файл содержит дефолтные настройки системы, которые используются при первой загрузке. В последствии некоторые параметры могут быть изменены из GUI EMS, однако настройки подключения можно изменить только в этом файле:

# server socket and socket handlers pool
gui.port=9310
gui.handler_pool_size=200
gui.connection.timeout.sec=300

gui.port - порт, который будет прослушиваться сервером для подключения GUI пользователей (используется для передачи данных в апплет пользователя).

gui.handler_pool_size - пул обработчиков пользовательских подключений.

gui.connection.timeout.sec - таймаут ожидания ответа от пользователя до разрыва соединения.

/etc/eltex-ems/gui.conf

Файл конфигурации пользовательского апплета.

log.level=INFO

ping.period=10
socket.timeout=300
#socket.port=9310

java.max_heap=700m
java.init_heap=250m

log.level - Уровень логирования в GUI : DEBUG, INFO, WARN, SEVERE, ERROR, FATAL. Логи сохраняются на компьютере пользователя, для windows путь хранения C:\Users\<UserName>\ems_log\.

socket.timeout - таймаут ожидания ответа от пользователя до разрыва соединения.

socket.port - порт, на который будет обращаться пользовательский апплет для получения данных от сервера. По умолчанию (если закомментирован) равен порту, который прослушивается сервером.

java.max_heap - ограничение на максимальное количество памяти, которое апплет будет занимать на ПК пользователя.

java.init_heap - количество памяти, которое апплет попытается занять при старте работы.

/etc/eltex-ems/check-ems-replication.conf

Конфигурация для проверки состояния репликации на серверах БД MySQL.

ENABLE_REPLICATION="No"

HOST1=192.168.56.100
HOST2=192.168.56.101

USER="root"
PASSWORD="root"

ENABLE_REPLICATION - статус проверки. "Yes" - проверка включена, "No" - выключена.

HOST1, HOST2 - адреса серверов БД

USER, PASSWORD - логин и пароль для подключения к консоли MySQL. Должны быть одинаковыми на обоих серверах и иметь привилегии для проверки статуса репликации.

/etc/default/eltex-ems

Файл содержит параметры запуска процесса eltex-ems.

# Location of java
JAVA=/usr/bin/java

# Maximum size of Java heap
JAVA_MAX_HEAP_MB=1576
# Initial size of Java heap
JAVA_INIT_HEAP_MB=256

# Options for Java Garbage Collector
GC_OPTS="-XX:+UseParallelGC -XX:MaxPermSize=512m -XX:PermSize=200m"

# Additional arguments to pass to java
JAVA_OPTS="-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/var/log/eltex-ems -Djava.security.egd=file:/dev/./urandom"

# Eltex.EMS home location
ELTEX_EMS_HOME="/usr/lib/eltex-ems"

# Set it more than (EMS tree objects number * 5)
FILE_LIMIT=16384

JAVA - расположение java-машины.

JAVA_MAX_HEAP_MB - максимальное количество памяти, которое будет забирать сервер EMS на свою работу. Если памяти не хватает, возможны ошибки типа OutOfMemory.

JAVA_INIT_HEAP_MB - количество памяти с которым стартует сервер EMS.

GC_OPTS - опции запуска сборщика мусора.

JAVA_OPTS - дополнительные опции запуске EMS сервера.

ELTEX_EMS_HOME - каталог с системными файлами EMS сервера.

FILE_LIMIT - ограничение на количество открываемых файлов. Устанавливается из расчете количество объектов в дереве умноженное на 5. При недостатке возможны перебои в работе сервера с ошибками вида 'java.io.IOException: Too many open files'.

Настройки GUI

Системные модули

Здесь содержаться настройки различных модулей, необходимых для работы сервера EMS.

pcrf

Модуль отвечает за взаимодействие с сервисом eltex-pcrf. Настраиваемые параметры:

Статус - включен/выключен.

URL - адрес для подключения к eltex-pcrf.

Таймаут соединения - время ожидания ответа от сервера eltex-pcrf.

Таймаут чтения/записи - время ожидания ответа от сервера eltex-pcrf.

radius

Настройка взаимодействия с сервером RADIUS. Необходимо для проверки состояния и перезапуска RADIUS сервера при обновлении таблицы NAS.

RADIUS service name - названия используемого сервиса. С версии SoftWLC 1.7 используется eltex-radius.

"Secret" for localhost - секретый ключ, котрый будет использовать сервер EMS для проверки состояния сервера RADIUS.

EMS host ip-address as RADIUS client - адрес EMS сервера с которого будет происходит обращение на RADIUS сервер.

Restart timeout - время ожидания подтверждения о выполнении перезапуска RADIUS сервера.

Min. restart interval - интервал между рестартами.

softwlc.nbi

Настройка взаимодействия с SoftWLC.NBI.

Статус - включен/выключен.

URL - ссылка для получения WSDL файла.

Username - логин для подключения к SoftWLC.NBI. 

Password - пароль для подключения к SoftWLC.NBI.

Connection timeout - время ожидания ответа при подключении.

Request timeout - время ожидания ответа при выполнении запроса данных.

system

Раздел содержит настройки работы основного модуля EMS.

Общие настройки

Язык интерфейса и системных сообщений - выбор языка интерфейса, доступны русский и английский языки.

IP адрес EMS сервера в управляющей сети станций - IP адрес интерфейса, с которого сервер EMS будет обращаться к точкам доступа.

Каталог временных файлов - адрес хранения временных файлов, создаваемых при работе сервера EMS.

Tomcat URL - URL адрес сервера EMS для доступа к нему из внешних сетей. Используется для скачивания данных с сервера на пользовательские ПК по протоколу HTTP.

Внутренний TOMCAT URL - URL адрес сервера EMS для доступа к нему из cети управления точками доступа. Используется для обновления прошивок точек доступа по протоколу HTTP.

Каталог общих файлов - каталог файлов, создаваемых EMS и требующих хранения, например шаблоны файлов конфигураций.

Каталог временных файлов БД - каталог для хранения временных фалойв, получаемых с БД, например дампов или архивов, которые будут в последствии отправлены на другой сервер.

Дополнительные команды -

Уровни логирования работы мониторов - глобальная установка уровня логирования мониторов EMS сервера (задачи по расписанию). Доступные значения: DEBUG, INFO, WARN, SEVERE, ERROR, FATAL

Посылать SNMP предзапрос 'Контроль доступности' - выполнение проверки доступности устройства перед выполнением операций конфигурирования.

Таймаут операции SNMP предзапроса - время ожидания ответа от устройства при проверке доступности.

Размер очереди для менеджера асинхронных задач - максимальное количество одновременно выполняемых асинхронных задач.

Время хранения записей в списке 'Задачи' - максимальное время хранения задач, по истечению которого задачи из списка будут удалены.

Опрос доступности (ICMP, SNMP ping) - включение/выключение механизма опроса устройств в дереве объектов.

Период опроса устройства (ICMP, SNMP ping) - интервал опроса устройств в дереве объектов. При большом количестве устройств система может не успевать выполнить опрос всех устройств в указанное время, в этом случае при запуске сервера будет отображаться сообщение о необходимости увеличить интвервал.

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

Период хранения результатов ICMP, SNMP запросов - период опроса, который будет хранится в памяти EMS. Более старые данные будут удаляться.

Таймаут проверки GUI сессии в состоянии 'Создана' - время проверки сессии после загрузки апплета.

Синхронизировать устройство после восстановления связи - механизм автоматической синхронизации устройств в случае если связь с ним была потеряна на длительное время (равное "Периоду, после которого запустится автосинхронизация"), а потом восстановлена.

Конфигурация устройства после восстановления связи - механизм, выполняющий конфигурирование устройства в соответствии с действующей привязкой инициализации.

Период, после которого запустится автосинхронизация - интервал времени между событиями потери и восстановления связи к объекту, при превышении которого запускается автоинициализация и конфигурирование.

Режим ACS.GUI - режим работы ACS.

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

HTTP таймаут - время ожидания ответа ответа на запросы по протоколу HTTP.

Тип доступа к устройствам системы - выбор механизма определения области видимости объектов системы для пользователей. При использовании доменной системы видимость объекта определяется по совпадению доменов пользователя и объекта. В системе по ролям зоны видимости по узлам в дереве объектов.

Проверять хостнейм для всех устройств - функция проверки hostname у устройств в дереве объектов. В случае если имя объекта в дереве не совпадает с hostname устройство помечается как аварийное.

Показывать дополнительные параметры доступа/инициализации - дополнительные опции при инициализации точек доступа, включают в себя адрес инсталляции.

Настройки апплета (GUI)

Заголовок аплета - отображается в заголовке окна.

Скрывать панель "Задачи" - при запуске аплета панель с асинхронными задачами будет скрыта.

Отображать кнопку "Помощь" рядом с параметром - рядом с параметрами появляется дополнительная кнопка с кратким описанием.

Сохранять значение фильтров поиска при выходе из вкладки - сохранение фильтров на вкладках, например на вкладке "Список устройств".

Режим автоматического выбора запомненной вкладки - при переходе на устройство будет открыта последняя открытая вкладка для этого типа устройств.

Приоритет аварий для сигнализации в дереве объектов - уровень аварии на устройстве, достаточный чтобы попасть в список активных аварий.

Включить модуль мониторинга RRD - включение/отключение модуля мониторинга RRD.

Отображать количество записей в таблицах - отображение счетчика числа записей в таблицах. Рекомендуется отключать в высоконагруженных системах.

Настройка подсистемы высылки сообщений из журнала трапов на внешнюю систему

Включить сервис - статус сервиса вкл/выкл.

Включить стартовый трап системы EMS -отправка специального трапа при старте сервера EMS.

Тип отправляемого сообщения - тип сообщения trap/inform.

Адрес приемника - IP адрес сервера, обрабатывающего сообщения от EMS.

Порт приемника - порт, прослушиваемый сервером-обработчиком.

Количество повторов informv2 - количество повторных отправок сообщений, если не пришло подтверждение о доставке.

Таймаут повтора informv2 - интвервал времени между повторными отправками.

Системный OID, с которого отправляется трап - информационное поле.

Системный OID, означающий тип нотификации - информационное поле.

Включить транслитерацию - конвертация русскоязычных символов в сообщении в лаитиницу.

SNMP trap community - имя сообщества.

Список приоритетов отправляемых событий - может принимать значения DEBUG, INFO, WARN, SEVERE, ERROR, FATAL.

Отправка аварийных сообщений на почту

Отправка сообщений об авариях на почту по протоколу SMTP.

Включить сервис - статус сервиса вкл/выкл.

Адрес сервера - IP адрес SMTP сервера.

Порт сервера - порт, прослушиваемый SMTP сервером.

Логин - логин учетной записи для на SMTP сервере.

Пароль - пароль от учетной записи на SMTP сервере.

Имя сервера - доменное имя SMTP сервера.

Первая строка содержимого письма - информационное поле, содержит пример сообщения в письме.

От кого (адрес отправителя) - email пользователя. от имени которого отправляется сообщение.

EMail адрес службы поддержки - адрес техподдержки, который будет указан в конце письма для обратной связи.

tftpserver

IP адрес для станционных устройств – общий адрес, который используется для работы со станционными устройствами;

Порт (для встроенного TFTP) – порт локального (встроенного в  EMS) TFTP сервера, возможные значения  1..65535 (по умолчанию 69);

Каталог корневой службы – каталог корневого сервиса tftpd;

Подкаталог станционного ПО – имя подкаталога для файлов станционного ПО, поле не редактируется;

Подкаталог файлов конфигурации – имя подкаталога для файлов конфигурации, поле не редактируется;

Трассировка взаимодействия – вывод отладочных сообщений в лог;

Включить встроенный TFTP сервер – использовать TFTP-сервер, встроенный в систему EMS, иначе - использовать сервер TFTP на том же хосте вне системы EMS.

wirelessCommon

Максимальное время хранения информации о ТД - время хранения информации. полученной при открытии вкладок конфигурации точки доступа.

Путь к файлам статических IP адресов DHCP серверов - (функционал не используется).

Автоматическая инициализация - автоматическая инициализация точек доступа от которых были получены трапы присутствия. Функция должна быть активна для автоматической обработке смены IP адресов точками доступа.

Разрешить установку SSID на WDS радиоканалы - по умолчанию функция выключена, т.к. настройка дополнительных SSID вместе с WDS снижает общую скорость передачи данных.

Выключать SSID не имеющие привязки - при работе монитора проверки SSID на точках доступа будут выключаться все SSID, для которых не создана привязка к этой точке доступа в менеджере SSID.

Права и пользователи

Домены

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

Доступность для управления и мониторинга узлов (групп) точек доступа или единичных точек доступа определяется доменом. В случае если домен, указанный в роли, совпадает с доменом группы или точки доступа, то пользователь SoftWLC, которому присвоена данная роль, будет обладать правами работы с точкой доступа или группой точек доступа. Также Пользователь сможет иметь права на управление ТД или группой, если его домен находится на уровень выше, но при этом совпадает на аналогичном уровне с доменом ТД или группы.

Типы доменов

Возможности системы позволяют создавать SSID с любым доменом на любой точке доступа. Таким образом можно организовывать общую Wi-Fi сеть в различных регионах, при этом пользователь с одной и той же учетной записью сможет авторизоваться на всей этой сети. В связи с этим возникает необходимость в создании отдельных веток доменов для точек доступа и для SSID (а также пользователей, потому что их домены совпадают). Для такого разделения в систему была добавлена типизация доменов:

'ap' - домены, предназначенные для работы с точками доступа. При создании такого домена в дереве объектов автоматически создается узел, в который могут быть помещены новые точки доступа.

'service' - предназначены для использования в настройках SSID, учетных записей пользователей, виртуальных порталов и других сервисных объектов.

'both' - универсальный тип, объединяет в себе все функции. Используется в схемах. где отсутствует необходимость в разделении доменов по типам.

Работа с доменами

Роли

В качестве базового принципа разделения прав используется механизм ролей. Роль — это логическая сущность, которая содержит в себе следующие данные:

• Имя роли;
• Текстовое описание;
• Время бездействия (сек);
• Список разрешённых действий с объектами:
• Список разрешённых узлов и объектов;
• Параметры регистрации на аварии:
  • Информационные (Info);
  • Предупреждения (Warning);
  • Не важные (Minor);
  • Важные (Major);
  • Критические (Critical).

В системе присутствует одна базовая роль администратора, которая называется «SuperUser». Эту роль запрещено редактировать. Она автоматически имеет все права на все объекты.

Все прочие роли настраиваются администратором, согласно должностным обязанностям операторов и логической разбивке по устройствам или территориальному принципу. 
Пользователь системы — это логическая сущность, предназначенная для авторизации входа в систему. Каждый пользователь имеет следующий набор параметров:

• Имя;
• Пароль;
• Описание;
• Роль;
• Дата окончания действия учётной записи;
• Адрес электронной почты;
• Пересылка сообщений на электронную почту пользователя;
• Блокировка;
• Включение многопользовательского режима.

При создании нового пользователя обязательно заполнение всех полей. Имя и пароль требуются для каждого входа в систему (авторизация), роль определяет перечень разрешённых действий, а дата окончания действия учётной записи регулирует время действия записи и проверяется при каждой авторизации.

Настройка ролей и пользователей доступна для пользователей системы с правами «Редактировать права и роли». Добавление и редактирование ролей производится путём вызова пункта меню «Администрирование/Права и пользователи/Настройка ролей пользователей». При выборе этого пункта меню программа выдаст диалог, в котором можно редактировать роли (кроме системных ролей «SuperUser» и «NorthBound»), а также добавлять и удалять роли.

Есть возможность настройки времени бездействия для роли – это время в секундах, начиная с последней операции, выполненной пользователем с данной ролью, по истечении которого сессия будет завершена. Для задания бесконечного времени бездействия используется значение «0».

Для каждой роли существует перечень разрешений, который можно изменить, перейдя в меню «Редактировать привилегии».Привилегии сгруппированы в разделы по основным модулям. Все действия по настройке системы управления собраны в разделе «system». Настройка прав на действия с устройствами wireless и конфигурирование основных параметров ТД производится во вкладке «Wireless Common». Для каждой привилегии есть возможность просмотра расположения акций, входящих в состав данной привилегии (кнопка  слева от привилегии).

В настройке роли в разделе «Регистрация на аварии» указываются уровни аварий, которые необходимо отправлять пользователю с данной ролью, подписанному на отправку аварий на почту (E-mail).
Для каждой роли, помимо закреплённых за ней прав, необходимо также задать и область действия этих прав. Для разграничения по группам объектов и узлов можно использовать настройку списка разрешенных объектов либо домен. Настройка производится в файле /usr/lib/eltex-ems/conf/system-config.txt. Для работы с доменами нужно задать «user_access_type=BY_DOMAIN», с ролями – «user_access_type= BY_ROLE». 

При выборе типа доступа пользователей по ролям при редактировании роли необходимо отметить флагом «Разрешить»соответствующие узлы в правой части диалога настройки роли. При разрешении доступа к узлу для данной роли происходит автоматическое разрешение на все вложенные узлы и объекты. Для конфигурирования полного доступа к дереву необходимо выдать разрешение на корневой узел «RootNode».

Перечень привилегий

Пользователи

Мониторы

Архивация и рассылка лог-файлов

Выгрузка конфигураций

Диагностика сервера EMS

Диагностика системы резервирования

Контроль размеров пулов системы

Контроль соответствия состава 'дерева' и таблицы NAS

Контроль температуры

Монитор автозакрытия сессий RADIUS

Опрос списка конкурентных точек доступа

Очистка базы syslog сервера

Проверка и исправление SSID привязок

Проверка расписания работы SSID

Проверка соединения с БД

Резервное копирование БД RADIUS

Резервное копирование СУ

Синхронизация событий

Синхронизация устройств

Сканирование версий ПО

Удаление старых лог-файлов

Хранить 3 года статистику Wi-Fi подключений

Экспорт журнала сообщений

eltex-ems-db                         3.11-432