Merge branch 'master' of git.curoverse.com:arvados into 13330-cwl-intermediate-collec...
[arvados.git] / doc / install / configure-fs-storage.html.textile.liquid
1 ---
2 layout: default
3 navsection: installguide
4 title: Filesystem storage
5 ...
6 {% comment %}
7 Copyright (C) The Arvados Authors. All rights reserved.
8
9 SPDX-License-Identifier: CC-BY-SA-3.0
10 {% endcomment %}
11
12 Keepstore can store data in local and network-attached POSIX filesystems.
13
14 h2. Setting up filesystem mounts
15
16 Volumes are configured in the @Volumes@ section of the configuration file.  You may provide multiple volumes for a single keepstore process to manage multiple disks.  Keepstore distributes blocks among volumes in round-robin fashion.
17
18 <pre>
19 Volumes:
20 - # The volume type, indicates this is a filesystem directory.
21   Type: Directory
22
23   # The directory that will be used as the backing store.
24   Root: /mnt/local-disk
25
26   # How much replication is performed by the underlying filesystem.
27   # (for example, a network filesystem may provide its own replication).
28   # This is used to inform replication decisions at the Keep layer.
29   DirectoryReplication: 1
30
31   # If true, do not accept write or trash operations, only reads.
32   ReadOnly: false
33
34   # When true, read and write operations (for whole 64MiB blocks) on
35   # an individual volume will queued and issued serially.  When
36   # false, read and write operations will be issued concurrently.
37   #
38   # May improve throughput if you experience contention when there are
39   # multiple requests to the same volume.
40   #
41   # When using SSDs, RAID, or a parallel network filesystem, you probably
42   # don't want this.
43   Serialize: false
44
45   # Storage classes to associate with this volume.  See "Storage
46   # classes" in the "Admin" section of doc.arvados.org.
47   StorageClasses: null
48
49   # Example of a second volume section
50 - DirectoryReplication: 2
51   ReadOnly: false
52   Root: /mnt/network-disk
53   Serialize: false
54   StorageClasses: null
55   Type: Directory
56 </pre>