DOCSP-14117 Timezone datafile update

Author: mungitoperrito

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 <https://www.iana.org/time-zones>`_. 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 <https://www.iana.org/time-zones>`_. 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
+<https://downloads.mongodb.org/olson_tz_db/timezonedb-latest.zip>`_.
+

source/includes/warning-timeZoneInfo.rst

@@ -0,0 +1,14 @@
+.. warning::
+
+   MongoDB uses the third party `timelib
+   <https://github.com/derickr/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
+   <https://downloads.mongodb.org/olson_tz_db/timezonedb-latest.zip>`_.
+   and use the :option:`timeZoneInfo <mongod --timeZoneInfo>` parameter.
+

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:

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`.

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