MLS QoS Verification Commands on Catalyst 6500 Series Switch

Document

Mon, 07/09/2012 - 23:40
Jul 9th, 2012

Verification Commands

show mls qos

To display multilayer switching (MLS) quality of service (QoS) information, use the show mls qos command in privileged EXEC mode.

show mls qos [{arp | ipv6 | ip | ipx | last | mac | module [module-number]} [interface interface-number | slot slot | null 0 | port-channel number | vlan vlan-id]] [detailed]

Syntax Description


arp

(Optional)   Displays Address Resolution Protocol (ARP) information.

ipv6

(Optional)   Displays IPv6 information.

ip

(Optional)   Displays information about the MLS IP status.

ipx

(Optional)   Displays information about the MLS Internetwork Packet Exchange (IPX) status.

last

(Optional)   Displays information about the last packet-policing.

mac

(Optional)   Displays information about the MAC address-based QoS status.

module module-number

(Optional)   Specifies the module (slot) number; displays the global and per-interface QoS   enabled and disabled settings and the global QoS counters.

interface

(Optional)   Interface type; valid values are ethernet, fastethernet, gigabitethernet,   tengigabitethernet, ge-wan, pos, and atm.

interface-number

(Optional)   Module and port number; see the "Usage Guidelines" section for   valid values.

slot slot

(Optional)   Specifies the slot number; displays the global and per-interface QoS enabled   and disabled settings and the global QoS counters.

null   0

(Optional)   Specifies the null interface; the only valid value is 0.

port-channel number

(Optional)   Specifies the channel interface; there is a maximum of 64 values ranging   from 1 to 282.

vlan vlan-id

(Optional)   Specifies the VLAN ID; valid values are from 1 to 4094.

detailed

(Optional)   Displays additional statistics.

Usage Guidelines

The ge-wan, pos, and atm interfaces are not supported on systems that are configured with a Supervisor Engine 720.

The interface-number argument designates the module and port number. Valid values for interface-number depend on the specified interface type and the chassis and module that are used. For example, if you specify a Gigabit Ethernet interface and have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot chassis, valid values for the module number are from 1 to 13 and valid values for the port number are from 1 to 48.

The port-channel number values from 257 to 282 are supported on the Content Switching Module (CSM) and the Firewall Services Module (FWSM) only.

Examples

Last Logged Packet Example

This example shows how to display information about the last logged packet:

Router# show mls qos last

QoS engine last packet information:

    Packet was transmitted

    Output TOS/DSCP: 0xC0/48[unchanged]   Output COS: 0[unchanged]

    Aggregate policer index: 0(none)

    Microflow policer index: 0(none)                                

IPv6 Example

Supervisor Engine 720 Example

This example shows how to display QoS information:

Router# show mls qos

QoS is enabled globally

Microflow policing is enabled globally

QoS ip packet dscp rewrite enabled globally

QoS is disabled on the following interfaces:

Fa6/3 Fa6/4

QoS DSCP-mutation map is enabled on the following interfaces:

Fa6/5

Vlan or Portchannel(Multi-Earl) policies supported: Yes

Egress policies supported: Yes

----- Module [5] -----

QoS global counters:

Total packets: 164

IP shortcut packets: 0

Packets dropped by policing: 0

IP packets with TOS changed by policing: 0

IP packets with COS changed by policing: 0

Non-IP packets with COS changed by policing: 0

MPLS packets with EXP changed by policing: 0

Supervisor Engine 2 Example

This example shows the output if you do not enter any keywords:

Router# show mls qos

  QoS is enabled globally

  Microflow QoS is enabled globally

QoS global counters:

    Total packets: 217500

    IP shortcut packets: 344

    Packets dropped by policing: 344

    IP packets with TOS changed by policing 18323

    IP packets with COS changed by policing 1602

    Non-IP packets with COS changed by policing 0

show mls qos maps

To display multilayer switching (MLS) quality of service (QoS) mapping information, use the show mls qos maps command in privileged EXEC mode.

Cisco 7600 Series Router and Catalyst 6500 Series Switch

show mls qos maps [cos-dscp | cos-mutation | dscp-cos | dscp-exp | dscp-mutation | exp-dscp | exp-mutation | ip-prec-dscp | policed-dscp]

Syntax Description


cos-dscp

(Optional)   Displays the class of service (CoS)-to-differentiated services code point   (DSCP) map.

dscp-cos

(Optional)   Displays the DSCP-to-CoS map.

cos-mutation

(Optional)   Displays the CoS-mutation map.

dscp-exp

(Optional)   Displays the DSCP-to-exp map.

dscp-mutation

(Optional)   Displays the DSCP-mutation map.

exp-dscp

(Optional)   Displays the exp-to-DSCP map.

exp-mutation

(Optional)   Displays the exp-mutation map.

ip-prec-dscp

(Optional)   Displays the IP-precedence-to-DSCP map.

policed-dscp

(Optional)   Displays the policed-DSCP map.

Usage Guidelines

Maps are used to generate an internal DSCP value, which represents the priority of the traffic. Use the show mls qos maps command without keywords to display all maps.

Examples

The following is sample output from the show mls qos maps cos-dscp command displaying the DSCP values to which each CoS value will be mapped:

Router# show mls qos maps cos-dscp

Cos-dscp map:

        cos:  0  1  2  3  4  5  6  7

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

       dscp:  8  8  8  8 24 32 56 56

The following is sample output from the show mls qos maps dscp-cos command displaying the CoS values to which each DSCP value will be mapped:

Router# show mls qos maps dscp-cos

Dscp-cos map:

       dscp:  0  8 10 16 18 24 26 32 34 40 46 48 56

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

        cos:  0  1  1  1  2  2  3  3  4  4  5  6  7

This example shows how to display the QoS-map settings:

Router# show mls qos maps

   Policed-dscp map:

            0  1  2  3  4  5  6  7  8  9

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

      00:  00 01 02 03 04 05 06 07 08 09

      10:  10 11 12 13 14 15 16 17 18 19

      20:  20 21 22 23 24 25 26 27 28 29

      30:  30 31 32 33 34 35 36 37 38 39

      40:  40 41 42 43 44 45 46 47 48 49

      50:  50 51 52 53 54 55 56 57 58 59

      60:  60 61 62 63

   Dscp-cos map:

            0  1  2  3  4  5  6  7  8  9

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

      00:  00 00 00 00 00 00 00 00 01 01

      10:  01 01 01 01 01 01 02 02 02 02

      20:  02 02 02 02 03 03 03 03 03 03

      30:  03 03 04 04 04 04 04 04 04 04

      40:  05 05 05 05 05 05 05 05 06 06

      50:  06 06 06 06 06 06 07 07 07 07

      60:  07 07 07 07

   Cos-dscp map:

          cos:   0  1  2  3  4  5  6  7

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

        dscp:   0  8 16 24 32 40 48 56

   IpPrecedence-dscp map:

       ipprec:   0  1  2  3  4  5  6  7

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

        dscp:   0  8 16 24 32 40 48 56

Router#

In the policed DSCP and DSCP-CoS map displays, the new DSCP or CoS values are shown in the body of the table. The decade of the original DSCP value is shown in the left-side vertical column, and the units digit is in the top row. For example, the DSCP-CoS map indicates that if the original DSCP value is between 32 and 39, the CoS will be set to 4.

The CoS-DSCP and IP precedence-DSCP maps display the DSCP values to which each CoS or IP precedence value will be mapped. For example, the IP precedence-DSCP map indicates that if the original IP precedence value is 3, the DSCP will be set to 24.

This example shows how to verify the configuration of DSCP-mutation mapping:

Router# show mls qos maps | begin DSCP mutation

DSCP mutation map mutmap1:                  (dscp= d1d2)

     d1 :  d2 0  1  2  3  4  5  6  7  8  9

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

      0 :    00 01 02 03 04 05 06 07 08 09

      1 :    10 11 12 13 14 15 16 17 18 19

      2 :    20 21 22 23 24 25 26 27 28 29

      3 :    08 31 32 33 34 35 36 37 38 39

      4 :    40 41 42 43 44 45 46 47 48 49

<...Output Truncated...>

Router#

In the DSCP mutation map display, the marked-down DSCP values are shown in the body of the table. The first digit (d1) of the original DSCP value is in the left-side vertical column labeled d1, and the second digit (d2) is in the top row. For example, a DSCP value of 30 maps to a new DSCP value of 08.

show platform qos policy-map

To display the type and number of policy maps that are configured on the router, use the show platform qos policy-map command in privileged EXEC mode.

show platform qos policy-map

Syntax Description

This command has no arguments or keywords.

Usage Guidelines

On Cisco Catalyst 6500 series switches and Cisco 7600 series routers, you cannot attach a quality of service (QoS) policy map with match input vlan to an interface if you have already attached a QoS policy map to a VLAN interface (a logical interface that has been created with the interface vlan command). If you attempt to use both types of service policies, you must remove both types of service policies before you can add the policy maps.

The show platform qos policy-map command shows whether the router is currently configured for interface vlan and match input vlan service policies. It also shows the number of policy maps for each type.

Examples

The following example shows a router that has service policies configured only on VLAN interfaces:

Router# show platform qos policy-map

service policy configured on int vlan: TRUE

# of int vlan service policy instances: 3

match input vlan service policy configured: FALSE

# of match input vlan service policy instances: 0

The following example shows a router that has service policies configured on VLAN interfaces and that has a service policy configured with match input vlan. In this configuration, you must remove all service policies from their interfaces, and then configure only one type or another.

Router# show platform qos policy-map

service policy configured on int vlan: TRUE

# of int vlan service policy instances: 1

match input vlan service policy configured: TRUE

# of match input vlan service policy instances: 1

show platform qos policy-map Field Descriptions

Field

Description

service   policy configured on int vlan

Indicates   whether any QoS policy maps are configured on VLAN interfaces.

#   of int vlan service policy instances

Number   of QoS policy maps that are configured on VLAN interfaces.

match   input vlan service policy configured

Indicates   whether any QoS policy maps that use the match input vlan command are   configured on interfaces.

#   of match input vlan service policy instances

Number   of QoS policy maps using the match input vlan command that are   configured on interfaces.

show policy-map

To display the configuration of all classes for a specified service policy map or of all classes for all existing policy maps, use the show policy-map command in user EXEC or privileged EXEC mode.

show policy-map [policy-map]

Syntax Description

policy-map

(Optional)   Name of the service policy map whose complete configuration is to be   displayed. The name can be a maximum of 40 characters.

Usage Guidelines

The show policy-map command displays the configuration of a policy map created using the policy-map command. You can use the show policy-map command to display all class configurations comprising any existing service policy map, whether or not that policy map has been attached to an interface. The command displays:

? ECN marking information only if ECN is enabled on the interface.

? Bandwidth-remaining ratio configuration and statistical information, if configured and used to determine the amount of unused (excess) bandwidth to allocate to a class queue during periods of congestion.

show policy-map interface

To display the statistics and the configurations of the input and output policies that are attached to an interface, use the show policy-map interface command in user EXEC or privileged EXEC mode.

Cisco 6500 Series Switches

show policy-map interface [interface-type interface-number | vlan vlan-id] [detailed] [{input | output} [class class-name]]

show policy-map interface [port-channel channel-number [class class-name]]

Syntax Description

type   access-control

(Optional)   Displays class maps configured to determine the exact pattern to look for in   the protocol stack of interest.

type

Type   of interface or subinterface whose policy configuration is to be displayed.

number

Port,   connector, or interface card number.

vc

(Optional)   For ATM interfaces only, shows the policy configuration for a specified PVC.

vpi/

(Optional)   ATM network virtual path identifier (VPI) for this permanent virtual circuit   (PVC). On the Cisco 7200 and 7500 series routers, this value ranges from 0 to   255.

The   vpi and vci arguments cannot both be set to 0; if one is 0, the   other cannot be 0.

The   absence of both the forward slash (/) and a vpi value defaults   the vpi value to 0. If this value is omitted, information for all   virtual circuits (VCs) on the specified ATM interface or subinterface is   displayed.

vci

(Optional)   ATM network virtual channel identifier (VCI) for this PVC. This value ranges   from 0 to 1 less than the maximum value set for this interface by the atm   vc-per-vp command. Typically, the lower values 0 to 31 are reserved for   specific traffic (F4 Operation, Administration, and Maintenance [OAM],   switched virtual circuit [SVC] signaling, Integrated Local Management   Interface [ILMI], and so on) and should not be used.

The   VCI is a 16-bit field in the header of the ATM cell. The VCI value is unique   only on a single link, not throughout the ATM network, because it has local   significance only.

The   vpi and vci arguments cannot both be set to 0; if one is 0, the   other cannot be 0.

dlci

(Optional)   Indicates a specific PVC for which policy configuration will be displayed.

dlci

(Optional)   A specific data-link connection identifier (DLCI) number used on the   interface. Policy configuration for the corresponding PVC will be displayed   when a DLCI is specified.

input

(Optional)   Indicates that the statistics for the attached input policy will be   displayed.

output

(Optional)   Indicates that the statistics for the attached output policy will be   displayed.

slot

(ATM   shared port adapter only) Chassis slot number. See the appropriate hardware   manual for slot information. For SIPs, see the platform-specific SPA hardware   installation guide or the corresponding "Identifying Slots and Subslots   for SIPs and SPAs" topic in the platform-specific SPA software   configuration guide.

/subslot

(ATM   shared port adapter only) Secondary slot number on an SPA interface processor   (SIP) where a SPA is installed. See the platform-specific SPA hardware   installation guide and the corresponding "Specifying the Interface Address   on an SPA" topic in the platform-specific SPA software configuration   guide for subslot information.

/port

(ATM   shared port adapter only) Port or interface number. See the appropriate   hardware manual for port information. For SPAs, see the corresponding   "Specifying the Interface Address" topics in the platform-specific   SPA software configuration guide.

.subinterface

(ATM   shared port adapter only-Optional) Subinterface number. The number that   precedes the period must match the number to which this subinterface belongs.   The range is 1 to 4,294,967,293.

interface-type

(Optional)   Interface type; possible valid values are ethernet, fastethernet,   gigabitethernet, tengigabitethernet, pos, atm,   and ge-wan.

interface-number

(Optional)   Module and port number; see the "Usage Guidelines" section for   valid values.

null   0

(Optional)   Specifies the null interface; the only valid value is 0.

vlan vlan-id

(Optional)   Specifies the VLAN ID; valid values are from 1 to 4094.

detailed

(Optional)   Displays additional statistics.

class class-name

(Optional)   Displays the QoS policy actions for the specified class.

port-channel channel-number

(Optional)   Displays the EtherChannel port-channel interface.

Usage Guidelines

Cisco 7600 Series Routers and Catalyst 6500 Series Switches

The pos, atm, and ge-wan interfaces are not supported on Cisco 7600 series routers or Catalyst 6500 series switches that are configured with a Supervisor Engine 720.

Cisco 7600 series routers and Catalyst 6500 series switches that are configured with a Supervisor Engine 2 display packet counters.

Cisco 7600 series routers and Catalyst 6500 series switches that are configured with a Supervisor Engine 720 display byte counters.

The output does not display policed-counter information; 0 is displayed in its place (for example, 0 packets, 0 bytes). To display dropped and forwarded policed-counter information, enter the show mls qos command.

On the Cisco 7600 series router, for OSM WAN interfaces only, if you configure policing within a policy map, the hardware counters are displayed and the class-default counters are not displayed. If you do not configure policing within a policy map, the class-default counters are displayed.

On the Catalyst 6500 series switch, the show policy-map interface command displays the strict level in the priority feature and the counts per level.

The interface-number argument designates the module and port number. Valid values for interface-number depend on the specified interface type and the chassis and module that are used. For example, if you specify a Gigabit Ethernet interface and have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot chassis, valid values for the module number are from 1 to 13 and valid values for the port number are from 1 to 48.

HQF

When you configure HQF, the show policy-map interface command displays additional fields that include the differentiated services code point (DSCP) value, WRED statistics in bytes, transmitted packets by WRED, and a counter that displays packets output/bytes output in each class.

show policy-map interface brief

To display information about only the active policy maps attached to an interface, use the show policy-map interface brief command in privileged EXEC mode.

show policy-map interface [input | output] brief [policy-map-name] [vrf [vrf-id]] [timestamp]

Syntax Description

input

(Optional)   Indicates that only the information about the active input policy maps will   be displayed.

output

(Optional)   Indicates that only the information about the active output policy maps will   be displayed.

brief

Indicates   that the name of all the active policy maps (both input and output policy   maps) and the interfaces to which the policy maps are attached will be   displayed. The active input policy maps will be displayed first, followed by   the output policy maps.

policy-map-name

(Optional)   Name of an active policy map to be displayed.

vrf

(Optional)   Indicates that the active policy maps for Virtual Private Network (VPN)   routing and forwarding (VRF) instances will be displayed.

vrf-id

(Optional)   A specific VRF identifier.

timestamp

(Optional)   Indicates that the date and time when the policy map was attached will be   displayed, along with the ID of the user who attached the policy map.

Usage Guidelines

The show policy-map interface brief command displays the name of the active policy maps and the interfaces to which those policy maps are attached. An active policy map is one that is attached to an interface.

The optional keywords and arguments allow you to tailor the information displayed about VPNs, time stamps, and user IDs.

If you do not specify any optional keywords or arguments, all policy maps (even those that are not active) are displayed.

show class-map

To display class maps and their matching criteria, use the show class-map command in user EXEC or privileged EXEC mode.

Syntax Description

type   stack

(Optional)   Displays class maps configured to determine the correct protocol stack in   which to examine via flexible packet matching (FPM).

type   access-control

(Optional)   Displays class maps configured to determine the exact pattern to look for in   the protocol stack of interest.

class-map-name

(Optional)   Name of the class map. The class map name can be a maximum of 40 alphanumeric   characters.

Command Default

All class maps are displayed.

Usage Guidelines

You can use the show class-map command to display all class maps and their matching criteria. If you enter the optional class-map-name argument, the specified class map and its matching criteria will be displayed.

Examples

The following example shows how to display class-map information for all class maps:

Router# show class-map

Class Map match-any class-default (id 0)

   Match any

Class Map match-any class-simple (id 2)

   Match any

Class Map match-all ipp5 (id 1)

   Match ip precedence 5

Class Map match-all agg-2 (id 3)

show queuing interface

To display the queueing statistics of an interface, use the show queueing interface command in user EXEC or privileged EXEC mode.

show queueing interface type number [vc

Catalyst 6500 Series Switches

show queueing interface {type number | null 0 | vlan vlan-id} [detailed]

Syntax Description

type number

Interface   type and interface number.

For   Cisco 7600 series routers, the valid interface types are ethernet, fastethernet,   gigabitethernet, tengigabitethernet, pos, atm,   and ge-wan.

For   Cisco 7600 series routers, the interface number is the module and port   number. See the "Usage Guidelines" section for more information.

vc

(Optional)   Shows the weighted fair queueing (WFQ) and Weighted Random Early Detection   (WRED) parameters associated with a specific virtual circuit (VC). If   desired, both the virtual path identifier (VPI) and virtual channel   identifier (VCI) values, or just the VCI value, can be specified.

vpi/

(Optional)   The VPI. If the vpi argument is omitted, 0 is used as the VPI value   for locating the permanent virtual circuit (PVC). If the vpi argument   is specified, the / separator is required.

vci

(Optional)   The VCI.

null   0

Specifies   the null interface number; the only valid value is 0.

vlan vlan-id

Specifies   the VLAN identification number; valid values are from 1 to 4094.

detailed

(Optional)   Displays the detailed statistics information per policy class.

Catalyst 6500 Series Switches

In Cisco IOS Release 12.2(33)SXI and later releases, the optional detailed keyword is available. The show queueing interface detailed command output includes the following information:

? Display of the last 30-second counters.

? Display of the peak 30-second counters over the last 5 minutes.

? Display of the 5-minute average and peak bps rates.

? The peak rates are monitored with 10-second resolution. Releases prior to Cisco IOS Release 12.2(33)SXI were monitored at 30-second resolution.

Loading.

Actions

This Document