docs: adjustments for streaming standbys that disconnect frequently
authorBruce Momjian
Thu, 17 Apr 2014 14:52:32 +0000 (10:52 -0400)
committerBruce Momjian
Thu, 17 Apr 2014 14:52:48 +0000 (10:52 -0400)
Document problems when disconnection causes loss of hot_standby_feedback
and suggest adjusting max_standby_archive_delay and
max_standby_streaming_delay.

Initial patch by Marko Tiikkaja, adjustments by me

doc/src/sgml/high-availability.sgml

index ecb51c4b1a224a141bec49f045e7e0bded11f204..39d7467ddd10a9b0dd7eadd0fda6186ee3b6b239 100644 (file)
@@ -1889,9 +1889,14 @@ if (!triggered)
     situation will be no worse than if the standby queries were running
     directly on the primary server, and you are still getting the benefit of
     off-loading execution onto the standby.
-    max_standby_archive_delay must be kept large in this case,
-    because delayed WAL files might already contain entries that conflict with
-    the desired standby queries.
+    If standby servers connect and disconnect frequently, you
+    might want to make adjustments to handle the period when
+    hot_standby_feedback feedback is not being provided.
+    For example, consider increasing max_standby_archive_delay
+    so that queries are not rapidly cancelled by conflicts in WAL archive
+    files during disconnected periods.  You should also consider increasing
+    max_standby_streaming_delay to avoid rapid cancellations
+    by newly-arrived streaming WAL entries after reconnection.