Sample bootstrap.properties file

# General properties
SERVERS_DIR=<PA_install_location>/samples/tm1
EXE_PATH=<PA_install_location>/bin64/tm1s.exe
SERVER_INFO_PATH=<PA_install_location>/paa_agent/paaAgentCache
AGENT_LABEL=<"agent name">

TM1_SERVER_INFO_PROCESS_TIME_INTERVAL=20000
NOTIFICATION_MEM_USAGE_INTERVAL=30000
NOTIFICATION_SERVER_UNRESPONSIVE_INTERVAL=40000
FILE_TAILER_REFRESH_INTERVAL=86400000
PAA_EMAIL_ADDRESS=administration@planning-analytics.ibmcloud.com
MODEL_UPLOAD=model_upload
SCRIPT_TIMEOUT=15

# SMTP Properties
SMTP_EMAIL_PORT=<port>
SMTP_EMAIL_AUTH=false
SMTP_EMAIL_HOST=<host>
SMTP_EMAIL_START_TLS_ENABLE=false
SMTP_EMAIL_USERNAME=<username>
SMTP_EMAIL_PASSWORD=<encrypted_pwd>

# Logging properties
com.ibm.ws.logging.console.log.level=OFF
com.ibm.ws.logging.trace.specification="*\=audit\:com.ibm.pa.kate.agent.*\=warning"
com.ibm.ws.logging.max.file.size=10
com.ibm.ws.logging.max.files=4

VERSION=1.0.nn.nnn

General properties

AGENT_LABEL
Use this setting to display a specified agent label (name) in place of the agent IP address in Planning Analytics Administration.
If an agent label is set, the label appears on the Databases and Agent tabs wherever an agent is identified. The agent IP address is not reported. For example:
Example of agent label in use
If an AGENT_LABEL is not specified, the agent IP address is displayed wherever an agent is identified.
EXE_PATH
Internal use only. Do not change.
FILE_TAILER_REFRESH_INTERVAL
Internal use only. Do not change.
Time in milliseconds between successive task executions. Used in scheduler that tails server logs for every TM1® Server.
MODEL_UPLOAD
Internal use only. Do not change.
NOTIFICATION_MEM_USAGE_INTERVAL
Internal use only. Do not change.
Not currently used.
NOTIFICATION_SERVER_UNRESPONSIVE_INTERVAL
Internal use only. Do not change.
Time in milliseconds between successive task executions. Used in the scheduler that checks for server unresponsiveness.
PAA_EMAIL_ADDRESS
Internal use only. Do not change.
SCRIPT_TIMEOUT
Internal use only. Do not change.
SERVERS_DIR
This parameter is applicable to Linux only. It specifies the full path of the directory that contains the TM1 databases directories.
Note:

Multiple paths must be separated by a semicolon. For example,

SERVERS_DIR=C:/tm1/samples/tm1/;C:/prod/servers/
You can specify the parent directory of your databases. You don't need to specify each database separately.
SERVER_INFO_PATH
Internal use only. Do not change.
TM1_SERVER_INFO_PROCESS_TIME_INTERVAL
Internal use only. Do not change.
Time in milliseconds between successive task executions. Used in the scheduler that checks system health.

SMTP properties

SMTP_EMAIL_PORT
Set to a free port. For example, 2500.
SMTP_EMAIL_AUTH
Default is false.
SMTP_EMAIL_HOST
Set based on your email server. For example, localhost.
SMTP_EMAIL_START_TLS_ENABLE
Default is false. Whether you need to configure certificates and set START_TLS_ENABLE=true depends on your email server configuration.
SMTP_EMAIL_USERNAME
Full email address. For example, example@my domain.com.
SMTP_EMAIL_PASSWORD
Email password for SMTP_EMAIL_USERNAME.

Logging properties

com.ibm.ws.logging.console.log.level
This setting controls the granularity of messages that go to the console.
When this log is enabled, a console.log is generated with the agent message.log at <PA_install_location>/paa_agent/wlp/usr/servers/kate-agent/logs.
Valid values are: INFO, AUDIT, WARNING, ERROR, and OFF.
Default is OFF.
com.ibm.ws.logging.trace.specification="*=audit:com.ibm.pa.kate.agent.*=warning"
This setting is used to selectively enable trace.
This entry refers to the agent message.log.
Valid values are: INFO, AUDIT, WARNING, ERROR, and OFF.
A restart of the Planning Analytics Administration agent is required for a logging value to take effect when you change this property.
com.ibm.ws.logging.max.file.size
The maximum size (in MB) that a log file can reach before it is rolled.
Default is 10. For more information, see Logging and Trace.
com.ibm.ws.logging.max.files
If an enforced maximum file size exists, this setting is used to determine how many of each of the logs files are kept.
Default is 4. For more information, see Logging and Trace.