= Backup tool that enhances the trac-admin hotcopy utility

== Description

This plugin is a script that provides some additional tooling around TracAdmin's hotcopy function. The script supports archiving the backup in '''gzip''', '''bzip2''' or '''zip''' format and can be configured to retain a specified number of past backups. Ideal for use as a cron job.

The script is derived from the 'hot-backup.py' script included in the Subversion distribution which provides similar tooling around Subversion's hotcopy utility.

{{{
USAGE: trac-hot-backup.py [OPTIONS] PROJECT_PATH BACKUP_PATH

Create a backup of the project at PROJECT_PATH in a subdirectory of
the BACKUP_PATH location, named with the backup date and time.

Options:
  --archive-type=FMT Create an archive of the backup. FMT can be one of:
                       bz2 : Creates a bzip2 compressed tar file.
                       gz  : Creates a gzip compressed tar file.
                       zip : Creates a compressed zip file.
  --num-backups=N    Number of prior backups to keep around (0 to keep all).
  --help      -h     Print this help message and exit.
}}}


== Bugs/Feature Requests

Existing bugs and feature requests for TracHotBackupScript are 
[report:9?COMPONENT=TracHotBackupScript here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=TracHotBackupScript&owner=kcalcagno new ticket].

[[TicketQuery(component=TracHotBackupScript&group=type,format=progress)]]

== Download

Download the zipped source from [download:trachotbackupscript here], or just grab the script itself [http://trac-hacks.org/svn/trachotbackupscript/anyrelease/trac-hot-backup.py here].

== Source

You can check out TracHotBackupScript from [http://trac-hacks.org/svn/trachotbackupscript/anyrelease here] using Subversion, or [source:trachotbackupscript/anyrelease browse the source] with Trac.

== Examples

Back up the project at /var/trac/myproj to /nfs/backup/trac/myproj-YYYY-mm-dd-HHMM:

{{{
#!sh
trac-hot-backup.py /var/trac/myproj /nfs/backup/trac
}}}

Back up the project at /var/trac/myproj to /nfs/backup/trac/myproj-YYYY-mm-dd-HHMM.tar.gz and delete all but the seven most recent backups, including the one just created:

{{{
#!sh
trac-hot-backup.py --archive-type=gz --num-backups=7 /var/trac/myproj /nfs/backup/trac
}}}

== Recent Changes

[[ChangeLog(trachotbackupscript, 3)]]

== Author/Contributors

'''Author:''' [wiki:kcalcagno] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''