ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • storage aggregate add-disks

    Add disks to an aggregate

    Availability: This command is available to cluster administrators at the admin privilege level.

    Description

    The storage aggregate add-disks command adds disks to an existing aggregate. You must specify the number of disks or provide a list of disks to be added. If you specify the number of disks without providing a list of disks, the system selects the disks.

    Parameters

    -aggregate <aggregate name> - Aggregate

    This parameter specifies the aggregate to which disks are to be added.

    [-diskcount <integer>] - Disk Count

    This parameter specifies the number of disks that are to be added to the aggregate.

    { [-T, -disktype {ATA | BSAS | FCAL | FSAS | LUN | MSATA | SAS | SSD | VMDISK | SSD-NVM | SSD-CAP | SSD-ZNS | VMLUN | VMLUN-SSD}] - Disk Type

    This parameter specifies the type of disk that is to be added. It must be specified with the -diskcount parameter when adding disks to a Flash Pool.

    Use this parameter when adding spare SSDs to an aggregate to convert it to a Flash Pool.

    Only the aggregates marked as hybrid-enabled can be converted to Flash Pools. Use storage aggregate modify command to mark the aggregate as hybrid-enabled .
    When this parameter is used, disk selection is not influenced by RAID options raid.mix.hdd.disktype.capacity , raid.mix.hdd.disktype.performance , or raid.mix.disktype.solid_state . Only disks of the specified type are considered eligible for selection.
    | [-C, -diskclass {capacity | performance | archive | solid-state | array | virtual}] - Disk Class

    This parameter specifies the class of disk that is to be added. All disks that belong to the specified class are considered eligible for selection. The possible values are:

    • capacity = Capacity-oriented, near-line disk types. Includes disk types FSAS, BSAS and ATA.

    • performance = Performance-oriented, enterprise class disk types. Includes disk types FCAL and SAS.

    • archive = Archive class SATA disks in multi-disk carrier storage shelves. Includes disk type MSATA.

    • solid-state = Solid-state drives. Includes disk type SSD, SSD-CAP and SSD-NVM.

    • array = Logical storage devices backed by storage arrays and used by Data ONTAP as disks. Includes disk type LUN.

    • virtual = Virtual disks that are formatted and managed by the hypervisor. Includes disk type VMDISK.

    When this parameter is used, disk selection is not influenced by RAID options raid.mix.hdd.disktype.capacity , raid.mix.hdd.disktype.performance , or raid.mix.disktype.solid_state .
    [-chksumstyle <aggrChecksumStyle>] - Checksum Style

    This parameter specifies the checksum style for the disks to be added to an aggregate. It is not applicable if -disklist or -mirror-disklist is specified. The possible values are block for block checksum and advanced_zoned for advanced zoned checksum (AZCS). By default, disks with the same checksum style as the aggregate are selected. This behavior can be overridden by using this parameter to create a mixed checksum aggregate. A mixed checksum aggregate can support only the block and advanced_zoned checksum styles.

    [-disksize <integer>] - Disk Size(GB)

    This parameter specifies the size, in GB, of the disks that are to be added to the aggregate. Disks with a usable size between 90% and 105% of the specified size are selected.

    | [-d, -disklist <disk path name>,…​] - Disks

    This parameter specifies a list of disks to be added. If you specify the -disklist parameter, you cannot further qualify the list of disks to be added by count, checksum style, size or type.

    [-mirror-disklist <disk path name>,…​] - Disks for Mirrored Plex

    This parameter specifies a list of mirror disks to be added. It must contain the same number of disks specified in -disklist parameter. If you specify the -mirror-disklist parameter, you cannot further qualify the list of disks to be added by count, checksum style or type.

    { [-ignore-pool-checks <true>] - Don’t Enforce Plex Pool Best Practices

    The disks in a plex are normally required to come from the same SyncMirror pool. This behavior can be overridden with this parameter when it is set to true .

    [-f, -allow-mixed-rpm <true>] - Allow Disks With Different RPM Values

    This parameter specifies whether disks that have different RPM values can be added. For example, SAS disks can rotate at 10,000 or 15,000 RPM. If this parameter is set to true and a list of disks are provided by using the -disklist parameter, the disks will be added even if the SAS disks you specify have different RPM values. This parameter works similarly for ATA disks, which can rotate at 5,400 or 7,200 RPM.

    +
    NOTE: This parameter is applicable only when the -disklist or -mirror-disklist parameter is used.

    [-allow-same-carrier <true>] - Allow Same RAID Group Within Carrier

    This parameter can be used to allow two disks housed in the same carrier to be in the same RAID group when you add disks to an aggregate.

    Having disks in the same carrier in the same RAID group is not desirable because a carrier failure can cause a simultaneous outage for two disks in the same RAID group. You can add a disk to an aggregate that causes this situation, but when an alternate disk becomes available, Data ONTAP automatically initiates a series of disk copy operations to put the disks into different RAID groups. For this reason, you should use this parameter only when necessary. When possible, allow Data ONTAP to choose disks that need to be added to the aggregate.

    This parameter affects only the add-disks operation. It is not a persistent attribute of the aggregate.

    | [-storage-pool <storage pool name>] - Storage Pool

    This parameter specifies the name of the SSD storage pool from which available allocation units are added to a given aggregate. This parameter cannot be used with the -disk-list or -disk-count parameters.

    [-allocation-units <integer>] - Allocation Units }

    This parameter specifies the number of allocation units to be added to a given aggregate from an SSD storage pool. Number of allocation units available and size of each unit can be found using the storage pool show-available-capacity command. This parameter works only when you also use the -storage-pool parameter.

    [-n, -simulate <true>] - Simulate Addition of Disks

    This parameter is used with the disktype and diskcount parameters to determine which disks would be added without actually performing the addition of disks operation.

    [-g, -raidgroup {new|all|<raidgroup>}] - RAID Group

    This parameter enables the administrator to specify which RAID group will receive the added disks. If this parameter is not used, the disks are added to the most recently created RAID group until it is full, then new raid groups are created and filled until all the disks are added. If a RAID group name rgX is specified, the disks are added to that RAID group. If new is specified, the disks are added to a new RAID group, even if the disks would fit into an existing RAID group. If all is specified, the disks are added to existing RAID groups until all existing RAID groups are full. Then Data ONTAP creates one or more new RAID groups and adds the remaining disks to the new groups. If the disk type or checksum style parameters are specified with this parameter, the command operates only on the RAID groups with the matching disk type or checksum style, even if all is specified.

    [-cache-raid-group-size <integer>] - RAID Group Size for Cache Tier

    This parameter specifies the maximum number of disks that can be included in an SSD RAID group for this aggregate.

    This parameter is applicable only when adding SSDs for the first time to a hybrid-enabled aggregate. If this parameter is not used when the first SSDs are added to the aggregate, the maximum RAID group size for the SSD cache is set to the default SSD RAID group size for the RAID type of the SSD cache.
    [-t, -raidtype {raid_tec|raid_dp|raid4|raid_ep}] - RAID Type

    This parameter specifies the type for the new RAID groups that would be created while adding disks to the aggregate. Use this parameter when you add the first RAID group comprised of SSDs to a hybrid-enabled aggregate. The values are raid4 for RAID4, raid_dp for RAID Double Parity, and raid_tec for RAID-TEC. The default value is the type of RAID groups of the aggregate, except for RAID-TEC hybrid-enabled aggregates where the SSD tier will default to raid_dp . An aggregate might include a mix of different RAID types.

    Examples

    The following example adds 10 disks to an aggregate named aggr0. The disks are added to a RAID group named rg1:

    cluster1::> storage aggregate add-disks -aggregate aggr0 -diskcount 10 -raidgroup rg1

    In this example, an aggregate is converted to a Flash Pool aggregate using SSD capacity from a storage pool. The aggregate was created using RAID-DP for the hard disks and the SSDs are added using RAID4.

    cluster1::> storage aggregate add-disks -aggregate FlashPool -storage-pool SP1 -allocation-units 1 -raidtype raid4
    Top of Page