Log4J default parameters

When IBM Security Directory Integrator is installed, a FileAppender is used for the default logger. If you want to change the default logger you must change the content of the log4j.properties file situated in the TDI_installdir/etc folder. The default configuration is as follows:

# This is the default logger, you will see that it logs to ibmdi.log
log4j.appender.Default=org.apache.log4j.FileAppender
log4j.appender.Default.file=logs/ibmdi.log
log4j.appender.Default.layout=org.apache.log4j.PatternLayout
log4j.appender.Default.layout.ConversionPattern=%d{ISO8601} %-5p [%c] - %m%n
log4j.appender.Default.append=false

The FileAppender logger truncates the content of the ibmdi.log file (situated in TDI_installdir/logs) each time the IBM Security Directory Integrator server is started. If want to change that behavior you must change the log4j.appender.Default.append property to true.

In the log4j.properties file you can find also two examples for changing the default logger to RollingFileAppender or DailyRollingFileAppender. If you want to use them just uncomment the preferred one and comment the FileAppender logger:

##########ROLLING FILE SIZE APPENDER
##RollingFileAppender rolls over log files when they reach a certain size specified by the
##MaxFileSize parameter

#log4j.appender.Default=org.apache.log4j.RollingFileAppender
#log4j.appender.Default.File=logs/ibmdi.log
#log4j.appender.Default.Append=true
#log4j.appender.Default.MaxFileSize=10MB
#log4j.appender.Default.MaxBackupIndex=10
#log4j.appender.Default.layout=org.apache.log4j.PatternLayout
#log4j.appender.Default.layout.ConversionPattern=%d{ISO8601} %-5p [%c] - %m%n

##########DAILY OUTPUT LOG4J SETTINGS
## With the DailyRollingFileAppender the underlying file is rolled over at a user chosen frequency.
##The rolling schedule is specified by the DatePattern option 

#log4j.appender.Default=org.apache.log4j.DailyRollingFileAppender
#log4j.appender.Default.file=logs/ibmdi.log
#log4j.appender.Default.DatePattern='.'yyyy-MM-dd
#log4j.appender.Default.layout=org.apache.log4j.PatternLayout
#log4j.appender.Default.layout.ConversionPattern=%d{ISO8601} %-5p [%c] - %m%n

These are some of the parameters you find in the file Log4J.properties (for ibmdisrv and ibmditk).

Full documentation can be found at http://jakarta.apache.org/log4j/docs.

Log4J.rootCategory=DEBUG, Default

DEBUG is the loglevel for the named Appender (Log4J term called Default). If you set the loglevel to OFF or to the level above INFO, you do not get output from your script logmessages (see the following log terms):

Log4J.appender.Default

Defines what type of Appender the named appender Default is. It can be one of the following:

• FileRollerAppender (generates a new file for each run of the Server)
• ConsoleAppender (log to console)
• FileAppender (log to file)
• SyslogAppender (log to UNIX Syslog)
• NTEventLog (log to Windows NT EventLog)
• DailyRollingFileAppender (saves old files with a datestamp in their names)
• SystemLogAppender (In a folder structure under root_directory/system_logs)

Log4J.appender.Default.file

Default log file for FileAppender, relative to your installation directory (default ibmdi.log).

Log4J.logger.com.ibm.di.*

Log level of various IBM Security Directory Integrator components. Note that, for example, ibmditk shows the log level of the IBM Security Directory Integrator Configuration Editor itself (not the processes you are running inside it). Do not change these.