|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Get-NaEfficiency
NAME
Get-NaEfficiency
SYNOPSIS
Get efficiency information for a set of aggregates or volumes.
SYNTAX
Get-NaEfficiency [[-Volume] <String[]>] [-Recurse] [-Hashtable] [-Controller
<NaController>] [<CommonParameters>]
Get-NaEfficiency -Aggregate <String[]> [-Recurse] [-Hashtable] [-Controller
<NaController>] [<CommonParameters>]
DESCRIPTION
Get efficiency information for a set of aggregates or volumes. The efficien
cy information includes the space savings that result from using several Net
App space savings technologies.
The cmdlet returns an EfficiencyInfo object for each storage object it inves
tigates. An EfficiencyInfo object contains the following values:
- Capacity: The capacity of the storage object.
- Used: The amount of space used on the storage object.
- Free: The amount of space free on the storage object.
- Returns: A ReturnsInfo object which describes the storage efficiency
returns.
- Children: If the recurse switch is specified, this is a collection of
child storage objects.
An AggrEfficiencyInfo object contains the following values:
- RawCapacity: The total capacity of the disks contained in the aggrega
te, including parity disks. The size of the disks are determined by the Phy
sicalSpace value returned by Get-NaDisk.
- RawDataCapacity: The total capacity of the disks contained in the agg
regate including only data disks.
- SnapUsage: A SnapshotUsageInfo object detailing the snapshot usage of
this aggregate. A SnapshotUsageInfo object contains the number of snapshot
s of the aggregate, the size of the snapshot reserve, the amount of used sna
pshot space, and the amount of snapshot overflow space (used snapshot space
outside of the snapshot reserve).
- TotalVolumeSize: The total size, in bytes, of all the volumes contain
ed in this aggregate. This value is only valid when the -Recurse switch is
present.
- OverProvisioningPercent: The volume over-provisioning percent of this
aggregate. This is equal to (TotalVolumeSize / Capacity) * 100. This valu
e is only valid when the -Recurse switch is present.
A VolEfficiencyInfo object contains the following values:
- TotalSize: The size of the volume including the snapshot reserve.
- SnapUsage: A SnapshotUsageInfo object detailing the snapshot usage of
this volume. A SnapshotUsageInfo object contains the number of snapshots o
f the volume, the size of the snapshot reserve, the amount of used snapshot
space, and the amount of snapshot overflow space (used snapshot space outsid
e of the snapshot reserve).
- QuotaCommitted: The total amount of space committed on the volume to
tree quotas.
- QuotaUsed: The amount of space used on the volume by qtrees with tree
quotas set.
- QuotaOvercommit: The amount of space overcommitted to tree quotas. I
f QuotaCommitted < Capacity then the quota overcommit is zero.
- TotalLunSize: Total size of all the LUNs contained within this volume
. This value is only valid when the -Recurse switch is present.
- OverProvisioningPercent: The LUN over-provisioning percent of the volu
me. This value is equal to (TotalLunSize / Capacity) * 100. This value is
only valid when the -Recurse switch is present.
- Reserve: The amount of space in the overwrite reserve. This space is
saved as overwrite space for luns and files that have space reservation ena
bled.
- ReserveUsed: The amount of reserve space that is currently in use.
- SpaceReserve: The type of space reservation of the volume. This valu
e can be: volume, file, or none.
- PhysicalUsed: The amount of space consumed on the volume's containing
aggregate as reported by aggr show_space.
- Allocated: The amount of space allocated for this volume on the conta
ining aggregate as reported by aggr show_space.
- EffectiveUsed: The amount of space that would be used without NetApp
storage efficiency technologies. It is equal to Used plus Returns.
- EfficiencyPercentage: A percentage representing the overall storage e
fficiency of the volume. It is equal to the Effective Used divided by the C
apacity of the volume.
The ReturnsInfo object details the storage efficiency returns of a storage o
bject.
Aggregate ReturnsInfo:
- RaidDp: The savings that result from using Raid-DP as compared to mir
roring.
- Snapshot: The savings that result from using aggregate snapshots. Th
is is equal to: snapshot savings = data used space - (snapshot used space /
number of snapshots). We divide the snapshot used space by the number of s
napshots to get an accurate savings calculation from aggregates with long-ru
nning snapshots that effectively consume more space than the space consumed
by the data.
Volume ReturnsInfo:
- Dedupe: The savings that results from using deduplication.
- Compression: The savings that results from using compression.
- Snapshot: The savings that results from using volume snapshots. This
is equal to: snapshot savings = data used space - (snapshot used space / n
umber of snapshots). We divide the snapshot used space by the number of sna
pshots to get an accurate savings calculation from volumes with long-running
snapshots that effectively consume more space than the space consumed by th
e data.
- Cloning: The savings that result from using NetApp Volume FlexClones.
The value is equal to the result of the volume-clone-split-estimate API.
Lun ReturnsInfo:
- Thin: The savings that results from Thin Provisioning. This is equal
to size minus space consumed.
PARAMETERS
-Volume <String[]>
List of volume names to get efficiency information for. Wildcards are a
ccepted.
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Recurse
If specified, the cmdlet will find efficiency information for embedded o
bjects. Aggregates will gather information for volumes, volumes will ga
ther information for qtrees and LUNs.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Hashtable
If specified, the cmdlet will write the output as a Hashtable. The key
is the name of the volume (or aggregate) and the value is the associated
EfficiencyInfo object.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Aggregate <String[]>
List of aggregate names to get efficiency information for. Wildcards ar
e accepted.
Required? true
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.PowerShell.SDK.Cmdlets.Toolkit.Efficiency.EfficiencyInfo
NOTES
Category: toolkit
-------------- Example 1 --------------
C:\PS>Get-NaEfficiency *
Get the efficiency information for all volumes on the current controller.
Name Capacity Used Free SnapUsage Re
serve Returns EfficiencyPercentage
---- -------- ---- ---- --------- --
----- ------- --------------------
vol0 537.3 GB 3.0 GB 534.3 GB 266.2 MB
0 3.0 GB 1%
luns 400.0 GB 82.9 GB 317.1 GB 830.8 MB
0 125.7 GB 52%
cifs 400.0 GB 70.3 GB 329.7 GB 98.6 GB
0 63.7 GB 33%
testvol 16.0 GB 1.0 MB 16.0 GB 4.8 MB
0 436.0 KB 0%
tmp_root 4.0 GB 2.6 GB 1.4 GB 1.6 MB
0 2.6 GB 128%
tmp_luns1 4.0 GB 480.0 KB 4.0 GB 1.4 MB
0 297.5 KB 0%
snapsource0 4.0 GB 168.0 KB 4.0 GB 540.0 KB
0 108.0 KB 0%
vol1 20.0 GB 6.6 GB 13.4 GB 304.9 MB
0 6.3 GB 64%
WSFCRRE_dest 100.0 GB 57.7 GB 42.3 GB 3.9 MB
0 57.7 GB 115%
testluns 16.0 GB 6.0 GB 10.0 GB 4.1 MB 48
.0 KB 6.0 GB 75%
-------------- Example 2 --------------
C:\PS>Get-NaEfficiency -Aggregate aggr0 -Recurse
Get the efficiency information for aggr0 and all the volumes contained in ag
gr0.
RawCapacity : 5334426058752
RawDataCapacity : 3556284039168
SnapUsage : 60539224064
Name : aggr0
Capacity : 3039371522048
Used : 1131791167488
Free : 1907580354560
Returns : 2008754332467
Children : {[vol0, DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Efficienc
y.VolEfficiencyInfo], [luns, DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Effici
ency.VolEfficiencyInfo], [cifs, DataONTAP.PowerShell.SDK.Cmdlets.Toolkit.Eff
iciency.VolEfficiencyInfo], [testvol, DataONTAP.PowerShell.SDK.Cmdlets.Toolk
it.Efficiency.VolEfficiencyInfo]...}
-------------- Example 3 --------------
C:\PS>Get-NaEfficiency vol1 -Recurse | %{$_.Children.Values}
Get a list of qtrees on vol1 and their space usage information (if a tree qu
ota disk limit is set).
Name HasTreeQuota Capacity Used
Free
---- ------------ -------- ----
----
/vol/vol1/ False 0 0
0
/vol/vol1/qtree1 True 5.0 GB 1.3 MB 5.
0 GB
-------------- Example 4 --------------
C:\PS>Get-NaEfficiency vol1 -Recurse | %{$_.Children.Values} | %{$_.Children
.Values}
Get a list of luns contained in vol1 and their efficiency info.
Name IsThin Capacity Used
Free
---- ------ -------- ----
----
/vol/vol1/lun0_clone True 10.0 GB 160.0 KB
10.0 GB
/vol/vol1/lun0 True 10.0 GB 3.1 GB
6.9 GB
-------------- Example 5 --------------
C:\PS>Get-NaEfficiency -Aggregate * -Recurse | select Name, Capacity, TotalV
olumeSize, OverProvisioningPercent
Get the volume over-provisioning of all the aggregates on the current contro
ller.
Name Capacity To
talVolumeSize OverProvisioningPercent
---- -------- --
------------- -----------------------
aggr0 121910042624
92559769600 75
aggr1 853370273792
1391064113152 163
-------------- Example 6 --------------
C:\PS>Get-NaEfficiency -Recurse | select Name, Capacity, TotalLunSize, OverP
rovisioningPercent
Get the LUN over-provisioning of all the volumes on the current controller.
Name Capacity
TotalLunSize OverProvisioningPercent
---- --------
------------ -----------------------
testvol3 17179869184
0 0
vol4 161061273600
390675440128 242
vol0 92559769600
0 0
vol1 968009834496
342566461440 35
dunn_vol2_mirror 193273528320
252075026944 130
vfiler1 17179869184
0 0
testvol2 17179869184
0 0
testvol 17179869184
0 0
RELATED LINKS
| Copyright © 2013 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|