Debian/Ubuntu Packagespackages
- Debian/Ubuntupackages
+ Debian/Ubuntu packages
&repmgr; .deb packages are provided via the
@@ -268,10 +268,14 @@
Debian/Ubuntu package details
- The two tables below list relevant information, paths, commands etc. for the &repmgr; packages on
- Debian 9.x ("Stretch") and Ubuntu 16.04 ("Xenial Xerus"). Substitute the appropriate PostgreSQL major
+ The table below lists relevant information, paths, commands etc. for the &repmgr; packages on
+ Debian 9.x ("Stretch"). Substitute the appropriate PostgreSQL major
version number for your installation.
+
+ See also for some specifics related
+ to configuring the repmgrd daemon.
+
+
+
+ Instead of using the systemd service command directly,
+ it's recommended to execute pg_ctlcluster (as root,
+ either directly or via sudo), e.g.:
+
+ pg_ctlcluster 10 main [start|stop|restart|reload]
+
+
+ For pre-systemd systems, pg_ctlcluster
+ can be executed directly by the postgres user.
+
+
diff --git a/doc/configuration-service-commands.sgml b/doc/configuration-service-commands.sgml
index 6e0dfa23..a2894974 100644
--- a/doc/configuration-service-commands.sgml
+++ b/doc/configuration-service-commands.sgml
@@ -3,6 +3,10 @@
repmgr.confservice command settings
+
+ service command settings
+ configuration in repmgr.conf
+ Service command settings
diff --git a/doc/install-packages.sgml b/doc/install-packages.sgml
index 314c4acd..7e10ac58 100644
--- a/doc/install-packages.sgml
+++ b/doc/install-packages.sgml
@@ -153,6 +153,12 @@
Instructions can be found in the APT section of the PostgreSQL Wiki
(https://wiki.postgresql.org/wiki/Apt).
+
+ For more information on the package contents, including details of installation
+ paths and relevant service commands,
+ see the appendix section .
+
+
diff --git a/doc/repmgrd-configuration.sgml b/doc/repmgrd-configuration.sgml
index 9623cd67..7f046d47 100644
--- a/doc/repmgrd-configuration.sgml
+++ b/doc/repmgrd-configuration.sgml
@@ -141,8 +141,93 @@
-
- repmgrd connection settings
+
+
+ repmgrd
+ starting and stopping
+
+ repmgrd daemon
+
+ If installed from a package, the repmgrd can be started
+ via the operating system's service command, e.g. in systemd
+ using systemctl.
+
+
+ See appendix for details of service commands
+ for different distributions.
+
+
+ repmgrd can be started manually like this:
+
+ repmgrd -f /etc/repmgr.conf --pid-file /tmp/repmgrd.pid --daemonize
+ and stopped with kill `cat /tmp/repmgrd.pid`. Adjust paths as appropriate.
+
+
+ To apply configuration file changes to a running repmgrd
+ daemon, execute the operating system's service reload command (for manually started
+ instances, execute kill -HUP `cat /tmp/repmgrd.pid`).
+ Note that only a subset of configuration file parameters can be changed on a
+ running repmgrd daemon.
+
+
+
+
+ repmgrd
+ Debian/Ubuntu and daemon configuration
+
+
+ Debian/Ubuntu
+ repmgrd daemon configuration
+
+
+ repmgrd daemon configuration on Debian/Ubuntu
+
+
+ If &repmgr; was installed from Debian/Ubuntu packages, additional configuration
+ is required before repmgrd is started as a daemon.
+
+
+ This is done via the file /etc/default/repmgrd, which by default
+ looks like this:
+
+# default settings for repmgrd. This file is source by /bin/sh from
+# /etc/init.d/repmgrd
+
+# disable repmgrd by default so it won't get started upon installation
+# valid values: yes/no
+REPMGRD_ENABLED=no
+
+# configuration file (required)
+#REPMGRD_CONF="/path/to/repmgr.conf"
+
+# additional options
+#REPMGRD_OPTS=""
+
+# user to run repmgrd as
+#REPMGRD_USER=postgres
+
+# repmgrd binary
+#REPMGRD_BIN=/usr/bin/repmgrd
+
+# pid file
+#REPMGRD_PIDFILE=/var/run/repmgrd.pid
+
+
+ Set REPMGRD_ENABLED to yes, and REPMGRD_CONF
+ to the repmgr.conf file you are using.
+
+
+ If using systemd, you may need to execute systemctl daemon-reload.
+ Also, if you attempted to start repmgrd using systemctl start repmgrd,
+ you'll need to execute systemctl stop repmgrd. Because that's how systemd
+ rolls.
+
+
+
+
+
+
+ repmgrd connection settings
In addition to the &repmgr; configuration settings, parameters in the
conninfo string influence how &repmgr; makes a network connection to