World Map
Java Service Wrapper is the easiest way to make your product more reliable.
  • Free Trial
  • Buy Now
wrapper.logfile.rollmode Property

wrapper.logfile.rollmode

Compatibility :3.2.0
Editions :Professional EditionStandard EditionCommunity Edition
Platforms :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

This property controls the roll mode of the log file. See the wrapper.logfile property for an explanation of how to name the log file.

The default value is SIZE.

Example:
wrapper.logfile.rollmode=SIZE

Possible mode values include:

  • NONE :

    In this mode, the log file will never be rolled by the Wrapper. The log file will continue to grow in size indefinitely. 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 :

    In this mode, the log file will be rolled whenever its size exceeds the value defined by the wrapper.logfile.maxsize property.

  • WRAPPER :

    In this mode, 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. In this WRAPPER mode, the log files will not have a maximum size and will continue to grow until the Wrapper is restarted.

  • JVM :

    In this mode, 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. In this JVM mode, 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 log file will be rolled on Wrapper startup or whenever the log file exceeds the configured maximum size.

  • SIZE_OR_JVM :

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

  • DATE :

    In this mode, As each log entry is logged to a file by date, its timestamp is compared with a "YYYYMMDD" formatted token in the current log file. Whenever this date changes a new log file will be start to be loged. 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.

    WARNING

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

Reference: logfile