From 868b55e8079b28d56e04b8a9b8b9114b51758871 Mon Sep 17 00:00:00 2001 From: Andre Date: Fri, 23 Aug 2024 14:06:53 -0300 Subject: [PATCH] Add note in the manual about recovery near retention policy This commit Closes#200. It is adding a note to the recovery section in the documentation manual alerting the user about the possibility of the backup getting obsolete while the recovery process is ongoing and what to do to prevent that. The team first thought about a solution that could handle this automatically but many arguments were against this, specially because it could introduce unwanted behaviour on recover and the fact that `keep` feature is there to help. References: BAR-222 Signed-off-by: Andre --- doc/manual/43-backup-commands.en.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/manual/43-backup-commands.en.md b/doc/manual/43-backup-commands.en.md index 74c7aa6f7..fd31ada6c 100644 --- a/doc/manual/43-backup-commands.en.md +++ b/doc/manual/43-backup-commands.en.md @@ -198,6 +198,16 @@ command. The recovery command has several options that modify the command behavior. +> **IMPORTANT:** +> If you're unsure whether the backup you want to recover from will be +> automatically deleted by retention policies during recovery, +> mark it issuing the [keep command](#keep) using the appropriate target. +> Once the recovery process is complete and your new PostgreSQL instance +> has reached the desired recovery target, if you don’t want to +> keep the backup beyond the retention policy, you can remove `keep` +> annotation issuing the [keep command](#keep) again using the +> `--release` option. + ### Remote recovery Add the `--remote-ssh-command ` option to the invocation