Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 01-IRF commands | 132.35 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
display irf configuration
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
2 2 Ten-GigabitEthernet2/0/25 Ten-GigabitEthernet2/0/26
5 5 Ten-GigabitEthernet5/0/25 Ten-GigabitEthernet5/0/26
Ten-GigabitEthernet5/0/27
Ten-GigabitEthernet5/0/28
8 8 Ten-GigabitEthernet8/0/25 Ten-GigabitEthernet8/0/26
Ten-GigabitEthernet8/0/27
Ten-GigabitEthernet8/0/28
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/33 UP
Ten-GigabitEthernet1/0/34 DOWN
Ten-GigabitEthernet1/0/35 DOWN
Ten-GigabitEthernet1/0/36 DOWN
2 disable --
Member 2
IRF Port Interface Status
1 disable --
2 Ten-GigabitEthernet2/0/33 UP
Ten-GigabitEthernet2/0/34 DOWN
Ten-GigabitEthernet2/0/35 DOWN
Ten-GigabitEthernet2/0/36 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.
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.
Usage guidelines
To display the global load sharing mode for IRF links, execute this command without any keywords or arguments.
To display the load sharing mode used on each IRF port in the IRF fabric, specify the irf-port keyword but not any IRF port. If no IRF ports are in up state, this command displays No IRF link exists.
To display the load sharing mode used on a specific IRF port, specify both the irf-port keyword and the member-id/port-number argument.
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 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. |
|
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/45
Ten-GigabitEthernet1/0/46
Ten-GigabitEthernet1/0/47
Ten-GigabitEthernet1/0/48
Ten-GigabitEthernet2/0/45
Ten-GigabitEthernet2/0/46
Ten-GigabitEthernet2/0/47
Ten-GigabitEthernet2/0/48
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 Ten-GigabitEthernet1/0/1 Normal
2 Ten-GigabitEthernet2/0/1 Normal
MAD BFD enabled interface: VLAN-interface 3
MAD status : Normal
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 |
|
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. |
|
|
Ports manually configured to not shut down when the IRF fabric transitions to the Recovery state. |
|
|
Ports set to not shut down by default when the IRF fabric transitions to the Recovery state. These ports are not user configurable. |
|
|
· Normal—The MAD mechanism is operating correctly. · Faulty—The MAD mechanism is not operating correctly. Check the interface or port for connectivity or configuration problems (for example, you can check whether all member devices have member ports used for LACP MAD). · N/A—MAD link status cannot be detected. This field always displays N/A if BFD MAD is enabled on a management Ethernet port. |
|
|
Member ID |
IRF member ID of the local device. |
|
Port |
Member ports of the aggregate interface used for LACP MAD. |
|
Neighbor |
IRF member ID of the neighbor member device. |
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, FCoE, 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
Use irf mac-address to specify a MAC address as the IRF bridge MAC address.
Use undo irf mac-address to restore the default.
Syntax
irf mac-address mac-address
undo irf mac-address
Default
An IRF fabric uses the bridge MAC address of the master device as the IRF bridge MAC address.
Views
System view
Predefined user roles
network-admin
Parameters
mac-address: Specifies a MAC address in the format of H-H-H. The MAC address cannot be the all-zero or all-F MAC address, or a multicast MAC address. You can omit the consecutive zeros at the beginning of each segment. For example, you can enter f-e2-1 for 000f-00e2-0001.
Usage guidelines
|
|
CAUTION: IRF bridge MAC address change causes transient traffic disruption. |
On a switched LAN, the IRF bridge MAC address must be unique.
After you specify an IRF bridge MAC address, the IRF fabric always uses the specified address unless you specify another IRF bridge MAC address or bridge MAC persistence takes effect.
You can specify the bridge MAC address of an existing IRF fabric for a new IRF fabric to replace the existing IRF fabric with transient packet loss.
When IRF fabrics merge, IRF ignores the configured IRF bridge MAC address and checks the bridge MAC address of each member device in the IRF fabrics. IRF merge fails if any of the member devices have the same bridge MAC address.
After IRF fabrics merge, the merged IRF fabric uses the bridge MAC address of the merging IRF fabric who won the master election as the IRF bridge MAC address.
If an IRF fabric splits after you configure the IRF bridge MAC address, both the split IRF fabrics use the configured bridge MAC address as the IRF bridge MAC address.
Examples
# Configure the IRF fabric to use c4ca-d9e0-8c3c as the IRF bridge MAC address.
<Sysname> system-view
[Sysname] irf mac-address c4ca-d9e0-8c3c
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 using a bridge MAC address as its bridge MAC address after the address owner leaves.
This command does not take effect if the IRF bridge MAC address is configured by using the irf mac-address mac-address command.
Depending on the network condition, enable the IRF fabric to retain or change its bridge MAC address after the address owner leaves.
If ARP MAD or ND MAD is used, disable IRF bridge MAC persistence by using the undo irf mac-address persistent command..
Configure the irf mac-address persistent always command or the irf mac-address mac-address command in the following situations:
· TRILL is configured. The command setting avoids unnecessary traffic disruption caused by IRF bridge MAC address changes on the TRILL network.
· The IRF fabric uses a daisy-chain topology, and it has aggregate links with upstream or downstream devices. The persistence setting prevents transmission delay or packet loss after the address owner leaves.
On a switched LAN, the bridge MAC address must be unique for correct traffic transmission.
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 of the 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 device.
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 an IRF member device.
Views
System view
Predefined user roles
network-admin
Parameters
member-id: Specifies an IRF member device by its ID.
text: Specifies a 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 device.
Use undo irf member priority to restore the default.
Syntax
irf member member-id priority priority
undo irf member member-id priority
Default
The IRF member priority is 1.
Views
System view
Predefined user roles
network-admin
Parameters
member-id: Specifies an IRF member device by its ID.
priority: Specifies a 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
The IRF member ID is 1.
Views
System view
Predefined user roles
network-admin
Parameters
member-id: Specifies an IRF member device by its ID, in the range of 1 to 10.
new-member-id: Assigns a new ID to the IRF member device, 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 device 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 device. The member-id argument represents the ID of the IRF member device. 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/48 to IRF-port 3/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/0/48
[Sysname-Ten-GigabitEthernet3/0/48] shutdown
[Sysname-Ten-GigabitEthernet3/0/48] quit
[Sysname] irf-port 3/1
[Sysname-irf-port3/1] port group interface ten-gigabitethernet 3/0/48
[Sysname-irf-port3/1] quit
[Sysname] interface ten-gigabitethernet 3/0/48
[Sysname-Ten-GigabitEthernet3/0/48] 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 use the irf-port load-sharing mode command to 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
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. To set the global load sharing mode, use the irf-port global load-sharing mode command.
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.
Do not configure ARP MAD together with LACP MAD, because they handle collisions differently.
Do not configure ARP MAD together with BFD MAD if common Ethernet ports are used for MAD. ARP MAD requires the spanning tree feature, but BFD MAD is mutually exclusive with the spanning tree feature.
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. · 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. |
When you configure ARP MAD that uses management Ethernet ports, follow these restrictions and guidelines:
|
Category |
Restrictions and guidelines |
|
Ports on the intermediate device for ARP MAD |
Use common Ethernet ports on the intermediate device to connect the management Ethernet ports on the IRF fabric. |
|
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. |
When you use the mad arp 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.
|
|
NOTE: 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
# Enable ARP MAD on VLAN-interface 3.
<Sysname> system-view
[Sysname] interface vlan-interface 3
[Sysname-Vlan-interface3] mad arp 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 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 intermediate devices.
Do not configure BFD MAD together with LACP MAD, because they handle collisions differently.
Do not configure BFD MAD together with ARP MAD or ND MAD if common Ethernet ports are used for MAD. BFD MAD is mutually exclusive with the spanning tree feature, but ARP MAD and ND MAD require the spanning tree feature.
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. · Configure 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 |
|
Ports on the intermediate device for BFD MAD |
Use common Ethernet ports on the intermediate device to connect the BFD MAD-enabled management Ethernet ports on the IRF fabric. |
|
BFD MAD VLAN |
· Create a VLAN for BFD MAD only on the intermediate device, and assign the ports used for BFD MAD to the VLAN. On the IRF fabric, you do not need to assign the BFD MAD-enabled 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. 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. |
|
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.
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.
|
|
NOTE: 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
# 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.
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. To avoid incorrect traffic forwarding, do not exclude any ports except for the ports used for Telnet and MAD.
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 Ten-GigabitEthernet 2/0/1 from being shut down when the MAD status transits to Recovery.
<Sysname> system-view
[Sysname] mad exclude interface ten-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 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 MAD IP addresses are on the same subnet.
· If common Ethernet ports are used for BFD MAD, configure MAD IP addresses on the BFD MAD-enabled VLAN interface.
· If management Ethernet ports are used for BFD MAD, configure MAD IP addresses on the BFD MAD-enabled management Ethernet ports.
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.
Do not configure ND MAD together with LACP MAD, because they handle collisions differently.
Do not configure ND MAD together with BFD MAD if common Ethernet ports are used for BFD MAD. ND MAD requires the spanning tree feature, but BFD MAD is mutually exclusive with the spanning tree feature.
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.
|
|
NOTE: 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
# 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 up to eight 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 the binding between a physical interface and an IRF port even if the IRF link has been lost. (For example, this situation could occur when the member device holding the physical interface is removed.) To remove the binding, use the undo port group interface command.
Examples
# Bind Ten-GigabitEthernet 3/0/45 through Ten-GigabitEthernet 3/0/48 to IRF-port 3/1 on IRF member 3.
[Sysname] interface range ten-gigabitethernet 3/0/45 to ten-gigabitethernet 3/0/48
[Sysname-if-range] shutdown
[Sysname-if-range] quit
[Sysname] irf-port 3/1
[Sysname-irf-port3/1] port group interface ten-gigabitethernet 3/0/45
[Sysname-irf-port3/1] port group interface ten-gigabitethernet 3/0/46
[Sysname-irf-port3/1] port group interface ten-gigabitethernet 3/0/47
[Sysname-irf-port3/1] port group interface ten-gigabitethernet 3/0/48
[Sysname-irf-port3/1] quit
[Sysname] interface range ten-gigabitethernet 3/0/45 to ten-gigabitethernet 3/0/48
[Sysname-if-range] undo shutdown
[Sysname-if-range] quit
IRF 3 commands
pex working-mode
Use pex working-mode to set the operating mode of the device.
Use undo pex working-mode to restore the default.
Syntax
pex working-mode { auto | pex | switch } { all | slot slot-number1 [ to slot-number2 ] }
undo pex working-mode { all | slot slot-number1 [ to slot-number2 ] }
Default
The device operates in auto mode.
Views
System view
Predefined user roles
network-admin
Parameters
auto: Specifies the auto operating mode. This mode takes effect when the device is not part of an IRF fabric or IRF 3 system. The device automatically changes to the PEX mode to join an IRF 3 system when it detects any PEX links in up state. Before that, the device operates as an independent node and is configurable from its CLI.
pex: Specifies the PEX operating mode. In this mode, the device can only be managed from the parent fabric in an IRF 3 system. You cannot manage the device from the CLI of the device. If no PEX links are available to the parent fabric, you can only access the device from the Boot menus.
switch: Specifies the switch operating mode. In this mode, the device operates independently as a node. It is not part of an IRF 3 system, whether or not it has connections to the parent fabric.
all: Specifies all member devices in an IRF fabric.
slot slot-number1: Specifies an IRF member device by its member ID.
slot slot-number1 to slot-number2: Specifies a range of IRF member devices. The slot-number1 argument represents the start member ID. The slot-number2 argument represents the end member ID. The end member ID must be greater than or equal to the start member ID.
Usage guidelines
For the configuration to take effect, you must reboot the device. To cancel the change, use the undo form of this command before you reboot the device.
The auto mode does not take effect if IRF port settings are configured on the device. For the auto mode to take effect, you must remove these settings.
The auto mode runs only for 24 hours. The auto mode stops monitoring PEX links if the device fails to join an IRF 3 system before the timer expires. To add the device to an IRF 3 system, you must manually change its mode to PEX mode.
Examples
# Specify the operating mode as PEX for the device with member ID 1.
<Sysname> system-view
[Sysname] pex working-mode pex slot 1
Are you sure you want to change to the PEX mode? [Y/N]: y
If you want to change device to PEX mode, you must reboot the device.
# Cancel the operating mode change before you reboot the device.
[Sysname] undo pex working-mode slot 1
Are you sure you want to force a change to default mode? In default mode, the de
vice will be changed to auto mode. [Y/N]: y
