Version set to 3.8.0

Signed-off-by: Didier Michel <[email protected]>
EnterpriseDB · Aug 31, 2023 · 5dac441 · 5dac441
1 parent d80c0d7
commit 5dac441
Show file tree

Hide file tree

Showing 28 changed files with 77 additions and 53 deletions.
diff --git a/barman/version.py b/barman/version.py
@@ -20,4 +20,4 @@
 This module contains the current Barman version.
 """
 
-__version__ = "3.7.0"
+__version__ = "3.8.0"
diff --git a/doc/barman-cloud-backup-delete.1 b/doc/barman-cloud-backup-delete.1
@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 2.2.1
 .\"
-.TH "BARMAN\-CLOUD\-BACKUP\-DELETE" "1" "July 25, 2023" "Barman User manuals" "Version 3.7.0"
+.TH "BARMAN\-CLOUD\-BACKUP\-DELETE" "1" "August 31, 2023" "Barman User manuals" "Version 3.8.0"
 .hy
 .SH NAME
 .PP
@@ -52,9 +52,10 @@ usage:\ barman\-cloud\-backup\-delete\ [\-V]\ [\-\-help]\ [\-v\ |\ \-q]\ [\-t]
 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ [\-\-endpoint\-url\ ENDPOINT_URL]
 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ [\-P\ AWS_PROFILE]\ [\-\-profile\ AWS_PROFILE]
 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ [\-\-read\-timeout\ READ_TIMEOUT]
-\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ [\-\-azure\-credential\ {azure\-cli,managed\-identity}]
-\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ (\-b\ BACKUP_ID\ |\ \-r\ RETENTION_POLICY)
-\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ [\-\-dry\-run]\ [\-\-batch\-size\ DELETE_BATCH_SIZE]
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ [\-\-azure\-credential\ {azure\-cli,managed\-identity}
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ [\-b\ BACKUP_ID]\ [\-m\ MINIMUM_REDUNDANCY]
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ [\-r\ RETENTION_POLICY]\ [\-\-dry\-run]
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ [\-\-batch\-size\ DELETE_BATCH_SIZE]
 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ source_url\ server_name
 
 This\ script\ can\ be\ used\ to\ delete\ backups\ made\ with\ barman\-cloud\-backup
@@ -76,6 +77,8 @@ optional\ arguments:
 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ The\ cloud\ provider\ to\ use\ as\ a\ storage\ backend
 \ \ \-b\ BACKUP_ID,\ \-\-backup\-id\ BACKUP_ID
 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ Backup\ ID\ of\ the\ backup\ to\ be\ deleted
+\ \ \-m\ MINIMUM_REDUNDANCY,\ \-\-minimum\-redundancy\ MINIMUM_REDUNDANCY
+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ The\ minimum\ number\ of\ backups\ that\ should\ always\ be\ available.
 \ \ \-r\ RETENTION_POLICY,\ \-\-retention\-policy\ RETENTION_POLICY
 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ If\ specified,\ delete\ all\ backups\ eligible\ for\ deletion
 \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ according\ to\ the\ supplied\ retention\ policy.\ Syntax:
@@ -119,25 +122,29 @@ Extra\ options\ for\ the\ azure\-blob\-storage\ cloud\ provider:
 .PP
 For Boto:
 .IP \[bu] 2
-https://boto3.amazonaws.com/v1/documentation/api/latest/guide/configuration.html
+<https://boto3.amazonaws.com/v1/documentation/api/latest/guide/configuration.html>
 .PP
 For AWS:
 .IP \[bu] 2
-https://docs.aws.amazon.com/cli/latest/userguide/cli\-chap\-getting\-set\-up.html
+<https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html>
 .IP \[bu] 2
-https://docs.aws.amazon.com/cli/latest/userguide/cli\-chap\-getting\-started.html.
+<https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html>.
 .PP
 For Azure Blob Storage:
 .IP \[bu] 2
-https://docs.microsoft.com/en\-us/azure/storage/blobs/authorize\-data\-operations\-cli#set\-environment\-variables\-for\-authorization\-parameters
+<https://docs.microsoft.com/en-us/azure/storage/blobs/authorize-data-operations-cli#set-environment-variables-for-authorization-parameters>
 .IP \[bu] 2
-https://docs.microsoft.com/en\-us/python/api/azure\-storage\-blob/?view=azure\-python
+<https://docs.microsoft.com/en-us/python/api/azure-storage-blob/?view=azure-python>
 .PP
-For Google Cloud Storage: * Credentials:
-https://cloud.google.com/docs/authentication/getting\-started#setting_the_environment_variable
+For Google Cloud Storage:
+.IP \[bu] 2
+Credentials:
+<https://cloud.google.com/docs/authentication/getting-started#setting_the_environment_variable>
+.RS 2
 .PP
 Only authentication with \f[C]GOOGLE_APPLICATION_CREDENTIALS\f[] env is
 supported at the moment.
+.RE
 .SH DEPENDENCIES
 .PP
 If using \f[C]\-\-cloud\-provider=aws\-s3\f[]:
@@ -150,7 +157,8 @@ azure\-storage\-blob
 .IP \[bu] 2
 azure\-identity (optional, if you wish to use DefaultAzureCredential)
 .PP
-If using \f[C]\-\-cloud\-provider=google\-cloud\-storage\f[] *
+If using \f[C]\-\-cloud\-provider=google\-cloud\-storage\f[]
+.IP \[bu] 2
 google\-cloud\-storage
 .SH EXIT STATUS
 .TP

diff --git a/doc/barman-cloud-backup-delete.1.md b/doc/barman-cloud-backup-delete.1.md
@@ -1,6 +1,6 @@
-% BARMAN-CLOUD-BACKUP-DELETE(1) Barman User manuals | Version 3.7.0
+% BARMAN-CLOUD-BACKUP-DELETE(1) Barman User manuals | Version 3.8.0
 % EnterpriseDB <https://www.enterprisedb.com>
-% July 25, 2023
+% August 31, 2023
 
 # NAME
 

diff --git a/doc/barman-cloud-backup-keep.1 b/doc/barman-cloud-backup-keep.1
@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 2.2.1
 .\"
-.TH "BARMAN\-CLOUD\-BACKUP\-DELETE" "1" "July 25, 2023" "Barman User manuals" "Version 3.7.0"
+.TH "BARMAN\-CLOUD\-BACKUP\-DELETE" "1" "August 31, 2023" "Barman User manuals" "Version 3.8.0"
 .hy
 .SH NAME
 .PP

diff --git a/doc/barman-cloud-backup-keep.1.md b/doc/barman-cloud-backup-keep.1.md
@@ -1,6 +1,6 @@
-% BARMAN-CLOUD-BACKUP-DELETE(1) Barman User manuals | Version 3.7.0
+% BARMAN-CLOUD-BACKUP-DELETE(1) Barman User manuals | Version 3.8.0
 % EnterpriseDB <https://www.enterprisedb.com>
-% July 25, 2023
+% August 31, 2023
 
 # NAME
 

diff --git a/doc/barman-cloud-backup-list.1 b/doc/barman-cloud-backup-list.1
@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 2.2.1
 .\"
-.TH "BARMAN\-CLOUD\-BACKUP\-LIST" "1" "July 25, 2023" "Barman User manuals" "Version 3.7.0"
+.TH "BARMAN\-CLOUD\-BACKUP\-LIST" "1" "August 31, 2023" "Barman User manuals" "Version 3.8.0"
 .hy
 .SH NAME
 .PP

diff --git a/doc/barman-cloud-backup-list.1.md b/doc/barman-cloud-backup-list.1.md
@@ -1,6 +1,6 @@
-% BARMAN-CLOUD-BACKUP-LIST(1) Barman User manuals | Version 3.7.0
+% BARMAN-CLOUD-BACKUP-LIST(1) Barman User manuals | Version 3.8.0
 % EnterpriseDB <https://www.enterprisedb.com>
-% July 25, 2023
+% August 31, 2023
 
 # NAME
 

diff --git a/doc/barman-cloud-backup-show.1 b/doc/barman-cloud-backup-show.1
@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 2.2.1
 .\"
-.TH "BARMAN\-CLOUD\-BACKUP\-SHOW" "1" "July 25, 2023" "Barman User manuals" "Version 3.7.0"
+.TH "BARMAN\-CLOUD\-BACKUP\-SHOW" "1" "August 31, 2023" "Barman User manuals" "Version 3.8.0"
 .hy
 .SH NAME
 .PP

diff --git a/doc/barman-cloud-backup-show.1.md b/doc/barman-cloud-backup-show.1.md
@@ -1,6 +1,6 @@
-% BARMAN-CLOUD-BACKUP-SHOW(1) Barman User manuals | Version 3.7.0
+% BARMAN-CLOUD-BACKUP-SHOW(1) Barman User manuals | Version 3.8.0
 % EnterpriseDB <https://www.enterprisedb.com>
-% July 25, 2023
+% August 31, 2023
 
 # NAME
 

diff --git a/doc/barman-cloud-backup.1 b/doc/barman-cloud-backup.1
@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 2.2.1
 .\"
-.TH "BARMAN\-CLOUD\-BACKUP" "1" "July 25, 2023" "Barman User manuals" "Version 3.7.0"
+.TH "BARMAN\-CLOUD\-BACKUP" "1" "August 31, 2023" "Barman User manuals" "Version 3.8.0"
 .hy
 .SH NAME
 .PP

diff --git a/doc/barman-cloud-backup.1.md b/doc/barman-cloud-backup.1.md
@@ -1,6 +1,6 @@
-% BARMAN-CLOUD-BACKUP(1) Barman User manuals | Version 3.7.0
+% BARMAN-CLOUD-BACKUP(1) Barman User manuals | Version 3.8.0
 % EnterpriseDB <https://www.enterprisedb.com>
-% July 25, 2023
+% August 31, 2023
 
 # NAME
 

diff --git a/doc/barman-cloud-check-wal-archive.1 b/doc/barman-cloud-check-wal-archive.1
@@ -1,7 +1,7 @@
 .\" Automatically generated by Pandoc 2.2.1
 .\"
-.TH "BARMAN\-CLOUD\-CHECK\-WAL\-ARCHIVE" "1" "July 25, 2023" "Barman User manuals" "Version
-3.7.0"
+.TH "BARMAN\-CLOUD\-CHECK\-WAL\-ARCHIVE" "1" "August 31, 2023" "Barman User manuals" "Version
+3.8.0"
 .hy
 .SH NAME
 .PP

diff --git a/doc/barman-cloud-check-wal-archive.1.md b/doc/barman-cloud-check-wal-archive.1.md
@@ -1,6 +1,6 @@
-% BARMAN-CLOUD-CHECK-WAL-ARCHIVE(1) Barman User manuals | Version 3.7.0
+% BARMAN-CLOUD-CHECK-WAL-ARCHIVE(1) Barman User manuals | Version 3.8.0
 % EnterpriseDB <https://www.enterprisedb.com>
-% July 25, 2023
+% August 31, 2023
 
 # NAME
 

diff --git a/doc/barman-cloud-restore.1 b/doc/barman-cloud-restore.1
@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 2.2.1
 .\"
-.TH "BARMAN\-CLOUD\-RESTORE" "1" "July 25, 2023" "Barman User manuals" "Version 3.7.0"
+.TH "BARMAN\-CLOUD\-RESTORE" "1" "August 31, 2023" "Barman User manuals" "Version 3.8.0"
 .hy
 .SH NAME
 .PP

diff --git a/doc/barman-cloud-restore.1.md b/doc/barman-cloud-restore.1.md
@@ -1,6 +1,6 @@
-% BARMAN-CLOUD-RESTORE(1) Barman User manuals | Version 3.7.0
+% BARMAN-CLOUD-RESTORE(1) Barman User manuals | Version 3.8.0
 % EnterpriseDB <https://www.enterprisedb.com>
-% July 25, 2023
+% August 31, 2023
 
 # NAME
 

diff --git a/doc/barman-cloud-wal-archive.1 b/doc/barman-cloud-wal-archive.1
@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 2.2.1
 .\"
-.TH "BARMAN\-CLOUD\-WAL\-ARCHIVE" "1" "July 25, 2023" "Barman User manuals" "Version 3.7.0"
+.TH "BARMAN\-CLOUD\-WAL\-ARCHIVE" "1" "August 31, 2023" "Barman User manuals" "Version 3.8.0"
 .hy
 .SH NAME
 .PP

diff --git a/doc/barman-cloud-wal-archive.1.md b/doc/barman-cloud-wal-archive.1.md
@@ -1,6 +1,6 @@
-% BARMAN-CLOUD-WAL-ARCHIVE(1) Barman User manuals | Version 3.7.0
+% BARMAN-CLOUD-WAL-ARCHIVE(1) Barman User manuals | Version 3.8.0
 % EnterpriseDB <https://www.enterprisedb.com>
-% July 25, 2023
+% August 31, 2023
 
 # NAME
 

diff --git a/doc/barman-cloud-wal-restore.1 b/doc/barman-cloud-wal-restore.1
@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 2.2.1
 .\"
-.TH "BARMAN\-CLOUD\-WAL\-RESTORE" "1" "July 25, 2023" "Barman User manuals" "Version 3.7.0"
+.TH "BARMAN\-CLOUD\-WAL\-RESTORE" "1" "August 31, 2023" "Barman User manuals" "Version 3.8.0"
 .hy
 .SH NAME
 .PP

diff --git a/doc/barman-cloud-wal-restore.1.md b/doc/barman-cloud-wal-restore.1.md
@@ -1,6 +1,6 @@
-% BARMAN-CLOUD-WAL-RESTORE(1) Barman User manuals | Version 3.7.0
+% BARMAN-CLOUD-WAL-RESTORE(1) Barman User manuals | Version 3.8.0
 % EnterpriseDB <https://www.enterprisedb.com>
-% July 25, 2023
+% August 31, 2023
 
 # NAME
 

diff --git a/doc/barman-wal-archive.1 b/doc/barman-wal-archive.1
@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 2.2.1
 .\"
-.TH "BARMAN\-WAL\-ARCHIVE" "1" "July 25, 2023" "Barman User manuals" "Version 3.7.0"
+.TH "BARMAN\-WAL\-ARCHIVE" "1" "August 31, 2023" "Barman User manuals" "Version 3.8.0"
 .hy
 .SH NAME
 .PP

diff --git a/doc/barman-wal-archive.1.md b/doc/barman-wal-archive.1.md
@@ -1,6 +1,6 @@
-% BARMAN-WAL-ARCHIVE(1) Barman User manuals | Version 3.7.0
+% BARMAN-WAL-ARCHIVE(1) Barman User manuals | Version 3.8.0
 % EnterpriseDB <https://www.enterprisedb.com>
-% July 25, 2023
+% August 31, 2023
 
 # NAME
 

diff --git a/doc/barman-wal-restore.1 b/doc/barman-wal-restore.1
@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 2.2.1
 .\"
-.TH "BARMAN\-WAL\-RESTORE" "1" "July 25, 2023" "Barman User manuals" "Version 3.7.0"
+.TH "BARMAN\-WAL\-RESTORE" "1" "August 31, 2023" "Barman User manuals" "Version 3.8.0"
 .hy
 .SH NAME
 .PP

diff --git a/doc/barman-wal-restore.1.md b/doc/barman-wal-restore.1.md
@@ -1,6 +1,6 @@
-% BARMAN-WAL-RESTORE(1) Barman User manuals | Version 3.7.0
+% BARMAN-WAL-RESTORE(1) Barman User manuals | Version 3.8.0
 % EnterpriseDB <https://www.enterprisedb.com>
-% July 25, 2023
+% August 31, 2023
 
 # NAME
 

diff --git a/doc/barman.1 b/doc/barman.1
@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 2.2.1
 .\"
-.TH "BARMAN" "1" "July 25, 2023" "Barman User manuals" "Version 3.7.0"
+.TH "BARMAN" "1" "August 31, 2023" "Barman User manuals" "Version 3.8.0"
 .hy
 .SH NAME
 .PP

diff --git a/doc/barman.1.d/00-header.md b/doc/barman.1.d/00-header.md
@@ -1,3 +1,3 @@
-% BARMAN(1) Barman User manuals | Version 3.7.0
+% BARMAN(1) Barman User manuals | Version 3.8.0
 % EnterpriseDB <https://www.enterprisedb.com>
-% July 25, 2023
+% August 31, 2023
diff --git a/doc/barman.5 b/doc/barman.5
@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 2.2.1
 .\"
-.TH "BARMAN" "5" "July 25, 2023" "Barman User manuals" "Version 3.7.0"
+.TH "BARMAN" "5" "August 31, 2023" "Barman User manuals" "Version 3.8.0"
 .hy
 .SH NAME
 .PP
@@ -715,6 +715,22 @@ Global/Server.
 .RS
 .RE
 .TP
+.B primary_checkpoint_timeout
+This defines the amount of seconds that Barman will wait at the end of a
+backup if no new WAL files are produced, before forcing a checkpoint on
+the primary server.
+.RS
+.PP
+If not set or set to 0, Barman will not force a checkpoint on the
+primary, and wait indefinitely for new WAL files to be produced.
+.PP
+The value of this option should be greater of the value of the
+\f[C]archive_timeout\f[] set on the primary server.
+.PP
+This option works only if \f[C]primary_conninfo\f[] option is set, and
+it is ignored otherwise.
+.RE
+.TP
 .B primary_conninfo
 The connection string used by Barman to connect to the primary Postgres
 server during backup of a standby Postgres server.

diff --git a/doc/barman.5.d/00-header.md b/doc/barman.5.d/00-header.md
@@ -1,3 +1,3 @@
-% BARMAN(5) Barman User manuals | Version 3.7.0
+% BARMAN(5) Barman User manuals | Version 3.8.0
 % EnterpriseDB <https://www.enterprisedb.com>
-% July 25, 2023
+% August 31, 2023
diff --git a/doc/manual/00-head.en.md b/doc/manual/00-head.en.md
@@ -1,6 +1,6 @@
 % Barman Manual
 % EnterpriseDB UK Limited
-% July 25, 2023 (3.7.0)
+% August 31, 2023 (3.8.0)
 
 **Barman** (Backup and Recovery Manager) is an open-source administration tool for disaster recovery of PostgreSQL servers written in Python. It allows your organisation to perform remote backups of multiple servers in business critical environments to reduce risk and help DBAs during the recovery phase.