How to install collective.recipe.rsync
- Download and install ActivePython
- Open Command Prompt
- Type
pypm install collective.recipe.rsync
Lastest release
collective.recipe.rsync is a zc.buildout recipe that copies files between two locations via the rsync program.
Note
collective.recipe.rsync currently assumes you have a UNIX-based operating system and that the rsync binary is in your path when you execute buildout or the rsync script. Ideas for Windows support are welcome.
Installation
Add a section to your buildout.cfg file, e.g.:
[buildout] http://build.pythonpackages.com/buildout/plone/latest parts += rsync [rsync] recipe = collective.recipe.rsync source = remotehost:/path/to/Data.fs target = ${buildout:directory}/var/filestorage/Data.fs
This copies a Data.fs file from remotehost to var/filestorage/Data.fs relative to the buildout root.
Specify alternate SSH port
Optionally you may specify an alternate SSH port for rsync to use:
[rsync] recipe = collective.recipe.rsync source = remotehost:/path/to/Data.fs target = ${buildout:directory}/var/filestorage/Data.fs port = 22000
This copies a Data.fs file from remotehost to var/filestorage/Data.fs using port 22000.
Create a script
Normally collective.recipe.rsync will run rsync during the recipe installation. Optionally you can create a script to execute rsync later by configuring the script = true option:
[rsync] recipe = collective.recipe.rsync source = remotehost:/path/to/Data.fs target = ${buildout:directory}/var/filestorage/Data.fs script = true
This is useful in cases where you want to automate an rsync script with cron e.g. via z3c.recipe.usercrontab.
Changelog
2.1.0 (2012-04-09)
- Clean up package [aclark]
2.0.0 (2011-05-24)
- Don't prefix scripts with "rsync-"
1.9 (2011-04-12)
- Call install on update
- UI tweaks
1.8 (2011-03-29)
- Switched to using subprocess to call rsync (to show progress to stdout) [mattss]
- Replace print statements with logger [aclark]
- Update docs
1.7 (2011-01-21)
- Doc fixes
- Make script name based on section name
- Support more than one script in the same buildout
1.6 (2011-01-20)
- Add script option
- Generates bin/rsync script
- Disables rsync during buildout execution
- Facilitates creation of scheduled rsyncs via cron
1.5 (2011-01-10)
- Doc fixes
- Add a note about UNIX compat only
1.4 (2011-01-10)
- Support alternate ssh port parameter in recipe section. This allows collective.recipe.rsync to execute rsync with: -e 'ssh <port>', which facilitates copying over non-standard ssh ports.
1.3 (2010-12-19)
- Fix docs
1.2 (2010-12-19)
- Fix docs
- Add new test harness
- Clean up package
1.1 (2010-11-05)
- Modified output to include rsync command line being executed
1.0 (2010-02-28)
- Rename package from collective.recipe.rsync_datafs to collective.recipe.rsync
0.1 (2009-08-26)
- Created recipe with ZopeSkel