---
layout: default
navsection: installguide
-title: Filesystem storage
+title: Configure filesystem storage
...
{% comment %}
Copyright (C) The Arvados Authors. All rights reserved.
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.
-Note that each volume has a UUID, like "zzzzz-nyw5e-0123456789abcde". You can assign these manually, but once assigned they should not be changed.
+{% include 'assign_volume_uuid' %}
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.
Volumes:
<span class="userinput">uuid_prefix</span>-nyw5e-<span class="userinput">000000000000000</span>:
AccessViaHosts:
- "http://keep0.zzzzz.example.com:25107/": {}
+ "http://<span class="userinput">keep0.uuid_prefix.example.com</span>:25107": {}
Driver: Directory
DriverParameters:
# The directory that will be used as the backing store.
<span class="userinput">uuid_prefix</span>-nyw5e-<span class="userinput">000000000000001</span>:
AccessViaHosts:
- "http://keep1.zzzzz.example.com:25107/": {}
+ "http://keep1.<span class="userinput">uuid_prefix</span>.example.com:25107": {}
Driver: Directory
DriverParameters:
Root: /mnt/local-disk
</code></pre></notextile>
-In the case of a network-attached filesystem accessible by all keepstore servers, the AccessViaHosts section is omitted.
+In the case of a network-attached filesystem, the AccessViaHosts section can have multiple entries. If the filesystem is accessible by all keepstore servers, the AccessViaHosts section can be empty, or omitted entirely.
<notextile>
<pre><code>Clusters:
<span class="userinput">uuid_prefix</span>:
Volumes:
- # This volume is used by all keepstore servers.
<span class="userinput">uuid_prefix</span>-nyw5e-<span class="userinput">000000000000002</span>:
+ AccessViaHosts:
+ # This section determines which keepstore servers access the
+ # volume. In this example, keep0 has read/write access, and
+ # keep1 has read-only access.
+ #
+ # If the AccessViaHosts section is empty or omitted, all
+ # keepstore servers will have read/write access to the
+ # volume.
+ "http://<span class="userinput">keep0.uuid_prefix.example.com</span>:25107/": {}
+ "http://<span class="userinput">keep1.uuid_prefix.example.com</span>:25107/": {ReadOnly: true}
Driver: Directory
DriverParameters:
Root: /mnt/network-attached-filesystem