| 1 | = Backup tool that enhances the trac-admin hotcopy utility = |
| 2 | |
| 3 | == Description == |
| 4 | |
| 5 | 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. |
| 6 | |
| 7 | The script is derived from the 'hot-backup.py' script included in the Subversion distribution which provides similar tooling around Subversion's hotcopy utility. |
| 8 | |
| 9 | {{{ |
| 10 | USAGE: trac-hot-backup.py [OPTIONS] PROJECT_PATH BACKUP_PATH |
| 11 | |
| 12 | Create a backup of the project at PROJECT_PATH in a subdirectory of |
| 13 | the BACKUP_PATH location, named with the backup date and time. |
| 14 | |
| 15 | Options: |
| 16 | --archive-type=FMT Create an archive of the backup. FMT can be one of: |
| 17 | bz2 : Creates a bzip2 compressed tar file. |
| 18 | gz : Creates a gzip compressed tar file. |
| 19 | zip : Creates a compressed zip file. |
| 20 | --num-backups=N Number of prior backups to keep around (0 to keep all). |
| 21 | --help -h Print this help message and exit. |
| 22 | }}} |
| 23 | |
| 24 | |
| 25 | == Bugs/Feature Requests == |
| 26 | |
| 27 | Existing bugs and feature requests for TracHotBackupScript are |
| 28 | [report:9?COMPONENT=TracHotBackupScript here]. |
| 29 | |
| 30 | If you have any issues, create a |
| 31 | [http://trac-hacks.org/newticket?component=TracHotBackupScript&owner=kcalcagno new ticket]. |
| 32 | |
| 33 | == Download == |
| 34 | |
| 35 | Download the zipped source from [download:trachotbackupscript here]. |
| 36 | |
| 37 | == Source == |
| 38 | |
| 39 | You can check out TracHotBackupScript from [http://trac-hacks.org/svn/trachotbackupscript here] using Subversion, or [source:trachotbackupscript browse the source] with Trac. |
| 40 | |
| 41 | == Example == |
| 42 | |
| 43 | Back up the project at /var/trac/myproj to /nfs/backup/trac/myproj-YYYY-mm-dd-HHMM: |
| 44 | |
| 45 | {{{ |
| 46 | $ trac-hot-backup.py /var/trac/myproj /nfs/backup/trac |
| 47 | }}} |
| 48 | |
| 49 | Back up the project at /var/trac/myproj to /nfs/backup/trac/myproj-YYYY-mm-dd-HHMM.tar.gz and deletes all but the seven most recent backups (including the one just created): |
| 50 | |
| 51 | {{{ |
| 52 | $ trac-hot-backup.py --archive-type=gz --num-backups=7 /var/trac/myproj /nfs/backup/trac |
| 53 | }}} |
| 54 | |
| 55 | |
| 56 | == Recent Changes == |
| 57 | |
| 58 | [[ChangeLog(trachotbackupscript, 3)]] |
| 59 | |
| 60 | == Author/Contributors == |
| 61 | |
| 62 | '''Author:''' [wiki:kcalcagno] [[BR]] |
| 63 | '''Contributors:''' |