As with the MailArchiva server, the Windows agent has comprehensive logging facilities that can be used for troubleshooting purposes. We recommend you enable DEBUG logging when you first run the agent for safety sake. To enable agent debug logging, edit the file log4j.properties in C:\Program Files\MailArchiva\MailArchivaAgent\log4.properties. Change the line "log4j.logger.AgentService=INFO, archivadebug, nteventlog" to "log4j.logger.AgentService=DEBUG, archivadebug, nteventlog". Restart the agent. Typically, the agent log file is found in \debug.log. If you experiencing difficulties with the Windows Agent, you need to examine the output in this file. Obviously, for performance reasons, we do not recommend that you leave the DEBUG logging enabled in a production environment.

Its worth also noting that the Exchange agent will automatically output debug logging to the Windows Event Viewer. Since the Windows agent uses the log4j framework you can easily implement all sorts of additional tricks by adding appenders. Refer to the log4j web site for more information on kinds of facilities that this powerful logging framework offers.

---

log4j.properties file ------------------------------

# Logging Properties

log4j.logger.AgentService=INFO, archivadebug, nteventlog

# debug log log4j.appender.archivadebug=org.apache.log4j.RollingFileAppender log4j.appender.archivadebug.File=C:\\debug.log log4j.appender.archivadebug.MaxFileSize=10000KB log4j.appender.archivadebug.layout=org.apache.log4j.PatternLayout #log4j.appender.archivadebug.layout.ConversionPattern=%d [%t] %-5p %c - %m%n log4j.appender.archivadebug.layout.ConversionPattern=%d %m%n

log4j.appender.nteventlog=org.apache.log4j.NTEventLogAppender log4j.appender.nteventlog.threshold=WARN log4j.appender.nteventlog.layout=org.apache.log4j.SimpleLayout log4j.appender.nteventlog.source=MailArchivaAgent

log4j.appender.syslog=org.apache.log4j.net.SyslogAppender log4j.appender.syslog.Facility=LOCAL7 log4j.appender.syslog.Sysloghost=localhost log4j.appender.syslog.layout=org.apache.log4j.PatternLayout 2log4j.appender.syslog.layout.ConversionPattern=%d %m%n

-- JamieBand - 21 Sep 2007