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: ERROR: could not access file "$libdir/repmgr"?
+
+ 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,