Add FAQ for time-based Point-in-Time Recovery.

pgbackrest · Sep 16, 2019 · 8675699 · 8675699
1 parent 49b421d
commit 8675699
Show file tree

Hide file tree

Showing 2 changed files with 18 additions and 0 deletions.
diff --git a/doc/xml/faq.xml b/doc/xml/faq.xml
@@ -96,6 +96,16 @@ process-max=1
         <p>See the <link url="user-guide.html#repo-host">Dedicated Repository Host</link> section of the <proper>User Guide</proper> for more information.</p>
     </section>
 
+    <section id="time-based-pitr">
+        <title>Time-based Point-in-Time Recovery does not appear to work, why?</title>
+
+        <p>The most common mistake when using time-based Point-in-Time Recovery is forgetting to choose a backup set that is before the target time. <backrest/> defaults to the latest backup and if it is after the target time, then <setting>--target=</setting> is not considered valid by <postgres/> and is therefore ignored, resulting in WAL recovery to the latest time available.</p>
+
+        <p>To choose the correct backup set, run the <cmd>info</cmd> command and find the backup with a timestamp stop that is before the target time. When running the restore, specify the option <setting>--set=BACKUP_LABEL</setting> where <id>BACKUP_LABEL</id> is the backup that was found with a <b>stop</b> timestamp before the target time.</p>
+
+        <p>See the <link url="user-guide.html#pitr">Point-in-Time Recovery</link> section of the <proper>User Guide</proper> for more information.</p>
+    </section>
+
     <!-- <section id="different-server">
         <title>How to restore a backup to a different server (for example, a production backup to a development server)?</title>
 

diff --git a/doc/xml/release.xml b/doc/xml/release.xml
@@ -51,6 +51,14 @@
 
                         <p>Add documentation clarifications regarding standby repositories.</p>
                     </release-item>
+
+                    <release-item>
+                        <release-item-contributor-list>
+                            <release-item-contributor id="cynthia.shang"/>
+                        </release-item-contributor-list>
+
+                        <p>Add FAQ for time-based Point-in-Time Recovery.</p>
+                    </release-item>
                 </release-improvement-list>
             </release-doc-list>
         </release>