| Author: | Liraz Siri <liraz@turnkeylinux.org> |
|---|---|
| Date: | 2013-09-05 |
| Manual section: | 8 |
| Manual group: | backup |
tklbam-backup [ -options ] [ override ... ]
<override> := <filesystem-override> | <database-override>
Overrides are usually configured in /etc/tklbam/overrides.
<filesystem-override> := -?/path/to/include/or/exclude
This includes or excludes additional files and directories from being backed up if they've changed since installation.
Overrides defaults in /var/lib/tklbam/profile/dirindex.conf
Gotchas:
Examples:
# exclude log files in /var/www -/var/www/*/logs # ignores changes to webmin configuration -/etc/webmin # include the contents of an external hard disk... /mnt/images
<database-override> := -?mysql:database[/table]
<database-override> := -?pgsql:database[/table]
By default ALL databases and database tables are backed up.
Adding a positive override (e.g., mysql:mydatabase) changes the default behavior so that only the database or table specified in the override is included in the backup.
Negative overrides exclude a database (e.g., -mysql:mydatabase) or table (e.g., -mysql:mydatabase/mytable) from being included in the backup.
Excluding a table only excludes its data. The schema of an excluded table is still backed up, as it takes up a trivial amount of space and other tables or views may depend on it.
You can mix positive overrides with negative overrides.
Examples:
# exclude Drupal6 sessions table -mysql:drupal6/sessions # only include drupal6 database mysql:drupal6 # only include mahara postgres database pgsql:mahara
| --dump=DIR | Dump a raw backup extract to path. Tip: tklbam-restore path/to/raw/extract/ |
| --raw-upload=PATH | |
| Use Duplicity to upload raw path contents to --address | |
| --address=TARGET_URL | |
| manual backup target URL. Default: automatically configured via Hub | |
| --resume | Resume aborted backup session |
| --disable-resume | |
| Disable implicit --resume when rerunning an aborted backup | |
| --simulate | Simulate operation. Don't actually backup. Useful for inspecting /TKLBAM by hand. |
| --quiet, -q | Be less verbose |
| --logfile=PATH | Path of file to log output to. Default: /var/log/tklbam-backup |
| --debug | Run $SHELL before Duplicity |
| --volsize MB | Size of backup volume in MBs. Default: 50 |
| --s3-parallel-uploads=N | |
| Number of parallel volume chunk uploads Default: 1 | |
| --full-backup FREQUENCY | |
Time frequency of full backup. Default: 1M <frequency> := now | <int>[DWM]
| |
| --skip-files | Don't backup filesystem |
| --skip-database | |
| Don't backup databases | |
| --skip-packages | |
| Don't backup new packages | |
| --force-profile=PROFILE_ID | |
| Force a specific backup profile | |
Resolution order for configurable options:
comand line (highest precedence)
configuration file (/etc/tklbam/conf):
# comment <option-name> <value>
built-in default (lowest precedence)
| Configuration files: | |
|---|---|
| /etc/tklbam/overrides, /etc/tklbam/conf, /etc/tklbam/hooks.d | |
| Local cache of profile: | |
| /var/lib/tklbam/profile | |
tklbam (8), tklbam-faq (7), tklbam-hooks (5)