Cache Configuration - Summary‌

The configuration file ./etc/auth_dmz.xml contains the most important configuration parameters for the service as comment blocks (see table below). All parameters are located within the Configure element.

<Configure class="com.ebd.hub.services.auth.MessageAuthenticationService">
...
</Configure>


Each parameter is defined in the following way (abstractly here).

<Set name="parameterName">parameterValue</Set>

Parameters

Parameter

Function

Default Value

cachedChannelTypes

Comma-delimited list of numeric channel types that should be stored in the cache. If undefined, all types (1,2,3,4,5,6,7,8), see section Restricted Caching by Channel Types ('cachedChannelTypes')‌.

All types.

cacheUpdateTimeout

Timeout [ms], of how long to wait for a valid cache before a request fails.

8000 (8 seconds)

defaultTarget

<host>:<port> of the inner MessageService.

Default port: 8020 (if only the host has been specified)

defTargetService

Name of the inner AuthenticationService.

Authentication Service

fullUpdatePeriod

Period [ms] after which the next update is a complete one. Value 0 means no complete updates except for once a day and after a restart.

0 (no complete update)

ignoreNotification

If true, the immediate cache replication is switched off.

false

localDbFile

Path to the table space of a persistent cache database. If defined, the file including all folders is created. If undefined, the cache is stored in the main memory.

Not persistent.

maxInitAttempts

Number of attempts for an initial update.

12

maxWait

Waiting time [ms] for the response of a synchronous message.

8000 (8 seconds)

messageContext

Context of consumer queue of inner AuthenticationService.

System

messageQueue

Name of the consumer queue used for requests to the inner AuthenticationService. It must match the name of the queue the inner Authentication Service is registered to.

AuthCall

noCaching

true disables caching in general.

false

subID

Positive integer between 0 and 31 to identify a DMZ server in a cluster, see section Configuration of Parameter 'subID'.

Calculated automatically.

updatePeriod

Period [ms] for cache updates. Value 0 means no update. Negative values or values between 1 and 3000 are ignored.

900000 (15 minutes)