|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Get-NcEfficiency
NAME
Get-NcEfficiency
SYNOPSIS
Get efficiency information for volumes.
SYNTAX
Get-NcEfficiency [[-Volume] <String[]>] [[-Vserver] <String[]>] [-Controller
<NcController[]>] [<CommonParameters>]
DESCRIPTION
Get efficiency information for volumes. The efficiency information includes
the space savings that result from using several NetApp space savings techn
ologies.
The cmdlet returns a VolEfficiencyInfo object for each volume it investigaes
. 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 retu
rns.
The VolEfficiency object returned contains the following volume-specific val
ues:
- SnapshotCount: The number of snapshots of the volume.
- SnapshotReserve: The size of the snapshot reserve for the volume.
- SnapshotUsed: The amount of space used by snapshots.
- SnapshotOverflow: The amount of space consumed by snapshots outside of th
e snapshot reserve.
- Reserve: The amount of space in the overwrite reserve. This space is sav
ed as overwrite space for LUNs and files that have space reservation enabled
.
- ReserveUsed: The amount of reserve space that is currently in use.
- SpaceReserve: The type of space reservation of the volume. This value ca
n be: none, volume, or file.
- 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 quo
tas set.
- QuotaOvercommit: The amount of space overcommitted to tree quotas. If Qu
otaCommitted < Capacity then the quota overcommit is zero.
- TotalLunSize: The total sze of all LUNs contained within this volume.
- LunOverprovisionPercent: The LUN over-provisioning percent of the volume.
This value is equal to (TotalLunSize / Capacity) * 100.
- EffectiveUsed: The amount of space that would be used without NetApp stor
age efficiency technologies. This is equal to Used + Returns.
- EfficiencyPercent: A percentage representing the overall storage efficien
cy of the volume. This is equal to (EffectiveUsed / Capacity) * 100.
- Qtrees: A Hashtable containing the qtrees that exist for the volume.
The QtreeEfficiency object contains the following qtree-specific values:
- HasTreeQuota: If true, the qtree has a tree quota enabled. When a tree q
uota is enabled for the qtree, the Capacity value is equal to the DiskLimit
of the quota. The Capacity, Used, and Free values are only considered valid
when HasTreeQuota is true.
- Luns: A Hashtable containing the LUNs contained within this qtree.
The LunEfficiency object contains the following LUN-specific values:
- IsThin: If true, the LUN is thin provisioned (i.e. space reservation is n
ot enabled).
The VolReturnsInfo object contains the following volume efficiency returns i
nformation:
- Dedupe: The savings that result from using deduplication.
- Compression: The savings that result from using compression.
- Snapshot: The savings that result from using volume snapshots. This is e
qual to: Used - (SnapshotUsed / SnapshotCount). We divide the snapshot use
d space by the number of snapshots to get an accurate savings calculation fr
om volumes with long-running snapshots that effectively consume more space t
han the data.
- Cloning: The savings that result from using NetApp Volume FlexClones. Th
is value is equal to the result of the volume-clone-split-estimate API, that
is, the amount of additional space that would be consumed if the volume wer
e no longer a clone.
The LunReturnsInfo object contains the following LUN efficiency information:
- Thin: The savings that result from LUN thin provisioning. This is equal
to the LUN size minus the LUN space consumed.
PARAMETERS
-Volume <String[]>
Volume for which to get efficiency information. Data ONTAP wildcards ar
e accepted.
Required? false
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Vserver <String[]>
Vserver for which to get efficiency information. Data ONTAP wildcards a
re accepted.
Required? false
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
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
<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.Efficiency.VolEfficiency
NOTES
Category: toolkit
Family: cluster, vserver
-------------- Example 1 --------------
C:\PS>Get-NcEfficiency -Vserver vserver1 -Volume nfs
Get the efficiency information for the given volume on the given vserver.
SnapshotCount : 10
SnapshotReserve : 0
SnapshotUsed : 14760075264
SnapshotOverflow : 14760075264
Reserve : 0
ReserveUsed : 0
SpaceReserve : none
QuotaCommitted : 0
QuotaUsed : 0
QuotaOverCommit : 0
TotalLunSize : 0
LunOverprovisionPercent : 0
EffectiveUsed : 2028179085721
EfficiencyPercent : 944.4444839474745094776153564
Qtrees : {[, DataONTAP.C.Types.Efficiency.QtreeEfficiency]}
NcController : 10.60.189.172
Vserver : vserver1
Name : nfs
Capacity : 214748364800
Used : 94281019392
Free : 120467255296
Returns : 1933898066329
-------------- Example 2 --------------
C:\PS>Get-NcEfficiency -Vserver dlamotta01
Get the efficiency information for all of the volumes on the given vserver.
Vserver: dlamotta01
Name Capacity Used SnapshotUsed Returns Ef
fectiveUsed EfficiencyPercent
---- -------- ---- ------------ ------- --
----------- -----------------
cifs 95.0 GB 5.2 MB 2.1 MB 5.0 MB
10.3 MB 0.0%
cmodesr2 3.0 GB 244.0 KB 0 0
244.0 KB 0.0%
dlamotta01_root_vol 19.0 MB 124.0 KB 720.0 KB 52.0 KB
176.0 KB 0.9%
luns 95.0 GB 3.5 GB 251.9 MB 3.6 GB
7.1 GB 7.4%
luns_clone 95.0 GB 3.5 GB 6.7 MB 6.9 GB
10.4 GB 11.0%
vol1_SM1 9.5 GB 1004.0 KB 1.1 MB 899.6 KB
1.9 MB 0.0%
vol1_SM2 9.5 GB 1004.0 KB 1.1 MB 906.7 KB
1.9 MB 0.0%
-------------- Example 3 --------------
C:\PS>$eff = Get-NcEfficiency -Vserver dlamotta01
$eff | % { $_.Qtrees.Values }
View the information for all the qtrees on the given vserver.
Vserver: dlamotta01
Volume Name HasQtreeQuota Capacit
y Used
------ ---- ------------- -------
- ----
cifs False
- -
cifs qtree1 True 10.0 G
B 0
cmodesr2 False
- -
dlamotta01_root_vol False
- -
luns True 5.0 G
B 0
luns_clone False
- -
vol1_SM1 False
- -
vol1_SM2 False
- -
-------------- Example 4 --------------
C:\PS>$eff = Get-NcEfficiency
$eff | % { $_.Qtrees.Values } | % { $_.Luns.Values }
Get all of the LUN information for the current cluster.
Vserver: costea01
Name IsThin Capacity Used
---- ------ -------- ----
/vol/xenfcp_vol/xenfcp True 1.0 GB 0
Vserver: dlamotta01
Name IsThin Capacity Used
---- ------ -------- ----
/vol/luns/lun0 True 150.0 GB 330.7 MB
/vol/luns/lun0_clone True 150.0 GB 3.2 GB
/vol/luns_clone/lun0 True 150.0 GB 330.7 MB
/vol/luns_clone/lun0_clone True 150.0 GB 3.2 GB
Vserver: iscsivs1
Name IsThin Capacity Used
---- ------ -------- ----
/vol/xenlun_vol/xenlun True 2.0 GB 100.4 MB
RELATED LINKS
| Copyright © 2012 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|