Blog

Should Debug_Outfile be used on a Domino 6.x server?


Tags :


Straight from technote #1181562

Dynamic Console Logging

Starting with Domino 6.0, the Domino server creates a console.log file by default in the "IBM_TECHNICAL_SUPPORT" folder, which is located in the server's Data directory.  The development of the console.log file, which can be dynamically enabled and disabled at the server console, makes the use of the parameter debug_outfile no longer recommended.
 
For backwards compatibility, when debug_outfile is present in the notes.ini it takes precedence.  However, using the debug_outfile parameter is no longer the preferred method for capturing console output.

Console.log is superior to the use of "debug_outfile" because it can be dynamically enabled and disabled at the server console, thus eliminating delays capturing crucial data.  Server reboots are no longer required to begin capturing basic console logging, which is not the case when using the parameter debug_outfile.

Notes:

  • There may be a few customers who wish to continue to use debug_outfile to rename the log file or to relocate the log file to a different directory via debug_outfile=\.
  • If you just want to relocate the directory these files are saved into, but are happy with the name of console.log, you can use another new parameter logfile_dir.  Here are some examples of these parameters at work
notes.ini parameters show server output
debug_outfile=mylog.log
Diagnostic Directory:     C:\Lotus\Domino7\Data\IBM_TECHNICAL_SUPPORT
Console Log File:           C:\Lotus\Domino7\Data\IBM_TECHNICAL_SUPPORT\mylog.log
debug_outfile=C:\temp\mylog.log Diagnostic Directory:    C:\Lotus\Domino7\Data\IBM_TECHNICAL_SUPPORT
Console Log File:           C:\temp\mylog.log
logfile_dir=C:\temp Diagnostic Directory:    C:\temp
Console Log File:           C:\temp\console.log
logfile_dir=C:\temp
debug_outfile=mytemp.log
Diagnostic Directory:    C:\temp
Console Log File:           C:\temp\mytemp.log

  • If you place a debug_outfile=xxxxxx statement in your notes.ini and start the server, it will internally start writing to the log file, regardless of the value you might have set for CONSOLE_LOG_ENABLED (discussed below).  However, the log writing will still respond to stop consolelog to stop writing to the log.