diff --git a/doc/cloning-standbys.sgml b/doc/cloning-standbys.sgml index a202686a..ab9dfe7b 100644 --- a/doc/cloning-standbys.sgml +++ b/doc/cloning-standbys.sgml @@ -352,10 +352,12 @@ provide additional parameters for pg_basebackup to customise the cloning process. + By default, pg_basebackup performs a checkpoint before beginning the backup process. However, a normal checkpoint may take some time to complete; - a fast checkpoint can be forced with the -c/--fast-checkpoint option. + a fast checkpoint can be forced with repmgr standby clone's + -c/--fast-checkpoint option. Note that this may impact performance of the server being cloned from (typically the primary) so should be used with care. @@ -370,6 +372,18 @@ Other options can be passed to pg_basebackup by including them in the repmgr.conf setting pg_basebackup_options. + + + Not that by default, &repmgr; executes pg_basebackup with + (PostgreSQL 9.6 and earlier: ) set to stream. + From PostgreSQL 9.6, if replication slots are in use, it will also create a replication slot before + running the base backup, and execute pg_basebackup with the + option set to the name of the previously created replication slot. + + + These parameters can set by the user in pg_basebackup_options, in which case they + will override the &repmgr; default values. However normally there's no reason to do this. + If using a separate directory to store WAL files, provide the option --waldir (--xlogdir in PostgreSQL 9.6 and earlier) with the absolute path to the