Dell PowerVault ME5 Series Storage System CLI Reference Guide

PDF

show disk-groups


Description	Shows information about disk groups. The command will show information for all disk groups by default, or you can use parameters to filter the output.
Minimum role	monitor
Syntax	show disk-groups [detail] [pool <pool>] [scrub-status] [<disk-groups>]
Parameters	[detail] Optional. This parameter shows additional detail about disk groups. [pool <pool>] Optional. Specifies the name or serial number of the pool that contains the disk groups for which to show information. If this parameter is omitted, information is shown for disk groups in all pools. NOTE:For linear disk groups, the pool name is the disk group name (the disk group always occupies 100% of the pool). scrub-status Optional. Shows disk-group properties related to the scrub utility, including the scrub duration goal. [<disk-groups>] Optional. A comma-separated list of the names or serial numbers of the disk groups for which to show information. A name that includes a space must be enclosed in double quotes. If this parameter is omitted, information is shown for all disk groups.
Output	Name The name of the disk group. Blocksize Shown by the detail parameter. The size of a block, in bytes. Size The capacity of the disk group, formatted to use the current base, precision, and units. Free The amount of free space in the disk group, formatted to use the current base, precision, and units. Class Shown by the detail parameter. Linear: The disk group acts as a linear pool. Virtual: The disk group is in a virtual pool. Pool The name of the pool that contains the disk group. Tier Performance: The disk group is in the highest storage tier, which uses SSDs (high speed). Standard: The disk group is in the storage tier that uses enterprise-class spinning SAS disks (10k/15k RPM). Archive: The disk group is in the lowest storage tier, which uses midline spinning SAS disks (<10k RPM, high capacity). Read Cache: The disk group uses SSDs, which provide high-speed read cache for a storage pool. % of Pool The percentage of pool capacity that the disk group occupies. Own Either the preferred owner during normal operation or the partner controller when the preferred owner is offline. Current Owner Shown by the detail parameter. See Own. Preferred Owner Shown by the detail parameter. Controller that owns the disk group and its volumes during normal operation. RAID The RAID level of the disk group. Disks The number of disks in the disk group. Spares Shown by the detail parameter. For a linear disk group, the number of spares assigned to the disk group. For a virtual disk group, 0. Chk For RAID levels except NRAID and RAID 1, the chunk size for the disk group. For NRAID and RAID 1, not applicable (N/A). Chunk Size Shown by the detail parameter. See Chk. Status CRIT: Critical. The disk group is online but isn't fault tolerant because some of its disks are down. DMGD: Damaged. The disk group is online and fault tolerant, but some of its disks are damaged. FTDN: Fault tolerant with a down disk. The disk group is online and fault tolerant, but some of its disks are down. FTOL: Fault tolerant. MSNG: Missing. The disk group is online and fault tolerant, but some of its disks are missing. OFFL: Offline. Either the disk group is using offline initialization, or its disks are down and data may be lost. QTCR: Quarantined critical. The disk group is critical with at least one inaccessible disk. For example, two disks are inaccessible in a RAID 6 disk group or one disk is inaccessible for other fault-tolerant RAID levels. If the inaccessible disks come online or if after 60 seconds from being quarantined the disk group is QTCR or QTDN, the disk group is automatically dequarantined. QTDN: Quarantined with a down disk. The RAID 6 disk group has one inaccessible disk. The disk group is fault tolerant but degraded. If the inaccessible disks come online or if after 60 seconds from being quarantined the disk group is QTCR or QTDN, the disk group is automatically dequarantined. QTOF: Quarantined offline. The disk group is offline with multiple inaccessible disks causing user data to be incomplete, or is an NRAID or RAID 0 disk group. STOP: The disk group is stopped. UNKN: Unknown. UP:The disk group is online and does not have fault-tolerant attributes. Current Job DRSC: A disk is being scrubbed. EXPD: The disk group is being expanded. INIT: The disk group is initializing. PRERCON: At least one disk in the disk group is being preemptively reconstructed. RBAL: The ADAPT disk group is being rebalanced. RCON: At least one disk in the disk group is being reconstructed. VDRAIN: The virtual disk group is being removed and its data is being drained to another disk group. VPREP: The virtual disk group is being prepared for use in a virtual pool. VRECV: The virtual disk group is being recovered to restore its membership in the virtual pool. VREMV: The disk group and its data are being removed. VRFY: The disk group is being verified. VRSC: The disk group is being scrubbed. Blank if no job is running. Job% 0%-99%: Percent complete of running job Blank if no job is running (job has completed) Current Job Completion Shown by the detail parameter. See Job%. Serial Number Shown by the detail parameter. The serial number of the disk group. Active Drive Spin Down Enable Shown by the detail parameter. Disabled: DSD is disabled for the disk group. Enabled - all spinning: DSD is enabled for the disk group. Partial spin-down: DSD is enabled for the disk group and its disks are partially spun down to conserve power. Full spin-down: DSD is enabled for the disk group and its disks are fully spun down to conserve power. Active Drive Spin Down Delay Shown by the detail parameter. For spinning disks in a disk group, the period of inactivity after which the disks and dedicated spares will automatically spin down, from 1 to 360 minutes. The value 0 means spin down is disabled. Scrub Duration Goal Shown by the scrub-status parameter. The requested duration of a disk-group scrub operation, in hours. A value of 0 indicates that the scrub duration will use the system default duration setting of 720 hours (30 days). A value of 1 to 1080 hours (45 days) will cause the storage system to adjust the resources available to the scrub operation, which could affect other performance. There is no guarantee that this scrub duration goal is achievable, due to such considerations as disk-group size or abnormally high host activity. Sec Fmt The sector format of disks in the disk group. 512n: All disks use 512-byte native sector size. Each logical block and physical block is 512 bytes. 512e: All disks use 512-byte emulated sector size. Each logical block is 512 bytes and each physical block is 4096 bytes. Eight logical blocks will be stored sequentially in each physical block. Logical blocks may or may not be aligned with physical block boundaries. Mixed: The disk group contains a mix of 512n and 512e disks. This is supported, but for consistent and predictable performance, do not mix disks of different sector size types (512n, 512e). Sector Format Shown by the detail parameter. See Sec Fmt. Stripe Width Shown by the detail parameter. For an ADAPT disk group, this specifies the stripe width to use. 8+2: Each stripe contains 8 data chunks and 2 parity chunks. Including spare capacity equivalent to the 2 largest disks, the minimum disk-group size is 12 disks. This is the default. 16+2: Each stripe contains 16 data chunks and 2 parity chunks. Including spare capacity equivalent to the 2 largest disks,the minimum disk-group size is 20 disks. This option has less overhead, but also less redundancy, than the 8+2 option. Target Spare Capacity Shown by the detail parameter. <size>: The target spare capacity in GiB. If the value is 0, the absolute minimum spare space will be used. default: The target spare capacity will be the sum of the two largest disks in the disk group, which is sufficient to fully recover fault tolerance after loss of any two disks in the group. For a non-ADAPT disk group, N/A. Actual Spare Capacity Shown by the detail parameter. For an ADAPT disk group, the actual spare capacity in GiB. For a non-ADAPT disk group, N/A. Critical Disk Capacity Shown by the detail parameter. For an ADAPT disk group, the amount of storage space that is not currently protected against disk loss, in GiB. (Normally all data is protected against loss of two disks.) Degraded Disk Capacity Shown by the detail parameter. For an ADAPT disk group, the amount of storage space that is protected against loss of a single disk only, in GiB. (Normally all data is protected against loss of two disks.) Linear Volume Partition Boundary Shown by the detail parameter. The block size by which volumes are aligned in a linear ADAPT disk group. Disk group space is allocated in multiples of this size to such volumes. Metadata Size Shown by the detail parameter. The amount of metadata the disk group is currently using. Health OK Degraded Fault N/A Unknown Reason If Health is not OK, this field shows the reason for the health state. Health Reason Shown by the detail parameter. See Reason. Action If Health is not OK, this field shows recommended actions to take to resolve the health issue. Health Recommendation Shown by the detail parameter. See Action.
Examples	Show information about all disk groups. # show disk-groups Show information about disk group dg0002. # show disk-groups dg0002 Show additional information about disk group dg0002. # show disk-groups dg0002 detail
Basetypes	disk-groups status
See also	show disks show pools