Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 04-Data buffer commands | 60.60 KB |
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.
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
Default
Manually configured data buffer settings are not applied.
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.
Examples
# Apply manually configured data buffer settings.
<Sysname> system-view
[Sysname] buffer apply
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 ingress [ slot slot-number ] cell service-pool sp-id shared ratio ratio
undo buffer 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.
slot slot-number: Specifies the slot number of the device, which is fixed at 1.
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 commmand applies to the specified slot. If you do not specify the option, this commmand 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 usage threshold
Use buffer usage threshold to set the 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 the slot number of the device, which is fixed at 1.
ratio ratio: Specifies the buffer usage threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when the packet statistics collection mode is queue (configured by using the statistic mode queue command).
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%.
<Sysname> system-view
[Sysname] buffer usage threshold slot 1 ratio 50
Related commands
display buffer usage interface
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 ingress usage threshold service-pool sp-id slot slot-number ratio ratio
undo buffer 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
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 1 to 3.
slot slot-number: Specifies the slot number of the device, which is fixed at 1.
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
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.
Examples
# Enable the Burst feature.
<Sysname> system-view
[Sysname] burst-mode enable
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 ] ]
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.
Examples
# Display brief buffer usage statistics for Ten-GigabitEthernet 1/0/1.
<Sysname> display buffer usage interface ten-gigabitethernet 1/0/1
Interface QueueID Total Used Threshold(%) Violations
--------------------------------------------------------------------------------
HGE1/0/30 0 761856 0 100 0
1 761856 0 100 0
2 761856 0 100 0
3 761856 0 100 0
4 761856 0 100 0
5 761856 0 100 0
6 761856 0 100 0
7 761856 0 100 0
Table 1 Command output
|
Field |
Description |
|
Total |
Data buffer size in bytes allowed for a queue. |
|
Used |
Data buffer size in bytes 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. |