Server

The data in this file is used for PPM server settings. The following table lists the most important setting options:

Key

Value

Description

PRINT_STACKTRACE_

ON_EXCEPTION

Switch

Is used for receiving additional internal details on error messages. TRUE activates the advanced output of error messages ("stack traces").

Default value: FALSE

ANALYSIS_SERVER_
CONNECT_RETRY_
INTERVAL

Figure

Number of milliseconds that the PPM server waits in case of a failed connection to the analysis server before starting a new connection attempt.

Default value: 1500

ANALYSIS_SERVER_
MAX_CONNECT_
RETRIES

Figure

Maximum number of connection attempts between PPM and analysis server before connection attempts are canceled.

Default value: 120

ENCODING

Text

Specifies the character set encoding of exported XML files.
Valid values: ISO-8859-1, UTF-8

This value is set in the client setup and must not be changed at a later time.

PREV_PERIOD.
TOLERANCE
_IN_PERCENT

Figure

Percentage tolerance within which comparison values are considered equal to the measure value. Used in EPC view to represent trends.

Default value: 1

SUBSERVER_RETRY_
WAIT_TIME

Figure

Number of milliseconds that the master waits in case of a failed connection to the subserver before starting a new connection attempt.

Default value: 10000

SUBSERVER_MAX_
CONNECT_RETRIES

Figure

Maximum number of connection attempts between master and subserver before connection attempts are canceled.

Default value: 10

SUBSERVER_RETRY_
WAIT_TIME

Figure

Waiting time in milliseconds after which the next attempt to connect to the sub-server is started

Default value: 10000

SERVER_MODE

Text

Determines a server's operation mode. Valid values:
STANDALONE, SUBSERVER, MASTER

This value is set by client setup.

HTTPS_DISABLE_CERTIFICATE_AUTHORITY_VERIFICATION

Switch

True controls the check of the certification authority

Default value: false.

If the key is missing or has any other value the default case applies and the check will be performed strictly.

If the check has been disabled the check of the certification authority will not take place for any of the https connections between the PPM server and other hosts. This does not only apply to connections with central user management.

The RMI connection is unaffected by these settings.

Further information on HTTPS support is available in the PPM Operation Guide.

HTTPS_DISABLE_CERTIFICATE_HOSTNAME_VERIFICATION

Switch

True turns off the check of the host name if the host name validation of the certificate during SSL communication is not to be performed.

Default value: false.

If the key is missing or has any other value the default case applies and the check will be performed strictly.

This entry applies to all https connections.

The RMI connection is unaffected by these settings.

Further information on HTTPS support is available in the PPM Operation Guide.

LANGUAGE

Text

Language to be used for running the PPM server (in line with ISO 639-1. If the specified language is not supported by the client, the default language of the client is used)

Default value: „" (not set)

QUERY_CONNECTION_POOL_SIZE

Figure

Size of the query connection pool for queries (> 0).

Default value: 16

COCKPIT_THREAD_COUNT

Figure

Number of threads used for calculating cockpit queries.

(-1 for unlimited number of threads)

Default value: 8

USER_ADMIN_LIST_LIMIT

Figure

Maximum number of users displayed in user management when using LDAP (legacy or UMC)

Default value: 100

PRIORITY_FREQUENCY_QUERY

Figure

Priority of frequency queries (integer >= 0). Smaller values have a higher priority.

Default value: 8

REPORT_TOKEN_TIMEOUT

Figure

Maximum runtime (in seconds) for report sessions (UMC).

Default value: 604800 (60*60*24*7)

IMPORT_TOKEN_TIMEOUT

Figure

Maximum runtime (in seconds) for import and internal sessions (UMC).

Default value: 604800 (60*60*24*7)

UMC_SESSION_REFRESH

Figure

Timeout extension of the UMC session. Multiplied by the value specified in UMC (default: 60 seconds).

Default value: 15

(that is, 15 * 60 seconds = 15 minutes)

COMPARE_MASTER_SUBSERVER_CONFIGS

Switch

Indicates if the configuration is compared between master and sub-servers. This parameter is only relevant in the MASTER operation mode. Valid values are TRUE or FALSE.

The default setting TRUE results in a comparison of the master configuration and the sub-server configuration. If the configurations are different, the sub-server will not connect with the master.

The setting FALSE can lead to invalid and unpredictable behavior and should only be set if Software AG has instructed you to do so.

HTTP_PORT

Figure

Specifies the port number used by the load balancer to communicate with the PPM server.

WEB_SERVICE_SESSION_TIMEOUT

Figure

Validity time in milliseconds before a connection expires. If there is no communication with the server during this time, the user is logged out.

WEB_SERVICE_SESSION_TIMEOUT_RENEWAL

Figure

Time in milliseconds in which a logged in client sends a ping signal to the server to maintain the session.

WEB_SERVICE_MIN_THREADS

Figure

Minimum number of threads for Web service requests

WEB_SERVICE_THREAD_IDLE_TIMEOUT

Figure

Maximum duration of an inactive thread. If this time elapses with no activity, the thread is ended.

WEB_SERVICE_REQUEST_TIMEOUT

Figure

Maximum wait time for a response from the server. If a request to the server takes longer than the time specified in this value, the server sends a timeout to the client so that the client can request the result again. This value must be lower than the abort time between the upstream load balancers and the client server.

During the master server client setup, all sub-servers to be used by the master are specified. This information is stored in the following entries (X is a placeholder for the number of a sub-server, value range 1-64):

Key

Value

Description

SUBSERVER.X.URL

URL

Registry URL to address the sub-server

SUBSERVER.X.CLIENT

Text

Name of the client

SUBSERVER.X.USER

Text

Name of the PPM user whose ID is used by the master server to connect to the sub-server

SUBSERVER.X.PASSWORD

Text

Encrypted password of the PPM user

PIKI_SUBSERVER

Figure

Determines the sub-server (value corresponds to the number of the sub-server) that contains the measure series for data input of process instance-independent measures in the PPM front-end.

It is recommended to use a system administrator user for the communication between master server and sub-servers. This ensures that the master server can access the sub-servers with full system privileges.

The data for process instance-independent measure series should always be imported on the sub-server specified in PIKI_SUBSERVER.

Warning

Distributing data of a process instance-independent measure series on several sub-servers can lead to invalid results.