From 0970789b1d4e2079e62a63a28f4f4fdb3b697f5e Mon Sep 17 00:00:00 2001 From: Ian Barwick Date: Wed, 23 Jan 2019 12:55:06 +0900 Subject: [PATCH] doc: improve package install instructions Including: - additional clarification for Pg 9.x RPM package names - consistent usage of sudo --- doc/install-packages.sgml | 124 ++++++++++++++++++++++---------------- 1 file changed, 73 insertions(+), 51 deletions(-) diff --git a/doc/install-packages.sgml b/doc/install-packages.sgml index 05dd76b2..c9cdbd3b 100644 --- a/doc/install-packages.sgml +++ b/doc/install-packages.sgml @@ -29,9 +29,10 @@ - &repmgr; packages are designed to be compatible with the community-provided PostgreSQL packages. + &repmgr; RPM packages are designed to be compatible with the community-provided PostgreSQL packages + and 2ndQuadrant's 2ndQPostgres. 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. + customers, as the PostgreSQL filesystem layout may be different to the community RPMs. Please contact your support vendor for assistance. @@ -47,54 +48,76 @@ 2ndQuadrant public RPM yum repository - Beginning with repmgr 4.0.5, 2ndQuadrant provides a dedicated yum - public 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. - + public 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 - - - Locate the repository RPM for your PostgreSQL version from the list at: - https://dl.2ndquadrant.com/ - - + + + Locate the repository RPM for your PostgreSQL version from the list at: + https://dl.2ndquadrant.com/ + + Install the repository definition 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: - + (this enables the 2ndQuadrant repository as a source of &repmgr; packages). + + + For example, for PostgreSQL 10 on CentOS, execute: + curl https://dl.2ndquadrant.com/default/release/get/10/rpm | sudo bash - - - Verify that the repository is installed with: - + + + + For PostgreSQL 9.6 on CentOS, execute: + +curl https://dl.2ndquadrant.com/default/release/get/9.6/rpm | sudo bash + + + + + Verify that the repository is installed with: + sudo yum repolist - The output should contain two entries like this: - + The output should contain two entries like this: + 2ndquadrant-dl-default-release-pg10/7/x86_64 2ndQuadrant packages (PG10) for 7 - x86_64 4 2ndquadrant-dl-default-release-pg10-debug/7/x86_64 2ndQuadrant packages (PG10) for 7 - x86_64 - Debug 3 - - + + Install the &repmgr version appropriate for your PostgreSQL version (e.g. repmgr10): -$ yum install repmgr10 +sudo yum install repmgr10 + + + For packages for PostgreSQL 9.6 and earlier, the package name does not contain + a period between major and minor version numbers, e.g. + repmgr96. + + + + + To determine the names of available packages, execute: + +yum search repmgr + + + @@ -163,16 +186,15 @@ $ yum install repmgr10 2ndQuadrant public apt repository for Debian/Ubuntu - Beginning with repmgr 4.0.5, 2ndQuadrant provides a - public apt repository for 2ndQuadrant software, - including &repmgr;. - - - General instructions for using this repository can be found on its - homepage. Specific instructions - for installing &repmgr; follow below. - + public apt repository for 2ndQuadrant software, + including &repmgr;. + + + General instructions for using this repository can be found on its + homepage. Specific instructions + for installing &repmgr; follow below. + @@ -180,13 +202,13 @@ $ yum install repmgr10 - - + + Install the repository definition for your distribution and PostgreSQL version - (this enables the 2ndQuadrant repository as a source of &repmgr; packages) by executing: + (this enables the 2ndQuadrant repository as a source of &repmgr; packages) by executing: curl https://dl.2ndquadrant.com/default/release/get/deb | sudo bash - + This will automatically install the following additional packages, if not already present: @@ -203,12 +225,12 @@ curl https://dl.2ndquadrant.com/default/release/get/deb | sudo bash - - + + Install the &repmgr version appropriate for your PostgreSQL version (e.g. repmgr10): -$ apt-get install postgresql-10-repmgr - +sudo apt-get install postgresql-10-repmgr + For packages for PostgreSQL 9.6 and earlier, the package name includes @@ -216,11 +238,11 @@ $ apt-get install postgresql-10-repmgr postgresql-9.6-repmgr. - + - + - +