BUG #13599: Backup/Restore Documentation Bug

Lists: Postg토토SQL : Postg토토SQL 메일 링리스트 : 2015-08-31 이후 PGSQL-BUGS 15:19
From: jkemp(at)arinc(dot)com
To: pgsql-bugs(at)postgresql(dot)org
Subject: BUG #13599: Backup/Restore Documentation Bug
Date: 2015-08-31 15:19:29
Message-ID: 20150831151929.2090.43633@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: Postg토토SQL : Postg토토SQL 메일 링리스트 : 2015-08-31 이후 PGSQL-BUGS 15:19

The following bug has been logged on the website:

Bug reference: 13599
Logged by: Joe Kemp
Email address: jkemp(at)arinc(dot)com
PostgreSQL version: 9.4.0
Operating system: N/A
Description:

After troubleshooting some legacy backup/restore scripts in our
infrastructure it became clear a useful bit of information is missing from
the "24.3.4. Recovering Using a Continuous Archive Backup" section. Earlier
in this section there is a mention that the backup_label file is critical
but no mention of how it is used. I propose the second sentence of step #8
be modified so it reads “The server will go into recovery mode and proceed
to read through the archived WAL files it needs as identified in the
backup_label file.” This would make it clear that the backup_label file is
used during the restore process rather than being an informational file that
is available if needed.


From: Michael Paquier <michael(dot)paquier(at)gmail(dot)com>
To: jkemp(at)arinc(dot)com
Cc: PostgreSQL mailing lists <pgsql-bugs(at)postgresql(dot)org>
Subject: Re: BUG #13599: Backup/Restore Documentation Bug
Date: 2015-09-01 02:46:06
Message-ID: CAB7nPqR8Utxy-WahkBNfU1kVj+0mQhDTOH9L=DmXcz_J1NY+Xg@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: Postg스포츠 토토 사이트SQL : Postg스포츠 토토 사이트SQL 메일 링리스트 : 2015-09-01 이후 PGSQL-BUGS 02:46

On Tue, Sep 1, 2015 at 12:19 AM, <jkemp(at)arinc(dot)com> wrote:
> After troubleshooting some legacy backup/restore scripts in our
> infrastructure it became clear a useful bit of information is missing from
> the "24.3.4. Recovering Using a Continuous Archive Backup" section. Earlier
> in this section there is a mention that the backup_label file is critical
> but no mention of how it is used. I propose the second sentence of step #8
> be modified so it reads “The server will go into recovery mode and proceed
> to read through the archived WAL files it needs as identified in the
> backup_label file.” This would make it clear that the backup_label file is
> used during the restore process rather than being an informational file that
> is available if needed.

This sounds like a good suggestion. Attached is a patch.
--
Michael

Attachment Content-Type Size
20150901_backuplabel_doc.patch application/x-patch 1.3 KB