db/pgbackrest
1
0
Fork 0
mirror of https://github.com/pgbackrest/pgbackrest.git synced 2025-11-06 08:49:29 +02:00
Code Issues Releases Activity

v2.30: PostgreSQL 13 Support

Browse Source 
Bug Fixes:

* Error with hints when backup user cannot read pg_settings. (Reviewed by Stefan Fercot, Cynthia Shang. Reported by Mohamed Insaf K.)

Features:

* PostgreSQL 13 support. (Reviewed by Cynthia Shang.)

Improvements:

* Improve PostgreSQL version identification. (Reviewed by Cynthia Shang, Stephen Frost.)
* Improve working directory error message. (Reviewed by Stefan Fercot.)
* Add hint about starting the stanza when WAL segment not found. (Contributed by David Christensen. Reviewed by David Steele.)
* Add hint for protocol version mismatch. (Reviewed by Cynthia Shang. Suggested by loop-evgeny.)

Documentation Improvements:

* Add note that pgBackRest versions must match when running remotely. (Reviewed by Cynthia Shang. Suggested by loop-evgeny.)
* Move info command text to the reference and link to user guide. (Reviewed by Cynthia Shang. Suggested by Christophe Courtois.)
* Update yum repository path for CentOS/RHEL user guide. (Contributed by Heath Lord. Reviewed by David Steele.)
This commit is contained in:
David Steele
2020-10-05 11:51:45 -04:00
parent 74151d57ba
commit 9229d6c866
11 changed files with 872 additions and 677 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
CONTRIBUTING.md
View File

@@ -46,12 +46,12 @@ pgbackrest/test/test.pl --vm=none --dry-run
P00 INFO: test begin - log level info
P00 INFO: check version info
P00 INFO: builds required: bin
--> P00 INFO: 68 tests selected
--> P00 INFO: 69 tests selected
P00 INFO: P1-T01/68 - vm=none, module=common, test=error
[filtered 65 lines of output]
P00 INFO: P1-T67/68 - vm=none, module=performance, test=type
P00 INFO: P1-T68/68 - vm=none, module=performance, test=storage
P00 INFO: P1-T01/69 - vm=none, module=common, test=error
[filtered 66 lines of output]
P00 INFO: P1-T68/69 - vm=none, module=performance, test=type
P00 INFO: P1-T69/69 - vm=none, module=performance, test=storage
--> P00 INFO: DRY RUN COMPLETED SUCCESSFULLY
```
@@ -138,7 +138,7 @@ pgbackrest/test/test.pl --vm-build --vm=u18
--- output ---
P00 INFO: test begin - log level info
P00 INFO: Using cached pgbackrest/test:u18-base-20200814A image (7df9a43ce9b6736e5f8dc797edd0f6326908fd2b) ...
P00 INFO: Using cached pgbackrest/test:u18-base-20200924A image (d95d53e642fc1cea4a2b8e935ea7d9739f7d1c46) ...
P00 INFO: Building pgbackrest/test:u18-test image ...
P00 INFO: Build Complete
```

2
README.md
View File

@@ -4,7 +4,7 @@
pgBackRest aims to be a reliable, easy-to-use backup and restore solution that can seamlessly scale up to the largest databases and workloads by utilizing algorithms that are optimized for database-specific requirements.
pgBackRest [v2.29](https://github.com/pgbackrest/pgbackrest/releases/tag/release/2.29) is the current stable release. Release notes are on the [Releases](http://www.pgbackrest.org/release.html) page.
pgBackRest [v2.30](https://github.com/pgbackrest/pgbackrest/releases/tag/release/2.30) is the current stable release. Release notes are on the [Releases](http://www.pgbackrest.org/release.html) page.
Documentation for v1 can be found [here](http://www.pgbackrest.org/1). No further releases are planned for v1 because v2 is backward-compatible with v1 options and repositories.

10
doc/RELEASE.md
View File

@@ -33,16 +33,16 @@ to:
#define PROJECT_VERSION "2.14"
```
## Build release documentation. Be sure to install latex using the instructions from the Vagrantfile before running this step.
```
${PGBR_REPO?}/doc/release.pl --build
```
## Update code counts
```
${PGBR_REPO?}/test/test.pl --code-count
```
## Build release documentation. Be sure to install latex using the instructions from the Vagrantfile before running this step.
```
${PGBR_REPO?}/doc/release.pl --build
```
## Commit release branch and push to CI for testing
```
git commit -m "Release test"

1276
doc/resource/exe.cache
View File

File diff suppressed because it is too large Load Diff

147
doc/resource/git-history.cache
View File

@@ -1,4 +1,151 @@
[
{
"commit": "74151d57ba03a4e9386f8e988d7f832ccfbe1e25",
"date": "2020-10-05 08:42:18 -0400",
"subject": "Add apt-get update to contributing guide.",
"body": "This allows apt-get to work correctly even if the base container is a bit out of date."
},
{
"commit": "293add28fdd306b863b077d27b0f3438b6594110",
"date": "2020-10-05 08:37:48 -0400",
"subject": "Add text rendering for page links missed in 597739fa.",
"body": "Since links are not possible in the command line help just display the name of the linked section.\n\nAlso, during reference text rendering there is no out key so make sure it is defined before trying to use it."
},
{
"commit": "597739fafecf349af470134200aafc65a53eabf2",
"date": "2020-09-25 11:26:27 -0400",
"subject": "Move info command text to the reference and link to user guide.",
"body": "This means the same text will appear in both places, which should make it easier to find.\r\n\r\nAlso update the link code to allow both page and section to be specified rather than only one or the other."
},
{
"commit": "31962377d9d53aed4b8b01accdba7801fa5ce435",
"date": "2020-09-25 10:30:29 -0400",
"subject": "Add hint and documentation for protocol version mismatches.",
"body": "Update the documentation to explicitly state that versions must match across hosts when running remotely.\r\n\r\nAdd a hint to the protocol version mismatch error to help the user identify the problem."
},
{
"commit": "b096a25b49875b1303c066b6f659dd5afffebc56",
"date": "2020-09-24 11:19:51 -0400",
"subject": "Update test containers for PostgreSQL 13.",
"body": "Add older PostgreSQL versions to the u18 container that were not available before.\n\nThis also updates all minor versions for prior versions of PostgreSQL."
},
{
"commit": "ad79932ba5bf3df7e59677c29b32477b7022ea16",
"date": "2020-09-22 11:57:38 -0400",
"subject": "Add internal verify command.",
"body": "Scan the WAL archive for missing or invalid files and build up ranges of WAL that will be used to verify backup integrity. A number of errors and warnings are currently emitted but they should not be considered authoritative (yet).\r\n\r\nThe command is incomplete so is marked internal."
},
{
"commit": "3e8a6febe66ef30dee104a895fd7e3c5f8ad0660",
"date": "2020-09-21 14:37:07 -0400",
"subject": "Update yum repository path for CentOS/RHEL user guide.",
"body": "Update to the current yum.p.o repository so the CentOS/RHEL user guide will build on PostgreSQL 13."
},
{
"commit": "927d9adbee780a51639955edb74ce7a4850db100",
"date": "2020-09-18 16:55:26 -0400",
"subject": "Improve PostgreSQL version identification.",
"body": "Previously, catalog versions were fixed for all versions which made maintaining the catalog versions during PostgreSQL beta and release candidate cycles very painful. A version of pgBackRest which was functionally compatible was rendered useless by a catalog version bump in PostgreSQL.\r\n\r\nInstead use only the control version to identify a PostgreSQL version when possible. Some older versions require a catalog version to positively identify a PostgreSQL version, so include them when required.\r\n\r\nSince the catalog number is required to work with tablespaces it will need to be stored. There's already a copy of it in backup.info so use that (even though we have been ignoring it in the C versions)."
},
{
"commit": "94475bfbe6a694b150091d5f7208b0d01ab07a40",
"date": "2020-09-17 15:17:13 -0400",
"subject": "Add missing semicolon in backtrace debug code.",
"body": "Apparently backtrace has not been used for debugging since it was broken in 7fba1f0b.\n\nEven though this is test code it might be good to find a way to test it to prevent regressions."
},
{
"commit": "4cd61152f510140a30525e995b0901590d55012c",
"date": "2020-09-17 12:39:30 -0400",
"subject": "Update PostgreSQL 13 test catalog versions missed in 6bb111c1.",
"body": "These values are not used by the Perl integration tests so maybe it would be better to remove them, but for now just update since they should not be changing again for PG13."
},
{
"commit": "9db314397302bc01d81a24cb0edaceefa2b2e9d0",
"date": "2020-09-17 10:35:27 -0400",
"subject": "Error with hints when backup user cannot read pg_settings.",
"body": "This condition used to give a not-very-clear error which we have been intending to improve. But in the meantime the changes in fbff299 resulted in a segfault for this condition instead because the data_directory was assumed to be non-NULL.\r\n\r\nFix this by explicitly throwing an error with hints when any row in pg_settings cannot be selected."
},
{
"commit": "c71609879bb3782dd7da40c14313e75e78262bfc",
"date": "2020-09-16 09:33:37 -0400",
"subject": "Fix incorrect control/catalog versions in command/stanza test.",
"body": "These were not caught because backup info load automatically corrects them."
},
{
"commit": "8dce7bbb608c65a16a4e41ae2cd95c588154e9e0",
"date": "2020-09-14 10:15:40 -0400",
"subject": "Ignore backup_manifest in PG13.",
"body": "This file is created by pg_basebackup so might be in the data directory if the cluster was restored from a pg_basebackup backup. Also exclude backup_manifest.tmp since it is possible to find that in the backup directory."
},
{
"commit": "fc77c511824feb77c0a5f4cd5d95795184b65d2e",
"date": "2020-09-11 10:10:25 -0400",
"subject": "Improve working directory error message.",
"body": "Improve the wording of the error message and add a hint to make it clearer what is wrong and how the user can fix it.\r\n\r\nAlso change the assert to a regular error since this is not an internal error."
},
{
"commit": "dac182c06e84ba94a3e03cc0769367bdc89ba3b7",
"date": "2020-09-11 08:23:26 -0400",
"subject": "Improve alignment in TEST_ERROR output.",
"body": "Align the error types and messages so they are easier to compare."
},
{
"commit": "ecb112f802be958fdccf003be2e9b62aada98bb3",
"date": "2020-09-08 13:02:13 -0400",
"subject": "Add infoArchiveMove() and infoBackupMove()."
},
{
"commit": "5941f5631afc73e504d67827587a90ca91ead399",
"date": "2020-09-08 12:55:56 -0400",
"subject": "Extern infoBackupNewLoad() and infoArchiveNewLoad()."
},
{
"commit": "4239f8a81aa5da52667149a4933956347492b748",
"date": "2020-09-08 12:47:35 -0400",
"subject": "Add manifestFree()."
},
{
"commit": "fead0046918ad50eafa30991c2e8d6aabbf254a0",
"date": "2020-09-08 12:44:08 -0400",
"subject": "Move WAL constants to postgres/interface header."
},
{
"commit": "b8efb13bcb11027fcbb3bd386446280cd8b625ce",
"date": "2020-09-08 12:28:56 -0400",
"subject": "Move archiveIdComparator() to archive/common module."
},
{
"commit": "9fd31913a8cbff1f1371ccabfebb003cb3c47c05",
"date": "2020-09-03 07:49:49 -0400",
"subject": "Add hint about starting the stanza when WAL segment not found.",
"body": "If a stop command has been issued the check command fails due to archiving timing out.\n\nProvide a hint to document this situation and point the user in the proper direction."
},
{
"commit": "76900d676416758e82b12ea3966daadf6e3b3464",
"date": "2020-09-02 14:45:09 -0400",
"subject": "Fix contributor name."
},
{
"commit": "41118e1b6813ea41a13c0441c726f3e7c28051d9",
"date": "2020-09-02 11:03:49 -0400",
"subject": "Allow ProtocolParallel to complete with no jobs.",
"body": "If the callback never returned any jobs then protocolParallelDone() would never be true. The reason is that the done state was being set in protocolParallelResult(), which never gets called if there are no results.\r\n\r\nCalling protocolParallelResult() doesn't make much sense in this case so instead move the done logic to protocolParallelDone().\r\n\r\nFor current usage of ProtocolParallel we ensure there are jobs before processing so this is not a live issue, but the new behavior is required for future development."
},
{
"commit": "ce6c492620d9408a432f5b7c04a437ec812788ac",
"date": "2020-09-01 11:02:44 -0400",
"subject": "Add notes about optional symlinks to repo format 6 design."
},
{
"commit": "bb87d989b840e77d1ceafc8f699972101fb94d96",
"date": "2020-08-31 08:20:40 -0400",
"subject": "Update config.guess and config.sub to latest versions."
},
{
"commit": "05ef03feb5550f7151ee34afe6b0358637f65fc8",
"date": "2020-08-31 07:41:48 -0400",
"subject": "Begin v2.30 development."
},
{
"commit": "1df7d3eee5baa38504478fafa27de2b1b0fce724",
"date": "2020-08-31 07:28:22 -0400",

43
doc/xml/auto/metric-coverage-report.auto.xml
View File

@@ -7,9 +7,9 @@
<table-row>
<table-cell>command/archive</table-cell>
<table-cell>12/12 (100.0%)</table-cell>
<table-cell>13/13 (100.0%)</table-cell>
<table-cell>74/74 (100.0%)</table-cell>
<table-cell>216/216 (100.0%)</table-cell>
<table-cell>222/222 (100.0%)</table-cell>
</table-row>
<table-row>
@@ -49,9 +49,9 @@
<table-row>
<table-cell>command/expire</table-cell>
<table-cell>10/10 (100.0%)</table-cell>
<table-cell>9/9 (100.0%)</table-cell>
<table-cell>202/202 (100.0%)</table-cell>
<table-cell>320/320 (100.0%)</table-cell>
<table-cell>314/314 (100.0%)</table-cell>
</table-row>
<table-row>
@@ -72,7 +72,7 @@
<table-cell>command/local</table-cell>
<table-cell>1/1 (100.0%)</table-cell>
<table-cell>---</table-cell>
<table-cell>20/20 (100.0%)</table-cell>
<table-cell>21/21 (100.0%)</table-cell>
</table-row>
<table-row>
@@ -93,7 +93,7 @@
<table-cell>command/restore</table-cell>
<table-cell>26/26 (100.0%)</table-cell>
<table-cell>454/454 (100.0%)</table-cell>
<table-cell>933/933 (100.0%)</table-cell>
<table-cell>935/935 (100.0%)</table-cell>
</table-row>
<table-row>
@@ -103,6 +103,13 @@
<table-cell>155/155 (100.0%)</table-cell>
</table-row>
<table-row>
<table-cell>command/verify</table-cell>
<table-cell>17/17 (100.0%)</table-cell>
<table-cell>176/176 (100.0%)</table-cell>
<table-cell>479/479 (100.0%)</table-cell>
</table-row>
<table-row>
<table-cell>common</table-cell>
<table-cell>172/172 (100.0%)</table-cell>
@@ -211,22 +218,22 @@
<table-row>
<table-cell>db</table-cell>
<table-cell>27/27 (100.0%)</table-cell>
<table-cell>102/102 (100.0%)</table-cell>
<table-cell>370/370 (100.0%)</table-cell>
<table-cell>106/106 (100.0%)</table-cell>
<table-cell>373/373 (100.0%)</table-cell>
</table-row>
<table-row>
<table-cell>info</table-cell>
<table-cell>119/119 (100.0%)</table-cell>
<table-cell>740/740 (100.0%)</table-cell>
<table-cell>2381/2381 (100.0%)</table-cell>
<table-cell>122/122 (100.0%)</table-cell>
<table-cell>752/752 (100.0%)</table-cell>
<table-cell>2394/2394 (100.0%)</table-cell>
</table-row>
<table-row>
<table-cell>postgres</table-cell>
<table-cell>34/34 (100.0%)</table-cell>
<table-cell>100/100 (100.0%)</table-cell>
<table-cell>378/378 (100.0%)</table-cell>
<table-cell>102/102 (100.0%)</table-cell>
<table-cell>381/381 (100.0%)</table-cell>
</table-row>
<table-row>
@@ -239,8 +246,8 @@
<table-row>
<table-cell>protocol</table-cell>
<table-cell>69/69 (100.0%)</table-cell>
<table-cell>202/202 (100.0%)</table-cell>
<table-cell>855/855 (100.0%)</table-cell>
<table-cell>204/204 (100.0%)</table-cell>
<table-cell>857/857 (100.0%)</table-cell>
</table-row>
<table-row>
@@ -287,7 +294,7 @@
<table-row>
<table-cell>TOTAL</table-cell>
<table-cell>1387/1387 (100.0%)</table-cell>
<table-cell>6363/6364 (99.98%)</table-cell>
<table-cell>20766/20766 (100.0%)</table-cell>
<table-cell>1407/1407 (100.0%)</table-cell>
<table-cell>6559/6560 (99.98%)</table-cell>
<table-cell>21269/21269 (100.0%)</table-cell>
</table-row>

7
doc/xml/release.xml
View File

@@ -12,7 +12,7 @@
</intro>
<release-list>
<release date="XXXX-XX-XX" version="2.30dev" title="UNDER DEVELOPMENT">
<release date="2020-10-05" version="2.30" title="PostgreSQL 13 Support">
<release-core-list>
<release-bug-list>
<release-item>
@@ -29,7 +29,7 @@
<release-feature-list>
<release-item>
<commit subject="Ignore backup_manifest in PostgreSQL 13."/>
<commit subject="Ignore backup_manifest in PG13."/>
<commit subject="Update PostgreSQL 13 test catalog versions missed in 6bb111c1."/>
<commit subject="Update test containers for PostgreSQL 13."/>
@@ -117,6 +117,9 @@
</release-item>
<release-item>
<commit subject="Move info command text to the reference and link to user guide."/>
<commit subject="Add text rendering for page links missed in 597739fa."/>
<release-item-contributor-list>
<release-item-ideator id="christophe.courtois"/>
<release-item-reviewer id="cynthia.shang"/>

2
src/build/configure.ac
View File

@@ -1,7 +1,7 @@
# Initialize configuration
# ----------------------------------------------------------------------------------------------------------------------------------
AC_PREREQ([2.69])
AC_INIT([pgBackRest], [2.30dev])
AC_INIT([pgBackRest], [2.30])
AC_CONFIG_SRCDIR([version.h])
AC_CONFIG_AUX_DIR(build)

20
src/configure vendored
View File

@@ -1,6 +1,6 @@
#! /bin/sh
# Guess values for system-dependent variables and create Makefiles.
# Generated by GNU Autoconf 2.69 for pgBackRest 2.30dev.
# Generated by GNU Autoconf 2.69 for pgBackRest 2.30.
#
#
# Copyright (C) 1992-1996, 1998-2012 Free Software Foundation, Inc.
@@ -577,8 +577,8 @@ MAKEFLAGS=
# Identity of this package.
PACKAGE_NAME='pgBackRest'
PACKAGE_TARNAME='pgbackrest'
PACKAGE_VERSION='2.30dev'
PACKAGE_STRING='pgBackRest 2.30dev'
PACKAGE_VERSION='2.30'
PACKAGE_STRING='pgBackRest 2.30'
PACKAGE_BUGREPORT=''
PACKAGE_URL=''
@@ -1250,7 +1250,7 @@ if test "$ac_init_help" = "long"; then
# Omit some internal or obsolete options to make the list less imposing.
# This message is too long to be a string in the A/UX 3.1 sh.
cat <<_ACEOF
\`configure' configures pgBackRest 2.30dev to adapt to many kinds of systems.
\`configure' configures pgBackRest 2.30 to adapt to many kinds of systems.
Usage: $0 [OPTION]... [VAR=VALUE]...
@@ -1297,7 +1297,7 @@ fi
if test -n "$ac_init_help"; then
case $ac_init_help in
short | recursive ) echo "Configuration of pgBackRest 2.30dev:";;
short | recursive ) echo "Configuration of pgBackRest 2.30:";;
esac
cat <<\_ACEOF
@@ -1387,7 +1387,7 @@ fi
test -n "$ac_init_help" && exit $ac_status
if $ac_init_version; then
cat <<\_ACEOF
pgBackRest configure 2.30dev
pgBackRest configure 2.30
generated by GNU Autoconf 2.69
Copyright (C) 2012 Free Software Foundation, Inc.
@@ -1685,7 +1685,7 @@ cat >config.log <<_ACEOF
This file contains any messages produced by compilers while
running configure, to aid debugging if configure makes a mistake.
It was created by pgBackRest $as_me 2.30dev, which was
It was created by pgBackRest $as_me 2.30, which was
generated by GNU Autoconf 2.69. Invocation command line was
$ $0 $@
@@ -4709,7 +4709,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1
# report actual input values of CONFIG_FILES etc. instead of their
# values after options handling.
ac_log="
This file was extended by pgBackRest $as_me 2.30dev, which was
This file was extended by pgBackRest $as_me 2.30, which was
generated by GNU Autoconf 2.69. Invocation command line was
CONFIG_FILES = $CONFIG_FILES
@@ -4771,7 +4771,7 @@ _ACEOF
cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`"
ac_cs_version="\\
pgBackRest config.status 2.30dev
pgBackRest config.status 2.30
configured by $0, generated by GNU Autoconf 2.69,
with options \\"\$ac_cs_config\\"
@@ -5475,4 +5475,4 @@ if test -n "$ac_unrecognized_opts" && test "$enable_option_checking" != no; then
$as_echo "$as_me: WARNING: unrecognized options: $ac_unrecognized_opts" >&2;}
fi
# Generated from src/build/configure.ac sha1 bb319c3dc3fabf2edb8fd3d3b4e94add270db9cf
# Generated from src/build/configure.ac sha1 9d2e9698659b08681beba8d807ebcf2bb7799f4c

2
src/version.h
View File

@@ -23,6 +23,6 @@ repository will be invalid unless migration functions are written.
/***********************************************************************************************************************************
Software version. Currently this value is maintained in Version.pm and updated by test.pl.
***********************************************************************************************************************************/
#define PROJECT_VERSION "2.30dev"
#define PROJECT_VERSION "2.30"
#endif

28
test/code-count/file-type.yaml
View File

@@ -511,6 +511,30 @@ src/command/stanza/upgrade.h:
class: core
type: c/h
src/command/verify/file.c:
class: core
type: c
src/command/verify/file.h:
class: core
type: c/h
src/command/verify/protocol.c:
class: core
type: c
src/command/verify/protocol.h:
class: core
type: c/h
src/command/verify/verify.c:
class: core
type: c
src/command/verify/verify.h:
class: core
type: c/h
src/common/assert.h:
class: core
type: c/h
@@ -1931,6 +1955,10 @@ test/src/module/command/stanzaTest.c:
class: test/module
type: c
test/src/module/command/verifyTest.c:
class: test/module
type: c
test/src/module/common/assertOffTest.c:
class: test/module
type: c