lsarray
Use the lsarray command to list the array MDisks.
Syntax
>>- lsarray -- --+----------+-- --+-----------------------+-----> '- -nohdr -' '- -delim -- delimiter -' >-- --+---------+-- --+-----------------+-- --------------------> '- -bytes-' '- -filtervalue? -' >--+-----------------------------------------------------+-- ---> +- -filtervalue -- attribute=value -------------------+ '- -filtervalue -- capacity=value -- -unit --+- b --+-' +- kb -+ +- mb -+ +- gb -+ +- tb -+ '- pb -' >--+------------------+-- ------------------------------------->< '-+- mdisk_id --+-' '- mdisk_name -'
Parameters
- (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.
- (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 one-byte character. In a detailed view, the data is separated from its header by the specified delimiter.
- (Optional) Requests output of capacities in bytes (instead of rounded values).
- (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
- (Optional) Specifies a list of one or more filter attributes matching 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 entering the command. The following rules apply to the use of wildcards when using 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 using a wildcard character, you must enclose the filter entry
within double quotation marks (""):
lsarray -filtervalue "name=md*"
- (Optional) Specifies a list of one or more filter capacity (size) values matching the specified values for the unit parameter. Use the unit parameter to interpret the value for size or capacity.
- (Optional) The units that are used when applying 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
- (Optional) The identity of the array MDisk.
- (Optional) The name of the array MDisk.
Description
This command returns a concise list or a detailed view
of array MDisks visible to the clustered system (system). Table 1 provides the attribute values
that can be displayed as output view data.
Attribute | Values |
---|---|
capacity | Indicates the value for the capacity specified using the -unit parameter. |
status |
|
mode | Indicates the mode. The values are:
|
quorum_index | Indicates the quorum index. The values are:
|
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:
|
fast_write_state | Indicates the cache state of the array. The values are:
|
raid_level | Indicates the RAID level of the array. The values are:
|
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 should 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 indicates if
the array is balanced to its spare goals:
For distributed
arrays, this indicates whether a superior drive class is being used
for the array:
|
tier | Indicates the tier that this array is assigned
to by auto-detection (for internal arrays) or by the user:
Note: Use the chmdisk command
to change this value.
|
easy_tier_load | Indicates the value for Easy Tier® settings, and is either blank (for arrays) or one of the following values (for
MDisks): :
|
slow_write_priority | Indicates the response time goal:
|
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.
|
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:
|
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. |
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 have been 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 enterprise
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:ssd
easy_tier_load:medium
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