rsync - Jan 2014 - Suggestion for "known issues and debugging" additional content

Hello,

?? First, I have to compliment the crew on the documentation.? It's solid.

??
 Running on Ubuntu 12.04.3, I was using rsync to synchronize a 5T 
filesystem across two servers.? The default Ubuntu configuration is to 
run rsync over ssh, conveniently the way I prefer it.

?? 
Initially, it would run for hours and copy 4T or so data.? Then as it 
began to progress further, perhaps using more RAM, the rsync job would 
run and copy some amount of data, then the client side (doing the pull) 
would throw this type of error:

rsync: connection unexpectedly closed (21313238038 bytes received so far)
[receiver]
rsync error: error in rsync protocol data stream (code 12) at io.c(605)
[receiver=3.0.9]
[receiver]
 _exit_cleanup(code=12, file=io.c, line=605): about to call exit(12)
rsync: connection unexpectedly closed (183 bytes received so far) [generator]
rsync error: unexplained error (code 255) at io.c(605) [generator=3.0.9]
[generator] _exit_cleanup(code=12, file=io.c, line=605): about to call exit(255)


It didn't take much searching to find the rsync troubleshooting page
http://rsync.samba.org/issues.htmlhttp://.? After reading that and spending a
few minutes looking around, I found this on the remote server during pulls:


Jan? 9 19:54:45 ubuntu kernel: [371329.296889] Out of memory: Kill process 11810
(rsync) score 2 or sacrifice child
Jan? 9 19:54:45 ubuntu kernel: [371329.296946] Killed process 11810 (rsync)
total-vm:66120kB, anon-rss:0kB, file-rss:4kB
Jan? 9 20:30:58 ubuntu kernel: [373501.815163] sshd invoked oom-killer:
gfp_mask=0x201da,
 order=0, oom_adj=0, oom_score_adj=0



Root cause: sshd was killing it's child rsync because the OS was out of 
RAM.? This may be an uncommon occurrence, but I thought I'd toss it into the
mix and let you decide if you want to include a tip covering this
cause of failure.? I only allocated 1G RAM to it because it's a VM.? I 
increased the RAM to 2G and - problem solved.? I would have seen it 
sooner if I was watching the console.


thanks for the awesome software.
?
-
The human mind is like Van Halen.  If you just pull out one piece and keep
replacing it, it just degenerates.
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
<http://lists.samba.org/pipermail/rsync/attachments/20140110/6b35cb85/attachment.html>