github/repmgr
1
0
Fork 0
mirror of https://github.com/EnterpriseDB/repmgr.git synced 2026-03-24 23:56:29 +00:00
Code Issues Packages Projects Releases 1 Wiki Activity

docs: reformat additonal config file upgrade notes into a new section

Browse Source 
It's easier to link to the information that way.
This commit is contained in:
Ian Barwick
2020-08-06 09:43:40 +09:00
parent cd81046c26
commit aed0045c3a
1 changed files with 51 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

71
doc/configuration-file.xml
View File

@@ -210,30 +210,61 @@ conninfo='host=node1 user=repmgr dbname=repmgr connect_timeout=2'</programlistin
<filename>/path/to/repmgr.conf</filename>). <filename>/path/to/repmgr.conf</filename>).
</para> </para>
</note> </note>
</sect2>
<note> <sect2 id="configuration-file-postgresql-major-upgrades" xreflabel="configuration file and PostgreSQL major version upgrades">
<para> <title>Configuration file and PostgreSQL major version upgrades</title>
When upgrading the PostgreSQL cluster to a new major version, updating the &repmgr; configuration file
may be needed. In particular, if default package locations for <option>pg_bindir</option> and <indexterm>
<option>data_directory</option> are used, both these options in <filename>repmgr.conf</filename> <primary>repmgr.conf</primary>
will need to be updated accordingly. <secondary>ostgreSQL major version upgrades</secondary>
</para> </indexterm>
</note>
<para>
When upgrading the PostgreSQL cluster to a new major version, <filename>repmgr.conf</filename>
will probably needed to be updated.
</para>
<para>
Usually <option>pg_bindir</option> and <option>data_directory</option> will need to be modified,
particularly if the default package locations are used, as these usually change.
</para>
<note>
<para> <para>
If the location of the configuration file changed after a PostgreSQL major upgrade, the It's also possible the location of <filename>repmgr.conf</filename> itself will change
<option>config_file</option> field from the <structname>repmgr.nodes</structname> table will (e.g. from <filename>/etc/repmgr/11/repmgr.conf</filename> to <filename>/etc/repmgr/12/repmgr.conf</filename>).
need to reflect this change. This can be accomplished by forcing all nodes to register This is stored as part of the &repmgr; metadata and is used by &repmgr; to execute &repmgr; remotely
again with the new configuration file. This will effectively update the <option>config_file</option> (e.g. during a <link linkend="performing-switchover">switchover operation</link>).
field in <structname>repmgr.nodes</structname>. To accomplished this, just </para>
execute <link linkend="repmgr-primary-register"> <para>
<command>repmgr primary register --force -f /path/to/repmgr.conf</command></link> If the content and/or location of <filename>repmgr.conf</filename> has changed, the &repmgr; metadata
on the primary node, and then <link linkend="repmgr-standby-register"> needs to be updated to reflect this. The &repmgr; metadata can be updated on each node with:
<command>repmgr standby register --force -f /path/to/repmgr.conf</command></link> <itemizedlist spacing="compact" mark="bullet">
on all the standby nodes (don't forget the witness, if there is one). <listitem>
<simpara>
<link linkend="repmgr-primary-register">
<command>repmgr primary register --force -f /path/to/repmgr.conf</command>
</link>
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="repmgr-standby-register">
<command>repmgr standby register --force -f /path/to/repmgr.conf</command>
</link>
</simpara>
</listitem>
<listitem>
<simpara>
<link linkend="repmgr-witness-register">
<command>repmgr witness register --force -f /path/to/repmgr.conf -h primary_host</command>
</link>
</simpara>
</listitem>
</itemizedlist>
</para> </para>
</note>
</sect2> </sect2>
</sect1> </sect1>