summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorGravatar Joey Hess <joey@kitenet.net>2012-11-24 16:30:15 -0400
committerGravatar Joey Hess <joey@kitenet.net>2012-11-24 16:30:15 -0400
commita00262011dc7f4ccac8c5c40d845224c281c56b2 (patch)
treee59997bf6b311fdfdd0ba80d864864c40e78484b /doc
parentac4be3de323345ab4a6cb4a624b975ac686cc2d5 (diff)
webapp and assistant glacier support
Diffstat (limited to 'doc')
-rw-r--r--doc/assistant.mdwn2
-rw-r--r--doc/assistant/repogroup.pngbin0 -> 10986 bytes
-rw-r--r--doc/bugs/glacier_with_assistant_bugs.mdwn7
-rw-r--r--doc/design/assistant/transfer_control.mdwn3
-rw-r--r--doc/preferred_content.mdwn23
5 files changed, 21 insertions, 14 deletions
diff --git a/doc/assistant.mdwn b/doc/assistant.mdwn
index 549434207..003269817 100644
--- a/doc/assistant.mdwn
+++ b/doc/assistant.mdwn
@@ -35,6 +35,8 @@ interface to add repositories and control the git-annex assistant.
Follow the [[pairing_walkthrough]].
* Want to share a synchronised folder with a friend?
Follow the [[share_with_a_friend_walkthrough]].
+* Want to archive data to a drive or the cloud?
+ Follow the [[archival_walkthrough]]
## command line startup
diff --git a/doc/assistant/repogroup.png b/doc/assistant/repogroup.png
new file mode 100644
index 000000000..ac5aabd89
--- /dev/null
+++ b/doc/assistant/repogroup.png
Binary files differ
diff --git a/doc/bugs/glacier_with_assistant_bugs.mdwn b/doc/bugs/glacier_with_assistant_bugs.mdwn
index 4605a03b2..59f9118be 100644
--- a/doc/bugs/glacier_with_assistant_bugs.mdwn
+++ b/doc/bugs/glacier_with_assistant_bugs.mdwn
@@ -1,8 +1,3 @@
-When a file is moved to an archive directory, the assistant uploads it to
-glacier correctly, but then fails to drop it locally, unless it was
-started with `--trust-glacier`.
-
-Since it just uploaded the file, it should be able to drop it, without
-needing to trust glacier's inventory. Note that `git annex move` works.
+Need to handle retrying downloads of files from glacier after 4 hours.
[[!tag /design/assistant]]
diff --git a/doc/design/assistant/transfer_control.mdwn b/doc/design/assistant/transfer_control.mdwn
index ad5578c50..c21c4a170 100644
--- a/doc/design/assistant/transfer_control.mdwn
+++ b/doc/design/assistant/transfer_control.mdwn
@@ -19,6 +19,9 @@ something smart with such remotes.
log is not updated in time, it will fail to drop unwanted content.
(There's a 10 second sleep there now to avoid the race, but that's hardly
a fix.)
+* When a file is renamed into an archive directory, it's not immediately
+ transferred to archive remotes. (Next expensive scan does successfully
+ cause the transfer to happen).
### dropping no longer preferred content
diff --git a/doc/preferred_content.mdwn b/doc/preferred_content.mdwn
index ac2cd1ecf..499cf628e 100644
--- a/doc/preferred_content.mdwn
+++ b/doc/preferred_content.mdwn
@@ -92,7 +92,7 @@ to "standard", and put it in one of these groups:
All content is preferred, unless it's in a "archive" directory.
-`exclude=*/archive/*`
+`exclude=*/archive/* and exclude=archive/*`
### transfer
@@ -104,7 +104,7 @@ USB drive used in a sneakernet.
The preferred content expression for these causes them to get and retain
data until all clients have a copy.
-`not (inallgroup=client and copies=client:2) and exclude=*/archive/*`
+`not (inallgroup=client and copies=client:2) and exclude=*/archive/* and exclude=archive/*`
The "copies=client:2" part of the above handles the case where
there is only one client repository. It makes a transfer repository
@@ -112,17 +112,24 @@ speculatively prefer content in this case, even though it as of yet
has nowhere to transfer it to. Presumably, another client repository
will be added later.
-### archive
+### backup
+
+All content is preferred.
+
+### small archive
+
+Only prefers content that's located in an "archive" directory, and
+only if it's not already been archived somewhere else.
+
+`(include=*/archive/* or include=archive/*) and not (copies=archive:1 or copies=smallarchive:1)`
+
+### full archive
All content is preferred, unless it's already been archived somewhere else.
-`not copies=archive:1`
+`not (copies=archive:1 or copies=smallarchive:1)`
Note that if you want to archive multiple copies (not a bad idea!),
you should instead configure all your archive repositories with a
version of the above preferred content expression with a larger
number of copies.
-
-### backup
-
-All content is preferred.