The logging properties file

You can use the logging properties file, tm1s-log.properties, to control which log levels are logged for the different components of TM1®.

The tm1s-log.properties file is a text file that contains the parameters for configuring logging for a specific TM1 server. For more information, see Configuring logging parameters in tm1s-log.properties and Configuring logging level in tm1s-log.properties.

Each TM1 server uses its own tm1s-log.properties file and checks for the file whenever the server is started. After startup, the server checks for updates to the properties file and adjusts the logging as needed. You can update a properties file in real time and the TM1 server dynamically reads the changes and adjusts the logging.

Note: The TM1 local server checks only the tm1s-log.properties file when the local server starts up.

A sample tm1s-log.properties file is provided in the directory of some sample TM1 databases that you install.

Example tm1s-log.properties file

log4j.logger.TM1=INFO, S1

# S1 is set to be a SharedMemoryAppender
log4j.appender.S1=org.apache.log4j.SharedMemoryAppender
# Specify the size of the shared memory segment
log4j.appender.S1.MemorySize=5 MB
# Specify the max filesize
log4j.appender.S1.MaxFileSize=100 MB
# Specify the max backup index
log4j.appender.S1.MaxBackupIndex=20
# Specify GMT or Local timezone
log4j.appender.S1.TimeZone=GMT


log4j.logger.Event=INFO, S_Event
log4j.appender.S_Event=org.apache.log4j.SharedMemoryAppender
log4j.appender.S_Event.MemorySize=1 MB
log4j.appender.S_Event.MaxFileSize=100 MB
log4j.appender.S_Event.MaxBackupIndex=1
log4j.appender.S_Event.File=tm1event.log
log4j.appender.S_Event.Format=TM1Event
log4j.appender.S_Event.TimeZone=GMT