18702: consolidate upgrade instructions in one place; move the

[arvados.git] / doc / admin / maintenance-and-upgrading.html.textile.liquid

diff --git a/doc/install/maintenance-and-upgrading.html.textile.liquid b/doc/admin/maintenance-and-upgrading.html.textile.liquid
similarity index 80%
rename from doc/install/maintenance-and-upgrading.html.textile.liquid
rename to doc/admin/maintenance-and-upgrading.html.textile.liquid
index 8cfbbe8dcbe0b25541a1ed5a0210cf00c53e7d6b..7d0ca84d25fca5a37d3a27b6e6fc10a22d1d1fa0 100644 (file)
--- a/doc/install/maintenance-and-upgrading.html.textile.liquid
+++ b/doc/admin/maintenance-and-upgrading.html.textile.liquid
@@ -54,7 +54,11 @@ h2(#upgrading). Upgrading Arvados
 
 Upgrading Arvados typically involves the following steps:
 
-* consult the "upgrade notes":{{site.baseurl}}/admin/upgrading.html and the "release notes":https://arvados.org/releases/ for the release you want to upgrade to
-* rebuild and deploy the "compute node image":crunch2-cloud/install-compute-node.html (cloud only)
-* update the configuration file for the new release (see "Maintaining Arvados":#maintaining above)
-* upgrade the Arvados components on the system nodes
+# consult the "upgrade notes":{{site.baseurl}}/admin/upgrading.html and the "release notes":https://arvados.org/releases/ for the release you want to upgrade to
+# Wait for the cluster to be idle and stop Arvados services.
+# Make a backup of your database, as a precaution.
+# update the configuration file for the new release, if necessary (see "Maintaining Arvados":#maintaining above)
+# rebuild and deploy the "compute node image":{{site.baseurl}}/install/crunch2-cloud/install-compute-node.html (cloud only)
+# Install new packages using @apt-get upgrade@ or @yum upgrade@.
+# Wait for package installation scripts as they perform any necessary data migrations.
+# Verify that the Arvados services were restarted as part of the package upgrades.