diff --git a/gpdb-doc/dita/best_practices/sysconfig.xml b/gpdb-doc/dita/best_practices/sysconfig.xml index edcf640818c45ba8328b8d97e1e554199d77a93b..a88e8a196f6174557d2eeee10cfe4bfc25118a7a 100644 --- a/gpdb-doc/dita/best_practices/sysconfig.xml +++ b/gpdb-doc/dita/best_practices/sysconfig.xml @@ -6,6 +6,32 @@ Database cluster hosts.

Configuration of the Greenplum Database cluster is usually performed as root.

+
+ Configuring the Timezone +

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.

+

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.

+

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 gpconfig utility to show and set the Greenplum Database timezone. + For example, these commands show the Greenplum Database timezone and set the timezone to + US/Pacific.# gpconfig -s TimeZone +# gpconfig -c TimeZone 'US/Pacific'You + must restart Greenplum Database after changing the timezone. The command gpstop + -ra restarts Greenplum Database. The catalog view + pg_timezone_names provides Greenplum Database timezone information.

+
+
File System

XFS is the file system used for Greenplum Database data directories. XFS should be mounted