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

mdc-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

Data buffer commands -- buffer queue guaranteed

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

Distributed devices in standalone mode:Centralized devices:Centralized IRF devices:

buffer { ingress | egress } [ slot slot-number ] { cell | packet } queue queue-id guaranteed { ratio ratio | size }

undo buffer { ingress | egress } [ slot slot-number ] { cell | packet } queue queue-id guaranteed

Distributed devices in IRF mode:

buffer { ingress | egress } [ chassis chassis-number slot slot-number ] { cell | packet } queue queue-id guaranteed { ratio ratio | size }

undo buffer { ingress | egress } [ chassis chassis-number slot slot-number ] { cell | packet } queue queue-id guaranteed

Default

The fixed-area ratio for a queue is 13%.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

ingress: Specifies the ingress buffer.

egress: Specifies the egress buffer.

slot slot-number: Specifies the current device. The slot-number argument is fixed to 1. (Centralized devices.)

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command applies to all cards. (Distributed devices in standalone mode.)

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. (Centralized IRF devices.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option, the command applies to all cards of the IRF fabric. (Distributed devices in IRF mode.)

cell: Specifies cell resources.

packet: Specifies packet 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.

size: Specifies the fixed-area space, in bytes. The value range for this argument varies by device model.

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

Data buffer commands -- buffer queue shared

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

Distributed devices in standalone mode:Centralized devices:Centralized IRF devices:

buffer { ingress | egress } [ slot slot-number ] { cell | packet } queue queue-id shared { ratio ratio | size }

undo buffer { ingress | egress } [ slot slot-number ] { cell | packet } queue queue-id shared

Distributed devices in IRF mode:

buffer { ingress | egress } [ chassis chassis-number slot slot-number ] { cell | packet } queue queue-id shared { ratio ratio | size }

undo buffer { ingress | egress } [ chassis chassis-number slot slot-number ] { cell | packet } queue queue-id shared

Default

The maximum shared-area ratio for a queue is 20%.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

ingress: Specifies the ingress buffer.

egress: Specifies the egress buffer.

slot slot-number: Specifies the current device. The slot-number argument is fixed to 1. (Centralized devices.)

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command applies to all cards. (Distributed devices in standalone mode.)

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. (Centralized IRF devices.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option, the command applies to all cards of the IRF fabric. (Distributed devices in IRF mode.)

cell: Specifies cell resources.

packet: Specifies packet resources.

queue-id: Specifies a queue by its ID in the range of 0 to 7. If you do not specify a queue, this command sets the maximum shared-area space for each port.

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 bytes. The value range for this argument varies by device model.

Usage guidelines

By default, all queues have an equal share of the shared area. You can set the shared-area space 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

Data buffer commands -- 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

Distributed devices in standalone mode:Centralized devices:Centralized IRF devices:

buffer { ingress | egress } [ slot slot-number ] { cell | packet } total-shared { ratio ratio | size }

undo buffer { ingress | egress } [ slot slot-number ] { cell | packet } total-shared

Distributed devices in IRF mode:

buffer { ingress | egress } [ chassis chassis-number slot slot-number ] { cell | packet } total-shared { ratio ratio | size }

undo buffer { ingress | egress } [ chassis chassis-number slot slot-number ] { cell | packet } total-shared

Default

The total shared-area ratio is 100%.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

ingress: Specifies the ingress buffer.

egress: Specifies the egress buffer.

slot slot-number: Specifies the current device. The slot-number argument is fixed to 1. (Centralized devices.)

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command applies to all cards. (Distributed devices in standalone mode.)

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. (Centralized IRF devices.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option, the command applies to all cards of the IRF fabric. (Distributed devices in IRF mode.)

cell: Specifies cell resources.

packet: Specifies packet resources.

ratio ratio: Specifies the ratio of the shared area, in percentage. The value range for ratio is 0 to 100.

size: Specifies the size of the shared area, in bytes. The value range for this argument varies by device model.

Usage guidelines

After you set the shared-area space, 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

Data buffer commands -- 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

Distributed devices in standalone mode:Centralized IRF devices:

buffer usage threshold slot slot-number ratio ratio

undo buffer usage threshold slot slot-number

Distributed devices in IRF mode:

buffer usage threshold chassis chassis-number slot slot-number ratio ratio

undo buffer usage threshold chassis chassis-number slot slot-number

Default

The per-interface buffer usage threshold is 100%.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

slot slot-number: Specifies a card by its slot number. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. (Centralized IRF devices.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (Distributed devices in IRF mode.)

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

# (Centralized IRF devices.) 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

# (Distributed devices in standalone mode.) Set the per-interface buffer usage threshold to 50% for card 3.

<Sysname> system-view

[Sysname] buffer usage threshold slot 3 ratio 50

# (Distributed devices in IRF mode.) Set the per-interface buffer usage threshold to 50% for card 3 on IRF member device 2.

<Sysname> system-view

[Sysname] buffer usage threshold chassis 2 slot 3 ratio 50

Related commands

display buffer usage interface

Data buffer commands -- 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

mdc-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

Data buffer commands -- display buffer

Use display buffer to display buffer size settings.

Syntax

Distributed devices in standalone mode:Centralized devices:Centralized IRF devices:

display buffer [ slot slot-number ] [ queue [ queue-id ] ]

Distributed devices in IRF mode:

display buffer [ chassis chassis-number slot slot-number ] [ queue [ queue-id ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

slot slot-number: This option does not take effect. The value for the slot-number argument can only be 1. (Centralized devices.)

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays buffer size settings for all cards. (Distributed devices in standalone mode.)

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. (Centralized IRF devices.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option, the command displays buffer size settings for all cards of the IRF fabric. (Distributed devices in IRF mode.)

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

# (Centralized devices.) (Distributed devices in standalone mode.) (Centralized IRF devices.) Display buffer size settings.

<Sysname> display buffer

Slot Type Eg(Total-shared , Shared)

1 packet 95 , 100

1 cell 55 , 33

Eg: Size of the sending buffer

Total-shared: Size of the shared buffer for all ports

Shared: Size of the maximum shared buffer per port

Unit: Ratio

# (Centralized devices.) (Distributed devices in standalone mode.) (Centralized IRF devices.) 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 packet 11 , 60

1 0-7 cell 12 , 100

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

# (Distributed devices in IRF mode.) Display buffer size settings for slot 2 in chassis 1.

<Sysname> display buffer chassis 1 slot 2

Slot Type In(Total-shared , Shared) Eg(Total-shared , Shared)

1/2 packet 24 , 2 36 , 2

1/2 cell 50 , 25 -- , --

In: Size of the receiving buffer

Eg: Size of the sending buffer

Total-shared: Size of the shared buffer for all ports

Shared: Size of the maximum shared buffer per port

Unit: Ratio

# (Distributed devices in IRF mode.) Display the fixed-area ratio and shared-area ratio for the queues for slot 2 in chassis 1.

<Sysname> display buffer chassis 1 slot 2 queue

Slot Queue Type In(Guaranteed , Shared) Eg(Guaranteed , Shared)

1/2 0-7 packet 256 , 128 256 , 128

1/2 0-1,3-4,6-7 cell 256 , 128 256 , 128

1/2 2,5 cell 512 , 128 -- , --

In: Size of the receiving buffer

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: Byte

Table 1 Command output

Field | Description
Type | Resource type: packet or cell.
Queue | Queue ID in the range of 0 to 7.
In | Ingress buffer.
Eg | Egress buffer.
(Total-shared , Shared) | Total-shared indicates the total shared-area ratio. If the device does not support a resource type, this field displays two hyphens (--). Shared indicates the shared-area ratio of a port. If the device does not support a resource type, this field displays two hyphens (--).
(Guaranteed , Shared) | · Guaranteed indicates the fixed-area ratio of a queue. If the device does not support a resource type, this field displays two hyphens (--). · Shared indicates the shared-area ratio of a queue. If the device does not support a resource type, this field displays two hyphens (--).

Data buffer commands -- display buffer usage

Use display buffer usage to display buffer usage.

Syntax

Distributed devices in standalone mode:Centralized devices:Centralized IRF devices:

display buffer usage [ slot slot-number ]

Distributed devices in IRF mode:

display buffer usage [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

slot slot-number: Specifies the current device. The value for the slot-number argument can only be 1. (Centralized devices.)

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays buffer usage for all cards. (Distributed devices in standalone mode.)

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. (Centralized IRF devices.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option, the command displays buffer usage for all cards of the IRF fabric. (Distributed devices in IRF mode.)

Examples

# Display buffer usage.

<Sysname> display buffer usage

Egress total-shared cell buffer usage on slot 1 :

XPE 0

Total: 4033 KB

Used: 0 KB

Free: 4033 KB

XPE 1

Total: 4033 KB

Used: 0 KB

Free: 4033 KB

XPE 2

Total: 4033 KB

Used: 0 KB

Free: 4033 KB

XPE 3

Total: 4033 KB

Used: 0 KB

Free: 4033 KB

5sec 1min 5min

------------------------------------------------------------------

Ten-GigabitEthernet1/0/1 XPE 0 0% 0% 0%

XPE 1 0% 0% 0%

XPE 2 0% 0% 0%

XPE 3 0% 0% 0%

Ten-GigabitEthernet1/0/2 XPE 0 0% 0% 0%

XPE 1 0% 0% 0%

XPE 2 0% 0% 0%

XPE 3 0% 0% 0%

Ten-GigabitEthernet1/0/3 XPE 0 0% 0% 0%

XPE 1 0% 0% 0%

XPE 2 0% 0% 0%

XPE 3 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.
XPE | Model of the data buffer.
Block | Block where the port resides. The block where the ports on the front panel of the device reside is fixed to Block 1.
Total | Total size of the data buffer.
Used | Size of used data buffer.
Free | Size of free data buffer.
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.

‌

Data buffer commands -- 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

mdc-admin

mdc-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 buffer usage statistics for GigabitEthernet 1/0/1.

<Sysname> display buffer usage interface gigabitethernet 1/0/1

Interface QueueID Total Used Threshold(%) Violations

--------------------------------------------------------------------------------

GE1/0/1 0 9418032 0 30 0

1 9418032 0 30 0

2 9418032 0 30 0

3 9418032 0 30 0

4 9418032 0 30 0

5 9418032 0 30 0

6 9418032 0 30 0

7 9418032 0 30 0

Table 3 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.

‌