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.