mkthrottle

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

Read syntax diagramSkip visual syntax diagram mkthrottle -type offload | vdisk | host | hostcluster | mdiskgrp -bandwidthbandwidth_limit_in_mb-iopsiops_limit-namethrottle_name-vdiskvdisk_idvdisk_name-hosthost_idhost_name-hostclusterhostcluster_idhostcluster_name-mdiskgrpmdiskgrp_idmdiskgrp_name

Parameters

-type offload | vdisk | host | hostcluster | mdiskgrp
(Required) Specifies the type of throttle.
-bandwidth bandwidth_limit_in_mb
(Optional) Specifies the bandwidth in MBps. This must be a numeric value 0 - 268435456.
-iops iops_limit
(Optional) Specifies the I/O operations limit. This must be a numeric value 0 - 33554432.
-name throttle_name
(Optional) Specifies the throttling object's name. This value must be an alphanumeric string up to 63 characters long.
-vdisk vdisk_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.
-host host_id | host_name
(Optional) Specifies the host ID or name to throttle.
-hostcluster hostcluster_id | hostcluster_name
(Optional) Specifies the host cluster ID or name to throttle.
-mdiskgrp mdiskgrp_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:
  • The throttle I/O limit is per node.
  • 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.
  • 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