Log Configuration 

Use

Using the Log Configurator service runtime available in the Visual Administrator, you can manage the logging and tracing configurations of the J2EE Engine components and of the deployed applications. To ease the configuration process, two configuration modes are provided – simple and advanced. The simple mode is suitable for users who have basic knowledge of the SAP Logging API. They can only use tabs for assigning severity levels to locations and categories. The advanced mode is for users who are skilled in using the SAP Logging API features. They can configure traces and formatters, and can make use of the additional features added to the locations and categories configuration.

The advanced configuration mode has to be used with extreme care and only by users who are familiar in detail with the SAP Logging API.

To switch between the modes, choose  To advanced mode/To simple mode.

By default the Log Configurator service Runtime tab runs in simple mode.

For more information, see:

Working with the Simple Mode

Working with the Advanced Mode

Options are also provided for:

·        archiving logs

·        configuring system critical logs

·        parallel work with the service runtime properties.

Before using the configuration options, it is advisable to read the general rules for using logs and traces in J2EE Engine.

 

Features

The Log Configurator service has the following features:

·        Initial configuration of logging and tracing for server components – each server component can specify in a log-configuration.xml how the logging and tracing has to be configured. This XML must be packed in the <SDA_root><server|dispatcher>/descriptors/ directory of the SDA of the component and its name must be exactly log-configuration.xml.

·        For runtime management of the logging and tracing configuration – the logging and tracing routines can be configured for a running system using either the Visual Administrator or the Shell Console Administrator.

·        Configuration of logging and tracing for applications that are deployed on the J2EE Engine – the Log Configurator service can extract a log-configuration.xml if it is packed in the application EAR file. The XML must be placed in the /META-INF/ directory of the EAR and its name must be exactly log-configuration.xml.

Log Archiving

The Log Configurator service provides an option for automatic archiving of log files at regular intervals. To activate this function, choose Server ® Services ® Log Configurator ®Properties tab and set the value of the ArchiveOldLogFiles as “ON”. The archives are stored in the J2EE Engine ..log/archive directory. This directory is specified using the ArchivesDirectory property of the same service.

There is no automatic procedure for deleting the archives. You have to do this manually.