Fix some documentation in pg_rewind
authorMichael Paquier
Fri, 5 Apr 2019 01:38:21 +0000 (10:38 +0900)
committerMichael Paquier
Fri, 5 Apr 2019 01:38:21 +0000 (10:38 +0900)
commit064b3fcbdb198f04ee74e01dd48b3d75448b3c4c
tree7b2001d7bb6676fff3ced83092b48bc8d970f933
parent7dbc0759e0207436851ccc7098250a8110efe655
Fix some documentation in pg_rewind

Since 11, it is possible to use a non-superuser role when using an
online source cluster with pg_rewind as long as the role has proper
permissions to execute on the source all the functions used by
pg_rewind, and the documentation stated that a superuser is necessary.
Let's add at the same time all the details needed to create such a
role.

A second confusion which comes a lot from users is that it is necessary
to issue a checkpoint on a freshly-promoted standby so as its control
file has up-to-date timeline information which is used by pg_rewind to
validate the operation.  Let's document that properly.  This is
back-patched down to 9.5 where pg_rewind has been introduced.

Author: Michael Paquier
Reviewed-by: Magnus Hagander
Discussion: https://postgr.es/m/CABUevEz5bpvbwVsYCaSMV80CBZ5-82nkMzbb+Bu=h1m=rLdn=g@mail.gmail.com
Backpatch-through: 9.5
doc/src/sgml/ref/pg_rewind.sgml