Table of Contents

Related Documents

01-IRF commands

Title	Size	Download
01-IRF commands	122.45 KB

IRF commands

display irf

Use display irf to display IRF fabric information, including the member ID, role, priority, bridge MAC address, and description of each IRF member.

Syntax

display irf

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display IRF fabric information.

<Sysname> display irf

MemberID Role Priority CPU-Mac Description

1 Standby 1 00e0-fc0f-8c02 F1Num001

*+2 Master 1 00e0-fc0f-8c03 F1Num002

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

* indicates the device is the master.

+ indicates the device through which the user logs in.

The Bridge MAC of the IRF is: 00e0-fc00-1000

Auto upgrade : yes

Mac persistent : always

Domain ID : 30

Table 1 Command output

Field	Description
MemberID	IRF member ID: · ID of the master is prefixed with an asterisk (*) sign. · ID of the device where you are logged in is prefixed with a plus (+) sign.
Role	Role of the member device in the IRF fabric: · Standby—Subordinate device. · Master—Master device. · Loading—The device is loading software images.
Priority	IRF member priority.
CPU-MAC	MAC address of the CPU in the device.
Description	Description you have configured for the member device. · If no description is configured, this field displays a dashed line (-----). · If the description exceeds the maximum number of characters that can be displayed, an ellipsis (…) is displayed in place of the exceeding text. To display the complete description, use the display current-configuration command.
The Bridge MAC of the IRF is	Bridge MAC address of the IRF fabric.
Auto upgrade	Status of the software auto-update feature: · yes—Enabled. · no—Disabled.
MAC persistent	IRF bridge MAC persistence setting: · 6 min—Bridge MAC address of the IRF fabric remains unchanged for 6 minutes after the address owner leaves. · always—Bridge MAC address of the IRF fabric does not change after the address owner leaves. · no—Bridge MAC address of the current master replaces the original bridge MAC address as soon as the owner of the original address leaves.
Domain ID	Domain ID of the IRF fabric. The domain ID you assign to an IRF fabric must uniquely identify the fabric in a multi-IRF fabric network.

Related commands

· display irf configuration

· display irf topology

Use display irf configuration to display basic IRF settings, including each member's current member ID, new member ID, and physical interfaces bound to the IRF ports. The new member IDs take effect at reboot.

Syntax

display irf configuration

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display basic IRF settings.

<Sysname> display irf configuration

MemberID NewID IRF-Port1 IRF-Port2

1 1 Ten-GigabitEthernet1/0/49 Ten-GigabitEthernet1/0/51

Ten-GigabitEthernet1/0/50 Ten-GigabitEthernet1/0/52

2 2 Ten-GigabitEthernet2/0/49 Ten-GigabitEthernet2/0/51

Ten-GigabitEthernet2/0/50 Ten-GigabitEthernet2/0/52

3 3 Ten-GigabitEthernet3/0/49 Ten-GigabitEthernet3/0/51

Ten-GigabitEthernet3/0/50 Ten-GigabitEthernet3/0/52

4 4 Ten-GigabitEthernet4/0/49 Ten-GigabitEthernet4/0/51

Ten-GigabitEthernet4/0/50 Ten-GigabitEthernet4/0/52

Table 2 Command output

Field	Description
MemberID	Current member ID of the device.
NewID	Member ID assigned to the device. This member ID takes effect at reboot.
IRF-Port1	Physical interfaces bound to IRF-port 1. The bindings take effect at reboot. This field displays disable if no physical interfaces are bound to the IRF port.
IRF-Port2	Physical interfaces bound to IRF-port 2. The bindings take effect at reboot. This field displays disable if no physical interfaces are bound to the IRF port.

Related commands

· display irf

· display irf topology

display irf link

Use display irf link to display IRF link information, including IRF ports, IRF physical interfaces, and IRF link status.

Syntax

display irf link

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display IRF link information.

<Sysname> display irf link

Member 1

IRF Port Interface Status

1 Ten-GigabitEthernet1/0/49 UP

Ten-GigabitEthernet1/0/50 DOWN

2 disable --

Member 2

IRF Port Interface Status

1 disable --

2 Ten-GigabitEthernet2/0/49 UP

Ten-GigabitEthernet2/0/50 DOWN

Table 3 Command output

Field	Description
Member ID	IRF member ID.
IRF Port	IRF port number: · 1—IRF-port 1. · 2—IRF-port 2.
Interface	Physical interfaces bound to the IRF port. This field displays disable if no physical interfaces have been bound to the IRF port.
Status	Link state of the IRF physical interface: · UP—The link is up. · DOWN—The link is down. · ADM—The interface has been manually shut down by using the shutdown command. · ABSENT—Interface module that hosts the interface is not present.

display irf topology

Use display irf topology to display IRF fabric topology information, including the member IDs, IRF port state, adjacencies of IRF ports, and CPU MAC address of the master.

Syntax

display irf topology

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the IRF fabric topology.

<Sysname> display irf topology

Topology Info

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

IRF-Port1 IRF-Port2

MemberID Link neighbor Link neighbor Belong To

1 DOWN -- UP 2 00e0-fc0f-8c02

2 UP 1 UP 3 00e0-fc0f-8c02

3 UP 2 DIS -- 00e0-fc0f-8c02

Table 4 Command output

Field	Description
IRF-Port1	Information about IRF-port 1, including its link state and neighbor.
IRF-Port2	Information about IRF-port 2, including its link state and neighbor.
MemberID	IRF member ID.
Link	Link state of the IRF port: · UP—The IRF link is up. · DOWN—The IRF link is down because the port has no physical link or has not been activated by the irf-port-configuration active command. · DIS—No physical interfaces have been bound to the IRF port. To bind a physical interface to the IRF port, use the port group interface command. · TIMEOUT—IRF hello interval has timed out.
neighbor	IRF member ID of the device connected to the IRF port. If no device is connected to the port, this field displays two hyphens (--).
Belong To	IRF fabric that has the device, represented by the CPU MAC address of the master in the IRF fabric.

Related commands

· display irf

· display irf configuration

display irf-port load-sharing mode

Use display irf-port load-sharing mode to display IRF link load sharing mode.

Syntax

display irf-port load-sharing mode [ irf-port [ member-id/port-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

irf-port: Displays IRF port-specific load sharing modes. If you do not specify this keyword, the command displays the global load sharing mode for IRF links.

member-id/port-number: Specifies an IRF port number. The member-id argument represents an IRF member ID. The port-number argument represents the index number (1 or 2) of the IRF port on the member device. If you do not specify the member-id and port-number arguments, this command displays the load sharing mode used on each IRF port in the IRF fabric. If no IRF ports are in up state, this command displays No IRF link exists.

Examples

# Display the global load sharing mode for IRF links. In this example, because no user-defined global load sharing mode has been configured, the default global load sharing mode applies.

<Sysname> display irf-port load-sharing mode

irf-port Load-Sharing Mode:

Layer 2 traffic: packet type-based sharing

Layer 3 traffic: packet type-based sharing

# Display the global load sharing mode for IRF links. In this example, because a user-defined global load sharing mode has been configured, the user-defined global load sharing mode applies.

<Sysname> display irf-port load-sharing mode

irf-port Load-Sharing Mode:

destination-ip address source-ip address

# Display the load sharing mode of IRF-port 1/1. In this example, because neither port-specific load sharing mode nor user-defined global load sharing mode has been configured, the default global load sharing mode applies.

<Sysname> display irf-port load-sharing mode irf-port 1/1

irf-port1/1 Load-Sharing Mode:

Layer 2 traffic: packet type-based sharing

Layer 3 traffic: packet type-based sharing

# Display the load sharing mode of IRF-port 1/1 after destination MAC-based load sharing is configured on the port.

<Sysname> display irf-port load-sharing mode irf-port 1/1

irf-port1/1 Load-Sharing Mode:

destination-mac address

Table 5 Command output

Field	Description
irf-port Load-Sharing Mode	Global load sharing mode for IRF links: · If no global IRF link load sharing mode has been configured, the default global load sharing mode applies. · If a user-defined global load sharing mode has been configured, the configured mode applies.
irf-port1/1 Load-Sharing Mode	Link load sharing mode of IRF-port 1/1: · If you have not configured a port-specific load sharing mode, the global IRF link load sharing mode applies. · If you have configured a port-specific load sharing mode, the configured mode applies.
Layer 2 traffic: packet type-based sharing	Default load sharing mode for traffic that has no IP header. By default, this type of traffic is distributed based on packet types.
Layer 3 traffic: packet type-based sharing	Default load sharing mode for non-TCP/-UDP IP packets. By default, this type of traffic is distributed based on packet types.
destination-ip address source-ip address	Configured global load sharing mode. Traffic is distributed based on destination and source IP addresses.
destination-mac address	Configured load sharing mode for IRF-port 1/1. Traffic is distributed based on destination MAC addresses.

display mad

Use display mad to display MAD status and settings.

Syntax

display mad [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

verbose: Displays detailed MAD information. If you do not specify this keyword, the command only displays whether a MAD mechanism is enabled or disabled.

Examples

# Display brief MAD information.

<Sysname> display mad

MAD ARP enabled.

MAD ND enabled.

MAD LACP disabled.

MAD BFD enabled.

# Display detailed MAD information.

<Sysname> display mad verbose

Multi-active recovery state: No

Excluded ports(user-configured):

Vlan-interface999

Excluded ports(system-configured):

Ten-GigabitEthernet1/0/49

Ten-GigabitEthernet1/0/50

Ten-GigabitEthernet2/0/49

Ten-GigabitEthernet2/0/50

MAD ARP enabled interface:

Vlan-interface2

MAD ND enabled interface:

Vlan-interface2

MAD LACP enabled interface: Bridge-Aggregation 1

MAD status : Normal

Member ID Port MAD status

1 GigabitEthernet1/0/1 Normal

2 GigabitEthernet2/0/1 Normal

MAD BFD enabled interface: VLAN-interface 3

MAD status : Faulty

Member ID MAD IP address Neighbor MAD status

1 192.168.1.1/24 2 Normal

1 192.168.1.1/24 3 Normal

2 192.168.1.2/24 1 Normal

2 192.168.1.2/24 3 Normal

3 192.168.1.3/24 1 Normal

3 192.168.1.3/24 2 Normal

Table 6 Command output

Field	Description
Multi-active recovery state	Whether the IRF fabric is in Recovery state: · Yes—The IRF fabric is in Recovery state. When MAD detects that an IRF fabric has split into multiple IRF fabrics, it allows one fabric to forward traffic. All the other IRF fabrics are set to the Recovery state. In Recovery state, MAD shuts down all physical network ports in the fabric except for the IRF physical interfaces and ports configured to not shut down. · No—The IRF fabric is not in Recovery state. It is active and can forward traffic.
Excluded ports(user-configured)	Ports manually configured to not shut down when the IRF fabric transitions to the Recovery state.
Excluded ports(system-configured)	Ports set to not shut down by default when the IRF fabric transitions to the Recovery state. These ports are not user configurable.
MAD ARP enabled interface:	Interfaces on which ARP MAD is enabled.
MAD ND enabled interface:	Interfaces on which ND MAD is enabled.
MAD LACP enabled interface	Interface on which LACP MAD is enabled. This field is displayed for each interface enabled with LACP MAD.
MAD status	LACP MAD operating status: · Normal—LACP MAD is operating correctly. · Faulty—LACP MAD is not operating correctly. Verify the following items: ? Verify that the ports on LACP MAD links are up. ? Verify that the intermediate device supports extended LACPDUs. ? Verify that all member devices have member ports used for LACP MAD.
Member ID Port MAD status	LACP MAD details: · Member ID—IRF member ID of a device. · Port—Member ports of the aggregate interface used for LACP MAD. · MAD status—LACP MAD operating state on a member port. Options include Normal and Faulty.
MAD BFD enabled interface:	Layer 3 interface on which BFD MAD is enabled.
MAD status	BFD MAD operating status: · Normal—BFD MAD is operating correctly. · Faulty—BFD MAD is not operating correctly. Check the BFD MAD link connectivity. · N/A—BFD MAD link status cannot be detected. If BFD MAD is enabled on a management Ethernet port, it is normal that this field displays N/A.
Member ID MAD IP address Neighbor MAD status	BFD MAD details: · Member ID—IRF member ID of the local device. · MAD IP address—MAD IP address of a member device. · Neighbor—IRF member ID of the neighboring member device. · MAD status—BFD MAD link state. Options include Normal and Faulty.

irf auto-update enable

Use irf auto-update enable to enable the software auto-update feature.

Use undo irf auto-update enable to disable the software auto-update feature.

Syntax

irf auto-update enable

undo irf auto-update enable

Default

Software auto-update is enabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

This command automatically propagates the current software images of the master device in the IRF fabric to any devices you are adding to the IRF fabric.

To ensure a successful software update, verify that the new device you are adding to the IRF fabric has sufficient storage space for the new software images. If sufficient storage space is not available, the device automatically deletes the current software images. If the reclaimed space is still insufficient, the device cannot complete the auto-update. You must reboot the device, and then access the Boot menus to delete files.

You must manually update the new device with the software images running on the IRF fabric in the following situations:

· Software auto-update is disabled.

· Software auto-update fails to update software. This situation might occur if the IRF fabric cannot identify the software version used on the new device.

Examples

# Enable the software auto-update feature.

<Sysname> system-view

[Sysname] irf auto-update enable

irf domain

Use irf domain to assign a domain ID to the IRF fabric.

Use undo irf domain to restore the default IRF domain setting.

Syntax

irf domain domain-id

undo irf domain

Default

The IRF domain ID is 0.

Views

System view

Predefined user roles

network-admin

Parameters

domain-id: Specifies a domain ID for the IRF fabric. The value range is 0 to 4294967295.

Usage guidelines

One IRF fabric forms one IRF domain. IRF uses IRF domain IDs to uniquely identify IRF fabrics and prevent IRF fabrics from interfering with one another.

If one IRF fabric uses another IRF fabric as the intermediate device for LACP MAD, ARP MAD, or ND MAD, you must assign the two IRF fabrics different domain IDs for correct split detection. False detection causes IRF split.

An IRF fabric has only one IRF domain ID. You can change the IRF domain ID by using the following commands: irf domain, mad enable, mad arp enable, or mad nd enable. The IRF domain IDs configured by using these commands overwrite each other.

Examples

# Set the IRF domain ID to 10.

<Sysname> system-view

[Sysname] irf domain 10

irf link-delay

Use irf link-delay to set a delay for the IRF ports to report a link down event.

Use undo irf link-delay to restore the default.

Syntax

irf link-delay interval

undo irf link-delay

Default

The IRF link down report delay is 4 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Sets the IRF link down report delay in the range of 0 to 10000 milliseconds. If the interval is set to 0, link down events are reported without any delay.

Usage guidelines

When you configure the IRF link down report delay, follow these restrictions and guidelines:

· Make sure the IRF link down report delay is shorter than the heartbeat or hello timeout settings of upper-layer protocols (for example, CFD, VRRP, and OSPF). If the report delay is longer than the timeout setting of a protocol, unnecessary recalculations might occur.

· Set the delay to 0 seconds in the following situations:

? The IRF fabric requires a fast master/subordinate or IRF link switchover.

? The BFD or GR feature is used.

? You want to shut down an IRF physical interface or reboot an IRF member device. (After you complete the operation, reconfigure the delay depending on the network condition.)

Examples

# Set the IRF link down report delay to 300 milliseconds.

<Sysname> system-view

[Sysname] irf link-delay 300

irf mac-address persistent

Use irf mac-address persistent to configure IRF bridge MAC persistence.

Use undo irf mac-address persistent to enable the IRF fabric to change its bridge MAC address as soon as the address owner leaves.

Syntax

irf mac-address persistent { always | timer }

undo irf mac-address persistent

Default

After the address owner leaves, the IRF fabric continues using its bridge MAC address as the IRF bridge MAC address for 6 minutes. If the owner does not rejoin the IRF fabric within the time limit, the IRF fabric uses the bridge MAC address of the current master as the bridge MAC address.

Views

System view

Predefined user roles

network-admin

Parameters

always: Enables the IRF bridge MAC address to be permanent. The IRF bridge MAC address does not change after the address owner leaves.

timer: Enables the IRF bridge MAC address to remain unchanged for 6 minutes after the address owner leaves. If the address owner rejoins the IRF fabric within the time limit, the IRF bridge MAC address does not change. If the address owner does not rejoin within the time limit, the IRF fabric uses the bridge MAC address of the current master as the bridge MAC address.

Usage guidelines

IRF bridge MAC persistence specifies the amount of time an IRF fabric can continue to use a bridge MAC address as its bridge MAC address after the address owner leaves.

If ARP MAD or ND MAD is used with the spanning tree feature, use the undo irf mac-address persistent command to disable IRF bridge MAC persistence.

Use the irf mac-address persistent always command when the following conditions are met:

· The IRF fabric uses a daisy-chain topology.

· The IRF fabric has aggregate links with upstream or downstream devices.

The persistence setting prevents transmission delay or packet loss after the address owner leaves.

By default, an IRF fabric uses the bridge MAC address of the master device as its bridge MAC address. Layer 2 protocols, such as LACP, use this bridge MAC address to identify the IRF fabric. On a switched LAN, the bridge MAC address must be unique.

To avoid duplicate bridge MAC addresses, an IRF fabric can change its bridge MAC address automatically after the address owner leaves. However, the change causes temporary service disruption. Depending on the network condition, you can enable the IRF fabric to preserve or change its bridge MAC address after the address owner leaves.

When IRF fabrics merge, IRF ignores the IRF bridge MAC address and checks the bridge MAC address of each member device in the IRF fabrics. IRF merge fails if any two member devices have the same bridge MAC address.

Examples

# Enable the IRF bridge MAC address to persist forever.

<Sysname> system-view

[Sysname] irf mac-address persistent always

irf member description

Use irf member description to configure a description for an IRF member.

Use undo irf member description to restore the default.

Syntax

irf member member-id description text

undo irf member member-id description

Default

No description is configured for any IRF member.

Views

System view

Predefined user roles

network-admin

Parameters

member-id: Specifies the ID of an IRF member.

text: Configures the IRF member description, a string of 1 to 127 characters.

Usage guidelines

Configure a description to describe the location or purpose of a member device.

Examples

# Configure a description for IRF member 1.

<Sysname> system-view

[Sysname] irf member 1 description F1Num001

irf member priority

Use irf member priority to change the priority of an IRF member.

Use undo irf member priority to restore the default.

Syntax

irf member member-id priority priority

undo irf member member-id priority

Default

IRF member priority is 1.

Views

System view

Predefined user roles

network-admin

Parameters

member-id: Specifies an IRF member ID.

priority: Sets priority in the range of 1 to 32. The greater the priority value, the higher the priority. A member with higher priority is more likely to be the master.

Usage guidelines

To display the ID and priority settings of IRF members, use the display irf command.

Examples

# Set the priority of IRF member 2 to 32.

<Sysname> system-view

[Sysname] irf member 2 priority 32

irf member renumber

Use irf member renumber to change the IRF member ID of a device.

Use undo irf member renumber to restore the previous IRF member ID of the device.

Syntax

irf member member-id renumber new-member-id

undo irf member member-id renumber

Default

IRF member ID is 1.

Views

System view

Predefined user roles

network-admin

Parameters

member-id: Specifies the ID of an IRF member, in the range of 1 to 10.

new-member-id: Assigns a new ID to the IRF member, in the range of 1 to 10.

Usage guidelines

CAUTION:

IRF member ID change can cause losses of member ID-related configurations at reboot, including settings on physical interfaces.

To have the new ID take effect, you must reboot the IRF member.

When adding a device into an IRF fabric, you must assign a unique IRF member ID to the device. If its IRF member ID has been used in the IRF fabric, the device cannot join the IRF fabric.

Plan IRF member ID assignment before setting up an IRF fabric, and change member IDs before configuring any other features.

Interchanging member IDs between IRF member devices might cause undesirable configuration changes and data loss. For example, the IRF member IDs of Device A and Device B are 2 and 3, respectively. After you interchange their member IDs, their port settings also interchange.

After an IRF fabric is formed, make sure you understand the impact of the member ID change on the network.

Examples

# Change the ID of an IRF member from 1 to 3.

<Sysname> display irf

[Sysname] irf member 1 renumber 3

Warning: Renumbering the member ID may result in configuration change or loss. Continue?[Y/N]:Y

irf-port

Use irf-port to enter IRF port view.

Use undo irf-port to remove all port bindings on an IRF port.

Syntax

irf-port member-id/port-number

undo irf-port member-id/port-number

Views

System view

Predefined user roles

network-admin

Parameters

member-id/port-number: Specifies an IRF port on an IRF member. The member-id argument represents the ID of the IRF member. The port-number argument represents the IRF port index and must be 1 or 2.

Usage guidelines

To bind physical interfaces to an IRF port, you must enter IRF port view.

Before you remove all port bindings on an IRF port, shut down all its physical interfaces.

Examples

# Bind Ten-GigabitEthernet 3/0/49 to IRF-port 3/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/49

[Sysname-Ten-GigabitEthernet3/0/49] shutdown

[Sysname-Ten-GigabitEthernet3/0/49] quit

[Sysname] irf-port 3/1

[Sysname-irf-port3/1] port group interface ten-gigabitethernet 3/0/49

[Sysname-irf-port3/1] quit

[Sysname] interface ten-gigabitethernet 3/0/49

[Sysname-Ten-GigabitEthernet3/0/49] undo shutdown

Related commands

port group interface

irf-port global load-sharing mode

Use irf-port global load-sharing mode to set the global load sharing mode for IRF links.

Use undo irf-port global load-sharing mode to restore the default.

Syntax

irf-port global load-sharing mode { destination-ip | destination-mac | source-ip | source-mac } *

undo irf-port global load-sharing mode

Default

Packets are distributed across IRF member links automatically based on their packet types.

Views

System view

Predefined user roles

network-admin

Parameters

destination-ip: Distributes traffic across IRF member links based on destination IP address.

destination-mac: Distributes packets across IRF member links based on destination MAC address.

source-ip: Distributes packets across IRF member links based on source IP address.

source-mac: Distributes packets across IRF member links based on source MAC address.

Usage guidelines

The global IRF link load sharing mode applies to all IRF ports in the IRF fabric. You can configure the sharing mode to include a combination of multiple criteria for making traffic distribution decisions. (For example, criteria could include source MAC address and IP address.) If your device does not support a criterion combination, the system displays an error message.

If you configure the global load sharing mode multiple times, the most recent configuration takes effect.

You can also configure a port-specific load sharing mode for an IRF port in IRF port view.

An IRF port preferentially uses the port-specific load sharing mode. If no port-specific load sharing mode is available, the port uses the global load sharing mode.

Examples

# Configure the global IRF link load sharing mode to distribute traffic based on destination MAC address.

<Sysname> system-view

[Sysname] irf-port global load-sharing mode destination-mac

Related commands

irf-port load-sharing mode

Use irf-port load-sharing mode to configure a port-specific load sharing mode for an IRF port to distribute traffic across its physical links.

Use undo irf-port load-sharing mode to restore the default.

Syntax

irf-port load-sharing mode { destination-ip | destination-mac | source-ip | source-mac } *

undo irf-port load-sharing mode

Default

The global IRF link load sharing mode applies.

Views

IRF port view

Predefined user roles

network-admin

Parameters

destination-ip: Distributes traffic across IRF member links based on destination IP address.

destination-mac: Distributes packets across IRF member links based on destination MAC address.

source-ip: Distributes packets across IRF member links based on source IP address.

source-mac: Distributes packets across IRF member links based on source MAC address.

Usage guidelines

To successfully configure a port-specific load sharing mode for an IRF port, make sure you have bound a minimum of one physical interface to the IRF port.

You can configure an IRF port-specific load sharing mode to include a combination of multiple criteria for making traffic distribution decisions. For example, criteria could include source MAC address and IP address. If your device does not support a criterion combination, the system displays an error message.

If you configure the port-specific load sharing mode multiple times on an IRF port, the most recent configuration takes effect.

An IRF port preferentially uses the port-specific load sharing mode. If no port-specific load sharing mode is available, the port uses the global load sharing mode.

Examples

# Configure a port-specific load sharing mode for IRF-port 1/1 to distribute traffic based on destination MAC address.

<Sysname> system-view

[Sysname] irf-port 1/1

[Sysname-irf-port1/1] irf-port load-sharing mode destination-mac

irf-port-configuration active

Use irf-port-configuration active to activate IRF ports.

Syntax

irf-port-configuration active

Views

System view

Predefined user roles

network-admin

Usage guidelines

After connecting the physical interfaces between two devices and binding them to the correct IRF ports, you must use this command to activate the settings on the IRF ports. This command merges the two devices into one IRF fabric.

Activating IRF port settings can cause an IRF merge and device reboot. To avoid configuration loss, use the following procedure to set up your IRF fabric:

1. Plan the IRF setup, including the IRF fabric topology, IRF fabric size, member ID assignment, and bindings of physical interfaces and IRF ports.

2. Change the IRF member ID of each device to make sure they are unique in the IRF fabric.

3. Connect the physical interfaces between neighboring devices and make sure the peer interfaces can ping each other.

4. Bind the physical interfaces to the IRF ports on each device.

5. Save the configuration to the startup configuration file on each device.

6. Activate the IRF ports on each device.

The system activates the IRF port settings automatically in the following situations:

· The configuration file that the device starts with contains IRF port bindings.

· You are binding physical interfaces to an IRF port after an IRF fabric is formed.

Examples

To configure and activate IRF-port 1/2:

# Bind Ten-GigabitEthernet 1/0/27 to IRF-port 1/2.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 1/0/27

[Sysname-Ten-GigabitEthernet1/0/27] shutdown

[Sysname-Ten-GigabitEthernet1/0/27] quit

[Sysname] irf-port 1/2

[Sysname-irf-port1/2] port group interface Ten-GigabitEthernet 1/0/27

You must perform the following tasks for a successful IRF setup:

Save the configuration after completing IRF configuration.

Execute the "irf-port-configuration active" command to activate the IRF ports.

[Sysname-irf-port1/2] quit

[Sysname] interface ten-gigabitethernet 1/0/27

[Sysname-Ten-GigabitEthernet1/0/27] undo shutdown

[Sysname-Ten-GigabitEthernet1/0/27] quit

# Save the configuration so the IRF port settings can take effect after the device reboots.

[Sysname] save

The current configuration will be written to the device. Are you sure? [Y/N]:y

Please input the file name(*.cfg)[flash:/startup.cfg]

(To leave the existing filename unchanged, press the enter key):

flash:/startup.cfg exists, overwrite? [Y/N]:y

Validating file. Please wait............................

Saved the current configuration to mainboard device successfully.

# Activate the IRF port.

[Sysname] irf-port-configuration active

mad arp enable

Use mad arp enable to enable ARP MAD.

Use undo mad arp enable to disable ARP MAD.

Syntax

mad arp enable

undo mad arp enable

Default

ARP MAD is disabled.

Views

Management Ethernet interface view, VLAN interface view

Predefined user roles

network-admin

Usage guidelines

ARP MAD detects multi-active collisions by using extended ARP packets.

You can use ARP MAD with BFD MAD and ND MAD, but not with LACP MAD.

When you configure ARP MAD that uses common Ethernet ports, follow these restrictions and guidelines:

Category	Restrictions and guidelines
ARP MAD VLAN	· Do not enable ARP MAD on VLAN-interface 1. · If you are using an intermediate device, perform the following tasks on both the IRF fabric and the intermediate device: ? Create a VLAN and VLAN interface for ARP MAD. ? Assign the ports of ARP MAD links to the ARP MAD VLAN. · As a best practice, do not use the ARP MAD VLAN for any other purposes.
ARP MAD and feature configuration	If an intermediate device is used, make sure the following requirements are met: · Run the spanning tree feature between the IRF fabric and the intermediate device to ensure that there is only one ARP MAD link in forwarding state. For more information about the spanning tree feature and its configuration, see Layer 2—LAN Switching Configuration Guide. · Enable the IRF fabric to change its bridge MAC address as soon as the address owner leaves. · If the intermediate device is also an IRF fabric, assign the two IRF fabrics different domain IDs for correct split detection.

Category	Restrictions and guidelines
Management Ethernet ports for ARP MAD	Connect a management Ethernet port on each member device to the common Ethernet ports on the intermediate device.
ARP MAD VLAN	On the intermediate device, create a VLAN for ARP MAD, and assign the ports used for ARP MAD to the VLAN. On the IRF fabric, you do not need to assign the management Ethernet ports to the VLAN.
ARP MAD and feature configuration	· Enable the IRF fabric to change its bridge MAC address as soon as the address owner leaves. · If the intermediate device is also an IRF fabric, assign the two IRF fabrics different domain IDs for correct split detection.

mad bfd enable

Use mad bfd enable to enable BFD MAD.

Use undo mad bfd enable to disable BFD MAD.

Syntax

mad bfd enable

undo mad bfd enable

Default

BFD MAD is disabled.

Views

Management Ethernet interface view, VLAN interface view

Predefined user roles

network-admin

Usage guidelines

BFD MAD uses the BFD protocol to detect multi-active collisions. This MAD mechanism can work with or without an intermediate device.

You can use BFD MAD with ARP MAD and ND MAD, but not with LACP MAD.

When you configure BFD MAD that uses common Ethernet ports, follow these restrictions and guidelines:

Category	Restrictions and guidelines
BFD MAD VLAN	· Do not enable BFD MAD on VLAN-interface 1. · If you are using an intermediate device, perform the following tasks on both the IRF fabric and the intermediate device: ? Create a VLAN and VLAN interface for BFD MAD. ? Assign the ports of BFD MAD links to the BFD MAD VLAN. · Make sure the IRF fabrics on the network use different BFD MAD VLANs. · Make sure the BFD MAD VLAN contains only ports on the BFD MAD links. Exclude a port from the BFD MAD VLAN if the port is not on the BFD MAD link. For example, if you have assigned the port to all VLANs by using the port trunk permit vlan all command, use the undo port trunk permit command to exclude the port from the BFD MAD VLAN.
BFD MAD VLAN and feature compatibility	Do not use the BFD MAD VLAN for any purpose other than configuring BFD MAD. · Use only the mad bfd enable and mad ip address commands on the VLAN interface used for BFD MAD. If you configure other features, both BFD MAD and other features on the interface might run incorrectly. · Disable the spanning tree feature on all Layer 2 Ethernet ports in the BFD MAD VLAN. The MAD feature is mutually exclusive with the spanning tree feature.
MAD IP address	· Use the mad ip address command instead of the ip address command to configure MAD IP addresses on the BFD MAD-enabled VLAN interface. · Make sure all the MAD IP addresses are on the same subnet.

When you configure BFD MAD that uses management Ethernet ports, follow these restrictions and guidelines:

Category	Restrictions and guidelines
Management Ethernet ports for BFD MAD	Connect a management Ethernet port on each member device to the common Ethernet ports on the intermediate device.
BFD MAD VLAN	· On the intermediate device, create a VLAN for BFD MAD, and assign the ports used for BFD MAD to the VLAN. On the IRF fabric, you do not need to assign the management Ethernet ports to the VLAN. · Make sure the IRF fabrics on the network use different BFD MAD VLANs. · Make sure the BFD MAD VLAN on the intermediate device contains only ports on the BFD MAD links.
MAD IP address	· Use the mad ip address command instead of the ip address command to configure MAD IP addresses on the BFD MAD-enabled management Ethernet ports. · Make sure all the MAD IP addresses are on the same subnet.

Examples

# Enable BFD MAD on VLAN-interface 3.

<Sysname> system-view

[Sysname] interface vlan-interface 3

[Sysname-Vlan-interface3] mad bfd enable

mad enable

Use mad enable to enable LACP MAD.

Use undo mad enable to disable LACP MAD.

Syntax

mad enable

undo mad enable

Default

LACP MAD is disabled.

Views

Aggregate interface view

Predefined user roles

network-admin

Usage guidelines

LACP MAD uses extended LACP packets to detect multi-active collisions. This MAD mechanism requires an intermediate device that supports extended LACP packets.

LACP MAD handles collisions differently than BFD MAD, ARP MAD, and ND MAD. To avoid conflicts, do not enable LACP MAD together with any of those mechanisms in an IRF fabric. However, you can use BFD MAD, ARP MAD, and ND MAD together.

You must set up a dynamic link aggregation group that spans all IRF member devices between the IRF fabric and the intermediate device. To enable dynamic link aggregation, configure the link-aggregation mode dynamic command on the aggregate interface.

If one IRF fabric uses another IRF fabric as the intermediate device for LACP MAD, you must assign the two IRF fabrics different domain IDs for correct split detection. False detection causes IRF split.

When you use the mad enable command, the system prompts you to enter a domain ID. If you do not want to change the current domain ID, press enter at the prompt.

Examples

# Enable LACP MAD on Bridge-Aggregation 1, a Layer 2 dynamic aggregate interface.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] link-aggregation mode dynamic

[Sysname-Bridge-Aggregation1] mad enable

You need to assign a domain ID (range: 0-4294967295)

[Current domain is: 0]: 1

The assigned domain ID is: 1

MAD LACP only enable on dynamic aggregation interface.

# Enable LACP MAD on Route-Aggregation 1, a Layer 3 dynamic aggregate interface.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] link-aggregation mode dynamic

[Sysname-Route-Aggregation1] mad enable

You need to assign a domain ID (range: 0-4294967295)

[Current domain is: 0]: 1

The assigned domain ID is: 1

MAD LACP only enable on dynamic aggregation interface.

Related commands

irf domain

mad exclude interface

Use mad exclude interface to exclude a physical network port from being shut down when the IRF fabric transits to the Recovery state upon detection of a multi-active collision.

Use undo mad exclude interface to restore the default MAD action on a physical network port.

Syntax

mad exclude interface interface-type interface-number

undo mad exclude interface interface-type interface-number

Default

All physical ports except the IRF physical interfaces and console ports shut down when the IRF fabric transits to the Recovery state.

Views

System view

Predefined user roles

network-admin

Parameters

interface-type interface-number: Specifies a port by its type and number.

Usage guidelines

If a port must be kept in up state for special purposes such as Telnet connection, exclude the port from the shutdown action. As a best practice, do not exclude any ports except for the ports used for Telnet and MAD to avoid incorrect traffic forwarding.

The ports that have been shut down by MAD come up when the member devices reboot to join the recovered IRF fabric. If auto recovery fails because the current master fails or any other exception occurs, use the mad restore command to manually recover the member devices and bring up the ports.

Examples

# Exclude GigabitEthernet 2/0/1 from being shut down when the MAD status transits to Recovery.

<Sysname> system-view

[Sysname] mad exclude interface gigabitethernet 2/0/1

Related commands

mad restore

mad ip address

Use mad ip address to assign a MAD IP address to an IRF member device for BFD MAD.

Use undo mad ip address to delete a MAD IP address.

Syntax

mad ip address ip-address { mask | mask-length } member member-id

undo mad ip address ip-address { mask | mask-length } member member-id

Default

No MAD IP address is configured for an IRF member device.

Views

Management Ethernet interface view, VLAN interface view

Predefined user roles

network-admin

Parameters

ip-address: Specifies an IP address in dotted decimal notation. This IP address is bound to an IRF member for BFD detection and is called a MAD IP address.

mask: Specifies a subnet mask in decimal dotted notation.

mask-length: Specifies a subnet mask in length, in the range of 0 to 32.

member member-id: Specifies the ID of an IRF member.

Usage guidelines

To use BFD MAD, configure a MAD IP address for each IRF member. Make sure all the MAD IP addresses are on the same subnet.

To avoid problems, only use the mad ip address command to configure MAD IP addresses. Do not configure a MAD IP address by using other commands (for example, the ip address command).

The master attempts to establish BFD sessions with other member devices by using its MAD IP address as the source IP address.

· If the IRF fabric is integrated, only the MAD IP address of the master takes effect. The master cannot establish a BFD session with any other member. If you execute the display bfd session command, the state of the BFD sessions is Down.

· When the IRF fabric splits, the IP addresses of the masters in the partitioned IRF fabrics take effect. The masters can establish a BFD session. If you execute the display bfd session command, the state of the BFD session between the two devices is Up.

Examples

# Assign a MAD IP address to IRF member 1 on VLAN-interface 3.

<Sysname> system-view

[Sysname] interface vlan-interface 3

[Sysname-Vlan-interface3] mad ip address 192.168.0.1 255.255.255.0 member 1

# Assign a MAD IP address to IRF member 2 on VLAN-interface 3.

[Sysname-Vlan-interface3] mad ip address 192.168.0.2 255.255.255.0 member 2

Related commands

mad bfd enable

mad nd enable

Use mad nd enable to enable ND MAD.

Use undo mad nd enable to disable ND MAD.

Syntax

mad nd enable

undo mad nd enable

Default

ND MAD is disabled.

Views

VLAN interface view

Predefined user roles

network-admin

Usage guidelines

ND MAD uses extended NS packets of the IPv6 ND protocol to detect multi-active collisions.

You can use ND MAD with BFD MAD and ARP MAD, but not with LACP MAD.

Do not configure ND MAD on VLAN-interface 1.

You can set up ND MAD links between neighbor IRF member devices, or between each IRF member device and an intermediate device.

If one IRF fabric uses another IRF fabric as the intermediate device for ND MAD, you must assign the two IRF fabrics different domain IDs for correct split detection. False detection causes IRF split.

When you use the mad nd enable command, the system prompts you to enter a domain ID. If you do not want to change the current domain ID, press enter at the prompt.

Examples

# Enable ND MAD on VLAN-interface 3.

<Sysname> system-view

[Sysname] interface vlan-interface 3

[Sysname-Vlan-interface3] mad nd enable

You need to assign a domain ID (range: 0-4294967295)

[Current domain is: 0]: 1

The assigned domain ID is: 1

Related commands

irf domain

mad restore

Use mad restore to restore the normal MAD state of the IRF fabric in Recovery state.

Syntax

mad restore

Views

System view

Predefined user roles

network-admin

Usage guidelines

If the active IRF fabric has failed to work before the IRF split problem is fixed, use this command to restore an IRF fabric in Recovery state. The recovered IRF fabric will take over the active IRF fabric role.

Examples

# Restore the normal MAD state of the IRF fabric in Recovery state.

<Sysname> system-view

[Sysname] mad restore

This command will restore the device from multi-active conflict state. Continue? [Y/N]:Y

Restoring from multi-active conflict state, please wait...

port group interface

Use port group interface to bind a physical interface to an IRF port.

Use undo port group interface to remove the binding of a physical interface and an IRF port.

Syntax

port group interface interface-type interface-number

undo port group interface interface-name

Default

No physical interfaces are bound to an IRF port.

Views

IRF port view

Predefined user roles

network-admin

Parameters

interface-type interface-number: Specifies a physical interface by its type and number.

interface-name: Specifies a physical interface in the interface-typeinterface-number format. No space is allowed between the interface-type and interface-number arguments.

Usage guidelines

Bind a minimum of one physical interface to an IRF port for setting up an IRF connection. You can bind a maximum of four physical interfaces to an IRF port.

Use the shutdown command to shut down all ports in a port group before you bind them to or remove them from IRF ports. After the binding or binding removal operation is complete, use the undo shutdown command to bring up all the ports. For more information about IRF physical interface binding requirements, see IRF Configuration Guide.

The system does not dynamically remove IRF port bindings when IRF links are lost, for example, because an expansion interface card is removed. To remove IRF port bindings, you must use the undo port group interface command.

Examples

# Bind Ten-GigabitEthernet 3/0/49 through Ten-GigabitEthernet 3/0/50 to IRF-port 3/1 on IRF member 3.

<Sysname> system-view

[Sysname] interface range ten-gigabitethernet 3/0/49 to ten-gigabitethernet 3/0/50

[Sysname-if-range] shutdown

[Sysname-if-range] quit

[Sysname] irf-port 3/1

[Sysname-irf-port3/1] port group interface ten-gigabitethernet 3/0/49

[Sysname-irf-port3/1] port group interface ten-gigabitethernet 3/0/50

[Sysname-irf-port3/1] quit

[Sysname] interface range ten-gigabitethernet 3/0/49 to ten-gigabitethernet 3/0/50

[Sysname-if-range] undo shutdown

02-IRF Command Reference

IRF commands

irf link-delay

irf member description

irf member priority

irf member renumber

irf-port

mad arp enable

mad enable

mad exclude interface

mad ip address

port group interface

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us