diff --git a/doc/appendix-packages.sgml b/doc/appendix-packages.sgml index d0a73757..d34c462d 100644 --- a/doc/appendix-packages.sgml +++ b/doc/appendix-packages.sgml @@ -47,12 +47,12 @@ - 2ndQuadrant repository + 2ndQuadrant public repository Repository URL: - http://packages.2ndquadrant.com/repmgr/ + https://rpm.2ndquadrant.com/ Repository documentation: diff --git a/doc/install-packages.sgml b/doc/install-packages.sgml index 886ea09f..07ca3f00 100644 --- a/doc/install-packages.sgml +++ b/doc/install-packages.sgml @@ -5,26 +5,27 @@ system. - + installation on Red Hat/CentOS/Fedora etc. - RedHat/Fedora/CentOS + RedHat/CentOS/Fedora - RPM packages for &repmgr; are available via Yum through + &repmgr; RPM packages for RedHat/CentOS variants and Fedora are available from the + 2ndQuadrant + public RPM repository; see following + section for details. + + + RPM packages for &repmgr; are also available via Yum through the PostgreSQL Global Development Group RPM repository (http://yum.postgresql.org/). Follow the instructions for your distribution (RedHat, CentOS, - Fedora, etc.) and architecture as detailed there. - - - 2ndQuadrant also provides its - own RPM packages which are made available - at the same time as each &repmgr; release, as it can take some days for - them to become available via the main PGDG repository. See following section for details: + 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. @@ -43,59 +44,68 @@ - 2ndQuadrant repmgr yum repository + 2ndQuadrant public RPM yum repository + + + + Beginning with repmgr 3.1.3, + 2ndQuadrant provided its own repository + at http://packages.2ndquadrant.com/repmgr/. + This repository will be deprecated in a future release as it is replaced by + the public RPM repository + documented below. + + + - Beginning with repmgr 3.1.3, + Beginning with repmgr 4.0.5, 2ndQuadrant provides a dedicated yum - repository for &repmgr; releases. This repository complements the main - PGDG community repository, - but enables repmgr users to access the latest &repmgr; packages before they are - available via the PGDG repository, which can take several days to be updated following - a fresh &repmgr; release. - + public RPM repository for 2ndQuadrant software, + including &repmgr;. We recommend using this for all future &repmgr; releases. + + + General instructions for using this repository can be found on its + homepage. Specific instructions + for installing &repmgr; follow below. + Installation - - - Import the repository public key (optional but recommended): - - rpm --import http://packages.2ndquadrant.com/repmgr/RPM-GPG-KEY-repmgr - - + + + Locate the repository RPM for your PostgreSQL version from the list at: + https://rpm.2ndquadrant.com/site/content/ + + - Install the repository RPM for your distribution (this enables the 2ndQuadrant - repository as a source of repmgr packages): - - - - Fedora: - http://packages.2ndquadrant.com/repmgr/yum-repo-rpms/repmgr-fedora-1.0-1.noarch.rpm - - - - - RHEL, CentOS etc: - http://packages.2ndquadrant.com/repmgr/yum-repo-rpms/repmgr-rhel-1.0-1.noarch.rpm - - - - - - e.g.: - - $ yum install http://packages.2ndquadrant.com/repmgr/yum-repo-rpms/repmgr-rhel-1.0-1.noarch.rpm - - + Install the repository RPM for your distribution and PostgreSQL version + (this enables the 2ndQuadrant repository as a source of &repmgr; packages). + + + For example, for PostgreSQL 10 on CentOS, execute: + +sudo yum install https://rpm.2ndquadrant.com/site/content/2ndquadrant-repo-10-1-1.el7.noarch.rpm + + + + Verify that the repository is installed with: + +sudo yum repolist + The output should contain two entries like this: + +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 + + - Install the repmgr version appropriate for your PostgreSQL version (e.g. repmgr96), e.g.: + Install the &repmgr version appropriate for your PostgreSQL version (e.g. repmgr10), e.g.: - $ yum install repmgr96 +$ yum install repmgr10 @@ -105,13 +115,13 @@ Compatibility with PGDG Repositories - The 2ndQuadrant &repmgr; yum repository uses exactly the same package definitions as the - main PGDG repository and is effectively a selective mirror for &repmgr; packages only. + The 2ndQuadrant &repmgr; yum repository packages use the same definitions and file system layout as the + main PGDG repository. - Normally yum should 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. + Normally yum 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. To ensure the 2ndQuadrant repository is always prioritised, install yum-plugin-priorities @@ -125,24 +135,19 @@ To install a specific package version, execute yum --showduplicates list for the package in question: - [root@localhost ~]# yum --showduplicates list repmgr96 + [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 - repmgr96.x86_64 3.2-1.el6 2ndquadrant-repmgr - repmgr96.x86_64 3.2.1-1.el6 2ndquadrant-repmgr - repmgr96.x86_64 3.3-1.el6 2ndquadrant-repmgr - repmgr96.x86_64 3.3.1-1.el6 2ndquadrant-repmgr - repmgr96.x86_64 3.3.2-1.el6 2ndquadrant-repmgr - repmgr96.x86_64 3.3.2-1.rhel6 pgdg96 - repmgr96.x86_64 4.0.0-1.el6 2ndquadrant-repmgr - repmgr96.x86_64 4.0.0-1.rhel6 pgdg96 + 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 then append the appropriate version number to the package name with a hyphen, e.g.: - [root@localhost ~]# yum install repmgr96-3.3.2-1.el6 + [root@localhost ~]# yum install repmgr10-4.0.3-1.rhel7