starlingx/docs
Code Issues Proposed changes
docs/doc/source/updates/kubernetes/reclaiming-disk-space.rst
Ron Stone 0012d76f09 Add updates and upgrades content 
Some substitutions also added to accomodate StX vs partner file naming.
Add 750.006 alarm to performing-an-orchestrated-upgrade

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: I33588f3c1b22cd0dbc96133cf8eb056c8c2e5162
Signed-off-by: Ron Stone <ronald.stone@windriver.com>
2021-05-17 07:12:27 -04:00

3.4 KiB
Raw Blame History

Reclaim Disk Space

You can free up and reclaim disk space taken by previous updates once a newer version of an update has been committed to the system.

  1. Run the query-dependencies command to show a list of updates that are required by the specified update (patch), including itself.

    sw-patch query-dependences [ --recursive ] <patch-id>

    The query-dependencies command will show a list of updates that are required by the specified update (including itself). The --recursive option will crawl through those dependencies to return a list of all the updates in the specified update's dependency tree. This query is used by the “commit” command in calculating the set of updates to be committed.For example,

    controller-0:/home/sysadmin# sw-patch query-dependencies --PATCH_0004 --PATCH_0002 --PATCH_0003 --PATCH_0004

    controller-0:/home/sysadmin# sw-patch query-dependencies --PATCH_0004 --recursive --PATCH_0001 --PATCH_0002 --PATCH_0003 --PATCH_0004

  2. Run the sw-patch commit command.

    sw-patch commit [ --dry-run ] [ --all ] [ --release ] [ <patch-id> … ]

    The sw-patch commit command allows you to specify a set of updates to be committed. The commit set is calculated by querying the dependencies of each specified update.

    The --all option, without the --release option, commits all updates of the currently running release. When two releases are on the system use the --release option to specify a particular release's updates if committing all updates for the non-running release. The --dry-run option shows the list of updates to be committed and how much disk space will be freed up. This information is also shown without the --dry-run option, before prompting to continue with the operation. An update can only be committed once it has been fully applied to the system, and cannot be removed after.

    Following are examples that show the command usage.

    The following command lists the status of all updates that are in an APPLIED state.

    controller-0:/home/sysadmin# sw-patch query

    The following command commits the updates.

    controller-0:/home/sysadmin# sw-patch commit -PATCH_0001 -PATCH_0002 The following patches will be committed: -PATCH_0001 -PATCH_0002

    This commit operation would free 2186.31 MiB

    WARNING: Committing a patch is an irreversible operation. Committed patches

    cannot be removed.

    Would you like to continue? [y/N]: y The patches have been committed.

    The following command shows the updates now in the COMMITTED state.

    controller-0:/home/sysadmin# sw-patch query Patch ID RR Release Patch State ================ ===== ======== ========= -PATCH_0001 N Committed -PATCH_0002 Y Committed