Using Modular QoS CLI

This chapter describes how to configure Modular QoS CLI (MQC) objects that can be used for configuring QoS features using Cisco Connected Grid OS (Cisco CG-OS) software.

This chapter includes the following sections:

•Information About MQC

•Configuring or Modifying a Class Map

•Configuring or Modifying a Policy Map

Information About MQC

This section provides an overview of the Modular QoS and includes the following topics:

•MQC Structure

•System-Defined MQC Object

•Using an MQC Object

MQC Structure

MQC provides a language to define QoS policies.

To configure QoS on the Cisco CG-OS router, follow these steps:

1. Create class maps.

Class maps are a class of traffic that is based on packet-matching criteria. Class maps are referenced in policy maps.

2. Create policy maps.

Policy maps specify actions to take on class maps such as marking.

Note You define the class-map and policy-map object types when you create them.

3. Apply service policies to a Layer 3 interface.

Service policies apply a specified policy map to output packets on an interface. The Cisco CG-OS router supports the following interfaces: cellular, WiMax, and Ethernet.

You can view all or individual values for MQC objects by using the show class-map and show policy-map commands.

System-Defined MQC Object

Type qos is the default class-map on the Cisco CG-OS router. Additionally, by default, the Cisco CG-OS router assigns the type qos class map class-default to all packets that do not match any defined match criteria within a type qos policy map.

Using an MQC Object

A packet is matched sequentially to a class of traffic starting from the first traffic class definition (see Sequencing of QoS Actions). When a match is found, the Cisco CG-OS router applies the policy actions for that class to the packet.

The reserved class map receives all traffic that is not matched in type qos policies, and the Cisco CG-OS router applies the policy actions as it would for any other traffic class.

Configuring an MQC Object

When you specify an MQC object command, the Cisco CG-OS router creates the object and enters map mode (pmap) as seen in the example below: 

router (config)# policy-map type qos priority_queuing_2

router (config-pmap-qos)#

 
   
 
   
 
     
   
 
   
 
    
   
 Note Because type qos is the system-defined default, you can exclude type qos from the policy-map type qos priority_queuing_2 command above and it yields the same result. 
 
   
 
    
   
 To remove a class-map or policy-map object, use the no form of the command that you used to create the object as seen in the example below: 
 
    
   
 router (config-pmap-qos)# no policy-map type qos priority_queuing_2 
 
    
     
    
    
   
 Configuring or Modifying a Class Map 
 
    
   
 You can create or modify a class map, and, then reference class maps in policy maps. 
 
     
    
   
 BEFORE YOU BEGIN 
 
    
   
 Determine the names that you want to assign to the class maps. 
 
     
    
   
 DETAILED STEPS 
 
    
   
 
 
   
 
    
 
      
      
      
 
         
        
        

          Command 
        
 		 
        
        

          Purpose 
        
 		 
      
 
      
 
       
 Step 1  
 		 
       
 configuration terminal 
 		 
       
 Enters configuration mode. 
 		 
      
 
      
 
       
 Step 2  
 		 
       
 class-map [type qos] [match-any | match-all] class-map-name 
 		 
       
 Creates or accesses the class map of type qos, and then enters class-map qos mode. Class-map names can contain alphabetic, hyphen, or underscore characters, are case sensitive, and can be up to 40 characters. 
 		 
      
 
      
 
       
 Step 3  
 		 
       
 exit 
 		 
       
 Exits class-map qos mode and enters configuration mode. 
 		 
      
 
      
 
       
 Step 4  
 		 
       
 class-map type qos match-any class-map-name 
 		 
       
 Creates or accesses the class map of type qos, and then enters class-map qos mode. 
 		 
      
 
      
 
       
 Step 5  
 		 
       
 show class-map type qos [class-map-name] 
 		 
       
 (Optional) Displays information about all configured class maps or a selected class map of type qos. 
 		 
      
 
      
 
       
 Step 6  
 		 
       
 copy running-config startup-config 
 		 
       
 (Optional) Saves the running configuration to the startup configuration. 
 		 
      
 
      
    
 
   
 
   
 
 
     
    
   
 EXAMPLE 
 
    
   
 This example shows how to create or modify a class map of type qos. 
 
    
   
 
    
router# configuration terminal

 
   
 
    
   
 
    
router(config)# class-map type match-any priority_1

 
   
 
    
   
 
    
router(config-cmap-qos)# match dscp 5

 
   
 
    
   
 
    
router(config-cmap-qos)# exit

 
   
 
    
   
 
    
router(config)# copy running-config startup-config

 
   
 
     
    
    
   
 Configuring or Modifying a Policy Map 
 
    
    
   
 You can create or modify a policy map to define the actions to perform on class maps. 
 
     
    
   
 DETAILED STEPS 
 
    
   
 
 
   
 
    
 
      
      
      
 
         
        
        

          Command 
        
 		 
        
        

          Purpose 
        
 		 
      
 
      
 
       
 Step 1  
 		 
       
 configuration terminal 
 		 
       
 Enters configuration mode. 
 		 
      
 
      
 
       
 Step 2  
 		 
       
 policy-map [type qos] [match-first] policy-map-name  
 		 
       
 Creates or accesses the policy map of type qos and then enters policy-map mode. Policy-map names can contain alphabetic, hyphen, or underscore characters, are case sensitive, and can be up to 40 characters. 
 		 
      
 
      
 
       
 Step 3  
 		 
       
 show policy-map [type qos] [policy-map-name] 
 		 
       
 (Optional) Displays information about all configured policy maps or a selected policy map of type qos. 
 		 
      
 
      
 
       
 Step 4  
 		 
       
 copy running-config startup-config 
 		 
       
 (Optional) Saves the running configuration to the startup configuration. 
 		 
      
 
      
    
 
   
 
   
 
 
     
    
   
 EXAMPLE 
 
    
   
 This example shows how to create or modify a policy map of type qos. 
 
    
   
 
    
router# configuration terminal

 
   
 
    
   
 
    
router(config)# policy-map policy1

 
   
 
    
   
 
    
router(config-pmap-qos)# copy running-config startup-config

 
   
 
    
   
 
    
 
   
 
   
 
     
   
 
   
 
    
   
 Note In the example above, the policy-map policy1 command is equivalent to the policy-map type qos policy1 command. The Cisco CG-OS router assumes a policy map of type qos, because it is the system default when a command does not specify a type. 
 
   
 
     
    
    
   
 Applying Descriptions to MQC Objects 
 
    
   
 You can use the description command to add a description to an MQC object such as a class map and a policy map. 
 
     
    
   
 BEFORE YOU BEGIN 
 
    
   
 Access the class map or policy map. 
 
     
    
   
 DETAILED STEPS 
 
    
   
 
 
   
 
    
 
      
      
      
 
         
        
        

          Command 
        
 		 
        
        

          Purpose 
        
 		 
      
 
      
 
       
 Step 1  
 		 
       
 configuration terminal 
 		 
       
 Enters configuration mode. 
 		 
      
 
      
 
       
 Step 2  
 		 
       
 class-map [type qos] [match-any] class-map-name 
 		 
       
 Creates or accesses the class map, and then enters class-map mode. The class-map name can contain alphabetic, hyphen, or underscore characters, is case sensitive, and can be up to 40 alphanumeric characters. 
 		 
      
 
      
 
       
 policy-map [type qos] [match-first] [policy-map-name] 
 		 
       
 Creates or accesses the policy map, and then enters policy-map mode. The policy-map name can contain alphabetic, hyphen, or underscore characters, is case sensitive, and can be up to 40 characters. 
 		 
      
 
      
 
       
 Step 3  
 		 
       
 description string 
 		 
       
 Adds a description string to the MQC object. The description can be up to 200 alphanumeric characters. 
 
 Note You cannot modify the description of system-defined qos class maps. 
 		 
      
 
      
 
       
 Step 4  
 		 
       
 copy running-config startup-config 
 		 
       
 (Optional) Saves the running configuration to the startup configuration. 
 		 
      
 
      
    
 
   
 
   
 
 
     
    
   
 EXAMPLE 
 
    
   
 This example shows how to add a description to a class map: 
 
    
   
router# configuration terminal 
 
    
   
router(config)# class-map class1 
 
    
   
router(config-cmap-qos)# description my traffic class 
 
    
   
router(config-cmap-qos)# copy running-config startup-config 
 
    
   
 
 
     
    
    
   
 Verifying an MQC Object 
 
    
    
   
 To display MQC object configuration information, perform one of the following tasks: 
 
    
   
 
 
   
 
    
 
      
      
      
 
        
        

          Command 
        
 		 
        
        

          Purpose 
        
 		 
      
 
      
 
       
 show class-map [type qos] [class-map-name] 
 		 
       
 Displays information about all configured class maps or a selected class map of type qos. 
 		 
      
 
      
 
       
 show policy-map [type qos] [policy-map-name] 
 		 
       
 Displays information about all configured policy maps or a selected policy map of type qos.