storage aggregate modify

Modify aggregate attributes

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

Description

The storage aggregate modify command can be used to modify attributes of an aggregate such as RAID type and maximum RAID group size.

Changing the RAID type immediately changes the RAID group type for all RAID groups in the aggregate.

Changing the maximum RAID size does not cause existing RAID groups to grow or to shrink; rather, it affects the size of RAID groups created in the future, and determines whether more disks can be added to the RAID group that was most recently created.

Parameters

-aggregate <aggregate name> - Aggregate
This parameter specifies the storage aggregate that is to be modified.
[-disktype | -T {ATA | BSAS | FCAL | FSAS | LUN | MSATA | SAS | SSD | VMDISK | SSD-NVM}] - Disk Type
This parameter specifies either the HDD tier or the SSD tier when changing the RAID type of a Flash Pool. If the HDD tier is composed of more than one type of disk, specifying any of the disk types in use causes that tier to be modified.
[-free-space-realloc {on|off}] - Free Space Reallocation
This parameter specifies whether free space reallocation is enabled on the aggregate.

Free space reallocation optimizes the free space in an aggregate immediately before Data ONTAP writes data to the blocks in that aggregate.

The default setting is off.

[-ha-policy {sfo|cfo}] - HA Policy
This parameter specifies the high-availability policy to be used in the context of a root recovery procedure. Do not modify this setting unless directed to do so by a customer support representative.
[-percent-snapshot-space <percent>] - Space Reserved for Snapshot Copies
This parameter is used to set the space reserved for Snapshot copies to the specified value. For example, to set the snapshot reserve to 5%, you should enter -percent-snapshot-space 5.
[-space-nearly-full-threshold-percent <percent>] - Aggregate Nearly Full Threshold Percent
This optionally specifies the percentage at which the aggregate is considered nearly full, and above which an EMS warning will be generated. The default value is 95%. The maximum value for this option is 99%. Setting this threshold to 0 disables the aggregate nearly full space alerts.
[-space-full-threshold-percent <percent>] - Aggregate Full Threshold Percent
This optionally specifies the percentage at which the aggregate is considered full, and above which a critical EMS error will be generated. The default value is 98%. The maximum value for this option is 100%. Setting this threshold to 0 disables the aggregate full space alerts.
[-hybrid-enabled {true|false}] - Hybrid Enabled
If the hybrid-enabled option is set to "true", the aggregate is marked as hybrid_enabled, that is, the aggregate can contain a mix of SSDs and HDDs (Hard Disk Drives, e.g., SAS, SATA, and/or FC). By default, aggregates cannot be marked "hybrid_enabled" if the aggregate contains FlexVols that cannot be write cached. A FlexVol cannot be write-cached if it is part of an aggregate created in Data ONTAP 7. Use -force-hybrid-enabled to over-ride this behavior.
[-force-hybrid-enabled | -f [true]] - Force Marking of Aggregate as Hybrid Enabled
By default, aggregates cannot be marked "hybrid_enabled" if the aggregate contains FlexVols that cannot be write cached. A FlexVol cannot be write-cached if it is part of an aggregate created in Data ONTAP 7. Use -force-hybrid-enabled to over-ride this behavior. Note that read caching will be enabled on these FlexVols, but write caching will be disabled.Setting this parameter to true would mark the aggregate as hybrid_enabled; this means that the aggregate can contain a mix of SSDs and HDDs (Hard Disk Drives, for example, SAS, SATA and/or FC). This parameter is used to force marking aggregates which have FlexVols that cannot be write cached as hybrid enabled. FlexVols in the aggregate marked as hybrid enabled using this parameter which cannot participate in write-caching will only have read-caching enabled. All other FlexVols in the aggregate can participate in both read and write caching.
[-maxraidsize | -s <integer>] - Max RAID Size
This parameter specifies the maximum number of disks that can be included in a RAID group for this aggregate.
Note: For Flash Pools, this option controls the maximum size of the HDD RAID groups.
[-cache-raid-group-size <integer>] - Flash Pool SSD Tier Maximum RAID Group Size
This parameter specifies the maximum number of disks that can be included in a SSD RAID group for this Flash Pool.
Note: This parameter is applicable only for Flash Pools.
[-raidtype | -t {raid_tec|raid_dp|raid4}] - RAID Type
This parameter specifies the RAID type for RAID groups on the aggregate. The possible values are raid4 for RAID4, raid_dp for RAID-DP, and raid_tec for RAID-TEC. If you change the RAID type from RAID4 to RAID-DP, each RAID group allocates a spare disk for the group's second parity disk and begins a reconstruction process. If you change the RAID type from RAID-DP to RAID-TEC, each RAID group allocates a spare disk for the group's third parity disk and begins a reconstruction process. Changing the RAID type from RAID4 to RAID-TEC or vice-versa is not supported. To change the RAID type from RAID4 to RAID-TEC, first change from RAID4 to RAID-DP and then to RAID-TEC.
[-resyncsnaptime <integer>] - SyncMirror Resync Snapshot Frequency in Minutes
This parameter sets the mirror resynchronization snapshot frequency to be the given number of minutes. The default value is 60 (minutes).
[-state <aggregate state>] - State
This deprecated parameter specifies the state of the aggregate. The possible values are as follows:
  • online - Immediately sets the aggregate online. All volumes on the aggregate are set to the state they were in when the aggregate was taken offline or restricted. The preferred command to bring an aggregate online is storage aggregate online.
  • offline - Takes an aggregate offline. You cannot take an aggregate offline if any of its volumes are online. The preferred command to take an aggregate offline is storage aggregate offline.
  • restricted - Restricts the aggregate. You cannot restrict an aggregate if any of its volumes are online. The preferred command to restrict an aggregate is storage aggregate restrict.
[-is-autobalance-eligible {true|false}] - Is Eligible for Auto Balance Aggregate (privilege: advanced)
This specifies whether the aggregate is 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.
[-autobalance-unbalanced-threshold-percent <integer>] - Threshold When Aggregate Is Considered Unbalanced (%) (privilege: advanced)
This parameter sets the space used threshold percentage that will cause the Auto Balance Aggregate feature to consider an aggregate as unbalanced.
[-autobalance-available-threshold-percent <integer>] - Threshold When Aggregate Is Considered Balanced (%) (privilege: advanced)
This parameter sets the threshold percentage which will determine if an aggregate is a target destination for a move. The Auto Balance Aggregate feature will attempt to move volumes from an unbalanced aggregate until it is under this percentage.
[-resync-priority {high(fixed)|high|medium|low}] - Resynchronization Priority
This parameter specifies the new resynchronization priority value for the specified aggregate. This field cannot be modified for unmirrored or Data ONTAP system aggregates.

Possible values for this parameter are:

  • high: Mirrored data aggregates with this priority value start resynchronization first.
  • medium: Mirrored data aggregates with this priority value start resynchronization after all the system aggregates and data aggregates with 'high' priority value have started resynchronization.
  • low: Mirrored data aggregates with this priority value start resynchronization only after all the other aggregates have started resynchronization.
[-single-instance-data-logging {off|on}] - Enable SIDL
This parameter specifies whether Single Instance Data Logging feature is enabled on the aggregate and the constituent volumes on the aggregate. This feature improves user write perfomance by optimizing the amount of data nvlogged by user writes on platforms where NVRAM and secondary storage are of same media type.
[-is-inactive-data-reporting-enabled {true|false}] - Inactive Data Reporting Enabled
This parameter specified whether the reporting of how much user data is inactive should be enabled on the aggregate and volumes on the aggregate. This parameter is not allowed on FabricPools.

Examples

The following example changes all RAID groups on an aggregate named aggr0 to use RAID-DP:

cluster1::> storage aggregate modify -aggregate aggr0 -raidtype raid_dp

The following example changes all RAID groups with FSAS disks in an aggregate named aggr0 to use RAID-TEC:

cluster1::> storage aggregate modify -aggregate aggr0 -disktype FSAS -raidtype raid_tec