X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/5c4d9d38dcee73a7ffb6221c80f707c3924da64f..5fcca42249b8b35f50beb9ed4c51d090d76c1767:/doc/install/configure-fs-storage.html.textile.liquid?ds=sidebyside diff --git a/doc/install/configure-fs-storage.html.textile.liquid b/doc/install/configure-fs-storage.html.textile.liquid index ddd54c3f0c..ebf964a796 100644 --- a/doc/install/configure-fs-storage.html.textile.liquid +++ b/doc/install/configure-fs-storage.html.textile.liquid @@ -1,7 +1,7 @@ --- layout: default navsection: installguide -title: Filesystem storage +title: Configure filesystem storage ... {% comment %} Copyright (C) The Arvados Authors. All rights reserved. @@ -13,44 +13,60 @@ Keepstore can store data in local and network-attached POSIX filesystems. h2. Setting up filesystem mounts -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. - -
-Volumes: -- # The volume type, indicates this is a filesystem directory. - Type: Directory - - # The directory that will be used as the backing store. - Root: /mnt/local-disk - - # How much replication is performed by the underlying filesystem. - # (for example, a network filesystem may provide its own replication). - # This is used to inform replication decisions at the Keep layer. - DirectoryReplication: 1 - - # If true, do not accept write or trash operations, only reads. - ReadOnly: false - - # When true, read and write operations (for whole 64MiB blocks) on - # an individual volume will queued and issued serially. When - # false, read and write operations will be issued concurrently. - # - # May improve throughput if you experience contention when there are - # multiple requests to the same volume. - # - # When using SSDs, RAID, or a parallel network filesystem, you probably - # don't want this. - Serialize: false - - # Storage classes to associate with this volume. See "Storage - # classes" in the "Admin" section of doc.arvados.org. - StorageClasses: null - - # Example of a second volume section -- DirectoryReplication: 2 - ReadOnly: false - Root: /mnt/network-disk - Serialize: false - StorageClasses: null - Type: Directory -+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. + +{% include 'assign_volume_uuid' %} + +Note that each volume entry has an @AccessViaHosts@ section indicating which Keepstore instance(s) will serve that volume. In this example, keep0 and keep1 each have their own data disk. The @/mnt/local-disk@ directory on keep0 is volume @ClusterID-nyw5e-000000000000000@, and the @/mnt/local-disk@ directory on keep1 is volume @ClusterID-nyw5e-000000000000001@ . + +
Volumes:
+ ClusterID-nyw5e-000000000000000:
+ AccessViaHosts:
+ "http://keep0.ClusterID.example.com:25107": {}
+ Driver: Directory
+ DriverParameters:
+ # The directory that will be used as the backing store.
+ Root: /mnt/local-disk
+
+ # How much replication is performed by the underlying
+ # filesystem. (for example, a network filesystem may provide
+ # its own replication). This is used to inform replication
+ # decisions at the Keep layer.
+ Replication: 1
+
+ # If true, do not accept write or trash operations, only
+ # reads.
+ ReadOnly: false
+
+ # Storage classes to associate with this volume.
+ StorageClasses: null
+
+ ClusterID-nyw5e-000000000000001:
+ AccessViaHosts:
+ "http://keep1.ClusterID.example.com:25107": {}
+ Driver: Directory
+ DriverParameters:
+ Root: /mnt/local-disk
+
Volumes:
+ ClusterID-nyw5e-000000000000002:
+ 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://keep0.ClusterID.example.com:25107/": {}
+ "http://keep1.ClusterID.example.com:25107/": {ReadOnly: true}
+ Driver: Directory
+ DriverParameters:
+ Root: /mnt/network-attached-filesystem
+ Replication: 2
+