v2.48: Repository Storage Tags

Bug Fixes:

• Fix issue restoring block incremental without a block list. (Reviewed by Stephen Frost, Burak Yurdakul. Reported by Burak Yurdakul.)

Features:

• Add --repo-storage-tag option to create object tags. (Reviewed by Stephen Frost, Stefan Fercot, Timothée Peignier.)
• Add known hosts checking for SFTP storage driver. (Contributed by Reid Thompson. Reviewed by Stephen Frost, David Steele.)
• Support for dual stack connections. (Reviewed by Stephen Frost.)
• Add backup size completed/total to info command JSON output. (Contributed by Stefan Fercot. Reviewed by David Steele.)

Improvements:

• Multi-stanza check command. (Reviewed by Stephen Frost.)
• Retry reads of pg_control until checksum is valid. (Reviewed by Stefan Fercot, Stephen Frost.)
• Optimize WAL segment check after successful backup. (Reviewed by Stephen Frost.)
• Improve GCS multi-part performance. (Reviewed by Reid Thompson.)
• Allow archive-get command to run when stanza is stopped. (Reviewed by Tom Swartz, David Christensen, Reid Thompson.)
• Accept leading tilde in paths for SFTP public/private keys. (Contributed by Reid Thompson. Reviewed by David Steele.)
• Reload GCS credentials before renewing authentication token. (Reviewed by Stephen Frost. Suggested by Daniel Farina.)

Documentation Bug Fixes:

• Fix configuration reference example for the tls-server-address option. (Fixed by Hartmut Goebel. Reviewed by David Steele.)
• Fix command reference example for the filter option.

Test Suite Improvements:

• Allow storage/sftp unit test to run without libssh2 installed. (Contributed by Reid Thompson. Reviewed by David Steele. Suggested by Wu Ning.)

v2.47: Performance Improvements and Bug Fixes

Bug Fixes:

• Preserve block incremental info in manifest during delta backup. (Reviewed by Stephen Frost. Reported by Francisco Miguel Biete Banon.)
• Fix block incremental file names in verify command. (Reviewed by Reid Thompson. Reported by Francisco Miguel Biete Banon.)
• Fix spurious automatic delta backup on backup from standby. (Reviewed by Stephen Frost. Reported by krmozejko, Don Seiler.)
• Skip recovery.signal for PostgreSQL >= 12 when recovery type=none. (Reviewed by Stefan Fercot. Reported by T.Anastacio.)
• Fix unique label generation for diff/incr backup. (Fixed by Andrey Sokolov. Reviewed by David Steele.)
• Fix time-based archive expiration when no backups are expired. (Reviewed by Stefan Fercot.)

Improvements:

• Improve performance of SFTP storage driver. (Contributed by Stephen Frost, Reid Thompson. Reviewed by David Steele.)
• Add timezone offset to info command date/time output. (Reviewed by Stefan Fercot, Philip Hurst. Suggested by Philip Hurst.)
• Centralize error handling for unsupported features. (Reviewed by Stefan Fercot.)

Documentation Improvements:

• Clarify preference to install from packages in the user guide. (Reviewed by Stefan Fercot. Suggested by dr-kd.)

v2.46: Block Incremental Backup and SFTP Storage

Features:

• Block incremental backup. (Reviewed by John Morris, Stephen Frost, Stefan Fercot.)
• SFTP support for repository storage. (Contributed by Reid Thompson. Reviewed by Stephen Frost, David Steele.)
• PostgreSQL 16 support. (Reviewed by Stefan Fercot.)

Improvements:

• Allow page header checks to be skipped. (Reviewed by David Christensen. Suggested by David Christensen.)
• Avoid chown() on recovery files during restore. (Reviewed by Stefan Fercot, Marcelo Henrique Neppel. Suggested by Marcelo Henrique Neppel.)
• Add error retry detail for HTTP retries.

Documentation Improvements:

• Add warning about using recovery type=none. (Reviewed by Stefan Fercot.)
• Add note about running stanza-create on already-created repositories.

v2.45: Block Incremental Backup (BETA)

Bug Fixes:

• Skip writing recovery.signal by default for restores of offline backups. (Reviewed by Stefan Fercot. Reported by Marcel Borger.)

Features:

• Block incremental backup (BETA). (Reviewed by John Morris, Stephen Frost, Stefan Fercot.)

Improvements:

• Keep only one all-default group index. (Reviewed by Stefan Fercot.)

Documentation Improvements:

• Add explicit instructions for upgrading between 2.x versions. (Contributed by Christophe Courtois. Reviewed by David Steele.)
• Remove references to SSH made obsolete when TLS was introduced.

v2.44: Remove PostgreSQL 9.0/9.1/9.2 Support

Improvements:

• Remove support for PostgreSQL 9.0/9.1/9.2. (Reviewed by Stefan Fercot.)
• Restore errors when no backup matches the current version of PostgreSQL. (Contributed by Stefan Fercot. Reviewed by David Steele. Suggested by Soulou.)
• Add compress-level range checking for each compress-type. (Reviewed by Stefan Fercot. Suggested by gkleen, ViperRu.)

Documentation Improvements:

• Add warning about enabling "hierarchical namespace" on Azure storage. (Reviewed by Stefan Fercot. Suggested by Vojtech Galda, Pluggi, asjonos.)
• Add replacement for linefeeds in monitoring example. (Reviewed by Stefan Fercot. Suggested by rudonx, gmustdie, Ivan Shelestov.)
• Clarify target-action behavior on various PostgreSQL versions. (Contributed by Chris Bandy. Reviewed by David Steele, Anton Kurochkin, Stefan Fercot. Suggested by Anton Kurochkin, Chris Bandy.)
• Updates and clarifications to index page. (Reviewed by Stefan Fercot.)
• Add dark mode to the website. (Suggested by Stephen Frost.)

v2.43: Bug Fix

Bug Fixes:

• Fix missing reference in diff/incr backup. (Reviewed by Stefan Fercot. Reported by Marcel Borger, ulfedf, jaymefSO.)

Improvements:

• Add hint when an option is specified without an index. (Reviewed by Stefan Fercot.)

v2.42: Bug Fixes

Bug Fixes:

• Fix memory leak in file bundle backup/restore. (Reviewed by John Morris, Oscar. Reported by Oscar.)
• Fix protocol error on short read of remote file. (Reviewed by Stephen Frost.)

Improvements:

• Do not store references for zero-length files when bundling. (Reviewed by Stefan Fercot.)
• Use more generic descriptions for pg_start_backup()/pg_stop_backup(). (Reviewed by Greg Sabino Mullane, David Christensen. Suggested by Greg Sabino Mullane.)

Test Suite Improvements:

• Update test.pl --psql-bin option to match command-line help. (Contributed by Koshi Shibagaki. Reviewed by David Steele.)

v2.41: Backup Annotations

Bug Fixes:

• Fix incorrect time expiration being used for non-default repositories. (Reviewed by Stefan Fercot. Reported by Adam Brusselback.)
• Fix issue when listing directories recursively with a filter. (Reviewed by Stephen Frost. Reported by Efremov Egor.)

Features:

• Backup key/value annotations. (Contributed by Stefan Fercot. Reviewed by David Steele. Suggested by Adam Berlin.)

Improvements:

• Support --set in JSON output for info command. (Contributed by Stefan Fercot. Reviewed by David Steele. Suggested by Anton Kurochkin.)
• Allow upload chunk size to be configured for object stores. (Reviewed by Stefan Fercot. Suggested by Anton Glushakov.)
• Update archive.info timestamps after a successful backup. (Reviewed by Stefan Fercot. Suggested by Alex Richman.)
• Move standby timeline check after checkpoint. (Reviewed by Stefan Fercot, Keith Fiske. Suggested by Keith Fiske.)
• Improve warning message on backup resume. (Suggested by Cynthia Shang.)

Documentation Improvements:

• Add absolute path for kill in pgbackrest.service. (Suggested by Don Seiler.)

v2.40: OpenSSL 3 Support

NOTE TO PACKAGERS: An experimental meson build has been added but packagers should continue to use the autoconf/make build for the foreseeable future.

Improvements:

• OpenSSL 3 support. (Reviewed by Stephen Frost.)
• Create snapshot when listing contents of a path. (Reviewed by John Morris, Stephen Frost.)
• Force target-timeline=current when restore type=immediate. (Reviewed by Stephen Frost.)
• Truncate files during delta restore when they are larger than expected. (Reviewed by Stephen Frost.)
• Disable incremental manifest save when resume=n. (Contributed by Reid Thompson. Reviewed by David Steele.)
• Set backup percent complete to zero before copy start. (Contributed by Reid Thompson. Reviewed by David Steele.)
• Use S3 IsTruncated flag to determine list continuation. (Reviewed by John Morris, Soulou. Suggested by Christian Montagne.)

Documentation Bug Fixes:

• Skip internal options in the configuration reference. (Reported by Francisco Miguel Biete.)

Documentation Improvements:

• Add link to PostgreSQL configuration in repository host section. (Reviewed by Stefan Fercot. Suggested by Julien Cigar.)

Test Suite Improvements:

• Add experimental Meson build. (Reviewed by Eli Schwartz, Sam Bassaly.)
• Allow any path to be passed to the --test-path option. (Contributed by Andrey Sokolov. Reviewed by David Steele.)
• Fix compile error when DEBUG_EXEC_TIME is defined without DEBUG. (Contributed by Andrey Sokolov. Reviewed by David Steele.)

v2.39: Verify and File Bundling

Bug Fixes:

• Fix error thrown from FINALLY() causing an infinite loop. (Reviewed by Stephen Frost.)
• Error on all lock failures except another process holding the lock. (Reviewed by Reid Thompson, Geir Råness. Reported by Geir Råness.)

Features:

• Backup file bundling for improved small file support. (Reviewed by Reid Thompson, Stefan Fercot, Chris Bandy.)
• Verify command to validate the contents of a repository. (Contributed by Cynthia Shang, Reid Thompson. Reviewed by David Steele, Stefan Fercot.)
• PostgreSQL 15 support. (Reviewed by Stefan Fercot.)
• Show backup percent complete in info output. (Contributed by Reid Thompson. Reviewed by David Steele.)
• Auto-select backup for restore command --type=lsn. (Contributed by Reid Thompson. Reviewed by Stefan Fercot, David Steele.)
• Suppress existing WAL warning when archive-mode-check is disabled. (Contributed by Reid Thompson. Reviewed by David Steele.)
• Add AWS IMDSv2 support. (Contributed by Nuno Pires. Reviewed by David Steele.)

Improvements:

• Allow repo-hardlink option to be changed after full backup. (Reviewed by Reid Thompson.)
• Increase precision of percent complete logging for backup and restore. (Contributed by Reid Thompson. Reviewed by David Steele.)
• Improve path validation for repo-* commands. (Contributed by Reid Thompson. Reviewed by David Steele.)
• Improve stop command to honor stanza option. (Contributed by Reid Thompson. Reviewed by David Steele. Suggested by ragaoua.)
• Improve error message for invalid repo-azure-key. (Contributed by Reid Thompson. Reviewed by David Steele. Suggested by Seth Daniel.)
• Add hint to check the log on archive-get/archive-push async error. (Reviewed by Reid Thompson.)
• Add ClockError for unexpected clock skew and timezone changes. (Reviewed by Greg Sabino Mullane, Stefan Fercot. Suggested by Greg Sabino Mullane.)
• Strip extensions from history manifest before showing in error message. (Reviewed by Stefan Fercot.)
• Add user:group to lock permission error. (Reviewed by Reid Thompson.)

Documentation Bug Fixes:

• Fix incorrect reference to stanza-update in the user guide. (Fixed by Abubakar Mohammed. Reviewed by David Steele.)
• Fix example for repo-gcs-key-type option in configuration reference. (Reviewed by Reid Thompson.)
• Fix tls-server-auth example and add clarifications. (Reviewed by Reid Thompson.)

Documentation Improvements:

• Simplify messaging around supported versions in the documentation. (Reviewed by Stefan Fercot, Reid Thompson, Greg Sabino Mullane.)
• Add option type descriptions. (Contributed by Reid Thompson. Reviewed by David Steele.)
• Add FAQ about backup types and restore speed. (Contributed by David Christensen. Reviewed by Reid Thompson.)
• Document required base branch for pull requests. (Contributed by David Christensen. Reviewed by Reid Thompson.)