The legacy keepstore config (loaded from @/etc/arvados/keepstore/keepstore.yml@ or a different location specified via -legacy-keepstore-config command line argument) takes precedence over the centralized config. After you migrate everything from the legacy config to the centralized config, you should delete @/etc/arvados/keepstore/keepstore.yml@ and stop using the -legacy-keepstore-config argument.
-If a legacy config file exists when a keepstore process starts up, its log messages will provide instructions for migrating configuration values from the legacy config file to the new centralized config file. Installing the @arvados-server@ package and running @arvados-server config-check@ will also display these migration instructions. After making these changes, run @arvados-server config-check@ (or restart keepstore and check startup logs) and repeat as needed. When this process is complete, you should delete the legacy config file, copy the updated centralized config file to your next keepstore server, and repeat the same process there.
+To migrate a keepstore node's configuration, first install @arvados-server@. Run @arvados-server config-diff@, review and apply the recommended changes to @/etc/arvados/config.yml@, and run @arvados-server config-diff@ again to check for additional warnings and recommendations. When you are satisfied, delete the legacy config file, restart keepstore, and check its startup logs. Copy the updated centralized config file to your next keepstore server, and repeat the process there.
After migrating and removing all legacy keepstore 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.
projects / arvados.git / commitdiff