ePages 6.17+ WebInterface.conf | → 6.17.39 | Created: 6.17.39; Updated: 6.17.39 |
WebInterface.conf is an INI-style configuration file. It's used by a number of components of the web interface, such as epages Service, Application Server and Web Adapter.
Table of Contents |
All sections and key names are case sensitive. Whitespace after the equal sign (=) is significant.
Option | Type/Range | Default Value | Description |
---|---|---|---|
MAXREQUEST | 0 .. INT_MAX Requests | 10000 | Maximum number of requests that are processed by one application server. When the application server has processed this number of requests, it terminates itself. It will be re-started automatically by the epages Service. |
MAXUPTIME | 0 .. INT_MAX Seconds | not set | Maximum uptime of an application server process. When the application server is running for more than MAXUPTIME seconds it terminates itself after the next request. |
MAXMEMORY | 0 .. INT_MAX MBytes | not set | Maximum memory size of one application server [MBytes]. When the application server is using more than MAXMEMORY MBytes of RAM it terminates itself after the next request. |
FREEREQUESTPERIOD | 0 .. INT_MAX Seconds | 5 | Heartbeat frequency for idle application servers [sec]. The application server will periodically poll for new cache updates after this period of idle time. |
TIMEOUT | 1 .. INT_MAX Seconds | 150 | This value specifies the wait time in seconds until the web adapter tries to find a free application server if the previous request failed. The request could fail when no request routers are available or all application servers are busy. |
RETRIES | 0 .. INT_MAX Retries | 150 | Specifies how often the web adapter tries to find an idle application server. Works in conjunction with TIMEOUT. That is, the web adapter will wait for a maximum of RETRIES * TIMEOUT seconds. |
MAXCONTENTLENGTH | 0 .. INT_MAX KBytes | 0 (not limited) | Maximum content length in KBytes for incoming POST requests. Larger requests are discarded by the web adapter. They will not be passed on to an application server. The value "0" means that the content length is not limited. The default values is 10 MiB. Values above 20MiB (including unlimited) are not recommended. |
INTERVALTIME | deprecated | deprecated | deprecated as of 6.17.5 |
MAXCACHEITEMS | deprecated | deprecated | deprecated as of 6.17.5, replaced by a setting in ServerConfig.xml |
PRIORITY | ABOVE_NORMAL, NORMAL, BELOW_NORMAL | NORMAL |
Process priority of application servers Should be used on Windows only, because Unix processes cannot increase their priority unless they run with root privileges. |
MONITOR_PRIORITY | ABOVE_NORMAL, NORMAL, BELOW_NORMAL | NORMAL |
Process priority of application servers during unexpected long operations Should be used on Windows only, because Unix processes cannot increase their priority unless they run with root privileges. |
MANUAL_MONITOR_PRIORITY | ABOVE_NORMAL, NORMAL, BELOW_NORMAL | NORMAL |
Process priority of application servers during expected long operations, such as product import/export Should be used on Windows only, because Unix processes cannot increase their priority unless they run with root privileges. |
MONITOR_TIMEOUT | 0 .. INT_MAX Seconds | 15 | Timeout in seconds for the hourglass page |
DOMAINREDIRECT | deprecated | deprecated | deprecated as of 6.0.7 (EPG-11807) |
COOKIES | Comma-separated list of strings | SessionID, Language, Currency, Locale, PreviewStyle, PopUp | List of cookies used by the application server. Any cookies that are not in this list will be ignored |
KEEPALIVE | Boolean (0/1) | 1 | Keep the connection between web adapter and request router alive. Note that there is a limit of 1024 concurrent connections. Therefore set KEEPALIVE=0 if you plan to have more than 1000 web server processes/threads |
DEBUG | deprecated | deprecated | deprecated as of 6.17.5 |
OPTIONS | String | Sets options for the Perl process, for example to enable warnings, profiler or debugger |
Sections with IP addresses are deprecated as of 6.17.5 and can't be used anymore. See ePages 6.17+ ServerConfig.xml for information on how to configure the ePages server components.
This section configures how the web server handles customized URLs (EPG-6666). The default behavior is that all request are re-written as:
/epages/.shorturl?URI=$OriginalURI
Option | Type/Range | Default value | Description |
---|---|---|---|
epages | String | epages | Name of the virtual web server directory of the ePages web adapter |
BaseURI | deprecated | deprecated | deprecated |
ExceptionPrefix | space-separated list of strings | /epages/ /WebRoot/ /robots.txt /favicon.ico | List of space-separated URI prefixes that are not rewritten |
ExceptionRegex | space-separated list of strings | List of space-separated regular expressions to define additional URI exceptions | |
ExceptionHost | space-separated list of strings | List of space-separated host names for which no URLs are rewritten. For example, the provider domain names, such as "[[strato.de]]", "[[www.strato.com]]" can be defined as exceptions |
Configures the log level for the binary web interface components.
Option | Type/Range | Default value | Description |
---|---|---|---|
outfile | String | Log file name without extension (pid, threadid and '.log' automatically added) | |
ANYLEVEL | Boolean (0/1) | 0 | |
SOCKET | Boolean (0/1) | 0 | |
REQUEST | Boolean (0/1) | 0 | |
RROUTER | Boolean (0/1) | 0 | |
LOG | Boolean (0/1) | 0 | |
LIST | Boolean (0/1) | 0 | |
HASH | Boolean (0/1) | 0 | |
INIFILE | Boolean (0/1) | 0 | |
UTILS | Boolean (0/1) | 0 | |
SERVER | Boolean (0/1) | 0 | |
SRVMANAGER | Boolean (0/1) | 0 | |
WEBSERVER | Boolean (0/1) | 0 | |
CONFIG | Boolean (0/1) | 0 | |
SOCKETSEND | Boolean (0/1) | 0 | |
SOCKETRECV | Boolean (0/1) | 0 | |
PROCESSING | Boolean (0/1) | 0 | |
CRITICALSECTION | Boolean (0/1) | 0 | |
CORE | Boolean (0/1) | 0 | |
PAGECACHE | Boolean (0/1) | 0 | |
SERVICE | Boolean (0/1) | 0 | |
MEMORY | Boolean (0/1) | 0 | |
ADD_LOGMSGS | Boolean (0/1) | 0 | |
TRACE | Boolean (0/1) | 0 | |
FILE | Boolean (0/1) | 0 | |
CONDITION | Boolean (0/1) | 0 |
[GLOBAL] MAXREQUEST=10000 TIMEOUT=150 RETRIES=150 MAXCONTENTLENGTH=0 [WA-DEBUG] SOCKET=1 RESPONSE=1 REQUEST=1 outfile=/tmp/WA-DEBUG