starlingx/docs
Code Issues Proposed changes
Files
bb66b3373c62c36e4eb0e955bb0e95ef72d39a9c
docs/doc/source/updates/kubernetes/installing-in-service-software-updates-using-the-cli.rst
egoncalv c12cf2bc59 Replaced relase version to nn.nn 
Solved building and merge conflict problem.

Signed-off-by: egoncalv <elisamaraaoki.goncalves@windriver.com>
Change-Id: I9272fa6246bd60ace6a5f7ba64fdb4181b1e4721
2021-06-14 20:16:28 -03:00

4.7 KiB
Raw Blame History

Install In-Service Software Updates Using the CLI

The procedure for applying an in-service update is similar to that of a reboot-required update, except that the host does not need to be locked and unlocked as part of applying the update.

  1. Upload the update (patch).

    $ sudo sw-patch upload INSVC_HORIZON_SYSINV.patch
INSVC_HORIZON_SYSINV is now available

  2. Confirm that the update is available.

    $ sudo sw-patch query
      Patch ID        RR  Release  Patch State
====================  ==  =======  ===========
INSVC_HORIZON_SYSINV  N    nn.nn    Available

  3. Check the status of the hosts.

    $ sudo sw-patch query-hosts
  Hostname      IP Address    Patch Current  Reboot Required  Release  State
============  ==============  =============  ===============  =======  =====
worker-0      192.168.204.24       Yes             No          nn.nn   idle
controller-0  192.168.204.3        Yes             No          nn.nn   idle
controller-1  192.168.204.4        Yes             No          nn.nn   idle

  4. Ensure the original update files have been deleted from the root drive.

    After they are uploaded to the storage area, the original files are no longer required. You must use the command-line interface to delete them, in order to ensure enough disk space to complete the installation.

    $ rm </path/patchfile>

    Caution

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

  5. Apply the update (patch).

    $ sudo sw-patch apply INSVC_HORIZON_SYSINV
INSVC_HORIZON_SYSINV is now in the repo

    The update state transitions to Partial-Apply:

    $ sudo sw-patch query
Patch ID              RR  Release   Patch State
====================  ==  =======  =============
INSVC_HORIZON_SYSINV  N    nn.nn   Partial-Apply

    As it is an in-service update, the hosts report that they are not 'patch current', but they do not require a reboot.

    $ sudo sw-patch query-hosts
Hostname      IP Address      Patch Current  Reboot Required  Release  State
============  ==============  =============  ===============  =======  =====
worker-0      192.168.204.24       No              No          nn.nn   idle
controller-0  192.168.204.3        No              No          nn.nn   idle
controller-1  192.168.204.4        No              No          nn.nn   idle

  6. Install the update on controller-0.

    $ sudo sw-patch host-install controller-0
.............
Installation was successful.

  7. Query the hosts to check status.

    $ sudo sw-patch query-hosts
Hostname      IP Address    Patch Current  Reboot Required    Release  State
============  ==============  =============  ===============  =======  =====
worker-0      192.168.204.24       No              No          nn.nn   idle
controller-0  192.168.204.3        Yes             No          nn.nn   idle
controller-1  192.168.204.4        No              No          nn.nn   idle

    The controller-1 host reports it is now 'patch current' and does not require a reboot, without having been locked or rebooted

  8. Install the update on worker-0 (and other worker nodes and storage nodes, if present)

    $ sudo sw-patch host-install worker-0
....
Installation was successful.

    You can query the hosts to confirm that all nodes are now 'patch current', and that the update has transitioned to the Applied state.

    $ sudo sw-patch query-hosts
Hostname      IP Address      Patch Current  Reboot Required  Release  State
============  ==============  =============  ===============  =======  =====
worker-0      192.168.204.24       Yes             No          nn.nn   idle
controller-0  192.168.204.3        Yes             No          nn.nn   idle
controller-1  192.168.204.4        Yes             No          nn.nn   idle

$ sudo sw-patch query
Patch ID              RR  Release  Patch State
====================  ==  =======  ===========
INSVC_HORIZON_SYSINV  N    nn.nn     Applied