17-QoS Command

Download


Chapter 1  QoS Commands

1.1  QoS Command

1.1.1  display mirroring-group

Syntax

display mirroring-group { group-id | all | local | remote-destination | remote-source }

View

Any view

Parameter

group-id: Group number of a port mirroring group with a value of 1.

local: Specifies to display the parameter settings of local port mirroring groups.

remote-destination: Specifies to display the parameter settings of the destination groups for remote mirroring.

remote-source: Specifies to display the parameter settings of the source groups for remote mirroring.

all: Specifies to display the parameter settings of all mirroring groups.

Description

Use the display mirroring-group command to display parameter settings of a mirroring group.

Local mirroring group information includes:

l           Group number

l           Group type: local

l           Group state

l           Source port information

l           Destination port information

Remote destination mirroring group information includes:

l           Group number

l           Group type: remote-destination

l           Group state

l           Destination port information

l           remote-probe vlan information

Remote source mirroring group information includes:

l           Group number

l           Group type: remote-source

l           Group state

l           Source port information

l           Reflector port information

l           Remote-probe VLAN information

Example

# Display parameter settings of a mirroring group.

<H3C> display mirroring-group all

mirroring-group 1:

    type: local

    status: active

    mirroring port:

        Ethernet1/0/1  inbound

    monitor port: Ethernet1/0/2

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 “802.1p priority -> local precedence queue” mapping table.

Example

# Display the “802.1p priority -> local precedence queue” 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) :      1     0     0     1     2     2     3     3

1.1.3  display qos dscp-local-precedence-map

Syntax

display qos dscp-local-precedence-map

View

Any view

Parameter

None

Description

Use the display qos dscp-local-precedence-map command to display the “DSCP precedence -> local precedence queue” mapping table.

Example

# Display the “DSCP precedence -> local precedence queue” mapping table.

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

dscp-local-precedence-map:

             dscp : local-precedence(queue)

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

                0 :            0

                1 :            0

                2 :            0

                3 :            0

                4 :            0

                5 :            0

                6 :            0

                7 :            0

                8 :            0

                9 :            0

               10 :            0

               11 :            0

               12 :            0

               13 :            0

               14 :            0

               15 :            0

               16 :            1

               17 :            1

               18 :            1

               19 :            1

               20 :            1

               21 :            1

               22 :            1

               23 :            1

               24 :            1

               25 :            1

               26 :            1

               27 :            1

               28 :            1

               29 :            1

               30 :            1

               31 :            1

               32 :            2

               33 :            2

               34 :            2

               35 :            2

               36 :            2

               37 :            2

               38 :            2

               39 :            2

               40 :            2

               41 :            2

               42 :            2

               43 :            2

               44 :            2

               45 :            2

               46 :            2

               47 :            2

               48 :            3

               49 :            3

               50 :            3

               51 :            3

               52 :            3

               53 :            3

               54 :            3

               55 :            3

               56 :            3

               57 :            3

               58 :            3

               59 :            3

               60 :            3

               61 :            3

               62 :            3

               63 :            3

1.1.4  display qos ip-precedence-local-precedence-map

Syntax

display qos ip-precedence-local-precedence-map

View

Any view

Parameter

None

Description

Use the display qos ip-precedence-local-precedence-map command to display the “IP precedence -> local precedence queue” mapping table.

Example

# Display the “IP precedence -> local precedence queue” mapping table.

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

ip-precedence-local-precedence-map:

          ip-precedence :      0     1     2     3     4     5     6     7

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

local-precedence(queue) :      0     0     1     1     2     2     3     3

1.1.5  display qos-interface all

Syntax

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

View

Any view

Parameter

interface-type interface-number: Port on a switch.

unit-id: Unit ID of the switch. It can only be 1.

Description

Use the display qos-interface all command to display all QoS settings of a port.

If the interface-type interface-number arguments are not provided, the QoS settings of all the ports are displayed.

Displayed information includes:

l           Line-rate limit on a port.

l           Queue scheduling settings: Specifies the adopted queue scheduling mode and weights of queues.

Example

# Display all QoS settings of Ethernet1/0/1.

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

 

Ethernet1/0/1: line-rate

   Inbound: 128 Kbps

 

Ethernet1/0/1:

 

 Queue scheduling mode: weighted round robin

 weight of queue 0: 2

 weight of queue 1: 3

 weight of queue 2: 4

 weight of queue 3: 5

1.1.6  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 on a switch.

unit-id: Unit ID of the switch. It can only be 1.

Description

Use the display qos-interface line-rate command to display line-rate limit settings.

If the interface-type interface-number arguments are not provided, the line-rate limit settings of all the ports are displayed.

Displayed information includes:

l           The port(s) with line-rate limit enabled.

l           Direction and value of line-rate limit.

Example

# Display line-rate limit settings of Ethernet1/0/1.

<H3C> display qos-interface 1 line-rate

Ethernet1/0/1: line-rate

   Inbound: 128 kbps

1.1.7  display queue-scheduler

Syntax

display queue-scheduler

View

Any view

Parameter

None

Description

Use the display queue-scheduler command to display the queue scheduling mode and parameters.

Displayed information includes:

l           Adopted queue scheduling mode.

l           Weights of queues.

Related command: queue-scheduler.

Example

# Display the queue scheduling mode and parameters.

<H3C> display queue-scheduler

 Queue scheduling mode: weighted round robin

 weight of queue 0: 1

 weight of queue 1: 2

 weight of queue 2: 3

 weight of queue 3: 4

1.1.8  line-rate

Syntax

line-rate { inbound | outbound } target-rate

undo line-rate{ inbound | outbound }

View

Ethernet port view

Parameter

inbound: Applies line-rate limit to inbound packets on a given port.

outbound: Applies line-rate limit to outbound packets on a given port.

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 are:

l           Fast Ethernet port: 64 to 99,968

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

Description

Use the line-rate command to set line-rate limit to inbound or outbound packets for a given port.

Use the undo line-rate command to cancel line-rate limit configurations of the port.

Example

# Set the line-rate limit for inbound packets on Ethernet1/0/1 to 128 kbps.

<H3C> system-view

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

[H3C] interface Ethernet1/0/1

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

1.1.9  mirroring-group

Syntax

mirroring-group group-id { local | remote-destination | remote-source }

undo mirroring-group { group-id | all | local | remote-destination | remote-source }

View

System view

Parameter

group-id: Group number of the mirroring group with a value of 1.

local: Specifies the mirroring group with group number as group-id to be the local port mirroring group.

remote-destination: Specifies the mirroring group with group number as group-id to be the remote destination mirroring group

remote-source: Specifies the mirroring group with group number as group-id to be the remote source mirroring group.

All: Deletes all mirroring group parameter settings, which means deleting all mirroring groups.

Description

Use the mirroring-group command to configure a mirroring group.

Use the undo mirroring-group command to delete a mirroring group configuration.

Example

# Configure a local mirroring group.

<H3C> system-view

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

[H3C] mirroring-group 1 local

1.1.10  mirroring-group mirroring-port

Syntax

mirroring-group group-id mirroring-port mirroring-port-list { both | inbound | outbound }

undo mirroring-group group-id mirroring-port mirroring-port-list { both | inbound | outbound }

View

System view, Ethernet port view

Parameter

group-id: Group number of the mirroring group with a value of 1.

mirroring-port mirroring-port-list: Specifies a list of source ports. mirroring-port-list is available in system view only, but not in Ethernet port view.

both: Mirrors packets both received and sent via the port.

inbound: Indicates that only inbound packets on a given port are monitored.

outbound: Indicates that only outbound packets on a given port are monitored.

Description

Use the mirroring-group mirroring-port command to configure the source port. Use the undo mirroring-group mirroring-port command to delete source port settings.

Example

# Set Ethernet1/0/1 as the source port and configure to have all its inbound packets monitored.

<H3C> system-view

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

[H3C] mirroring-group 1 local

[H3C] mirroring-group 1 mirroring-port Ethernet1/0/1 inbound

1.1.11  mirroring-group monitor-port

Syntax

mirroring-group group-id monitor-port monitor-port

undo mirroring-group group-id monitor-port monitor-port

View

System view

Parameter

group-id: Group number of the mirroring group with a value of 1.

monitor-port monitor-port: Specifies the destination port. monitor-port is available in system view only, but not in Ethernet port view.

Description

Use the mirroring-group monitor-port command to configure the destination port.

Use the undo mirroring-group monitor-port command to cancel destination port settings.

Note the following when you configure the destination port:

l           LACP must be disabled on the destination port.

l           The destination port for remote mirroring must be an Access port.

l           After a port is configured as a reflector port, the switch does not allow you to change the port type and its default VLAN ID.

Example

# Set Ethernet1/0/2 as the destination port of the mirroring group 1.

<H3C> system-view

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

[H3C] mirroring-group 1 local

[H3C] mirroring-group 1 monitor-port Ethernet1/0/2

1.1.12  mirroring-group reflector-port

Syntax

mirroring-group group-id reflector-port reflector-port

undo mirroring-group group-id reflector-port reflector-port

View

System view

Parameter

group-id: Group number of the port mirroring group with a value of 1.

reflector-port reflector-port: Specifies the reflector port. reflector-port is available in system view only, but not in Ethernet port view.

Description

Use the mirroring-group reflector-port command to set the reflector port.

Use the undo mirroring-group reflector-port command to cancel the reflector port settings.

Note the following when you configure the reflector port:

l           The reflector port must be an Access port.

l           LACP must be disabled on the reflector port.

l           After a port is configured as a reflector port, the switch does not allow you to change the port type and its default VLAN ID, or to add it to another VLAN.

Example

# Set Ethernet1/0/1 as the reflector port of the mirroring group 1.

<H3C> system-view

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

[H3C] mirroring-group 1 remote-source

[H3C] mirroring-group 1 reflector-port Ethernet1/0/1

1.1.13  mirroring-group remote-probe vlan

Syntax

mirroring-group group-id remote-probe vlan remote-probe-vlan-id

undo mirroring-group group-id remote-probe vlan remote-probe-vlan-id

View

System view

Parameter

group-id: Group number of the mirroring group with a value of 1.

remote-probe vlan remote-probe-vlan-id: Specifies the remote-probe VLAN for the mirroring group.

Description

Use the mirroring-group remote-probe vlan command to specify the remote-probe VLAN of a mirroring group.

Use the undo mirroring-group remote-probe vlan command to cancel the remote-probe VLAN configuration of a mirroring group.

Example

# Set VLAN 100 as the remote-probe VLAN of the mirroring group 1.

<H3C> system-view

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

[H3C] mirroring-group 1 remote-source

[H3C] mirroring-group 1 remote-probe vlan 100

1.1.14  mirroring-port

Syntax

mirroring-port { inbound | outbound | both }

undo mirroring-port

View

Ethernet port view

Parameter

inbound: Monitors only inbound packets on a given port.

outbound: Monitors only outbound packets on a given port.

both: Monitors both inbound and outbound packets on a given port.

Description

Use the mirroring-port command to configure the source port.

Use the undo mirroring-port command to remove the source port settings.

Note that this command is available to only the local mirroring group.

Example

# Set Ethernet1/0/1 as the source port, on which both inbound and outbound packets are monitored.

<H3C> system-view

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

[H3C] mirroring-group 1 local

[H3C] interface Ethernet1/0/1

[H3C-Ethernet1/0/1] mirroring-port both

1.1.15  monitor-port

Syntax

monitor-port

undo monitor-port

View

Ethernet port view

Parameter

None

Description

Use the monitor-port command to set destination port.

Use the undo monitor-port command to cancel the destination port settings.

Note that this command is available to only the local mirroring group.

S3100-SI switch series support multiple-to-one port monitoring. That is, packets on multiple source ports can be copied into one destination port.

Example

Sets Ethernet1/0/1 as the destination port of the mirroring group 1.

<H3C> system-view

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

[H3C] mirroring-group 1 local

[H3C] interface Ethernet1/0/1

[H3C-Ethernet1/0/1] monitor-port

1.1.16  priority

Syntax

priority priority-level

undo priority

View

Ethernet port view

Parameter

priority-level: Specifies port priority, in the range of 0 to 7.

Description

Use the priority command to set Ethernet port priority.

Use the undo priority command to revert to the default settings.

By default, the switch replaces 802.1p priority of inbound packets with port priority.

Example

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

<H3C> system-view

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

[H3C] interface Ethernet1/0/1

[H3C-Ethernet1/0/1] priority 6

1.1.17  priority trust

Syntax

priority trust

undo priority

View

System view

Parameter

None

Description

Use the priority trust command to configure a switch not to replace 802.1p priority of inbound packets with port priority.

Use the undo priority command to restore the default settings.

By default, a switch replaces 802.1p priority of inbound packets with port priority.

Example

# Configure the switch to use 802.1p priority of the inbound packets.

<H3C> system-view

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

[H3C] priority trust

1.1.18  priority-trust

Syntax

priority-trust { cos | dscp | ip-precedence }

View

System view

Parameter

cos: Puts packets into the proper output queue based on 802.1p priority.

dscp: Puts packets into the proper output queue based on DSCP precedence.

ip-precedence: Puts packets into the proper output queue based on IP precedence.

Description

Use the priority-trust command to specify the priority policy used by the switch in packet queuing.

By default, a switch uses 802.1p priority.

You can also specify some other priority for the switch to use for queue scheduling.

A port supports four output queues, into which a switch puts packets based on one of the following:

DSCP precedence: Ranges from 0 to 63. By default, packets with DSCP values from 1 to 15 are put into queue 0, those from 16 to 31 in queue 1, from 32 to 47 in queue 2, and from 48 to 63 in queue 3.

CoS priority: Ranges from 0 to 7. By default, packets with CoS priority level 1 or 2 are put into queue 0, those with 0 or 3 in queue 1, with 4 or 5 in queue 2, and with 6 or 7 in queue 3.

IP precedence: Ranges from 0 to 7. By default, packets with IP precedence level 0 or 1 are put into queue 0, those with 2 or 3 in queue 1, with 4 or 5 in queue 2, and with 6 or 7 in queue 3.

Users can choose a queuing policy that best meets their needs.

Example

# Configure to use DSCP precedence.

<H3C> system-view

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

[H3C] priority-trust dscp

1.1.19  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: Maps CoS 0 to a local precedence entry (ranging from 0 to 3).

cos1-map-local-prec: Maps CoS 1 to a local precedence entry (ranging from 0 to 3)

cos2-map-local-prec: Maps CoS 2 to a local precedence entry (ranging from 0 to 3)..

cos3-map-local-prec: Maps CoS 3 to a local precedence entry (ranging from 0 to 3)..

cos4-map-local-prec: Maps CoS 4 to a local precedence entry (ranging from 0 to 3)..

cos5-map-local-prec: Maps CoS 5 to a local precedence entry (ranging from 0 to 3)..

cos6-map-local-prec: Maps CoS 6 to a local precedence entry (ranging from 0 to 3)..

cos7-map-local-prec: Maps CoS 7 to a local precedence entry (ranging from 0 to 3)..

Description

Use the qos cos-local-precedence-map command to configure an “802.1p priority -> local precedence queue” mapping table.

Use the undo qos cos-local-precedence-map command to revert to the default “802.1p priority -> local precedence queue” mapping table.

By default, the system uses the default “802.1p priority -> local precedence queue” mapping table.

Table 1-1 The default “802.1p priority -> local precedence queue” mapping table

802.1p priority

Local precedence queue

0

1

1

0

2

0

3

1

4

2

5

2

6

3

7

3

 

Example

# Configure the “802.1p priority -> local precedence queue” mapping table.

[H3C] qos cos-local-precedence-map 0 0 1 1 2 2 3 3

The completed mapping table is as follows:

Table 1-2 “802.1p priority -> local precedence queue” mapping table

802.1p priority

Local precedence queue

0

0

1

0

2

1

3

1

4

2

5

2

6

3

7

3

 

1.1.20  qos dscp-local-precedence-map

Syntax

qos dscp-local-precedence-map dscp-list : local-precedence

undo qos dscp-local-precedence-map dscp-list

View

System view

Parameter

dscp-list: List of DSCP values. It can include only one DSCP value or many DSCP values. DSCP values are separated by space. dscp-list is connected with local-precedence by the “:” after it to indicate the mapping relationship between them. The range of dscp-list is from 0 to 63.

local-precedence: Local precedence with a value range of 0 to 3.

Description

Use the qos dscp-local-precedence-map command to configure a “DSCP precedence -> local precedence queue” mapping table.

Use the undo qos dscp-local-precedence-map command to revert to the default “DSCP precedence -> local precedence queue” mapping table.

By default, the “DSCP precedence -> local precedence queue” mapping table is used, which is shown as follows:

Table 1-3 The default “DSCP precedence -> local precedence queue” mapping table

DSCP precedence

Local precedence queue

0–15

0

16–31

1

32–47

2

48–63

3

 

Example

# Configure a “DSCP precedence -> local precedence queue” mapping table that maps DSCP values 0 through 7 to the local precedence queue 2.

<H3C> system-view

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

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

1.1.21  qos ip-precedence-local-precedence-map

Syntax

qos ip-precedence-local-precedence-map ip-pre0-map-local-prec ip-pre1-map-local-prec ip-pre2-map-local-prec ip-pre3-map-local-prec ip-pre4-map-local-prec ip-pre5-map-local-prec ip-pre6-map-local-prec ip-pre7-map-local-prec

undo qos ip-precedence-local-precedence-map

View

System view

Parameter

ip-pre0-map-local-prec: Maps IP precedence 0 to a local precedence entry (ranging from 0 to 3).

ip-pre1-map-local-prec: Maps IP precedence 1 to a local precedence entry (ranging from 0 to 3).

ip-pre2-map-local-prec: Maps IP precedence 2 to a local precedence entry (ranging from 0 to 3).

ip-pre3-map-local-prec: Maps IP precedence 3 to a local precedence entry (ranging from 0 to 3).

ip-pre4-map-local-prec: Maps IP precedence 4 to a local precedence entry (ranging from 0 to 3).

ip-pre5-map-local-prec: Maps IP precedence 5 to a local precedence entry (ranging from 0 to 3).

ip-pre6-map-local-prec: Maps IP precedence 6 to a local precedence entry (ranging from 0 to 3).

ip-pre7-map-local-prec: Maps IP precedence 7 to a local precedence entry (ranging from 0 to 3).

Description

Use the qos ip-precedence-local-precedence-map command to configure an “IP precedence -> local precedence queue” mapping table.

Use the undo qos ip-precedence-local-precedence-map command to revert to the default “IP precedence -> local precedence queue” mapping table.

By default, the “IP precedence -> local precedence queue” mapping table is used.

Table 1-4 The default “IP precedence -> local precedence queue” mapping table

IP precedence IP

Local precedence queue

0

0

1

0

2

1

3

1

4

2

5

2

6

3

7

3

 

Example

# Configure an “IP precedence -> local precedence queue” mapping table.

<H3C> system-view

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

[H3C] qos ip-precedence-local-precedence-map 3 3 2 2 1 1 0 0

1.1.22  queue-scheduler

Syntax

queue-scheduler { hq-wrr queue0-weight queue1-weight queue2-weight | wrr queue0-weight queue1-weight queue2-weight queue3-weight }

undo queue-scheduler

View

System view

Parameter

hq-wrr queue0-weight queue1-weight queue2-weight: Indicates that the HQ-WRR (High Queue-WRR) queue scheduling mode is used. queue0-weight, queue1-weight, and queue2-weight refer to the weight of queue 0, 1 and 2 respectively, all ranging from 1 to 15.

wrr queue0-weight queue1-weight queue2-weight queue3-weight: Indicates that the WRR (Weight Round Robin) queue scheduling mode is used. queue0-weight, queue1-weight, queue2-weight, and queue3-weight refer to the weights of queues 0 to 3 respectively, all ranging from 1 to 15.

Description

Use the queue-scheduler command to set the queue scheduling algorithm.

Use the undo queue-scheduler command to revert to the default queue scheduling algorithm.

By default, the WRR algorithm is used, which sets weights for queue 0 to queue 3 as 1 to 4 respectively.

Each port of the switch supports four output queues.

The WRR algorithm works as follows:

Each queue is assigned with a weight value (w0, w1, w2 and w3 corresponding to the four queues), which indicates the proportions of source allocated to each queue. For example, weight values for queues 0 to 3 are set as 1, 2, 4 and 8 (corresponding to w0, w1, w2 and w3) respectively. In this case, when data traffic of the four output queues on the port exceeds the port processing capability, the switch will perform weight round robin on the queues, based on the allocated proportion of 1:2:4:8. That is to say, among every 15 packets sent by the switch, 1 packet is put into queue 0, 2 into queue 1, 4 into queue 2 and 8 into queue 3.

With the HQ-WRR algorithm, queue 3 is allocated with the highest priority. When data traffic of the four output queues on the port exceeds the port processing capability, packets in queue 3 will be sent first, and then WRR algorithm is used on the rest three queues.

Related command: display queue-scheduler.

Example

# Set WRR as the queue scheduling algorithm.

<H3C> system-view

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

[H3C] queue-scheduler wrr 1 2 4 8

1.1.23  remote-probe vlan

Syntax

remote-probe vlan enable

undo remote-probe vlan enable

View

VLAN view

Parameter

None

Description

Use the remote-probe vlan enable command to set the current VLAN as a remote-probe VLAN.

Use the undo remote-probe vlan enable command to delete the remote-probe VLAN settings for the current VLAN.

After you use the command, the system will check if the current VLAN is a dynamic VLAN. If yes, the system fails in execution the command and prompts “Can not set dynamic VLAN as remote-probe VLAN!”.

Example

# Configure VLAN 5 to be the remote-probe vlan.

<H3C> system-view

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

[H3C] vlan 5

[H3C-vlan5] remote-probe vlan enable