starlingx/docs
Code Issues Proposed changes
docs/doc/source/updates/kubernetes/rolling-back-a-software-upgrade-before-the-second-controller-upgrade.rst
Ron Stone f125a8b892 Remove spurious escapes (r8,dsR8) 
This change addresses a long-standing issue in rST documentation imported from XML.
That import process added backslash escapes in front of various characters. The three
most common being '(', ')', and '_'.
These instances are removed.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Id43a9337ffcd505ccbdf072d7b29afdb5d2c997e
2023-03-01 11:19:04 +00:00

2.4 KiB
Raw Blame History

Roll Back a Software Upgrade Before the Second Controller Upgrade

After the first controller is upgraded, you can still perform an in-service abort of an upgrade before the second Controller (controller-0 in the examples of this procedure) has been upgraded. The system upgrade-abort command can be run from the node that is updated with the latest release and has upgraded successfully.

  1. Abort the upgrade with the upgrade-abort command.

    ~(keystone_admin)]$ system upgrade-abort

    The upgrade state is set to aborting. Once this is executed, there is no canceling; the upgrade must be completely aborted.

    The following states apply when you execute this command.

    • aborting:
      • State entered when system upgrade-abort is executed before upgrading controller-0.
      • Remain in this state until the abort is completed.

  2. Make controller-0 active.

    ~(keystone_admin)]$ system host-swact controller-1

    If controller-1 was active with the new upgrade release, swacting back to controller-0 will switch back to using the previous release databases, which were frozen at the time of the swact to controller-1. Any changes to the system that were made while controller-1 was active will be lost.

  3. Lock and downgrade controller-1.

    ~(keystone_admin)]$ system host-lock controller-1
~(keystone_admin)]$ system host-downgrade controller-1

    The host is re-installed with the previous release load.

    Note

    The downgrade process will take a minimum of 20 to 30 minutes to complete.

    You can view the downgrade progress on controller-1 using the serial console.

  4. Unlock controller-1.

    ~(keystone_admin)]$ system host-unlock controller-1

  5. Complete the upgrade.

    ~(keystone_admin)]$ system upgrade-complete

  6. Delete the newer upgrade release that has been aborted.

    ~(keystone_admin)]$ system load-delete <loadID>