The timezone property makes it possible to define the time zone in which the Wrapper will be executed.
Starting from version 3.5.29, it is advised to use IANA time zone identifiers. These identifiers are composed of the name of a continent or ocean and a name of a representative location within this area (typically the name of the largest city). For example, 'America/Los_Angeles' represents the timezone of Pacific Time. A full list of the identifiers can be found here.
For backward compatibility, a list of time zone abbreviations (e.g. MST, GMT, JST, etc.) is also supported.
However, Java deprecated these because the same abbreviation is sometimes used to represent several time zones.
It is not recommended to use them in the Wrapper configuration because the same code may lead to different interpretations depending on the operating system.
With IANA time zones, the same configuration will always produce the same time regardless of the platform.
Examples on defining the Timezone:
wrapper.timezone=America/Los_Angeles //Set the Timezone to Pacific Time
using a IANA identifier
wrapper.timezone=CET //Set the Timezone to Central European Time
wrapper.timezone=UTC+0100 //Set the Timezone to UTC+01
wrapper.timezone=UTC-0530 //Set the Timezone to UTC-0530
(-5 hours and 30 minutes offset to UTC)
Changing the timezone will affect the timestamps in all log output (in Standard and Professional Editions),
as well as the wrapper.timer.<n>.interval property
and the Mail Settings (in Professional Edition).
Starting from version 3.5.35, the timezone, if specified, will be passed to the JVM using the 'user.timezone' option.
This guarantees that the time is always synchronized between the Wrapper and Java application.
It is possible to specify a different timezone for the Java application by setting one of the wrapper.java.additional.<n> properties with '-Duser.timezone=<YOUR_TIMEZONE>'.
Alternatively you may add this option without specifying a value to use the timezone of the machine on which the application is running.
This property is required when using an IANA identifier. It allows you to specify the path to a directory containing the IANA Time Zone Database source files.
The IANA Time Zone database is regularly updated to take into account changes in the local times all over the world. The database provides several files (one per region in the world) which are grouped together in a single tar.gz package, and available for download on the website of the Internet Assigned Number Authority (IANA).
These files are called:
You should select the file named with the region containing the selected timezone. For example, the file 'northamerica' would be used when using the time zone 'America/Los_Angeles'. Next, extract it and put it in the location specified by the wrapper.timezone.file property. You may also put other files in the same folder if you plan to change wrapper.timezone to a timezone located in another region.
Since JAVA also uses the IANA Time Zone Database, the time used by your Java application will be consistent with the time of the Wrapper as long as they use the same timezone identifier. However, you may have to confirm that the version of the timezone database is the same as the one provided in your JRE release. A list of the versions per JRE release is available on Oracle's website.
Until version 3.5.44, there was an issue where the Wrapper hung on startup if the file
'etcetera' (part of the IANA tz database) was present at the location
specified by wrapper.timezone.folder. Removing this file would solve the issue. This has been fixed in version version 3.5.45.
Sometimes you want to turn off Summer (Daylight Saving) Time for some reasons
like having the Wrapper run on different servers in different timezones
and keeping the log files with the same timestamps, without changing the system's timezone.
With this property, you can specify whether the Wrapper will change the timezone information
to Summer(Daylight)/Winter Time automatically,
if the wrapper.timezone property has been set.
The default value is "TRUE".
Example: (Enable the time change to Summer/Winter Time)
If a timezone doesn't use Summer Time, this property will be ignored.
This also means that the Wrapper won't respect the property if the timezone was defined with "UTC+/-xxxx".
Also when a Summer (Daylight) Time has been defined for wrapper.timezone,
this property also has no effect.
This property allows to display the offset of the current timezone in the timestamps of the log outputs.
When using a IANA timezone, an additional letter will be added to indicate if daylight saving time is in effect
('D' for Daylight saving time, 'S' for Standard time).
The default value is FALSE, meaning that the timestamps will be displayed without this additional information.
Example: (log output with wrapper.timezone.debug_timestamps=TRUE)
STATUS | 2016/03/16 17:54:44 GMT-07:00 D | wrapper | --> Wrapper Started as Console
List of the supported timezone identifiers
For a full list of the IANA timezone identifiers, please refer to this page.