docs/doc/source/updates/kubernetes/manual-removal-host-software-deployment-24f47e80e518.rst
Ngairangbam Mili dd9ca375dc Host Software Deployment (USM)
Story: 2010676
Task: 50141

Change-Id: I2ab679259b22c71d1e544a036d2cfa5cc8f81a2c
Signed-off-by: Ngairangbam Mili <ngairangbam.mili@windriver.com>
2024-11-07 02:50:17 +00:00

87 lines
3.0 KiB
ReStructuredText

.. WARNING: Add no lines of text between the label immediately following
.. and the title.
.. _manual-removal-host-software-deployment-24f47e80e518:
=======================================
Manual Removal Host Software Deployment
=======================================
A fully deployed patch release can be removed (un-deployed) by using the
the :ref:`manual-host-software-deployment-ee17ec6f71a4` 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:
.. code-block::
~(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
:ref:`manual-host-software-deployment-ee17ec6f71a4` procedure, and deploy (or
go back to) the `starlingx-10.0.1` software release in the software deployment
start step.
.. code-block::
~(keystone_admin)]$ software deploy start starlingx-10.0.1
Deployment for starlingx-10.0.1 started
.. code-block::
~(keystone_admin)]$ software deploy show
+--------------+------------------+------+-------+
| From Release | To Release | RR | State |
+--------------+------------------+------+-------+
| 10.0.3 | 10.0.1 | True | start |
+--------------+------------------+------+-------+
On the completion of the :ref:`manual-host-software-deployment-ee17ec6f71a4`
procedure, run the following command:
.. code-block::
~(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.
.. code-block::
~(keystone_admin)]$ software delete starlingx-10.0.3
starlingx-10.0.3 has been deleted.
.. code-block::
~(keystone_admin)]$ software delete starlingx-10.0.2
starlingx-10.0.2 has been deleted.
.. code-block::
~(keystone_admin)]$ software list
+--------------------------+-------+-----------+
| Release | RR | State |
+--------------------------+-------+-----------+
| starlingx-10.0.0 | True | deployed |
| starlingx-10.0.1 | False | deployed |
+--------------------------+-------+-----------+