Update our documentation concerning where to create data directories.

Tom Lane <tgl@sss.pgh.pa.us>

Commit: 208e41d9133b26f2de04619c66fc7b31a0777c9e
Author: Tom Lane <tgl@sss.pgh.pa.us>
Date: 2015-07-28T22:42:59Z
Releases: 9.0.23
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.

Files

PathChange+/−
doc/src/sgml/runtime.sgml modified +57 −22