Document that not backing up postmaster.pid and postmaster.opts might

help prevent pg_ctl from getting confused.

Backpatch to 9.1.

diff --git a/doc/src/sgml/backup.sgml b/doc/src/sgml/backup.sgml
index b8daedcbb6e42241ad987fddcdec8310a731423e..737355a911d97cc9b436868cf798e469ec587d6d 100644 (file)
--- a/doc/src/sgml/backup.sgml
+++ b/doc/src/sgml/backup.sgml
@@ -869,7 +869,11 @@ SELECT pg_stop_backup();
     of mistakes when restoring.  This is easy to arrange if
     pg_xlog/ is a symbolic link pointing to someplace outside
     the cluster directory, which is a common setup anyway for performance
-    reasons.
+    reasons.  You might also want to exclude postmaster.pid
+    and postmaster.opts, which record information
+    about the running postmaster, not about the
+    postmaster which will eventually use this backup.
+    (These files can confuse pg_ctl.)