13647: Fixup docs.
authorTom Clegg <tclegg@veritasgenetics.com>
Tue, 10 Sep 2019 20:37:05 +0000 (16:37 -0400)
committerTom Clegg <tclegg@veritasgenetics.com>
Tue, 10 Sep 2019 20:37:05 +0000 (16:37 -0400)
Arvados-DCO-1.1-Signed-off-by: Tom Clegg <tclegg@veritasgenetics.com>

doc/install/configure-fs-storage.html.textile.liquid
doc/install/install-keepstore.html.textile.liquid

index 1e13190aa55fcaef27a4363b5ff760c48496fead..2a3117ecbd2fb9212fde6fb39a04f4ef17728626 100644 (file)
@@ -1,7 +1,7 @@
 ---
 layout: default
 navsection: installguide
-title: Filesystem storage
+title: Configure filesystem storage
 ...
 {% comment %}
 Copyright (C) The Arvados Authors. All rights reserved.
@@ -15,7 +15,7 @@ h2. Setting up filesystem mounts
 
 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.
 
index 1f724191e939f02defb87538d0858c8abcbfe9e0..92fd91eb02d1544339f6dfea46262f772f5fe43d 100644 (file)
@@ -69,7 +69,6 @@ Add or update the following sections of @/etc/arvados/config.yml@ as needed. Ref
       MaxKeepBlockBuffers: 128
 </code></pre>
 </notextile>
-<pre>
 
 h3. Notes on storage management
 
@@ -112,7 +111,7 @@ If your system uses systemd, the keepstore service should already be set up. Res
 </code></pre>
 </notextile>
 
-h3. Run keepstore as a supervised service
+h3(#runit). Start the service (option 2: runit)
 
 Install runit to supervise the keepstore daemon.  {% include 'install_runit' %}
 
@@ -126,11 +125,11 @@ GOGC=10 exec keepstore
 </code></pre>
 </notextile>
 
-h3. Set up additional servers
+h2. Set up additional servers
 
 Repeat the above sections to prepare volumes and bring up supervised services on each Keepstore server you are setting up.
 
-h3. Restart the API server and controller
+h2. Restart the API server and controller
 
 After adding all of your keepstore servers to the Services section, make sure the cluster config file is up to date on the API server host, and restart the API server and controller processes to ensure the changes are applied.
 
@@ -138,7 +137,7 @@ After adding all of your keepstore servers to the Services section, make sure th
 sudo systemctl restart nginx arvados-controller
 </pre>
 
-h3(#testing). Testing keep
+h2(#testing). Testing keep
 
 Install the "Python SDK":{{site.baseurl}}/sdk/python/sdk-python.html