Hosted by:

wrapper.logfile.rollmode Property

wrapper.logfile.rollmode Property

Configuration Property Overview

- Configuration Property Overview
- Logging Configuration Properties
- Property List by Name

wrapper.logfile.rollmode

Controls the roll mode of the log file. Possible values include:

- `NONE` - The log file will never be rolled by the Wrapper. The log file will continue to grow in size indefinately. In general, it is best to avoid this option as it could provide a way for the Wrapper to eat up all available disc space should an application produce very large quantities of output.

  There are cases, however, where a user would want to disable log rolling by the Wrapper. An example is where an external log rolling tool is being used.

- `SIZE` - The log file will be rolled whenever its size exceeds the value defined by the wrapper.logfile.maxsize property.

- `WRAPPER` - The log file will be rolled when the Wrapper is first launched. This rolling will happen immediately after the configuration file has been loaded. For this reason, any configuration problems will be logged to the file prior to it being rolled. The log files will not have a maximum size and will continue to grow until the Wrapper is restarted.

- `JVM` - The log file will be rolled on Wrapper startup as with the `WRAPPER` mode. But it will also be rolled just before any restarted JVMs are launced. The log files will not have a maximum size and will continue to grow until the Wrapper or a JVM is restarted.

- `SIZE_OR_WRAPPER` - This mode combines the `SIZE` and `WRAPPER` modes. The logfile will be rolled on Wrapper startup or whenever the logfile exceeds the configured maximum size.

- `SIZE_OR_JVM` - This mode combines the `SIZE` and `JVM` modes. The logfile will be rolled on Wrapper startup, JVM restart, or whenever the logfile exceeds the configured maximum size.

- `DATE` - As each log entry is logged to a file, its timestamp is compared with a YYYYMMDD formatted token in the current log file. Whenever this date changes a new log file will be opened. This has the benefit of grouping all log entries for a given day in a specific file. A file will not be created on days which do not have any log output.

  This roll mode requires that the wrapper.logfile property contain the token "YYYYMMDD" someplace in the file name.

See the wrapper.logfile property for an explanation of how to name the logfile.

Defaults to `SIZE`.

Example:

    wrapper.logfile.rollmode=SIZE

by Leif Mortenson

Copyright ©1999-2004 by Tanuki Software. All Rights Reserved. | last modified: