|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Add-NcAggr
NAME
Add-NcAggr
SYNOPSIS
Add disks to the specified aggregate.
SYNTAX
Add-NcAggr [-Name] <String> -DiskCount <Int32> [-ChecksumStyle <String>] [-D
iskSize <Int64>] [-GroupSelectionMode <String>] [-ForceSparePool] [-Upgrade6
4BitMode <String>] [-DiskType <String>] [-Controller <NcController[]>] [-Rai
dGroup <String>] [-WhatIf] [-Confirm] [<CommonParameters>]
Add-NcAggr [-Name] <String> -Disks <Object[]> [-GroupSelectionMode <String>]
[-ForceSparePool] [-Upgrade64BitMode <String>] [-AllowSameCarrier] [-Contro
ller <NcController[]>] [-RaidGroup <String>] [-WhatIf] [-Confirm] [<CommonPa
rameters>]
DESCRIPTION
Add disks to the specified aggregate. The disks to add are specified in the
same way as for New-NcAggr. By the time the API returns, the disk(s) may no
t yet be completely added. Use Get-NcAggr to query the aggregate status to
determine when it has finished growing due to the added disk(s). When the U
pgrade64BitMode input is provided to this API, the API produces a set of res
ults in the background. These results are not available as output from Add-
NcAggr. Use the Get-NcAggr and Get-NcVol cmdlets to query the results of th
e 64-bit upgrade process on the aggregate and flexible volumes, respectively
.
PARAMETERS
-Name <String>
Name of the aggregate to which the disks will be added.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-DiskCount <Int32>
Number of disks to add, including the parity disks. The disks will come
from the pool of spare disks. The smallest disks in this pool join the
aggregate first, unless the DiskSize argument is specified. Either the
DiskCount or Disks argument must be specified.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ChecksumStyle <String>
Specifies the checksum style for the disks to be added to an aggregate.
This input is not allowed if a list of disks to use is specified throug
h the Disks parameter. The possible values:
"advanced_zoned" - advanced_zoned checksum (azcs)
"block" - block.
By default, disks with same checksum style as the aggregate are selected
. Use this option to override that behavior and create a mixed checksum
aggregate. "zoned" is not supported as one of the possible values as a
mixed checksum aggregate can support only block and advanced_zoned chec
ksum styles.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DiskSize <Int64>
The individual disk size in bytes. Disks that are within approximately
20% of the specified size will be selected. If the DiskSize argument is
not specified, existing groups are appended with disks that are the bes
t match by size for the largest disk in the group. When starting new gr
oups, disks that are the best match by size for the largest disk in the
last raid group are selected first, then smaller disks, and finally larg
er disks. This DiskSize option is ignored if a specific list of disks i
s specified through the Disks parameter.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-GroupSelectionMode <String>
Specifies how Data ONTAP adds the specified disks to RAID groups. Legit
imate values are "last", "one", "new" or "all". GroupSelectionMode is a
n optional argument, and the behavior when it is not used is selected by
value of RaidGroup. If RaidGroup is used, the behavior is the same as f
or GroupSelectionMode "one". If RaidGroup is not used, the behavior is t
he same as for GroupSelectionMode "last". The RaidGroup option must be
used with GroupSelectionMode value "one", and it cannnot be used with ot
hers. If the string value is "last", Data ONTAP adds the specified disk
s to the existing last RAID group first. After the last RAID group is f
ull, it creates one or more new RAID groups and adds the remaining disks
to the new groups. If the string value is "one", Data ONTAP adds the s
pecified disks to the existing RAID group specified by RaidGroup option
until this specified RAID group is full. If the string value is "new",
Data ONTAP creates one or more new RAID groups and adds the specified di
sks to the new groups, even if they would fit into an existing RAID grou
p. The name of new RAID groups are selected automatically. It is not p
ossible to specify the name for the new RAID groups. If the string valu
e is "all", Data ONTAP adds the specified disks to existing RAID groups
first. Only after all existing RAID groups are full, it creates one or
more new RAID groups and adds the remaining disks to the new groups.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ForceSparePool
Disks in a plex are not normally permitted to span spare pools. This be
havior is overridden with this option.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Upgrade64BitMode <String>
Allows the aggregate to grow past 16 TB and begin 64-bit upgrade. If no
t supplied, adding disks past 16 TB to a 32-bit aggregate will fail. Le
gitimate values are "check", "grow_all", "grow_none", and "grow_reserved
". If the "check" value is specified, Add-NcAggr produces a summary of
the space impact which would result from upgrading the aggregate to 64-b
it. This summary includes the space usage of each contained volume afte
r the volume is upgraded to 64-bit and the amount of space that must be
added to the volume to successfully complete the 64-bit upgrade. The su
mmary can be obtained via the Get-NcAggr and Get-NcVol cmdlets. The agg
regate's summary is made available in the 'check' element that is part o
f the 'aggr-64bit-upgrade-info' typedef. The flexible volumes' summary
is made available in the 'check' element that is part of the 'volume-64b
it-upgrade-info' typedef. This option does not result in an upgrade to
64-bit or addition of disks. If the "grow_all" value is specified, Add-
NcAggr upgrades the aggregate to 64-bit if the total aggregate size afte
r adding the specified disks exceeds 16TB. This option allows Add-NcAgg
r to automatically grow volumes as needed if they run out of space due t
o the 64-bit upgrade. The volumes will be grown to accommodate all the
files within these volumes. This option does not affect volumes which h
ave autosize enabled. If the "grow_none" value is specified, Add-NcAggr
upgrades the aggregate to 64-bit if the total aggregate size after addi
ng the specified disks exceeds 16TB. This option does not allow Add-NcA
ggr to automatically grow volumes if they run out of space due to the 64
-bit upgrade. If the "grow_reserved" value is specified, Add-NcAggr upg
rades the aggregate to 64-bit if the total aggregate size after adding t
he specified disks exceeds 16TB. This option allows Add-NcAggr to autom
atically grow volumes if they run out of space due to the 64-bit upgrade
, but only to accommodate the space reserved files within these volumes.
This option does not affect volumes which have autosize enabled.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DiskType <String>
Type of disks to use: ATA, BSAS, EATA, FCAL, FSAS, LUN, SAS, SATA, SCSI,
XATA, XSAS, or SSD. This option is required when converting an existin
g aggregate to a hybrid one, or when operating on a hybrid aggregate. O
therwise, the option is not required.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Controller <NcController[]>
A clustered Data ONTAP controller to receive this cmdlet, as embodied by
an NcController object. This parameter is returned by the Connect-NcCo
ntroller cmdlet. If not specified, the value in the global variable Cur
rentNcController is used. In the latter case, if CurrentNcController co
ntains a collection of NcController objects, this cmdlet is invoked on e
ach controller in succession.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-RaidGroup <String>
Specifies the RAID group (for example rg0) to which the indicated disks
are to be added. By default, the controller fills up one RAID group wit
h disks before starting another RAID group. Suppose an aggregate curren
tly has one RAID group of 12 disks and its RAID group size is 14. If yo
u add 5 disks to this aggregate, it will have one RAID group with 14 dis
ks and another RAID group with 3 disks. The filer does not evenly distr
ibute disks among RAID groups.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Disks <Object[]>
Specific list of disks to add to the aggregate. Either the Disks or Dis
kCount argument must be specified.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-AllowSameCarrier
If specified, allow placing two disks from one carrier in one RAID group
.
Using two disks from one carrier that houses multiple disks in one RAID
group is not desirable. If that happens, Data ONTAP initiates a series o
f disk copy operations to correct that situation. Sometimes, selection o
f available spare disks makes it impossible to avoid placing two disks f
rom one carrier in one RAID group.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".
INPUTS
OUTPUTS
DataONTAP.C.Types.Aggr.AggrAttributes
NOTES
Category: aggr
API: aggr-add
Family: cluster
-------------- Example 1 --------------
C:\PS>Add-NcAggr aggr2 -DiskCount 3
Add three disks to aggregate 'aggr2'.
Name State TotalSize Used Available Disks RaidType RaidSize Volumes
---- ----- --------- ---- --------- ----- -------- -------- -------
aggr2 online 717.1 GB 0% 717.1 GB 8 raid_dp,normal 16 0
RELATED LINKS
New-NcAggr
| Copyright © 2012 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|