Populate the Storage AreaΒΆ

Software updates (patches) have to be uploaded to the StarlingX storage area before they can be applied.


  1. Log in as sysadmin to the active controller.

  2. Upload the update file to the storage area.

    $ sudo sw-patch upload /home/sysadmin/patches/STLX-CONTROLLER_<nn.nn>_PATCH_0001.patch
    Cloud_Platform__CONTROLLER_<nn.nn>_PATCH_0001 is now available

    where <nn.nn> in the update file name is the StarlingX release number.

    This example uploads a single update to the storage area. You can specify multiple update files on the same command separating their names with spaces.

    Alternatively, you can upload all update files stored in a directory using a single command, as illustrated in the following example:

    $ sudo sw-patch upload-dir /home/sysadmin/patches

    The update is now available in the storage area, but has not been applied to the update repository or installed to the nodes in the cluster.

  3. Verify the status of the update.

    $ sudo sw-patch query

    The update state displays Available, indicating that it is included in the storage area. Further details about the updates can be retrieved as follows:

    $ sudo sw-patch show <patch_id>

    The sudo sw-patch query command returns a list of patch IDs. The sudo sw-patch show command provides further detail about the specified <patch_id>.

  4. Delete the update files from the root drive.

    After the updates are uploaded to the storage area, the original files are no longer required. You must delete them to ensure there is enough disk space to complete the installation.

    $ rm /home/sysadmin/patches/*


    If the original files are not deleted before the updates are applied, the installation may fail due to a full disk.


When an update in the Available state is no longer required, you can delete it using the following command:

$ sudo sw-patch delete STLX-00004-PATCH_0001

The update to delete from the storage area is identified by the update (patch) ID reported by the sw-patch query command. You can provide multiple patch IDs to the delete command, separating their names by spaces.