mirror of
https://github.com/EnterpriseDB/repmgr.git
synced 2026-03-23 15:16:29 +00:00
2491b8ae52
In some circumstances, e.g. while performing a switchover, it is essential
that repmgrd does not take any kind of failover action, as this will put
the cluster into an incorrect state.
Previously it was necessary to stop repmgrd on all nodes (or at least
those nodes which repmgrd would consider as promotion candidates), however
this is a cumbersome and potentially risk-prone operation, particularly if the
replication cluster contains more than a couple of servers.
To prevent this issue from occurring, this patch introduces the ability
to "pause" repmgrd on all nodes wth a single command ("repmgr daemon pause")
which notifies repmgrd not to take any failover action until the node
is "unpaused" ("repmgr daemon unpause").
"repmgr daemon status" provides an overview of each node and whether repmgrd
is running, and if so whether it is paused.
"repmgr standby switchover" has been modified to automatically pause repmgrd
while carrying out the switchover.
See documentation for further details.
130 lines
3.3 KiB
Plaintext
130 lines
3.3 KiB
Plaintext
<!-- doc/src/sgml/postgres.sgml -->
|
|
|
|
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.2//EN" [
|
|
|
|
<!ENTITY % version SYSTEM "version.sgml">
|
|
%version;
|
|
|
|
<!ENTITY % filelist SYSTEM "filelist.sgml">
|
|
%filelist;
|
|
|
|
<!ENTITY repmgr "<productname>repmgr</productname>">
|
|
<!ENTITY postgres "<productname>PostgreSQL</productname>">
|
|
]>
|
|
|
|
<book id="repmgr">
|
|
<title>repmgr &repmgrversion; Documentation</title>
|
|
|
|
<bookinfo>
|
|
<corpauthor>2ndQuadrant Ltd</corpauthor>
|
|
<productname>repmgr</productname>
|
|
<productnumber>&repmgrversion;</productnumber>
|
|
&legal;
|
|
|
|
<abstract>
|
|
<para>
|
|
This is the official documentation of &repmgr; &repmgrversion; for
|
|
use with PostgreSQL 9.3 - PostgreSQL 10.
|
|
It describes the functionality supported by the current version of &repmgr;.
|
|
</para>
|
|
|
|
<para>
|
|
&repmgr; was developed by
|
|
<ulink url="https://2ndquadrant.com">2ndQuadrant</ulink>
|
|
along with contributions from other individuals and companies.
|
|
Contributions from the community are appreciated and welcome - get
|
|
in touch via <ulink url="https://github.com/2ndQuadrant/repmgr">github</>
|
|
or <ulink url="https://groups.google.com/group/repmgr">the mailing list/forum</>.
|
|
Multiple 2ndQuadrant customers contribute funding
|
|
to make repmgr development possible.
|
|
</para>
|
|
|
|
<para>
|
|
2ndQuadrant, a Platinum sponsor of the PostgreSQL project,
|
|
continues to develop repmgr to meet internal needs and those of customers.
|
|
Other companies as well as individual developers
|
|
are welcome to participate in the efforts.
|
|
</para>
|
|
</abstract>
|
|
|
|
<keywordset>
|
|
<keyword>repmgr</keyword>
|
|
<keyword>PostgreSQL</keyword>
|
|
<keyword>replication</keyword>
|
|
<keyword>asynchronous</keyword>
|
|
<keyword>HA</keyword>
|
|
<keyword>high-availability</keyword>
|
|
</keywordset>
|
|
</bookinfo>
|
|
|
|
|
|
<part id="getting-started">
|
|
<title>Getting started</title>
|
|
&overview;
|
|
&install;
|
|
&quickstart;
|
|
</part>
|
|
|
|
<part id="repmgr-administration-manual">
|
|
<title>repmgr administration manual</title>
|
|
|
|
&configuration;
|
|
&cloning-standbys;
|
|
&promoting-standby;
|
|
&follow-new-primary;
|
|
&switchover;
|
|
&configuring-witness-server;
|
|
&event-notifications;
|
|
&upgrading-repmgr;
|
|
</part>
|
|
|
|
<part id="using-repmgrd">
|
|
<title>Using repmgrd</title>
|
|
&repmgrd-automatic-failover;
|
|
&repmgrd-configuration;
|
|
&repmgrd-demonstration;
|
|
&repmgrd-cascading-replication;
|
|
&repmgrd-network-split;
|
|
&repmgrd-witness-server;
|
|
&repmgrd-pausing;
|
|
&repmgrd-degraded-monitoring;
|
|
&repmgrd-monitoring;
|
|
&repmgrd-bdr;
|
|
</part>
|
|
|
|
<part id="repmgr-command-reference">
|
|
<title>repmgr command reference</title>
|
|
|
|
&repmgr-primary-register;
|
|
&repmgr-primary-unregister;
|
|
&repmgr-standby-clone;
|
|
&repmgr-standby-register;
|
|
&repmgr-standby-unregister;
|
|
&repmgr-standby-promote;
|
|
&repmgr-standby-follow;
|
|
&repmgr-standby-switchover;
|
|
&repmgr-witness-register;
|
|
&repmgr-witness-unregister;
|
|
&repmgr-node-status;
|
|
&repmgr-node-check;
|
|
&repmgr-node-rejoin;
|
|
&repmgr-cluster-show;
|
|
&repmgr-cluster-matrix;
|
|
&repmgr-cluster-crosscheck;
|
|
&repmgr-cluster-event;
|
|
&repmgr-cluster-cleanup;
|
|
&repmgr-daemon-status;
|
|
&repmgr-daemon-pause;
|
|
&repmgr-daemon-unpause;
|
|
</part>
|
|
|
|
&appendix-release-notes;
|
|
&appendix-signatures;
|
|
&appendix-faq;
|
|
&appendix-packages;
|
|
|
|
<![%include-index;[&bookindex;]]>
|
|
<![%include-xslt-index;[<index id="bookindex"></index>]]>
|
|
|
|
</book>
|