mirror of
https://github.com/EnterpriseDB/repmgr.git
synced 2026-03-23 07:06:30 +00:00
250 lines
9.2 KiB
Plaintext
250 lines
9.2 KiB
Plaintext
<sect1 id="installation-packages" xreflabel="Installing from packages">
|
|
<title>Installing &repmgr; from packages</title>
|
|
<para>
|
|
We recommend installing &repmgr; using the available packages for your
|
|
system.
|
|
</para>
|
|
|
|
<sect2 id="installation-packages-redhat" xreflabel="Installing from packages on RHEL, CentOS and Fedora">
|
|
|
|
<indexterm>
|
|
<primary>installation</primary>
|
|
<secondary>on Red Hat/CentOS/Fedora etc.</secondary>
|
|
</indexterm>
|
|
|
|
<title>RedHat/CentOS/Fedora</title>
|
|
<para>
|
|
&repmgr; RPM packages for RedHat/CentOS variants and Fedora are available from the
|
|
<ulink url="https://2ndquadrant.com">2ndQuadrant</ulink>
|
|
<ulink url="https://rpm.2ndquadrant.com/">public RPM repository</ulink>; see following
|
|
section for details.
|
|
</para>
|
|
<para>
|
|
RPM packages for &repmgr; are also available via Yum through
|
|
the PostgreSQL Global Development Group RPM repository
|
|
(<ulink url="https://yum.postgresql.org/">http://yum.postgresql.org/</ulink>).
|
|
Follow the instructions for your distribution (RedHat, CentOS,
|
|
Fedora, etc.) and architecture as detailed there. Note that it can take some days
|
|
for new &repmgr; packages to become available via the this repository.
|
|
</para>
|
|
<note>
|
|
<para>
|
|
&repmgr; packages are designed to be compatible with the community-provided PostgreSQL packages.
|
|
They may not work with vendor-specific packages such as those provided by RedHat for RHEL
|
|
customers, as the filesystem layout may be different to the community RPMs.
|
|
Please contact your support vendor for assistance.
|
|
</para>
|
|
</note>
|
|
|
|
<para>
|
|
For more information on the package contents, including details of installation
|
|
paths and relevant <link linkend="configuration-service-commands">service commands</link>,
|
|
see the appendix section <xref linkend="packages-centos">.
|
|
</para>
|
|
|
|
|
|
<sect3 id="installation-packages-redhat-2ndq">
|
|
<title>2ndQuadrant public RPM yum repository</title>
|
|
|
|
<note>
|
|
<para>
|
|
<ulink url="https://2ndquadrant.com">2ndQuadrant</ulink> previously provided a dedicated
|
|
&repmgr; repository at
|
|
<ulink url="http://packages.2ndquadrant.com/repmgr/">http://packages.2ndquadrant.com/repmgr/</ulink>.
|
|
This repository will be deprecated in a future release as it is now replaced by
|
|
the <ulink url="https://rpm.2ndquadrant.com/">public RPM repository</ulink>
|
|
documented below.
|
|
</para>
|
|
</note>
|
|
|
|
<para>
|
|
Beginning with <ulink url="https://repmgr.org/docs/4.0/release-4.0.5.html">repmgr 4.0.5</ulink>,
|
|
<ulink url="https://2ndquadrant.com/">2ndQuadrant</ulink> provides a dedicated <literal>yum</literal>
|
|
<ulink url="https://rpm.2ndquadrant.com/">public RPM repository</ulink> for 2ndQuadrant software,
|
|
including &repmgr;. We recommend using this for all future &repmgr; releases.
|
|
</para>
|
|
<para>
|
|
General instructions for using this repository can be found on its
|
|
<ulink url="https://rpm.2ndquadrant.com/">homepage</ulink>. Specific instructions
|
|
for installing &repmgr; follow below.
|
|
</para>
|
|
<para>
|
|
<emphasis>Installation</emphasis>
|
|
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
Locate the repository RPM for your PostgreSQL version from the list at:
|
|
<ulink url="https://rpm.2ndquadrant.com/">https://rpm.2ndquadrant.com/</ulink>
|
|
</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>
|
|
Install the repository RPM for your distribution and PostgreSQL version
|
|
(this enables the 2ndQuadrant repository as a source of &repmgr; packages).
|
|
</para>
|
|
<para>
|
|
For example, for PostgreSQL 10 on CentOS, execute:
|
|
<programlisting>
|
|
sudo yum install https://rpm.2ndquadrant.com/site/content/2ndquadrant-repo-10-1-1.el7.noarch.rpm
|
|
</programlisting>
|
|
</para>
|
|
<para>
|
|
Verify that the repository is installed with:
|
|
<programlisting>
|
|
sudo yum repolist</programlisting>
|
|
The output should contain two entries like this:
|
|
<programlisting>
|
|
2ndquadrant-repo-10/7/x86_64 2ndQuadrant packages for PG10 for rhel 7 - x86_64 1
|
|
2ndquadrant-repo-10-debug/7/x86_64 2ndQuadrant packages for PG10 for rhel 7 - x86_64 - Debug 1</programlisting>
|
|
</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>
|
|
Install the &repmgr version appropriate for your PostgreSQL version (e.g. <literal>repmgr10</literal>):
|
|
<programlisting>
|
|
$ yum install repmgr10</programlisting>
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
|
|
<para>
|
|
<emphasis>Compatibility with PGDG Repositories</emphasis>
|
|
</para>
|
|
<para>
|
|
The 2ndQuadrant &repmgr; yum repository packages use the same definitions and file system layout as the
|
|
main PGDG repository.
|
|
</para>
|
|
<para>
|
|
Normally <application>yum</application> will prioritize the repository with the most recent &repmgr; version.
|
|
Once the PGDG repository has been updated, it doesn't matter which repository
|
|
the packages are installed from.
|
|
</para>
|
|
<para>
|
|
To ensure the 2ndQuadrant repository is always prioritised, install <literal>yum-plugin-priorities</literal>
|
|
and set the repository priorities accordingly.
|
|
</para>
|
|
|
|
<para>
|
|
<emphasis>Installing a specific package version</emphasis>
|
|
</para>
|
|
<para>
|
|
To install a specific package version, execute <command>yum --showduplicates list</command>
|
|
for the package in question:
|
|
<programlisting>
|
|
[root@localhost ~]# yum --showduplicates list repmgr10
|
|
Loaded plugins: fastestmirror
|
|
Loading mirror speeds from cached hostfile
|
|
* base: ftp.iij.ad.jp
|
|
* extras: ftp.iij.ad.jp
|
|
* updates: ftp.iij.ad.jp
|
|
Available Packages
|
|
repmgr10.x86_64 4.0.3-1.rhel7 pgdg10
|
|
repmgr10.x86_64 4.0.4-1.rhel7 pgdg10
|
|
repmgr10.x86_64 4.0.5-1.el7 2ndquadrant-repo-10</programlisting>
|
|
then append the appropriate version number to the package name with a hyphen, e.g.:
|
|
<programlisting>
|
|
[root@localhost ~]# yum install repmgr10-4.0.3-1.rhel7</programlisting>
|
|
</para>
|
|
</sect3>
|
|
</sect2>
|
|
|
|
<sect2 id="installation-packages-debian" xreflabel="Installing from packages on Debian or Ubuntu">
|
|
|
|
<indexterm>
|
|
<primary>installation</primary>
|
|
<secondary>on Debian/Ubuntu etc.</secondary>
|
|
</indexterm>
|
|
|
|
<title>Debian/Ubuntu</title>
|
|
<para>.deb packages for &repmgr; are available from the
|
|
PostgreSQL Community APT repository (<ulink url="http://apt.postgresql.org/">http://apt.postgresql.org/</ulink>).
|
|
Instructions can be found in the APT section of the PostgreSQL Wiki
|
|
(<ulink url="https://wiki.postgresql.org/wiki/Apt">https://wiki.postgresql.org/wiki/Apt</ulink>).
|
|
</para>
|
|
<para>
|
|
For more information on the package contents, including details of installation
|
|
paths and relevant <link linkend="configuration-service-commands">service commands</link>,
|
|
see the appendix section <xref linkend="packages-debian-ubuntu">.
|
|
</para>
|
|
|
|
<sect3 id="installation-packages-debian-ubuntu-2ndq">
|
|
<title>2ndQuadrant public apt repository for Debian/Ubuntu</title>
|
|
|
|
<para>
|
|
Beginning with <ulink url="https://repmgr.org/docs/4.0/release-4.0.5.html">repmgr 4.0.5</ulink>,
|
|
<ulink url="https://2ndquadrant.com/">2ndQuadrant</ulink> provides a
|
|
<ulink url="https://apt.2ndquadrant.com/">public apt repository</ulink> for 2ndQuadrant software,
|
|
including &repmgr;.
|
|
</para>
|
|
<para>
|
|
General instructions for using this repository can be found on its
|
|
<ulink url="https://apt.2ndquadrant.com/">homepage</ulink>. Specific instructions
|
|
for installing &repmgr; follow below.
|
|
</para>
|
|
|
|
<para>
|
|
<emphasis>Installation</emphasis>
|
|
|
|
<itemizedlist>
|
|
|
|
<listitem>
|
|
<para>
|
|
If not already present, install the <application>apt-transport-https</application> package:
|
|
<programlisting>
|
|
sudo apt-get install apt-transport-https</programlisting>
|
|
</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>
|
|
Create <filename>/etc/apt/sources.list.d/2ndquadrant.list</filename> as follows:
|
|
<programlisting>
|
|
sudo sh -c 'echo "deb https://apt.2ndquadrant.com/ $(lsb_release -cs)-2ndquadrant main" > /etc/apt/sources.list.d/2ndquadrant.list'</programlisting>
|
|
</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>
|
|
Install the 2ndQuadrant <ulink url="https://apt.2ndquadrant.com/site/keys/9904CD4BD6BAF0C3.asc">repository key</ulink>:
|
|
<programlisting>
|
|
sudo apt-get install curl ca-certificates
|
|
curl https://apt.2ndquadrant.com/site/keys/9904CD4BD6BAF0C3.asc | sudo apt-key add -</programlisting>
|
|
</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>
|
|
Update the package list
|
|
<programlisting>
|
|
sudo apt-get update</programlisting>
|
|
</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>
|
|
Install the &repmgr version appropriate for your PostgreSQL version (e.g. <literal>repmgr10</literal>):
|
|
<programlisting>
|
|
$ apt-get install postgresql-10-repmgr</programlisting>
|
|
</para>
|
|
<note>
|
|
<para>
|
|
For packages for PostgreSQL 9.6 and earlier, the package name includes
|
|
a period between major and minor version numbers, e.g.
|
|
<literal>postgresql-9.6-repmgr</literal>.
|
|
</para>
|
|
</note>
|
|
</listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
</para>
|
|
|
|
</sect3>
|
|
</sect2>
|
|
|
|
</sect1>
|