Configure Firmware Update Orchestration

You can configure Firmware Update Orchestration Strategy using the sw-manager CLI.

Note

Management-affecting alarms cannot be ignored using relaxed alarm rules during an orchestrated firmware update operation. For a list of management-affecting alarms, see StarlingX Fault Management: Alarm Messages. To display management-affecting active alarms, use the following command:

~(keystone_admin)$ fm alarm-list --mgmt_affecting

During an orchestrated firmware update operation, the following alarms are ignored even when the default strict restrictions are selected:

  • 200.001: Maintenance host lock alarm

  • 280.002: Subcloud resource out-of-sync

  • 700.004: VM stopped

  • 900.301: Firmware update auto apply in progress

Prerequisites

  • Hosts that need to be updated must be in the unlocked-enabled state.

  • The firmware update image must be in the applied state. For more information, see Managing Software Updates.

Procedure

  1. Create the strategy.

    The Firmware Update Orchestration Strategy create command creates a series of stages with steps that apply the firmware update to the hardware.

    Firmware update requires a reboot. Therefore, the created strategy includes steps that automatically lock and unlock the host to bring the new image function into service.

    ~(keystone_admin)$ sw-manager fw-update-strategy create
    Strategy Firmware Update Strategy:
      strategy-uuid:                          3e43c018-9c75-4ba8-a276-472c3bcbb268
      controller-apply-type:                  ignore
      storage-apply-type:                     ignore
      worker-apply-type:                      serial
      default-instance-action:                stop-start
      alarm-restrictions:                     strict
      current-phase:                          build
      current-phase-completion:               0%
      state:                                  building
      inprogress:                             true
    
  2. Optional: Display the strategy in summary, if required. The firmware update strategy show command displays the strategy in a summary.

    ~(keystone_admin)$ sw-manager fw-update-strategy show
    Strategy Firmware Update Strategy:
      strategy-uuid:                          3e43c018-9c75-4ba8-a276-472c3bcbb268
      controller-apply-type:                  ignore
      storage-apply-type:                     ignore
      worker-apply-type:                      serial
      default-instance-action:                stop-start
      alarm-restrictions:                     strict
      current-phase:                          build
      current-phase-completion:               100%
      state:                                  ready-to-apply
      build-result:                           success
    

    The strategy steps and stages are displayed using the –details option.

  3. Apply the strategy.

    Firmware Update Orchestration Strategy apply command executes the strategy stages and steps consecutively until the firmware update on all the hosts in the strategy is complete.

    • Use the -stage-id option to specify a specific stage to apply; one at a time.

      Note

      When applying a single stage, only the next stage will be applied; you cannot skip stages.

    ~(keystone_admin)$sw-manager fw-update-strategy apply
    Strategy Firmware Update Strategy:
      strategy-uuid:                          3e43c018-9c75-4ba8-a276-472c3bcbb268
      controller-apply-type:                  ignore
      storage-apply-type:                     ignore
      worker-apply-type:                      serial
      default-instance-action:                stop-start
      alarm-restrictions:                     strict
      current-phase:                          apply
      current-phase-completion:               0%
      state:                                  applying
      inprogress:                             true
    
    • Use the show command to monitor firmware update state and percentage completion.

    ~(keystone_admin)$sw-manager fw-update-strategy show
    Strategy Firmware Update Strategy:
      strategy-uuid:                          3e43c018-9c75-4ba8-a276-472c3bcbb268
      controller-apply-type:                  ignore
      storage-apply-type:                     ignore
      worker-apply-type:                      serial
      default-instance-action:                stop-start
      alarm-restrictions:                     strict
      current-phase:                          apply
      current-phase-completion:               50%
      state:                                  applying
      inprogress:                             true
    
  4. Optional: Abort the strategy, if required. This is only used to stop, and abort the entire strategy.

    The firmware update strategy abort command can be used to abort the firmware update strategy after the current step of the currently applying stage is completed.

  5. Delete the strategy.

    Note

    After the Firmware Update Orchestration Strategy has been applied (or aborted) it must be deleted before another firmware update strategy can be created. If a firmware update strategy application fails, you must address the issue that caused the failure, then delete and re-create the strategy before attempting to apply it again.

    ~(keystone_admin)$sw-manager fw-update-strategy delete
    Strategy deleted.
    

For more information see Firmware Update Orchestration Using the CLI.