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

4.1 KiB

Raw Blame History

Roll Back a Software Upgrade After the Second Controller Upgrade

After the second controller is upgraded, you can still roll back a software upgrade, however, the rollback will impact the hosting of applications.

The upgrade abort procedure can only be applied before the upgrade-complete command is issued. Once this command is issued the upgrade cannot be aborted. If you must revert to the previous release, then restore the system using the backup data taken prior to the upgrade.

In some scenarios additional actions will be required to complete the upgrade abort. It may be necessary to restore the system from a backup.

Run the upgrade-abort command to abort the upgrade.
```
~(keystone_admin)]$ system upgrade-abort
```
Once this is done there is no going back; the upgrade must be completely aborted.

The following state applies when you run this command.
- aborting-reinstall:
  - State entered when system upgrade-abort is executed after upgrading controller-0.
  - Remain in this state until the abort is completed.

Make controller-1 active.

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

Lock controller-0.

~(keystone_admin)]$ system host-lock controller-0

Wipe the disk and power down all storage (if applicable) and worker hosts.

Note

Skip this step if doing this procedure on a Duplex system.
1. Execute wipedisk from the shell on each storage or worker host.
2. Power down each host.
Lock all storage (if applicable) and worker hosts.

Note

Skip this step if doing this procedure on a Duplex system.
```
~(keystone_admin)]$ system host-lock <hostID>
```
Downgrade controller-0.
```
~(keystone_admin)]$ system host-downgrade controller-0
```
The host is re-installed with the previous release load.
Unlock controller-0.
```
~(keystone_admin)]$ system host-unlock controller-0
```
Note

Wait for controller-0 to become unlocked-enabled. Wait for the sync 400.001 Services-related alarm to be raised and then cleared.
Swact to controller-0.
```
~(keystone_admin)]$ system host-swact controller-1
```
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. This is essentially the same result as a system restore.

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.

Unlock controller-1.

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

Power up and unlock the storage hosts one at a time (if using a Ceph storage backend). The hosts are re-installed with the previous release load.

Note

Skip this step if doing this procedure on a Duplex system.
Power up and unlock the worker hosts one at a time.

Note

Skip this step if doing this procedure on a Duplex system.

The hosts are re-installed with the previous release load. As each worker host goes online, application pods will be automatically recovered by the system.
Complete the upgrade.
```
~(keystone_admin)]$ system upgrade-abort-complete
```
This cleans up the upgrade release, configuration, databases, and so forth.
Delete the upgrade release load.
```
~(keystone_admin)]$ system load-delete
```

4.1 KiB Raw Blame History

Roll Back a Software Upgrade After the Second Controller Upgrade

4.1 KiB

Raw Blame History