diff options
author | Peter Eisentraut <peter@eisentraut.org> | 2020-04-04 09:08:12 +0200 |
---|---|---|
committer | Peter Eisentraut <peter@eisentraut.org> | 2020-04-04 09:08:12 +0200 |
commit | 552fcebff04699103cefd2efa71fae1274893dbe (patch) | |
tree | 1ec040622722e56709a8f2bd08d66da4bd06f503 /doc/src | |
parent | df3b181499b40523bd6244a4e5eb554acb9020ce (diff) | |
download | postgresql-552fcebff04699103cefd2efa71fae1274893dbe.tar.gz postgresql-552fcebff04699103cefd2efa71fae1274893dbe.zip |
Revert "Improve handling of parameter differences in physical replication"
This reverts commit 246f136e76ecd26844840f2b2057e2c87ec9868d.
That patch wasn't quite complete enough.
Discussion: https://www.postgresql.org/message-id/flat/E1jIpJu-0007Ql-CL%40gemulon.postgresql.org
Diffstat (limited to 'doc/src')
-rw-r--r-- | doc/src/sgml/high-availability.sgml | 48 |
1 files changed, 12 insertions, 36 deletions
diff --git a/doc/src/sgml/high-availability.sgml b/doc/src/sgml/high-availability.sgml index b5d32bb720a..bb5d9962ed3 100644 --- a/doc/src/sgml/high-availability.sgml +++ b/doc/src/sgml/high-availability.sgml @@ -2148,14 +2148,18 @@ LOG: database system is ready to accept read only connections </para> <para> - The settings of some parameters determine the size of shared memory for - tracking transaction IDs, locks, and prepared transactions. These shared - memory structures should be no smaller on a standby than on the primary. - Otherwise, it could happen that the standby runs out of shared memory - during recovery. For example, if the primary uses a prepared transaction - but the standby did not allocate any shared memory for tracking prepared - transactions, then recovery will abort and cannot continue until the - standby's configuration is changed. The parameters affected are: + The setting of some parameters on the standby will need reconfiguration + if they have been changed on the primary. For these parameters, + the value on the standby must + be equal to or greater than the value on the primary. + Therefore, if you want to increase these values, you should do so on all + standby servers first, before applying the changes to the primary server. + Conversely, if you want to decrease these values, you should do so on the + primary server first, before applying the changes to all standby servers. + 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> @@ -2184,34 +2188,6 @@ LOG: database system is ready to accept read only connections </para> </listitem> </itemizedlist> - - The easiest way to ensure this does not become a problem is to have these - parameters set on the standbys to values equal to or greater than on the - primary. Therefore, if you want to increase these values, you should do - so on all standby servers first, before applying the changes to the - primary server. Conversely, if you want to decrease these values, you - should do so on the primary server first, before applying the changes to - all standby servers. The WAL tracks changes to these parameters on the - primary, and if a standby processes WAL that indicates that the current - value on the primary is higher than its own value, it will log a warning, for example: -<screen> -WARNING: insufficient setting for parameter max_connections -DETAIL: max_connections = 80 is a lower setting than on the master server (where its value was 100). -HINT: Change parameters and restart the server, or there may be resource exhaustion errors sooner or later. -</screen> - Recovery will continue but could abort at any time thereafter. (It could - also never end up failing if the activity on the primary does not actually - require the full extent of the allocated shared memory resources.) If - recovery reaches a point where it cannot continue due to lack of shared - memory, recovery will pause and another warning will be logged, for example: -<screen> -WARNING: recovery paused because of insufficient parameter settings -DETAIL: See earlier in the log about which settings are insufficient. -HINT: Recovery cannot continue unless the configuration is changed and the server restarted. -</screen> - This warning will repeated once a minute. At that point, the settings on - the standby need to be updated and the instance restarted before recovery - can continue. </para> <para> |