Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 01-IRF (cluster) commands | 171.12 KB |
IRF commands
chassis convert mode irf
Use chassis convert mode irf to enable IRF mode.
Use undo chassis convert mode to restore standalone mode.
Syntax
chassis convert mode irf
undo chassis convert mode
Default
The device operates in standalone mode.
Views
System view
Predefined user roles
network-admin
Usage guidelines
|
|
CAUTION: Restoring the standalone mode of a member device also removes that device from the IRF fabric. If you continue to use that device on the network, IP or bridge MAC conflict might occur. You must reconfigure the device or the IRF fabric to remove the conflict. |
To set up an IRF fabric, place all member devices in IRF mode. In standalone mode, a device cannot join an IRF fabric.
The device automatically reboots for the mode change to take effect. During the reboot, you may choose to have the system automatically convert the startup configuration file. Automatic configuration conversion prevents slot- or interface-related settings from becoming invalid. For example, the system adds member ID information to interface numbers and file paths in IRF mode.
IRF generates packets on a device in IRF mode even if the device does not form an IRF fabric with any other devices. To conserve system resources after a device is removed from an IRF fabric, restore its standalone mode if the device will not be used in an IRF fabric.
Examples
# Enable IRF mode.
<Sysname> system-view
[Sysname] chassis convert mode irf
The device will switch to IRF mode and reboot.
You are recommended to save the current running configuration and specify the configuration file for the next startup. Continue? [Y/N]:y
Do you want to convert the content of the next startup configuration file flash:/startup.cfg to make it available in IRF mode? [Y/N]:y
Now rebooting, please wait...
# Restore standalone mode.
<Sysname> system-view
[Sysname] undo chassis convert mode
The device will switch to stand-alone mode and reboot.
You are recommended to save the current running configuration and specify the configuration file for the next startup. Continue? [Y/N]:y
Do you want to convert the content of the next startup configuration file flash:/startup.cfg to make it available in stand-alone mode? [Y/N]:y
Now rebooting, please wait...
display irf
Use display irf to display IRF information.
Syntax
display irf
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
This command is supported only in IRF mode.
Examples
# Display IRF information.
<Sysname> display irf
Member ID Role Priority CPU MAC Description
1 Loading 1 00e0-fcbe-3102 F1Num001
*+2 Master 1 00e0-fcb1-ade2 F1Num002
--------------------------------------------------------
The asterisk (*) indicates the master.
The plus sign (+) indicates the device through which you are logged in.
The right angle bracket (>) indicates the device's stack capability is disabled.
Bridge MAC of the IRF: 00e0-fc00-1000
Auto upgrade : Disabled
MAC persistence : Disabled
Topo-domain ID : 30
Auto merge : Enabled
Table 1 Command output
|
Field |
Description |
|
Member ID |
IRF member ID: · A prefix of asterisk sign (*) indicates the master device. · A prefix of plus sign (+) indicates the device where you are logged in. · A prefix of right angle bracket (>) indicates the device that has been temporarily removed from the IRF fabric by using the undo irf member stack enable command. |
|
Role |
Role of the member device in the IRF fabric: · Master—Master device. · Standby—Standby 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. |
|
Bridge MAC of the IRF |
Bridge MAC address of the IRF fabric. |
|
Auto upgrade |
Status of the software auto-update feature: · Enabled. · Disabled. |
|
MAC persistence |
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. · Disabled—Bridge MAC address of the current master replaces the original bridge MAC address as soon as the owner of the original address leaves. |
|
Topo-domain ID |
Topo-domain ID of the IRF fabric. The topo-domain ID you assign to an IRF fabric must uniquely identify the IRF fabric in a multi-IRF network. |
|
Auto merge |
Status of the auto-merge feature: · Enabled. · Disabled. |
display irf configuration
Use display irf configuration to display IRF settings for each member device in an IRF fabric.
Syntax
display irf configuration
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display IRF settings on all member devices.
<Sysname> display irf configuration
The New ID, Topo-domain, Stack, and Member interfaces fields display settings for the next startup.
Member ID New ID Topo-domain Stack Member interfaces
1 1 0 Enabled Disabled
Table 2 Command output
|
Field |
Description |
|
Member ID |
Current IRF member ID of the device. |
|
New ID |
IRF member ID assigned to the device. This member ID takes effect at reboot. |
|
Topo-domain |
IRF topo-domain ID. The topo-domain ID takes effect at reboot. |
|
Stack |
Whether multimember stacking capability is enabled: · Enabled—The device can form an IRF fabric with other member devices. · Disabled—The device cannot form an IRF fabric with other member devices. The device will be removed from the IRF fabric in a maximum of 5 seconds (see "irf member stack enable"). This field is available only when the device is operating in IRF mode. |
|
Member interfaces |
Network interfaces bound to the IRF port. This field displays Disabled if no network interfaces have been bound to the IRF port. The channel type of each IRF link is enclosed in brackets. Available channel types include: · ctrl—Control channel. · data—Data channel. · ctrl&data—Hybrid channel. |
display irf link
Use display irf link to display IRF link information.
Syntax
display irf link
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
This command is supported only in IRF mode.
Examples
# Display IRF link information.
<Sysname> display irf link
Member ID Member interfaces Status
1 Disabled --
Table 3 Command output
|
Field |
Description |
|
Member ID |
IRF member ID. |
|
Member interfaces |
Network interfaces bound to the IRF port. This field displays Disabled if no network interfaces have been bound to the IRF port. The channel type of each IRF link is enclosed in brackets. Available channel types include: · ctrl—Control channel. · data—Data channel. · ctrl&data—Hybrid channel. |
|
Status |
Link status of the network interface: · Up—The link is up. · Down—The link is down. · ADM—The interface has been manually shut down by using the shutdown command. · Blocked—The link is blocked. In this state, the device cannot join an IRF fabric. For more information about this state, see "irf member stack enable." This field displays two hyphens (--) if no network interfaces are bound to the IRF port. |
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.
Usage guidelines
This command is supported only in IRF mode.
Examples
# Display brief MAD information.
<Sysname> display mad
MAD ARP disabled.
MAD ND disabled.
MAD LACP enabled.
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/5
Ten-GigabitEthernet2/0/5
MAD ARP disabled.
MAD ND disabled.
MAD LACP enabled interface: Bridge-Aggregation 1
MAD status : Normal
Member ID Port MAD status
1 GigabitEthernet1/1/0 Normal
2 GigabitEthernet2/1/0 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
2 192.168.1.2/24 1 Normal
Table 4 Command output
|
Field |
Description |
|
MAD ARP enabled. |
Status of ARP MAD. This field displays MAD ARP disabled if ARP MAD is disabled. |
|
MAD ND enabled. |
Status of ND MAD. This field displays MAD ND disabled if ND MAD is disabled. |
|
MAD LACP disabled. |
Status of LACP MAD. This field displays MAD LACP enabled if LACP MAD is enabled. |
|
MAD BFD disabled. |
Status of BFD MAD. This field displays MAD BFD enabled if BFD MAD is enabled. |
|
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 network interfaces in the fabric except for the IRF network interfaces and interfaces 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) |
Interfaces manually configured to not shut down when the IRF fabric transits to the Recovery state. |
|
Excluded ports(system-configured) |
Interfaces set to not shut down by default when the IRF fabric transits to the Recovery state. These interfaces 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 interfaces 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. Values 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 for connectivity issues. |
|
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. Values include Normal and Faulty. |
irf auto-merge enable
Use irf auto-merge enable to enable IRF auto-merge.
Use undo irf auto-merge enable to disable IRF auto-merge.
Syntax
irf auto-merge enable
undo irf auto-merge enable
Default
IRF auto-merge is enabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command is supported only in IRF mode.
IRF fabrics that are merging perform master election. The IRF auto-merge feature enables member devices in the IRF fabric that fails the master election to automatically reboot for completing the IRF merge. If the IRF auto-merge feature is disabled, you must follow the system instructions to manually reboot member devices in the IRF fabric that fails master election.
For a successful merge, make sure IRF auto-merge is enabled on both IRF fabrics that are merging.
IRF auto-merge takes effect on merges caused by the following events:
· The IRF link recovers from a link failure.
· The IRF network interfaces of the member devices are connected through a Layer 2 network after the interfaces are bound to IRF ports.
The feature does not take effect on a merge that occurs in the following conditions:
· You add a network interface to an IRF port.
· The network interface has been connected to the peer member device through a Layer 2 network before you bind it to the IRF port.
When you change the operating mode from IRF to standalone, the IRF auto-merge setting is restored to the default. To disable IRF auto-merge after you change the operating mode from standalone to IRF, use the undo form of this command.
Examples
# Enable IRF auto-merge.
<Sysname> system-view
[Sysname] irf auto-merge enable
irf auto-update enable
Use irf auto-update enable to enable software auto-update.
Use undo irf auto-update enable to disable software auto-update.
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 is supported only in IRF mode.
This command automatically propagates the current software images of the master in the IRF fabric to member 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 IRF fabric automatically deletes the current software images of the device. If the reclaimed space is still insufficient, the device cannot complete the auto-update. You must reboot the device, and then access the BootWare menu to delete files.
When you change the operating mode from IRF to standalone, the IRF auto-update setting is restored to the default. To disable IRF auto-update after you change the operating mode from standalone to IRF, use the undo form of this command.
Examples
# Enable software auto-update.
<Sysname> system-view
[Sysname] irf auto-update enable
irf domain
Use irf domain to assign an IRF MAD domain ID to each member device or to an IRF fabric.
Use undo irf domain to restore the default.
Syntax
irf domain domain-id
undo irf domain
Default
The IRF MAD domain ID is 0.
Views
System view
Predefined user roles
network-admin
Parameters
domain-id: Specifies an IRF MAD domain ID. The value range is 0 to 4294967295.
Usage guidelines
This command is supported only in IRF mode. When you change the operating mode from IRF to standalone, the command setting is restored to the default.
An IRF MAD domain ID uniquely identifies an IRF multi-active detection domain. 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 MAD domain IDs for correct split detection. False detection causes IRF split.
An IRF fabric has only one IRF MAD domain ID. You can change the IRF MAD domain ID by using the irf domain, mad enable, mad arp enable, or mad nd enable command. The IRF MAD domain IDs configured by using these commands overwrite each other.
Examples
# Set the IRF MAD domain ID to 10.
<Sysname> system-view
[Sysname] irf domain 10
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 will cause transient traffic disruption. |
When you replace an IRF fabric as a whole, you can configure the new IRF fabric with the bridge MAC address of the existing IRF fabric before the replacement to minimize service interruption.
This command is supported only in IRF mode. When you change the operating mode from IRF to standalone, the IRF bridge MAC address configuration is lost, regardless of whether you have saved the configuration.
You must make sure the IRF bridge MAC address is unique on the switched LAN.
After you specify an IRF bridge MAC address, the IRF fabric always uses the specified address as the IRF bridge MAC address.
If the 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.
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.
After IRF fabrics merge, the merged IRF fabric uses the bridge MAC address of the merging IRF fabric that won the master election 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
The IRF bridge MAC address does not change after the address owner leaves.
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 owner rejoins the IRF fabric within the time limit, the IRF bridge MAC address does not change. If the 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
|
|
CAUTION: IRF bridge MAC address change will cause transient traffic disruption. |
This command is supported only in IRF mode.
If the undo form of this command is used, bridge MAC address of the current master replaces the original IRF bridge MAC as soon as the original address owner leaves.
On a switched LAN, the IRF 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 two member devices have the same bridge MAC address.
If the IRF fabric has multi-member aggregate links, do not use the undo irf mac-address persistent command. Use of this command might result in unnecessary traffic disruption.
The irf mac-address persistent command does not take effect if the IRF bridge MAC address is configured by using the irf mac-address mac-address command.
If ARP MAD or ND MAD is used with the spanning tree feature, disable IRF bridge MAC persistence by using the undo irf mac-address persistent command. In addition, do not specify an IRF bridge MAC address by using the irf mac-address mac-address command.
When you change the operating mode from IRF to standalone, the bridge MAC persistence setting is restored to the default.
Examples
# Enable the IRF bridge MAC address to be permanent.
<Sysname> system-view
[Sysname] irf mac-address persistent always
irf member
Use irf member to assign an IRF member ID to the device in standalone mode.
Use undo irf member to restore the default.
Syntax
irf member member-id
undo irf member
Default
The IRF member ID is 1.
Views
System view
Predefined user roles
network-admin
Parameters
member-id: Specifies an IRF member ID for the device. The value range for this argument varies by device model.
Usage guidelines
This command is supported only in standalone mode.
Assign an IRF member ID to a device before enabling IRF mode. The member ID takes effect after IRF mode is enabled. This member ID must be unique among all IRF member devices.
To change the member ID of a device in IRF mode, use the irf member renumber command.
Examples
# (In standalone mode.) Assign IRF member ID 2 to the device.
<Sysname> system-view
[Sysname] irf member 2
Related commands
irf member renumber
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 a member device by its IRF member ID. The value range for IRF member IDs varies by device model.
text: Specifies a description, a string of 1 to 127 characters.
Usage guidelines
This command is supported only in IRF mode. When you change the operating mode from IRF to standalone, the command setting is restored to the default.
Examples
# Configure the description as F1Num001 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 device uses the IRF member priority that is set in standalone mode. (Mode conversion-capable devices.)
The IRF member priority is 1. (Mode conversion-incapable devices.)
Views
System view
Predefined user roles
network-admin
Parameters
member-id: Specifies a member device by its IRF member ID. The value range for this argument varies by device model.
priority: Sets the member 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
This command is supported only in IRF mode.
To assign an IRF priority to a device in standalone mode, use the irf priority command.
Examples
# Set the priority of IRF member 2 to 32.
<Sysname> system-view
[Sysname] irf member 2 priority 32
Related commands
irf priority
irf member renumber
Use irf member renumber to change the IRF member ID of an IRF member 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 device uses the member ID that is set in standalone mode. (Mode conversion-capable devices.)
The IRF member ID is 1. (Mode conversion-incapable devices.)
Views
System view
Predefined user roles
network-admin
Parameters
member-id: Specifies a member device by its IRF member ID. The value range for IRF member IDs varies by device model.
new-member-id: Assigns a new ID to the IRF member device.
Usage guidelines
|
|
CAUTION: In an IRF fabric, an IRF member ID change can invalidate member ID-related settings, including interface and file path settings, and cause data loss. Make sure you fully understand its impact on your live network. |
This command is supported only in IRF mode.
Make sure each member device in the IRF fabric has a unique member ID.
The new IRF member ID takes effect after you reboot the member device.
To set the member ID of a device in standalone mode, use the irf member command.
Examples
# Change the member ID of an IRF member device from 1 to 2.
<Sysname> system-view
[Sysname] irf member 1 renumber 2
Renumbering the member ID may result in configuration change or loss. Continue? [Y/N]:y
Related commands
irf member
irf member stack enable
Use irf member stack enable to enable an IRF member device to receive and send IRF control packets.
Use undo irf member stack enable to disable an IRF member device from receiving or sending IRF control packets.
Syntax
irf member member-id stack enable
undo irf member member-id stack enable
Default
An IRF member device receives and sends IRF control packets.
Views
System view
Predefined user roles
network-admin
Parameters
member-id: Specifies a member device by its IRF member ID. The value range for IRF member IDs varies by device model.
Usage guidelines
|
|
CAUTION: Disabling an IRF member device from receiving or sending IRF control packets will remove that member device from the IRF fabric. If you continue to use that device on the network, IP or bridge MAC conflict might occur. You must reconfigure the device or the IRF fabric to remove the conflict. |
This command is supported only in IRF mode.
You can use the undo form of this command to remove a member device from an IRF fabric for troubleshooting or maintenance purposes. The removed member device still operates in IRF mode and runs the original IRF settings. However, it does not send or receive IRF control packets.
After you finish the troubleshooting or maintenance tasks, you can execute this command to add the device back to the IRF fabric without having to reconfigure IRF settings. For this command to take effect, you must save the command setting and reboot the device.
When you change the operating mode from IRF to standalone, the command setting is restored to the default. To disable an IRF member device from receiving or sending IRF control packets after you change the operating mode from standalone to IRF, use the undo form of this command.
Examples
# Remove member device 2 from the IRF fabric.
<Sysname> system-view
[Sysname] undo irf member 2 stack enable
Member 2 will leave from the IRF and cannot form an IRF with any other devices. Continue? [Y/N]: y
Operation succeeded. Please check the configuration on member 2 with the IRF for configuration collisions.
# Add the removed device back to the IRF fabric.
<Sysname> system-view
[Sysname] irf member 2 stack enable
Please save the configuration, and then reboot the device for the configuration to take effect.
irf priority
Use irf priority in standalone mode to assign an IRF member priority to the device.
Use undo irf priority to restore the default.
Syntax
irf priority priority
undo irf priority
Default
The IRF member priority is 1.
Views
System view
Predefined user roles
network-admin
Parameters
priority: Specifies the member 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
This command is supported only in standalone mode.
The member priority configured in standalone mode takes effect after you enable IRF mode.
To change the IRF member priority of a device in IRF mode, use the irf member priority command. The new priority setting takes effect at the next master election, but it does not trigger a master election.
Examples
# (In standalone mode.) Assign IRF member priority 32 to the device.
<Sysname> system-view
[Sysname] irf priority 32
Related commands
irf member priority
irf topo-domain
Use irf topo-domain to assign an IRF topo-domain ID to each member device or to an IRF fabric.
Use undo irf topo-domain to restore the default.
Syntax
irf topo-domain topo-domain-id
undo irf topo-domain
Default
The IRF topo-domain ID is 0.
Views
System view
Predefined user roles
network-admin
Parameters
topo-domain-id: Specifies an IRF topo-domain ID. The value range is 0 to 4294967295.
Usage guidelines
|
|
CAUTION: Changing the IRF topo-domain ID of an IRF member device will remove that member device from the IRF fabric. This member device will be unable to exchange IRF protocol packets with the remaining member devices in the IRF fabric. |
An IRF topo-domain ID uniquely identifies an IRF fabric.
You must assign the same topo-domain ID to devices you are adding to the same IRF fabric.
For the topo-domain ID change to take effect, you must reboot the device.
Examples
# Set the IRF topo-domain ID to 10.
<Sysname> system-view
[Sysname] irf topo-domain 10
The configuration will take effect at the next startup.
irf-port
Use irf-port to enter IRF port view.
Syntax
In standalone mode:
irf-port
In IRF mode:
irf-port member-id
Views
System view
Predefined user roles
network-admin
Parameters
member-id: Specifies an IRF member ID. The value range for IRF member IDs varies by device model.
Usage guidelines
Each member device has only one IRF port. The IRF port ID is the IRF member ID.
You must enter IRF port view to bind links to the IRF port.
Examples
# (In standalone mode.) Enter IRF port view.
<Sysname> system-view
[Sysname] irf-port
# (In IRF mode.) Enter IRF port view of the IRF port on member device 1.
<Sysname> system-view
[Sysname] irf-port 1
Related commands
port group interface
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
VLAN interface view
Predefined user roles
network-admin
Usage guidelines
This command is supported only in IRF mode.
Do not configure ARP MAD together with LACP MAD or BFD MAD, because they handle collisions differently.
When you configure ARP MAD on a VLAN interface, 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 the IRF fabric and the intermediate device, create a VLAN for ARP MAD. ¡ On the IRF fabric and the intermediate device, assign the ports of ARP MAD links to the ARP MAD VLAN. ¡ On the IRF fabric, create a VLAN interface for 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 MAD domain IDs for correct split detection. |
When you execute the mad arp enable command, the system prompts you to enter a MAD domain ID. If you do not want to change the current MAD domain ID, press enter at the prompt.
An IRF fabric has only one IRF MAD domain ID. You can change the IRF MAD domain ID by using the following commands: irf domain, mad enable, mad arp enable, or mad nd enable. The IRF MAD domain IDs configured by using these commands overwrite each other.
Examples
# Enable ARP MAD on Layer 3 aggregate interface 1.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1] 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
Layer 3 aggregate interface view
VLAN interface view
Predefined user roles
network-admin
Usage guidelines
This command is supported only in IRF mode.
Do not configure BFD MAD together with ARP MAD or ND MAD, because they handle collisions differently.
When you configure BFD MAD on a VLAN interface, 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 the IRF fabric and the intermediate device, create a VLAN for BFD MAD. ¡ On the IRF fabric and the intermediate device, assign the ports of BFD MAD links to the BFD MAD VLAN. ¡ On the IRF fabric, create a VLAN interface for 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 that port is not on a BFD MAD link. If you have assigned that port to all VLANs by using the port trunk permit vlan all command, use the undo port trunk permit command to exclude that port from the BFD MAD VLAN. |
|
BFD MAD VLAN and feature compatibility |
Do not use the BFD MAD VLAN for any purposes other than configuring BFD MAD. · Use only the mad bfd enable and mad ip address commands on the BFD MAD-enabled VLAN interface. If you configure other features, both BFD MAD and other features on the interface might run incorrectly. · Disable the spanning tree feature on any Layer 2 Ethernet ports in the BFD MAD VLAN. The MAD feature is mutually exclusive with the spanning tree feature. |
|
MAD IP address |
· To avoid network issues, only use the mad ip address command to configure IP addresses on the BFD MAD-enabled VLAN interface. Do not configure an IP address by using the ip address command or configure a VRRP virtual address on the BFD MAD-enabled VLAN interface. · Make sure all the MAD IP addresses are on the same subnet. |
When you configure BFD MAD on a Layer 3 aggregate interface, follow these restrictions and guidelines:
|
Category |
Restrictions and guidelines |
|
BFD MAD-enabled Layer 3 aggregate interface |
· Make sure the Layer 3 aggregate interface operates in static aggregation mode. · Make sure the member ports in the aggregation group do not exceed the maximum number of Selected ports allowed for an aggregation group. If the number of member ports exceeds the maximum number of Selected ports, some member ports cannot become Selected. BFD MAD will be unable to work correctly and its state will change to Faulty. |
|
BFD MAD VLAN |
· On the intermediate device (if any), assign the ports on the BFD MAD links to the same VLAN. Do not assign the ports to an aggregate interface. If the ports are hybrid ports, make sure these ports are untagged members of their PVIDs. · If the intermediate device acts as a BFD MAD intermediate device for multiple IRF fabrics, assign different BFD MAD VLANs to the IRF fabrics. · Do not use the BFD MAD VLAN on the intermediate device for any purposes other than BFD MAD. · 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 that port is not on a BFD MAD link. If you have assigned that port to all VLANs by using the port trunk permit vlan all command, use the undo port trunk permit command to exclude that port from the BFD MAD VLAN. |
|
BFD MAD-enabled Layer 3 aggregate interface and feature compatibility |
Use only the mad bfd enable and mad ip address commands on the BFD MAD-enabled interface. If you configure other features, both BFD MAD and other features on the interface might run incorrectly. |
|
MAD IP address |
· To avoid network issues, only use the mad ip address command to configure IP addresses on the BFD MAD-enabled interface. Do not configure an IP address by using the ip address command or configure a VRRP virtual address on the BFD MAD-enabled interface. · Make sure all the MAD IP addresses are on the same subnet. |
Examples
# Enable BFD MAD on Route-Aggregation 3.
<Sysname> system-view
[Sysname] interface route-aggregation 3
[Sysname-Route-Aggregation3] 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
This command is supported only in IRF mode.
LACP MAD handles collisions differently than ARP MAD and ND MAD. To avoid conflicts, do not enable LACP MAD together with ARP MAD and ND MAD on an IRF fabric.
LACP MAD requires an H3C device that supports extended LACPDUs to act as the intermediate device. 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 MAD domain IDs for correct split detection. False detection causes IRF split.
When you execute the mad enable command, the system prompts you to enter a MAD domain ID. If you do not want to change the current MAD domain ID, press enter at the prompt.
An IRF fabric has only one IRF MAD domain ID. You can change the IRF MAD domain ID by using the following commands: irf domain, mad enable, mad arp enable, or mad nd enable. The IRF MAD 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.
# 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 network interface 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 configure the IRF fabric to shut down a network interface when it transits to the Recovery state upon detection of a multi-active collision.
Syntax
mad exclude interface interface-type interface-number
undo mad exclude interface interface-type interface-number
Default
When an IRF fabric transits to the Recovery state, the system automatically shuts down all network interfaces except for the IRF network interfaces.
Views
System view
Predefined user roles
network-admin
Parameters
interface-type interface-number: Specifies a network interface by its type and number.
Usage guidelines
This command is supported only in IRF mode.
If an interface must be kept in up state for special purposes such as Telnet connection, exclude the interface from the shutdown action. As a best practice to avoid incorrect traffic forwarding, do not exclude any interfaces except for the interfaces used for Telnet.
Do not exclude the following interfaces from the shutdown action:
· Aggregate interfaces used for MAD and their member interfaces.
· VLAN interfaces used for MAD and its Ethernet ports.
· Reth interfaces used for MAD and their member interfaces.
The interfaces 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 interfaces.
Examples
# Exclude GigabitEthernet 1/0 from being shut down when the MAD status transits to Recovery.
<Sysname> system-view
[Sysname] mad exclude interface gigabitethernet 1/0
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 the MAD IP address for an IRF member device.
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
Layer 3 aggregate interface view
VLAN interface view
Predefined user roles
network-admin
Parameters
ip-address: Specifies an IP address in dotted decimal notation.
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. The value range for IRF member IDs varies by device model.
Usage guidelines
This command is supported only in IRF mode.
To use BFD MAD, configure a MAD IP address for each IRF member device. Make sure all the MAD IP addresses are on the same subnet.
Do not configure a MAD IP address by using the ip address command or configure a VRRP virtual address on the BFD MAD-enabled interface.
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 Route-Aggregation 3.
<Sysname> system-view
[Sysname] interface route-aggregation 3
[Sysname-Route-Aggregation3] mad ip address 192.168.0.1 255.255.255.0 member 1
# Assign a MAD IP address to IRF member 2 on Route-Aggregation 3.
[Sysname-Route-Aggregation 3] 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
This command is supported only in IRF mode.
Do not configure ND MAD together with LACP MAD or BFD MAD, because they handle collisions differently.
When you configure ND MAD on a VLAN interface, follow these restrictions and guidelines:
|
Category |
Restrictions and guidelines |
|
ND MAD VLAN |
· Do not enable ND MAD on VLAN-interface 1. · If you are using an intermediate device, perform the following tasks: ¡ On the IRF fabric and the intermediate device, create a VLAN for ND MAD. ¡ On the IRF fabric and the intermediate device, assign the ports of ND MAD links to the ND MAD VLAN. ¡ On the IRF fabric, create a VLAN interface for the ND MAD VLAN. · Do not use the ND MAD VLAN for any other purposes. |
|
ND 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 ND 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 MAD domain IDs for correct split detection. |
When you execute the mad nd enable command, the system prompts you to enter a MAD domain ID. If you do not want to change the current MAD domain ID, press enter at the prompt.
An IRF fabric has only one IRF MAD domain ID. You can change the IRF MAD domain ID by using the following commands: irf domain, mad enable, mad arp enable, or mad nd enable. The IRF MAD domain IDs configured by using these commands overwrite each other.
Examples
# Enable ND MAD on Layer 3 aggregate interface 1.
<Sysname> system-view
[Sysname] interface route-aggregation 3
[Sysname-Route-Aggregation3] 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
This command is supported only in IRF mode.
For split IRF fabrics, if the active IRF fabric fails 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 network interface to an IRF port.
Use undo port group interface to remove the binding of a network interface and an IRF port.
Syntax
port group interface interface-type interface-number [ type { control | data } ]
undo port group interface interface-name
Default
No network interfaces are bound to an IRF port.
Views
IRF port view
Predefined user roles
network-admin
Parameters
interface-type interface-number: Specifies a network interface by its type and number. For information about available network interfaces, see IRF configuration in the virtual technologies configuration guide for the device.
interface-name: Specifies a network interface in the interface-typeinterface-number format. No space is allowed between the interface-type and interface-number arguments.
type { control | data }: Specifies a channel type for the IRF link. The hybrid channel type applies if you do not specify a channel type. The link can forward both data and control packets.
· control: Sets the link type to control. The link can forward only control packets, such as IRF protocol packets.
· data: Sets the link type to data. The link can forward only data packets.
Usage guidelines
|
|
CAUTION: Use the undo port group interface with caution. If the network interface is the only up member interface of the IRF port, the IRF fabric will split after you remove the binding. |
An IRF port must have a minimum of one hybrid channel, or a minimum of one data channel and one control channel. As a best practice, use separate physical links as data and control channels to prevent control traffic from being delayed when a large amount of data traffic is present.
The number of channels you can bind to an IRF port depending on the VSR model and the binding method.
|
VSR model |
Binding method |
Maximum number of channels per IRF port |
|
VSR1000 router |
Executing this command without specifying a channel type |
Only one hybrid channel |
|
Executing this command with a channel type specified |
One data channel and one control channel |
|
|
VSR2000 router |
Executing this command without specifying a channel type |
Two hybrid channels (operating in active/standby mode) |
|
Executing this command with a channel type specified |
One data channel and one control channel |
To change the channel type of an IRF link, you must first remove the binding, and then rebind the link.
Use the shutdown command to shut down a network interface before you bind it to or remove it from an IRF port. To bring up the network interface after a binding or binding removal operation, use the undo shutdown command.
The system does not dynamically remove IRF port bindings when IRF links are lost. To remove IRF port bindings, you must use the undo port group interface command.
When you use network interfaces that are grouped in hardware for IRF connection, follow these restrictions and guidelines:
· If you use one network interface in a group as an IRF network interface, the remaining network interfaces in the group can only act as IRF network interfaces. You cannot use them for any other purposes. To use a network interface in a group for any purpose other than IRF network interfaces, do not bind any of the interfaces in the group to an IRF port.
· The network interfaces in a group can be bound to different IRF ports.
· You must shut down all network interfaces in a group before you can assign or remove any of the interfaces to or from the IRF port. To bring up the interfaces after the assignment or removal is complete, execute the undo shutdown command.
Examples
# (In standalone mode.) Bind GigabitEthernet 1/0 as a hybrid channel to the IRF port on the device.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0
[Sysname-GigabitEthernet1/0] shutdown
[Sysname-GigabitEthernet1/0] quit
[Sysname] irf-port
[Sysname-irf-port] port group interface gigabitethernet 1/0
[Sysname-irf-port] quit
[Sysname] interface gigabitethernet 1/0
[Sysname-GigabitEthernet1/0] undo shutdown
# (In IRF mode.) Bind GigabitEthernet 2/0/1 as a hybrid channel to the IRF port on IRF member 2.
<Sysname> system-view
[Sysname] interface gigabitethernet 2/1/0
[Sysname-GigabitEthernet2/1/0] shutdown
[Sysname-GigabitEthernet2/1/0] quit
[Sysname] irf-port 2
[Sysname-irf-port2] port group interface gigabitethernet 2/1/0
[Sysname-irf-port2] quit
[Sysname] interface gigabitethernet 2/1/0
[Sysname-GigabitEthernet2/1/0] undo shutdown
Related commands
irf-port
