1<refentry id="repmgr-service-unpause">
2  <indexterm>
3    <primary>repmgr service unpause</primary>
4  </indexterm>
5
6  <indexterm>
7    <primary>repmgrd</primary>
8    <secondary>unpausing</secondary>
9  </indexterm>
10
11  <refmeta>
12    <refentrytitle>repmgr service unpause</refentrytitle>
13  </refmeta>
14
15  <refnamediv>
16    <refname>repmgr service unpause</refname>
17    <refpurpose>Instruct all &repmgrd; instances in the replication cluster to resume failover operations</refpurpose>
18  </refnamediv>
19
20  <refsect1>
21    <title>Description</title>
22    <para>
23      This command can be run on any active node in the replication cluster to instruct all
24      running &repmgrd; instances to &quot;unpause&quot;
25      (following a previous execution of <xref linkend="repmgr-service-pause"/>)
26      and resume normal failover/monitoring operation.
27    </para>
28
29    <note>
30      <para>
31        It's important to wait a few seconds after restarting PostgreSQL on any node before running
32        <command>repmgr service pause</command>, as the &repmgrd; instance
33        on the restarted node will take a second or two before it has updated its status.
34      </para>
35    </note>
36
37  </refsect1>
38
39  <refsect1>
40    <title>Prerequisites</title>
41    <para>
42      PostgreSQL must be accessible on all nodes (using the <varname>conninfo</varname> string shown by
43      <link linkend="repmgr-cluster-show"><command>repmgr cluster show</command></link>)
44      from the node where <command>repmgr service pause</command> is executed.
45    </para>
46  </refsect1>
47
48  <refsect1>
49    <title>Execution</title>
50    <para>
51     <command>repmgr service unpause</command> can be executed on any active node in the
52      replication cluster. A valid <filename>repmgr.conf</filename> file is required.
53      It will have no effect on nodes which are not already paused.
54    </para>
55  </refsect1>
56
57  <refsect1>
58    <title>Example</title>
59    <para>
60    <programlisting>
61$ repmgr -f /etc/repmgr.conf service unpause
62NOTICE: node 1 (node1) unpaused
63NOTICE: node 2 (node2) unpaused
64NOTICE: node 3 (node3) unpaused</programlisting>
65    </para>
66  </refsect1>
67
68  <refsect1>
69    <title>Options</title>
70    <variablelist>
71      <varlistentry>
72        <term><option>--dry-run</option></term>
73        <listitem>
74          <para>
75            Check if nodes are reachable but don't unpause &repmgrd;.
76          </para>
77        </listitem>
78      </varlistentry>
79    </variablelist>
80  </refsect1>
81
82  <refsect1>
83    <title>Exit codes</title>
84    <para>
85      One of the following exit codes will be emitted by <command>repmgr service unpause</command>:
86    </para>
87    <variablelist>
88
89      <varlistentry>
90        <term><option>SUCCESS (0)</option></term>
91        <listitem>
92          <para>
93            &repmgrd; could be unpaused on all nodes.
94          </para>
95        </listitem>
96      </varlistentry>
97
98      <varlistentry>
99        <term><option>ERR_REPMGRD_PAUSE (26)</option></term>
100        <listitem>
101          <para>
102           &repmgrd; could not be unpaused on one or mode nodes.
103          </para>
104        </listitem>
105      </varlistentry>
106
107    </variablelist>
108  </refsect1>
109
110  <refsect1>
111    <title>See also</title>
112    <para>
113      <xref linkend="repmgr-service-pause"/>,
114      <xref linkend="repmgr-service-status"/>,
115      <xref linkend="repmgrd-pausing"/>,
116      <xref linkend="repmgr-daemon-start"/>,
117      <xref linkend="repmgr-daemon-stop"/>
118    </para>
119  </refsect1>
120</refentry>
121
122