storm-control

Function

The storm-control command enables storm control for broadcast packets, unknown multicast packets, and unknown unicast packets on an interface.

The undo storm-control command disables storm control.

By default, storm control is disabled on interfaces.

Format

storm-control { broadcast | multicast | unicast } min-rate min-rate-value max-rate max-rate-value

storm-control { broadcast | multicast | unicast } min-rate cir min-rate-value-cir max-rate cir max-rate-value-cir (Only the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731-S, S5731S-H, S5731S-S, S5732-H, S5735-L, S5735S-L, S5735S-L-M, S5735-S, S5735S-S, S5735-S-I, S6720-EI, S6720-HI, S6720S-EI, S6730-H, S6730S-H, S6730-S, and S6730S-S support this command.)

storm-control { broadcast | multicast | unicast } min-rate percent min-rate-value-percent max-rate percent max-rate-value-percent (Only the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731-S, S5731S-H, S5731S-S, S5732-H, S5735-L, S5735S-L, S5735S-L-M, S5735-S, S5735S-S, S5735-S-I, S6720-EI, S6720-HI, S6720S-EI, S6730-H, S6730S-H, S6730-S, and S6730S-S support this command.)

undo storm-control { broadcast | multicast | unicast | all-packets }

Parameters

Parameter	Description	Value
broadcast	Enables storm control for broadcast packets.	-
multicast	Enables storm control for unknown multicast packets.	-
unicast	Enables storm control for unknown unicast packets.	-
min-rate min-rate-value	Specifies the lower threshold in packet rate limit mode. If the value of min-rate-value is specified, packets received by an interface are forwarded when the rate of receiving packets is smaller than the value of min-rate-value in storm detection.	The value is an integer, in pps. The value range is as follows: Ethernet interface: 1 to 148810 GE interface: 1 to 1488100 MultiGE interface: 1 to X. X indicates the negotiated bandwidth XGE interface: 1 to 14881000 25GE interface: 1 to 14881000 40GE interface: 1 to 59524000 100GE interface: 1 to 148810000 Port group: 1 to 148810000 NOTE: The given value range for port groups is the maximum one. The actually delivered value range depends on the minimum value range allowed by member interfaces in a port group.
min-rate cir min-rate-value-cir	Specifies the lower threshold in byte rate limit mode. If the value of min-rate-value-cir is specified, packets received by an interface are forwarded when the rate of receiving packets is smaller than the value of min-rate-value-cir in storm detection.	The value is an integer, in kbit/s. The value range is as follows: Ethernet interface: 1 to 100000 GE interface: 1 to 1000000 XGE interface: 1 to 10000000 25GE interface: 1 to 14881000 40GE interface: 1 to 40000000 100GE interface: 1 to 100000000 Port group: 1 to 100000000 NOTE: The given value range for port groups is the maximum one. The actually delivered value range depends on the minimum value range allowed by member interfaces in a port group.
min-rate percent min-rate-value-percent	Specifies the lower threshold in percentage rate limit mode. If the value of min-rate-value-percent is specified, packets received by an interface are forwarded when the rate of receiving packets is lower than the value of min-rate-value-percent in storm detection.	The value is an integer, in percentage. The value ranges from 1 to 100.
max-rate max-rate-value	Specifies the upper threshold in packet rate limit mode. Storm control is performed on an interface when the rate of receiving packets on the interface is greater than the value of max-rate-value in storm detection.	The value is an integer, in pps. The value range is as follows: Ethernet interface: 1 to 148810 GE interface: 1 to 1488100 MultiGE interface: 1 to X. X indicates the negotiated bandwidth XGE interface: 1 to 14881000 25GE interface: 1 to 14881000 40GE interface: 1 to 59524000 100GE interface: 1 to 148810000 Port group: 1 to 148810000 NOTE: The given value range for port groups is the maximum one. The actually delivered value range depends on the minimum value range allowed by member interfaces in a port group.
max-rate cir max-rate-value-cir	Specifies the upper threshold in byte rate limit mode. If the value of max-rate-value-cir is specified, storm control is performed on an interface when the rate of receiving packets on the interface is greater than the value of max-rate-value-cir in storm detection.	The value is an integer, in kbit/s. The value range is as follows: Ethernet interface: 1 to 100000 GE interface: 1 to 1000000 XGE interface: 1 to 10000000 25GE interface: 1 to 14881000 40GE interface: 1 to 40000000 100GE interface: 1 to 100000000 Port group: 1 to 100000000 NOTE: The given value range for port groups is the maximum one. The actually delivered value range depends on the minimum value range allowed by member interfaces in a port group.
max-rate percent max-rate-value-percent	Specifies the upper threshold in percentage rate limit mode. If the value of max-rate-value-percent is specified, storm control is performed on an interface when the rate of receiving packets on the interface is greater than the value of max-rate-value-percent in storm detection.	The value is an integer, in percentage. The value ranges from 1 to 100.
all-packets	Disables storm control for all the broadcast packets, unknown multicast packets, and unknown unicast packets.	-

Views

Ethernet interface view, 40GE interface view, 100GE interface view, GE interface view, XGE interface view, 25GE interface view, MultiGE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the average rate of receiving packets on an interface is greater than the value of max-rate-value, max-rate-value-cir, or max-rate-value-percent in storm detection, storm control is performed on the packets.

The storm detection interval can be set using the storm-control interval command.

Storm control actions include block and shutdown, which can be configured using the storm-control action command. If the action is block on an interface, packets on the interface are unblocked when the rate of receiving packets on the interface is smaller than the value of min-rate-value, min-rate-value-cir or min-rate-value-percent; if the action is shutdown on an interface, run the undo shutdown command to enable the interface.

Precautions

For S2720-EI, S5720I-SI, S5720-LI, S5720S-LI, S5720S-SI, S5720-SI, S5730S-EI, S5730-SI, S5735-L, S5735S-L, S5735S-L-M, S5735-S, S5735S-S, S5735-S-I, S6720-LI, S6720S-LI, S6720S-SI, and S6720-SI, when detecting unicast packets, a switch does not distinguish unknown unicast packets from known unicast packets. The packet rate detected is the sum of the rates of unknown and known unicast packets. When the storm control action is block, the switch blocks only the unknown unicast packets. This rule also applies to multicast packets.

You cannot configure storm control and traffic suppression simultaneously on an interface. For example, if you configure traffic suppression for broadcast packets on an interface, then you cannot configure storm control for broadcast packets simultaneously on the interface.

After storm control is configured on an interface, the device does not check the VLAN IDs of packets when performing check on the packets. That is, the device performs storm control on all the packets no matter whether the VLANs of the packets are allowed by the interface.

Example

# Perform storm control on broadcast packets received on GE0/0/1. In the storm detection interval, perform storm control on packets when the rate of receiving packets on an interface is greater than 8000 pps and forward packets when the rate of receiving packets on an interface is smaller than 5000 pps.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] storm-control broadcast min-rate 5000 max-rate 8000