26-QoS-QoS Profile Command

Download


Chapter 1  QoS Commands

 

The following commands were added:

l      VLAN mapping related commands: display qos-interface traffic-remark-vlanid and traffic-remark-vlanid.

l      Commands related to port rate limiting and traffic policing: line-rate and traffic-limit.

l      VLAN-based priority marking command: traffic-priority vlan.

l      The command for redirecting traffic to an aggregation group and removing outer VLAN tags when redirecting traffic to the specified port/aggregation group: traffic-redirect.

l      The command enabling the burst function: burst-mode enable.

 

1.1  QoS Commands

1.1.1  burst-mode enable

Syntax

burst-mode enable

undo burst-mode enable

View

System view

Parameters

None

Description

Use the burst-mode enable command to enable the burst function.

Use the undo burst-mode enable command to disable the burst function.

By default, the burst function is disabled.

The burst function improves packet buffering and forwarding performance in the following scenarios:

l           Dense broadcast or multicast traffic and massive burst traffic are present.

l           High-speed traffic is forwarded over a low-speed link or traffic received from multiple interfaces at the same speed is forwarded through an interface at the same speed.

By enabling the burst function on your switch, you can improve the processing performance of the switch operating in the above scenarios and thus drop packet loss rate.

 

  Caution:

l      For packets to be forwarded properly, you must not enable the burst function when the IRF function is enabled. Refer to IRF Fabric Operation for detailed information about IRF.

l      Because the burst function may affect the QoS performance of your switch, you must make sure that you are fully aware of the impacts when enabling the burst function.

 

Examples

# Enable the burst function.

<Sysname> system-view

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

[Sysname] burst-mode enable

1.1.2  display protocol-priority

Syntax

display protocol-priority

View

Any view

Parameters

None

Description

Use the display protocol-priority command to display the list of protocol priorities you assigned with the protocol-priority command.

An S5600 series switch supports setting priorities for certain protocol packets generated by it. The supported protocols are Telnet, SNMP, ICMP, OSPF, and BGP. Depending on your configuration, the IP or DSCP precedence is displayed for a specified protocol.

Related commands: protocol-priority.

Examples

# Display the list of protocol priorities manually specified.

<Sysname> display protocol-priority

Protocol: ospf

  IP-Precedence: routine(0)

 

Protocol: telnet

  DSCP: be(0)

Table 1-1 Description on the fields of the display protocol-priority command

Field

Description

Protocol: ospf

Indicate that a priority has been set for OSPF packets with the protocol-priority command.

IP-Precedence: routine(0)

An IP precedence has been assigned to OSPF packets. The assigned IP precedence is 0, that is, routine in words.

For information about the IP precedence range, refer to Table 1-6.

Protocol: telnet

Indicate that a priority has been set for Telnet packets with the protocol-priority command.

DSCP: be(0)

A DSCP precedence has been assigned to Telnet packets. The assigned value is 0, that is, be in words.

For information about the DSCP precedence range, refer to Table 1-7.

 

1.1.3  display qos cos-local-precedence-map

Syntax

display qos cos-local-precedence-map

View

Any view

Parameters

None

Description

Use the display qos cos-local-precedence-map command to display the 802.1p priority-to-local precedence mapping, illustrated by an 802.1p priority-to-local precedence mapping table as shown in the following example.

After a packet enters a switch, the switch sets the 802.1p priority and local precedence for the packet according to its own capability and the corresponding rules. The local precedence is locally significant precedence that the switch assigns to the packet. It corresponds to an output queue. Packets with higher local precedence values take precedence over those with lower precedence values and will be processed preferentially.

Related commands: qos cos-local-precedence-map.

Examples

# Display the 802.1p priority-to-local precedence mapping.

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

cos-local-precedence-map:

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

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

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

1.1.4  display qos-interface all

Syntax

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

View

Any view

Parameters

interface-type interface-number: Specifies the type and number of a port, for which QoS configuration information is to be displayed.

unit-id: Unit ID of the switch whose QoS-related configuration is to be displayed. Table 1-2 shows the value range for the unit-id argument.

Table 1-2 The value range for the unit-id argument

For a switch not in a fabric

For a switch in a fabric

Always 1

The unit ID ranges from 1 to 8, depending on the unit ID of the switch in the fabric. For example, if two switches form a fabric, with the unit IDs being 3 and 5 respectively, the unit IDs of the two switches can only be 3 and 5.

 

Description

Use the display qos-interface all command to display all the QoS-related configuration settings of a port or a unit.

Examples

# Display all the QoS-related configuration of GigabitEthernet 1/0/1.

<Sysname> display qos-interface GigabitEthernet 1/0/1 all

 

GigabitEthernet1/0/1: traffic-limit

 Inbound:

   Matches: Acl 2000 rule 0  running

     Effect mode: Union effect

     Target rate: 64 Kbps

     Burst bucket size: 16 Kbyte

     Exceed action: remark-dscp cs7

GigabitEthernet1/0/1: traffic-priority

 Inbound:

   Matches: Acl 2000 rule 0  running

     Priority action: dscp cs6

GigabitEthernet1/0/1: traffic-redirect

 Inbound:

   Matches: Acl 2000 rule 0  running

     Redirected to: interface GigabitEthernet1/0/2

GigabitEthernet1/0/1: traffic-statistic

 Inbound:

   Matches: Acl 2000 rule 0  running

     6 packets inprofile

     0 packet outprofile

GigabitEthernet1/0/1: mirrored-to

 Inbound:

   Matches: Acl 2000 rule 0  running

     Mirrored to: monitor interface

 

GigabitEthernet1/0/1: line-rate

   Outbound: 64 Kbps

 

GigabitEthernet1/0/1:

 

 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

 weight of queue 4: 5

 weight of queue 5: 9

 weight of queue 6: 13

 weight of queue 7: 15

GigabitEthernet1/0/1: traffic-remark-vlanid

 Inbound:

   Matches: Acl 2000 rule 0  running

     Remark vlan: 2

Table 1-3 Description on the fields of the display qos-interface all command

Field

Description

GigabitEthernet1/0/1

QoS functions configured on a port, including

l      traffic-limit, traffic policing configuration

l      traffic-priority, priority marking configuration

l      traffic-redirect, traffic redirecting configuration

l      traffic-statistic, traffic accounting configuration

l      mirrored-to, traffic mirroring configuration

l      line-rate, port speed limit configuration

l      traffic-remark-vlanid, VLAN mapping configuration

Inbound

Packet direction

Matches

ACL rules for traffic classifying

Effect mode

Union effect, indicating that the ACL referenced in the traffic-limit command takes effect together with the other ACLs applied to the port.

Target rate

Traffic policing target rate, in kbps

Bucket burst size

Maximum burst traffic size allowed, in KB

Exceed action

Action to take for exceeding packets:

l      drop: Drops the packets.

l      remark-dscp: Re-marks the DSCP precedence of the packets and forwards the packets.

Priority action

Priority marking action, which can be:

l      cos: Sets 802.1p precedence for packets.

l      dscp: Sets DSCP precedence for packets.

l      ip-precedence: Sets IP precedence for packets.

l      local-precedence: Sets local precedence for packets.

Redirected to

l      “interface” indicates that the packets are redirected to the port.

l      “cpu” indicates that the packets are redirected to the CPU.

l      “link-aggregation-group” indicates that the packets are redirected to the aggregation group.

inprofile

Statistics about the packets within the traffic limit

outprofile

Statistics about the packets beyond the traffic limit

Mirrored to

l      “monitor interface” indicates that the packets are duplicated to a port.

l      “cpu” indicates that the packets are duplicated to the CPU.

Queue scheduling mode

Queue scheduling algorithm, which can be:

l      strict priority

l      weighted round robin (WRR)

Remark vlan

Target VLAN ID used in VLAN mapping

 

1.1.5  display qos-interface line-rate

Syntax

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

View

Any view

Parameters

interface-type interface-number: Specifies the type and number of the port, of which the line rate configuration is to be displayed.

unit-id: Unit ID of the switch for which line rate configuration is to be displayed. For the value range for the unit-id argument, refer to Table 1-2.

Description

Use the display qos-interface line-rate command to display the line rate configuration of a port or the ports on a unit.

Related commands: line-rate.

Examples

# Display the line rate configuration of GigabitEthernet 1/0/1.

<Sysname> display qos-interface GigabitEthernet 1/0/1 line-rate

 

GigabitEthernet1/0/1: line-rate

   Outbound: 128 Kbps

     Burst bucket size: 16 Kbyte

Refer to Table 1-3 for the description on the output fields.

1.1.6  display qos-interface mirrored-to

Syntax

display qos-interface { interface-type interface-number | unit-id } mirrored-to

View

Any view

Parameters

interface-type interface-number: Specifies the type and number of a port for which traffic mirroring configuration is to be displayed.

unit-id: Unit ID of the switch for which traffic mirroring configuration is to be displayed. For the value range for the unit-id argument, refer to Table 1-2.

Description

Use the display qos-interface mirrored-to command to display the traffic mirroring configuration of a port or a unit.

Related commands: mirrored-to.

Examples

# Display the traffic mirroring configuration of GigabitEthernet 1/0/1.

<Sysname> display qos-interface GigabitEthernet 1/0/1 mirrored-to

GigabitEthernet1/0/1: mirrored-to

 Inbound:

   Matches: Acl 2000 rule 0 running

     Mirrored to: monitor interface

Refer to Table 1-3 for the description on the output fields.

1.1.7  display qos-interface traffic-limit

Syntax

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

View

Any view

Parameters

interface-type interface-number: Specifies the type and number of a port for which traffic policing configuration is to be displayed.

unit-id: Unit ID of the switch whose traffic policing configuration is to be displayed. For the value range for the unit-id argument, refer to Table 1-2.

Description

Use the display qos-interface traffic-limit command to display the traffic policing configuration of a port or a unit.

Related commands: traffic-limit.

Examples

# Display the traffic policing configuration of GigabitEthernet 1/0/1.

<Sysname> display qos-interface GigabitEthernet 1/0/1 traffic-limit

 

GigabitEthernet1/0/1: traffic-limit

 Inbound:

   Matches: Acl 3000 rule 1  running

     Target rate: 640 Kbps

     Burst bucket size: 16 Kbyte

     Exceed action: remark-dscp cs7

Refer to Table 1-3 for the description on the output fields.

1.1.8  display qos-interface traffic-priority

Syntax

display qos-interface { interface-type interface-number | unit-idtraffic-priority

View

Any view

Parameters

interface-type interface-number: Specifies the type and number of a port for which priority marking configuration is to be displayed.

unit-id: Unit ID of the switch whose priority marking configuration is to be displayed. For the value range for the unit-id argument, refer to Table 1-2.

Description

Use the display qos-interface traffic-priority command to display the priority marking configuration of a port or a unit.

Related commands: traffic-priority.

Examples

# Display the priority marking configuration of GigabitEthernet 1/0/1.

<Sysname> display qos-interface GigabitEthernet 1/0/1 traffic-priority

GigabitEthernet1/0/1: traffic-priority

 Inbound:

   Matches: Acl 2000 rule 0  running

     Priority action: dscp ef  

Refer to Table 1-3 for the description on the output fields.

1.1.9  display qos-interface traffic-redirect

Syntax

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

View

Any view

Parameters

interface-type interface-number: Specifies the type and number of a port for which traffic redirecting configuration is to be displayed.

unit-id: Unit ID of the switch whose traffic redirecting configuration is to be displayed. For the value range for the unit-id argument, refer to Table 1-2.

Description

Use the display qos-interface traffic-redirect command to display the traffic redirecting configuration of a port or a unit.

Related commands: traffic-redirect.

Examples

# Display the traffic redirecting configuration of GigabitEthernet 1/0/1.

<Sysname> display qos-interface GigabitEthernet 1/0/1 traffic-redirect

GigabitEthernet1/0/1: traffic-redirect

 Inbound:

   Matches: Acl 3000 rule 0  running

     Redirected to: interface GigabitEthernet1/0/2

Refer to Table 1-3 for the description on the output fields.

1.1.10  display qos-interface traffic-remark-vlanid

Syntax

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

View

Any view

Parameters

interface-type interface-number: Specifies the type and number of a port for which VLAN mapping configuration is to be displayed.

unit-id: Unit ID of the switch whose VLAN mapping configuration is to be displayed. For the value range for the unit-id argument, refer to Table 1-2.

Description

Use the display qos-interface traffic-remark-vlanid command to display the VLAN mapping configuration of a port or a unit.

Related commands: traffic-remark-vlanid.

Examples

# Display the VLAN mapping configuration of GigabitEthernet 1/0/1.

<Sysname> display qos-interface GigabitEthernet 1/0/1 traffic-remark-vlanid

GigabitEthernet1/0/1: traffic-remark-vlanid

 Inbound:

   Matches: Acl 4000 rule 0  running

     Remark vlan: 101

Refer to Table 1-3 for the description on the output fields.

1.1.11  display qos-interface traffic-statistic

Syntax

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

View

Any view

Parameters

interface-type interface-number: Specifies the type and number of a port for which traffic accounting configuration is to be displayed.

unit-id: Unit ID of the switch for which traffic accounting configuration and traffic statistics are to be displayed. For the value range for the unit-id argument, refer to Table 1-2.

Description

Use the display qos-interface traffic-statistic command to display the traffic accounting configuration and traffic statistics of a port or a unit.

Related commands: traffic-statistic.

Examples

# Display the traffic accounting configuration and traffic statistics of GigabitEthernet 1/0/1.

<Sysname> display qos-interface GigabitEthernet 1/0/1 traffic-statistic

GigabitEthernet1/0/1: traffic-statistic

 Inbound:

   Matches: Acl 2000 rule 2  running

     6 packets inprofile

     0 packet outprofile

Refer to Table 1-3 for the description on the output fields.

1.1.12  display queue-scheduler

Syntax

display queue-scheduler

View

Any view

Parameters

None

Description

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

This command does not display the weight or bandwidth set for a queue in port view. To display the setting, you can perform the display this command in port view.

Related commands: queue-scheduler.

Examples

# Display the global queue scheduling configuration.

<Sysname> 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

 weight of queue 4: 5

 weight of queue 5: 9

 weight of queue 6: 13

 weight of queue 7: 15

Refer to Table 1-3 for the description of the output fields.

1.1.13  line-rate

Syntax

line-rate outbound target-rate [ burst-bucket burst-bucket-size ]

undo line-rate outbound

View

Ethernet port view

Parameters

outbound: Limits the outbound packet rate.

target-rate: Target rate (in kbps). The following are value ranges for the argument:

l           GigabitEthernet port: 64 to 1000000

l           10-GigabitEthernet port: 1000 to 10000000

The granularity of port rate limit is 64 kbps. Assume that the value you provide for the target-rate argument is in the range N*64 to (N+1)*64 (N is a natural number), it will be rounded off to (N+1)*64.

burst-bucket burst-bucket-size: Specifies the maximum burst traffic size (in KB). This is the buffer size provided for burst traffic while traffic is being forwarding or received at the rate of target-rate. The following are the value ranges for the burst-bucket-size argument:

l           GigabitEthernet port: 4 to 512

l           10 GigabitEthernet port: 4 to 8192

The burst-bucket-size argument must be an integer power of 2. If it is not specified, 64 KB applies by default.

Description

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

Use the undo line-rate command to cancel the line rate configuration.

Compared to traffic policing, line rate applies to all the inbound or outbound packets passing through a port and thus a simpler solution when you only want to limit the rate of all the inbound or outbound packets passing through a port as a whole.

Related commands: display qos-interface line-rate.

Examples

# Limit the inbound packet rate to 128 kbps on GigabitEthernet 1/0/1.

<Sysname> system-view

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

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] line-rate outbound 128

# Display the line rate configuration of GigabitEthernet 1/0/1.

[Sysname-GigabitEthernet1/0/1] display qos-interface GigabitEthernet 1/0/1 line-rate

GigabitEthernet1/0/1: line-rate

   outbound: 128 Kbps

1.1.14  mirrored-to

Syntax

mirrored-to inbound acl-rule { monitor-interface | cpu }

undo mirrored-to inbound acl-rule

View

Ethernet port view

Parameters

inbound: Duplicates inbound packets.

acl-rule: ACL rules to be used for traffic classification. This argument can be a combination of multiple ACLs. For more information about this argument, refer to Table 1-4 and Table 1-5. Note that the ACL rules referenced must be those defined with the permit keyword.

Table 1-4 Ways of applying combined ACL rules

ACL combination

Form of the acl-rule argument

Apply a basic or advanced Layer 3 ACL

ip-group acl-number

Apply a rule in an Layer 3 ACL

ip-group acl-number rule rule-id

Apply all the rules in a Layer 2 ACL

link-group acl-number

Apply a rule in a Layer 2 ACL

link-group acl-number rule rule-id

Apply all the rules in a user-defined ACL

user-group acl-number

Apply a rule in a user-defined ACL

user-group acl-number rule rule-id

Apply a rule in an Layer 3 ACL and a rule in a Layer 2 ACL

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

 

Table 1-5 Description on the parameters used in Table 1-4

Parameter

Description

ip-group acl-number

Specifies the number of a basic or advanced ACL, in the range 2000 to 3999.

link-group acl-number

Specifies the number of a Layer 2 ACL, in the range 4000 to 4999.

User-group acl-number

Specifies the number of a user-defined ACL, in the range 5000 to 5999.

Rule-id

ACL rule number, in the range 0 to 65534. If this argument is not provided, all the rules in the ACL are specified.

 

monitor-interface: Duplicates packets to the specified destination port (the monitor port).

cpu: Duplicates packets to the CPU.

Description

Use the mirrored-to command to configure traffic mirroring.

Use the undo mirrored-to command to cancel the configuration.

Traffic monitoring provides a finer mirroring granularity than port mirroring, which mirrors all traffic passing through a port. For detailed information about port mirroring, refer to the part talking about mirroring.

Note that:

l           If you mirror traffic to the CPU, you do not need to configure a monitor port.

l           If you mirror traffic to a port, you must configure a monitor port with the mirroring-group monitor-port command or the monitor-port command. For information about the two commands, refer to the part talking about mirroring.

l           Traffic mirroring and local port mirroring share the same monitor port.

Related commands: display qos-interface mirrored-to.

Examples

# Configure traffic mirroring on GigabitEthernet 1/0/1, duplicating the inbound packets sourced from IP address 1.1.1.1 to GigabitEthernet 1/0/4.

<Sysname> system-view

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

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 1.1.1.1 0

[Sysname-acl-basic-2000] quit

[Sysname] interface GigabitEthernet 1/0/4

[Sysname-GigabitEthernet1/0/4] monitor-port

[Sysname-GigabitEthernet1/0/4] quit

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mirrored-to inbound ip-group 2000 monitor-interface

[Sysname-GigabitEthernet1/0/1] quit

# Configure traffic mirroring on GigabitEthernet 1/0/2, duplicating the inbound packets matching ACL 2000 to the CPU.

[Sysname] interface GigabitEthernet 1/0/2

[Sysname-GigabitEthernet1/0/2] mirrored-to inbound ip-group 2000 cpu

[Sysname-GigabitEthernet1/0/2] return

# Display the traffic mirroring configuration of GigabitEthernet 1/0/1 and GigabitEthernet 1/0/2.

<Sysname> display qos-interface GigabitEthernet 1/0/1 mirrored-to

GigabitEthernet1/0/1: mirrored-to

 Inbound:

   Matches: Acl 2000 rule 0  running

     Mirrored to: monitor interface

<Sysname> display qos-interface GigabitEthernet 1/0/2 mirrored-to

GigabitEthernet1/0/2: mirrored-to

 Inbound:

   Matches: Acl 2000 rule 0  running

     Mirrored to: cpu

1.1.15  priority

Syntax

priority priority-level

undo priority

View

Ethernet port view

Parameters

priority-level: Port priority, ranging from 0 to 7.

Description

Use the priority command to configure trusting port priority and set the priority of the port.

Use the undo priority command to restore the default.

By default, port priority is trusted and the priority of an Ethernet port is 0.

After you execute the priority command on a port, the port priority rather than the 802.1p priority of each inbound 802.1q-tagged packet is used to identify the matching local precedence for the packet (in the 802.1p-precedence-to-local precedence mapping table). Then, the packet is assigned to the output queue corresponding to the local precedence.

If the priority command, the priority trust command, and the undo priority command are configured on the same port, the command configured the last applies.

Related commands: priority trust.

Examples

# Configure GigabitEthernet 1/0/1 to trust its port priority and set the priority of GigabitEthernet 1/0/1 to 6.

<Sysname> system-view

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

[Sysname] interface GigabitEthernet1/0/1

[Sysname-GigabitEthernet1/0/1] priority 6

1.1.16  priority trust

Syntax

priority trust

undo priority

View

Ethernet port view

Parameters

None

Description

Use the priority trust command to configure the switch to trust the 802.1p priority of an inbound packet.

Use the undo priority command to restore the default settings.

By default, port priority is trusted and the priority of a port is 0.

After you execute the priority trust command on a port, the 802.1p priority of each inbound 802.1q-tagged packet is used to identify the matching local precedence for the packet (in the 802.1p-precedence-to-local precedence mapping table). Then, the packet is assigned to the output queue corresponding to the local precedence.

If the priority command, the priority trust command, and the undo priority command are configured on the same port, the command configured the last applies.

Related commands: priority