Index  |  Top  -  Up Data ONTAP 8.3

storage aggregate create

Create an aggregate

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

Description

The storage aggregate create command creates an aggregate. An aggregate consists of disks. You must specify the number of disks or provide a list of disks to be added to the new aggregate. If you specify the number of disks without providing a list of disks, the system selects the disks.

When creating an aggregate, you can optionally specify the aggregate's home node, the RAID type for RAID groups on the aggregate, and the maximum number of disks that can be included in a RAID group.

Parameters

-aggregate <aggregate name> - Aggregate

This parameter specifies the name of the aggregate that is to be created.

{  [-chksumstyle <aggrChecksumStyle>] - Checksum Style

This parameter specifies the checksum style for the aggregate. The values are block for Block Checksum and advanced_zoned for Advanced Zoned Checksum (AZCS).

   -diskcount <integer> - Number Of Disks

This parameter specifies the number of disks that are to be included in the aggregate, including the parity disks. The disks in this newly created aggregate come from the pool of spare disks. The smallest disks in this pool are added to the aggregate first, unless you specify the -disksize parameter.

   [-diskrpm | -R <integer>] - Disk RPM

This parameter specifies the RPM of the disks on which the aggregate is to be created. Possible values include 5400, 7200, 10000, and 15000.

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

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

   [-disktype | -T {ATA | BSAS | FCAL | FSAS | LUN | MSATA | SAS | SATA | SSD | VMDISK}] - Disk Type

This parameter specifies the type of disk on which the aggregate is to be created.

   [-mirror | -m [true]] - Mirror

This parameter specifies that the new aggregate be mirrored (have two plexes). If this parameter is set to true, the specified disks are split between the two plexes. By default, the new aggregate will not be mirrored. You cannot use the -mirror parameter when supplying a specific list of disks with either the -disklist or -mirror-disklist parameters.

   [-node {<nodename>|local}] - Node

This parameter specifies the home node for the aggregate. If this parameter is not specified, Data ONTAP selects the node where the aggregate is created.

|  -disklist | -d <disk path name>, ... - Disks for First Plex

This parameter specifies a list of disks to be added to the new aggregate. If you specify the -disklist parameter, you cannot further qualify the list of disks to be added by count, checksum style, type, size, or RPM. You cannot use the -disklist parameter when the -mirror parameter is set to true.

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

This parameter specifies a list of mirror disks to be added to the new mirrored aggregate. 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, type, size, or RPM. You cannot use the -mirror-disklist parameter when the -mirror parameter is set to true.

[-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. This option cannot be used when the -mirror option is set to true

[-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 create an aggregate with this characteristic, 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 the disks from which to create the aggregate.

This parameter affects only the aggregate creation operation. It is not a persistent attribute of the aggregate.

[-allow-mixed-rpm | -f [true]] - Allow Disks With Different RPM Values

This parameter specifies whether the aggregate can contain disks that have different RPM values. 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 aggregate will be created 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.

[-maxraidsize | -s <integer>] - Max RAID Size

This parameter specifies the maximum number of disks that can be included in a RAID group.

[-raidtype | -t {raid_dp|raid4}] - RAID Type

This parameter specifies the type for RAID groups on the aggregate. The values are raid4 for RAID 4 and raid_dp for RAID Double Parity. The default setting is raid_dp . This parameter is not needed for array LUNs because they are always created with the RAID0 raidtype.

[-simulate [true]] - Simulate Aggregate creation

This option simulates the aggregate creation and prints the list of disks that would be used for the aggregate.

[-force-small-aggregate [true]] - Force the Creation of a Small Aggregate (privilege: advanced)

This parameter can be used to force the creation of a 2-disk RAID4 aggregate, or a 3-disk or 4-disk RAID-DP aggregate.

[-is-autobalance-eligible {true|false}] - Is Eligible for Auto Balance Aggregate (privilege: advanced)

This specifies whether the aggregate will be considered by the Auto Balance Aggregate feature. If the Auto Balance Aggregate feature is not used, this field is not used. When this parameter is set to true the Auto Balance Aggregate feature might recommend moving volumes to or from this aggregate in order to balance system workload. When this parameter is set to false the aggregate will not be considered as a destination for the Auto Balance Aggregate feature allowing for predictability in data placement. The default value is false.

Examples

The following example creates an aggregate named aggr0 on a home node named node0. The aggregate contains 20 disks and uses RAID-DP. The aggregate contains regular FlexVol volumes:

cluster1::> storage aggregate create -aggregate aggr0 -nodes node0
-diskcount 20 -raidtype raid_dp -volume-style flex

The following example creates an aggregate named aggr0 on a home node named node0. The aggregate contains the disks specified and uses RAID-DP

cluster1::> storage aggregate create -aggregate aggr0 -nodes node0
-disklist 1.0.15,1.0.16,1.0.17,1.0.18,1.0.19 -raidtype raid_dp

The following example creates an aggregate named aggr0 on a home node named node0. The aggregate contains 20 disks of size 10GB and of type SAS:

cluster1::> storage aggregate create -aggregate aggr0 -nodes node0
-diskcount 20 -disksize 10 -disktype SAS

The following example creates a mirrored aggregate named aggr0 on the local node. The aggregate contains 10 disks in each plex:

cluster1::> storage aggregate create -aggregate aggr0 -mirror    
-diskcount 20 

Index  |  Top  -  Up Data ONTAP 8.3

Copyright © 1994-2015 NetApp, Inc. Legal Information