Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.

Dell PowerVault ME5 Series Storage System CLI Reference Guide

PDF

add disk-group

Description Creates a disk group using specified disks.
  • If the system has no disk groups, you can create either a linear or a virtual disk group. Whichever storage type you choose, the system will use that type for new disk groups. To switch to the other storage type, you must first remove all disk groups by using the remove disk-groups command.
  • All disks in a disk group must be the same type (enterprise SAS, for example).
NOTE:

A disk group can contain a mix of 512-byte native sector size (512n) disks and 512-byte emulated sector size (512e) disks. For consistent and predictable performance, do not mix disks of different sector size types (512n, 512e).

For virtual storage, a disk group of midline SAS disks will be used in the Archive tier. A disk group of enterprise SAS disks will be used in the Standard tier. A disk group of SSDs can be used:

  • In the Performance tier (with the Performance tier license).
  • As an all-flash array (without the Performance Tier license).
  • As read cache. A virtual pool can contain only one read-cache disk group .
A virtual pool cannot contain both a read-cache disk group and a Performance tier. At least one virtual disk group must exist in a pool before a read-cache disk group can be added. A read-cache disk group can contain a maximum of two disks.

When you add a virtual disk group, the system will first prepare the disk group to be added to a virtual pool. During preparation, the disk group status will be VPREP and the disk group cannot be removed. When preparation is complete, the disk group will start initializing. During initialization, the disk group status will be INIT and the disk group will be available to store user data-or the disk group can be removed.

  • All virtual disk groups in the same tier in a virtual pool should have the same RAID level, capacity, and physical number of disks. This will provide consistent performance across the tier.
  • To replace a single-disk read-cache disk group with a multiple-disk read-cache disk group, simply remove the read cache and re-add it.
NOTE: If the only disk group in a virtual pool is quarantined, the pool will be inaccessible and attempting to add a new disk group to that pool will fail with a "duplicate name" error. Before you can add a disk group to that pool, you must resolve the problem with the quarantined disk group.
Minimum role standard
Syntax

add disk-group

[assigned-to a|b|auto]

[chunk-size 64k|128k|256k|512k]

disks disks

[level nraid|raid0|r0|raid1|r1|raid5|r5|raid6|r6|raid10|r10|ADAPT]

[mode online|offline]

[pool a|b]

[spare <disks>]

[spare-capacity <size>[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]|default]

[stripe-width 8+2|16+2]

type linear|virtual|read-cache

[<name>]

Parameters assigned-to a|b|auto

Optional for linear storage. Prohibited for virtual storage. For a system operating in Active-Active ULP mode, this specifies the controller module to own the group. To let the system automatically load-balance groups between controller modules, use auto or omit this parameter. In Single Controller mode, this parameter is ignored; the system automatically load-balances groups in anticipation of the insertion of a second controller in the future.

chunk-size 64k|128k|256k|512k

Optional for linear storage. Prohibited for virtual storage. Prohibited for ADAPT.

For linear storage, this specifies the amount of contiguous data, in KB, that is written to a disk-group member before moving to the next member of the group. For NRAID and RAID 1, chunk-size has no meaning and is therefore not applicable. The default is 512k.

For virtual storage, the system will use one of the following chunk sizes, which cannot be changed:

  • RAID 1: Not applicable.
  • RAID 5 and RAID 6:
    • With 2,4, or 8 non-parity disks: 512k. For example, a RAID-5 group with 3, 5, or 9 total disks or a RAID-6 group with 4, 6, or 10 total disks.
    • Other configurations: 64k
  • RAID 10: 512k
For an ADAPT disk group, the system will automatically determine the proper chunk size.

disks <disks>

Specifies the IDs of the disks to include in the group. For disk syntax, see Command syntax. The minimum and maximum numbers of disks supported for each RAID level are:

NRAID: 1 (linear storage only; not fault tolerant)

RAID 0: 2-16 (linear storage only; not fault tolerant)

RAID 1: 2

RAID 5: 3-16

RAID 6: 4-16

RAID 10: 4-16

ADAPT: 12-128

RAID 10 requires a minimum of two RAID-1 subgroups each having two disks. RAID 50 requires a minimum of two RAID-5 subgroups each having three disks. NRAID is automatically used for a read-cache disk group with a single disk. RAID 0 is automatically used for a read-cache disk group with multiple disks.

RAID 10 requires a minimum of two RAID 1 subgroups each having two disks. The system automatically uses NRAID for a read-cache disk group with a single disk, or RAID 0 for a read-cache disk group with multiple disks.

NOTE: RAID 5 and RAID 6 disk groups, which have parity disks, should be created using the "power of 2" method to align properly with virtual pages. Failure to follow this method can result in significant degradation of sequential write performance.

RAID 5 disk groups should be created using 3, 5, or 9 disks. RAID 6 disk groups should be created using 4, 6, or 10 disks.

NOTE:
level nraid|raid0|r0|raid1|r1|raid5|r5|raid6|r6|raid10|r10|ADAPT

Required for a linear disk group. Required for a virtual disk group. Prohibited for a read-cache disk group. Specifies the RAID level to apply to the member disks.

mode online|offline

Optional for a linear group. Prohibited for a virtual or read-cache disk group. Specifies whether the group is initialized online or offline.

  • online: After a brief initialization period (seconds), the disk-group state is set toFTOL and I/O operations can be performed on the disk group. Subsequently, an initialization pass across the LBA extent is performed during which the existing data on the member data disks of the disk group is read, parity is generated, and only parity is written to the disk group (the data-area contents are preserved and not zeroed). This pass can take hours to complete on a large disk group. Online mode is the default for a linear disk group. Online mode is always used for a virtual disk group.
  • offline: The disk group will be in an unavailable, offline (OFFL) state during the initialization process, during which zeros are written to all data and parity sectors of the LBA extent of the disk group. This can take hours to complete on a large disk group but is faster than online mode. When initialization is complete, the disk group state is set to FTOL and I/O operations can be performed on the disk group.
pool a|b

Required for a virtual or read-cache disk group. Prohibited for a linear disk group. Specifies the name of the virtual pool to contain the disk group. If the pool does not already exist, it will be created.

spare disks

Optional for a linear disk group. Prohibited for a virtual or read-cache disk group. Prohibited for ADAPT. Specifies the IDs of from 1 to 4 dedicated spares to assign to a RAID 1, 5, 6, or 10 disk group. For disk syntax, see Command syntax. Only global spares are used for virtual disk groups.

spare-capacity <size>[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]|default

Optional. For an ADAPT disk group, this specifies the target spare capacity.

  • <size>[B|KB|MB|GB|TB|KiB|MiB|GiB|TiB]: Sets the target spare capacity to a specific size. The unit is optional (B represents bytes). If no unit is specified, GiB will be used, regardless of the current base. Whichever unit is set, internally the value will be rounded down to the nearest GiB. If the value is set to 0, the absolute minimum spare space will be used. If this parameter is omitted, the default setting will be used.
  • default: Sets the target spare capacity to 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.

stripe-width 8+2|16+2

Optional. 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.
type linear|virtual|read-cache

Required. Specifies the type of disk group to create.

  • linear : A disk group for linear storage.
  • virtual : A standard disk group for virtual storage.
  • read-cache : A disk group for use as read cache for a virtual pool.
<name>

Optional for a virtual or read-cache disk group. Required for a linear disk group. Specifies a name for the new disk group. The name must be unique system-wide. Input rules:

  • The value is case sensitive.
  • The value can have a maximum of 32 bytes.
  • The value can include spaces and printable UTF-8 characters except: " , < \
  • A value that includes a space must be enclosed in double quotes.
If this parameter is omitted, the system will generate the name dgcontroller-ID# where # starts at 01 for a virtual disk group, or rccontroller-ID for a read-cache disk group.
Examples Add linear RAID-1 disk group dg1 with one spare.

# add disk-group type linear disks 1.20-21 level r1 spare 1.22 dg1

Add ADAPT linear disk group ALDG.

# add disk-group type linear disks 1.1-12 level adapt ALDG

Add a virtual RAID-6 disk group to pool A. The resulting group will have an auto-generated name.

# add disk-group type virtual disks 1.16-19 level r6 pool a

Add an ADAPT virtual disk group to pool B.

# add disk-group type virtual disks 2.1-12 level adapt pool b

Add a read-cache disk group to pool B. The resulting group will be named rcB.

# add disk-group type read-cache disks 1.18-19 pool b

See also

expand disk-group

remove disk-groups

set disk-group

show disk-groups

show disks


Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\