From 6005426684c861cd54704e30e2355b54362296de Mon Sep 17 00:00:00 2001 From: Dan Helfman Date: Sun, 3 Jul 2022 22:24:25 -0700 Subject: [PATCH] Update documentation about configuring multiple consistency checks or multiple databases (#559). --- NEWS | 3 +++ docs/how-to/backup-your-databases.md | 6 ++++-- docs/how-to/deal-with-very-large-backups.md | 11 +++++++---- setup.py | 2 +- 4 files changed, 15 insertions(+), 7 deletions(-) diff --git a/NEWS b/NEWS index 6f5d07ff3..ee2d9004d 100644 --- a/NEWS +++ b/NEWS @@ -1,3 +1,6 @@ +1.6.6.dev0 + * #559: Update documentation about configuring multiple consistency checks or multiple databases. + 1.6.5 * #553: Fix logging to include the full traceback when Borg experiences an internal error, not just the first few lines. diff --git a/docs/how-to/backup-your-databases.md b/docs/how-to/backup-your-databases.md index dccb9e6e9..01a84f963 100644 --- a/docs/how-to/backup-your-databases.md +++ b/docs/how-to/backup-your-databases.md @@ -52,6 +52,8 @@ hooks: postgresql_databases: - name: users hostname: database1.example.org + - name: orders + hostname: database2.example.org port: 5433 username: postgres password: trustsome1 @@ -59,14 +61,14 @@ hooks: options: "--role=someone" mysql_databases: - name: posts - hostname: database2.example.org + hostname: database3.example.org port: 3307 username: root password: trustsome1 options: "--skip-comments" mongodb_databases: - name: messages - hostname: database3.example.org + hostname: database4.example.org port: 27018 username: dbuser password: trustsome1 diff --git a/docs/how-to/deal-with-very-large-backups.md b/docs/how-to/deal-with-very-large-backups.md index 550ff0517..aa67f1f63 100644 --- a/docs/how-to/deal-with-very-large-backups.md +++ b/docs/how-to/deal-with-very-large-backups.md @@ -83,12 +83,15 @@ consistency: checks: - name: repository frequency: 2 weeks + - name: archives + frequency: 1 month ``` -This tells borgmatic to run this consistency check at most once every two -weeks for a given repository. The `frequency` value is a number followed by a -unit of time, e.g. "3 days", "1 week", "2 months", etc. The `frequency` -defaults to "always", which means run this check every time checks run. +This tells borgmatic to run the `repository` consistency check at most once +every two weeks for a given repository and the `archives` check at most once a +month. The `frequency` value is a number followed by a unit of time, e.g. "3 +days", "1 week", "2 months", etc. The `frequency` defaults to `always`, which +means run this check every time checks run. Unlike a real scheduler like cron, borgmatic only makes a best effort to run checks on the configured frequency. It compares that frequency with how long diff --git a/setup.py b/setup.py index 679c035a3..9cf64a16b 100644 --- a/setup.py +++ b/setup.py @@ -1,6 +1,6 @@ from setuptools import find_packages, setup -VERSION = '1.6.5' +VERSION = '1.6.6.dev0' setup(