docs/doc/source/updates/kubernetes/rolling-back-a-software-upgrade-before-the-second-controller-upgrade.rst
Ron Stone dd8efe5f85 Upgrades edits (r6,r7,dsR6,dsR7)
Copy edits for typos, markup and other technical issues.
Fix case typo
Fix merge conflicts.
Resolve FixMe issues.
Minor copy edit updates.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: I7d710d3faa957c1cb66cc18c9a248a567e7c580f
2022-10-27 06:34:33 -04:00

2.4 KiB

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>