Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 03-Data buffer commands | 150.91 KB |
buffer packet-drop alarm enable
buffer packet-drop alarm interval
buffer queue guaranteed (system view)
buffer queue guaranteed (interface view)
buffer queue map-to service-pool
buffer queue shared (system view)
buffer queue shared (interface view)
buffer threshold alarm interval
buffer usage threshold headroom
buffer usage threshold headroom queue
buffer usage threshold queue (interface view)
buffer usage threshold queue (system view)
buffer usage threshold service-pool
display buffer usage interface
buffer transient-capture enable
display buffer transient-capture packet-drop
Data buffer commands
Inappropriate data buffer changes can cause system problems. Before manually changing data buffer settings, make sure you understand its impact on your device. As a best practice, use the burst-mode enable command if the system requires large buffer spaces. The burst-mode enable command and the buffer apply command are mutually exclusive. If you have configured the data buffer by using one command, you must execute the undo form of the command before using the other command.
Basic data buffer commands
buffer apply
Use buffer apply to apply manually configured data buffer settings.
Use undo buffer apply to restore the default.
Syntax
buffer apply
undo buffer apply
Views
System view
Predefined user roles
network-admin
Usage guidelines
For data buffer settings to take effect, you must execute this command after configuring data buffer settings.
After applying manually configured data buffer settings, you cannot directly modify the applied settings. To modify them, you must cancel the application, reconfigure data buffer settings, and reapply the new settings.
This command might cause the PFC function to be on longer in effect or to operate incorrectly. For information about PFC configuration commands, see Ethernet interface commands in Layer 2—LAN Switching Command Reference.
Examples
# Apply manually configured data buffer settings.
<Sysname> system-view
[Sysname] buffer apply
buffer packet-drop alarm enable
Use buffer packet-drop alarm enable to enable packet-drop alarms.
Use undo buffer packet-drop alarm enable to disable packet-drop alarms.
Syntax
buffer packet-drop alarm enable
undo buffer packet-drop alarm enable
Default
Packet-drop alarms are disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
The device generates and reports packet-drop alarms to a network management system (such as IMC) for displaying the data buffer usage.
This command does not take effect only on the Headroom buffer.
Examples
# Enable packet-drop alarms.
<Sysname> system-view
[Sysname] buffer packet-drop alarm enable
Related commands
buffer usage threshold queue (interface view)
buffer usage threshold queue (system view)
buffer packet-drop alarm interval
buffer packet-drop alarm interval
Use buffer packet-drop alarm interval to set the interval for sending packet-drop alarms.
Use undo buffer packet-drop alarm interval to restore the default.
Syntax
buffer packet-drop alarm interval interval
undo buffer packet-drop alarm interval
Default
The interval for sending packet-drop alarms is 5 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
interval: Specifies the interval for sending packet-drop alarms, in the range of 0 to 60 seconds. The value of 0 indicates that packet-drop alarms are sent immediately after they are generated.
Usage guidelines
This command takes effect only when packet-drop alarms are enabled.
Examples
# Set the interval for sending packet-drop alarms to 20 seconds.
<Sysname> system-view
[Sysname] buffer packet-drop alarm interval 20
Related commands
buffer packet-drop alarm enable
buffer queue guaranteed (system view)
Use buffer queue guaranteed to set the fixed-area space for a queue.
Use undo buffer queue guaranteed to delete the fixed-area space setting of a queue.
Syntax
buffer egress [ slot slot-number ] cell queue queue-id guaranteed ratio ratio
undo buffer egress [ slot slot-number ] cell queue queue-id guaranteed
Default
The fixed-area ratio for a queue is 13%.
Views
System view
Predefined user roles
network-admin
Parameters
egress: Specifies the egress buffer.
slot slot-number: Specifies an IRF member device by its member ID (slot number). If you do not specify an IRF member device, this command applies to all IRF member devices.
cell: Specifies cell resources.
queue-id: Specifies a queue by its ID in the range of 0 to 7.
ratio ratio: Specifies the fixed-area space ratio, in percentage. The value range for ratio is 1 to 100.
Usage guidelines
By default, all queues have an equal share of the fixed area. You can set the fixed-area ratio for a queue. The other queues equally share the remaining part.
The fixed-area space for a queue cannot be used by other queues. Therefore, it is also called the minimum guaranteed buffer for the queue. The sum of fixed-area space configured for all queues cannot exceed the total fixed-area space. Otherwise, the configuration fails.
Examples
# Configure queue 0 to use 20% fixed-area space of cell resources in the egress buffer.
<Sysname> system-view
[Sysname] buffer egress cell queue 0 guaranteed ratio 20
buffer queue guaranteed (interface view)
Use buffer queue guaranteed to set the fixed-area ratio or size for a queue.
Use undo buffer queue guaranteed to delete the fixed-area ratio or size setting of a queue.
Syntax
buffer egress cell queue queue-id guaranteed ratio ratio
undo buffer egress cell queue queue-id guaranteed
Default
The fixed-area ratio for a queue is 13%.
Views
Interface view
Predefined user roles
network-admin
Parameters
egress: Specifies the egress buffer.
cell: Specifies cell resources.
queue-id: Specifies a queue by its ID in the range of 0 to 7.
ratio ratio: Specifies the fixed-area space ratio, in percentage. The value range for ratio is 0 to 100.
Usage guidelines
By default, all queues have an equal share of the fixed area. You can set the fixed-area ratio for a queue. The other queues equally share the remaining part.
The fixed-area space for a queue cannot be used by other queues. Therefore, it is also called the minimum guaranteed buffer for the queue. The sum of the fixed-area ratios configured for all queues cannot exceed 100%. The queue that causes the sum of the fixed-area ratios to exceed 100% fails to be configured and still uses the default setting.
Examples
# Configure queue 0 on Twenty-FiveGigE 1/0/1 to use 20% fixed-area space of cell resources in the egress buffer.
<Sysname> system-view
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] buffer egress cell queue 0 guaranteed ratio 20
buffer queue map-to service-pool
Use buffer queue map-to service-pool to map a queue to a service pool.
Use undo buffer queue map-to service-pool to restore the default.
Syntax
buffer { egress | ingress } queue queue-id map-to service-pool sp-id
undo buffer { egress | ingress } queue queue-id map-to
Default
All queues are mapped to service pool 0.
Views
Interface view
Predefined user roles
network-admin
Parameters
ingress: Specifies the ingress buffer.
egress: Specifies the egress buffer.
queue-id: Specifies a queue by its ID in the range of 0 to 7.
service-pool sp-id: Specifies a service pool by its ID. The value range for the sp-id argument is 1 to 3.
Usage guidelines
Before configuring this command, use the buffer service-pool shared command to set the maximum shared-area ratio for the service pool.
For the ingress buffer, the queue ID specified represents the 802.1p priority. The actual queue ID mapped to the service pool is determined by the dot1p-lp priority map.
Examples
# Map queue 1 on Twenty-FiveGigE 1/0/1 to service pool 1.
<Sysname> system-view
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] buffer egress queue 1 map-to service-pool 1
Related commands
buffer service-pool shared
buffer queue shared (system view)
Use buffer queue shared to set the maximum shared-area ratio for a queue.
Use undo buffer queue shared to delete the maximum shared-area ratio setting of a queue.
Syntax
buffer egress [ slot slot-number ] cell queue queue-id shared { ratio ratio | size }
undo buffer egress [ slot slot-number ] cell queue queue-id shared
Default
The maximum shared-area ratio for a queue is 20%.
Views
System view
Predefined user roles
network-admin
Parameters
egress: Specifies the egress buffer.
slot slot-number: Specifies an IRF member device by its member ID (slot number). If you do not specify an IRF member device, this command applies to all IRF member devices.
cell: Specifies cell resources.
queue-id: Specifies a queue by its ID in the range of 0 to 7.
ratio ratio: Specifies the maximum shared-area space ratio, in percentage. The value range for ratio is 0 to 100.
size: Specifies the maximum shared-area space, in the number of 100 to 132105 cell resources.
|
|
NOTE: The size argument is supported only in Release 6616 and later. |
Usage guidelines
The buffer egress [ slot slot-number ] cell queue queue-id shared size command must be used together with PFC. If you do not use PFC, do not execute this command. For more information about PFC, see Ethernet interface configuration in Layer 2—LAN Switching Configuration Guide.
By default, all queues have an equal share of the shared area. You can set the shared-area ratio for a queue. The unconfigured queues use the default setting. The shared-area space for each queue is finally determined by the chip based on your configuration and the number of packets to be received and sent.
Examples
# Configure queue 0 to use up to 10% shared-area space of cell resources in the egress buffer.
<Sysname> system-view
[Sysname] buffer egress cell queue 0 shared ratio 10
buffer queue shared (interface view)
Use buffer queue shared to set the maximum shared-area ratio or size for a queue.
Use undo buffer queue shared to delete the maximum shared-area ratio or size setting of a queue.
Syntax
buffer egress cell queue queue-id shared { ratio ratio | size }
undo buffer egress cell queue queue-id shared
Default
The maximum shared-area ratio for a queue is 20%.
Views
Interface view
Predefined user roles
network-admin
Parameters
egress: Specifies the egress buffer.
cell: Specifies cell resources.
queue-id: Specifies a queue by its ID in the range of 0 to 7.
ratio ratio: Specifies the maximum shared-area ratio, in percentage. The value range for ratio is 0 to 100.
size: Specifies the maximum shared-area space, in the number of 100 to 132105 cell resources.
|
|
NOTE: The size argument is supported only in Release 6616 and later. |
Usage guidelines
The buffer egress cell queue queue-id shared size command must be used together with PFC. If you do not use PFC, do not execute this command. For more information about PFC, see Ethernet interface configuration in Layer 2—LAN Switching Configuration Guide.
By default, all queues have an equal share of the shared area. You can set the shared-area ratio for a queue. The unconfigured queues use the default setting. The shared-area space for each queue is finally determined by the chip based on your configuration and the number of packets to be received and sent.
Examples
# Configure queue 0 on Twenty-FiveGigE 1/0/1 to use 20% shared-area space of cell resources in the egress buffer.
<Sysname> system-view
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] buffer egress cell queue 0 shared ratio 20
buffer service-pool shared
Use buffer service-pool shared to set the maximum shared-area ratio or size for a service pool.
Use undo buffer service-pool shared to delete the maximum shared-area ratio or size setting of a service pool.
Syntax
buffer { egress | ingress } [ slot slot-number ] cell service-pool sp-id shared ratio ratio
undo buffer { egress | ingress } [ slot slot-number ] cell service-pool sp-id shared
Default
All of the shared area is reserved for service pool 0.
Views
System view
Predefined user roles
network-admin
Parameters
ingress: Specifies the ingress buffer.
egress: Specifies the egress buffer.
slot slot-number: Specifies an IRF member device by its member ID (slot number).
cell: Specifies cell resources.
service-pool sp-id: Specifies a service pool by its ID. The value range for the sp-id argument is 1 to 3.
ratio ratio: Specifies the maximum shared-area ratio, in percentage. The value range for ratio is 0 to 99.
Usage guidelines
This command takes effect after you executed the buffer apply command.
The sum of the fixed-area ratios configured for all queues cannot exceed 100%. The queue that causes the sum of the fixed-area ratios to exceed 100% fails to be configured and still uses the default setting.
If you specify the slot slot-number option, this command applies to the specified slot. If you do not specify the option, this command applies to all slots. The configuration for a slot have higher priority over the configuration for all slots.
Examples
# Configure service pool 1 to use up to 50% shared-area space of cell resources in the egress buffer.
<Sysname> system-view
[Sysname] buffer egress cell service-pool 1 shared ratio 50
Related commands
buffer apply
buffer threshold alarm enable
Use buffer threshold alarm enable to enable threshold-crossing alarms.
Use undo buffer threshold alarm enable to disable threshold-crossing alarms.
Syntax
buffer threshold alarm { egress | headroom | ingress } enable
undo buffer threshold alarm { egress | headroom | ingress } enable
Default
Threshold-crossing alarms are disabled.
Views
System view
Predefined user roles
network-admin
Parameters
ingress: Specifies the ingress buffer.
headroom: Specifies the Headroom buffer.
egress: Specifies the egress buffer.
Usage guidelines
The device generates and reports threshold-crossing alarms to a network management system (such as IMC) for displaying the data buffer usage.
Examples
# Enable threshold-crossing alarms.
<Sysname> system-view
[Sysname] buffer threshold alarm ingress enable
Related commands
buffer usage threshold headroom
buffer usage threshold headroom queue
buffer usage threshold queue (interface view)
buffer usage threshold queue (system view)
buffer threshold alarm interval
Use buffer threshold alarm interval to set the interval for sending threshold-crossing alarms.
Use undo buffer threshold alarm interval to restore the default.
Syntax
buffer threshold alarm { egress | headroom | ingress } interval interval
undo buffer threshold alarm { egress | headroom | ingress } interval
Default
The interval for sending threshold-crossing alarms is 5 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
ingress: Specifies the ingress buffer.
headroom: Specifies the Headroom buffer.
egress: Specifies the egress buffer.
interval: Specifies the interval for sending threshold-crossing alarms, in the range of 0 to 60 seconds. 0 indicates that threshold-crossing alarms are sent immediately after they are generated.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled.
Examples
# Set the interval for sending threshold-crossing alarms to 20 seconds.
<Sysname> system-view
[Sysname] buffer threshold alarm ingress interval 20
Related commands
buffer threshold alarm enable
buffer usage threshold headroom
buffer usage threshold headroom queue
buffer usage threshold queue (interface view)
buffer usage threshold queue (system view)
buffer total-shared
Use buffer total-shared to set the total shared-area ratio.
Use undo buffer total-shared to delete the total shared-area ratio setting.
Syntax
buffer egress [ slot slot-number ] cell total-shared ratio ratio
undo buffer egress [ slot slot-number ] cell total-shared
Default
The total shared-area ratio is 100%.
Views
System view
Predefined user roles
network-admin
Parameters
egress: Specifies the egress buffer.
slot slot-number: Specifies an IRF member device by its member ID (slot number). If you do not specify an IRF member device, this command applies to all IRF member devices.
cell: Specifies cell resources.
ratio ratio: Specifies the ratio of the shared area, in percentage. The value range for ratio is 0 to 100.
Usage guidelines
After you set the shared-area ratio, the remaining buffer space is automatically assigned to the fixed area.
Examples
# Configure the shared area to use 50% space of cell resources in the egress buffer.
<Sysname> system-view
[Sysname] buffer egress cell total-shared ratio 50
buffer usage threshold
Use buffer usage threshold to set a per-interface buffer usage threshold.
Use undo buffer usage threshold to restore the default.
Syntax
buffer usage threshold slot slot-number ratio ratio
undo buffer usage threshold slot slot-number
Default
The per-interface buffer usage threshold is 100%.
Views
System view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies an IRF member device by its member ID.
ratio ratio: Specifies the buffer usage threshold in percentage, in the range of 1 to 100.
Usage guidelines
After you configure this command, the switch automatically records buffer usage for each interface. When a queue on an interface uses more buffer space than the set threshold, the system counts one threshold violation for the queue.
To display the buffer usage statistics for interfaces, use the display buffer usage interface command.
Examples
# Set the per-interface buffer usage threshold to 50% for IRF member device 1.
<Sysname> system-view
[Sysname] buffer usage threshold slot 1 ratio 50
Related commands
display buffer usage interface
buffer usage threshold headroom
Use buffer usage threshold headroom to set the global per-queue alarm threshold for the Headroom buffer.
Use undo buffer usage threshold headroom to restore the default.
Syntax
buffer usage threshold headroom slot slot-number ratio ratio
undo buffer usage threshold headroom slot slot-number ratio
Default
The global per-queue alarm threshold for the Headroom buffer is 100%.
Views
System view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies an IRF member device by its member ID (slot number).
ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the global alarm threshold for the Headroom buffer, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
Examples
# Set the global per-queue alarm threshold to 50% for slot 1.
<Sysname> system-view
[Sysname] buffer usage threshold headroom slot 1 ratio 50
Related commands
buffer threshold alarm enable
buffer usage threshold headroom queue
Use buffer usage threshold headroom queue to set the Headroom buffer alarm threshold for a queue on an interface.
Use undo buffer usage threshold headroom queue to restore the default.
Syntax
buffer usage threshold headroom queue queue-id ratio ratio
undo buffer usage threshold headroom queue queue-id ratio
Default
The global per-queue alarm threshold for the Headroom buffer is used.
Views
Interface view
Predefined user roles
network-admin
Parameters
queue-id: Specifies a queue by its ID in the range of 0 to 7.
ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the alarm threshold, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
Examples
# Set the Headroom buffer alarm threshold to 50% for queue 1 on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] interface twenty-fivegige 1/0/1
[Sysname–Twenty-FiveGigE1/0/1] buffer usage threshold headroom queue 1 ratio 50
Related commands
buffer threshold alarm enable
buffer usage threshold queue (interface view)
Use buffer usage threshold queue to set the ingress or egress buffer alarm threshold for a queue on an interface.
Use undo buffer usage threshold queue to restore the default.
Syntax
buffer { egress | ingress } usage threshold queue queue-id ratio ratio
undo buffer { egress | ingress } usage threshold queue queue-id ratio
Default
The global per-queue alarm threshold for the ingress or egress buffer is used.
Views
Interface view
Predefined user roles
network-admin
Parameters
ingress: Specifies the ingress buffer.
egress: Specifies the egress buffer.
queue-id: Specifies a queue by its ID in the range of 0 to 7.
ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the alarm threshold for the ingress or egress buffer, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
Examples
# Set the ingress buffer alarm threshold to 50% for queue 1 on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] interface twenty-fivegige 1/0/1
[Sysname–Twenty-FiveGigE1/0/1] buffer ingress usage threshold queue 1 ratio 50
Related commands
buffer threshold alarm enable
buffer usage threshold queue (system view)
Use buffer usage threshold queue to set the global ingress or egress buffer alarm threshold for a queue.
Use undo buffer usage threshold queue to restore the default.
Syntax
buffer { egress | ingress } usage threshold slot slot-number queue queue-id ratio ratio
undo buffer { egress | ingress } usage threshold slot slot-number queue queue-id ratio
Default
The global ingress or egress buffer alarm threshold for a queue is 100%.
Views
System view
Predefined user roles
network-admin
Parameters
ingress: Specifies the ingress buffer.
egress: Specifies the egress buffer.
slot slot-number: Specifies an IRF member device by its member ID (slot number).
queue-id: Specifies a queue by its ID in the range of 0 to 7.
ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the global ingress or egress alarm threshold, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
Examples
# Set the global ingress alarm threshold to 50% for queue 1 in slot 1.
<Sysname> system-view
[Sysname] buffer ingress usage threshold slot 1 queue 1 ratio 50
Related commands
buffer threshold alarm enable
buffer usage threshold service-pool
Use buffer usage threshold service-pool to set the alarm threshold for a service pool.
Use undo buffer usage threshold service-pool to restore the default.
Syntax
buffer { egress | ingress } usage threshold service-pool sp-id slot slot-number ratio ratio
undo buffer { egress | ingress } usage threshold service-pool sp-id slot slot-number ratio
Default
The alarm threshold for a service pool is 100%.
Views
System view
Predefined user roles
network-admin
Parameters
egress: Specifies the egress buffer.
ingress: Specifies the ingress buffer.
service-pool sp-id: Specifies a service pool by its ID. The value range for the sp-id argument is 0 to 3.
slot slot-number: Specifies an IRF member device by its member ID (slot number).
ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled. When the usage of a service pool exceeds the alarm threshold, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
Examples
# Set the alarm threshold to 50% for a service pool in slot 1.
<Sysname> system-view
[Sysname] buffer egress usage threshold service-pool 0 slot 1 ratio 50
Related commands
buffer queue shared
buffer service-pool shared
buffer threshold alarm enable
buffer threshold alarm interval
burst-mode enable
Use burst-mode enable to enable the Burst feature.
Use undo burst-mode enable to disable the Burst feature.
Syntax
burst-mode enable
undo burst-mode enable
Default
The Burst feature is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
The Burst feature is especially useful for reducing packet losses under the following circumstances:
· Broadcast or multicast traffic is intensive, resulting in bursts of traffic.
· Traffic enters a device from a high-speed interface and goes out of a low-speed interface.
· Traffic enters a device from multiple same-rate interfaces and goes out of an interface with the same rate.
The default data buffer settings will be changed after the Burst feature is enabled. You can display the data buffer settings by using the display buffer command.
Disabling the Burst feature after enabling it might cause the PFC function to be on longer in effect or to operate incorrectly. For information about PFC configuration commands, see Ethernet interface commands in Layer 2—LAN Switching Command Reference.
Examples
# Enable the Burst feature.
<Sysname> system-view
[Sysname] burst-mode enable
display buffer
Use display buffer to display buffer size settings.
Syntax
display buffer [ slot slot-number ] [ queue [ queue-id ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID (slot number). If you do not specify an IRF member device, this command displays buffer size settings for all IRF member devices.
queue queue-id: Specifies a queue by its number in the range of 0 to 7. If you specify a queue, this command displays the fixed-area ratio and shared-area ratio for the specified queue. If you specify the queue keyword without the queue-id argument, this command displays the fixed-area ratio and shared-area ratio for each queue. If you do not specify the queue keyword, this command displays the total shared-area ratio.
Examples
# Display buffer size settings.
<Sysname> display buffer
Slot Type Eg(Total-shared)
1 cell 100
Eg: Size of the sending buffer
Total-shared: Size of the shared buffer for all ports
Unit: Ratio
# Display the fixed-area ratio and shared-area ratio for the queues.
<Sysname> display buffer queue
Slot Queue Type Eg(Guaranteed , Shared)
1 0-7 cell 13 , 20
Eg: Size of the sending buffer
Guaranteed: Size of the minimum guaranteed buffer per queue
Shared: Size of the maximum shared buffer per queue
Unit: Ratio
Table 1 Command output
|
Field |
Description |
|
Type |
Resource type. |
|
Queue |
Queue ID in the range of 0 to 7. |
|
Eg |
Egress buffer. |
|
(Total-shared) |
Total-shared indicates the total shared-area ratio. |
|
(Guaranteed , Shared) |
· Guaranteed indicates the fixed-area ratio of a queue. · Shared indicates the shared-area ratio of a queue. |
display buffer usage
Use display buffer usage to display buffer usage.
Syntax
display buffer usage [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID (slot number). If you do not specify an IRF member device, this command displays buffer usage for all IRF member devices.
Examples
# Display buffer usage.
<Sysname> display buffer usage
Ingress total-shared cell buffer usage on slot 2 :
XPE 0
Total: 32768 KB
Used: 0 KB
Free: 32768 KB
Global_headroom: 0 KB
SP0_headroom_used: 0 KB
SP0_Headroom_peak: 0 KB
SP0_buffer_total: 32677 KB
SP0_buffer_used: 0 KB
SP0_buffer_peak: 0 KB
SP1_headroom_used: 0 KB
SP1_Headroom_peak: 0 KB
SP1_buffer_total: 0 KB
SP1_buffer_used: 0 KB
SP1_buffer_peak: 0 KB
SP2_headroom_used: 0 KB
SP2_Headroom_peak: 0 KB
SP2_buffer_total: 0 KB
SP2_buffer_used: 0 KB
SP2_buffer_peak: 0 KB
SP3_headroom_used: 0 KB
SP3_Headroom_peak: 0 KB
SP3_buffer_total: 0 KB
SP3_buffer_used: 0 KB
SP3_buffer_peak: 0 KB
Egress total-shared cell buffer usage on slot 2 :
XPE 0
Total: 32768 KB
Used: 0 KB
Free: 32768 KB
SP0_buffer_total: 32677 KB
SP0_buffer_used: 0 KB
SP0_buffer_peak: 0 KB
SP1_buffer_total: 0 KB
SP1_buffer_used: 0 KB
SP1_buffer_peak: 0 KB
SP2_buffer_total: 0 KB
SP2_buffer_used: 0 KB
SP2_buffer_peak: 0 KB
SP3_buffer_total: 0 KB
SP3_buffer_used: 0 KB
SP3_buffer_peak: 0 KB
5sec 1min 5min
------------------------------------------------------------------
WGE2/0/1 XPE 0 0% 0% 0%
WGE2/0/2 XPE 0 0% 0% 0%
WGE2/0/3 XPE 0 0% 0% 0%
WGE2/0/4 XPE 0 0% 0% 0%
WGE2/0/5 XPE 0 0% 0% 0%
…
Table 2 Command output
|
Field |
Description |
|
Egress total-shared cell buffer usage on slot |
Usage of cell resources in the shared area on an IRF member device. |
|
Unit |
Chip number. |
|
XPE |
Type of the data buffer. |
|
Total |
Total size of the data buffer. |
|
Used |
Size of used data buffer. |
|
Free |
Size of free data buffer. |
|
Global_headroom |
Total headroom size. |
|
SP |
Service pool. |
|
headroom_used |
Headroom area usage in KB for the ingress buffer. |
|
Headroom_peak |
Peak used Headroom area in KB during the time between two executions of the display buffer usage command. |
|
buffer_total |
Total buffer size in KB. |
|
buffer_used |
Used buffer size in KB. |
|
buffer_peak |
Peak used buffer size in KB during the time between two executions of the display buffer usage command. |
|
5sec |
Percentage of the buffer that the port uses for the last 5 seconds. |
|
1min |
Percentage of the buffer that the port uses for the last 1 minute. |
|
5min |
Percentage of the buffer that the port uses for the last 5 minutes. |
display buffer usage interface
Use display buffer usage interface to display buffer usage statistics for interfaces.
Syntax
display buffer usage interface [ interface-type [ interface-number ] ] [ verbose ]
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 the interface-type argument, this command displays buffer usage statistics for all Ethernet interfaces. If you specify the interface-type argument without the interface-number argument, this command displays buffer usage statistics for all Ethernet interfaces of the specified type.
verbose: Displays detailed buffer usage statistics. If you do not specify this keyword, the command displays brief buffer usage statistics.
Examples
# Display brief buffer usage statistics for Twenty-FiveGigE 1/0/1.
<Sysname> display buffer usage interface twenty-fivegige 1/0/1
Interface QueueID Total Used Threshold(%) Violations
--------------------------------------------------------------------------------
WGE1/0/1 0 26214 0 70 0
1 26214 0 70 0
2 26214 0 70 0
3 26214 0 70 0
4 26214 0 70 0
5 26214 0 70 0
6 26214 0 70 0
7 26214 0 70 0
Table 3 Command output
|
Field |
Description |
|
Total |
Data buffer size (in the number of cell resources) allowed for a queue. |
|
Used |
Data buffer size (in the number of cell resources) that has been used by a queue. |
|
Threshold(%) |
Buffer usage threshold for a queue. The threshold value is the same as the per-interface threshold value. |
|
Violations |
Number of threshold violations for a queue. The value of this field is reset upon a switch reboot. |
# Display detailed buffer usage statistics for Twenty-FiveGigE 1/0/1.
[Sysname] display buffer usage interface twenty-fivegige 1/0/1 verbose
Twenty-FiveGigE1/0/1
Ingress:
QueueID: 0
Total: 131078 Used: 0 Threshold(%): 100
Violations: 0 Shared: 0 Headroom: 0
XoffThres: 131072 IsDynamic: 0
Used(%): 0 Free: 131072 UsedPeak: 0
HeadroomUsed(%): 0 HeadroomFree: 0 HeadroomPeak: 0
QueueID: 1
Total: 131078 Used: 0 Threshold(%): 100
Violations: 0 Shared: 0 Headroom: 0
XoffThres: 131072 IsDynamic: 0
Used(%): 0 Free: 131072 UsedPeak: 0
HeadroomUsed(%): 0 HeadroomFree: 0 HeadroomPeak: 0
QueueID: 2
Total: 131078 Used: 0 Threshold(%): 100
Violations: 0 Shared: 0 Headroom: 0
XoffThres: 131072 IsDynamic: 0
Used(%): 0 Free: 131072 UsedPeak: 0
HeadroomUsed(%): 0 HeadroomFree: 0 HeadroomPeak: 0
QueueID: 3
Total: 131078 Used: 0 Threshold(%): 100
Violations: 0 Shared: 0 Headroom: 0
XoffThres: 131072 IsDynamic: 0
Used(%): 0 Free: 131072 UsedPeak: 0
HeadroomUsed(%): 0 HeadroomFree: 0 HeadroomPeak: 0
QueueID: 4
Total: 131078 Used: 0 Threshold(%): 100
Violations: 0 Shared: 0 Headroom: 0
XoffThres: 131072 IsDynamic: 0
Used(%): 0 Free: 131072 UsedPeak: 0
HeadroomUsed(%): 0 HeadroomFree: 0 HeadroomPeak: 0
QueueID: 5
Total: 131078 Used: 0 Threshold(%): 100
Violations: 0 Shared: 0 Headroom: 0
XoffThres: 131072 IsDynamic: 0
Used(%): 0 Free: 131072 UsedPeak: 0
HeadroomUsed(%): 0 HeadroomFree: 0 HeadroomPeak: 0
QueueID: 6
Total: 131078 Used: 0 Threshold(%): 100
Violations: 0 Shared: 0 Headroom: 0
XoffThres: 131072 IsDynamic: 0
Used(%): 0 Free: 131072 UsedPeak: 0
HeadroomUsed(%): 0 HeadroomFree: 0 HeadroomPeak: 0
QueueID: 7
Total: 131078 Used: 0 Threshold(%): 100
Violations: 0 Shared: 0 Headroom: 0
XoffThres: 131072 IsDynamic: 0
Used(%): 0 Free: 131072 UsedPeak: 0
HeadroomUsed(%): 0 HeadroomFree: 0 HeadroomPeak: 0
Egress:
QueueID: 0
Total: 26214 Used: 0 Threshold(%): 100
Violations: 0 TailDropThres: 26214 IsDynamic: 1
DeadlockCount: 0 DeadlockRecover: 0
Used(%): 0 Free: 26214 UsedPeak: 0
QueueID: 1
Total: 26214 Used: 0 Threshold(%): 100
Violations: 0 TailDropThres: 26214 IsDynamic: 1
DeadlockCount: 0 DeadlockRecover: 0
Used(%): 0 Free: 26214 UsedPeak: 0
QueueID: 2
Total: 26214 Used: 0 Threshold(%): 100
Violations: 0 TailDropThres: 26214 IsDynamic: 1
DeadlockCount: 0 DeadlockRecover: 0
Used(%): 0 Free: 26214 UsedPeak: 0
QueueID: 3
Total: 26214 Used: 0 Threshold(%): 100
Violations: 0 TailDropThres: 26214 IsDynamic: 1
DeadlockCount: 0 DeadlockRecover: 0
Used(%): 0 Free: 26214 UsedPeak: 0
QueueID: 4
Total: 26214 Used: 0 Threshold(%): 100
Violations: 0 TailDropThres: 26214 IsDynamic: 1
DeadlockCount: 0 DeadlockRecover: 0
Used(%): 0 Free: 26214 UsedPeak: 0
QueueID: 5
Total: 26214 Used: 0 Threshold(%): 100
Violations: 0 TailDropThres: 26214 IsDynamic: 1
DeadlockCount: 0 DeadlockRecover: 0
Used(%): 0 Free: 26214 UsedPeak: 0
QueueID: 6
Total: 26214 Used: 0 Threshold(%): 100
Violations: 0 TailDropThres: 26214 IsDynamic: 1
DeadlockCount: 0 DeadlockRecover: 0
Used(%): 0 Free: 26214 UsedPeak: 0
QueueID: 7
Total: 26214 Used: 0 Threshold(%): 100
Violations: 0 TailDropThres: 26214 IsDynamic: 1
DeadlockCount: 0 DeadlockRecover: 0
Used(%): 0 Free: 26214 UsedPeak: 0
Table 4 Command output
|
Field |
Description |
|
Ingress |
Usage statistics for the ingress buffer. |
|
Egress |
Usage statistics for the egress buffer. |
|
Total |
Data buffer size allowed for a queue, in cell resources. |
|
Used |
Data buffer size that has been used by a queue, in cell resources. |
|
Threshold(%) |
Buffer usage threshold for a queue. The threshold value is the same as the per-interface threshold value. |
|
Violations |
Number of threshold violations for a queue. The value of this field is reset upon a switch reboot. |
|
Shared |
Number of cell resources in the shared area used by a queue. |
|
Headroom |
Number of cell resources in the Headroom area used by a queue. When a queue on an interface enabled with PFC enters PFC XOFF state, the interface sends XOFF frames to notify the peer interface to stop sending packets to that queue. Packets sent by the peer interface before it receives XOFF frames are stored in the Headroom area. |
|
XoffThres |
Back pressure frame triggering threshold in number of cell resources. For commands to configure back pressure frame triggering thresholds, see Ethernet interface commands in Layer 2—LAN Switching Command Reference. |
|
TailDropThres |
Tail drop threshold, in the number of cell resources calculated according to the ratio value set in the buffer queue shared command. |
|
IsDynamic |
For the inbound direction, this field can be one of the following values: · 0—Indicates a static back pressure frame triggering threshold. · 1—Indicates a dynamic back pressure frame triggering threshold. For the outbound direction, this field can only be 1, which indicates a dynamic tail drop threshold. |
|
Used(%) |
Buffer usage in percentage. |
|
Free |
Free buffer in cell resources. |
|
UsedPeak |
Peak used buffer in cell resources during the time between two executions of the display buffer usage interface command. |
|
HeadroomUsed(%) |
Headroom area usage in percentage for the ingress buffer. |
|
HeadroomFree |
Free Headroom area in number of cell resources for the ingress buffer. |
|
HeadroomPeak |
Peak used Headroom area in number of cell resources during the time between two executions of the display buffer usage interface command. |
|
DeadlockCount |
Number of times the device entered the PFC deadlock state in the egress buffer. |
|
DeadlockRecover |
Number of times the device released the PFC deadlock state in the egress buffer. |
|
|
NOTE: For more information about back pressure frame triggering thresholds and PFC deadlock, see Ethernet interface configuration in Layer 2—LAN Switching Configuration Guide. |
TCB commands
buffer transient-capture enable
Use buffer transient-capture enable to enable and configure TCB.
Use undo buffer transient-capture enable to disable TCB.
Syntax
System view:
buffer transient-capture global [ slot slot-number ] egress enable [ no-local-analysis ] [ acl { ipv4-acl-number | name ipv4-acl-name } ] [ start-threshold start-threshold-value stop-threshold stop-threshold-value ] [ frozen-number frozen-number frozen-timer timer-value ] [ pre-sample-rate pre-sample-rate post-sample-rate post-sample-rate ] [ poll-frequency frequency-value ]
undo buffer transient-capture global [ slot slot-number ] enable
|
|
NOTE: This command is supported only in Release 6616 and later. |
Interface view:
buffer transient-capture { egress [ queue queue-id ] | ingress } enable [ no-local-analysis ] [ acl { ipv4-acl-number | name ipv4-acl-name } ] [ start-threshold start-threshold-value stop-threshold stop-threshold-value ] [ frozen-number frozen-number frozen-timer timer-value ] [ pre-sample-rate pre-sample-rate post-sample-rate post-sample-rate ] [ poll-frequency frequency-value ]
undo buffer transient-capture enable
Default
TCB is disabled.
Views
System view
Interface view
Predefined user roles
network-admin
Parameters
global: Configures TCB globally. This keyword is supported only in system view.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command configures TCB for the master device.
egress: Specifies the egress buffer.
queue-id: Specifies a queue by its ID in the range of 0 to 7. If you do not specify a queue, this command enables TCB for all queues. This argument is supported only in interface view.
ingress: Specifies the ingress buffer. This keyword is supported only in interface view.
no-local-analysis: Reports raw packet data and packet drop reason without performing local analysis. If you do not specify this parameter, local analysis is performed.
acl: Specifies an ACL. If you do not specify an ACL, this command enables TCB for all traffic.
· ipv4-acl-number: Specifies an advanced IPv4 ACL by its number in the range of 3000 to 3999.
· name ipv4-acl-name: Specifies an advanced IPv4 ACL by its name, a case-insensitive string of 1 to 63 characters. The ACL name must start with an English letter.
start-threshold start-threshold-value: Specifies the queue length in bytes above which packet capturing will be started. The value range for the start-threshold-value argument is 1 to 67108352. The default is 2500. The value for the start-threshold-value argument must be greater than the value for the stop-threshold-value argument.
stop-threshold stop-threshold-value: Specifies the queue length in bytes below which packet capturing will be stopped. The value range for the stop-threshold-value argument is 1 to 67108352. The default is 1500. The value for the stop-threshold-value argument must be greater than the value for the start-threshold-value argument.
frozen-number frozen-number: Specifies the number of packets to be captured before the TCB state machine moves to the frozen state. The value range for the frozen-number argument is 3 to 1024. The default is 256.
frozen-timer timer-value: Specifies the capture timer for moving the TCB state machine to the frozen state. The value range for the timer-value argument is 1 to 500. The default is 500.
pre-sample-rate pre-sample-rate: Specifies the number of packets captured in the pre-trigger state. The value range for the pre-sample-rate argument is 1 to 16. The default is 16. If the value range is 1 to 16, the specified number of packets are sampled out of 16 packets. If you specify 16, all packets are captured.
post-sample-rate post-sample-rate: Specifies the number of packets captured in the post-trigger state. The value range for the post-sample-rate argument is 1 to 16. The default is 16. If the value range is 1 to 16, the specified number of packets are sampled out of 16 packets. If you specify 16, all packets are captured.
poll-frequency frequency-value: Specifies the number of times that data is reported per minute. The value range for the frequency-value argument is 1 to 600. The default is 20.
Usage guidelines
The TCB feature monitors packet drop events on queues. When a packet is dropped on a queue, the system collects the drop time, drop reason, packet metadata, and other information and reports them to an NMS through gRPC.
You can configure TCB in system view or interface view, but not in both views at the same time. For example, if you have configured TCB in system view, to configure TCB in interface view, you must first delete the TCB configuration in system view.
The TCB configuration in system view takes effect on all TCB-capable interfaces. The TCB configuration in interface view takes effect only on the specified interface.
In interface view, only one interface on the device can be configured with TCB.
If TCB is configured on a VTEP in a VXLAN network to monitor packets to site networks, it obtains outer header information instead of inner header information of VXLAN packets as the packet characteristics.
Examples
Configure TCB for slot 1.
<Sysname> system-view
[Sysname] buffer transient-capture global slot 1 egress enable no-local-analysis acl 3000 start-threshold 10000 stop-threshold 5000 frozen-number 1000 frozen-timer 500 pre-sample-rate 10 post-sample-rate 10 poll-frequency 30
# Configure TCB on Twenty-FiveGigE 1/0/1.
<Sysname> system-view
[Sysname] interface twenty-fivegige 1/0/1
[Sysname-Twenty-FiveGigE1/0/1] buffer transient-capture egress enable no-local-analysis acl 3000 start-threshold 10000 stop-threshold 5000 frozen-number 1000 frozen-timer 500 pre-sample-rate 10 post-sample-rate 10 poll-frequency 30
display buffer transient-capture packet-drop
Use display buffer transient-capture packet-drop to display packet drop information.
|
|
IMPORTANT: This command is supported only in Release 6616 and later. |
Syntax
display buffer transient-capture packet-drop slot slot-number { ethernet | ipv4 | ipv6 }
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ethernet: Displays packet drop information for Ethernet frames.
ipv4: Displays packet drop information for IPv4 packets.
ipv6: Displays packet drop information for IPv6 packets.
slot slot-number: Specifies an IRF member device by its member ID (slot number).
Usage guidelines
This command lists packet drop events in chronological order, including the number of packets dropped, drop time, dropped packet characteristics, queue and interface, and drop reason.
Examples
# Display IPv4 packet drop information for slot 1.
<Sysname> display buffer transient-capture packet-drop slot 1 ipv4
TCB STATUS: EgressPort WGE1/0/1
--------------------------------------------------------------------------------
No. Time SMAC DMAC VLAN SIP DIP SPort DPort Queue IfName Reason
--------------------------------------------------------------------------------
Total Drop Packets in Ring Buffer of XPE 0: 10
0 8a44800 0010-9400-0005 0010-9400-0002 100 192.168.1.2 192.168.0.1 0 0 0 WGE1/0/1 2
Table 5 Command output
|
Field |
Description |
|
Time |
Time when packets were dropped, in the form of UNIX timestamps (time since 00:00:00 01/01/1970). |
|
Reason |
Packet drop reason: · 1—Dropped when enqueued. · 2—Dropped when dequeued. · 3—Dropped by WRED. · 4—Dropped due to insufficient cell resources. |
|
Total packets dropped on XPE0 |
Total number of packets dropped on XPE0. XPE is a data buffer type. |
