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:

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.