2014-12-02 04:49:25 +01:00
|
|
|
title: Atticmatic
|
|
|
|
date:
|
2014-12-02 05:15:21 +01:00
|
|
|
save_as: atticmatic/index.html
|
2014-12-02 04:49:25 +01:00
|
|
|
|
2014-11-27 18:29:31 +01:00
|
|
|
## Overview
|
2014-10-31 06:34:03 +01:00
|
|
|
|
2014-12-02 04:49:25 +01:00
|
|
|
atticmatic is a simple Python wrapper script for the [Attic backup
|
|
|
|
software](https://attic-backup.org/) that initiates a backup and prunes any
|
|
|
|
old backups according to a retention policy. The script supports specifying
|
|
|
|
your settings in a declarative configuration file rather than having to put
|
|
|
|
them all on the command-line, and handles common errors.
|
2014-10-31 06:34:03 +01:00
|
|
|
|
2014-11-26 01:01:59 +01:00
|
|
|
Here's an example config file:
|
|
|
|
|
|
|
|
[location]
|
|
|
|
# Space-separated list of source directories to backup.
|
|
|
|
source_directories: /home /etc
|
|
|
|
|
|
|
|
# Path to local or remote Attic repository.
|
|
|
|
repository: user@backupserver:sourcehostname.attic
|
|
|
|
|
|
|
|
[retention]
|
|
|
|
# Retention policy for how many backups to keep in each category.
|
|
|
|
keep_daily: 7
|
|
|
|
keep_weekly: 4
|
|
|
|
keep_monthly: 6
|
|
|
|
|
|
|
|
Additionally, exclude patterns can be specified in a separate excludes config
|
|
|
|
file, one pattern per line.
|
|
|
|
|
2014-12-02 05:22:49 +01:00
|
|
|
atticmatic is hosted at <https://torsion.org/atticmatic> with [source code
|
|
|
|
available](https://torsion.org/hg/atticmatic). It's also mirrored on
|
2014-12-02 04:49:25 +01:00
|
|
|
[GitHub](https://github.com/witten/atticmatic) and
|
|
|
|
[BitBucket](https://bitbucket.org/dhelfman/atticmatic) for convenience.
|
2014-11-19 03:32:16 +01:00
|
|
|
|
2014-10-31 06:34:03 +01:00
|
|
|
|
2014-11-27 18:29:31 +01:00
|
|
|
## Setup
|
2014-10-31 06:34:03 +01:00
|
|
|
|
2014-12-02 04:49:25 +01:00
|
|
|
To get up and running with Attic, follow the [Attic Quick
|
|
|
|
Start](https://attic-backup.org/quickstart.html) guide to create an Attic
|
2014-12-20 19:56:03 +01:00
|
|
|
repository on a local or remote host. Note that if you plan to run atticmatic
|
|
|
|
on a schedule with cron, and you encrypt your attic repository with a
|
|
|
|
passphrase instead of a key file, you'll need to set the `ATTIC_PASSPHRASE`
|
|
|
|
environment variable. See [attic's repository encryption
|
|
|
|
documentation](https://attic-backup.org/quickstart.html#encrypted-repos) for
|
|
|
|
more info.
|
2014-10-31 06:34:03 +01:00
|
|
|
|
|
|
|
If the repository is on a remote host, make sure that your local root user has
|
|
|
|
key-based ssh access to the desired user account on the remote host.
|
|
|
|
|
2014-12-02 04:49:25 +01:00
|
|
|
To install atticmatic, run the following command to download and install it:
|
2014-10-31 06:34:03 +01:00
|
|
|
|
2014-12-02 04:49:25 +01:00
|
|
|
sudo pip install hg+https://torsion.org/hg/atticmatic
|
2014-10-31 06:34:03 +01:00
|
|
|
|
|
|
|
Then copy the following configuration files:
|
|
|
|
|
2014-11-26 13:04:14 +01:00
|
|
|
sudo cp sample/atticmatic.cron /etc/cron.d/atticmatic
|
2014-11-27 05:15:21 +01:00
|
|
|
sudo mkdir /etc/atticmatic/
|
2014-10-31 06:34:03 +01:00
|
|
|
sudo cp sample/config sample/excludes /etc/atticmatic/
|
|
|
|
|
|
|
|
Lastly, modify those files with your desired configuration.
|
|
|
|
|
|
|
|
|
2014-11-27 18:29:31 +01:00
|
|
|
## Usage
|
2014-10-31 06:34:03 +01:00
|
|
|
|
|
|
|
You can run atticmatic and start a backup simply by invoking it without
|
|
|
|
arguments:
|
|
|
|
|
|
|
|
atticmatic
|
|
|
|
|
2014-11-26 01:01:59 +01:00
|
|
|
This will also prune any old backups as per the configured retention policy.
|
|
|
|
By default, the backup will proceed silently except in the case of errors. But
|
|
|
|
if you'd like to to get additional information about the progress of the
|
|
|
|
backup as it proceeds, use the verbose option instead:
|
2014-10-31 06:34:03 +01:00
|
|
|
|
|
|
|
atticmattic --verbose
|
|
|
|
|
|
|
|
If you'd like to see the available command-line arguments, view the help:
|
|
|
|
|
|
|
|
atticmattic --help
|
2014-11-18 03:35:47 +01:00
|
|
|
|
|
|
|
|
2014-11-27 18:29:31 +01:00
|
|
|
## Running tests
|
2014-11-18 06:57:44 +01:00
|
|
|
|
|
|
|
To install test-specific dependencies, first run:
|
|
|
|
|
2014-12-02 07:39:11 +01:00
|
|
|
sudo python setup.py test
|
2014-11-18 06:57:44 +01:00
|
|
|
|
|
|
|
To actually run tests, run:
|
|
|
|
|
|
|
|
nosetests --detailed-errors
|
|
|
|
|
|
|
|
|
2014-11-27 18:29:31 +01:00
|
|
|
## Feedback
|
2014-11-18 03:35:47 +01:00
|
|
|
|
2014-12-02 04:49:25 +01:00
|
|
|
Questions? Comments? Got a patch? Contact <mailto:witten@torsion.org>.
|