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

Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Оглавление

Metadata list
hiddentrue
|| Device | SoftWLC |
|| DocMainTitle | Руководство администратора |
|| DocTitle3 | Eltex NBI |
|| fwversion | 1.8 |
|| issueDate | 26.10.2017 |


Описание


Интерфейс обеспечивает связь между компонентами SoftWLC, основан на протоколе SOAP. Используется для поддержки работы сервисов: Личный кабинет, конструктор порталов, PCRF, а также позволяет проводить интеграцию с вышестоящими OSS/BSS. Служит для генерации сертификатов для TLS-авторизации.

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

Блок кода
languagebash
themeRDark
apt-get install eltex-axis
apt-get install eltex-radius-nbi


Предупреждение

Для установки сначала нужно развернуть пакет eltex-axis, а затем eltex-radius-nbi (При нарушении этого порядка возможны проблемы в работе сервиса).


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


Интерфейс работает под tomcat (версии 7 и выше), поэтому отдельных команд для запуска/остановки не предусмотрено.



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


/etc/eltex-radius-nbi/radius_nbi_config.txt

Содержит параметры для подключения к сервисам системы SoftWLC.

  • Настройки подключения к базам данных MySQL. Для подключения к каждой базе могут использоваться отдельные параметры (в конце файла прописывается подключение к БД ELTEX_PORTAL, которое тоже нужно настроить!), в качестве примера приведено подключение к БД radius.

Без форматирования
# DB  radius(alias=radius)
radius.jdbc.driver=org.gjt.mm.mysql.Driver
radius.jdbc.dbUrl=jdbc:mysql://localhost/radius?zeroDateTimeBehavior=convertToNull&useUnicode=true&characterEncoding=utf8&relaxAutoCommit=true&connectTimeout=5000
radius.jdbc.username=javauser
radius.jdbc.password=javapassword
radius.jdbc.maxPoolSize=48
radius.jdbc.inUse=yes
  • Подключение к northbound EMS, необходимо для отправки команд в сервис eltex-ems:
Без форматирования
# адрес ems-northbound
ems.nbi.host=127.0.0.1
ems.nbi.port=8080
ems.nbi.path=northbound
ems.nbi.protocol=http
  • Подключение к eltex-auth-service по протоколу ssh, необходимо для перезапуска сервиса в случае изменения таблицы NAS через Личный кабинет:
Без форматирования
# eltex_auth_service
auth.port=22
auth.host=127.0.0.1
auth.username=username
auth.password=password
  • Подключение к eltex-radius по протоколу ssh, необходимо для перезапуска сервиса в случае изменения таблицы NAS:
Без форматирования
# freeradius-domain-1
freeradius-domain-1.port=22
freeradius-domain-1.host=192.168.0.1
freeradius-domain-1.username=username
freeradius-domain-1.password=password
  • Адрес Tomcat, доступный для пользователей ЛК. Используется для формирования ссылок на файлы отчетов и TLS-сертификатов для пользователей.
Без форматирования
# tomcat url
tomcat.host=127.0.0.1
tomcat.port=8080
  • Подключение к сервису PCRF:
Без форматирования
# pcrf stuff
pcrf.enabled=true
pcrf.url=http://localhost:7070
pcrf.username=admin
pcrf.password=password
pcrf.readtimeout=11
pcrf.writetimeout=1
  • Подключение к кластеру MongoDB к базе pcrf:
Без форматирования
# pcrf mongodb connector
pcrf.mongodb.enabled=true
pcrf.mongodb.uri=mongodb://localhost:27017/pcrf
  • Подключение к кластеру MongoDB к базе wifi-customer-cab:
Без форматирования
# wifi-customer-cab mongodb connector
wificab.mongodb.enabled=true
wificab.mongodb.uri=mongodb://localhost:27017/wifi-customer-cab
  • Настройка подключения к БД SORM2 (Mongo):
Без форматирования
# Eltex.SORM2.replicator MongoDB 'sorm2' connect
sorm2.mongodb.enabled=false
sorm2.mongodb.uri=mongodb://localhost:27017/sorm2
  • Подключение к сервису SORM2:
Без форматирования
# Eltex.SORM2.replicator host to use API
sorm2.enabled=false
sorm2.url=http://localhost:7071
sorm2.username=admin
sorm2.password=password
  • Активация функционала СОРМ-3. Активируется проверка полей "ФИО" и "номер телефона" у оператора при работе с учетными записями пользователей Wi-Fi. Поля "ФИО" и "номер телефона" становятся обязательными у пользователей Wi-Fi.
Без форматирования
#It enables records export to SORM3 while editing wifi users
sorm3.enabled=false
  • Настройка таймаута для загрузки статистики в Личном кабинете. По умолчанию значение равно 90000мс.
Без форматирования
# wifi-customer-cab request settings
wificab.timeout=90000
  • Активация и настройка коннектора для подключения к БД mongo, для работы со схемой подключения устройств OTT:
Без форматирования
# ott mongodb connector
ott.mongodb.enabled=true
ott.mongodb.uri=mongodb://localhost:27017/ott
  • Активация и настройка параметров для работы методов NBI с SSO:
Без форматирования
# SSO settings
sso.enabled=false
sso.clientSecret=
sso.clientId=

# SSO REST
sso.rest.server.protocol=http
sso.rest.server.address=
sso.rest.server.port=80
sso.rest.server.timeout.sec=10
sso.rest.protocol.version=2.0
sso.rest.username=
sso.rest.password=

sso.rest.getToken.path=/apiman-gateway/b2b_test/getToken
sso.rest.getUserInfo.path=/apiman-gateway/b2b_test/getUserInfo
sso.rest.addUser.path=/apiman-gateway/b2b_test/addUser
sso.rest.updateUser.path=/apiman-gateway/b2b_test/updateUser
sso.rest.delUser.path=/apiman-gateway/b2b_test/delUser
sso.rest.addUserParam.path=/apiman-gateway/b2b_test/addUserParam
sso.rest.delUserParam.path=/apiman-gateway/b2b_test/delUserParam
sso.rest.getUserByName.path=/apiman-gateway/b2b_test/getUserByName
sso.rest.getUserByEmail.path=/apiman-gateway/b2b_test/getUserByEmail
sso.rest.resetPassword.path=/apiman-gateway/b2b_test/resetPassword
sso.rest.getUserByParam.path=/apiman-gateway/b2b_test/getUserByParam
  • Настройка доступа до БД eltex-portal:
Без форматирования
###########################################################################
##########################DB ELTEX_PORTAL settings#########################
###########################################################################
portal.db.driver=com.mysql.jdbc.Driver
portal.db.url=jdbc:mysql://localhost:3306/ELTEX_PORTAL?max_allowed_packet=32362048&useUnicode=true&characterEncoding=utf8
portal.db.username=javauser
portal.db.password=javapasswor
  • Настройка доступа до сервиса eltex-ngw:
Без форматирования
# NGW
ngw.url=http://127.0.0.1:8040
  • Настройка доступа до сервиса eltex-doors:
Без форматирования
# DOORS
doors.url = http://localhost:9097/
doors.timeout = 60
doors.username = user
doors.password = password
  • Настройка доступа до API-Elvis ( на сервисе eltex-portal-constructor):
Без форматирования
# ELVIS
elvis.url=http://localhost:9001/epadmin/
elvis.timeout=60

/etc/eltex-radius-nbi/hikari.properties

Для взаимодействия eltex-radius-nbi с БД mysql использует пул соединений  hikari cp.

  • Максимальное время ожидания соединения:
Без форматирования
# ConnectionTimeout property controls the maximum number of milliseconds that a client (that's you) will wait for a connection from the pool.
connectionTimeout=15000
  • Период времени, в течение которого соединение проверяется на доступность, должен быть меньше чем connectionTimeout:
Без форматирования
# ValidationTimeout property controls the maximum amount of time that a connection will be tested for aliveness.
validationTimeout=3000
  • Таймаут в течение которого, соединению можно бездействовать. Минимальное значение 10000(10 секунд), максимальное 600000 (600 секунд):
Без форматирования
# IdleTimeout property controls the maximum amount of time that a connection is allowed to sit idle in the pool.
idleTimeout=30000
  • Минимальное количество свободных соединений, которые hikari cp поддерживает в пуле:
Без форматирования
# MinimumIdle property controls the minimum number of idle connections that HikariCP tries to maintain in the pool.
minimumIdle=1


Документация по командам


Актуальная документация по командам содержится в пакете eltex-radius-nbi. К ней можно получить доступ после установки пакета по ссылке http://localhost:8080/eltex-radius-nbi/asciidoc/.

WSDL файл можно получить по ссылке http://localhost:8080/axis2/services/RadiusNbiService?wsdl.

Вместо localhost нужно указать ip-адрес сервера, на котором установлен NBI.