<div class="aui-message error aui-message-error">
<p class="title">
<span class="aui-icon icon-error"></span>
<strong>Comala Metadata License Details</strong>
</p>
<p>Invalid commercial evaluation license with a expired error. Please click <a href="https://marketplace.atlassian.com/plugins/org.andya.confluence.plugins.metadata" target="_blank">here</a> to purchase a commercial license.</p>
</div>
Описание
В состав 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 | Интервал выполнения проверки наличия тарифных планов на порталах. В случае отсутствия тарифного плана формируется сообщение об ошибке |
paymentsCleanerPeriod | Период очистки неудачных платежей в БД в cron-формате |
jetty | |
https | Настройки работы контейнера по https. Необходимо указать расположение сертификата, ключ и прослушиваемый порт. port - прослушиваемый порт keystorePass - ключ от хранилища сертификатов keystoreFile - файл хранилища, содержащий сертификат keystoreType - тип хранилища certAlias - алиас сертификата в хранилище ciphers - поддерживаемые методы шифрования |
database | |
host | Адрес сервера БД |
port | Порт, на который сервер БД принимает входящее подключение |
name | Название БД |
user | Имя пользователя БД |
password | Пароль пользователя БД |
pool | Управление соединениями к БД connectionTimeout - Время жизни коннекта при бездействии validationTimeout - интервал проверки бездействующих коннектов min - минимальное количество коннектов max - максимальное количество коннектов |
cache | Настройки кэширования maxEntries - максимальное количество элементов в кэше maxResourceBytes - размер кэша expireTime - время хранения данных в кэше |
validation | |
public_key | Путь к файлу ключа сервиса eltex-doors для валидации токенов при обращении на портал других сервисов (eltex-johhny) |
/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"/> | минимальный порог записи для всех логеров |
Политика ротирования, прописанная по-умолчанию для accesslog и authlog
<Policies> <TimeBasedTriggeringPolicy interval="1" modulate="true"/> </Policies>
Указывает на ротацию логов раз в сутки. При использовании данной политики ограничение maxFileSize для актуального лога не отработает.
Для ограничения размера актуального лога, в соответствии с maxFileSize замените политику на
<Policies> <SizeBasedTriggeringPolicy size="${maxFileSize}"/> </Policies>
Описание ошибок в логах.
Логфайл: /var/log/eltex-portal/portal.log
Название | Значение | Пример |
---|---|---|
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 | 2020-07-09T09:45:07,827 [qtp76432244-17] ERROR org.eltex.portal.sms.NotificationClient NotificationClient.getConfigurationInfo(line:527). Can`t connect to Ngw server with code: 1601 code 1601:NGW_NOT_AVAILABLE and reason: NgwException{FAILED: 'Protocol is not supported by the server: eltex-ngw-api#1.16.5'} |