Frame-based accounting

This chapter provides information to configure frame-based accounting using the CLI.

Overview

When enabled, frame-based accounting allows QoS policies account for the Ethernet frame overhead. For example, it accounts for the IFG (inter-frame gap) and the preamble. Typically, the IFG and preamble constitute 20 bytes (12 + 8). The QoS meter/policer and shaper use this overhead when allocating bandwidth for Ethernet ports.

Frame-based accounting

A configurable CLI command enables accounting of the frame overhead on ingress or egress. This is a system-wide parameter that affects the behavior of the ingress meter or egress rate. When disabled, the queue rates and egress-rate do not account for the Ethernet frame overhead. By default, frame-based accounting is disabled for both ingress and egress.

Note:

Frame-based accounting for SAP-egress aggregate meters is not supported on the 7210 SAS platforms described in this document.

Effects of enabling ingress frame-based accounting on ingress meter functionality

To enable system-wide consistency in configuring QoS queue and meter rate parameters, the meters used on the system ingress may need to account for Ethernet frame overhead. Access uplink ingress and service ingress meters account for Ethernet frame overhead. A configurable CLI command can enable or disable the frame overhead accounting. This is a system-wide command that affects the behavior of all the meters in the system.

Effects of enabling egress frame-based accounting on access-uplink queue functionality

If frame overhead consideration is enabled, the queue scheduler accounts for the Ethernet frame overhead. The maximum egress bandwidth accounts for the Ethernet frame overhead (it accounts for the IFG (inter-frame gap) and the preamble). Typically, the IFG and preamble constitute about 20 bytes (12 + 8). The overhead for Ethernet ports uses this value.

A configurable CLI command enables accounting of the frame overhead. This is a system-wide command that affects the behavior of all egress queues (when frame-based accounting is enabled on egress port, the associated queues also account for frame overhead implicitly). When disabled, the port egress-rate command does not account for the Ethernet frame overhead.

Note:

Frame-based accounting does not affect the SAP egress aggregate rate command on 7210 SAS-D and 7210 SAS-Dxp. In other words, the SAP egress aggregate command does not account for the Ethernet frame overhead regardless of whether egress frame-based accounting is enabled or disabled.

Accounting and statistics

Accounting records and statistics do not account for frame overhead.

Basic configurations

To enable frame-based accounting, perform the following:

Enable the frame-based-accounting command in the config>qos>frame-based-accounting context.
Configure the ingress-enable command to enable frame-based accounting for ingress metering.
Configure the egress-enable command to enable frame-based-accounting for egress queue rates, scheduler and port level egress-rate.

The following is a sample frame-based accounting configuration output.

*A:Dut-1>config>qos>frame-based-accounting# info detail 
----------------------------------------------
            no ingress-enable
            no egress-enable
----------------------------------------------
*A:Dut-1>config>qos>frame-based-accounting#

Enabling and disabling frame-based accounting

To enable the frame-based-accounting command for ingress, use the ingress-enable command. To disable the frame-based-accounting command for ingress, use the no ingress-enable command. To enable the frame-based-accounting command on egress, use the egress-enable command. To disable frame-based-accounting command on egress, use the no egress-enable command.

config>qos>frame-based-accounting

The following is a sample configuration output that shows the enabling of frame-based-accounting.

*A:Dut-1>config>qos>frame-based-accounting# ingress-enable 
*A:Dut-1>config>qos>frame-based-accounting# egress-enable 
*A:Dut-1>config>qos>frame-based-accounting# info 
----------------------------------------------
            ingress-enable
            egress-enable
----------------------------------------------
*A:Dut-1>config>qos>frame-based-accounting#

The following is a sample configuration output that shows the disabling of frame-based-accounting.

*A:Dut-1>config>qos>frame-based-accounting# no ingress-enable 
*A:Dut-1>config>qos>frame-based-accounting# no egress-enable 
*A:Dut-1>config>qos>frame-based-accounting# info detail 
----------------------------------------------
            no ingress-enable
            no egress-enable
----------------------------------------------
*A:Dut-1>config>qos>frame-based-accounting#

Frame-based accounting command reference

Command hierarchies

Configuration commands

    - config
        - qos
            - frame-based-accounting
                - [no] egress-enable
                - [no] ingress-enable

Show commands

    - show
        - qos
            - sap-ingress [policy-id] [association | match-criteria | detail]
            - network [policy-id] [detail] 
            - access-egress [policy-id] [association | detail] 
            - network-queue [network-queue-policy-name] [detail] 
            - port-scheduler-policy [port-scheduler-policy-name] [association]

Configuration descriptions

Configuration commands

frame-based-accounting

Syntax

frame-based-accounting

Context

config>qos

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure frame-based accounting.

egress-enable

Syntax

[no] egress-enable

Context

config>qos>frame-based-accounting

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables the frame-based accounting for access egress, network queue, port scheduler, SAP or network aggregate rate, and port-level egress rate.

The no form of the command disables frame-based accounting for all egress QoS.

Default

no egress-enable

ingress-enable

Syntax

[no] ingress-enable

Context

config>qos>frame-based-accounting

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables frame-based accounting for SAP-ingress and network QoS.

The no form of the command disables frame-based accounting for SAP-ingress and network QoS.

Default

no ingress-enable

Show commands

sap-ingress

Syntax

sap-ingress [policy-id] [association | match-criteria | detail]

Context

show>qos

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays the accounting status of a SAP-ingress policy along with other details of the policy. When frame-based-accounting is enabled, accounting is shown as frame-based, otherwise it is shown as packet-based.

Parameters

policy-id: Displays information about the specific policy ID.

association: Displays the associations of the SAP-ingress policy.

match-criteria: Displays the match criteria of the SAP-ingress policy.

detail: Displays the detailed information of the SAP-ingress policy.

Output

The following output is an example of SAP-ingress QoS policy information, and Output fields: QoS SAP-ingress describes the output fields.

Sample output

*A:Dut-1# show qos sap-ingress 1 
===============================================================================
QoS Sap Ingress
===============================================================================
-------------------------------------------------------------------------------
Sap Ingress Policy (1)
-------------------------------------------------------------------------------
Policy-id          : 1                        Scope              : Template    
Default FC         : be                                                        
Criteria-type      : None                                                      
Accounting         : frame-based                                               
Classifiers Allowed: 16                       Meters Allowed     : 8           
Classifiers Used   : 2                        Meters Used        : 2           
Description    : Default SAP ingress QoS policy.
 
===============================================================================
*A:Dut-1#

Table 1. Output fields: QoS SAP-ingress
Label	Description
Policy-Id	Displays the ID that uniquely identifies the policy.
Scope	Exclusive Implies that this policy can only be applied to a single SAP.
Scope	Template Implies that this policy can be applied to multiple SAPs on the router.
Default FC	Specifies the default FC for the policy.
Criteria-type	IP Specifies that an IP criteria-based SAP-ingress policy is used to select the appropriate ingress meter and corresponding FC for matched traffic.
Accounting	Packet-based Specifies that the meters associated with this policy do not account for packet framing overheads (such as Ethernet the Inter Frame Gap (IFG) and the preamble), while accounting for the bandwidth to be used by this flow. Frame-based Specifies that the meters associated with this policy account for the packet framing overheads (such as for Ethernet the IFG and preamble), while accounting the bandwidth to be used by the flow.
Classifiers Allowed	Indicates the number of classifiers allowed for a service.
Meters Allowed	Indicates the number of meters allowed for a service.
Classifiers Used	Indicates the number of classifiers used for a service.
Meters Used	Indicates the number of meters used for a service.
Description	A text string that helps identify the policy’s context in the configuration file.

network

Syntax

network [policy-id] [detail]

Context

show>qos

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays the accounting status of a network QoS policy in addition to other details about the policy. When frame-based-accounting is enabled, accounting is shown as frame-based, otherwise it is shown as packet-based.

Parameters

policy-id: Displays information about the specific policy ID.

detail: Displays the detailed policy information.

Output

The following output is an example of network information, and Output fields: show QoS network describes the output fields.

Sample output

*A:Dut-1# show qos network 1 
===============================================================================
QoS Network Policy
===============================================================================
-------------------------------------------------------------------------------
Network Policy (1)
-------------------------------------------------------------------------------
Policy-id      : 1                            Remark       : False             
Forward Class  : be                           Profile      : Out               
Attach Mode    : l2                           Config Mode  : l2+mpls           
Scope          : Template                     Policy Type  : port              
Accounting     : frame-based                                                   
Description    : Default network-port QoS policy.
-------------------------------------------------------------------------------
Meter Mode   CIR Admin   CIR Rule   PIR Admin   PIR Rule    CBS       MBS
-------------------------------------------------------------------------------
1     TrTcm_CA  0         closest       max       closest   32        128 
-------------------------------------------------------------------------------
FC                  UCastM         MCastM         
-------------------------------------------------------------------------------
No FC-Map Entries Found. 
-------------------------------------------------------------------------------
Port Attachments
-------------------------------------------------------------------------------
Port-id : 1/1/3                                                                
Port-id : 1/1/6                                                                
Port-id : 1/1/7                                                                
Port-id : 1/1/8                                                                
Port-id : 1/1/9                                                                
===============================================================================
*A:Dut-1#

Table 2. Output fields: show QoS network
Label	Description
Policy-Id	The ID that uniquely identifies the policy.
Remark	Remarking can be enabled or disabled.
Forward Class	Specifies the FC name.
Profile	Out Specifies the EXP marking for the packets which are out-of-profile, egressing on this queue. Specifies the dot1p marking for the out-of-profile packets which egressing on this queue.
Profile	In Specifies the EXP marking for the packets which are in-of-profile, egressing on this queue.Specifies the dot1p markings for in-profile packets egressing on this queue.
Scope	Exclusive Specifies that this policy can be applied only to a single network port. Template Specifies that this policy can be applied to multiple network ports on the router.
Policy Type	Specifies the policy type.
Accounting	Packet-based Specifies that the meters associated with this policy do not account for packet framing overheads (such as Ethernet the Inter Frame Gap (IFG) and the preamble), while accounting for the bandwidth to be used by this flow. Frame-based Specifies that the meters associated with this policy account for the packet framing overheads (such as for Ethernet the IFG and preamble), while accounting the bandwidth to be used by the flow.
Description	A text string that helps identify the policy’s context in the configuration file.
Meter Mode	Specifies the configured mode of the meter.
CIR Admin	Specifies the administrative Committed Information Rate (CIR) parameters for the meters.
CIR Rule	min The operational CIR for the meters will be equal to or greater than the administrative rate specified using the rate command.
	max The operational CIR for the meter will be equal to or less than the administrative rate specified using the rate command.
	closest The operational PIR for the meters will be the rate closest to the rate specified using the rate command without exceeding the operational PIR.
PIR Admin	Specifies the administrative Peak Information Rate (PIR) parameters for the meters.
PIR Rule	min The operational CIR for the meters will be equal to or greater than the administrative rate specified using the rate command.
	max The operational CIR for the meter will be equal to or less than the administrative rate specified using the rate command.
	closest The operational PIR for the meters will be the rate closest to the rate specified using the rate command without exceeding the operational PIR.
CBS	def Specifies the default CBS value for the meters.
CBS	value Specifies the value to override the default reserved buffers for the meters.
MBS	def Specifies the default MBS value.
MBS	value Specifies the value to override the default MBS for the meter.
Port-id	Specifies the port number.

access-egress

Syntax

access-egress [policy-id] [association | detail]

Context

show>qos

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays the accounting status of an access-egress policy in addition to other details about the policy. When frame-based-accounting is enabled, accounting is shown as frame-based, otherwise it is shown as packet-based.

Parameters

policy-id: Displays information about the specific policy ID.

association: Displays the policy associations.

detail: Displays the policy information in detail.

Output

The following output is an example of access-egress QoS policy information, and Output fields: access egress describes the output fields.

Sample output

*A:Dut-1# show qos access-egress 1 
===============================================================================
QoS Access Egress
===============================================================================
-------------------------------------------------------------------------------
Policy-id      : 1                            Scope        : Template          
Remark         : False                       
Accounting     : frame-based                 
Description    : Default Access egress QoS policy.
===============================================================================
*A:Dut-1#

Table 3. Output fields: access egress
Label	Description
Policy-Id	Specifies the ID that uniquely identifies the policy.
Scope	Exclusive Specifies that this policy can be applied only to a single access egress port. Template Specifies that this policy can be applied to multiple access ports on the router.
Remark	True Specifies that remarking is enabled for all the dot1q-tagged packets that egress the ports on which the sap egress QoS policy is applied and remarking is enabled. False Specifies that remarking is disabled for the policy.
Accounting	Packet-based Specifies that the meters associated with this policy do not account for packet framing overheads (such as Ethernet the Inter Frame Gap (IFG) and the preamble), while accounting for the bandwidth to be used by this flow. Frame-based Specifies that the meters associated with this policy account for the packet framing overheads (such as for Ethernet the IFG and preamble), while accounting the bandwidth to be used by the flow.
Description	A text string that helps identify the policy’s context in the configuration file

network-queue

Syntax

network-queue [network-queue-policy-name] [detail]

Context

show>qos

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays the accounting status of a network-queue policy in addition to other details about the policy. When frame-based-accounting is enabled, accounting is shown as frame-based, otherwise it is shown as packet-based.

Parameters

network-queue-policy-name: Displays information about the specific network queue policy.

detail: Displays the detailed policy information.

Output

The following output is an example of network queue information, and Output fields: network queue describes the output fields.

Sample output

*A:Dut-1# show qos network-queue default 
===============================================================================
QoS Network Queue Policy
===============================================================================
-------------------------------------------------------------------------------
Network Queue Policy (default)
-------------------------------------------------------------------------------
Policy         : default                                                       
Accounting     : frame-based                                                   
Description    : Default network queue QoS policy.
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
Port-id : 1/1/6                                                                
Port-id : 1/1/7                                                                
===============================================================================
*A:Dut-1#

Table 4. Output fields: network queue
Label	Description
Policy	The policy name that uniquely identifies the policy.
Accounting	Packet-based Specifies that the meters associated with this policy do not account for packet framing overheads (such as Ethernet the Inter Frame Gap (IFG) and the preamble), while accounting for the bandwidth to be used by this flow. Frame-based Specifies that the meters associated with this policy account for the packet framing overheads (such as for Ethernet the IFG and preamble), while accounting the bandwidth to be used by the flow.
Description	A text string that helps identify the policy’s context in the configuration file.
Port-Id	Displays the physical port identifier where the network queue policy is applied.

port-scheduler-policy

Syntax

port-scheduler-policy [port-scheduler-policy-name] [association]

Context

show>qos

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays the accounting status of a port-scheduler policy in addition to other details about the policy. When frame-based-accounting is enabled, accounting is shown as frame-based, otherwise it is shown as packet-based.

Parameters

port-scheduler-policy-name: Displays information about the specific port scheduler policy.

association: Displays the associations of the port scheduler policy.

Output

The following output is an example of port scheduler policy information, and Output fields: port scheduler policy describes the output fields.

Sample output

*A:Dut-1# show qos port-scheduler-policy default 
===============================================================================
QoS Port Scheduler Policy
===============================================================================
Policy-Name       : default
Description       : Default Port Scheduler policy.
Accounting        : frame-based                                                
Mode              : STRICT                                                     
Last changed      : 08/06/2001 18:36:04                                        
Number Of Queues  : 8

Table 5. Output fields: port scheduler policy
Label	Description
Policy-Name	Displays the port scheduler policy name.
Mode	Displays the port scheduler policy mode (STRICT, RR, WRR, WDRR).
Accounting	Packet-based Specifies that the meters associated with this policy do not account for packet framing overheads (such as Ethernet the Inter Frame Gap (IFG) and the preamble), while accounting for the bandwidth to be used by this flow. Frame-based Specifies that the meters associated with this policy account for the packet framing overheads (such as for Ethernet the IFG and preamble), while accounting the bandwidth to be used by the flow.
Last Changed	Displays the last time the configuration changed.
Queue #	Displays the weight of the queue if configured.