aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorAlvaro Herrera <alvherre@alvh.no-ip.org>2019-09-27 16:40:01 -0300
committerAlvaro Herrera <alvherre@alvh.no-ip.org>2019-09-27 16:40:01 -0300
commit5adafaf176d09ba5ea11ae128416fc5211469bc0 (patch)
tree52edf9e0971547c6b382691d8f09d3168dd607ff /doc/src
parentc967e13f4047ef6f3d91bcb1cff6d746322aff6d (diff)
downloadpostgresql-5adafaf176d09ba5ea11ae128416fc5211469bc0.tar.gz
postgresql-5adafaf176d09ba5ea11ae128416fc5211469bc0.zip
Have pg_rewind run crash recovery before rewinding
If we don't do this, the rewind fails if the server wasn't cleanly shut down, which seems unhelpful serving no purpose. Also provide a new option --no-ensure-shutdown to suppress this behavior, for alleged advanced usage that prefers to avoid the crash recovery. Authors: Paul Guo, Jimmy Yih, Ashwin Agrawal Reviewed-by: Álvaro Herrera Discussion: https://postgr.es/m/CAEET0ZEffUkXc48pg2iqARQgGRYDiiVxDu+yYek_bTwJF+q=Uw@mail.gmail.com
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/ref/pg_rewind.sgml15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/src/sgml/ref/pg_rewind.sgml b/doc/src/sgml/ref/pg_rewind.sgml
index ac142d22fcd..a06e5ac5e11 100644
--- a/doc/src/sgml/ref/pg_rewind.sgml
+++ b/doc/src/sgml/ref/pg_rewind.sgml
@@ -166,6 +166,21 @@ PostgreSQL documentation
</varlistentry>
<varlistentry>
+ <term><option>--no-ensure-shutdown</option></term>
+ <listitem>
+ <para>
+ <application>pg_rewind</application> verifies that the target server
+ is cleanly shutdown before rewinding; by default, if it isn't, it
+ starts the server in single-user mode to complete crash recovery.
+ By passing this option, <application>pg_rewind</application> skips
+ this and errors out immediately if the server is not cleanly shut
+ down. Users are expected to handle the situation themselves in that
+ case.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-n</option></term>
<term><option>--dry-run</option></term>
<listitem>