From 5586aab967a6b7586bec9a10252cabe6165b2148 Mon Sep 17 00:00:00 2001 From: Dan Helfman Date: Fri, 9 Feb 2024 15:35:29 -0800 Subject: [PATCH] Clarify documentation about restoring a database: borgmatic does not create the database upon restore. --- NEWS | 4 ++++ docs/how-to/backup-your-databases.md | 4 ++++ setup.py | 2 +- 3 files changed, 9 insertions(+), 1 deletion(-) diff --git a/NEWS b/NEWS index dda9434..abee6fd 100644 --- a/NEWS +++ b/NEWS @@ -1,3 +1,7 @@ +1.8.9.dev0 + * Clarify documentation about restoring a database: borgmatic does not create the database upon + restore. + 1.8.8 * #370: For the PostgreSQL hook, pass the "PGSSLMODE" environment variable through to Borg when the database's configuration omits the "ssl_mode" option. diff --git a/docs/how-to/backup-your-databases.md b/docs/how-to/backup-your-databases.md index f450835..64db6cf 100644 --- a/docs/how-to/backup-your-databases.md +++ b/docs/how-to/backup-your-databases.md @@ -262,6 +262,10 @@ systems that you'd like supported. ## Database restoration +When you want to replace an existing database with its backed-up contents, you +can restore it with borgmatic. Note that the database must already exist; +borgmatic does not currently create a database upon restore. + To restore a database dump from an archive, use the `borgmatic restore` action. But the first step is to figure out which archive to restore from. A good way to do that is to use the `rlist` action: diff --git a/setup.py b/setup.py index 1a24f5a..d069cb1 100644 --- a/setup.py +++ b/setup.py @@ -1,6 +1,6 @@ from setuptools import find_packages, setup -VERSION = '1.8.8' +VERSION = '1.8.9.dev0' setup(