Add switchover section

doc/command-reference.sgml

@@ -149,7 +149,7 @@
  </sect1>
 
 
- <sect1 id="repmgr-standby-unregister" xreflabel="repmgr standby inregister">
+ <sect1 id="repmgr-standby-unregister" xreflabel="repmgr standby unregister">
   <indexterm><primary>repmgr standby unregister</primary></indexterm>
   <title>repmgr standby unregister</title>
   <para>
@@ -235,6 +235,35 @@
   </para>
  </sect1>
 
+
+ <sect1 id="repmgr-standby-switchover" xreflabel="repmgr standby switchover">
+  <indexterm>
+    <primary>repmgr standby switchover</primary>
+  </indexterm>
+  <title>repmgr standby switchover</title>
+  <para>
+    Promotes a standby to primary and demotes the existing primary to a standby.
+    This command must be run on the standby to be promoted, and requires a
+    passwordless SSH connection to the current primary.
+  </para>
+  <para>
+    If other standbys are connected to the demotion candidate, &repmgr; can instruct
+    these to follow the new primary if the option <literal>--siblings-follow</literal>
+    is specified.
+  </para>
+  <para>
+    Execute with the <literal>--dry-run</literal> option to test the switchover as far as
+    possible without actually changing the status of either node.
+  </para>
+  <para>
+    <command>repmgrd</command> should not be active on any nodes while a switchover is being
+    executed. This restriction may be lifted in a later version.
+  </para>
+  <para>
+    For more details see the section <xref linkend="performing-switchover">.
+  </para>
+ </sect1>
+
  <sect1 id="repmgr-cluster-show" xreflabel="repmgr cluster show">
   <indexterm>
     <primary>repmgr cluster show</primary>

doc/filelist.sgml

@@ -42,6 +42,7 @@
 <!ENTITY cloning-standbys  SYSTEM "cloning-standbys.sgml">
 <!ENTITY promoting-standby  SYSTEM "promoting-standby.sgml">
 <!ENTITY follow-new-primary  SYSTEM "follow-new-primary.sgml">
+<!ENTITY switchover  SYSTEM "switchover.sgml">
 <!ENTITY command-reference SYSTEM "command-reference.sgml">
 <!ENTITY appendix-signatures      SYSTEM "appendix-signatures.sgml">
 

doc/repmgr.sgml

@@ -71,6 +71,7 @@
   &cloning-standbys;
   &promoting-standby;
   &follow-new-primary;
+  &switchover;
   &command-reference;
  </part>