services/fuse/README.rst

   1 ========================
   2 Arvados Keep FUSE Driver
   3 ========================
   4
   5 Overview
   6 --------
   7
   8 This package provides a FUSE driver for Keep, the Arvados_ storage
   9 system.  It allows you to read data from your collections as if they
  10 were on the local filesystem.
  11
  12 .. _Arvados: https://arvados.org/
  13
  14 Installation
  15 ------------
  16
  17 Installing under your user account
  18 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  19
  20 This method lets you install the package without root access.
  21 However, other users on the same system won't be able to use it.
  22
  23 1. Run ``pip install --user arvados_fuse``.
  24
  25 2. In your shell configuration, make sure you add ``$HOME/.local/bin``
  26    to your PATH environment variable.  For example, you could add the
  27    command ``PATH=$PATH:$HOME/.local/bin`` to your ``.bashrc`` file.
  28
  29 3. Reload your shell configuration.  For example, bash users could run
  30    ``source ~/.bashrc``.
  31
  32 Installing on Debian systems
  33 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  34
  35 1. Add this Arvados repository to your sources list::
  36
  37      deb http://apt.arvados.org/ wheezy main
  38
  39 2. Update your package list.
  40
  41 3. Install the ``python-arvados-fuse`` package.
  42
  43 Configuration
  44 -------------
  45
  46 This driver needs two pieces of information to connect to
  47 Arvados: the DNS name of the API server, and an API authorization
  48 token.  You can set these in environment variables, or the file
  49 ``$HOME/.config/arvados/settings.conf``.  `The Arvados user
  50 documentation
  51 <http://doc.arvados.org/user/reference/api-tokens.html>`_ describes
  52 how to find this information in the Arvados Workbench, and install it
  53 on your system.
  54
  55 Testing and Development
  56 -----------------------
  57
  58 Debian packages you need to build llfuse:
  59
  60 $ apt-get install python-dev pkg-config libfuse-dev libattr1-dev
  61
  62 This package is one part of the Arvados source package, and it has
  63 integration tests to check interoperability with other Arvados
  64 components.  Our `hacking guide
  65 <https://arvados.org/projects/arvados/wiki/Hacking_Python_SDK>`_
  66 describes how to set up a development environment and run tests.