Manual Removal Host Software Deployment

A fully deployed patch release can be removed (un-deployed) by using the the Manual Host Software Deployment procedure and deploying a previous patch release or the major release.

Note

A fully deployed major release cannot be removed (un-deployed).

For example, the following shows the current software releases deployed:

~(keystone_admin)]$ software list
+--------------------------+-------+-----------+
| Release                  | RR    |    State  |
+--------------------------+-------+-----------+
| starlingx-10.0.0         | True  | deployed  |
| starlingx-10.0.1         | False | deployed  |
| starlingx-10.0.2         | True  | deployed  |
| starlingx-10.0.3         | False | deployed  |
+--------------------------+-------+-----------+

To remove patch releases starlingx-10.0.3 and starlingx-10.0.2, follow the Manual Host Software Deployment procedure, and deploy (or go back to) the starlingx-10.0.1 software release in the software deployment start step.

~(keystone_admin)]$ software deploy start starlingx-10.0.1
Deployment for starlingx-10.0.1 started

~(keystone_admin)]$ software deploy show
+--------------+------------------+------+-------+
| From Release | To Release       |   RR | State |
+--------------+------------------+------+-------+
| 10.0.3       | 10.0.1           | True | start |
+--------------+------------------+------+-------+

On the completion of the Manual Host Software Deployment procedure, run the following command:

~(keystone_admin)]$ software list
+--------------------------+-------+-----------+
| Release                  | RR    |    State  |
+--------------------------+-------+-----------+
| starlingx-10.0.0         | True  | deployed  |
| starlingx-10.0.1         | False | deployed  |
| starlingx-10.0.2         | True  | available |
| starlingx-10.0.3         | False | available |
+--------------------------+-------+-----------+

If the removed patches are no longer required on the system, you can delete them.

~(keystone_admin)]$ software delete starlingx-10.0.3
starlingx-10.0.3 has been deleted.

~(keystone_admin)]$ software delete starlingx-10.0.2
starlingx-10.0.2 has been deleted.

~(keystone_admin)]$ software list
+--------------------------+-------+-----------+
| Release                  | RR    |    State  |
+--------------------------+-------+-----------+
| starlingx-10.0.0         | True  | deployed  |
| starlingx-10.0.1         | False | deployed  |
+--------------------------+-------+-----------+