Configuring and enabling IBM TM1 Web logging for versions 2.0.69 and earlier

You can change the logging message level for IBM® TM1® Web logging.

Logging properties are stored in the log4j.properties file in the following location:

<TM1 install location>\webapps\tm1web\WEB-INF\configuration

Logging for TM1 Web is configured and enabled by default when the program is installed.

Attention: The default web logging configuration is intended for everyday use and does not typically require adjustment. For assistance if you need to configure the logging properties for troubleshooting purposes, contact IBM Customer Support.

The following is a sample of the logging properties file.

# System logging settings
log4j.rootLogger=ERROR, TextFile
log4j.logger.com.ibm.cognos=ERROR
log4j.logger.com.cognos=ERROR
log4j.logger.com.cognos.org=ERROR
log4j.logger.com.ibm.cognos.perf=ERROR
log4j.logger.com.ibm.cognos.tm1=ERROR

log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p (%x) %c - %m%n

log4j.appender.TextFile=org.apache.log4j.DailyRollingFileAppender
log4j.appender.TextFile.File=logs/tm1web.log
log4j.appender.TextFile.DatePattern=.yyyy-MM-dd
log4j.appender.TextFile.layout=org.apache.log4j.PatternLayout
log4j.appender.TextFile.layout.ConversionPattern=%d [%t] %-5p (%x) %c - %m%n

log4j.appender.XMLFile=org.apache.log4j.DailyRollingFileAppender
log4j.appender.XMLFile.File=logs/tm1web_log.xml
log4j.appender.XMLFile.DatePattern=.yyyy-MM-dd
log4j.appender.XMLFile.layout=org.apache.log4j.xml.XMLLayout

You can adjust various logging level and output options in this file.

The message level is indicated by:

log4j.logger.logger_name=message_level

The log file name is indicated by:

log4j.appender.appender_name.File=location
Attention: By default, the log file is created beneath the root of your web server. As such, it could be accessible by unauthorized individuals. Consider setting the File parameter to write the log file to a secure location. The parameter can accept a relative or literal path.

Procedure

  1. Open the log4j.properties file in a text editor, such as Microsoft Windows Notepad.
  2. Locate and edit the line you want to adjust.

    For example, change the message level to one of the valid values; DEBUG, INFO, or ERROR.

  3. Save and close the file.