HP 3PAR OS 3.1.3 CLI Administrator's Manual

Modifying a QoS Rule with the HP 3PAR CLI
Three CLI commands are available to create and manage QoS rules. The commands and their
syntax details are:
• setqos [options]
[{vvset|domain:{<name>|<pattern>}|sys:all_others}]...
The setqos command creates and updates QoS rules in a system.
• showqos [options]
[{vvset|domain:{<name>|<pattern>}|sys:all_others}]...
The showqos command lists the QoS rules configured in a system.
• statqos [options]
[{vvset|domain:{<name>|<pattern>}|sys:all_others}]...
The statqos command displays run-time statistics of active QoS rules.
For details about command syntax and the columns in their output, see the HP 3PAR CLI Help page
for each of the commands.
The integer value for bandwidth in the setqos command can optionally be followed with:
• k or K to indicate a multiple of 1000
• m or M to indicate a multiple of 1,000,000
• g or G to indicate a multiple of 1,000,000,000
If you specify "none", there is no limit on I/O issue bandwidth rate.
The CLI offers a number of features that are not available in the MC. For example, a QoS rule can
be created with the setqos command and be kept inactive by using the -off option.
All user-defined rules can be switched off simultaneously by using the setqos –off vvset:*
command; use the setqos –on vvset:* command to enable them again.
Rules can be shown in ordered form by issuing the showqos –sortcol X,[inc|dec], where
X is the column number, and inc and dec sort on increasing or decreasing values in the column,
respectively. Column counting in the output of showqos starts with the left column, which is
numbered 0. The table below shows output of the showqos command, with the sorting option set
on decreasing IOPS value.
cli% showqos -sortcol 4,dec
I/O per second KBytes per sec
Id Type Name QoS Limit Limit
22 vvset MS-SQL on 40000 500000
8 vvset Exchange5 on 12000 80000
13 vvset Sub-ESX51 off 12000 80000
7 vvset Oracle11i on 8000 64000
12 sys all_others on 6000 120000
----------------------------------------------------------
5 total
An option of particular interest for setqos is –vv <name>|<pattern>. This option changes
the QoS rule, for all VVsets that include VVs with names matching any of the names or patterns
specified, to the value contained in the setqos statement. If a VV is in a VVset for which no QoS
rule has yet been defined, a new rule is created with the limits in the setqos command.
The built-in rule all_others is switched off by the command setqos –off sys:all_others.
The showqos and statqos command provide a centralized view of the QoS rules in the systems
and how the workloads conform to them.
154 HP Priority Optimization