From b755d09b0a01ceb5cf47530f45ddead518a018f0 Mon Sep 17 00:00:00 2001 From: Dan Helfman Date: Sat, 28 Feb 2015 11:03:22 -0800 Subject: [PATCH] Added a troubleshooting section with steps to deal with broken pipes. --- NEWS | 4 ++++ README.md | 21 +++++++++++++++++++++ 2 files changed, 25 insertions(+) diff --git a/NEWS b/NEWS index 93d33a5..0d2cb0e 100644 --- a/NEWS +++ b/NEWS @@ -1,3 +1,7 @@ +0.0.4-dev + + * Added a troubleshooting section with steps to deal with broken pipes. + 0.0.3 * After pruning, run attic's consistency checks on all archives. diff --git a/README.md b/README.md index 99b8a56..d289369 100644 --- a/README.md +++ b/README.md @@ -94,6 +94,27 @@ To actually run tests, run: nosetests --detailed-errors +## Troubleshooting + +### Broken pipe with remote repository + +When running atticmatic on a large remote repository, you may receive errors +like the following, particularly while "attic check" is valiating backups for +consistency: + + Write failed: Broken pipe + attic: Error: Connection closed by remote host + +This error can be caused by an ssh timeout, which you can rectify by adding +the following to the ~/.ssh/config file on the client: + + Host * + ServerAliveInterval 120 + +This should make the client keep the connection alive while validating +backups. + + ## Feedback Questions? Comments? Got a patch? Contact .