mirror of
https://github.com/EnterpriseDB/repmgr.git
synced 2026-03-22 22:56:29 +00:00
10425d6967
As they are now XML files. In PostgreSQL itself they remain with the .sgml suffix for backwards compatibility, but that's not important for us.
71 lines
2.1 KiB
XML
71 lines
2.1 KiB
XML
<refentry id="repmgr-standby-unregister">
|
|
<indexterm>
|
|
<primary>repmgr standby unregister</primary>
|
|
</indexterm>
|
|
|
|
<refmeta>
|
|
<refentrytitle>repmgr standby unregister</refentrytitle>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>repmgr standby unregister</refname>
|
|
<refpurpose>remove a standby's information from the &repmgr; metadata</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<para>
|
|
Unregisters a standby with &repmgr;. This command does not affect the actual
|
|
replication, just removes the standby's entry from the &repmgr; metadata.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Execution</title>
|
|
<para>
|
|
To unregister a running standby, execute:
|
|
<programlisting>
|
|
repmgr standby unregister -f /etc/repmgr.conf</programlisting>
|
|
</para>
|
|
<para>
|
|
This will remove the standby record from &repmgr;'s internal metadata
|
|
table (<literal>repmgr.nodes</literal>). A <literal>standby_unregister</literal>
|
|
event notification will be recorded in the <literal>repmgr.events</literal> table.
|
|
</para>
|
|
<para>
|
|
If the standby is not running, the command can be executed on another
|
|
node by providing the id of the node to be unregistered using
|
|
the command line parameter <literal>--node-id</literal>, e.g. executing the following
|
|
command on the primary server will unregister the standby with
|
|
id <literal>3</literal>:
|
|
<programlisting>
|
|
repmgr standby unregister -f /etc/repmgr.conf --node-id=3</programlisting>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Options</title>
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><option>--node-id</option></term>
|
|
<listitem>
|
|
<para>
|
|
<varname>node_id</varname> of the node to unregister (optional)
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</refsect1>
|
|
|
|
<refsect1 id="repmgr-standby-unregister-events">
|
|
<title>Event notifications</title>
|
|
<para>
|
|
A <literal>standby_unregister</literal> <link linkend="event-notifications">event notification</link> will be generated.
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|
|
|