lsupdate

Use the lsupdate command to display a system's machine code (code) upgrade status.

Syntax

lsupdate

Parameters

None

Description

The following are the upgrade status states:
status
Indicates the overall update-related status of the system. The values are:
  • success, which indicates that all updating activity is complete.
  • system_preparing, which indicates that the system is preparing a manual update.
  • system_prepared, which indicates that the system is ready to starting a manual update.
  • system_prepare_failed, which indicates that the system could not start a manual update.
    Note: Check the event log.
  • system_initializing, which indicates that the system is readying nodes for an update.
  • system_updating, which indicates that the nodes are being updated.
  • system_updating_pausing, which indicates that the nodes are being updated.
  • system_committing, which indicates that all nodes have been updated and the system is readying the new code.
  • system_stalled, which indicates that an update has stalled because of unexpected node problems.
  • system_stalled_non_redundant, which indicates that an update has stalled because of dependent volumes.
  • system_restoring, which indicates that a stalled update has been cancelled by the user.
    Note: The previous code version is being restored.
  • system_restoring_pausing, which indicates that nodes are being restored.
  • system_restoring_stalled_non_redundant, which indicates that an update has been cancelled and then stalled because of dependent volumes..
  • system_manual_update, which indicates that a manual update is in progress.
  • system_completion_required, which indicates that all nodes have updated and management functions are available, but further system changes are necessary to complete the update.
    Note: Check the event log.
  • system_completing, which indicates that an automatic update completion is in progress.
  • system_completing_pausing, which indicates that automatic update completion is paused.
  • system_completing_paced, which indicates that a paced update completion is in progress.
  • system_completing_stalled, which indicates that an automatic update completion has stalled because of an unexpected problem.
  • enclosures, which indicates that enclosure firmware is being updated.
  • enclosures_stalled, which indicates that an enclosure firmware update has stalled because of an unexpected problem or the enclosure has a lack of redundancy.
    Note: On a Lenovo Storage V7000 Gen1 system, battery maintenance can leave an enclosure without redundancy for several hours.
  • drives, which indicates that drive firmware is being updated.
event_sequence_number
Indicates an event describing any current problem with the code update. The value must be a numeric string in decimal format (or blank).
progress
Indicates the completion percentage of the current update activity in terms of number of objects updated (rather than time elapsed). The value must be a numeric string (decimal) between 0 and 100.
estimated_completion_time
Indicates estimated completion time of current update activity. It is valid only if the current update activity is automatic and has not stalled. The value must be in the format YYMMDDHHMMSS (or blank).
suggested_action
Indicates the actions that help the update progress. The value must be:
  • start, which indicates that the system is ready for a new update to start. No update is in progress or prepared and all nodes are online.
  • wait, which indicates that the system is busy (no action is required) because an update is in progress.
  • fix, which indicates that an update cannot continue because of a problem. Check the event log, specifically the event_sequence_number output. Nodes are offline.
  • resume_cancel, which indicates that the update is stalled but can be resumed or canceled. Nodes are online.
  • resume, which indicates that the update completion is stalled but can be resumed. Nodes are online.
  • complete, which indicates the system update is complete and update completion must be issued. Nodes are online.
  • pacednext, which indicates that the paced update is in progress and the next node must be scheduled for updating. Nodes are online.
  • manual, which indicates that a manual update is in progress.
system_new_code_level
Indicates that a new level of code is being updated. The value must be the build version (or blank if not updating or restoring the system).
system_forced
Indicates any current node-related activity in forced mode (ignoring dependent volumes). The values are yes or no.
system_next_node_status
Indicates the status of the next node in the current node-related update activity. The values are:
  • waiting, which indicates that the node is ready for updating and that the system is waiting (typically for multipathing failover).
  • ready, which indicates that the node is ready for updating, and the update activity is paced. You must start the update manually.
  • updating, which indicates that the node is updating.
  • stalled, which indicates that the node is going to be updated next, but the update is stalled.
  • none, which indicates that there is no node to update.
system_next_node_time
Indicates the time that the next node update will start. It is valid only if the system_next_node_status is waiting. The value must be in the format YYMMDDHHMMSS x (or blank).
system_next_node_id
Indicates the ID of the next node in the current node-related update. The value must be a numeric string (or blank).
system_next_node_name
Indicates the name of the next node in the current node-related update. The value must be an alphanumeric string (or blank).

An invocation example of an update

lsupdate

The resulting output:

status system_updating
event_sequence_number
progress 50
estimated_completion_time 140522093020
suggested_action wait
system_new_code_level 7.4.0.1 (build 99.2.141022001)
system_forced no
system_next_node_status updating
system_next_node_time
system_next_node_id 2
system_next_node_name node2

An invocation example of a paced update

lsupdate

The resulting output:

status system_completing_paced
event_sequence_number
progress 75
estimated_completion_time
suggested_action pacednext
system_new_code_level
system_forced no
system_next_node_status ready
system_next_node_time
system_next_node_id 4
system_next_node_name node4