diff options
author | Michael Paquier <michael@paquier.xyz> | 2019-10-07 09:07:22 +0900 |
---|---|---|
committer | Michael Paquier <michael@paquier.xyz> | 2019-10-07 09:07:22 +0900 |
commit | caa078353ecd1f3b3681c0d4fa95ad4bb8c2308a (patch) | |
tree | 2d6d5de9a223506b254ffad68bcf04a49ca1ec10 /doc/src | |
parent | 732457b5d2521c6ccd6b3b096d7aba73fca2a38a (diff) | |
download | postgresql-caa078353ecd1f3b3681c0d4fa95ad4bb8c2308a.tar.gz postgresql-caa078353ecd1f3b3681c0d4fa95ad4bb8c2308a.zip |
Improve handling and coverage of --no-ensure-shutdown in pg_rewind
This includes a couple of changes around the new behavior of pg_rewind
which enforces recovery to happen once on a cluster not shut down
cleanly:
- Some comments and documentation improvements.
- Shutdown the cluster to rewind with immediate mode in all the tests,
this allows to check after the forced recovery behavior which is wanted
as new default.
- Use -F for the forced recovery step, so as postgres does not use
fsync. This was useless as a final sync is done once the tool is done.
Author: Michael Paquier
Reviewed-by: Alexey Kondratov
Discussion: https://postgr.es/m/20191004083721.GA1829@paquier.xyz
Diffstat (limited to 'doc/src')
-rw-r--r-- | doc/src/sgml/ref/pg_rewind.sgml | 10 |
1 files changed, 6 insertions, 4 deletions
diff --git a/doc/src/sgml/ref/pg_rewind.sgml b/doc/src/sgml/ref/pg_rewind.sgml index fbf454803b5..42d29edd4e9 100644 --- a/doc/src/sgml/ref/pg_rewind.sgml +++ b/doc/src/sgml/ref/pg_rewind.sgml @@ -169,12 +169,14 @@ PostgreSQL documentation <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. + <application>pg_rewind</application> requires that the target server + is cleanly shut down before rewinding. By default, if the target server + is not shut down cleanly, <application>pg_rewind</application> starts + the target server in single-user mode to complete crash recovery first, + and stops it. 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 + down. Users are expected to handle the situation themselves in that case. </para> </listitem> |