Port level egress rate-limiting
This section provides information to configure port level egress-rate command using the command line interface.
Overview
Egress port rate limiting allows the device to limit the traffic that egresses through a port to a value less than the available link bandwidth. This feature is supported on the 7210 SAS-series platforms.
Applications
This feature is useful when connecting the 7210 SAS to an Ethernet-over-SDH (EoSDH) (or microwave) network, where the network allocates predetermined bandwidth to the nodes connecting into it, based on the transport bandwidth requirement. When connecting to such a network it is important that the traffic sent into the SDH node does not exceed the configured values because the SDH network does not have QoS capabilities and buffers required to prioritize the ingress traffic.
Egress rate attributes include:
Allows for per port configuration of the maximum egress port rate, using the egress-rate CLI command.
Ethernet ports configured as access, access uplink and network support this feature.
The port scheduler distributes the available maximum egress bandwidth based on the CIR/PIR configuration parameters provisioned for the queues.
Provides support for a burst parameter to control the amount of burst the egress port can generate.
When ports are members of a LAG, all the ports use the same value for the egress-rate and the max-burst parameters.
If frame overhead accounting is enabled, then queue scheduler accounts for the Ethernet frame overhead.
Effect of port level rate-limiting on network queue functionality
When an egress-rate sub-rate value is given, the network queue (on network ports or access uplink ports) rates that are specified using percentages will use the egress-rate value instead of the port bandwidth (if egress rate is lesser than port bandwidth) to configure the appropriate queue rates. Configuration of egress port rate to different values will result in a corresponding dynamic adjustment of rates for the queues configured on network ports, or access uplink ports.
When the egress-rate sub-rate value is set, CBS/MBS of the associated network queues will not change.
Basic configurations
To apply port level rate-limiting, perform the following:
The egress-rate command is present in the *A:Dut-1>config>port>ethernet context.
The egress-rate configures the maximum rate (in kbps) for the port. The value should be between 1 and 1000000 kbps and between 1 and 10000000 kbps for a 10G port.
The max-burst command configures a maximum-burst (in kilo-bits) associated with the egress-rate. This is an optional parameter and if not defined then, by default, it is set to 64 kb for a 1G port and 64 kb for a 10G port. Users cannot configure max-burst without configuring egress-rate. The max-burst value should be between 32 and 16384 or the default.
By default there is no egress-rate command set on port. The default egress-rate for a port is the maximum (equal to line-rate).
On 10G port, if Egress port Rate Limiter (ERL) configured is more than 8Gig, Nokia recommends configuring the burst value higher than 80kbits to avoid packet drops.
The following is a sample configuration output that shows the egress-rate configuration for a port.
*A:Dut-1>config>port# info
----------------------------------------------
ethernet
egress-rate 120000 max-burst 234
exit
no shutdown
----------------------------------------------
*A:Dut-1>config>port#
Modifying port level egress-rate command
To modify egress rate parameters you can simply apply an egress-rate command with new egress-rate and max-burst value.
The following is a sample configuration that shows a modified egress-rate configuration for a port.
*A:Dut-1>config>port# ethernet egress-rate 10000 max-burst default
*A:Dut-1>config>port# info
----------------------------------------------
ethernet
egress-rate 10000
exit
no shutdown
----------------------------------------------
*A:Dut-1>config>port#
Removing port level egress-rate command
To remove egress-rate command from a port, use the no option with the egress-rate command. Do not include the rate for the egress-rate and max-burst options. Use the following syntax to remove the egress-rate command from a port.
config>port>ethernet# no egress-rate
The following is a sample configuration output that shows the removal of egress-rate configuration from a port.
*A:Dut-1>config>port# no ethernet egress-rate
*A:Dut-1>config>port# info
----------------------------------------------
ethernet
exit
no shutdown
----------------------------------------------
*A:Dut-1>config>port#
Default egress-rate values
By default no egress-rate is configured for a port.
Port level egress-rate command reference
Command hierarchies
Configuration commands
config
- port
- ethernet
- egress-rate sub-rate [max-burst size-in-kbits]
- no egress-rate
Show commands
show
- port [port-id]
Command descriptions
Configuration commands
egress-rate
Syntax
egress-rate sub-rate [max-burst size-in-kbits]
no egress-rate
Context
config>port>ethernet
Platforms
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
Description
This command configures the maximum rate and corresponding burst value for a port.
The no form of this command removes the egress-rate from the port.
Parameters
- sub-rate
Specifies the maximum rate, in kbps.
- max-burst size-in-kbits
Specifies the maximum burst size, in kbs.
Show commands
port
Syntax
port [port-id]
Context
show
Platforms
Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode
Description
This command displays the egress rate and max burst value set for the port, along with other details about the port.
Parameters
- port-id
Displays information about the specific port ID.
Output
The following output is an example of port information, and Output fields: specific port describes the output fields.
Sample output*A:Dut-1>config>port>ethernet# show port 1/1/23
===============================================================================
Ethernet Interface
===============================================================================
Description : 10/100/Gig Ethernet SFP
Interface : 1/1/23 Oper Speed : 100 mbps
Link-level : Ethernet Config Speed : 1 Gbps
Admin State : up Oper Duplex : full
Oper State : up Config Duplex : full
Physical Link : Yes MTU : 9212
IfIndex : 36405248 Hold time up : 0 seconds
Last State Change : 03/12/2001 03:31:09 Hold time down : 0 seconds
Last Cleared Time : N/A
Configured Mode : network Encap Type : null
Dot1Q Ethertype : 0x8100 QinQ Ethertype : 0x8100
Net. Egr. Queue Pol: default Access Egr. Qos *: n/a
Egr. Sched. Pol : default Network Qos Pol : 1
Auto-negotiate : true MDI/MDX : MDX
Accounting Policy : None Collect-stats : Disabled
Egress Rate : 100000 Max Burst : 8000
Down-when-looped : Disabled Keep-alive : 10
Loop Detected : False Retry : 120
Configured Address : 00:f7:d6:5e:98:18
Hardware Address : 00:f7:d6:5e:98:18
Cfg Alarm :
Alarm Status :
Transceiver Data
Transceiver Type : SFP
Model Number : 3HE00062AAAA01 ALA IPUIAEHDAA6
TX Laser Wavelength: 0 nm Diag Capable : no
Connector Code : Unknown Vendor OUI : 00:90:65
Manufacture date : 2008/09/11 Media : Ethernet
Serial Number : PEB2WGH
Part Number : FCMJ-8521-3-A5
Optical Compliance : GIGE-T
Link Length support: 100m for copper
===============================================================================
Traffic Statistics
===============================================================================
Input Output
-------------------------------------------------------------------------------
Octets 15028477 3236
Packets 16729 19
Errors 0 0
===============================================================================
* indicates that the corresponding row element may have been truncated.
===============================================================================
Port Statistics
===============================================================================
Input Output
-------------------------------------------------------------------------------
Unicast Packets 11611 17
Multicast Packets 359 0
Broadcast Packets 4759 2
Discards 0 0
Unknown Proto Discards 0
===============================================================================
===============================================================================
Ethernet-like Medium Statistics
===============================================================================
Alignment Errors : 0 Sngl Collisions : 0
FCS Errors : 0 Mult Collisions : 0
SQE Test Errors : 0 Late Collisions : 0
CSE : 0 Excess Collisns : 0
Too long Frames : 0 Int MAC Tx Errs : 0
Symbol Errors : 0 Int MAC Rx Errs : 0
===============================================================================
*A:MTU-T2>config>port>ethernet#
| Label | Description |
|---|---|
Description |
A text description of the port |
Interface |
The physical port ID in the form slot/mda/port for non-QSFP28 ports, or slot/mda/cport/channel for QSFP28 ports |
Oper Speed |
The speed of the interface |
Link-level |
Ethernet — The port is configured as Ethernet |
Config Speed |
The configured speed of the interface |
Admin State |
Up — The port is administratively up Down — The port is administratively down |
Oper Duplex |
Full — The link is set to full duplex mode Half — The link is set to half duplex mode |
Oper State |
Up — The port is operationally up Down — The port is operationally down Additionally, the lag-id of the LAG it belongs to in addition to the status of the LAG member (active or standby) is specified. |
Config Duplex |
Full — The link is set to full duplex mode Half — The link is set to half duplex mode |
Physical Link |
Yes — A physical link is present No — A physical link is not present |
MTU |
The size of the largest packet which can be sent/received on the Ethernet physical interface, specified in octets |
IfIndex |
Displays the interface's index number which reflects its initialization sequence |
Hold time up |
The link up dampening time in seconds The port link dampening timer value which reduces the number of link transitions reported to upper layer protocols. |
Last State chg |
Displays the system time moment that the peer is up |
Hold Time Down |
The link down dampening time in seconds The down timer controls the dampening timer for link down transitions. |
Last Cleared Time |
The time since the last clear |
Configured Mode |
network — The port is configured for transport network use access — The port is configured for service access |
Encap Type |
Null — Ingress frames will not use any tags or labels to delineate a service dot1q — Ingress frames carry 802.1Q tags where each tag signifies a different service QinQ — Encapsulation type specified for QinQ Access SAPs |
Dot1q Ethertype |
Indicates the Ethertype expected when the port's encapsulation type is dot1q |
QinQ Ethertype |
Indicates the Ethertype expected when the port's encapsulation type is QinQ |
Net. Egr. Queue Pol |
Specifies the network egress queue policy or that the default policy is used |
Access Egr. Qos |
Specifies the access egress policy or that the default policy 1 is in use |
Egr. Sched. Pol |
Specifies the port scheduler policy or that the default policy default is in use |
Network Qos Pol |
The network QoS policy ID applied to the port |
Auto-negotiate |
True — The link attempts to automatically negotiate the link speed and duplex parameters False — The duplex and speed values are used for the link |
MDI/MDX |
Indicates the Ethernet interface type |
Accounting Policy |
Indicates the accounting policy, if configured |
Collect-stats |
Enabled — The collection of accounting and statistical data for the network Ethernet port is enabled When applying accounting policies the data by default is collected in the appropriate records and written to the designated billing file. Disabled — Collection is disabled Statistics are still accumulated by the IOM cards, however, the CPU does not obtain the results and write them to the billing file. |
Egress Rate |
The maximum amount of egress bandwidth (in kilobits per second) that this Ethernet interface can generate |
Max Burst |
The maximum number of RSVP messages to be sent |
Down-when-looped |
Shows whether the feature is enabled or disabled |
Keep-alive |
The interval at which keep-alive messages are exchanged |
Loop Detected |
Indicates whether a loop is detected on the port |
Retry |
Indicates the minimum wait time before the port is re-enabled after it is brought down because of a loop detection |
Configured Address |
The base chassis Ethernet MAC address |
Hardware Address |
The interface's hardware or system assigned MAC address at its protocol sublayer |
Transceiver Data |
|
Transceiver Type |
Type of the transceiver |
Model Number |
The model number of the transceiver |
Transceiver Code |
The code for the transmission media |
TX Laser Wavelength |
The light wavelength transmitted by the transceiver laser |
Connector Code |
The vendor organizationally unique identifier field (OUI) contains the IEEE company identifier for the vendor |
Diag Capable |
Indicates if the transceiver is capable of doing diagnostics |
Vendor OUI |
The vendor-specific identifier field (OUI) contains the IEEE company identifier for the vendor |
Manufacture date |
The manufacturing date of the hardware component in the mmddyyyy ASCII format |
Media |
The media supported for the SFP |
Serial Number |
The vendor serial number of the hardware component |
Part Number |
The vendor part number contains ASCII characters, defining the vendor part number or product name |
Traffic Statistics |
|
Input/Output |
When the collection of accounting and statistical data is enabled, octet, packet, and error statistics are displayed |
Octets |
Total number of octets received |
Packets |
The number of packets received, broken down by size Port Statistics |
Port Statistics |
|
Errors Input/Output |
For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol For packet-oriented interfaces, the number of outbound packets that could not be transmitted because of errors For character-oriented or fixed-length interfaces, the number of outbound transmission units that could not be transmitted because of errors |
Unicast Packets Input/Output |
The number of packets, delivered by this sublayer to a higher sublayer, which were not addressed to a multicast or broadcast address at this sublayer The total number of packets that higher-level protocols requested be transmitted, and which were not addressed to a multicast or broadcast address at this sublayer, including those that were discarded or not sent |
Multicast Packets Input/Output |
The number of packets, delivered by this sublayer to a higher sublayer, which were addressed to a multicast address at this sublayer For a MAC layer protocol, this includes both group and functional addresses. The total number of packets that higher-level protocols requested be transmitted, and which were addressed to a multicast address at this sublayer, including those that were discarded or not sent For a MAC layer protocol, this includes both Group and Functional addresses. |
Broadcast Packets Input/Output |
The number of packets, delivered by this sublayer to a higher sublayer, which were addressed to a broadcast address at this sublayer The total number of packets that higher-level protocols requested be transmitted, and which were addressed to a multicast address at this sublayer, including those that were discarded or not sent For a MAC layer protocol, this includes both Group and Functional addresses. |
Discards Input/Output |
The number of inbound packets chosen to be discarded to possibly free up buffer space |
Unknown Proto Discards Input/Output |
For packet-oriented interfaces, the number of packets received through the interface which were discarded because of an unknown or unsupported protocol For character-oriented or fixed-length interfaces that support protocol multiplexing the number of transmission units received via the interface which were discarded because of an unknown or unsupported protocol For any interface that does not support protocol multiplexing, this counter is always 0. |
Ethernet-like Medium Statistics |
|
Alignment Errors |
The total number of packets received that had a length (excluding framing bits, but including FCS octets) of between 64 and 1518 octets, inclusive, but that had either a bad Frame Check Sequence (FCS) with an integral number of octets (FCS Error) or a bad FCS with a non-integral number of octets |
FCS Errors |
The number of frames received that are an integral number of octets in length but do not pass the FCS check |
SQE Errors |
The number of times that the SQE TEST ERROR is received |
CSE |
The number of times that the carrier sense condition was lost or never asserted when attempting to transmit a frame |
Too long Frames |
The number of frames received that exceed the maximum permitted frame size |
Symbol Errors |
For an interface operating at 100 Mb/s, the number of times there was an invalid data symbol when a valid carrier was present |
Sngl Collisions |
The number of frames that are involved in a single collision, and are subsequently transmitted successfully |
Mult Collisions |
The number of frames that are involved in more than one collision and are subsequently transmitted successfully |
Late Collisions |
The number of times that a collision is detected later than one slot Time into the transmission of a packet |
Excess Collisions |
The number of frames for which a transmission fails because of excessive collisions |
Int MAC Tx Errs |
The number of frames for which a transmission fails because of an internal MAC sublayer transmit error |
Int MAC Rx Errs |
The number of frames for which a reception fails because of an internal MAC sublayer receive error |