Описание
В состав SoftWLC включен WEB-портал, с помощью которого реализуется модель авторизации hotspot-клиентов. Неизвестный системе пользователь может свободно (без получения заранее логина и пароля) подключиться к точке доступа, но при попытке выйти в интернет через браузер пользователь перенаправляется на страницу WEB-портала, на которой может по выбору пройти процедуру авторизации или получения авторизационных данных (например, с помощью SMS). В процессе выполнения процедур авторизации абонент может наблюдать рекламные сообщения в виде баннеров, кастомизированных в соответствии с требованиями оператора.
Данный сервис используется для отображения страниц виртуальных порталов и проведения регистрации и авторизации Wi-Fi пользователей, подключающихся на точках доступа Eltex или при помощи ESR/BRAS.
Установка выполняется при помощи пакета eltex-portal.
Во время инициализации сервиса eltex-portal и до момента пока сервис полностью не загрузится, вместо портала будет отображаться страница "Warming up". Что свидетельствует о том, что портал еще в процессе инициализации, а модули сервиса находятся в процессе конфигурации. После того как сервис eltex-portal полностью загрузился, будет произведен автоматический редирект пользователя на главную страницу портала.
Пример страницы инициализации портала:
Управление сервисом
Действие | Команда | Ответ |
---|---|---|
Проверка состояния | service eltex-portal status | Сервис работает eltex-portal start/running, process <pid> Сервис не работает eltex-portal stop/waiting |
Запуск сервиса | service eltex-portal start | Сервис запустился eltex-portal start/running, process <pid> Сервис уже работает start: Job is already running: eltex-portal |
Остановка сервиса | service eltex-portal stop | Сервис успешно остановлен eltex-portal stop/waiting Сервис не остановлен, т.к. не был запущен stop: Unknown instance: |
Перезапуск сервиса | service eltex-portal restart | Сервис успешно перезапущен eltex-portal stop/waiting eltex-portal start/running, process <pid> stop: Unknown instance: eltex-portal start/running, process <pid> |
Конфигурация
/etc/eltex-portal/application.conf
основной конфигурационный файл. Пример дефолтной конфигурации:
Параметры | Описание |
---|---|
portal | |
defaultRedirectUrl | Адрес, на который будет выполнено перенаправление пользователя в случае когда необходим перезапустить его сессиию на портале. Должен быть настроен по протоколу http. |
tariffCheckerPeriod | Интервал выполнения проверки наличия тарифных планов на порталах. В случае отсутствия тарифного плана формируется сообщение об ошибке. |
jetty | |
https | Настройки работы контейнера по https. Необходимо указать расположение сертификата, ключ и прослушиваемый порт. port - прослушиваемый порт keystorePass - ключ от хранилища сертификатов keystoreFile - файл хранилища, содержащий сертификат keystoreType - тип хранилища certAlias - алиас сертификата в хранилище ciphers - поддерживаемые методы шифрования |
accessLog | Логирование запросов на сервис. enabled - статус логирования directory - директория сохранения логов format - форма логов default - стандартный формат NCSA, custom - расширенный формат для отладки append - продолжение записи существующего файла после перезапуска сервиса retrainDays - время хранения логов append - дополнительная информация logCookies - сохранение cookie в логах logAP - сохранение заголовков переданных точкой доступа logBRAS - сохранение данных, переданных BRAS'ом |
database | |
host | Адрес сервера БД |
port | Порт, на который сервер БД принимает входящее подключение |
name | Название БД |
user | Имя пользователя БД |
password | Пароль пользователя БД |
readOnly | Статус подключения к базе данных |
pool | Управление соединениями к БД connectionTimeout - Время жизни коннекта при бездействии validationTimeout - интервал проверки бездействующих коннектов min - минимальное количество коннектов max - максимальное количество коннектов |
cache | Настройки кэширования maxEntries - максимальное количество элементов в кэше maxResourceBytes - размер кэша expireTime - время хранения данных в кэше |
/etc/default/eltex-portal
Файл содержит параметры, необходимые для инициализации сервиса. Пример дефолтной конфигурации:
Параметры | Описание |
---|---|
PORT | порт, на который сервис будет принимать соединения |
JAVA_INIT_HEAP | Количество памяти, выделяемое на работу сервиса при старте. Рекомендуется выставлять равное JAVA_MAX_HEAP. |
JAVA_MAX_HEAP | Максимальное количество памяти, которое может зарезервировать сервис |
JAVA_OPTS | Дополнительные опции для запуска jvm |
/etc/eltex-portal/log4j2.xml
настройки логирования работы сервиса. Пример дефолтной конфигурации
Параметр | Описание |
---|---|
monitorInterval | Интервал автоматического перечитывания конфигурации логгера. |
maxFileSize | Максимально допустимый размер файла. При его превышении создается новый файл. а старый архивируется |
accumulatedFileSize | Суммарный размер логов (текущий файл + архивные). При его превышении наиболее старые файлы будут удаляться. |
lastModified | Срок хранения логов, файлы модифицированные раннее этого срока будут удаляться. |
maxCount | Максимальное количество архивных файлов, при его превышении наиболее старые файлы будут перезаписываться. |
baseDir | Базовая директория хранения логов. |
<AppenderRef ref="RollingFile" level="ERROR"/> | минимальный порог записи для всех логеров |
Описание ошибок в логах.
Логфайл: /var/log/eltex-portal/log_ep.txt
Название | Значение | Пример |
---|---|---|
CHECK LOGIN AND PSW IN smsc_gate.conf | Проблема доступности NGW к сервису отправки SMS сообщений | 2018-08-22T09:38:56,420 [SimpleContainerScope.Executor@266376052-35] ERROR org.eltex.portal.sms.SendSmsWithPswResponseHandler SendSmsWithPswResponseHandler.onResult(line:53). Error while sending message on number: 79529056800. ErrorCode: 10, errMessage: 79529056800. Received error code = 1. CHECK LOGIN AND PSW IN smsc_gate.conf. Error in the parameters of function of dispatch sms via http protocol |
NGW_NOT_AVAILABLE | Проблема доступности портала к сервису NGW |