summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorGravatar Joey Hess <joey@kitenet.net>2014-07-08 12:47:16 -0400
committerGravatar Joey Hess <joey@kitenet.net>2014-07-08 12:47:16 -0400
commit85332b880d96b842071d767733f70f461a66a867 (patch)
tree1388afc5feaa22f5d7420a582c8c75758bbf90c1 /doc
parent8c61246c6877afee56e39463aebf37844078027a (diff)
parent262798061e4fcfea67e41d19dfed2ca2cd2503dc (diff)
Merge branch 'master' of ssh://git-annex.branchable.com
Diffstat (limited to 'doc')
-rw-r--r--doc/bugs/Assistant_doesn__39__t_check_if_it_can_drop_files.mdwn62
-rw-r--r--doc/bugs/Assistant_merge_loop/comment_3_07341221b2839fdc1c43634e011451d2._comment62
-rw-r--r--doc/bugs/Moved_files_are_not_picked_up_by_the_assistant_on_OS_X.mdwn22
-rw-r--r--doc/bugs/git-annex.app_doesn__39__t_seem_to_use_the_bundled_git.mdwn48
-rw-r--r--doc/bugs/git-annex.app_doesn__39__t_seem_to_use_the_bundled_git/comment_1_73924adc1c3c0dca5adce9a5e1740e48._comment10
-rw-r--r--doc/forum/Best_approach_for_central_sharing_and_multiple_users.mdwn8
-rw-r--r--doc/forum/Ssh_remote_on_NAS.mdwn34
-rw-r--r--doc/forum/performance_and_multiple_replication_problems/comment_5_8df6cc8b72e0e78c7380f7d471124498._comment12
-rw-r--r--doc/forum/update_via_cabal_fails.mdwn35
-rw-r--r--doc/todo/Faster___171__git_annex_status__187___when___171__git_annex_watch__187___is_running.mdwn5
10 files changed, 298 insertions, 0 deletions
diff --git a/doc/bugs/Assistant_doesn__39__t_check_if_it_can_drop_files.mdwn b/doc/bugs/Assistant_doesn__39__t_check_if_it_can_drop_files.mdwn
new file mode 100644
index 000000000..c789fb831
--- /dev/null
+++ b/doc/bugs/Assistant_doesn__39__t_check_if_it_can_drop_files.mdwn
@@ -0,0 +1,62 @@
+### Please describe the problem.
+
+The assistant/webapp doesn't drop files from the local (source) repository after transferring it to the 2 backup repositories (numcopies 2), but they are listed with:
+
+ git annex find --want-drop
+
+### What steps will reproduce the problem?
+
+#### mintcream ####
+
+ git init annex
+ cd ~/annex
+ git commit -m "create" --allow-empty
+ git annex init mintcream
+ git annex numcopies 2
+ git annex group here source
+ git config annex.autocommit false
+ git annex webapp
+
+#### liquorice ####
+
+ git init annex
+ cd ~/annex
+ git annex init liquorice
+ git annex group here backup
+
+#### candyfloss ####
+
+ git init annex
+ cd ~/annex
+ git annex init candyfloss
+ git annex group here backup
+
+#### mintcream ####
+
+ (add both backup repositories in webapp as "remote repositories")
+ (copy files into ~/annex directory)
+ git annex add
+ git commit -m "add some files"
+ (use "sync now" to prod assistant into noticing the commit)
+
+### What was I expecting to happen? ###
+
+The assistant to transfer the files to liquorice and candyfloss, then for the assistant to drop the files from mintcream.
+
+### What actually happened? ###
+
+The assistant transfers the files to liquorice and candyfloss. No files are dropped from mintcream.
+
+### What version of git-annex are you using? On what operating system?
+
+git-annex version: 5.20140707-g923b436
+
+Arch Linux (git-annex-bin from AUR)
+
+### Please provide any additional information below.
+
+I wish to retain control of the commits on "master" (annex.autocommit false) but want the assistant to handle moving/dropping the files as required in the background.
+
+ git annex drop --auto
+
+works as expected.
diff --git a/doc/bugs/Assistant_merge_loop/comment_3_07341221b2839fdc1c43634e011451d2._comment b/doc/bugs/Assistant_merge_loop/comment_3_07341221b2839fdc1c43634e011451d2._comment
new file mode 100644
index 000000000..1b6956483
--- /dev/null
+++ b/doc/bugs/Assistant_merge_loop/comment_3_07341221b2839fdc1c43634e011451d2._comment
@@ -0,0 +1,62 @@
+[[!comment format=mdwn
+ username="EskildHustvedt"
+ ip="80.202.103.55"
+ subject="comment 3"
+ date="2014-07-08T08:13:40Z"
+ content="""
+I'm still seeing this problem in 5.20140707-g923b436
+
+ [0 zerodogg@firefly annexed]$ git annex version
+ git-annex version: 5.20140707-g923b436
+ build flags: Assistant Webapp Webapp-secure Pairing Testsuite S3 WebDAV Inotify DBus DesktopNotify XMPP DNS Feeds Quvi TDFA CryptoHash
+ key/value backends: SHA256E SHA1E SHA512E SHA224E SHA384E SKEIN256E SKEIN512E SHA256 SHA1 SHA512 SHA224 SHA384 SKEIN256 SKEIN512 WORM URL
+ remote types: git gcrypt S3 bup directory rsync web webdav tahoe glacier ddar hook external
+ local repository version: 5
+ supported repository version: 5
+ upgrade supported from repository versions: 0 1 2 4
+ [0 zerodogg@firefly annexed]$ git graph | head -n20
+ * d4bf68f - (HEAD, annex/direct/master) merge refs/remotes/serenity/synced/master (3 minutes ago) <Eskild Hustvedt>
+ |\
+ * | d03f280 - merge refs/remotes/browncoats/synced/master (3 minutes ago) <Eskild Hustvedt>
+ |/
+ * e6863b8 - (serenity/synced/master, browncoats/synced/master) merge refs/remotes/serenity/synced/master (3 minutes ago) <Eskild Hustvedt>
+ |\
+ * \ 616d985 - merge refs/remotes/browncoats/synced/master (3 minutes ago) <Eskild Hustvedt>
+ |\ \
+ | |/
+ * | 3b39706 - merge refs/remotes/serenity/synced/master (3 minutes ago) <Eskild Hustvedt>
+ |\ \
+ | |/
+ * | 6d354cc - merge refs/remotes/browncoats/synced/master (4 minutes ago) <Eskild Hustvedt>
+ |\ \
+ | |/
+ * | 710c3c1 - merge refs/remotes/serenity/synced/master (4 minutes ago) <Eskild Hustvedt>
+ |\ \
+ | |/
+ * | 763930f - merge refs/remotes/browncoats/synced/master (4 minutes ago) <Eskild Hustvedt>
+ |/
+ [0 zerodogg@firefly annexed]$ git annex assistant --stop
+ [0 zerodogg@firefly annexed]$ git annex assistant
+ [0 zerodogg@firefly annexed]$ git graph | head -n20
+ * 947f1a2 - (HEAD, annex/direct/master) merge refs/remotes/serenity/synced/master (15 seconds ago) <Eskild Hustvedt>
+ |\
+ * | 19c6043 - merge refs/remotes/browncoats/synced/master (18 seconds ago) <Eskild Hustvedt>
+ |/
+ * b453741 - (serenity/synced/master, browncoats/synced/master) merge refs/remotes/serenity/synced/master (18 seconds ago) <Eskild Hustvedt>
+ |\
+ * \ 6baaebd - merge refs/remotes/browncoats/synced/master (18 seconds ago) <Eskild Hustvedt>
+ |\ \
+ | |/
+ * | 03e4fa2 - merge refs/remotes/serenity/synced/master (24 seconds ago) <Eskild Hustvedt>
+ |\ \
+ | |/
+ * | 33302d8 - merge refs/remotes/browncoats/synced/master (24 seconds ago) <Eskild Hustvedt>
+ |\ \
+ | |/
+ * | d4bf68f - merge refs/remotes/serenity/synced/master (4 minutes ago) <Eskild Hustvedt>
+ |\ \
+ | |/
+ * | d03f280 - merge refs/remotes/browncoats/synced/master (4 minutes ago) <Eskild Hustvedt>
+ |/
+ [0 zerodogg@firefly annexed]$
+"""]]
diff --git a/doc/bugs/Moved_files_are_not_picked_up_by_the_assistant_on_OS_X.mdwn b/doc/bugs/Moved_files_are_not_picked_up_by_the_assistant_on_OS_X.mdwn
new file mode 100644
index 000000000..9adce01c4
--- /dev/null
+++ b/doc/bugs/Moved_files_are_not_picked_up_by_the_assistant_on_OS_X.mdwn
@@ -0,0 +1,22 @@
+### Please describe the problem.
+
+On indirect repos on OS X, when a symlink is moved asisstant does not pick it up it. Even though assistant syncs after delete/move changes are not committed. git annex status returns ?? for the moved files. when I run git annex add on the files it says it added them but instead they still show up as ??. the only way to solve the problem is to manually restart the daemon which commits them.
+
+### What steps will reproduce the problem?
+
+Moving an annex file.
+
+
+### What version of git-annex are you using? On what operating system?
+
+5.20140703 g3cfcd54
+
+### Please provide any additional information below.
+
+[[!format sh """
+# If you can, paste a complete transcript of the problem occurring here.
+# If the problem is with the git-annex assistant, paste in .git/annex/daemon.log
+
+
+# End of transcript or log.
+"""]]
diff --git a/doc/bugs/git-annex.app_doesn__39__t_seem_to_use_the_bundled_git.mdwn b/doc/bugs/git-annex.app_doesn__39__t_seem_to_use_the_bundled_git.mdwn
new file mode 100644
index 000000000..87cb7ebec
--- /dev/null
+++ b/doc/bugs/git-annex.app_doesn__39__t_seem_to_use_the_bundled_git.mdwn
@@ -0,0 +1,48 @@
+### Please describe the problem.
+
+When trying to create a repository—i.e., running it for the first time—I get this error message:
+
+> user error (git ["--git-dir=(path)/.git","--work-tree=(path)","commit-tree","4b825dc642cb6eb9a060e54bf8d69288fbee4904","--no-gpg-sign"] exited 128)
+
+It _seems_ that it's because the bundled `git` executable isn't used, and instead `/usr/bin/git` is; and it's too old to support the `--no-gpg-sign` flag.
+
+
+### What steps will reproduce the problem?
+
+Run `git-annex.app` for the first time and give it a path.
+
+
+### What version of git-annex are you using? On what operating system?
+
+ $ /Applications/Git-Annex.app/Contents/MacOS/git-annex version
+ git-annex version: 5.20140707-gf0c48e8
+ build flags: Assistant Webapp Webapp-secure Pairing Testsuite S3 WebDAV FsEvents XMPP DNS Feeds Quvi TDFA CryptoHash
+ key/value backends: SHA256E SHA1E SHA512E SHA224E SHA384E SKEIN256E SKEIN512E SHA256 SHA1 SHA512 SHA224 SHA384 SKEIN256 SKEIN512 WORM URL
+ remote types: git gcrypt S3 bup directory rsync web webdav tahoe glacier ddar hook external
+
+
+### Please provide any additional information below.
+
+`…/.git/annex/daemon.log` doesn't exist
+
+ $ tree -a
+ .
+ ├── .DS_Store
+ └── .git
+ ├── HEAD
+ ├── annex
+ │   ├── index
+ │   ├── misctmp
+ │   ├── sentinal
+ │   └── sentinal.cache
+ ├── config
+ ├── hooks
+ │   └── pre-commit
+ ├── objects
+ │   ├── 4b
+ │   │   └── 825dc642cb6eb9a060e54bf8d69288fbee4904
+ │   ├── info
+ │   └── pack
+ └── refs
+ ├── heads
+ └── tags
diff --git a/doc/bugs/git-annex.app_doesn__39__t_seem_to_use_the_bundled_git/comment_1_73924adc1c3c0dca5adce9a5e1740e48._comment b/doc/bugs/git-annex.app_doesn__39__t_seem_to_use_the_bundled_git/comment_1_73924adc1c3c0dca5adce9a5e1740e48._comment
new file mode 100644
index 000000000..888ef1e4a
--- /dev/null
+++ b/doc/bugs/git-annex.app_doesn__39__t_seem_to_use_the_bundled_git/comment_1_73924adc1c3c0dca5adce9a5e1740e48._comment
@@ -0,0 +1,10 @@
+[[!comment format=mdwn
+ username="http://joeyh.name/"
+ ip="209.250.56.55"
+ subject="comment 1"
+ date="2014-07-08T16:44:32Z"
+ content="""
+No, it's using it, it seems the version of git in the OSX build does not support that option.
+
+I am going to fix the version problem, and update yesterday's OSX release with the fix.
+"""]]
diff --git a/doc/forum/Best_approach_for_central_sharing_and_multiple_users.mdwn b/doc/forum/Best_approach_for_central_sharing_and_multiple_users.mdwn
new file mode 100644
index 000000000..6fc104cb8
--- /dev/null
+++ b/doc/forum/Best_approach_for_central_sharing_and_multiple_users.mdwn
@@ -0,0 +1,8 @@
+Just a quick question: Can anyone recomment me a good to handle a centralized repository which is used by different users?
+
+Requirements: must work in direct mode on both sides, server is Linux, clients are Windows and operated by 2 different users.
+
+- Should the repository create bare or not?
+- Must the repository created on the server or can it also be "pushed" from one client to the server (via SSH on the server)?
+- Is there a better way for data transfer than SSH (WebDAV as in SVN)? I am still struggling with an elegant way to handle public keys in windows
+- What is the best way to not only keep meta data in sync but also the data each of the users has checked out?
diff --git a/doc/forum/Ssh_remote_on_NAS.mdwn b/doc/forum/Ssh_remote_on_NAS.mdwn
new file mode 100644
index 000000000..27bca5a51
--- /dev/null
+++ b/doc/forum/Ssh_remote_on_NAS.mdwn
@@ -0,0 +1,34 @@
+Hello,
+
+I finally have git annex working on my NAS (QNAP TS-119P II) thanks to the stand-alone arm pre-build package.
+
+I've just extracted all the files on my NAS and I've linked all the exec files from the git-annex.linux folder to links placed in a path folder, so that I can run git annex everywhere on the NAS.
+
+ [~] # git annex version
+ git-annex version: 5.20140528-g92a0591
+ build flags: Assistant Webapp Webapp-secure Pairing Testsuite S3 WebDAV Inotify DBus DesktopNotify XMPP DNS Feeds Quvi TDFA CryptoHash
+ key/value backends: SHA256E SHA1E SHA512E SHA224E SHA384E SKEIN256E SKEIN512E SHA256 SHA1 SHA512 SHA224 SHA384 SKEIN256 SKEIN512 WORM URL
+ remote types: git gcrypt S3 bup directory rsync web webdav tahoe glacier ddar hook external
+
+Now I'm trying to set it up as an SSH remote of my laptop repository, but I get this error:
+
+ git clone ssh://admin@nas:/share/HDA_DATA/myDir ./
+ Cloning into '.'...
+ admin@nas's password:
+ sh: git-upload-pack: command not found
+ fatal: Could not read from remote repository.
+
+ Please make sure you have the correct access rights
+ and the repository exists.
+
+I've checked that git-upload-pack is available both on my laptop and on the NAS and the "myDir" folder is supposed to be readable for the admin user on the NAS, even if the user I use on the laptop and on the NAS for git annex is different from the one I use to login. In fact, if I try to scp files from the annex folder then I don't get any permissions error.
+
+ scp admin@192.168.132.66:/share/HDA_DATA/myDir/* ./
+ admin@192.168.132.66's password:
+ doctest 100% 5 0.0KB/s 0.0KB/s 00:00
+ doctest2 100% 51 0.1KB/s 0.1KB/s 00:01
+
+Is there something else I should look at, in order to fix it and make it work?
+
+Thanks,
+Fabio
diff --git a/doc/forum/performance_and_multiple_replication_problems/comment_5_8df6cc8b72e0e78c7380f7d471124498._comment b/doc/forum/performance_and_multiple_replication_problems/comment_5_8df6cc8b72e0e78c7380f7d471124498._comment
new file mode 100644
index 000000000..f881942f9
--- /dev/null
+++ b/doc/forum/performance_and_multiple_replication_problems/comment_5_8df6cc8b72e0e78c7380f7d471124498._comment
@@ -0,0 +1,12 @@
+[[!comment format=mdwn
+ username="zardoz"
+ ip="134.147.14.84"
+ subject="comment 5"
+ date="2014-07-08T12:26:58Z"
+ content="""
+Something to keep in mind for some point in the future: btrfs supports an efficient method by which one can inquire exactly which files have changed since a specified point in time, where the point in time is measured by a unit called «generation».
+
+A program can request the current «generation» index, and later ask btrfs which files have changed after that index, without needing to walk the file-system. This is currently implemented in the user-space program «btrfs filesystem find-new». While it’s called «find-new», this not only find newly created files, but also changed files.
+
+Currently, it seems one needs to be super-user to use «find-new», because it lists changed files for complete subvolumes, but since generations are stored per-file, in the future there will likely be a user-space method for regular users.
+"""]]
diff --git a/doc/forum/update_via_cabal_fails.mdwn b/doc/forum/update_via_cabal_fails.mdwn
new file mode 100644
index 000000000..aae8461c6
--- /dev/null
+++ b/doc/forum/update_via_cabal_fails.mdwn
@@ -0,0 +1,35 @@
+I tried to update git-annex via cabal. It fails due to lens not installing:
+
+ juh@sokrates:~$ cabal update
+ Downloading the latest package list from hackage.haskell.org
+ juh@sokrates:~$ cabal install git-annex
+ Resolving dependencies...
+ In order, the following will be installed:
+ lens-4.2 (new version)
+ DAV-0.6.2 (reinstall) changes: http-client-0.3.1.1 -> 0.3.3.1,
+ http-client-tls-0.2.1.1 added, http-types-0.8.4 -> 0.8.5, lens-4.1.2 -> 4.2,
+ network-2.4.1.2 added, optparse-applicative-0.7.0.2 added, xml- conduit-1.2.0.1
+ -> 1.2.0.2, xml-hamlet-0.4.0.8 added
+ git-annex-5.20140707 (new package)
+ Warning: Note that reinstalls are always dangerous. Continuing anyway...
+ [1 of 1] Compiling Main ( /tmp/lens-4.2-3107/lens-4.2/Setup. lhs, /tmp/lens-4.2-3107/lens-4.2/dist/setup/Main.o )
+ Linking /tmp/lens-4.2-3107/lens-4.2/dist/setup/setup ...
+ Configuring lens-4.2...
+ Building lens-4.2...
+ Preprocessing library lens-4.2...
+
+ src/Control/Lens/Internal/Zoom.hs:47:8:
+ Could not find module `Control.Monad.Trans.Except'
+ Perhaps you meant
+ Control.Monad.Trans.Cont (from transformers-0.3.0.0)
+ Control.Monad.Trans.Error (from transformers-0.3.0.0)
+ Control.Monad.Trans.List (from transformers-0.3.0.0)
+ Use -v to see a list of the files searched for.
+ Failed to install lens-4.2
+ cabal: Error: some packages failed to install:
+ DAV-0.6.2 depends on lens-4.2 which failed to install.
+ git-annex-5.20140707 depends on lens-4.2 which failed to install.
+ lens-4.2 failed during the building phase. The exception was:
+ ExitFailure 1
+
+I am not an experienced user of cabal. So any hints to solve the conflicts are appreciated.
diff --git a/doc/todo/Faster___171__git_annex_status__187___when___171__git_annex_watch__187___is_running.mdwn b/doc/todo/Faster___171__git_annex_status__187___when___171__git_annex_watch__187___is_running.mdwn
new file mode 100644
index 000000000..7f7a482b9
--- /dev/null
+++ b/doc/todo/Faster___171__git_annex_status__187___when___171__git_annex_watch__187___is_running.mdwn
@@ -0,0 +1,5 @@
+I’m just experimenting with git-annex on a repo of ~150k files in about the same number of directories (WORM-backend). Calling, e.g., «git annex status» will take several minutes while stat()-ing all the files (for changes, I presume).
+
+This might already be on you todo list, but I was wondering whether it is possible to increase the performance of «annex status» (or related commands) when «annex watch» is running in the background. In that case, «status» could rely on cached data built-up at some point during initialization, plus based on the data that was accumulated via inotify. (Hopefully, all this won’t even be needed anymore on btrfs at some point in the future.)
+
+(I’m not very knowledgable in these things, so just out of curiosity: I noticed that, even though the «status» invocation takes ages, no HDD activity occurs and all the metadata is probably already in the Linux caches from a run I conducted immediately beforehand. Why do you figure that is? Is context switching so hugely expensive?)