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.