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

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

Ключ

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

...

A Shared Block
hiddentrue


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


Description

WEB portal is included into SoftWLC project to implement Hotspot clients authorization model. An unknown user can connect to an access point without getting login and password in advance. But if he (or she) tries to access the Internet via a browser, he will be redirected to a WEB portal page where authorization or credentials obtaining (for example, via SMS) can be performed. During authorization, a user can see advertisement banners customized in accordance with operator's requirements.

...

An example of a portal initialization page:

Service management

Operation

Command

Response

Status check


Без форматирования
service eltex-portal status



Подсказка

Service is running

eltex-portal start/running, process <pid>


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

Service is waiting

eltex-portal stop/waiting


Service start


Без форматирования
service eltex-portal start



Подсказка

Service has been started

eltex-portal start/running, process <pid>


Примечание

The service is already running

start: Job is already running: eltex-portal


Service stop


Без форматирования
service eltex-portal stop



Подсказка

Service has been stopped successfully

eltex-portal stop/waiting


Примечание

Service has not been stopped, as it was not started

stop: Unknown instance:


Service restart


Без форматирования
service eltex-portal restart



Подсказка

Service has been restarted successfully

eltex-portal stop/waiting

eltex-portal start/running, process <pid>

eltex-portal start/running, process <pid>
stop: Unknown instance:



Configuration

/etc/eltex-portal/application.conf

main configuration file. Default configuration example:

...

Parameter

Description

portal


defaultRedirectUrl

The address where the user will be redirected if his session should be restarted. It should be set in accordance with http protocol.

tariffCheckerPeriod

The interval for checking tariff availability on portals. If there are no available tariffs, the error message is generated.

jetty


https

Configuring container operation on https. Certificate location, key and listened port must be specified.
port — listened port
keystorePass — a key to a certificate store
keystoreFile — a store file that contains a certificate
keystoreType — store type
certAlias  — certificate alias in a store
ciphers — supported ciphering methods

accessLog

Server requests logging.
enabled — logging state
directory — the directory to store logs
format — default logs format: NCSA — standard format, custom — expanded format for debugging
append — current file writing continuation after service restart
retrainDays — log storage time
append — additional information
logCookies — saving cookie to logs
logAP — saving headers from access points
logBRAS — saving data from BRAS

database


host

Database server address

port

The port of the database server for getting inbound connection

name

Database name

user

Database user's name

password

Database user's password

readOnly

Database connection status

pool

Database connections management
connectionTimeout — the idle timeout of the connection
validationTimeout — the interval for idle connections validation
min — the minimum number of connections
max — the maximum number of connections

cache

Caching settings
maxEntries — the maximum number of items in the cache
maxResourceBytes — cache size
expireTime — cache data storage time



/etc/default/eltex-portal

The file contains parameters needed for service initialization. Default configuration example:

...

Parameter

Description

PORT

The port for the server to get connections.

JAVA_INIT_HEAP

Amount of memory allocated for service operation on startup. Recommended to be set equal to JAVA_MAX_HEAP.

JAVA_MAX_HEAP

Maximum amount of memory that the service can reserve.

JAVA_OPTS

Additional options for jvm launch.


/etc/eltex-portal/log4j2.xml

service operation logging settings. Default configuration example

...

Parameter

Description

monitorInterval

The interval for automatic monitoring of the logger configuration.

maxFileSize

The maximum file size. When exceeded, a new file is created, and an old file is archived.

accumulatedFileSize

Total log size (a current file + archived ones). When exceeded, the oldest files will be deleted.

lastModified

Log storage time, files modified earlier than the timeless, will be deleted.

maxCount

The maximum number of archived files. When exceeded, the oldest files will be deleted.

baseDir

Base directory to store logs.



<AppenderRef ref="RollingFile" level="ERROR"/>

Minimum logging level.


Log errors description

Log file: /var/log/eltex-portal/log_ep.txt 

...