Novell Documentation: iManager 1.5.1 - Using the eMBox Logger

Using the eMBox Logger

The eMBox 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 eMBox Logger is different than the client logging service, which is provided through the log files that you specify when you run the eMBox client (for example, when you specify -l mylogfile.txt in an eMBox client command or when you enter mylogfile.txt as a log file name in iManager). The eMBox Logger currently records all server messages for tasks that are performed by the eMBox, 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 eMBox Logger provides the following features:

The ability to change the log file name and location.
By default, log files are created in the embox\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 eMBox 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

Using the eMBox Logger Command Line Client

The following table lists the eMBox Logger command line client options:

Option	Description
logstart	Starts the eMBox logger.
logstop	Stops the eMBox logger.
readlog	Displays the current log file.
getlogstate	Displays the current state of the eMBox logger (Start/Stop).
getloginfo	Displays the name, logging mode(Append/Overwrite), maximum size and the current size of the eMBox 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 eMBox log file using the following parameters: -f filename The eMBox log file name. -s size in Kilo bytes 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.

Using the eMBox Logger Feature in Novell iManager

In Novell iManager, click the Roles and Tasks button.

Click eDirectory Maintenance Utilities > Log File.

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

Authenticate to the server, then click Next.

Select the log file operation to be performed.

Click Help for details.