From 24d7f7227effc5333ab93b930a80c0e61683840a Mon Sep 17 00:00:00 2001
From: Ian Barwick <ian@2ndquadrant.com>
Date: Wed, 23 Jan 2019 12:33:05 +0900
Subject: [PATCH] doc: clarify use-cases for pausing repmgrd

---
 doc/repmgrd-pausing.sgml | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/doc/repmgrd-pausing.sgml b/doc/repmgrd-pausing.sgml
index 07bb905c..b24a3624 100644
--- a/doc/repmgrd-pausing.sgml
+++ b/doc/repmgrd-pausing.sgml
@@ -21,13 +21,14 @@
   <para>
     However, <application>repmgrd</application> is unable to distinguish between
     planned outages (such as performing a <link linkend="performing-switchover">switchover</link>
-    or upgrading a server), and an actual server outage. In versions prior to &repmgr; 4.2
-    it was necessary to stop <application>repmgrd</application> on all nodes (or at least
+    or installing PostgreSQL maintenance released), and an actual server outage. In versions prior to
+    &repmgr; 4.2 it was necessary to stop <application>repmgrd</application> on all nodes (or at least
     on all nodes where <application>repmgrd</application> is
     <link linkend="repmgrd-automatic-failover">configured for automatic failover</link>)
-    to prevent <application>repmgrd</application> from making changes to the
+    to prevent <application>repmgrd</application> from making unintentional changes to the
     replication cluster.
   </para>
+
   <para>
     From <link linkend="release-4.2">&repmgr; 4.2</link>, <application>repmgrd</application>
     can now be &quot;paused&quot;, i.e. instructed not to take any action such as performing a failover.
@@ -35,6 +36,14 @@
     each <application>repmgrd</application> individually.
   </para>
 
+  <note>
+    <para>
+      For major PostgreSQL upgrades, e.g. from PostgreSQL 10 to PostgreSQL 11,
+      <application>repmgrd</application> should be shut down completely and only started up
+      once the &repmgr; packages for the new PostgreSQL major version have been installed.
+    </para>
+  </note>
+
   <sect1 id="repmgrd-pausing-prerequisites">
     <title>Prerequisites for pausing <application>repmgrd</application></title>
     <para>