22.2 Using the Logger

The Logger is an infrastructure module that logs all the events for all the eDirectory Management Tools (eMTools) such as DSBackup, DSMerge, and DSRepair. In this release, only one log file is provided in which all eMTools log their operations.

The Logger is different than the client logging service, which is provided through the log files that you specify when you run the client. For example, when you specify -l mylogfile.txt in a Client command or when you enter mylogfile.txt as a log file name in iManager. The Logger currently records all server messages for tasks that are performed by the eMTools, showing greater detail. By contrast, the client logging service records client messages and messages sent to the client, which give a general report of progress.

Logging is asynchronous, and all operations are logged by default.

This release of the Logger provides the following features:

  • The ability to change the log file name and location.

    By default, log files are created in the \log directory located in the same directory that eDirectory was installed in.

  • The ability to change the maximum file size, after which the log file will reset.

    The maximum file size is 8 MB.

  • The ability to change the logging mode.

    You can choose to append all new messages to the log file or to overwrite an existing log file. The Append option is set by default.

  • The ability to start and stop the logging.

    By default, the logger is in Start mode when the starts up. While in Stop mode, no messages are logged.

  • The ability to reset the log file contents.

  • The ability to read the log file from a client machine.

In This Section:

22.2.1 Using the Logger Command Line Client

The following table lists the Logger command line client options:

Option

Description

logstart

Starts the logger.

logstop

Stops the logger.

readlog

Displays the current log file.

getlogstate

Displays the current state of the logger (Start/Stop).

getloginfo

Displays the name, logging mode (Append/Overwrite), maximum size, and the current size of the log file.

setloginfo [-f filename] [-s size in Kilo bytes] [-a | -o]

Lets you set the name, size, and logging mode (Append/Overwrite) of the log file using the following parameters:

  • -f filename

    The log file name.

  • -s size in KB

    The maximum size of the log file.

  • -a

    New log messages will be appended to the current one.

  • -o

    The log file will be overwritten.

emptylog

Clears the contents of the server log file.

22.2.2 Using the Logger Feature in NetIQ iManager

  1. In NetIQ iManager, click the Roles and Tasks button Roles and Tasks button.

  2. Click eDirectory Maintenance > Log File.

  3. Specify which server will perform the log file operation, then click Next.

  4. Authenticate to the server, then click Next.

  5. Select the log file operation to be performed.

    Click Help for details.