starlingx/docs
Code Issues Proposed changes
Files
37ea44695d4c8380affd26dde9fb995d0e5f51e1
docs/doc/source/updates/kubernetes/reclaiming-disk-space.rst
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

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