Описание

Модуль выполняет функции:

Выгрузка данных об абонентах и WIFI-базовых станциях из системы SoftWLC.
Отправка сформированных данных на FTP сервер.

Подробное описание интеграции: v1.25_Интеграция с системами СОРМ

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

Установка приложения

apt install eltex-radius-sorm3

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

Запуск приложения выполняется с помощью cron.

Периодичность запуска определяется в файле:

/etc/cron.d/sorm_export

Файл sorm_export:

sorm_export

# read & export data каждый день
MAILTO=""
0 4 * * * root /usr/share/eltex-radius-sorm3/export_sorm.sh

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

/etc/eltex-radius-sorm/eltex-radius-sorm3.conf

Содержит параметры для запуска приложения. Пример дефолтной конфигурации:

/etc/eltex-radius-sorm/eltex-radius-sorm3.conf

[radius-data]
app_name=eltex-radius-sorm3-federal.jar
nbi_ip=localhost
nbi_port=8080
auth_username=admin
auth_password=password
export_path=/var/log/eltex-radius-sorm3/export_data
domain=
ftp_url=ftp://admin:password@192.168.0.1:/ftp/
start_count=128
max_count=1024
skip_with_regionId_eq_0=true

Параметры	Описание
app_name	Файл приложения (изменять нельзя)
nbi_ip	IP-адрес хоста с сервисом eltex-radius-nbi
nbi_port	Порт хоста с сервисом eltex-radius-nbi
auth_username	Логин для доступа к сервису eltex-radius-nbi
auth_password	Пароль для доступа к сервису eltex-radius-nbi
export_path	Путь для формирования файлов выгрузок данных, полученных от eltex-radius-nbi
domain	Домен (и его дочерние домены), для которых будет выполняться выгрузка информации. Если не указан - выгрузка выполняется для всех доменов.
ftp_url	Путь к FTP-серверу для отправки на него выгруженных файлов
start_count	Начальное число записей запрашиваемых при старте. Если скорость получения данные высока - число увеличивается в процессе работы
max_count	Максимальное число записей запрашиваемых за один запрос
skip_with_regionId_eq_0	Пропускать домены с пустым полем REGION_ID

/etc/eltex-radius-sorm/log4j2.xml

Файл настроек логирования:

/etc/eltex-radius-sorm/log4j2.xml

<?xml version="1.0" encoding="UTF-8"?>

<!--
    Use log4j version 2.0.beta8 - Eltex Radius Northbound

   configuration -  monitorInterval="30" - для перечитки конфиг-файла каждые 30 сек - для отслеживания изменений.
-->

<configuration monitorInterval="600">
    <properties>
        <property name="basedir">/var/log/eltex-radius-sorm3</property>
        <property name="maxSize">20 MB</property>
        <property name="maxCount">3</property>
        <property name="defaultPattern">%d{ISO8601} [%t] %-5p %logger{1} %C{1}.%M(line:%L). %m%n</property>
        <Property name="dateSuffix">%d{yyyyMMdd}</Property>

        <property name="gelfHost">udp:lab3-test.eltex.loc</property>
        <property name="gelfPort">12201</property>
        <property name="gelfLevel">OFF</property>
    </properties>

    <appenders>

        <RollingFile name="sorm3_debug" fileName="${basedir}/sorm3_debug.log"
                     filePattern="${basedir}/debug/sorm3_debug-${dateSuffix}-%i.log.gz">
            <ThresholdFilter level="INFO" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout>
                <pattern>${defaultPattern}</pattern>
            </PatternLayout>maxSize
            <!-- Правило по размерам файла (например, нарезать новые через каждые 10Мб) -->
            <SizeBasedTriggeringPolicy size="${maxSize}"/>
            <!-- Ограничение на кол-во файлов. -->
            <DefaultRolloverStrategy max="${maxCount}"/>
        </RollingFile>

        <RollingFile name="sorm3_error" fileName="${basedir}/sorm3_error.log"
                     filePattern="${basedir}/error/sorm3_error-${dateSuffix}-%i.log.gz">
            <ThresholdFilter level="ERROR" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout>
                <pattern>${defaultPattern}</pattern>
            </PatternLayout>
            <SizeBasedTriggeringPolicy size="${maxSize}"/>
            <DefaultRolloverStrategy max="${maxCount}"/>
        </RollingFile>

        <Gelf name="Gelf" host="${gelfHost}" port="${gelfPort}" version="1.1" facility="eltex-radius-sorm3"
              extractStackTrace="true" originHost="%host{fqdn}" maximumMessageSize="8192" >
            <Field name="thread" pattern="%t" />
            <Field name="level" pattern="%level" />
            <Field name="severity" pattern="%-5level" />
            <Field name="logger" pattern="%logger{1}" />
            <Field name="location" pattern="%C{1}.%M(line:%L)" />
        </Gelf>

    </appenders>


    <loggers>
        <root level="INFO">
            <appender-ref ref="sorm3_debug"/>
            <appender-ref ref="sorm3_error"/>
            <appender-ref ref="Gelf" level="${gelfLevel}"/>
        </root>
    </loggers>

</configuration>

Директория хранения логов:

<property name="basedir">/var/log/eltex-radius-sorm3</property>

Максимально допустимый размер файла логов (при его превышении создается новый файл, а старый архивируется):
```
<property name="maxSize">20 MB</property>
```

Максимальное количество архивных файлов, при его превышении наиболее старые файлы будут перезаписываться:
```
<property name="maxCount">3</property>
```

Блок настройки перенаправления логов в Graylog (адрес, порт, выкл/вкл отправку):

<property name="gelfHost">udp:lab3-test.eltex.loc</property>
<property name="gelfPort">12201</property>
<property name="gelfLevel">OFF</property>

Уровень логирования:
```
<root level="INFO">  
```

Дерево страниц

v1.25_Radius-SORM3