Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Prepare release 3.8.0 #841

Merged
merged 2 commits into from
Aug 31, 2023
Merged

Prepare release 3.8.0 #841

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c687ec1
Version set to 3.8.0
didiermichel Aug 31, 2023
538d32c
Update NEWS for 3.8.0
didiermichel Aug 31, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions NEWS
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,25 @@
Barman News - History of user-visible changes

Version 3.8.0 - 31 August 2023

- Clarify package installation. barman is packaged with default python version
for each operating system.

- The `minimum-redundancy` option is added to `barman-cloud-backup-delete`.
It allows to set the minimum number of backups that should always be available.

- Add a new `primary_checkpoint_timeout` configuration option. Allows define
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.

- Bug fixes:

- Fix race condition in barman retention policies application. Backup
deletions will now raise a warning if another deletion is in progress
for the requested backup.

- Fix `barman-cloud-backup-show` man page installation.

Version 3.7.0 - 25 July 2023

- Support is added for snapshot backups on AWS using EBS volumes.
Expand Down
2 changes: 1 addition & 1 deletion barman/version.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,4 +20,4 @@
This module contains the current Barman version.
"""

__version__ = "3.7.0"
__version__ = "3.8.0"
32 changes: 20 additions & 12 deletions doc/barman-cloud-backup-delete.1
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -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
Expand All @@ -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:
Expand Down Expand Up @@ -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[]:
Expand All @@ -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
Expand Down
4 changes: 2 additions & 2 deletions doc/barman-cloud-backup-delete.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand Down
2 changes: 1 addition & 1 deletion doc/barman-cloud-backup-keep.1
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 2 additions & 2 deletions doc/barman-cloud-backup-keep.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand Down
2 changes: 1 addition & 1 deletion doc/barman-cloud-backup-list.1
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 2 additions & 2 deletions doc/barman-cloud-backup-list.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand Down
2 changes: 1 addition & 1 deletion doc/barman-cloud-backup-show.1
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 2 additions & 2 deletions doc/barman-cloud-backup-show.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand Down
2 changes: 1 addition & 1 deletion doc/barman-cloud-backup.1
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 2 additions & 2 deletions doc/barman-cloud-backup.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand Down
4 changes: 2 additions & 2 deletions doc/barman-cloud-check-wal-archive.1
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 2 additions & 2 deletions doc/barman-cloud-check-wal-archive.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand Down
2 changes: 1 addition & 1 deletion doc/barman-cloud-restore.1
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 2 additions & 2 deletions doc/barman-cloud-restore.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand Down
2 changes: 1 addition & 1 deletion doc/barman-cloud-wal-archive.1
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 2 additions & 2 deletions doc/barman-cloud-wal-archive.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand Down
2 changes: 1 addition & 1 deletion doc/barman-cloud-wal-restore.1
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 2 additions & 2 deletions doc/barman-cloud-wal-restore.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand Down
2 changes: 1 addition & 1 deletion doc/barman-wal-archive.1
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 2 additions & 2 deletions doc/barman-wal-archive.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand Down
2 changes: 1 addition & 1 deletion doc/barman-wal-restore.1
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 2 additions & 2 deletions doc/barman-wal-restore.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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

Expand Down
2 changes: 1 addition & 1 deletion doc/barman.1
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 2 additions & 2 deletions doc/barman.1.d/00-header.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
18 changes: 17 additions & 1 deletion doc/barman.5
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -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.
Expand Down
4 changes: 2 additions & 2 deletions doc/barman.5.d/00-header.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
2 changes: 1 addition & 1 deletion doc/manual/00-head.en.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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.

Expand Down
Loading