- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 01-IPCC commands | 91.27 KB |
IPCC commands
cnp statistics enable
Use cnp statistics enable to enable CNP statistics collection.
Use undo cnp statistics enable to disable CNP statistics collection.
Syntax
cnp statistics enable
undo cnp statistics enable
Default
CNP statistics collection is disabled.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Usage guidelines
Application scenarios
On an RoCEv2 network, if the destination server receives packets with ECN, it sends CNPs to the source server to notify the source server to reduce the rate at which it sends packets, thereby alleviating congestion.
Operating mechanism
This command allows the device to collect CNP statistics on interfaces. To view CNP statistics, execute display cnp statistics.
Restrictions and guidelines
If you configure this feature on both an aggregate interface and its member ports, the device collect packet statistics only on the member ports. If some member ports of an aggregate interface are not configured with this feature, the aggregate interface will collect packet statistics only from the member ports that are not configured with this feature.
CNP statistics collection is supported only in the incoming direction of an interface.
Examples
# Enable CNP statistics collection.
<Sysname> system-view
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] cnp statistics enable
Related commands
display cnp statistics
display cnp statistics
Use display cnp statistics to display CNP statistics.
Syntax
display cnp statistics interface [ interface-type [ interface-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type [ interface-number ]: Specifies an interface by its type and number. If you do not specify an interface, this command displays CNP statistics on all interfaces. If you specify on an interface type, this command displays CNP statistics on all interfaces of that type.
Examples
# Display CNP statistics on interface HundredGigE 1/0/1.
<Sysname> display cnp statistics interface hundredgige 1/0/1
Interface Input Packets
----------------------------------------
HGE1/0/1 5
Table 1 Command output
|
Field |
Description |
|
Interface |
Abbreviated interface name. |
|
Input Packets |
Number of CNPs in the incoming direction of the interface. |
display ipcc statistics
Use display ipcc statistics to display statistics of CNPs that are proactively sent by the device.
Syntax
display ipcc statistics interface interface-type interface-number
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface interface-type interface-number: Displays statistics of CNPs that are proactively sent by the device for the specified interface.
Examples
# Display brief statistics of CNPs that are proactively sent by the device on HundredGigE 1/0/1.
<Sysname> display ipcc statistics interface gigabitethernet 1/0/1
CNP number: 200
RoCEv2 flow entries active: 2
Active flow information:
------------------------------------------
DIP SIP DQP
------------------------------------------
192.168.20.27 192.168.10.29 156243
192.168.20.11 192.168.10.11 1111
------------------------------------------
Table 2 Command output
|
Field |
Description |
|
CNP number |
Number of CNPs that are proactively sent by the device. |
|
RoCEv2 flow entries active |
Number of active RoCEv2 flow entries. |
|
Active flow Information |
Detailed RoCEv2 active flow entry information. |
|
DIP |
Destination IP. |
|
SIP |
Source IP. |
|
DQP |
Destination QP. |
display nak statistics
Use display nak statistics to display NAK packet statistics.
Syntax
display nak statistics interface [ interface-type [ interface-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type [ interface-number ]: Specifies an interface by its type and number. If you do not specify an interface, this command displays NAK statistics on all interfaces. If you specify on an interface type, this command displays NAK statistics on all interfaces of that type.
Examples
# Display NAK packet statistics on interface HundredGigE 1/0/1.
<Sysname> display nak statistics interface hundredgige 1/0/1
Interface Input Packets
----------------------------------------
HGE1/0/1 4
Table 3 Command output
|
Field |
Description |
|
Interface |
Abbreviated interface name. |
|
Input Packets |
Number of NAK packets in the incoming direction of the interface. |
Related commands
nak statistics enable
ipcc enable
Use ipcc enable to enable IPCC.
Use undo ipcc enable to disable IPCC.
Syntax
ipcc enable
undo ipcc enable
Default
IPCC is disabled.
Views
Interface view
Predefined user roles
network-admin
Usage guidelines
Application scenarios
Intelligent Proactive Congestion Control (IPCC) is an improvement of Explicit Congestion Notification (ECN). It intelligently identifies the interface congestion state and proactively sends CNPs to control the RoCEv2 packet sending rate, ensuring low latency and high throughput.
Restrictions and guidelines
IPCC takes effect only on RoCEv2 packets.
For IPCC to take effect, use the ipcc enable command together with the ipcc queue command.
IPCC performs RoCEv2 traffic analysis based on global bidirectional flows. If IPCC and NetAnalysis are both enabled at the same time, you must specify the bidirectional mode for NetAnalysis and cannot specify the acl keyword for the netanalysis rocev2 statistics command.
For more information about NetAnalysis, see NetAnalysis configuration in Networking Management and Monitoring Configuration Guide.
Examples
# Enable IPCC on interface HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] ipcc enable
Related commands
ipcc mode
ipcc queue
ipcc mode
Use ipcc mode to specify an IPCC mode.
Use undo ipcc mode to restore the default.
Syntax
ipcc mode { high-throughput | low-latency }
undo ipcc mode
Default
IPCC operates in high throughput mode.
Views
System view
Predefined user roles
network-admin
Parameters
high-throughput: Specifies the high throughput mode.
low-latency: Specifies the low latency mode.
Usage guidelines
Configure IPCC high throughput mode for services with a high traffic volume and low latency sensitivity. Configure IPCC low latency mode for services with a low traffic volume and high latency sensitivity.
Examples
# Configure IPCC to operate in low latency mode.
<Sysname> system-view
[Sysname] ipcc mode low-latency
ipcc queue
Use ipcc queue to enable IPCC for a queue.
Use undo ipcc queue to restore the default.
Syntax
ipcc queue queue-id
undo ipcc queue
Default
IPCC is not enabled for a queue.
Views
System view
Predefined user roles
network-admin
Parameters
queue-id: Specifies a queue by its ID in the range of 0 to 7.
Usage guidelines
For IPCC to take effect, use the ipcc queue command together with the ipcc enable command.
After you enable IPCC for a queue, the forwarding device monitors the length of the queue and calculates the number of CNPs to be proactively sent as follows:
· When the length of the queue increases, the forwarding device needs to send a small number of CNPs if the cache usage of the queue is low. If the cache usage of the queue is high, the forwarding device needs to send a large number of CNPs to reduce queue congestion and forwarding latency.
· When the length of the queue decreases, the forwarding device does not need to send CNPs if the cache usage of the queue is low. If the cache usage of the queue is high, the forwarding device needs to send a small number of CNPs to reduce queue congestion while ensuring throughput and latency performance.
Then, the forwarding device constructs CNPs based on the calculated number and address information in the RoCEv2 flow table and sends the CNPs to the sender. After receiving the CNPs, the sender reduces the RoCEv2 packet sending rate.
Examples
# Enable IPCC for queue 4.
<Sysname> system-view
[Sysname] ipcc queue 4
Related commands
ipcc enable
reset ipcc statistics
Use reset ipcc statistics to clear statistics of CNPs that are proactively sent by the device.
Syntax
reset ipcc statistics [ interface interface-type interface-number ]
Views
User view
Predefined user roles
network-admin
Parameters
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify this option, the command clears statistics about CNPs that are proactively sent by the device for all interfaces.
Usage guidelines
To make it easier to view statistics about CNPs proactively sent by the device over a period, you can use this command to clear historical statistics about CNPs proactively sent by the device. The historical statistics that have been cleared cannot be recovered.
Examples
# Clear statistics of CNPs that are proactively sent by the device on HundredGigE 1/0/1.
<Sysname> reset ipcc statistics interface gigabitethernet 1/0/1
Related commands
display ipcc statistics
nak statistics enable
Use nak statistics enable to enable NAK packet statistics collection.
Use undo nak statistics enable to disable NAK packet statistics collection.
Syntax
nak statistics enable
undo nak statistics enable
Default
NAK packet statistics collection is disabled.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Usage guidelines
Application scenarios
On an RoCEv2 network, if the destination server detects an error packet, such as packet loss or packet corruption, it generates and sends a NAK packet to the source server. Upon receiving the NAK packet, the source server identifies the packet that require retransmission based on NAK information, and then retransmits the packet to ensure data integrity and reliability.
Operating mechanism
This command allows the device to collect NAK packet statistics on interfaces. To view NAK packet statistics, execute display nak statistics.
Restrictions and guidelines
If you configure this feature on both an aggregate interface and its member ports, the device collect packet statistics only on the member ports. If some member ports of an aggregate interface are not configured with this feature, the aggregate interface will collect packet statistics only from the member ports that are not configured with this feature.
NAK statistics collection is supported only in the incoming direction of an interface.
Examples
# Enable NAK statistics collection.
<Sysname> system-view
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] nak statistics enable
reset cnp statistics
Use reset cnp statistics to clear CNP statistics.
Syntax
reset cnp statistics interface [ interface-type [ interface-number ] ]
Views
User view
Predefined user roles
network-admin
Parameters
interface-type [ interface-number ]: Specifies an interface by its type and number. If you do not specify an interface, this command clears CNP statistics on all interfaces. If you specify on an interface type, this command clears CNP statistics on all interfaces of that type.
Usage guidelines
To collect CNP statistics on an interface over a period, use this command to first clear the existing CNP statistics before starting a new collection.
Examples
# Clear CNP statistics on HundredGigE 1/0/1.
<Sysname> reset cnp statistics interface hundredgige 1/0/1
Related commands
display cnp statistics
reset nak statistics
Use reset nak statistics to clear NAK packet statistics.
Syntax
reset nak statistics interface [ interface-type [ interface-number ] ]
Views
User view
Predefined user roles
network-admin
Parameters
interface-type [ interface-number ]: Specifies an interface by its type and number. If you do not specify an interface, this command clears NAK packet statistics on all interfaces. If you specify on an interface type, this command clears NAK packet statistics on all interfaces of that type.
Usage guidelines
To collect NAK packet statistics on an interface over a period, use this command to first clear the existing NAK packet statistics before starting a new collection.
Examples
# Clear NAK packet statistics on HundredGigE 1/0/1.
<Sysname> reset nak statistics interface hundredgige 1/0/1
Related commands
display nak statistics
