diff --git a/pages/operations/upgrade/1010-quick-start.rst b/pages/operations/upgrade/1010-quick-start.rst index 9f5d024f8..55780f496 100644 --- a/pages/operations/upgrade/1010-quick-start.rst +++ b/pages/operations/upgrade/1010-quick-start.rst @@ -88,6 +88,11 @@ that ID: fuel node list --env ${ORIG_ID} | awk -F\| '$7~/controller/{print($0)}' +.. note:: + + Select a controller node with the lowest ID to ensures that you upgrade + the `primary` controller first. + Use the ID of the Controller to upgrade it with the following command: :: diff --git a/pages/operations/upgrade/3040-install-seed.rst b/pages/operations/upgrade/3040-install-seed.rst index 905f87d82..8762ff860 100644 --- a/pages/operations/upgrade/3040-install-seed.rst +++ b/pages/operations/upgrade/3040-install-seed.rst @@ -29,6 +29,12 @@ Deployment settings can be downloaded from Fuel API as a set of files. The upgrade script updates the settings by changing those files and uploading the modified information back via Fuel API. +.. note:: + Always upgrade the controller with the lowest ID number first. + The controller node with the lowest ID number is a so-called `primary` + controller and you must upgrade before other controllers in the + OpenStack environment. + The upgrade script keeps the deployment infromation for the environment in a cache directory (by default, ``/tmp/octane/deployment``). The deployment settings for the nodes are stored to subdirectory @@ -43,8 +49,9 @@ Install Controller commands ^^^^^^^^^^^^^^^^^^^^^^^^^^^ The upgrade automation script allows upgrading a controller that -exists in the original 6.1 environment. Select which controller -you would like to upgrade and run the following command. Replace +exists in the original 6.1 environment. Select the controller with +minimal ID out of all controllers deployed in the environment and +run the following command. Make sure to replace ```` with the actual ID of 6.1 Controller you'd like to upgrade: