26-QoS-QoS Profile Command

Download


Chapter 1  QoS Commands

1.1  QoS Commands

1.1.1  display protocol-priority

Syntax

display protocol-priority

View

Any view

Parameter

None

Description

Use the display protocol-priority command to display the priority of the protocol packet.

Example

# Display the priority of the protocol packet.

<H3C> display protocol-priority

Protocol: telnet

  DSCP: be(0)

1.1.2  display qos cos-local-precedence-map

Syntax

display qos cos-local-precedence-map

View

Any view

Parameter

None

Description

Use the display qos cos-local-precedence-map command to display the “COS-to-local-precedence” mapping table.

Example

# Display the “COS-to-local-precedence” mapping table.

<H3C> display qos cos-local-precedence-map

cos-local-precedence-map:

              cos(802.1p) :    0    1    2     3     4     5     6     7

------------------------------------------------------------------------

 local precedence(queue) :     0    1    2     3     4     5     6     7

1.1.3  display qos-interface all

Syntax

display qos-interface { interface-type interface-number | unit-id } all

View

Any view

Parameter

interface-type interface-number: Port index.

unit-id: Unit ID of the switch.

Description

Use the display qos-interface all command to display all the QoS configuration of the ports. If you do not input port parameters, this command will display the QoS parameter configuration of all the ports of the switch, including priority remark, queue scheduling, rate limit, etc; if you input port parameters, this command will display QoS parameter configuration of the port, including priority remark, queue scheduling, rate limit, etc.

When the IRF feature is enabled, the interface-type interface-number argument or the unit-id argument must be input.

Example

# Display all the QoS parameter configuration on Ethernet1/0/1.

<H3C> display qos-interface Ethernet 1/0/1 all

 

Ethernet1/0/1: traffic-limit

 Inbound:

   Matches: Acl 3001 rule 1  running

     Target rate: 640 kbps

     Exceed action: remark-dscp 4

Ethernet1/0/1: traffic-priority

 Inbound:

   Matches: Acl 2000 rule 0  running

     Priority action: dscp ef

 

Ethernet1/0/1: line-rate

   Inbound: 128 kbps

   Outbound: 1024 kbps

 

Ethernet1/0/1:

 

 Queue scheduling mode: strict-priority

1.1.4  display qos-interface line-rate

Syntax

display qos-interface { interface-type interface-number | unit-id } line-rate

View

Any view

Parameter

interface-type interface-number: Port index.

unit-id: Unit ID of the switch.

Description

Use the display qos-interface line-rate command to display the rate limit configuration of a port or all the ports of a switch. If you do not specify the interface-type interface-number argument, this command will display the rate limit configuration of all the ports of a switch; if you specify that argument, this command will display the rate limit configuration of a specific port.

Example

# Display the rate limit configuration of a specific port.

<H3C> display qos-interface 1 line-rate

Ethernet1/0/1: line-rate

   Inbound: 128 kbps

1.1.5  display qos-interface traffic-limit

Syntax

display qos-interface { interface-type interface-number | unit-id } traffic-limit

View

Any view

Parameter

interface-type interface-number: Port index.

unit-id: Unit ID of the switch.

Description

Use the display qos-interface traffic-limit command to display the traffic limit configuration of a port or all the ports of a switch, including the applied ACLs for traffic limit, committed information rate (CIR), and the corresponding actions.

Related command: traffic-limit.

Example

# Display the traffic limit configuration.

<H3C> display qos-interface Ethernet 1/0/1 traffic-limit

 

Ethernet1/0/1: traffic-limit

 Inbound:

   Matches: Acl 3001 rule 1  running

     Target rate: 640 kbps

     Exceed action: remark-dscp 4 

1.1.6  display qos-interface traffic-priority

Syntax

display qos-interface { interface-type interface-number | unit-id } traffic-priority

View

Any view

Parameter

interface-type interface-number: Port index.

unit-id: Unit ID of the switch.

Description

Use the display qos-interface traffic-priority command to display the traffic priority configuration. The information displayed includes the ACL corresponding to the traffic tagged with priority, priority type and value.

Related command: traffic-priority.

Example

# Display the traffic priority configuration.

<H3C> display qos-interface Ethernet 1/0/1 traffic-priority

Ethernet1/0/1: traffic-priority

 Inbound:

   Matches: Acl 2000 rule 0  running

     Priority action: dscp ef  

1.1.7  display qos-interface traffic-redirect

Syntax

display qos-interface { interface-type interface-number | unit-id } traffic-redirect

View

Any view

Parameter

interface-type interface-number: Port index.

unit-id: Unit ID of the switch.

Description

Use the display qos-interface traffic-redirect command to display the redirection configuration of a port or all the ports of a switch. The displayed information includes the corresponding ACLs of the traffic to be redirected, the destination interfaces, etc.

Related command: traffic-redirect.

Example

# Display the redirect configuration.

<H3C> display qos-interface Ethernet 1/0/1 traffic-redirect

Ethernet1/0/1: traffic-redirect

 Inbound:

   Matches: Acl 3000 rule 0  running

     Redirected to: interface Ethernet1/0/22

1.1.8  display qos-interface traffic-statistic

Syntax

display qos-interface { interface-type interface-number | unit-id } traffic-statistic

View

Any view

Parameter

interface-type interface-number: Port index.

unit-id: Unit ID of the switch.

Description

Use the display qos-interface traffic-statistic command to display the traffic statistics information. The information displayed includes the ACL corresponding to the traffic to be counted and the number of packets counted.

Related command: traffic-statistic.

Example

# Display the traffic statistics information.

<H3C> display qos-interface Ethernet 1/0/1 traffic-statistic

Ethernet1/0/1: traffic-statistic

 Inbound:

   Matches: Acl 2000 rule 2  running

     0 packet inprofile

     0 packet outprofile

1.1.9  display queue-scheduler

Syntax

display queue-scheduler

View

Any view

Parameter

None

Description

Use the display queue-scheduler command to display global queue scheduling mode and corresponding configuration.

Related command: queue-scheduler.

Example

# Display the global queue scheduling mode.

<H3C> display queue-scheduler

Queue scheduling mode: strict-priority

1.1.10  line-rate

Syntax

line-rate { inbound | outbound } target-rate

undo line-rate{ inbound | outbound }

View

Ethernet port view

Parameter

inbound: Limits the rate of inbound packets.

outbound: Limits the rate of outbound packets.

target-rate: Total rate (in Kbps) to limit both the inbound and outbound packets on the port, with the granularity of rate limit being 64 Kbps. If the number you input is in the range of N*64 to (N+1)*64 (N is a natural number), the switch will set the value to (N+1)*64 Kbps automatically. The target rate range for fast Ethernet ports and Gigabit Ethernet ports respectively is:

l           Fast Ethernet port: 64 to 99,968

l           Gigabit Ethernet port: 64 to 1,000,000

Description

Use the line-rate command to limit the rate of the packets on the port.

Use the undo line-rate command to cancel the rate limit configuration on the port.

The granularity of rate limit is 64 Kbps.

Example

# Limit the rate of inbound packets on Ethernet1/0/1 to 128 Kbps.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Ethernet 1/0/1

[H3C-Ethernet1/0/1] line-rate inbound 128

1.1.11  priority

Syntax

priority priority-level

undo priority

View

Ethernet port view

Parameter

priority-level: Priority level of the port, ranging from 0 to 7.

Description

Use the priority command to configure the priority of Ethernet port.

Use the undo priority command to restore the default port priority.

By default, the switch uses the port priority instead of the 802.1p priority carried by a packet.

After this command is configured, the switch will replace the packet 802.1p priority with the priority of the receiving port, according to which the packet will be put into the corresponding egress queue.

Example

# Set the priority of Ethernet1/0/1 port to 6.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Ethernet 1/0/1

[H3C-Ethernet1/0/1] priority 6

1.1.12  priority trust

Syntax

priority trust

undo priority

View

Ethernet port view

Parameter

None

Description

Use the priority trust command to configure the system to use the packet 802.1p priority instead of the port priority.

Use the undo priority command to configure the system not to use packet 802.1p priority.

By default, the system replaces the priority carried by a packet with the port priority.

Example

# Configure the system to use the packet priority on Ethernet1/0/1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Ethernet 1/0/1

[H3C-Ethernet1/0/1] priority trust

1.1.13  protocol-priority protocol-type

Syntax

protocol-priority protocol-type protocol-type { ip-precedence ip-precedence | dscp dscp-value }

undo protocol-priority protocol-type protocol-type

View

System view

Parameter

protocol-type protocol-type: Specifies the protocol type. Only TELNET, SNMP, ICMP and OSPF are supported currently.

ip-precedence ip-precedence: Specifies the IP precedence, in the range of 0 to 7. You can enter the keywords as shown in Table 1-1 .

Table 1-1 Description on IP precedence values

Keyword

IP precedence value (decimal)

IP precedence value (binary)

routine

0

000

priority

1

001

immediate

2

010

flash

3

011

flash-override

4

100

critical

5

101

internet

6

110

network

7

111

 

dscp dscp-value: Specifies the DSCP priority, in the range of 0 to 63. You can also enter the keywords listed in Table 1-2.

Table 1-2 Description on DSCP values

Keyword

DSCP value (decimal)

DSCP value (binary)

ef

46

101110

af11

10

001010

af12

12

001100

af13

14

001110

af21

18

010010

af22

20

010100

af23

22

010110

af31

26

011010

af32

28

011100

af33

30

011110

af41

34

100010

af42

36

100100

af43

38

100110

cs1

8

001000

cs2

16

010000

cs3

24

011000

cs4

32

100000

cs5

40

101000

cs6

48

110000

cs7

56

111000

be (default)

0

000000

 

Description

Use the protocol-priority command to set the global traffic priority for a specific protocol type.

Use the undo protocol-priority command to cancel the settings.

 

&  Note:

The precedence of OSPF protocol packets cannot be changed on S3600-SI series switches.

 

Example

# Set the IP precedence of SNMP protocol packets to 3.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] protocol-priority protocol-type snmp ip-precedence 3

1.1.14  qos cos-local-precedence-map

Syntax

qos cos-local-precedence-map cos0-map-local-prec cos1-map-local-prec cos2-map-local-prec cos3-map-local-prec cos4-map-local-prec cos5-map-local-prec cos6-map-local-prec cos7-map-local-prec

undo qos cos-local-precedence-map

View

System view

Parameter

cos0-map-local-prec: Local precedence to which CoS 0 is to be mapped, in the range of 0 to 7.

cos1-map-local-prec: Local precedence to which CoS 1 is to be mapped, in the range of 0 to 7.

cos2-map-local-prec: Local precedence to which CoS 2 is to be mapped, in the range of 0 to 7.

cos3-map-local-prec: Local precedence to which CoS 3 is to be mapped, in the range of 0 to 7.

cos4-map-local-prec: Local precedence to which CoS 4 is to be mapped, in the range of 0 to 7.

cos5-map-local-prec: Local precedence to which CoS 5 is to be mapped, in the range of 0 to 7.

cos6-map-local-prec: Local precedence to which CoS 6 is to be mapped, in the range of 0 to 7.

cos7-map-local-prec: Local precedence to which CoS 7 is to be mapped, in the range of 0 to 7.

Description

Use the qos cos-local-precedence-map command to configure the “CoS-to-local-precedence” mapping table.

Use the undo qos cos-local-precedence-map command to restore the default values.

The following is the default “CoS-to-local-precedence” mapping table.

Table 1-3 Default “CoS-to-local-precedence” mapping table

CoS value

Local precedence

0

2

1

0

2

1

3

3

4

4

5

5

6

6

7

7

 

Example

# Configure the “CoS-to-local-precedence” mapping table.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] qos cos-local-precedence-map 0 1 2 3 4 5 6 7

The following is the configured "CoS-to-local-precedence” mapping table.

Table 1-4 “CoS-to-local-precedence” mapping table

CoS value

Local precedence

0

0

1

1

2

2

3

3

4

4

5

5

6

6

7

7

 

1.1.15  queue-scheduler

Syntax

I. In system view

queue-scheduler { strict-priority | wfq queue0-width queue1-width queue2-width queue3-width queue4-width queue5-width queue6-width queue7-width | wrr queue0-weight queue1-weight queue2-weight queue3-weight queue4-weight queue5-weight queue6-weight queue7-weight }

undo queue-scheduler

II. In Ethernet port view

queue-scheduler { wfq queue0-width queue1-width queue2-width queue3-width queue4-width queue5-width queue6-width queue7-width | wrr queue0-weight queue1-weight queue2-weight queue3-weight queue4-weight queue5-weight queue6-weight queue7-weight }

undo queue-scheduler

View

System view/Ethernet port view

Parameter

strict-priority: Indicates that the queue uses strict priority (SP) scheduling algorithm.

wfq: Indicates that the queue uses weighted fair queue (WFQ) scheduling.

queue0-width queue1-width queue2-width queue3-width queue4-width queue5-width queue6-width queue7-width: Minimum delivery bandwidth of each WFQ queue in Kbps. Its granularity is 64 Kbps. If the number you enter is in the range of N*64 to (N+1)*64 (N is a natural number), the switch sets the value to (N+1)*64 automatically. The value for fast Ethernet ports is in the range of 64 to 99,968, and the value for Gigabit Ethernet ports is in the range of 64 to 1,000,000. A value of 0 means the corresponding queue uses the SP scheduling.

wrr: Indicates that the queue uses weighted round robin (WRR) scheduling.

queue0-weight queue1-weight queue2-weight queue3-weight queue4-weight queue5-weight queue6-weight queue7-weight: Indicates that the queue uses the WRR scheduling. The value ranges from 0 to 15. A value of 0 means the corresponding queue uses the SP scheduling.

Description

Use the queue-scheduler command to configure the queue scheduling mode.

Use the undo queue-scheduler command to restore the default value.

The queue scheduling algorithm defined by executing the queue-scheduler command in system view takes effect on all the ports of the switch. The queue scheduling algorithm defined by executing the queue-scheduler command in Ethernet port view takes effect on the current port only. If the weight (or bandwidth value) of the WRR (or WFQ) queue scheduling algorithm defined globally cannot satisfy the requirement of a port, you can modify the weight (or bandwidth value) of the queue scheduling algorithm for this port in Ethernet port view of this port. On this port, the newly defined queue weight (or bandwidth value) will replace the globally defined one. You cannot use the display queue-scheduler command to display the queue weight (or bandwidth value) defined in Ethernet port view.

A port of the switch supports eight egress queues and you can configure a queue scheduling mode, which can be SP, WRR, or WFQ as needed to achieve the implementation of WRR+SP or WFQ+SP. For example, with WRR or WFQ, if you set the weight or the minimum bandwidth of one or more queues to 0, the SP applies to the queue(s) and WRR or WFQ apply to other queues.

By default, the WRR algorithm is selected for all outbound queues on a port, and their weight values are 1, 2, 3, 4, 5, 9, 13, and 15.

Related command: display queue-scheduler.

Example

# Set WRR as the queue scheduling mode, and set the weight value of each queue to 1, 2, 3, 4, 5, 6, 7, and 8, respectively.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Ethernet 1/0/1

[H3C-Ethernet1/0/1] queue-scheduler wrr 1 2 3 4 5 6 7 8

1.1.16  reset traffic-statistic

Syntax

reset traffic-statistic inbound acl-rule

View

Ethernet port view

Parameter

inbound: Specifies to clear the statistics of the inbound packets on the port.

acl-rule: Applied ACL which can be the combination of various ACL rules. For the ways of combining ACLs and the description on related parameters, refer to Table 1-5 and Table 1-6.

Table 1-5 Ways of applying combined ACLs

ACL combination

Form of the acl-rule argument

Apply all the rules in an IP ACL separately

ip-group acl-number

Apply a rule in an IP ACL separately

ip-group acl-number rule rule-id

Apply all the rules in a Link ACL separately

link-group acl-number

Apply a rule in a Link ACL separately

link-group acl-number rule rule-id

Apply all the rules in a user-defined ACL separately

user-group acl-number

Apply a rule in a user-defined ACL separately

user-group acl-number rule rule-id

Apply a rule in an IP ACL and a rule in a Link ACL at the same time

ip-group acl-number rule rule-id link-group acl-number rule rule-id

 

Table 1-6 Description on the parameters in the ACL combination

Parameter

Description

ip-group acl-number

The number of a basic or advanced ACL, in the range of 2,000 to 3,999

link-group acl-number

The number of a Layer 2 ACL, in the range of 4,000 to 4,999

user-group acl-number

The number of a user-defined ACL, in the range of 5,000 to 5,999

rule-id

The number of an ACL rule, in the range of 0 to 65,534. If this argument is not specified, it refers to all the rules in the ACL

 

Description

Use the reset traffic-statistic command to clear the statistics of all or the specified traffic.

Example

# Clear the statistics of the inbound traffic that matches ACL 2000 on Ethernet1/0/1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Ethernet 1/0/1

[H3C-Ethernet1/0/1] reset traffic-statistic inbound ip-group 2000

1.1.17  traffic-limit

Syntax

traffic-limit inbound acl-rule target-rate [ exceed action ]

undo traffic-limit inbound acl-rule

View

Ethernet port view

Parameter

inbound: Imposes traffic limit on the packets received through the interface.

acl-rule: Applied ACL rules which can be the combination of various ACL rules. For the ways of combining ACLs and the description on related parameters, refer to Table 1-5 and Table 1-6.

target-rate: Total rate (in Kbps) to be set, with the granularity of traffic limit being 64 Kbps. If the specified number ranges from N*64 to (N+1)*64, where N is a natural number, the switch automatically sets (N+1)*64 as the parameter value. This argument ranges from 64 to 99,968 inclusive for a fast Ethernet port and from 64 to 1,000,000 inclusive for a Gigabit Ethernet port.

exceed action: Optional. The action is taken when the traffic exceeds the threshold. The action can be:

l           drop: Drops the packets.

l           remark-dscp value: Sets a new DSCP value.

Description

Use the traffic-limit command to activate ACL-based traffic identification, impose traffic limit, and take different actions on packets within/exceeding the traffic limit.

Use the undo traffic-limit command to remove traffic limit.

The granularity of traffic limit is 64 Kbps.

This command is only effective for the ACL rules whose actions are permit.

Example

# Impose traffic limit on packets that are received on Ethernet1/0/1 and match the permit rule in ACL 4000. Set the rate limit to 128 Kbps and drop the packets exceeding the rate.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Ethernet 1/0/1

[H3C-Ethernet1/0/1] traffic-limit inbound link-group 4000 128 exceed drop

1.1.18  traffic-priority

Syntax

traffic-priority { inbound | outbound } acl-rule { { dscp dscp-value | ip-precedence { pre-value | from-cos } } | cos { pre-value | from-ipprec } | local-precedence pre-value }*

undo traffic-priority { inbound | outbound } acl-rule

View

Ethernet port view

Parameter

inbound: Performs priority remarking on the packets received by the interface.

outbound: Performs priority remarking on the packets sent by the interface.

acl-rule: Applied ACL rules which can be the combination of various ACL rules. For the ways of combining ACLs and the description on related parameters, refer to Table 1-5 and Table 1-6.

dscp dscp-value: Sets DSCP priority, ranging from 0 to 63. You can also enter the keywords listed in Table 1-2.

ip-precedence { pre-value | from-cos }: Sets IP precedence. pre-value ranges from 0 to 7. You can also enter the keywords listed in Table 1-1. from-cos means to set IP precedence of the packet to be the same as the 802.1p priority.

cos { pre-value | from-ipprec }: Sets 802.1p priority. The pre-value argument ranges from 0 to 7. You can also enter the keywords list in Table 1-7. from-ipprec means to set 802.1p priority of the packet to be the same as the IP precedence.

Table 1-7 Description on 802.1p priority values

Keyword

CoS value (decimal)

CoS value (binary)

best-effort

0

000

background

1

001

spare

2

010

excellent-effort

3

011

controlled-load

4

100

video

5

101

voice

6

110

network-management

7

111

 

local-precedence pre-value: Sets local precedence. The pre-value argument ranges from 0 to 7.

Description

Use the traffic-priority command to apply ACLs in traffic classification and remark priority for the traffic matching the ACLs. This command is effective only for the ACL rules whose actions are permit.

Use the undo traffic-priority command to remove the function of remarking priority for the specified traffic.

 

&  Note:

The CoS precedence and the local-precedence cannot be applied simultaneously on the switch.

 

Related command: display qos-interface traffic-priority.

Example

# Remark the 802.1p priority of the packets that are received on Ethernet1/0/1 and match the permit rule in ACL 4000 as 1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Ethernet 1/0/1

[H3C-Ethernet1/0/1] traffic-priority inbound link-group 4000 cos 1

1.1.19  traffic-redirect

Syntax

traffic-redirect { inbound | outbound } acl-rule { cpu | interface interface-type interface-number }

undo traffic-redirect { inbound | outbound } acl-rule

View

Ethernet port view

Parameter

inbound: Performs traffic redirecting on the packets received by the interface.

outbound: Performs traffic redirecting on the packets sent by the interface.

acl-rule: Applied ACL rules which can be the combination of various ACL rules. For the ways of combining ACLs and the description on related parameters, refer to Table 1-5 and Table 1-6.

cpu: Redirects the traffic to the CPU.

interface interface-type interface-number: Redirects the packets to the specified Ethernet port. The interface-type argument refers to the port type.

Description

Use the traffic-redirect command to activate the ACL to identify and redirect the traffic (whose action is permit).

Use the undo traffic-redirect command to cancel the redirection.

Related command: display qos-interface traffic-redirect.

 

&  Note:

l      After the packets are redirected to CPU, they cannot be forwarded normally.

l      If the traffic is redirected to a Combo port in down state, the system automatically redirects the traffic to the port corresponding to the Combo port in up state.

 

Example

# Redirect the packets that are received on Ethernet1/0/1 and match the permit rule in ACL 2000 to Ethernet1/0/7.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Ethernet 1/0/1

[H3C-Ethernet1/0/1] traffic-redirect inbound ip-group 2000 interface Ethernet 1/0/7

1.1.20  traffic-statistic

Syntax

traffic-statistic inbound acl-rule