03-Layer 3-IP Services Command Reference

HomeSupportSwitchesS12500X-AF SeriesReference GuidesCommand ReferencesH3C S12500X-AF Switch Series Command References(R3606)-6W10003-Layer 3-IP Services Command Reference
01-ARP commands
Title Size Download
01-ARP commands 171.77 KB

ARP commands

arp check enable

Use arp check enable to enable dynamic ARP entry check.

Use undo arp check enable to disable dynamic ARP entry check.

Syntax

arp check enable

undo arp check enable

Default

Dynamic ARP entry check is enabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Dynamic ARP entry check disables a device from supporting dynamic ARP entries with multicast MAC addresses. The device cannot learn dynamic ARP entries containing multicast MAC addresses. You cannot manually add static ARP entries that contain multicast MAC addresses.

When dynamic ARP entry check is disabled, ARP entries containing multicast MAC addresses are supported. The device can learn dynamic ARP entries containing multicast MAC addresses obtained from the ARP packets sourced from a unicast MAC address. You can also manually add static ARP entries containing multicast MAC addresses.

Examples

# Enable dynamic ARP entry check.

<Sysname> system-view

[Sysname] arp check enable

arp check log enable

Use arp check log enable to enable the ARP logging feature.

Use undo arp check log enable to disable the ARP logging feature.

Syntax

arp check log enable

undo arp check log enable

Default

ARP logging is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

This feature enables a device to log ARP events when ARP cannot resolve IP addresses correctly. The device can log the following ARP events:

·     On a proxy ARP-disabled interface, the target IP address of a received ARP packet is not one of the following IP addresses:

¡     The IP address of the receiving interface.

¡     The virtual IP address of the VRRP group.

·     The sender IP address of a received ARP reply conflicts with one of the following IP addresses:

¡     The IP address of the receiving interface.

¡     The virtual IP address of the VRRP group.

The device sends ARP log messages to the information center. You can use the info-center source command to specify the log output rules for the information center. For more information about information center, see Network Management and Monitoring Configuration Guide.

The device can generate a large number of ARP logs. To conserve system resources, enable ARP logging only when you are auditing or troubleshooting ARP events.

Examples

# Enable ARP logging.

<Sysname> system-view

[Sysname] arp check log enable

arp ip-unnumbered learning enable

Use arp ip-unnumbered learning enable to enable an IP unnumbered interface to learn ARP entries for different subnets.

Use undo arp ip-unnumbered learning enable to disable an IP unnumbered interface from learning ARP entries for different subnets.

Syntax

arp ip-unnumbered learning enable

undo arp ip-unnumbered learning enable

Default

An IP unnumbered interface cannot learn ARP entries for different subnets.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

An IP unnumbered interface cannot learn the ARP entry of the peer device if the unnumbered interface and the peer device are on different subnets. To ensure communication between them, you can enable this feature on the IP unnumbered interface.

This feature takes effect only on an interface configured with the ip address unnumbered command. This interface is an unnumbered interface and borrows the IP address from another interface.

If an IP unnumbered interface is disabled from learning ARP entries for different subnets, existing ARP entries learned for different subnets are deleted after they age out.

Examples

# Configure HundredGigE 1/0/1 to borrow the IP address of HundredGigE 1/0/2, and enable HundredGigE 1/0/1 to learn ARP entries for different subnets.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] ip address unnumbered interface hundredgige 1/0/2

[Sysname-HundredGigE1/0/1] arp ip-unnumbered learning enable

Related commands

ip address unnumbered

arp max-learning-num

Use arp max-learning-num to set the dynamic ARP learning limit on an interface.

Use undo arp max-learning-num to restore the default.

Syntax

arp max-learning-num max-number

undo arp max-learning-num

Default

The dynamic ARP learning limit on an interface equals to the ARP table capacity set by using the hardware-resource arp command.

Views

Layer 2 Ethernet interface view

Layer 2 aggregate interface view

Layer 3 Ethernet interface view

Layer 3 Ethernet subinterface view

Layer 3 aggregate interface view

Layer 3 aggregate subinterface view

VXLAN VSI interface view

VLAN interface view

Predefined user roles

network-admin

Parameters

max-number: Specifies the maximum number of dynamic ARP entries that can be learned on an interface. The value range for this argument is 0 to N, where N equals to the ARP table capacity.

Usage guidelines

An interface can dynamically learn ARP entries. To prevent an interface from holding too many ARP entries, you can set the maximum number of dynamic ARP entries that the interface can learn. When the limit is reached, the interface stops learning ARP entries.

When the learning limit is set to 0, the interface is disabled from learning dynamic ARP entries.

Examples

# Specify VLAN-interface 40 to learn a maximum of 10 dynamic ARP entries.

<Sysname> system-view

[Sysname] interface vlan-interface 40

[Sysname-Vlan-interface40] arp max-learning-num 10

# Specify HundredGigE 1/0/1 to learn a maximum of 10 dynamic ARP entries.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] arp max-learning-num 10

# Specify Layer 2 aggregate interface Bridge-Aggregation 1 to learn a maximum of 10 dynamic ARP entries.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] arp max-learning-num 10

# Specify Layer 3 aggregate interface Route-Aggregation 1 to learn a maximum of 10 dynamic ARP entries.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] arp max-learning-num 10

arp max-learning-number

Use arp max-learning-number to set the dynamic ARP learning limit on a device.

Use undo arp max-learning-number to restore the default.

Syntax

arp max-learning-number max-number slot slot-number

undo arp max-learning-number slot slot-number

Default

The dynamic ARP learning limit on a device equals to the ARP table capacity set by using the hardware-resource arp command.

Views

System view

Predefined user roles

network-admin

Parameters

max-number: Specifies the maximum number of dynamic ARP entries that can be learned on a device. The value range for this argument is 0 to N, where N equals to the ARP table capacity.

slot slot-number: Specifies a card by its slot number.

Usage guidelines

A device can dynamically learn ARP entries. To prevent a device from holding too many ARP entries, you can set the maximum number of dynamic ARP entries that the device can learn. When the limit is reached, the device stops learning ARP entries.

When the learning limit is set to 0, the device is disabled from learning dynamic ARP entries.

Examples

# Set the ARP learning limit to 64 for slot 1.

<Sysname> system-view

[Sysname] arp max-learning-number 64 slot 1

arp mode uni

Use arp mode uni to configure a port as a customer-side port.

Use undo arp mode to restore the default.

Syntax

arp mode uni

undo arp mode

Default

A port operates as a network-side port.

Views

VSI interface view

VLAN interface view

Predefined user roles

network-admin

Usage guidelines

By default, the device associates an ARP entry with routing information when the device learns an ARP entry. The ARP entry provides the next hop information for routing. To save hardware resources, you can use this command to specify a port that connects to a user terminal as a customer-side port. The device will not associate the routing information with the learned ARP entries.

Examples

# Configure VLAN-interface 2 as a customer-side port.

<Sysname> system-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] arp mode uni

arp smooth

Use arp smooth to synchronize ARP entries from the active MPU to all other cards.

Syntax

arp smooth

Views

User view

Predefined user roles

network-admin

Usage guidelines

This command triggers a one-time operation to ensure that all cards on the device have the same ARP entries.

To synchronize ARP entries across all cards in a timely manner, you can schedule the device to automatically execute the arp smooth command. For information about scheduling a task, see Fundamentals Configuration Guide.

Examples

# Synchronize ARP entries from the active MPU to all other cards.

<Sysname> arp smooth

arp static

Use arp static to configure a static ARP entry.

Use undo arp to delete an ARP entry.

Syntax

arp static ip-address mac-address [ vlan-id interface-type interface-number | vsi-interface vsi-interface-id tunnel number vsi vsi-name | vsi-interface vsi-interface-id interface-type interface-number service-instance instance-id vsi vsi-name ] [ vpn-instance vpn-instance-name ]

undo arp ip-address [ vpn-instance-name ]

Default

No static ARP entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

ip-address: Specifies an IP address for the static ARP entry.

mac-address: Specifies a MAC address for the static ARP entry, in the format of H-H-H.

vlan-id: Specifies the ID of a VLAN to which the static ARP entry belongs. The value range is 1 to 4094.

interface-type interface-number: Specifies an interface by its type and number.

vsi-interface vsi-interface-id: Specifies a VSI interface by its number. The VSI interface must already exist.

tunnel number: Specifies a tunnel interface by its number. The tunnel interface must already exist.

vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters.

service-instance instance-id: Specifies an Ethernet service instance by its ID in the range of 1 to 4096. This option is a must if you specify a Layer 2 Ethernet interface for the preceding interface-type interface-number arguments. Do not specify this option if you specify an interface of other types for the preceding interface-type interface-number argument.

vpn-instance vpn-instance-name: Specifies the MPLS L3VPN instance to which the static ARP entry belongs. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If the static ARP entry belongs to the public network, do not specify this option.

Usage guidelines

A static ARP entry is manually configured and maintained. It does not age out and cannot be overwritten by any dynamic ARP entry.

Static ARP entries can be short or long.

A resolved short static ARP entry becomes unresolved upon certain events, for example, when the resolved output interface goes down, or the corresponding VLAN or VLAN interface is deleted.

Long static ARP entries are effective or ineffective. Ineffective long static ARP entries cannot be used for packet forwarding. A long static ARP entry is ineffective when any of the following conditions exists:

·     The IP address in the entry conflicts with a local IP address.

·     No local interface has an IP address in the same subnet as the IP address in the ARP entry.

If you specify the vlan-id interface-type interface-number argument, follow these restrictions and guidelines:

·     The interface can be an Ethernet interface or an aggregate interface.

·     The VLAN and VLAN interface must already exist. The specified Ethernet interface must belong to the specified VLAN.

·     The IP address of the VLAN interface and the IP address specified by the ip-address argument must be on the same network.

·     A long static ARP entry for a VLAN is deleted if the VLAN or VLAN interface is deleted.

On a VXLAN IP gateway that forwards traffic among VXLANs through VXLAN tunnels, a VSI interface can act as the gateway for multiple VXLANs. The VSI interface (input interface) might be connected to multiple VXLAN tunnel interfaces (output interfaces). In this case, you must specify the vsi-interface vsi-interface-id tunnel number vsi vsi-name parameters to identify a VSI interface-VSI-VXLAN tunnel interface binding. For more information about VSI interfaces, VSI, and VXLAN tunnel interfaces, see VXLAN Configuration Guide.

On a VXLAN IP gateway that forwards traffic from multiple local sites to remote sites, a VSI interface can act as the gateway for multiple local sites. The VSI interface (input interface) might be associated with multiple Ethernet services (output interfaces) on Layer 2 Ethernet interfaces through which the VSI interface connects to the local sites. In this case, you must specify the vsi-interface vsi-interface-id interface-type interface-number service-instance instance-id vsi vsi-name parameters to identify a VSI interface-Layer 2 Ethernet interface-Ethernet service instance-VSI binding. For more information about VSI interfaces, VSI, and Ethernet service instances, see VXLAN Configuration Guide.

Examples

# Configure a long static ARP entry that contains IP address 202.38.10.2, output interface HundredGigE 1/0/1 in VLAN 10, and MAC address 00e0-fc01-0000.

<Sysname> system-view

[Sysname] arp static 202.38.10.2 00e0-fc01-0000 10 hundredgige 1/0/1

# Configure a long static ARP entry that contains IP address 1.1.1.1, MAC address 00e0-fc01-0000, input interface VSI-interface 1, output interface Tunnel 1, and VSI a.

<Sysname> system-view

[Sysname] arp static 1.1.1.1 00e0-fc01-0000 vsi-interface 1 tunnel 1 vsi a

# Configure a long static ARP entry that contains IP address 1.1.1.1, MAC address 00e0-fc01-0000, input interface VSI-interface 1, output interface Ethernet instance 1 on HundredGigE 1/0/1, and VSI a.

<Sysname> system-view

[Sysname] arp static 1.1.1.1 00e0-fc01-0000 vsi-interface 1 hundredgige 1/0/1 service-instance 1 vsi a

Related commands

display arp

reset arp

arp timer aging

Use arp timer aging to set the aging timer for dynamic ARP entries.

Use undo arp timer aging to restore the default.

Syntax

arp timer aging aging-time

undo arp timer aging

Default

The aging timer for dynamic ARP entries is 20 minutes.

Views

System view

Predefined user roles

network-admin

Parameters

aging-time: Specifies the aging timer for dynamic ARP entries, in the range of 1 to 1440 minutes.

Usage guidelines

Each dynamic ARP entry in the ARP table has a limited lifetime, called an aging timer. The aging timer of a dynamic ARP entry is reset each time the dynamic ARP entry is updated. Dynamic ARP entries that are not updated before their aging timers expire are deleted from the ARP table.

Set the aging timer for dynamic ARP entries as needed. For example, when you configure proxy ARP, set a short aging time so that invalid dynamic ARP entries can be deleted in a timely manner.

Examples

# Set the aging timer for dynamic ARP entries to 10 minutes.

<Sysname> system-view

[Sysname] arp timer aging 10

Related commands

display arp timer aging

display arp

Use display arp to display ARP entries.

Syntax

display arp [ [ all | dynamic | static ] [ slot slot-number ] | vlan vlan-id | interface interface-type interface-number ] [ count | verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Displays all ARP entries.

dynamic: Displays dynamic ARP entries.

static: Displays static ARP entries.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays ARP entries on the active MPU.

vlan vlan-id: Specifies a VLAN by its VLAN ID. The VLAN ID is in the range of 1 to 4094.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays ARP entries for all interfaces.

count: Displays the number of ARP entries.

verbose: Displays detailed information about ARP entries.

Usage guidelines

This command displays information about ARP entries, including the IP address, MAC address, VLAN ID, output interface, entry type, and aging timer.

Examples

# Display all ARP entries.

<Sysname> display arp all

  Type: S-Static   D-Dynamic   O-Openflow   R-Rule   M-Multiport  I-Invalid

IP address      MAC address    VLAN/VSI name Interface                Aging Type

1.1.1.1         02e0-f102-0023 1             HGE1/0/1                 --    S

1.1.1.2         00e0-fc00-0001 12            HGE1/0/2                 16    D

1.1.1.3         00e0-fe50-6503 vsi1          Tunnel1                  15    D

1.1.1.4         000d-88f7-9f7d vsi1          HGE1/0/3                 16    D

# Display detailed information about all ARP entries.

<Sysname> display arp all verbose

IP address          : 1.1.1.1             MAC address    : 02e0-f102-0023

Type                : Static              Aging          : --

Interface           : HGE1/0/1

SVLAN/CVLAN         : 1000/1001

VPN instance        : --

Link ID             : --

VXLAN ID            : --

VSI name            : --

VSI interface       : --

Nickname            : 0x0000

IP address          : 1.1.1.2             MAC address    : 0015-e944-adc5

Type                : Dynamic             Aging          : 16 min

Interface           : HGE1/0/2

SVLAN/CVLAN         : --/--

VPN instance        : --

Link ID             : --

VXLAN ID            : --

VSI name            : --

VSI interface       : --

Nickname            : 0x0000

# Display the number of all ARP entries.

<Sysname> display arp all count

 Total number of entries : 4

Table 1 Command output

Field

Description

IP address

IP address in an ARP entry.

MAC address

MAC address in an ARP entry.

VLAN/VSI name

ID of the VLAN or name of the VSI to which an ARP entry belongs. This field displays hyphens (--) in either of the following situations:

·     The ARP entry is an unresolved short static ARP entry.

·     The output interface of the ARP entry does not belong to any VLAN or VSI.

Interface

Multiport ARP entry is not supported in the current software version.

Output interface in an ARP entry.

This field displays hyphens (--) in either of the following situations:

·     The ARP entry is an unresolved short static ARP entry.

·     The ARP entry is a multiport ARP entry and has no output interface information.
To obtain the output interface information of the multiport ARP entry, look up the MAC address table according to the MAC address in the ARP entry.

Aging

Aging time for an ARP entry, in minutes.

For a static ARP entry, this field always displays hyphens (--). The static ARP entry never ages out unless you delete it manually.

For a dynamic ARP entry, this field displays hyphens (--) if the aging time is unknown.

Type

Multiport ARP entry is not supported in the current software version.

ARP entry type:

·     D—Dynamic.

·     S—Static.

·     O—OpenFlow.

·     R—Rule.

·     M—Multiport.

·     I—Invalid.

SVLAN/CVLAN

ID of the SVLAN or CVLAN to which the ARP entry belongs. This field displays hyphens (--) in either of the following situations:

·     The ARP entry is an unresolved short static ARP entry.

·     The output interface of the ARP entry does not belong to any SVLAN or CVLAN.

VPN instance

Name of VPN instance. This field displays hyphens (--) if no VPN instance is configured for the ARP entry.

Link ID

Link ID in an ARP entry. This field displays hyphens (--) if the ARP entry does not belong to any VSI.

VXLAN ID

VXLAN ID (also called VNI). This field displays hyphens (--) if the ARP entry does not belong to any VXLAN.

VSI name

Name of the VSI to which the ARP entry belongs. This field displays hyphens (--) if the ARP entry does not belong to a specific VSI.

VSI interface

VSI interface specified for the VSI. This field displays hyphens (--) if no VSI interface is specified for the VSI.

Nickname

This field is not supported in the current software version.

Nickname of the ARP entry. The nickname is a string of four hexadecimal numbers, for example, 012a.

Total number of entries

Number of ARP entries.

Related commands

arp static

reset arp

display arp entry-limit

Use display arp entry-limit to display the maximum number of ARP entries that a device supports.

Syntax

display arp entry-limit

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the maximum number of ARP entries that the device supports.

<Sysname> display arp entry-limit

ARP entries: 1048576

display arp ip-address

Use display arp ip-address to display the ARP entry for an IP address.

Syntax

display arp ip-address [ slot slot-number ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ip-address: Specifies an IP address.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays the ARP entry on the active MPU.

verbose: Displays the detailed information about the specified ARP entry.

Usage guidelines

The ARP entry information includes the IP address, MAC address, VLAN ID, output interface, entry type, and aging timer.

Examples

# Display the ARP entry for the IP address 20.1.1.1.

<Sysname> display arp 20.1.1.1

  Type: S-Static   D-Dynamic   O-Openflow   R-Rule   M-Multiport  I-Invalid

IP Address       MAC Address    SVLAN/VSI Interface/Link ID        Aging Type

20.1.1.1         00e0-fc00-0001 --        --                       --    S

Related commands

arp static

reset arp

display arp timer aging

Use display arp timer aging to display the aging timer of dynamic ARP entries.

Syntax

display arp timer aging

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the aging timer of dynamic ARP entries.

<Sysname> display arp timer aging

Current ARP aging time is 20 minute(s)(default)

Related commands

arp timer aging

display arp vpn-instance

Use display arp vpn-instance to display the ARP entries for a VPN instance.

Syntax

display arp vpn-instance vpn-instance-name [ count ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.

count: Displays the number of ARP entries.

Usage guidelines

This command displays information about ARP entries for a VPN instance, including the IP address, MAC address, VLAN ID, output interface, entry type, and aging timer.

Examples

# Display ARP entries for VPN instance test.

<Sysname> display arp vpn-instance test

  Type: S-Static   D-Dynamic   O-Openflow   R-Rule   M-Multiport  I-Invalid

IP Address       MAC Address    SVLAN/VSI Interface/Link ID        Aging Type

20.1.1.1         00e0-fc00-0001 --        --                       --    S

Related commands

arp static

reset arp

display hardware-resource arp

Use display hardware-resource arp to display the ARP hardware resource mode information.

Syntax

display hardware-resource [ arp ]

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

If you do not specify the arp keyword, this command displays hardware resource mode for all types.

Examples

# Display ARP hardware resource mode.

<Sysname> display hardware-resource arp

Arp resource(arp), all supported modes:

  normal            The normal mode

  enhance_arp       The arp enhance mode

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

  Default         Current         Next

  normal          normal          normal

Table 2 Command output

Field

Description

Arp resource(arp), all supported modes

ARP hardware resource modes supported by the device:

·     normal—Normal mode.

·     enhance_arp—Enhanced mode.

Default

Default ARP hardware resource mode.

Current

Current ARP hardware resource mode.

Next

ARP hardware resource mode for the next startup.

 

Related commands

hardware-resource arp

hardware-resource arp

Use hardware-resource arp to set the ARP hardware resource mode.

Syntax

hardware-resource arp { normal | enhance_arp }

undo hardware-resource arp

Default

The ARP hardware resource mode is normal.

Views

System view

Predefined user roles

network-admin

Parameters

normal: Specifies the normal mode. In this mode, the number of ARP hardware forwarding entries allowed to be created is relatively small.

enhance_arp: Specifies the enhanced mode. In this mode, the number of ARP hardware forwarding entries allowed to be created is relatively large.

Usage guidelines

Hardware resources are limited on the device. ARP entries occupy device hardware resources. Use this command to set the ARP hardware resource mode as needed.

·     To limit ARP entries to use fewer hardware resources, use the normal mode.

·     To allow ARP entries to use more hardware resources, use the enhanced mode.

This settings takes effect after a device reboot.

Examples

# Set the ARP hardware resource mode to enhanced.

<Sysname> system-view

[Sysname] hardware-resource arp enhance_arp

Related commands

display hardware-resource arp

reset arp

Use reset arp to clear ARP entries from the ARP table.

Syntax

reset arp { all | dynamic | interface interface-type interface-number | slot slot-number | static }

Views

User view

Predefined user roles

network-admin

Parameters

all: Clears all ARP entries.

dynamic: Clears all dynamic ARP entries.

static: Clears all static ARP entries.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command clears ARP entries on the active MPU.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command clears ARP entries for all interfaces.

Examples

# Clear all static ARP entries.

<Sysname> reset arp static

Related commands

arp static

display arp


Gratuitous ARP commands

arp ip-conflict log prompt

Use arp ip-conflict log prompt to enable IP conflict notification.

Use undo arp ip-conflict log prompt to restore the default.

Syntax

arp ip-conflict log prompt

undo arp ip-conflict log prompt

Default

IP conflict notification is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

By default, the device performs the following operations if it is using the sender IP address of a received ARP packet:

·     Sends a gratuitous ARP request.

·     Displays an error message after the device receives an ARP reply about the conflict.

You can use this command to enable the device to display error messages before sending a gratuitous ARP reply or request for conflict confirmation.

Examples

# Enable IP conflict notification on the device.

<Sysname> system-view

[Sysname] arp ip-conflict log prompt

arp send-gratuitous-arp

Use arp send-gratuitous-arp to enable periodic sending of gratuitous ARP packets on an interface.

Use undo arp send-gratuitous-arp to disable the interface from periodically sending gratuitous ARP packets.

Syntax

arp send-gratuitous-arp [ interval interval ]

undo arp send-gratuitous-arp

Default

Periodic sending of gratuitous ARP packets is disabled.

Views

Layer 3 Ethernet interface view

Layer 3 Ethernet subinterface view

Layer 3 aggregate interface view

Layer 3 aggregate subinterface view

VSI interface view

VLAN interface view

Predefined user roles

network-admin

Parameters

interval interval: Specifies the sending interval in the range of 200 to 200000 milliseconds. The default value is 2000 milliseconds.

Usage guidelines

This feature takes effect on an interface only when the interface has an IP address and the data link layer state of the interface is up.

This feature can send gratuitous ARP requests only for a VRRP virtual IP address, or the sending interface's primary IP address or manually configured secondary IP address. The primary IP address can be configured manually or automatically, whereas the secondary IP address must be configured manually.

If you change the sending interval for gratuitous ARP packets, the configuration takes effect at the next sending interval.

The sending interval for gratuitous ARP packets might be much longer than the set interval when any of the following conditions exist:

·     This feature is enabled on multiple interfaces.

·     Each interface is configured with multiple secondary IP addresses.

·     A small sending interval is configured in the preceding cases.

Examples

# Enable HundredGigE 1/0/1 to send gratuitous ARP packets every 300 milliseconds.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] arp send-gratuitous-arp interval 300

gratuitous-arp-learning enable

Use gratuitous-arp-learning enable to enable learning of gratuitous ARP packets.

Use undo gratuitous-arp-learning enable to disable learning of gratuitous ARP packets.

Syntax

gratuitous-arp-learning enable

undo gratuitous-arp-learning enable

Default

Learning of gratuitous ARP packets is enabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

The learning of gratuitous ARP packets feature allows a device to maintain its ARP table by creating or updating ARP entries based on received gratuitous ARP packets.

When this feature is disabled, the device uses received gratuitous ARP packets to update existing ARP entries only. ARP entries are not created based on the received gratuitous ARP packets, which saves ARP table space.

Examples

# Enable learning of gratuitous ARP packets.

<Sysname> system-view

[Sysname] gratuitous-arp-learning enable

gratuitous-arp-sending enable

Use gratuitous-arp-sending enable to enable sending gratuitous ARP packets upon receiving ARP requests whose sender IP address is on a different subnet.

Use undo gratuitous-arp-sending enable to disable sending gratuitous ARP packets upon receiving ARP requests whose sender IP address is on a different subnet.

Syntax

gratuitous-arp-sending enable

undo gratuitous-arp-sending enable

Default

A device does not send gratuitous ARP packets when it receives ARP requests whose sender IP address is on a different subnet.

Views

System view

Predefined user roles

network-admin

Examples

# Disable a device from sending gratuitous ARP packets upon receiving ARP requests whose sender IP address is on a different subnet.

<Sysname> system-view

[Sysname] undo gratuitous-arp-sending enable


Proxy ARP commands

display local-proxy-arp

Use display local-proxy-arp to display the local proxy ARP status.

Syntax

display local-proxy-arp [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays the local proxy ARP status for all interfaces.

Usage guidelines

You can use this command to check whether local proxy ARP is enabled or disabled.

Examples

# Display the local proxy ARP status for HundredGigE 1/0/1.

<Sysname> display local-proxy-arp interface hundredgige 1/0/1

Interface HundredGigE1/0/1

 Local Proxy ARP status: enabled

Related commands

local-proxy-arp enable

display proxy-arp

Use display proxy-arp to display the proxy ARP status.

Syntax

display proxy-arp [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays the proxy ARP status for all interfaces.

Usage guidelines

You can use this command to check whether proxy ARP is enabled or disabled.

Examples

# Display the proxy ARP status on HundredGigE 1/0/1.

<Sysname> display proxy-arp interface hundredgige 1/0/1

Interface HundredGigE1/0/1

 Proxy ARP status: disabled

Related commands

proxy-arp enable

local-proxy-arp enable

Use local-proxy-arp enable to enable local proxy ARP.

Use undo local-proxy-arp enable to disable local proxy ARP.

Syntax

local-proxy-arp enable [ ip-range start-ip-address to end-ip-address ]

undo local-proxy-arp enable

Default

Local proxy ARP is disabled.

Views

Layer 3 Ethernet interface view

Layer 3 Ethernet subinterface view

Layer 3 aggregate interface view

Layer 3 aggregate subinterface view

VSI interface view

VLAN interface view

Predefined user roles

network-admin

Parameters

ip-range start-ip-address to end-ip-address: Specifies the IP address range for which local proxy ARP is enabled. The start IP address must be lower than or equal to the end IP address.

Usage guidelines

Proxy ARP enables a device on a network to answer ARP requests for an IP address not on that network.

With proxy ARP, hosts in different broadcast domains can communicate with each other as they do on the same network. To allow communication between hosts that connect to the same Layer 3 interface and reside in different broadcast domains, enable local proxy ARP.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Enable local proxy ARP on HundredGigE 1/0/1.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] local-proxy-arp enable

# Enable local proxy ARP on HundredGigE 1/0/1 for an IP address range.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] local-proxy-arp enable ip-range 1.1.1.1 to 1.1.1.20

Related commands

display local-proxy-arp

proxy-arp enable

Use proxy-arp enable to enable common proxy ARP.

Use undo proxy-arp enable to disable common proxy ARP.

Syntax

proxy-arp enable

undo proxy-arp enable

Default

Common proxy ARP is disabled.

Views

Layer 3 Ethernet interface view

Layer 3 Ethernet subinterface view

Layer 3 aggregate interface view

Layer 3 aggregate subinterface view

VSI interface view

VLAN interface view

Predefined user roles

network-admin

Usage guidelines

Proxy ARP enables a device on a network to answer ARP requests for an IP address not on that network.

With proxy ARP, hosts in different broadcast domains can communicate with each other as they do on the same network. To allow communication between hosts that connect to different Layer 3 interfaces or Layer 3 subinterfaces and reside in different broadcast domains, enable common proxy ARP.

Examples

# Enable common proxy ARP on HundredGigE 1/0/1.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] proxy-arp enable

Related commands

display proxy-arp


ARP snooping commands

arp snooping enable

Use arp snooping enable to enable ARP snooping.

Use undo arp snooping enable to disable ARP snooping.

Syntax

arp snooping enable

undo arp snooping enable

Default

ARP snooping is disabled.

Views

VLAN view

Predefined user roles

network-admin

Examples

# Enable ARP snooping for VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] arp snooping enable

display arp snooping

Use display arp snooping to display ARP snooping entries.

Syntax

display arp snooping [ vlan vlan-id ] [ slot slot-number ] [ count ]

display arp snooping ip ip-address [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vlan vlan-id: Displays ARP snooping entries for a VLAN. The vlan-id argument is in the range of 1 to 4094.

count: Displays the number of the ARP snooping entries.

ip ip-address: Displays the ARP snooping entry for the specified IP address.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays ARP snooping entries on the active MPU.

Examples

# Display ARP snooping entries for VLAN 2.

<Sysname> display arp snooping vlan 2

IP Address   MAC Address    VLAN ID Interface  Aging       Status

3.3.3.3      0003-0003-0003 2       HGE1/0/1   20          Valid

3.3.3.4      0004-0004-0004 2       HGE1/0/2   5           Invalid

# Display the number of the ARP snooping entries.

<Sysname> display arp snooping count

Total entries: 2

Table 3 Command output

Field

Description

IP Address

IP address in an ARP snooping entry.

MAC Address

MAC address in an ARP snooping entry.

VLAN ID

ID of the VLAN to which the ARP snooping entry belongs.

Interface

Input interface in an ARP snooping entry.

Aging

Aging time for an ARP snooping entry in minutes.

If the card learns an ARP snooping entry from another card, the card cannot learn the aging time of the entry, and this field displays hyphens (--).

Status

Status of an ARP snooping entry: Valid, Invalid, Collision.

Total entries

Number of ARP snooping entries.

 

Related commands

reset arp snooping

reset arp snooping

Use reset arp snooping to delete ARP snooping entries.

Syntax

reset arp snooping [ ip ip-address | vlan vlan-id ]

Views

User view

Predefined user roles

network-admin

Parameters

ip ip-address: Deletes the ARP snooping entry for the specified IP address.

vlan vlan-id: Deletes ARP snooping entries for the specified VLAN. The value range for the vlan-id argument is 1 to 4094.

Usage guidelines

If you do not specify any option, the command deletes all ARP snooping entries.

Examples

# Delete ARP snooping entries for VLAN 2.

<Sysname> reset arp snooping vlan 2

Related commands

display arp snooping


ARP fast-reply commands

arp fast-reply enable

Use arp fast-reply enable to enable ARP fast-reply for a VLAN.

Use undo arp fast-reply enable to disable ARP fast-reply for a VLAN.

Syntax

arp fast-reply enable

undo arp fast-reply enable

Default

ARP fast-reply is disabled on a VLAN.

Views

VLAN view

Predefined user roles

network-admin

Examples

# Enable ARP fast-reply for VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] arp fast-reply enable


ARP suppression commands

arp suppression enable

Use arp suppression enable to enable ARP suppression.

Use undo arp suppression enable to disable ARP suppression.

Syntax

arp suppression enable

undo arp suppression enable

Default

ARP suppression is disabled.

Views

Cross-connect view

VSI view

Predefined user roles

network-admin

Usage guidelines

You must enable L2VPN before you execute this command.

Examples

# Enable ARP suppression for cross-connect 2 in cross-connect group 1.

<Sysname> system-view

[Sysname] xconnect-group 1

[Sysname-xcg-1] connection 2

[Sysname-xcg-1-2] arp suppression enable

# Enable ARP suppression for VSI vsi1.

<Sysname> system-view

[Sysname] vsi vsi1

[Sysname-vsi-vsi1] arp suppression enable

Related commands

arp suppression push interval

arp suppression push interval

Use arp suppression push interval to enable the ARP suppression push feature and set a push interval.

Use undo arp suppression push interval to disable the ARP suppression push feature.

Syntax

arp suppression push interval interval

undo arp suppression push interval

Default

The ARP suppression push feature is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies a push interval for ARP suppression, in the range of 1 to 1440 minutes.

Usage guidelines

The ARP suppression push feature regularly pushes ARP suppression entries by broadcasting gratuitous ARP packets.

Examples

# Configure the device to push ARP suppression entries every 2 minutes.

<Sysname> system-view

[Sysname] arp suppression push interval 2

Related commands

arp suppression enable

display arp suppression

Use display arp suppression to display ARP suppression entries.

Syntax

display arp suppression [ vsi [ name vsi-name ] | xconnect-group [ name group-name ] ] [ slot slot-number ] [ count ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vsi: Display ARP suppression entries for VSIs.

name vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters excluding hyphens (-). If you do not specify a VSI, this command display ARP suppression entries for all VSIs.

xconnect-group: Display ARP suppression entries for cross-connect groups.

name group-name: Specifies a cross-connect group by its name, a case-sensitive string of 1 to 31 characters excluding hyphens (-). If you do not specify a cross-connect group, this command display ARP suppression entries for all cross-connect groups.

count: Displays the total number of ARP suppression entries.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays ARP suppression entries on the active MPU.

Parameters

If you do not specify the vsi or xconnect-group keyword, this command displays ARP suppression entries for all VSIs and cross-connect groups.

Examples

# Display ARP suppression entries for all cross-connect groups.

<Sysname> display arp suppression xconnect-group

IP address      MAC address     Xconnect-group       Connection           Aging

100.1.1.1       000c-29fe-5a8f  vpna                 svc                  12

100.1.1.2       000c-29fe-5aa3  vpna                 svc                  25

# Display the total number of ARP suppression entries for all cross-connect groups.

<Sysname> display arp suppression xconnect-group count

Total entries: 2

Table 4 Command output

Field

Description

IP address

IP address in the ARP suppression entry.

MAC address

MAC address in the ARP suppression entry.

Xconnect-group

Name of the cross-connect group to which the ARP suppression entry belongs.

Connection

Name of the cross-connect to which the ARP suppression entry belongs.

Aging

Aging time of the ARP suppression entry, in minutes.

 

# Display ARP suppression entries for all VSIs.

IP address      MAC address    Vsi Name                        Link ID    Aging

1.1.1.2         000f-e201-0101 vsi1                            0x70000    14

1.1.1.3         000f-e201-0202 vsi1                            0x80000    18

1.1.1.4         000f-e201-0203 vsi2                            0x90000    10

# Display the total number of ARP suppression entries for all VSIs.

<Sysname> display arp suppression vsi count

Total entries: 3   

Table 5 Command output

Field

Description

IP address

IP address in the ARP suppression entry.

MAC address

MAC address in the ARP suppression entry.

Link ID

Link ID in the ARP suppression entry. A link ID uniquely identifies an AC or VXLAN tunnel in a VSI.

Aging

Aging time of the ARP suppression entry, in minutes.

 

Related commands

reset arp suppression

reset arp suppression

Use reset arp suppression to clear ARP suppression entries.

Syntax

reset arp suppression [ vsi [ name vsi-name ] | xconnect-group [ name group-name ] ]

Views

User view

Predefined user roles

network-admin

Parameters

vsi: Clears ARP suppression entries for VSIs.

name vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters excluding hyphens (-). If you do not specify a VSI, this command clears ARP suppression entries for all VSIs.

xconnect-group: Clears ARP suppression entries for cross-connect groups.

name group-name: Specifies a cross-connect group by its name, a case-sensitive string of 1 to 31 characters excluding hyphens (-). If you do not specify a cross-connect group, this command clears ARP suppression entries for all cross-connect groups.

Parameters

If you do not specify the vsi or xconnect-group keyword, this command clears ARP suppression entries for all VSIs and cross-connect groups.

Examples

# Clear ARP suppression entries.

<Sysname> reset arp suppression

Related commands

display arp suppression xconnect-group


ARP direct route advertisement commands

arp route-direct advertise

Use arp route-direct advertise to enable ARP direct route advertisement.

Use undo arp route-direct advertise to disable ARP direct route advertisement.

Syntax

arp route-direct advertise

undo arp route-direct advertise

Default

ARP direct route advertisement is disabled.

Views

System view

Layer 3 Ethernet interface view

Layer 3 Ethernet subinterface view

Layer 3 aggregate interface view

Layer 3 aggregate subinterface view

VPN instance view

Predefined user roles

network-admin

Usage guidelines

You can enable ARP direct route advertisement in different views.

·     In system view, the feature takes effect on all interfaces on the public network.

·     In interface view, the feature takes effect on the specified interface.

·     In VPN instance view, the feature takes effect on all interfaces that belong to the VPN instance.

To disable ARP direct route advertisement on an interface, you must also disable ARP direct route advertisement in the VPN instance or the public network to which the interface belongs.

Examples

# Enable ARP direct route advertisement in system view.

<Sysname> system-view

[Sysname] arp route-direct advertise

# Enable ARP direct route advertisement on HundredGigE 1/0/1.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] arp route-direct advertise

# Enable ARP direct route advertisement in VPN instance vpna.

<Sysname> system-view

[Sysname] ip vpn-instance vpna

[Sysname-vpn-instance-vpna] arp route-direct advertise

 

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网