starlingx/docs
Code Issues Proposed changes
docs/doc/source/updates/kubernetes/populating-the-storage-area.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

2.5 KiB
Raw Blame History

Populate the Storage Area

Software updates (patches) have to be uploaded to the 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/-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 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/*

    Caution

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