If you are not using log4j to generate log files, you need to set a configuration parameter specific to each component for which you want Instant Messaging to generate logging information. This method is referred to as parameter-based logging for Instant Messaging. You can use parameter-based logging for all server instances including redirect servers, multiplexor, calendar-agent, and watchdog.
This iim.conf parameter-based logging mechanism may be deprecated in a future release. Use log4j when possible.
Table 13–2 provides the name of the log files and the configuration parameter in iim.conf used to set the logging level for each Instant Messaging component log file.
Table 13–2 Log File Names and Logging Level Configuration Parameters for Instant Messaging Components
Component |
Log File Name |
Logging Level Configuration Parameter |
---|---|---|
Server |
xmppd.log |
iim.log.iim_server.severity |
Multiplexor |
mux.log |
iim.log.iim_mux.severity |
Calendar agent |
agent-calendar.log |
iim.log.agent-calendar.severity |
Watchdog |
iim_wd.log |
iim.log.iim_wd.severity |
The configuration parameters can have the following values:
fatal
error
warning
info
debug
See Instant Messaging Component Logging Levels for information on the details logged for each logging level.
In addition, logging configuration in deployments with Sun JavaTM System Access Manager is determined by the com.iplanet.services.debug.level property. You set this property in the AMConfig.properties file on the Sun Java System Access Manager host. By default, this file is installed in the following location:
AM-svr-base/lib/AMConfig.properties
Where AM-svr-base is the directory in which you installed Access Manager.
This property can contain the following values:
message
warning
error
off
By default, the Sun Java System Portal Server desktop log file (desktop.debug) and archive log files (IMArchiveSearch.log and IMArchiveSubmit.log) are stored in the following locations:
Solaris: /var/opt/SUNWam/debug
Linux: /var/opt/sun/am/debug
Modify logging parameters in iim.conf.
See Table 13–2 for a list of the log files and the associated parameter you need to set for each component.
See iim.conf File Syntax for instructions on locating and modifying iim.conf. For more information on the watchdog, see Managing the Watchdog Process. For more information on the Calendar agent, see Chapter 16, Using Calendar Pop-up Reminders.