Follow

config.qos_policy.assign 

ROLE: Admin 

Description

Assign entity to policy.

Each policy is effective to only one type of entity:

  • Volume
  • Filesystem
  • Pool-volume - the policy impacts the volumes that belong to this pool
  • Pool-filesystem - the policy impacts the filesystems that belong to this pool
Syntaxconfig.qos_policy.assign policy=QOSPOLICY [vol={VOL|SNAP}[,{VOL|SNAP},...]] [fs={FS|SNAP}[,{FS|SNAP},...]] [pool=POOL[,POOL,...]] 
ArgumentsfsName of an existing filesystem or snapshot (multiple values, separated by commas) 
vol Name of an existing volume or snapshot (multiple values, separated by commas)
policyQoS policy 
poolName of an existing pool (multiple values, separated by commas)
ExampleAssigning a volume to a policy 
qos_policy.assign policy=q1 vol=v1
VOLUME 'v1' was assigned to policy 'q1' 
ExampleAssigning a filesystem to a policy 
qos_policy.assign policy=q2 fs=fs1 
FILESYSTEM 'fs1' was assigned to policy 'q2' 



config.qos_policy.assignment_query  

ROLE: All Roles

Description

List entities that are associated with a policy. 

Syntaxconfig.qos_policy.assignment_query [policy=QOSPOLICY] [type=QoS policy type]
ArgumentstypeVOLUME or POOL_VOLUME 
policy QoS policy 
Exampleqos_policy.assignment_query 

NAME TYPE            POLICY  ENTITIES 
v1   VOLUME          q1      -
v2   FILESYSTEM      q2      -
v3   POOL_VOLUME     q4      1
v4   POOL_FILESYSTEM q3      1



config.qos_policy.create 

ROLE: Admin 

Description

Create a new QoS policy. 

Syntaxconfig.qos_policy.create name=NAME type=QoS policy type [max_ops=QOSOPSORNONE] [max_throughput=MAXMIBPSORNONE] [burst=BURST] [burst_factor=BURSTFACTOR] 
Argumentsburst_factor
burstEnable or disable Burst for QoS policy 
max_throughput NONE, or qoS policy max throughput in MiB/s
max_ops NONE, or qoS policy max operations per second 
typeVOLUME or POOL_VOLUME
nameA maximum of 65 Latin characters, numbers, spaces, and the following symbols: "^&'@()[]$=!-#{}%.+~_" (excluding quotation marks). Leading and trailing whitespace characters are stripped.
ExampleCreating a policy with max IOPS and no burst 
qos_policy.create name=q5 type=volume max_ops=2000 
QoS policy "q5" created 
ExampleCreating a policy with max IOPS, and a burst
qos_policy.create name=q6 type=volume max_ops=2000 burst_factor=4 burst=yes
QoS policy "q6" created 



config.qos_policy.delete 

ROLE: Admin

Description

Delete a policy.

  • There is no need to unassigned entities from a policy prior to the deletion
  • Entities that were assigned to this policy are no longer assigned to a policy
Syntaxconfig.qos_policy.delete policy=QOSPOLICY 
Argumentspolicy QoS policy 
Exampleqos_policy.delete policy=q1 

QoS policy "q1" deleted 



config.qos_policy.enable 

ROLE: Admin

Description

Enable QoS. 

Syntaxconfig.qos_policy.enable 



config.qos_policy.modify 

ROLE: Admin 

Description

Modify a policy.

  • Rename the policy
  • Change the max operations or max throughput settings
  • Add a burst
  • Activate/deactivate the burst
Syntaxconfig.qos_policy.modify policy=QOSPOLICY [new_name=NAME] [max_ops=QOSOPSORNONE] [max_throughput=MAXMIBPSORNONE] [burst=BURST] [burst_factor=BURSTFACTOR] 
Argumentsnew_name A maximum of 65 Latin characters, numbers, spaces, and the following symbols: "^&'@()[]$=!-#{}%.+~_" (excluding quotation marks). Leading and trailing whitespace characters are stripped.Enable or disable Burst for QoS policy 
policy QoS policy
max_opsNONE, or qoS policy max operations per second 
max_throughputNONE, or qoS policy max throughput in MiB/s 
burst Enable or disable Burst for QoS policy 
burst_factor
ExampleRenaming a policy 
qos_policy.modify policy=q1 new_name=q2
Policy "q1" renamed to "q2"
ExampleChanging the max operations and max throughput parameters
qos_policy.modify policy=q1 max_ops=3000
QoS policy "q1" updated
ExampleChanging the burst factor
qos_policy.modify policy=policy-1 burst_factor=4 burst=yes
QoS policy "policy-1" updated
ExampleDeactivating the burst
qos_policy.modify policy=policy-1 burst=no
QoS policy "policy-1" updated



config.qos_policy.query 

ROLE: All Roles

Description

List existing policies. 

Syntaxconfig.qos_policy.query [policy=QOSPOLICY] [type=QoS policy type] 
ArgumentstypeVOLUME or POOL_VOLUME 
policy QoS policy 
Exampleqos_policy.query 

NAME TYPE            MAX OPS  MAX THROUGHPUT  BURST FACTOR  
q1   VOLUME          3000     UNLIMITED       4
q2   FILESYSTEM      3000     UNLIMITED       -
q3   POOL_VOLUME     10000    UNLIMITED       -
q4   POOL_FILESYSTEM 10000    UNLIMITED       - 



config.qos_policy.query_status 

ROLE: Admin

Description

Query the QoS status. 

Syntaxconfig.qos_policy.query_status 



config.qos_policy.unassign 

ROLE: Admin 

Description

Remove entity from policy.

Unassigning an entity from a policy is done in either of the following ways:

  • Specifying the entity
  • Specifying the policy and then the entity
Syntaxconfig.qos_policy.unassign [vol={VOL|SNAP}[,{VOL|SNAP},...]] [pool=POOL[,POOL,...]] [policy=QOSPOLICY]
ArgumentsvolName of an existing volume or snapshot (multiple values, separated by commas)
poolName of an existing pool (multiple values, separated by commas)
policy QoS policy
ExampleSpecifying the entity.
qos_policy.unassign vol=v1 
Entity was unassigned from QoS policy 
ExampleSpecifying the policy and the entity. 
qos_policy.unassign policy=q1 vol=v1 
Entity was unassigned from QoS policy 
Was this article helpful?
0 out of 0 found this helpful

0 out of 0 found this helpful

Last edited: 2022-08-06 08:35:10 UTC

Comments