diff --git a/doc/appendix-packages.sgml b/doc/appendix-packages.sgml index c61d0b4c..f8f1bc13 100644 --- a/doc/appendix-packages.sgml +++ b/doc/appendix-packages.sgml @@ -229,7 +229,7 @@ Debian/Ubuntu Packages packages - 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. + Debian 9.x packages @@ -315,8 +319,14 @@ - repmgrd service command: + PostgreSQL service command: systemctl [start|stop|restart|reload] postgresql@10-main + + + + + repmgrd service command: + systemctl [start|stop|restart|reload] repmgrd @@ -332,6 +342,19 @@
+ + + 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.conf service 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