lsarray

Use the lsarray command to list the array MDisks.

Syntax

lsarray [ -nohdr ] [ -delimdelimiter ] [ -bytes ] [ -filtervalue? ] { [ -filtervalueattribute=value ] | [ -filtervaluecapacity=value -unit { b | kb | mb | gb | tb | pb } ] } [ { mdisk_id | mdisk_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.
-bytes
(Optional) Requests output of capacities in bytes (instead of rounded values).
-filtervalue?
(Optional) Includes all of the valid filter attributes in the report. The following filter attributes are valid for the lsarray command:
  • balanced
  • capacity
  • distributed
  • mdisk_id
  • mdisk_name
  • mode
  • mdisk_grp_id
  • mdisk_grp_name
  • fast_write_state
  • raid_status
  • raid_level
  • redundancy
  • spare_goal
  • spare_protection_min
  • status
  • strip_size
  • tier
  • easy_tier_load
Any parameters that are specified with the -filtervalue? parameter are ignored.
-filtervalueattribute=value
(Optional) Specifies a list of one or more filter attributes 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 (""):
    lsarray -filtervalue  "name=md*"
-filtervaluecapacity=value
(Optional) Specifies a list of one or more filter capacities (size) values matching the specified values for the unit parameter. Use the unit parameter to interpret the value for size or capacity.
-unitb | kb | mb | gb | tb | pb
(Optional) The units that are used when you specify the -filtervalue capacity, where:
  • b = bytes
  • kb = 1,024 bytes
  • mb = 1,048,576 bytes
  • gb = 1,073,741,824 bytes
  • tb = 1,099,511,627,776 bytes
  • pb = 1,125,899,906,842,624 bytes
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 or a detailed view of array MDisks visible to the system. This table provides the attribute values that can be displayed as output view data.
Table 1. Array output
Attribute Values
capacity Indicates the value for the capacity you specify by using the -unit parameter.
status Indicates the array status. The values are:
  • online
  • offline
  • excluded
  • degraded (applies only to internal MDisks)
mode Indicates the mode. The values are:
  • unmanaged
  • managed
  • image
  • array
quorum_index Indicates the quorum index. The values are:
  • 0
  • 1
  • 2
  • Blank if the MDisk is not being used as a quorum disk.
block_size Indicates the block size. The value is 512 bytes (or blank) in each block of storage.
ctrl_type 4, 6, where 6 is a flash drive attached inside a node and 4 is any other device.
raid_status Indicates the RAID status. The values are:
offline
The array is offline on all nodes.
degraded
The array has deconfigured or offline members; the array is not fully redundant.
syncing
The array members are all online. The array is synchronizing parity or mirrors to achieve redundancy.
initializing
The array members are all online. The array is initializing; the array is fully redundant.
online
The array members are all online, and the array is fully redundant.
fast_write_state Indicates the cache state of the array. The values are:
  • empty, which indicates that the array disk data is not changing.
  • not_empty, which indicates that the array disk data might change.
  • corrupt, which indicates that the array disk data is lost and the array is corrupt.
Repair can be initiated by using the recoverarray or recoverarraybysystem command.
raid_level Indicates the RAID level of the array. The values are:
  • RAID0
  • RAID1
  • RAID5
  • RAID6
  • RAID10
redundancy Indicates the number of member disks that can fail concurrently without causing the array to fail.
strip_size Indicates the strip size of the array (in KB).
spare_goal Indicates the number of spares that the array members must be protected by. For distributed arrays, this value is blank.
spare_protection_min Indicates the minimum number of spares that an array member is protected by. For distributed arrays, this value is blank.
balanced
For nondistributed arrays, this value indicates whether the array is balanced to its spare goals:
  • exact indicates that all populated members have the same (matching) capability and location.
  • yes indicates that all populated members have at least the same capability and chain, but a different enclosure or slot.
  • no indicates that it is unbalanced.
For distributed arrays, this value indicates whether a superior drive class is being used for the array:
  • exact indicates that the same drive class is in use.
  • yes indicates that at least one array member exceeds the array drive class.
For distributed arrays, the array must also be balanced to its rebuild area goals.
tier Indicates the tier that this array is assigned to by auto-detection (for internal arrays) or by the user:
  • tier0_flash
  • tier1_flash
  • tier_enterprise
  • tier_nearline
Note: Use the chmdisk command to change this value.
replacement_date Indicates the date of a potential array failure. The format must be YYMMDD.
easy_tier_load Indicates the value for Easy Tier settings, and is either blank (for arrays) or one of the following values (for MDisks):
  • low
  • medium
  • high
  • very_high
slow_write_priority Indicates the response time goal:
  • latency indicates that the array is taken out of synchronization to quickly complete write operations that take excessive time.
  • redundancy indicates slow write operations are completed in normal time and the arrays remain synchronized.
site_id Indicates the site value for the storage pool. This numeric value is 1, 2, 3, or blank.
site_name Indicates the site name for the storage pool. This value is alphanumeric or is blank.
fabric_type Indicates a Fibre Channel (FC), SAS, or another type of array.
  • fc indicates an array from an FC controller.
  • sas_direct indicates an array from an SAS direct-attached controller.
distributed Indicates whether the array is distributed. The values are yes or no.
drive_class_id Indicates the drive class that makes up this array. If -allowsuperior was used during array creation, the lowest used drive class ID is displayed. This value is blank for nondistributed arrays.
drive_count Indicates the total width of the array, including rebuild areas. The value is a number from 4 to 128. The minimum value for RAID-6 and RAID-10 arrays is 6.
stripe_width Indicates the width of a single unit of redundancy within a distributed set of drives. The values are:
  • Any number from 3 - 16 for RAID-5 arrays.
  • Any number from 4 - 16 for RAID-6 arrays.
  • An even number from 2 - 16 for RAID-10 arrays.
rebuild_areas_total Indicates the total number of rebuild areas set when the array is created. These rebuild areas provide performance but no capacity. The value is 1 - 4 for distributed array RAID-5 and distributed array RAID-6. The value is blank for nondistributed arrays.
rebuild_areas_available Indicates the number of remaining rebuild areas within the set of drives. The value is 1 - 4 for distributed array RAID-5 and distributed array RAID-6. The value is blank for nondistributed arrays.
rebuild_areas_goal Indicates the rebuild areas threshold (minimum limit) at which point the array logs an error. The value is 1 - 4 for distributed array RAID-5 and distributed array RAID-6. The value is blank for nondistributed arrays.
over_provisioned Shows yes if the MDisk is thin-provisioned. Shows no if the disk is marked as fully allocated, resource-provisioned, or the information cannot be determined.
supports_unmap Shows yes if the MDisk indicates UNMAP support. Shows no if the disk indicates it does not support UNMAP, or the information cannot be identified.
provisioning_group_id System allocated identifier of the provisioning group that relates to the MDisk. This identifier is used to identify the list of MDisks that are provided by the same provisioning group.
physical_capacity The total physical storage capacity of the provisioning group providing this MDisk. If this disk is not over_provisioned, then logical capacity is reported here.
physical_free_capacity The amount of formatted available physical space in the provisioning group providing this MDisk. If this disk is not over_provisioned, then remaining logical capacity is reported here.
write_protected Shows yes if the array is in the write protected state, otherwise no.
data_reduced Indicates that the MDisk data is reduced. The values are yes or no.
effective_used_capacity The amount of logical data that is written to the MDisk. If this MDisk is not over_provisioned, then this field is blank.
allocated_capacity The amount of logical capacity that is allocated (by a pool) from this array for volume data and quorum.
This list defines the status fields:
online
The MDisk is online and available.
degraded
(Internal MDisks only) The array has members that are degraded, or the raid_status is degraded.
degraded_ports
There are one or more MDisk port errors.
degraded_paths
One or more paths to the MDisk are lost; the MDisk is not online to every node in the system.
offline
All paths to the MDisk are lost.
excluded
The MDisk is excluded from use by the system; the MDisk port error count exceeded the threshold.

A concise invocation example

lsarray -delim :

The resulting output:

mdisk_id:mdisk_name:status:mdisk_grp_id:mdisk_grp_name:capacity:raid_status:raid_level:redundancy:strip_size:tier:distributed
1::online:0:mdiskgrp0:68.4GB:online:raid0:0:256:enterprise:yes
2:mdisk2:online:0:mdiskgrp0:88.4GB:syncing:raid5:1:256:nearline:no
533:mdisk533:degraded:1:mdiskgrp1:78.2GB:syncing:raid6:2:128:ssd:yes
534:mdisk534:online:2:mdiskgrp1:94.2GB:initting:raid6:2:64:ssd:no

A detailed invocation example

lsarray 

The resulting output:

mdisk_id 144
mdisk_name draid6_5
status online
mode array
mdisk_grp_id 1
mdisk_grp_name pool_512
capacity 5.6TB
quorum_index
block_size
controller_name
ctrl_type
ctrl_WWNN
controller_id
path_count
max_path_count
ctrl_LUN_#
UID
preferred_WWPN
active_WWPN
fast_write_state not_empty
raid_status initting
raid_level raid6
redundancy 2
strip_size 256
spare_goal
spare_protection_min
balanced exact
tier tier0_flash
replacement_date 121110090907
slow_write_priority redundancy
fabric_type
site_id
site_name
easy_tier_load
encrypt no
distributed yes
drive_class_id 1
drive_count 28
stripe_width 15
rebuild_areas_total 4
rebuild_areas_available 4
rebuild_areas_goal 2

A detailed invocation example

lsarray 1

The resulting output:

mdisk_id:1
mdisk_name:
status:online
mode:array
mdisk_grp_id:0
mdisk_grp_name:mdiskgrp0
capacity:68.4GB
quorum_index:
block_size:
controller_name:
ctrl_type:
ctrl_WWNN:
controller_id:
path_count:
max_path_count:
ctrl_LUN_#:
UID:
preferred_WWPN:
active_WWPN:
node_id:
node_name:
location:fast_write_state:empty
raid_status:online
raid_level:raid0
redundancy:0
strip_size:256
spare_goal:2
spare_protection_min:2
balanced:yes
tier tier1_flash
replacement_date 121110090907
slow_write_priority:latency

fabric_type:
distributed no
 drive_class_id
 drive_count 8
 stripe_width 4
 total_rebuild_areas 
 available_rebuild_areas 
 rebuild_areas_goal

A detailed invocation example

lsarray 0

The resulting output:

mdisk_id 0
mdisk_name mdisk1
status online
mode array
...
replacement_date
over_provisioned yes
supports_unmap yes
provisioning_group_id 0
physical_capacity 13.10TB
physical_free_capacity 41.02GB
write_protected yes
effective_used_capacity 25.12TB
allocated_capacity 37.66TB

A detailed invocation example

lsarray

The resulting output:

mdisk_id mdisk_name status mdisk_grp_id mdisk_grp_name capacity raid_status raid_level redundancy strip_size tier            encrypt distributed over_provisioned supports_unmap write_protected effective_used_capacity allocated_capacity
0        mdisk0     online 0            mdiskgrp0      826.4GB  initting    raid6      0          256        tier_enterprise no      yes         no               no             no              25.12TB                 37.66TB