doc/user/tutorials/tutorial-keep-mount.html.textile.liquid

   1 ---
   2 layout: default
   3 navsection: userguide
   4 title: "Mounting Keep as a filesystem"
   5 ...
   6
   7 This tutoral describes how to use @arv-mount@ to mount Keep as a read-only file system access it using traditional filesystem tools.
   8
   9 @arv-mount@ provides several features:
  10
  11 * You can browse, open and read Keep entries as if they are regular files.
  12 * It is easy for existing tools to access files in Keep.
  13 * Data is downloaded on demand.  It is not necessary to download an entire file or collection to start processing.
  14
  15 {% include 'tutorial_expectations' %}
  16
  17 The default mode permits browsing any collection in Arvados as a subdirectory under the mount directory.  To avoid having to fetch a potentially very large list of all collections, collection directories only come into existence when explicitly accessed by their keep locator.
  18
  19 <notextile>
  20 <pre><code>~$ <span class="userinput">mkdir -p keep</span>
  21 ~$ <span class="userinput">arv-mount keep</span>
  22 ~$ <span class="userinput">cd keep/c1bad4b39ca5a924e481008009d94e32+210</span>
  23 ~/keep/c1bad4b39ca5a924e481008009d94e32+210$ <span class="userinput">ls</span>
  24 var-GS000016015-ASM.tsv.bz2
  25 ~/keep/c1bad4b39ca5a924e481008009d94e32+210$ <span class="userinput">md5sum var-GS000016015-ASM.tsv.bz2</span>
  26 44b8ae3fde7a8a88d2f7ebd237625b4f  var-GS000016015-ASM.tsv.bz2
  27 ~/keep/c1bad4b39ca5a924e481008009d94e32+210$ <span class="userinput">cd ../..</span>
  28 ~$ <span class="userinput">fusermount -u keep</span>
  29 </code></pre>
  30 </notextile>