From a2ff1536ad0b6ac18e20a46c86b2596b62f5c498 Mon Sep 17 00:00:00 2001 From: Ian Barwick Date: Tue, 1 May 2018 11:08:59 +0900 Subject: [PATCH] doc: add notes about package compatibility We need to emphasise that the repmgr packages are only compatible with packages based on the PGDG filesystem layout; 3rd party vendor packages often put application and data directories elsewhere. See e.g. GitHub #427. --- doc/appendix-faq.sgml | 17 ++++++++++++++++- doc/appendix-packages.sgml | 17 +++++++++++------ doc/install-packages.sgml | 9 +++++++++ 3 files changed, 36 insertions(+), 7 deletions(-) diff --git a/doc/appendix-faq.sgml b/doc/appendix-faq.sgml index e31570d1..d5fe882e 100644 --- a/doc/appendix-faq.sgml +++ b/doc/appendix-faq.sgml @@ -87,12 +87,27 @@ To minimize downtime during major upgrades, for more recent PostgreSQL - versions pglogical + versions (PostgreSQL 9.4 and later), + pglogical can be used to set up a parallel cluster using the newer PostgreSQL version, which can be kept in sync with the existing production cluster until the new cluster is ready to be put into production. + + + What does this error mean: <literal>ERROR: could not access file "$libdir/repmgr"</literal>? + + It means the &repmgr; extension code is not installed in the + PostgreSQL application directory. This typically happens when using PostgreSQL + packages provided by a third-party vendor, which often have different + filesystem layouts. + + + Either use PostgreSQL packages provided by the community or 2ndQuadrant; if this + is not possible, contact your vendor for assistance. + + diff --git a/doc/appendix-packages.sgml b/doc/appendix-packages.sgml index f8f1bc13..d0a73757 100644 --- a/doc/appendix-packages.sgml +++ b/doc/appendix-packages.sgml @@ -20,18 +20,23 @@ Currently, &repmgr; RPM packages are provided for versions 6.x and 7.x of CentOS. These should also work on matching versions of Red Hat Enterprise Linux, Scientific Linux and Oracle Enterprise Linux; together with CentOS, these are the same RedHat-based distributions for which the main community project - provides packages (see the PostgreSQL RPM Building Project + (PGDG) provides packages (see the PostgreSQL RPM Building Project page for details). - - It appears Red Hat provides enterprise users with PostgreSQL RPMs with a different - filesystem layout to the community RPMs, in which case the 2ndQuadrant &repmgr; RPM packages - may not be compatible. Please contact your support vendor for assistance. - + Note these &repmgr; RPM packages are not designed to work with SuSE/OpenSuSE. + + + &repmgr; packages are designed to be compatible with 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. + + + CentOS repositories diff --git a/doc/install-packages.sgml b/doc/install-packages.sgml index 7e10ac58..886ea09f 100644 --- a/doc/install-packages.sgml +++ b/doc/install-packages.sgml @@ -26,6 +26,15 @@ 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: + + + &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. + + + For more information on the package contents, including details of installation paths and relevant service commands,