pgsql: Update our documentation concerning where to create data directo - Mailing list pgsql-committers

From Tom Lane
Subject pgsql: Update our documentation concerning where to create data directo
Date
Msg-id E1ZKDbH-0007vp-1N@gemulon.postgresql.org
Whole thread Raw
List pgsql-committers
Update our documentation concerning where to create data directories.

Although initdb has long discouraged use of a filesystem mount-point
directory as a PG data directory, this point was covered nowhere in the
user-facing documentation.  Also, with the popularity of pg_upgrade,
we really need to recommend that the PG user own not only the data
directory but its parent directory too.  (Without a writable parent
directory, operations such as "mv data data.old" fail immediately.
pg_upgrade itself doesn't do that, but wrapper scripts for it often do.)

Hence, adjust the "Creating a Database Cluster" section to address
these points.  I also took the liberty of wordsmithing the discussion
of NFS a bit.

These considerations aren't by any means new, so back-patch to all
supported branches.

Branch
------
REL9_4_STABLE

Details
-------
http://git.postgresql.org/pg/commitdiff/0f272b8b4cf2a2217de64cb72e12530efb9c9e3b

Modified Files
--------------
doc/src/sgml/runtime.sgml |   79 ++++++++++++++++++++++++++++++++-------------
1 file changed, 57 insertions(+), 22 deletions(-)


pgsql-committers by date:

Previous
From: Andrew Dunstan
Date:
Subject: pgsql: Only adjust negative indexes in json_get up to the length of the
Next
From: Tom Lane
Date:
Subject: pgsql: Update our documentation concerning where to create data directo