[ARVADOS] updated: 2.1.0-128-g457dd05a3

Git user git at public.arvados.org
Fri May 14 17:41:32 UTC 2021

Summary of changes:
 doc/admin/config-migration.html.textile.liquid | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

       via  457dd05a3c10cfdca7cdc963f7a92343c5ffaf56 (commit)
      from  81a2b0fc6e2321203120c7426bcb745d50acaf39 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

commit 457dd05a3c10cfdca7cdc963f7a92343c5ffaf56
Author: Ward Vandewege <ward at curii.com>
Date:   Fri May 14 13:40:40 2021 -0400

    Mention the 'Rendezvous' parameter on Keepstore's InternalURLs, for
    migration from old config.
    refs #13647
    Arvados-DCO-1.1-Signed-off-by: Ward Vandewege <ward at curii.com>

diff --git a/doc/admin/config-migration.html.textile.liquid b/doc/admin/config-migration.html.textile.liquid
index 875ee4618..a1f7872df 100644
--- a/doc/admin/config-migration.html.textile.liquid
+++ b/doc/admin/config-migration.html.textile.liquid
@@ -70,6 +70,22 @@ To migrate a component configuration, do this on each node that runs an Arvados
 # After applying changes, re-run @arvados-server config-check@ again to check for additional warnings and recommendations.
 # When you are satisfied, delete the legacy config file, restart the service, and check its startup logs.
 # Copy the updated @config.yml@ file to your next node, and repeat the process there.
+# When you have a @config.yml@ file that includes all volumes on all keepstores, it is important to add a 'Rendezvous' parameter to the InternalURLs entries to make sure the old volume identifiers line up with the new config. If you don't do this, @keep-balance@ will want to shuffle all the existing data around to match the new volume order. The 'Rendezvous' value should be the last 15 characters of the keepstore's UUID in the old configuration. Here's an example:
+  xxxxx:
+    Services:
+      Keepstore:
+        InternalURLs:
+          "http://keep1.xxxxx.arvadosapi.com:25107": {Rendezvous: "eim6eefaibesh3i"}
+          "http://keep2.xxxxx.arvadosapi.com:25107": {Rendezvous: "yequoodalai7ahg"}
+          "http://keep3.xxxxx.arvadosapi.com:25107": {Rendezvous: "eipheho6re1shou"}
+          "http://keep4.xxxxx.arvadosapi.com:25107": {Rendezvous: "ahk7chahthae3oo"}
+In this example, the keepstore with the name `keep1` had the uuid `xxxxx-bi6l4-eim6eefaibesh3i` in the old configuration.
 After migrating and removing all legacy config files, make sure the @/etc/arvados/config.yml@ file is identical across all system nodes -- API server, keepstore, etc. -- and restart all services to make sure they are using the latest configuration.



More information about the arvados-commits mailing list