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.

Procedure

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 STLX-00004-PATCH_0004
STLX-00004-PATCH_0002
STLX-00004-PATCH_0003
STLX-00004-PATCH_0004

controller-0:/home/sysadmin# sw-patch query-dependencies STLX-00004-PATCH_0004 --recursive
STLX-00004-PATCH_0001
STLX-00004-PATCH_0002
STLX-00004-PATCH_0003
STLX-00004-PATCH_0004
```
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 00004-PATCH_0001 00004-PATCH_0002
The following patches will be committed:
    00004-PATCH_0001
    00004-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
================   ===== ========  =========
00004-PATCH_0001     N    00004    Committed
00004-PATCH_0002     Y    00004    Committed
```

Reclaim Disk Space

Reclaim Disk Space¶

StarlingX