[DOCS-10881] Docs for SERVER-29823: Add evergreen task to update and publish time zone rules Created: 09/Oct/17  Updated: 29/Oct/23  Resolved: 06/Nov/17

Status: Closed
Project: Documentation
Component/s: manual, Server
Affects Version/s: None
Fix Version/s: 3.5.14, 3.6.0-rc0

Type: Task Priority: Major - P3
Reporter: Kay Kim (Inactive) Assignee: Kevin Albertson
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Documented
documents SERVER-29823 Add evergreen task to update and publ... Closed
Related
related to DOCS-10473 Docs for SERVER-29822: update linux p... Closed
is related to SERVER-31731 Test that mongos accepts a --timeZone... Closed
Participants:
Days since reply: 6 years, 14 weeks, 2 days ago
Epic Link: DOCS: 3.6 Server

 Description   

Documentation Request Summary:

Under this ticket, we should document how users can configure the Olson/IANA timezone database (https://www.iana.org/time-zones) which the aggregation framework will use for time zone calculations. The details are described in the "Olson Timezone DB Management" section of the design document: https://docs.google.com/document/d/1I_x4NNWgfcXzmEFTPTYZkjIQVq_JUnZcxb5ak0o52oU/edit#heading=h.pwlnl94kk4xq.

I will try to summarize some of the most important points that need to be documented here:

  • There is an embedded version of the Olson database that will be used automatically, but this will be updated infrequently (e.g. once per major release).
  • We have added a new "processManagement.timeZoneInfo" config file parameter and "--timeZoneInfo" command line parameter. This can be used to override the builtin copy of the Olson database by pointing at a directory containing the tz db files.
  • Linux packages have been updated to set this parameter automatically to point at the system installation of the Olson database. This is to be documented under SERVER-29822. Such users can upgrade their Olson database simply by upgrading their system's version of the time zone db.
  • For users that may not have a system copy of the Olson database, in particular Windows users, we provide a stable download link for the latest version of the database: https://downloads.mongodb.org/olson_tz_db/timezonedb-latest.zip. Details about how to use this archive are present in the design document.

Please send the CR to David Storch and Nicholas Zolnierz, and let me know if you have any questions!

Engineering Ticket Description:

We will need to add a task that will:

  • Pull the most recent version of the Olsen time zone database
  • Transform that data into the directory structure MongoDB/timelib expects
  • Upload it to a place users can download it from
  • Add commits to MongoDB branches that support time zone information to update the built-in timezone rules.


 Comments   
Comment by Githook User [ 06/Nov/17 ]

Author:

{'name': 'Kevin Albertson', 'username': 'kevinAlbs', 'email': 'kevin.albertson@10gen.com'}

Message: DOCS-10881 add info about time zone options
Branch: master
https://github.com/mongodb/docs/commit/ca122fc1e86aafa753af5c2493a12b58fd9c46e4

Comment by Kevin Albertson [ 06/Nov/17 ]

This is partially done by the work in DOCS-10473. However DOCS-10473 does not include advice on when users would want to upgrade the timezone database (due to less frequent release cycle) or instructions to download the timezone database.

Comment by Charlie Swanson [ 26/Oct/17 ]

See SERVER-31731, we should also document that this parameter should be configured similarly on mongos.

Generated at Thu Feb 08 08:01:35 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.