mirror of
https://github.com/EnterpriseDB/repmgr.git
synced 2026-03-23 15:16:29 +00:00
303 lines
8.8 KiB
XML
303 lines
8.8 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 PostgreSQL versions from 9.4. 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. 4.1.x and &repmgrversion;.x)
|
|
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>
|
|
</row>
|
|
</thead>
|
|
|
|
<tbody>
|
|
<row>
|
|
<entry>
|
|
&repmgr; 5.4
|
|
</entry>
|
|
<entry>
|
|
(dev)
|
|
</entry>
|
|
<entry>
|
|
<link linkend="release-current">&repmgrversion;</link> (&releasedate;)
|
|
</entry>
|
|
<entry>
|
|
9.4, 9.5, 9.6, 10, 11, 12, 13, 15
|
|
</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry>
|
|
&repmgr; 5.3
|
|
</entry>
|
|
<entry>
|
|
YES
|
|
</entry>
|
|
<entry>
|
|
<link linkend="release-current">&repmgrversion;</link> (&releasedate;)
|
|
</entry>
|
|
<entry>
|
|
9.4, 9.5, 9.6, 10, 11, 12, 13, 14
|
|
</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>
|
|
</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>
|
|
</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>
|
|
</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>
|
|
</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>
|
|
</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>
|
|
</row>
|
|
</tbody>
|
|
|
|
</tgroup>
|
|
</table>
|
|
|
|
<important>
|
|
<para>
|
|
The &repmgr; 2.x and 3.x series 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. 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>
|