Configuring Logging for Instant Messaging Components Using iim.conf Parameters

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.

---

Note –

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 Java^TM 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

To Set Log Levels for Instant Messaging Components Using iim.conf Parameters

1. 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.