mirror of
https://github.com/EnterpriseDB/repmgr.git
synced 2026-03-22 22:56:29 +00:00
e696e28f43
The same document states that "repmgr 5.5.0 is compatible with all supported PostgreSQL versions from 13.x", so 12 shouldn't be listed in the matrix. Moreover, 14 is missing in 5.5 and 5.4.1, which looks like an accidental omission that might have happened when support for 15 was added on a version that only advertized 13 up to that point. 14 should have been added along with 15 then.
347 lines
9.7 KiB
XML
347 lines
9.7 KiB
XML
<sect1 id="install-requirements" xreflabel="installation requirements">
|
|
|
|
<title>Requirements for installing repmgr</title>
|
|
|
|
<indexterm>
|
|
<primary>installation</primary>
|
|
<secondary>requirements</secondary>
|
|
</indexterm>
|
|
|
|
<para>
|
|
repmgr is developed and tested on Linux and OS X, but should work on any
|
|
UNIX-like system supported by PostgreSQL itself. There is no support for
|
|
Microsoft Windows.
|
|
</para>
|
|
|
|
<para>
|
|
&repmgr; &repmgrversion; is compatible with all supported PostgreSQL versions from 13.x. See
|
|
section <link linkend="install-compatibility-matrix">&repmgr; compatibility matrix</link>
|
|
for an overview of version compatibility.
|
|
</para>
|
|
|
|
<note>
|
|
<simpara>
|
|
If upgrading from &repmgr; 3.x, please see the section <xref linkend="upgrading-from-repmgr-3"/>.
|
|
</simpara>
|
|
</note>
|
|
|
|
<para>
|
|
All servers in the replication cluster must be running the same major version of
|
|
PostgreSQL, and we recommend that they also run the same minor version.
|
|
</para>
|
|
|
|
<para>
|
|
&repmgr; must be installed on each server in the replication cluster.
|
|
If installing repmgr from packages, the package version must match the PostgreSQL
|
|
version. If installing from source, &repmgr; must be compiled against the same
|
|
major version.
|
|
</para>
|
|
|
|
<note>
|
|
<simpara>
|
|
The same "major" &repmgr; version (e.g. <literal>&repmgrversion;.x</literal>) <emphasis>must</emphasis>
|
|
be installed on all node in the replication cluster. We strongly recommend keeping all
|
|
nodes on the same (preferably latest) "minor" &repmgr; version to minimize the risk
|
|
of incompatibilities.
|
|
</simpara>
|
|
<simpara>
|
|
If different "major" &repmgr; versions (e.g. 5.2.x and &repmgrversion;)
|
|
are installed on different nodes, in the best case &repmgr; (in particular &repmgrd;)
|
|
will not run. In the worst case, you will end up with a broken cluster.
|
|
</simpara>
|
|
</note>
|
|
|
|
<para>
|
|
A dedicated system user for &repmgr; is <emphasis>not</emphasis> required; as many &repmgr; and
|
|
&repmgrd; actions require direct access to the PostgreSQL data directory,
|
|
these commands should be executed by the <literal>postgres</literal> user.
|
|
</para>
|
|
|
|
<para>
|
|
See also <link linkend="configuration-prerequisites">Prerequisites for configuration</link>
|
|
for information on networking requirements.
|
|
</para>
|
|
|
|
<tip>
|
|
<simpara>
|
|
We recommend using a session multiplexer utility such as <command>screen</command> or
|
|
<command>tmux</command> when performing long-running actions (such as cloning a database)
|
|
on a remote server - this will ensure the &repmgr; action won't be prematurely
|
|
terminated if your <command>ssh</command> session to the server is interrupted or closed.
|
|
</simpara>
|
|
</tip>
|
|
|
|
<sect2 id="install-compatibility-matrix">
|
|
|
|
<title>&repmgr; compatibility matrix</title>
|
|
|
|
<indexterm>
|
|
<primary>repmgr</primary>
|
|
<secondary>compatibility matrix</secondary>
|
|
</indexterm>
|
|
|
|
<indexterm>
|
|
<primary>compatibility matrix</primary>
|
|
</indexterm>
|
|
|
|
<para>
|
|
The following table provides an overview of which &repmgr; version supports
|
|
which PostgreSQL version.
|
|
</para>
|
|
|
|
<table id="repmgr-compatibility-matrix">
|
|
<title>&repmgr; compatibility matrix</title>
|
|
|
|
<tgroup cols="4">
|
|
<thead>
|
|
<row>
|
|
<entry>
|
|
&repmgr; version
|
|
</entry>
|
|
<entry>
|
|
Supported?
|
|
</entry>
|
|
<entry>
|
|
Latest release
|
|
</entry>
|
|
<entry>
|
|
Supported PostgreSQL versions
|
|
</entry>
|
|
<entry>
|
|
Notes
|
|
</entry>
|
|
</row>
|
|
</thead>
|
|
|
|
<tbody>
|
|
<row>
|
|
<entry>
|
|
&repmgr; 5.5
|
|
</entry>
|
|
<entry>
|
|
Yes
|
|
</entry>
|
|
<entry>
|
|
<link linkend="release-5.5.0">&repmgrversion;</link> (&releasedate;)
|
|
</entry>
|
|
<entry>
|
|
13, 14, 15, 16, 17
|
|
</entry>
|
|
<entry>
|
|
|
|
</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry>
|
|
&repmgr; 5.4.1
|
|
</entry>
|
|
<entry>
|
|
Yes
|
|
</entry>
|
|
<entry>
|
|
<link linkend="release-5.4.1">5.4.1</link> (2023-04-04)
|
|
</entry>
|
|
<entry>
|
|
10, 11, 12, 13, 14, 15
|
|
</entry>
|
|
<entry>
|
|
|
|
</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry>
|
|
&repmgr; 5.3.1
|
|
</entry>
|
|
<entry>
|
|
Yes
|
|
</entry>
|
|
<entry>
|
|
<link linkend="release-5.3.1">5.3.1</link> (2022-02-15)
|
|
</entry>
|
|
<entry>
|
|
9.4, 9.5, 9.6, 10, 11, 12, 13, 14, 15
|
|
</entry>
|
|
<entry>
|
|
PostgreSQL 15 supported from &repmgr; 5.3.3
|
|
</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry>
|
|
&repmgr; 5.2
|
|
</entry>
|
|
<entry>
|
|
No
|
|
</entry>
|
|
<entry>
|
|
<link linkend="release-5.2.1">5.2.1</link> (2020-12-07)
|
|
</entry>
|
|
<entry>
|
|
9.4, 9.5, 9.6, 10, 11, 12, 13
|
|
</entry>
|
|
<entry>
|
|
|
|
</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry>
|
|
&repmgr; 5.1
|
|
</entry>
|
|
<entry>
|
|
No
|
|
</entry>
|
|
<entry>
|
|
<link linkend="release-5.1.0">5.1.0</link> (2020-04-13)
|
|
</entry>
|
|
<entry>
|
|
9.3, 9.4, 9.5, 9.6, 10, 11, 12
|
|
</entry>
|
|
<entry>
|
|
|
|
</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry>
|
|
&repmgr; 5.0
|
|
</entry>
|
|
<entry>
|
|
No
|
|
</entry>
|
|
<entry>
|
|
<link linkend="release-5.0">5.0</link> (2019-10-15)
|
|
</entry>
|
|
<entry>
|
|
9.3, 9.4, 9.5, 9.6, 10, 11, 12
|
|
</entry>
|
|
<entry>
|
|
|
|
</entry>
|
|
</row>
|
|
|
|
|
|
<row>
|
|
<entry>
|
|
&repmgr; 4.x
|
|
</entry>
|
|
<entry>
|
|
No
|
|
</entry>
|
|
<entry>
|
|
<link linkend="release-4.4">4.4</link> (2019-06-27)
|
|
</entry>
|
|
<entry>
|
|
9.3, 9.4, 9.5, 9.6, 10, 11
|
|
</entry>
|
|
<entry>
|
|
|
|
</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry>
|
|
&repmgr; 3.x
|
|
</entry>
|
|
<entry>
|
|
No
|
|
</entry>
|
|
<entry>
|
|
<ulink url="https://repmgr.org/release-notes-3.3.2.html">3.3.2</ulink> (2017-05-30)
|
|
</entry>
|
|
<entry>
|
|
9.3, 9.4, 9.5, 9.6
|
|
</entry>
|
|
<entry>
|
|
|
|
</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry>
|
|
&repmgr; 2.x
|
|
</entry>
|
|
<entry>
|
|
No
|
|
</entry>
|
|
<entry>
|
|
<ulink url="https://repmgr.org/release-notes-2.0.3.html">2.0.3</ulink> (2015-04-16)
|
|
</entry>
|
|
<entry>
|
|
9.0, 9.1, 9.2, 9.3, 9.4
|
|
</entry>
|
|
<entry>
|
|
|
|
</entry>
|
|
</row>
|
|
</tbody>
|
|
|
|
</tgroup>
|
|
</table>
|
|
|
|
<important>
|
|
<para>
|
|
The &repmgr; series older than 5.x are no longer maintained or supported.
|
|
We strongly recommend upgrading to the latest &repmgr; version.
|
|
</para>
|
|
<para>
|
|
Following the release of &repmgr; 5.0, there will be no further releases of
|
|
the &repmgr; 4.x series or older. Note that &repmgr; 5.x is an incremental development
|
|
of the 4.x series and &repmgr; 4.x users should upgrade to this as soon as possible.
|
|
</para>
|
|
</important>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="install-postgresql-93-94">
|
|
|
|
<title>PostgreSQL 9.4 support</title>
|
|
|
|
<indexterm>
|
|
<primary>PostgreSQL 9.4</primary>
|
|
<secondary>repmgr support</secondary>
|
|
</indexterm>
|
|
|
|
<para>
|
|
Note that some &repmgr; functionality is not available in PostgreSQL 9.4:
|
|
</para>
|
|
<itemizedlist spacing="compact" mark="bullet">
|
|
|
|
<listitem>
|
|
<para>
|
|
In PostgreSQL 9.4, <command>pg_rewind</command> is not part of the core
|
|
distribution. <command>pg_rewind</command> will need to be compiled separately to be able
|
|
to use any &repmgr; functionality which takes advantage of it.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<warning>
|
|
<para>
|
|
PostgreSQL 9.3 has reached the end of its community support period (final release was
|
|
<ulink url="https://www.postgresql.org/docs/9.3/release-9-3-25.html">9.3.25</ulink>
|
|
in November 2018) and will no longer be updated with security or bugfixes.
|
|
</para>
|
|
<para>
|
|
Beginning with &repmgr; 5.2, &repmgr; no longer supports PostgreSQL 9.3.
|
|
</para>
|
|
<para>
|
|
PostgreSQL 9.4 has reached the end of its community support period (final release was
|
|
<ulink url="https://www.postgresql.org/docs/9.4/release-9-4-26.html">9.4.26</ulink>
|
|
in February 2020) and will no longer be updated with security or bugfixes.
|
|
</para>
|
|
<para>
|
|
We recommend that users of these versions migrate to a supported PostgreSQL version
|
|
as soon as possible.
|
|
</para>
|
|
<para>
|
|
For further details, see the <ulink url="https://www.postgresql.org/support/versioning/">PostgreSQL Versioning Policy</ulink>.
|
|
</para>
|
|
</warning>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|