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

bmomjian · bmomjian · commit 35db9d0ab8a8 · 2011-10-11T17:33:21.000-04:00
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
@@ -869,7 +869,11 @@ SELECT pg_stop_backup();
     of mistakes when restoring.  This is easy to arrange if
     <filename>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 <filename>postmaster.pid</>
+    and <filename>postmaster.opts</>, which record information
+    about the running <application>postmaster</>, not about the
+    <application>postmaster</> which will eventually use this backup.
+    (These files can confuse <application>pg_ctl</>.)
    </para>
 
    <para>
