Use the mkthrottle command to create a new throttle object
and associate it with an object (such as a volume). You can also create offloaded I/O throttling
(which is a single clustered system throttle).
Syntax
mkthrottle -type offload | vdisk | host | hostcluster | mdiskgrp [ -bandwidth bandwidth_limit_in_mb ] [ -iops iops_limit ] [ -name throttle_name ] [ -vdisk { vdisk_id | vdisk_name } ] [ -host { host_id | host_name } ] [ -hostcluster { hostcluster_id | hostcluster_name } ] [ -mdiskgrp { mdiskgrp_id | mdiskgrp_name } ]
Parameters
- -typeoffload | vdisk | host | hostcluster | mdiskgrp
- (Required) Specifies the type of throttle, either offload or
vdisk.
- -bandwidthbandwidth_limit_in_mb
- (Optional) Specifies the bandwidth in MBps. This must be a numeric value from 0 -
268435456.
- -iopsiops_limit
- (Optional) Specifies the I/O operations limit. This must be a numeric value 0 - 33554432.
- -namethrottle_name
- (Optional) Specifies the throttling object's name. This value must be an alphanumeric string up
to 63 characters long.
- -vdiskvdisk_id | vdisk_name
- (Optional) Specifies the volume ID or name of the volume to throttle. The value
must be a numeric or alphanumeric string.
Note: This keyword must be specified when you specify
-type vdisk.
This parameter is mandatory for volume
throttling but cannot be used for offload throttling.
- -hosthost_id | host_name
- (Optional) Specifies the host ID or name to throttle.
- -hostclusterhostcluster_id | hostcluster_name
- (Optional) Specifies the host cluster ID or name to throttle.
- -mdiskgrpmdiskgrp_id | mdiskgrp_name
- (Optional) Specifies the MDisk group (storage pool) or name to throttle. This applies to parent
or child storage pools.
Description
This command creates a new throttle object
and associates it with an object (such as a volume).
Note: - A throttle object cannot be defined for a host if it is a part of host cluster that already has
a host cluster throttle object defined for it.
- If a host cluster does not have a throttle object defined, its member hosts can have individual
host throttles defined.
- The storage pool throttle objects for a child pool and a parent pool work independently of each
other
- If a volume has multiple copies then throttling is done for the storage pool serving primary
copy. Throttling is
not applicable for secondary pools that are part of mirrored volumes.
An invocation example for creating a volume throttle of 10000 IOPs and a
bandwidth limit of 500 MBps for volume vdisk0
mkthrottle -type vdisk -iops 10000 -bandwidth 500 -vdisk vdisk0
The detailed resulting output:
No feedback
An invocation example for creating offloaded I/O throttling with a bandwidth limit of
500 MBps
mkthrottle -type offload -bandwidth 500
The detailed resulting output:
No feedback
An invocation example for creating a host with a bandwidth limit of 100
MBps
mkthrottle -type host -bandwidth 100 -host host_Win2012SP2
The detailed resulting output:
No feedback
An invocation example for creating a host cluster with a bandwidth limit of
3000 MBps
mkthrottle -type hostcluster -iops 3000 -hostcluster 0
The detailed resulting output:
No feedback
An invocation example for creating a MDisk group with a bandwidth limit of
4000 MBps
mkthrottle -type mdiskgrp -iops 40000 -mdiskgrp 0
The detailed resulting output:
No feedback