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

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 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

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 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