lsarrayexpansionprogress

Edit online

Use the lsarrayexpansionprogress command to display the array expansion task status for one or more arrays.

Syntax

Read syntax diagramSkip visual syntax diagram lsarrayexpansionprogress -nohdr-delimdelimiter-filtervalue?-filtervalueattribute=valuemdisk_idmdisk_name

Parameters

-nohdr
(Optional) By default, headings are displayed for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.
Note: If there is no data to be displayed, headings are not displayed.
-delim delimiter
(Optional) In a detailed view, each item of data has its own row, and if the headers are displayed, the data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a 1-byte character. In a detailed view, the data is separated from its header by the specified delimiter.
-filtervalue?
(Optional) Includes all of the valid filter attributes in the report. The following filter attributes are valid for the lsarrayexpansionprogress command:
  • mdisk_id
  • mdisk_name
  • progress
  • estimated_completion_time
  • mdisk_grp_name
  • status
  • target_capacity
  • additional_capacity_remaining
  • drives_added
Any parameters that are specified with the -filtervalue? parameter are ignored.
-filtervalue attribute=value
(Optional) Specifies a list of one or more filter attributes that match the specified values; see -filtervalue? for the supported attributes. Only objects with a value that matches the filter attribute value are returned. If capacity is specified, the units must also be included. Use the unit parameter to interpret the value for size or capacity.
Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards when you use the CLI:
  • The wildcard character is an asterisk (*).
  • The command can contain a maximum of one wildcard, which must be the first or last character in the string.
  • When you use a wildcard character, you must enclose the filter entry within double quotation marks.
mdisk_id
(Optional) The identity of the array MDisk.
mdisk_name
(Optional) The name of the array MDisk.

Description

This command returns a concise list of the array expansion task status for one or more arrays. If the ID or name parameter is not set, then all array MDisks currently expanding are displayed. If the parameter is set, then the view is displayed for that MDisk regardless if it is expanding or not. This table provides the attribute values that can be displayed as output view data.
Table 1. Output
Attribute Values
mdisk_id Indicates the ID of the MDisk.
mdisk_name Indicates the name of the MDisk.
progress Indicates the progress of the expansion. This value is a number in the range of 0 - 100 or blank if no expansion is in progress.
estimated_completion_time Indicates the estimated completion time for the expansion. This value is in the format of YYMMDDHHMMSS or blank if no expansion is in progress or the expansion is suspended.
status Indicates the current status of the expansion.
target_capacity Indicates the capacity of the array after the expansion process is completed. This value is in GB with two decimal places.
additional_capacity_remaining Indicates the capacity that is added to the array (target capacity - current capacity). This value is in GB with two decimal places.
drives_added Indicates the number of drives added.
This list defines the status fields:
blank
No expansion in progress.
inactive
No expansion in progress.
running
The expansion activity is proceeding normally.
offline
The expansion activity is suspended because the MDisk is offline.
suspended
The expansion activity is suspended because of an error. Fix the migration errors against the MDisk.
syncing
The expansion is suspended because the array is syncing.

An invocation example that lists all current expansions

svcinfo lsarrayexpansionprogress -delim :

The resulting output:

mdisk_id:mdisk_name:progress:estimated_completion_time:status:target_capacity:additional_capacity_remaining:drives_added
16:mdisk1:0:191225120000:running:31.79GB:7.95GB:1
32:mdisk2:20:100120132001:running:35.43GB:4.88GB:12
64:mdisk3:80:100120162401:running:67.34GB:16.54GB:3
96:mdisk4:59::offline:31.79GB:7.95GB:5

An invocation example for an MDisk not being expanded

svcinfo lsarrayexpansionprogress -delim : mdisk4 -nohrd

The resulting output:

96:mdisk4:100::inactive::