diff --git a/doc/appendix-packages.sgml b/doc/appendix-packages.sgml index 1b3192f7..234cd457 100644 --- a/doc/appendix-packages.sgml +++ b/doc/appendix-packages.sgml @@ -382,6 +382,63 @@ + + Snapshot packages + + snapshot packages + + + packages + snaphots + + + For testing new features and bug fixes, from time to time 2ndQuadrant provides + so-called "snapshot packages" via its public repository. These packages + are built from the &repmgr; source at a particular point in time, and are not formal + releases. + + + + We do not recommend installing these packages in a production environment + unless specifically advised. + + + + To install a snapshot package, it's necessary to install the 2ndQuadrant public snapshot repository, + following the instructions here: https://dl.2ndquadrant.com/default/release/site/ but replace release with snapshot + in the appropriate URL. + + + For example, to install the snapshot RPM repository for PostgreSQL 9.6, execute (as root): + +curl https://dl.2ndquadrant.com/default/snapshot/get/9.6/rpm | bash + + or as a normal user with root sudo access: + +curl https://dl.2ndquadrant.com/default/snapshot/get/9.6/rpm | sudo bash + + + Alternatively you can browse the repository here: + https://dl.2ndquadrant.com/default/snapshot/browse/. + + + Once the repository is installed, installing or updating &repmgr; will result in the latest snapshot + package being installed. + + + The package name will be formatted like this: + +repmgr96-4.1.1-0.0git320.g5113ab0.1.el7.x86_64.rpm + containg the snapshot build number (here: 320) and the hash + of the git commit it was built from (here: g5113ab0). + + + + Note that the next formal release (in the above example 4.1.1), once available, + will install in place of any snapshot builds. + + + Information for packagers @@ -390,7 +447,7 @@ information for packagers - We recommend patching the following parameters when + We recommend patching the following parameters when building the package as built-in default values for user convenience. These values can nevertheless be overridden by the user, if desired.