Setting Log File Parameters (SAP Library - ITS Tuning and Troubleshooting Guide)

Setting Log File Parameters

Use

You use this procedure to set log file parameters.

You can:

Define the handling of log files
Change the default directory location of log files

Prerequisites

You have started ITS Administration.

Procedure

Select an ITS instance and choose an AGate server hosted at the local machine.

Choose Configuration.

Choose Logs

You see a screen similar to the following:

This graphic is explained in the accompanying text

To change the default directory location of log files, do the following:

Choose LogPath.
Enter the new directory location.
Save your changes.

Choose a log file.

If you choose Access, Diagnostics or Loadstat to set parameters for access logs, diagnostics logs or load statistics logs, you see a screen similar to the following:

This graphic is explained in the accompanying text

If you choose Performance to set parameters for performance logs, you see a screen similar to the following:

This graphic is explained in the accompanying text

Choose the parameter(s) you want to set, and enter or change the value(s).

You can set values for the above parameters as listed in the following table:

Parameter	Description
BurialCmd	Specifies how archived log files should be handled after their retention period has expired. If you do not enter a value, ITS Administration deletes expired files from the file system. To define some other handling for a file, specify a burial command.
CacheSize	Size (in bytes) of the internal buffer used for cached and uncached writes to the log. If Caching is enabled (see below), CacheSize controls the block size with which information is flushed to the file system.
Caching	Enables / disables caching of log file data. To switch caching off, set this value to 0 To switch caching on; set this value to 1 For the ADM instance, this parameter should be set to 0.
FileSize	Maximum size (in bytes) of a log file before it is archived. This parameter controls the transition from the status "current log" to the status "archived log". To switch the archiving off, set this value to -1. In this case, the log file can grow without limit.
TimeToLive	Retention period (in days) for archived log files. If an archived log file is older than this, ITS Administration deletes it according to the value specified in BurialCmd. To prevent the archived files from being deleted, set the TimeToLive value to -1.
LogInterval	Time (in seconds) between each entry in the performance log. The default value is 60.

Save your changes.

Result

ITS Administration updates the values in the Windows NT registry. To apply these changes, you must restart the ITS instance.

For further information about log files, see ITS Log Files.