1
0
mirror of https://github.com/pgbackrest/pgbackrest.git synced 2026-06-20 01:17:49 +02:00

Remove explicit max_wal_senders/wal_level configuration from user guide.

Since PostgreSQL 10 these settings have been defaulted to values required by the user guide so there is no need to explicitly set them.

PostgreSQL 9.5/9.6 are still supported by pgBackRest but are not represented in the user guide since they are EOL.
This commit is contained in:
David Steele
2025-11-19 10:40:02 +02:00
parent d83019924b
commit bce97d3ea8
3 changed files with 21 additions and 11 deletions
+15
View File
@@ -26,4 +26,19 @@
</release-item>
</release-improvement-list>
</release-core-list>
<release-doc-list>
<release-improvement-list>
<release-item>
<github-issue id="2699"/>
<release-item-contributor-list>
<release-item-ideator id="jamie.nguyen"/>
<release-item-contributor id="david.steele"/>
</release-item-contributor-list>
<p>Remove explicit <setting>max_wal_senders</setting>/<setting>wal_level</setting> configuration from user guide.</p>
</release-item>
</release-improvement-list>
</release-doc-list>
</release>
+5
View File
@@ -522,6 +522,11 @@
<contributor-id type="github">jamessewell</contributor-id>
</contributor>
<contributor id="jamie.nguyen">
<contributor-name-display>Jamie Nguyen</contributor-name-display>
<contributor-id type="github">jamielinux</contributor-id>
</contributor>
<contributor id="jan.wieck">
<contributor-name-display>Jan Wieck</contributor-name-display>
<contributor-id type="github">wieck</contributor-id>
+1 -11
View File
@@ -1276,19 +1276,15 @@
<section id="configure-archiving">
<title>Configure Archiving</title>
<p>Backing up a running <postgres/> cluster requires WAL archiving to be enabled. Note that <i>at least</i> one WAL segment will be created during the backup process even if no explicit writes are made to the cluster.</p>
<p>Backing up a running <postgres/> cluster requires WAL archiving to be enabled. <id>%p</id> is how <postgres/> specifies the location of the WAL segment to be archived. Note that <i>at least</i> one WAL segment will be created during the backup process even if no explicit writes are made to the cluster.</p>
<postgres-config host="{[host-pg1]}" file="{[postgres-config-demo]}">
<title>Configure archive settings</title>
<postgres-config-option key="archive_command">'{[project-exe]} {[dash]}-stanza={[postgres-cluster-demo]} archive-push %p'</postgres-config-option>
<postgres-config-option key="archive_mode">on</postgres-config-option>
<postgres-config-option key="wal_level">replica</postgres-config-option>
<postgres-config-option key="max_wal_senders">3</postgres-config-option>
</postgres-config>
<p><id>%p</id> is how <postgres/> specifies the location of the WAL segment to be archived. Setting <pg-option>wal_level</pg-option> to at least <pg-setting>replica</pg-setting> and increasing <pg-option>max_wal_senders</pg-option> is a good idea even if there are currently no replicas as this will allow them to be added later without restarting the primary cluster.</p>
<p>The <postgres/> cluster must be restarted after making these changes and before performing a backup.</p>
<execute-list host="{[host-pg1]}">
@@ -3263,8 +3259,6 @@
<postgres-config-option key="hot_standby">on</postgres-config-option>
<postgres-config-option key="archive_command">'{[project-exe]} {[dash]}-stanza={[postgres-cluster-demo]} archive-push %p'</postgres-config-option>
<postgres-config-option key="archive_mode">on</postgres-config-option>
<postgres-config-option key="wal_level">replica</postgres-config-option>
<postgres-config-option key="max_wal_senders">3</postgres-config-option>
<postgres-config-option if="{[os-type-is-rhel]}" key="log_filename">'postgresql.log'</postgres-config-option>
</postgres-config>
@@ -3622,8 +3616,6 @@
<postgres-config-option key="archive_command">'{[project-exe]} {[dash]}-stanza=demo-alt archive-push %p'</postgres-config-option>
<postgres-config-option key="archive_mode">on</postgres-config-option>
<postgres-config-option key="wal_level">replica</postgres-config-option>
<postgres-config-option key="max_wal_senders">3</postgres-config-option>
<postgres-config-option if="{[os-type-is-rhel]}" key="log_filename">'postgresql.log'</postgres-config-option>
</postgres-config>
@@ -4261,8 +4253,6 @@
<postgres-config-option key="archive_command">'{[project-exe]} {[dash]}-stanza={[postgres-cluster-demo]} archive-push %p'</postgres-config-option>
<postgres-config-option key="archive_mode">on</postgres-config-option>
<postgres-config-option key="wal_level">replica</postgres-config-option>
<postgres-config-option key="max_wal_senders">3</postgres-config-option>
<postgres-config-option if="{[os-type-is-rhel]}" key="log_filename">'postgresql.log'</postgres-config-option>
</postgres-config>