Following the instructions below will enable logging in the Aeon Web DLL.
DLL Logging should only be enabled to aid in the diagnosis of a problem because the log files tend to get large quickly.
Beginning with Aeon 4.0, EAD contents are no longer included in log statements. Prior to Aeon 4.0, when the Aeon Web DLL processed finding aid requests, it downloaded the finding aid (EAD) and logged the file contents in their entirety at the debug level. Since EADs can be very large, this would often cause the log files to fill up and roll over very quickly if debug logging is enabled.
Enabling Logging
To enable logging in the Aeon DLL, you will need to create a new file with the text below. This file needs to be saved as log4d.props on the web server in the same directory where the aeon.dll is running (usually C:\Program Files (x86)\Aeon\Web). The text of the log4d.props file should be:
#---- begin log4d.props ----
log4d.debug=TRUE
log4d.loggerFactory=TLogDefaultLoggerFactory
# root priority - valid values are 'DEBUG', 'INFO', 'WARN', 'ERROR', 'FATAL'
log4d.rootLogger=INFO,ROOT
# root appender
log4d.appender.ROOT=TLogRollingFileAppender
log4d.appender.ROOT.append=TRUE
log4d.appender.ROOT.fileName=C:\Program Files (x86)\Aeon\logs\AeonDLL.log
log4d.appender.ROOT.errorHandler=TLogOnlyOnceErrorHandler
log4d.appender.ROOT.layout=TLogPatternLayout
log4d.appender.ROOT.layout.dateFormat=yyyy-mm-dd hh:MM:ss,zzz
log4d.appender.ROOT.layout.pattern=%d [%p] %c (%t) - %m%n
log4d.appender.ROOT.maxBackupIndex=9
log4d.appender.ROOT.maxFileSize=4MB
#---- end log4d.props ----
The DLL will now log to a file called C:\Program Files (x86)\Aeon\Logs\AeonDLL.log. This can be edited to another name or location. If you have multiple web folders (shared server or using test web), you can make a different log4d.props file in each web folder that points to another file name for that log. You may need to change the permissions on the C:\Program Files (x86)\Aeon\ directory to allow the Internet Guest Account (IUSR_AEON or similar) to create and write to a file. That file may not allow you to open it while the dll is still running. You may need to stop and restart the web server to open the file.
Disabling Logging
To disable logging in the Aeon DLL, rename the log4d.props file to something else (i.e. disable-log4d.props). If the DLL cannot find that file, it will not log any actions.