rsync Backups

• Using rsync for backups
  • Project web and developer web
  • New SourceForge Project SCMs
  • Classic Project SCMs
    • CVS
    • Subversion
  • Git, Bazaar, Mercurial

Using rsync for backups

SourceForge.net provides read-only rsync access to a number of service offerings to enable self-service backups of project data. rsync is the preferred tool for making backups, since it provides great flexibility, supports resume of failed transfers, and is optimized for efficient data transfer.

rsync clients are available for all modern Operating System platforms. Linux, BSD and Mac OS X users typically already have rsync installed, since it is typically included with the Operating System. MS Windows users can obtain rsync from the Cygwin project.

Project web and developer web

Read-write rsync access to project web and developer web content is available to project developers using our file management service.

New SourceForge Project SCMs

SCM repository contents may be accessed (read-only) by the project team and end-users using using rsync.

rsync may be used to copy an entire project repository as follows:

$ rsync -av SCM.code.sf.net::p/PROJECTNAME/MOUNTPOINT[.git] .

• Replace SCM, with the scm type (svn, git, or hg)
• Replace PROJECTNAME with the project's UNIX name
• Replace MOUNTPOINT with the repository's mount point (default is 'code')
• If (and only if) you're backing a git repo, add .git to the path

For example, if I wanted to rsync the git repository for the allura project, with the mountpoint 'git', I'd use the following command:

$ rsync -av git.code.sf.net::p/allura/git.git .

Classic Project SCMs

CVS

CVS repository contents may be accessed (read-only) by the project team and end-users using rsync.

rsync may be used to copy an entire project repository (replace PROJECTNAME with the UNIX group name of the project) as follows:

$ rsync -av PROJECTNAME.cvs.sourceforge.net::cvsroot/PROJECTNAME/* .

We do not permit access to the whole cvsroot module (i.e. to copy every project repository we host all at once) for sake of performance. Access is provided on a per-project basis instead.

To restore CVS data, make use of the adminrepo command with our interactive shell service.

Subversion

Subversion repository contents may be accessed (read-only) by the project team and end-users using rsync.

rsync may be used to copy an entire project repository (replace PROJECTNAME with the UNIX group name of the project) as follows:

$ rsync -av PROJECTNAME.svn.sourceforge.net::svn/PROJECTNAME/* .

We do not permit access to the whole svn module (i.e. to copy every project repository we host all at once) for sake of performance. Access is provided on a per-project basis instead.

To restore Subversion data, make use of our Subversion import facility.

Git, Bazaar, Mercurial

rsync can also be used to backup Git, Bazaar, and Mercurial repositories.