Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 02-IPCC commands | 54.72 KB |
IPCC commands
To use IPCC, you must install a license. If the license expires or is uninstalled, no IPCC functions are available. To resolve this issue, you must install a valid license again. For more information about licenses, see license management in Fundamentals Configuration Guide.
display ipcc statistics
Use display ipcc statistics to display statistics of Congestion Notification Packets (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. If you do not specify this option, the command displays statistics about CNPs that are proactively sent by the device for all interfaces.
Examples
# Display statistics of CNPs that are proactively sent by the device.
<Sysname> display ipcc statistics
Total statistics:
CNP number: 601
RoCEv2 flow entries: 1025
Interface statistics of XGE1/0/1
CNP number: 200
RoCEv2 flow entries: 1
Flow information:
------------------------------------------
DIP SIP DQP
------------------------------------------
192.168.20.27 192.168.10.29 156243
192.168.20.11 192.168.10.11 1111
------------------------------------------
Table 1 Command output
|
Field |
Description |
|
Total statistics |
Total number of CNPs. |
|
CNP number |
Number of CNPs that are proactively sent by the device. |
|
RoCEv2 flow entries |
Number of RoCEv2 flow entries. |
|
Interface Statistics of XGE1/0/1 |
Number of CNPs on the interface. |
|
Flow Information |
Detailed RoCEv2 flow entry information. |
|
DIP |
Destination IP. |
|
SIP |
Source IP. |
|
SQP |
Source QP. |
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
Intelligent Proactive Congestion Control (IPCC) is an improvement of Explicit Congestion Notification (ECN). It intelligently identifies the interface congestion state and proactively sends Congestion Notification Packets (CNPs) to control the RDMA over Converged Ethernet version 2 (RoCEv2) packet sending rate, ensuring low latency and high throughput.
IPCC takes effect only on RoCEv2 packets.
For IPCC to take effect, use the ipcc enable command together with the ipcc queue command.
Examples
# Enable IPCC on interface Ten-GigabitEthernet1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/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
