3 navsection: installguide
4 title: Configure filesystem storage
7 Copyright (C) The Arvados Authors. All rights reserved.
9 SPDX-License-Identifier: CC-BY-SA-3.0
12 Keepstore can store data in local and network-attached POSIX filesystems.
14 h2. Setting up filesystem mounts
16 Volumes are configured in the @Volumes@ section of the cluster 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.
18 {% include 'assign_volume_uuid' %}
20 Note that each volume has an AccessViaHosts section indicating that (for example) keep0's /mnt/local-disk directory is volume 0, while keep1's /mnt/local-disk directory is volume 1.
24 <span class="userinput">uuid_prefix</span>:
26 <span class="userinput">uuid_prefix</span>-nyw5e-<span class="userinput">000000000000000</span>:
28 "http://keep0.zzzzz.example.com:25107/": {}
31 # The directory that will be used as the backing store.
34 # When true, read and write operations (for whole 64MiB
35 # blocks) on an individual volume will queued and issued
36 # serially. When false, read and write operations will be
37 # issued concurrently.
39 # May improve throughput if you experience contention when
40 # there are multiple requests to the same volume.
42 # When using SSDs, RAID, or a shared network filesystem, you
43 # probably don't want this.
46 # How much replication is performed by the underlying
47 # filesystem. (for example, a network filesystem may provide
48 # its own replication). This is used to inform replication
49 # decisions at the Keep layer.
52 # If true, do not accept write or trash operations, only
56 # Storage classes to associate with this volume. See "Storage
57 # classes" in the "Admin" section of doc.arvados.org.
60 <span class="userinput">uuid_prefix</span>-nyw5e-<span class="userinput">000000000000001</span>:
62 "http://keep1.zzzzz.example.com:25107/": {}
66 </code></pre></notextile>
68 In the case of a network-attached filesystem accessible by all keepstore servers, the AccessViaHosts section is omitted.
72 <span class="userinput">uuid_prefix</span>:
74 # This volume is used by all keepstore servers.
75 <span class="userinput">uuid_prefix</span>-nyw5e-<span class="userinput">000000000000002</span>:
78 Root: /mnt/network-attached-filesystem
80 </code></pre></notextile>