14.2 Configuring Error Logging

14.2.1 Linux and UNIX

To configure the error logging settings for the server-side messages, you can use the n4u.server.log-levels and n4u.server.log-file parameters in the /etc/opt/novell/eDirectory/conf/nds.conf configuration file.

Setting the Severity Level

The severity levels available are LogFatal, LogWarn, LogErr, LogInfo, and LogDbg levels (in decreasing order of severity). For more information on the severity levels, refer to Section 14.1, Message Severity Levels.

By default, the severity level is set "LogFatal". So, only messages with severity level fatal will be logged.

To set the severity level, use the n4u.server.log-levels parameter in the nds.conf file as follows:

n4u.server.log-levels=severity_level

For example:

  • To set the severity level to LogInfo and above, type the following:

    n4u.server.log-levels=LogInfo
    

    With this configuration, messages with severity level LogInfo and above (that is, LogFatal, LogWarn, and LogErr) will be logged into log file.

  • To set the severity level to LogWarn and above, type the following:

    n4u.server.log-levels=LogWarn
    

    With this configuration, messages with severity level LogWarn and above (LogFatal) will be logged into the log file.

Specifying the Log File Name

To specify the location of the log file where the messages will be logged, use the n4u.server.log-file parameter in the nds.conf file. By default, the messages are logged into the ndsd.log file.

For example, to log the messages to /tmp/edir.log, type in the following:

n4u.server.log-file=/tmp/edir.log

To log the messages in the system log, use the n4u.server.log-file parameter as follows:

n4u.server.log-file=syslog

Specifying the Log File Size

To specify the size of the log file, use the n4u.server.log-file-size parameter in the nds.conf file. The maximum file limit can be 2 GB and the default file size is 1 MB. However, you can set the file size to below 1 MB also.

This setting is not applicable to the ndsd.log file.

If the log file size reaches the specified limit, then logger overwrites the log file from the start.

14.2.2 Windows

Setting the Severity Level

The severity levels available are LogFatal, LogWarn, LogErr, LogInfo, and LogDbg levels (in decreasing order of severity). For more information on the severity levels, refer to Section 14.1, Message Severity Levels.

To set the severity level, do the following:

  1. Click Start > Settings > Control Panel > Novell eDirectory Services

  2. In the Services tab, select dhlog.dlm.

  3. Enter the log level in the Startup Parameters box.

    For example, to set the log level to LogErr and above, enter the following:

    LogLevels=LogErr
    
  4. Click Configure

  5. In the ACS Config tab, click the plus sign of DHostLogger.

    The LogLevel parameter is updated with the configured value.

Specifying the Log File Name and Path

  1. Click Start > Settings > Control Panel > Novell eDirectory Services

  2. In the Services tab, select dhlog.dlm.

  3. Enter the log file path in Startup Parameters as follows:

    LogFile=file_path
    

    For example, to set the log file path to /tmp/Err.log, enter the following in startup parameters:

    LogFile=/tmp/Err.log
    
  4. Click Configure

  5. In the ACS Config tab, click the plus sign of DHostLogger.

    The LogFile parameter is updated with the configured value.

Specifying the Log File Size

  1. Click Start > Settings > Control Panel > Novell eDirectory Services

  2. In the Services tab, select dhlog.dlm.

  3. Enter the log file path in Startup Parameters as follows:

    LogSize=size
    

    The default file size is 1 MB.

  4. Click Configure

  5. In the ACS Config tab, click the plus sign of DHostLogger.

    The LogSize parameter is updated with the configured value.