adding best practice note for setting timezone (#5095)

* adding best practice note for setting timezone * edits to clarify timezone behavior

adding best practice note for setting timezone (#5095)
* adding best practice note for setting timezone * edits to clarify timezone behavior
4aed75c3 · David Yozie · GitHub · ce22b327 · 4aed75c3
隐藏空白更改
内联并排

Showing with 26 addition and 0 deletion

gpdb-doc/dita/best_practices/sysconfig.xml gpdb-doc/dita/best_practices/sysconfig.xml +26 -0

未找到文件。
--- a/gpdb-doc/dita/best_practices/sysconfig.xml
+++ b/gpdb-doc/dita/best_practices/sysconfig.xml
@@ -6,6 +6,32 @@
    Database cluster hosts.</shortdesc>
  <body>
    <p>Configuration of the Greenplum Database cluster is usually performed as root.</p>
+    <section id="topic_fvc_zh1_b2b">
+      <title>Configuring the Timezone</title>
+      <p>Greenplum Database selects a timezone to use from a set of internally stored PostgreSQL
+        timezones. The available PostgreSQL timezones are taken from the Internet Assigned Numbers
+        Authority (IANA) Time Zone Database, and Greenplum Database updates its list of available
+        timezones as necessary when the IANA database changes for PostgreSQL. </p>
+      <p>Greenplum selects the timezone by matching a PostgreSQL timezone with the user specified
+        time zone, or the host system time zone if no time zone is configured. For example, when
+        selecting a default timezone, Greenplum uses an algorithm to select a PostgreSQL timezone
+        based on the host system timezone files. If the system timezone includes leap second
+        information, Greenplum Database cannot match the system timezone with a PostgreSQL timezone.
+        In this case, Greenplum Database calculates a "best match" with a PostgreSQL timezone based
+        on information from the host system.</p>
+      <p>As a best practice, configure the Greenplum Database and the host system to use a known,
+        supported timezone. This prevents Greenplum Database from recalculating a "best match"
+        timezone each time the cluster is restarted, using the current system timezone and Greenplum
+        timezone files (which may have been updated from the IANA database since the last restart).
+        Use the <codeph>gpconfig</codeph> utility to show and set the Greenplum Database timezone.
+        For example, these commands show the Greenplum Database timezone and set the timezone to
+          <codeph>US/Pacific</codeph>.<codeblock># gpconfig -s TimeZone
+# gpconfig -c TimeZone 'US/Pacific'</codeblock>You
+        must restart Greenplum Database after changing the timezone. The command <codeph>gpstop
+          -ra</codeph> restarts Greenplum Database. The catalog view
+          <codeph>pg_timezone_names</codeph> provides Greenplum Database timezone information.</p>
+    </section>
+
    <section id="file_system">
      <title>File System</title>
      <p>XFS is the file system used for Greenplum Database data directories. XFS should be mounted