Install In-Service Software Update Using Horizon

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. Log in to the Horizon Web interface as the admin user.

  2. In StarlingX Horizon, open the Software Management page.

    The Software Management page is available from Admin > Platform > Software Management in the left-hand pane.

  3. Select the Patches tab to see the current update status.

    The Patches tab shows the current status of all updates uploaded to the system. If there are no updates, an empty Patch Table is displayed.

  4. Upload the update (patch) file to the update storage area.

    Click the Upload Patch button to display an upload window from which you can browse your workstation’s file system to select the update file. Click the Upload Patch button once the selection is done.

    The update file is transferred to the Active Controller and is copied to the update storage area, but it has yet to be applied to the cluster. This is reflected in the Patches tab.

  5. Apply the update.

    Click the Apply Patch button associated with the update. Alternatively, select the update first using the selection boxes on the left, and then click the Apply Patches button at the top. You can use this selection process to apply all updates, or a selected subset, in a single operation.

    The Patches tab is updated to report the update to be in the Partial-Apply state.

  6. Install the update on controller-0.

    1. Select the Hosts tab.

      The Hosts tab on the Host Inventory page reflects the new status of the hosts with respect to the new update state. In this example, the update only applies to controller software, as can be seen by the worker host’s status field being empty, indicating that it is ‘patch current’.

    2. Select the Install Patches option from the Edit Host button associated with controller-0 to install the update.

      A confirmation window is presented giving you a last opportunity to cancel the operation before proceeding.

  7. Repeat the steps 6 a,b, above with controller-1 to install the update on controller-1.

  8. Repeat the steps 6 a,b above for the worker and/or storage hosts (if present).

    This step does not apply for StarlingX Simplex or Duplex systems.

  9. Verify the state of the update.

    Visit the Patches tab again. The update is now in the Applied state.


The update is now applied, and all affected hosts have been updated.