tklbam-backup

Backup the current system

Author:	Liraz Siri <liraz@turnkeylinux.org>
Date:	2012-08-10
Manual section:	8
Manual group:	backup

SYNOPSIS

tklbam-backup [ -options ] [ override ... ]

ARGUMENTS

<override> := <filesystem-override> | <database-override>

Overrides are usually configured in /etc/tklbam/overrides.

Filesystem 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:

If you add a directory handled by package management this may break package management on the system you restore to.
Only changes (e.g., new files, edited files, deleted files) from the base installation are included in a backup.

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 overrides

<database-override> := -?mysql:database[/table]

By default ALL databases are backed up. Adding a positive override changes the default behavior so that only the database or table specified in the override is included in the backup.

You can mix positive overrides with negative overrides.

Examples:

# exclude Drupal6 sessions table
-mysql:drupal6/sessions

# only include drupal6 database
mysql:drupal6

OPTIONS

`--resume`	Resume aborted backup session
`--disable-resume`
	Disable implicit --resume when rerunning an aborted backup
`--address=TARGET_URL`
	manual backup target URL. Default: automatically configured via Hub
`--simulate, -s`	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

Configurable options

`--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] e.g.,: now - always do a full backup 60m - 60 minutes 12h - 12 hours 3D - three days 2W - two weeks 1M - one month
`--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)

FILES

Configuration files:
	/etc/tklbam/overrides, /etc/tklbam/conf, /etc/tklbam/hooks.d
Local cache of profile:
	/var/lib/tklbam/profile