[Contents] [Prev] [Next] [Index] [Report an Error]

# Configuring a Component to Store Log Messages in a File (SRC CLI)

Use the following statements to configure an SRC component to store log messages in a file:

`

logger name file {
  filter filter;
  filename filename;
  rollover-filename rollover-filename;
  maximum-file-size maximum-file-size;
}

`

If you plan to filter log messages, you should be familiar with severity levels and filters for logging before you configure system logging for a component. See Categories and Severity Levels for Event Messages.

To configure component logging to a file:

1. From configuration mode, access the configuration statement that configures the logging destination for the component.
   `
   [edit]
   user@host# component-hierarchy logger name file
   `

   For example:

   `
   [edit]
   user@host# edit shared sae configuration logger sae-file-log-1 file
   [edit]
   user@host# edit snmp agent logger snmp-file-log-1 file
   [edit]
   user@host# edit slot 0 jps logger jps-file-log-1 file
   `
2. Specify the filter to define which event messages the software logs or disregards.
   `
   [edit shared sae configuration logger sae-file-log-1 file]
   user@host# set filter filter
   `

   If you do not specify a filter, logging to the specified file is disabled.

   Filters can specify the logging level, such as debug, or can specify expressions.

3. Specify the absolute path of the filename that contains the current log files.
   `
   [edit shared sae configuration logger sae-file-log-1 file]
   user@host# set filename filename
   `

   Make sure that the user under which the J2EE application server or Web application server runs has write access to this folder. If this user does not have write access to the default folder, configure the component or application to write logs in folders to which the user has write access.

4. (Optional) Specify the absolute path of the filename that contains the log history.
   `
   [edit shared sae configuration logger sae-file-log-1 file]
   user@host# set rollover-filename rollover-filename
   `

   When the log file reaches the maximum size, the software closes the log file and renames it. If a previous rollover file exists, the software overwrites it. The software then reopens the log file and continues to save event messages in it.

   | Note: On a C Series Controller, log files are automatically rotated on a daily basis. If you do configure a rollover file when files are rotated, the software creates five compressed versions of partial log files, and one uncompressed log file.

5. (Optional) Specify the maximum size of the log file and the rollover file.
   `
   [edit shared sae configuration logger sae-file-log-1 file]
   user@host# set maximum-file-size maximum-file-size
   `

   Do not set the maximum file size to a value greater than the available disk space.

   | Note: On a C Series Controller, log files are automatically rotated on a daily basis.

#### Related Topics

- Configuring System Logging (SRC CLI)
- Saving System Log Messages to a File (SRC CLI)
- Sending System Log Messages to Other Servers (SRC CLI)
- Before You Configure Logging
- Overview of Logging for SRC Components

[Contents] [Prev] [Next] [Index] [Report an Error]