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