Manual Rollback Host Software DeploymentΒΆ

For a major release software deployment, you can roll back the Manual Host Software Deployment procedure at any time between software deploy start and software deploy activate. After the software deploy deletion step, aborting and rolling back of the major release deployment is not possible.

Note

This section also covers the abort and rollback of a new patched major release deployment.

Note

Currently, software deployments cannot be rolled back after the software deploy activate step.

Prerequisites

You are in the middle of the Manual Host Software Deployment procedure for a major release between software deploy start and software deploy delete.

Procedure

  1. Abort the current in-progress major release software deployment.

    ~(keystone_admin)]$ software deploy abort
    Deployment has been aborted
    
  2. Perform the following commands for all hosts, in the following host order:

    • When rolling back a patch: controller-1, controller-0, all storage nodes, and all worker nodes

    • When rolling back a major release: all worker nodes, all storage nodes, controller-0, and controller-1

    [sysadmin@controller-0 ~(keystone_admin)]$ system host-lock <host>
    [sysadmin@controller-0 ~(keystone_admin)]$ software deploy host-rollback <host>
    [sysadmin@controller-0 ~(keystone_admin)]$ system host-unlock <host>
    

    Note

    For controllers, a system host-swact controller-# will be required to lock and roll back the active controller.

  3. Delete the software deployment to complete the rollback.

    ~(keystone_admin)]$ software deploy delete
    Deployment has been deleted
    
    ~(keystone_admin)]$ software deploy show
    No deploy in progress
    
  4. Confirm that the previous software release is now deployed.

    ~(keystone_admin)]$ software list
    +--------------------------+-------+-----------+
    | Release                  | RR    |   State   |
    +--------------------------+-------+-----------+
    | starlingx-10.0.0         | True  | deployed  |
    | <new-maj-rel-id>         | True  | available |
    +--------------------------+-------+-----------+