From NAS-Central Buffalo - The Linkstation Wiki

Revision as of 01:52, 5 January 2007 (view source) Rappazzo (Talk | contribs) ← Older edit		Revision as of 01:55, 5 January 2007 (view source) Rappazzo (Talk | contribs) (→Examples) Newer edit →
Line 50:		Line 50:
	=Examples=		=Examples=
-	*Create a backup with todays date (formatted yyyy-mm-dd)	+	*Create a backup named with todays date (formatted yyyy-mm-dd)
	rsync -a /SOURCE/ /DEST/`date +%Y-%m-%d`/		rsync -a /SOURCE/ /DEST/`date +%Y-%m-%d`/

---

Revision as of 01:55, 5 January 2007

Contents 1 Background 2 Installation 2.1 Compile from source 2.2 Raw Binaries 2.2.1 PowerPC 2.3 FreeLink 2.4 OpenLink (Ipkg) 2.4.1 PowerPC 2.4.2 MIPSel 3 Examples 4 References

Background

rsync^[1] is a free software computer program for Unix systems which synchronizes files and directories from one location to another while minimizing data transfer using delta encoding when appropriate. An important feature of rsync not found in most similar programs/protocols is that the mirroring takes place with only one transmission in each direction.^{[2] [3]}

rsync can copy or display directory contents and copy files, optionally using compression and recursion.

rsyncd, the rsync protocol daemon, uses the default TCP port of 873. rsync can also be used to synchronize local directories, or via a remote shell such as RSH or SSH. In the latter case, the rsync client executable must be installed on the near as well as the far host (the computer running the remote shell daemon). There also exists a utility called rdiff^[4], which can be used for incremental backups.

The Mac OS X filesystem has a special version, rsyncX^[5][6], which allow transferring resource forks. To run rsync on Microsoft Windows, the Cygwin package is necessary^[7] to provide the expected system interfaces. A package combination is available that include rsync, cygwin, and an installer, making it easier and more familiar to Windows users^[8].

There are several well written tutorials on using rsync^{[9][10][11][12]}

Installation

Compile from source

On any distribution FreeLink or OpenLink

1. Make sure you have installed the Precompiled C development environment, running on the LS first.
2. Get the source, make and install.

wget http://samba.org/ftp/rsync/rsync-2.6.9.tar.gz 
tar xfzv rsync-2.6.9.tar.gz 
cd rsync-2.6.9
./configure 
make 
su root 
make install

Raw Binaries

PowerPC

From the Yahoo! Linkstation General Group ^[13]

wget http://ls.jcedata.net/rsync
chmod a+x rsync
cp rsync /usr/bin

FreeLink

Use apt-get to install rsync

apt-get install rsync

OpenLink (Ipkg)

PowerPC

• Install Ipkg on the Linkstation (for end-users) and enable the NSLU2 Feed: Ipkg Package List: PowerPC
• Install rsync

ipkg install rsync

MIPSel

Alexander Skwar has created a fairly extensive selection of Ipkg packages for the MIPSel (LS2) LinkStation, Install Ipkg and enable his feed:

• Ipkg on the Linkstation (for end-users)
• Experimental "unstable" ipk Packages for the MIPSEL Linkstation
• Install rsync

ipkg install rsync

Examples

• Create a backup named with todays date (formatted yyyy-mm-dd)

rsync -a /SOURCE/ /DEST/`date +%Y-%m-%d`/

• A script to create a backup, named by date, which will save space by creating hard links to files which are already backed up. It requires a symbolic link to the most recently created backup dir (similar to the last line of the script)

#!/bin/sh
BACKUP_DATE=`date +%Y-%m-%d`
rsync -a --delete --link-dest=/DEST/most-recent-backup /SOURCE/ /DEST/$BACKUP_DATE/
rm /BACKUP/most-recent-backup
ln -s /DEST/$BACKUP_DATE /DEST/most-recent-backup

References

1. ↑ Wikipedia: rsync
2. ↑ rsync homepage
3. ↑ rsync algorithm
4. ↑ rdiff-backup homepage
5. ↑ RsyncX - Frontend for rsync under Mac OS X
6. ↑ Fixing rsync on MacOS X 10.4 (Tiger) - http://www.onthenet.com.au/~q/rsync/
7. ↑ Rsync for Windows - using Cygwin
8. ↑ NasBackup rsync Windows GUI
9. ↑ Tutorial: Using rsync
10. ↑ Tutorial: Mirroring with rsync
11. ↑ Tutorial: Backing up files with rsync
12. ↑ Tutorials (with screenshots) for setup of Rsync on Windows, Rsync on Linux/Unix/BSD and Rsync on Mac OS X
13. ↑ From the Yahoo! Linkstation General Group: rsync binaries anyone / SSH without password as root INTO LinkStation

This article is currently a stub. You can help this Wiki by expanding it . This template will categorize articles that include it into Category:Stubs.