The attached patch updates the hot-standby documentation (in the high
availability section) so it explicitly mentions that certain settings
need to be applied to servers in a particular order. For example, it
states that if you increase a certain setting (e.g. max_connections) you
need to do so on a primary first, before applying it to any secondaries.

Previously this was not explicitly mentioned and could lead to one
thinking they can just apply the setting to all servers in parallel,
resulting in standby servers refusing to start.

The exact phrasing currently used in the patch may be a bit rough, I'm
open to suggestions on how to best improve the writing.

The patch is based on the master branch and applies cleanly to it.

Yorick
diff --git a/doc/src/sgml/high-availability.sgml b/doc/src/sgml/high-availability.sgml
index 51359d6236..bbb0e1aab2 100644
*** a/doc/src/sgml/high-availability.sgml
--- b/doc/src/sgml/high-availability.sgml
***************
*** 2098,2104 **** LOG:  database system is ready to accept read only connections
      be equal to or greater than the value on the primary. If these parameters
      are not set high enough then the standby will refuse to start.
      Higher values can then be supplied and the server
!     restarted to begin recovery again.  These parameters are:
  
        <itemizedlist>
         <listitem>
--- 2098,2108 ----
      be equal to or greater than the value on the primary. If these parameters
      are not set high enough then the standby will refuse to start.
      Higher values can then be supplied and the server
!     restarted to begin recovery again. If you want to increase these values you
!     should do so on the primary first, before applying the changes to any
!     standby servers. If you instead want to decrease these values you should do
!     so on the standbys first, before applying the changes to the primary. These
!     parameters are:
  
        <itemizedlist>
         <listitem>
-- 
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers

Reply via email to