Skip to main content
Sign Out

Welcome to Dell

My Account
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.
Sign In Create an Account Premier Sign In Partner Program Sign In
Contact Us

Your Dell.com Baskets

Dell Unity™ Family Unisphere® Command Line Interface User Guide

PDF

Create an I/O limit policy

Create an I/O limit policy that can be applied to a storage resource.

Format

/stor/config/iolimit create [-async] -name <value> [-descr <value>] [-shared {yes | no}] [-type {absolute | density}] [-maxIOPS <value>] [-maxKBPS <value>] [-maxIOPSDensity <value>] [-maxKBPSDensity <value>] [-burstRate <value> -burstTime <value> -burstFrequency <value>]

Action qualifier

QualifierDescription
-asyncRun the operation in asynchronous mode.
-nameType the name of the I/O limit.
-descrType a brief description of the I/O limit.
-sharedSpecify whether the I/O limit is shared. Values are one of the following:
  • yes
  • no (default)
-type Specify whether an absolute or density-based policy will be created. Values are one of the following:
  • absolute (default)
  • density
-maxIOPSSpecify the maximum IOPS. Cannot be specified when -type is density.
-maxKBPSSpecify the maximum KBPS. Cannot be specified when -type is density.
-maxIOPSDensity Specify the maximum IOPS per GB size of the attached object. Cannot be specified when -type is absolute.
-maxKBPSDensity Specify the maximum KBPS per GB size of the attached object. Cannot be specified when -type is absolute.
-burstRate Specify the burst rate as a percentage over the base limit. Requires the use of -burstTime and -burstFrequency. Value is 1 - 100.
-burstTime Specify the time interval during which the burst rate is in effect, in minutes. Requires the use of -burstRate and -burstFrequency. Use the following format:

<value>m, where:

  • <value>—Number of minutes within the range 1 - 60.
  • m—Qualifier to identify minutes.
-burstFrequencySpecify how often bursting is allowed in hours. Requires the use of -burstRate and -burstTime. Use the following format:

<value>h, where:

  • <value>—Number of hours within the range 1 - 24.
  • h—Qualifier to identify hours.

Example 1

The following command creates an I/O limit policy with these settings:

  • Name is finance.
  • Description is “for finance department.”
  • Shared.
  • Type is absolute.
  • Maximum IOPS of 500.
  • Maximum KBPS of 1000.

The I/O limit policy receives the ID IOL_1:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/iolimit create -name "finance" -descr "for finance department" -shared yes -type absolute -maxIOPS 500 -maxKBPS 1000 
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = IOL_1
Operation completed successfully.

Example 2

The following command creates an I/O limit policy with these settings:

  • Name is engineering.
  • Description is “for engineering department.”
  • Unshared.
  • Type is density based.
  • Maximum IOPS per GB of 600.
  • Maximum KBPS per GB of 2000.
  • Burst rate of 30 percent.
  • Burst time of five minutes.
  • Burst frequency of two hours.

The I/O limit policy receives the ID IOL_2:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/iolimit create -name "engineering" -descr "for engineering department" -shared yes -type density -maxIOPSDensity 600 -maxKBPSDensity 2000 -burstRate 30 -burstTime 5m -burstFrequency 2h 
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = IOL_2
Operation completed successfully.

Example 3

The following command failed because -type was set to absolute, but options only applicable to a -type of density were specified.

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/iolimit create -name "HR2" -type absolute -maxIOPSDensity 2000 -maxKBPSDensity 3000 
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation failed. Error code: 0x900912a
Mismatch between policy type and limit values. Absolute policy requires Maximum IOPS and/or Maximum KBPS while Density-based policy requires Maximum IOPS per GB and/or Maximum KBPS per GB. (Error Code:0x900912a)

Example 4

The following command failed because -type was set to density, but options only applicable to a -type of absolute were specified.

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/iolimit create -name "HR3" -type density -maxIOPS 2000 -maxKBPS 3000 
Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation failed. Error code: 0x900912a
Mismatch between policy type and limit values. Absolute policy requires Maximum IOPS and/or Maximum KBPS while Density-based policy requires Maximum IOPS per GB and/or Maximum KBPS per GB. (Error Code:0x900912a)

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\