From bd42455cb8c53499a0eadf9d12e1bf8e43548a51 Mon Sep 17 00:00:00 2001 From: Dave Cuthbert Date: Mon, 23 Aug 2021 16:06:11 -0400 Subject: [PATCH] DOCSP-14117 Timezone datafile update --- source/includes/fact-timeZoneInfo.rst | 15 ++++++++------- source/includes/warning-timeZoneInfo.rst | 14 ++++++++++++++ source/reference/configuration-options.txt | 3 ++- source/reference/program/mongod.txt | 4 +++- source/reference/program/mongos.txt | 3 ++- 5 files changed, 29 insertions(+), 10 deletions(-) create mode 100644 source/includes/warning-timeZoneInfo.rst diff --git a/source/includes/fact-timeZoneInfo.rst b/source/includes/fact-timeZoneInfo.rst index 9af599d1cfc..fad8926aa94 100644 --- a/source/includes/fact-timeZoneInfo.rst +++ b/source/includes/fact-timeZoneInfo.rst @@ -1,12 +1,13 @@ The full path from which to load the time zone database. If this option is not provided, then MongoDB will use its built-in time zone database. -The configuration file included with Linux and macOS packages sets the time -zone database path to ``/usr/share/zoneinfo`` by default. +The configuration file included with Linux and macOS packages sets the +time zone database path to ``/usr/share/zoneinfo`` by default. The built-in time zone database is a copy of the `Olson/IANA time zone -database `_. It is updated along with MongoDB -releases, but the release cycle of the time zone database differs from the -release cycle of MongoDB. A copy of the most recent release of the time zone -database can be downloaded from -https://downloads.mongodb.org/olson_tz_db/timezonedb-latest.zip. +database `_. It is updated along with +MongoDB releases, but the time zone database release cycle +differs from the MongoDB release cycle. The most recent release of +the time zone database is available on our `download site +`_. + diff --git a/source/includes/warning-timeZoneInfo.rst b/source/includes/warning-timeZoneInfo.rst new file mode 100644 index 00000000000..2c3e81e2cc8 --- /dev/null +++ b/source/includes/warning-timeZoneInfo.rst @@ -0,0 +1,14 @@ +.. warning:: + + MongoDB uses the third party `timelib + `_ library to provide accurate + conversions between timezones. Due to a recent update, ``timelib`` + could create inaccurate time zone conversions in older versions of + MongoDB. + + To explicitly link to the time zone database in versions of MongoDB + prior to 5.0, 4.4.7, 4.2.14, and 4.0.25, download the `time zone + database + `_. + and use the :option:`timeZoneInfo ` parameter. + diff --git a/source/reference/configuration-options.txt b/source/reference/configuration-options.txt index 50ec1d45002..cf01997e585 100644 --- a/source/reference/configuration-options.txt +++ b/source/reference/configuration-options.txt @@ -734,7 +734,8 @@ Core Options *Type*: string .. include:: /includes/fact-timeZoneInfo.rst - + + .. include:: /includes/warning-timeZoneInfo.rst .. _free-monitoring-configuration-options: diff --git a/source/reference/program/mongod.txt b/source/reference/program/mongod.txt index b4accbc003e..d6cfb153029 100644 --- a/source/reference/program/mongod.txt +++ b/source/reference/program/mongod.txt @@ -807,7 +807,9 @@ Core Options wget https://downloads.mongodb.org/olson_tz_db/timezonedb-latest.zip unzip timezonedb-latest.zip mongod --timeZoneInfo timezonedb-2017b/ - + + .. include:: /includes/warning-timeZoneInfo.rst + .. seealso:: :setting:`processManagement.timeZoneInfo`. diff --git a/source/reference/program/mongos.txt b/source/reference/program/mongos.txt index 37837a7cf2c..c35404b688b 100644 --- a/source/reference/program/mongos.txt +++ b/source/reference/program/mongos.txt @@ -607,7 +607,8 @@ Core Options wget https://downloads.mongodb.org/olson_tz_db/timezonedb-latest.zip unzip timezonedb-latest.zip mongos --timeZoneInfo timezonedb-2017b/ - + + .. include:: /includes/warning-timeZoneInfo.rst .. option:: --outputConfig