diff --git a/doc/appendix-faq.sgml b/doc/appendix-faq.sgml index 3d4c1a7a..c179bb73 100644 --- a/doc/appendix-faq.sgml +++ b/doc/appendix-faq.sgml @@ -333,5 +333,25 @@ + + + <application>repmgrd</application> aborts startup with the error "<literal>upstream node must be running before repmgrd can start</literal>" + + + repmgrd does this to avoid starting up on a replication cluster + which is not in a healthy state. If the upstream is unavailable, repmgrd + may initiate a failover immediately after starting up, which could have unintended side-effects, + particularly if repmgrd is not running on other nodes. + + + In particular, it's possible that the node's local copy of the repmgr.nodes copy + is out-of-date, which may lead to incorrect failover behaviour. + + + The onus is therefore on the adminstrator to manually set the cluster to a stable, healthy state before + starting repmgrd. + + +