Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 01-IRF commands | 201.15 KB |
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
By default, the device operates in standalone mode.
Views
System view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
To set up an IRF fabric, place all its member devices in IRF mode after configuring their member ID, priority, and IRF port settings. In standalone mode, a device cannot form an IRF fabric with other devices.
After removing a device from an IRF fabric, change its operating mode to standalone. In IRF mode, the device forms a single-member IRF fabric, and the IRF protocol still runs on the device to consume system resources.
Save any configuration you have made before changing the device to operate in a different mode, because the device will automatically reboot to make the new operating mode take effect.
Make sure you have assigned a member ID to each IRF member device before you enable the IRF mode. If no member ID is assigned, two hyphens (--) is displayed in the output of the MemberID field from the display irf-configuration command.
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
Please wait...
Saving the converted configuration file to the main board succeeded.
Slot 1:
Saving the converted configuration file succeeded.
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 alone mode? [Y/N]:y
Now rebooting, please wait...
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
mdc-admin
mdc-operator
Examples
# Display IRF fabric information.
<Sysname> display irf
MemberID Slot Role Priority CPU-Mac Description
*+1 0 Master 1 0210-fc03-0007 -----
--------------------------------------------------
* indicates the device is the master.
+ indicates the device through which the user logs in.
The Bridge MAC of the IRF is: 3ce5-a6b8-3800
Auto upgrade : yes
Mac persistent : always
Domain ID : 0
Auto merge : no
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 have been logged in is prefixed with a plus (+) sign. |
|
Slot |
MPU slot number. |
|
Role |
Role of the MPU in the IRF fabric: · Standby—Standby MPU for the global active MPU. · Master—Global active MPU. · Loading—Standby MPU for the global active MPU. This standby MPU is loading the software images. |
|
Priority |
IRF member priority. |
|
CPU-MAC |
MAC address of the CPU on the MPU. |
|
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. |
|
Auto upgrade |
Status of the software auto-update function: · yes—Enabled. The master device automatically propagates its software images to the device you are adding to the IRF fabric. · no—Disabled. You must manually make sure the joining device uses the same set of software images as the master device. If not, the new device cannot join the IRF fabric. |
|
MAC persistent |
IRF bridge MAC persistence setting: · 6 min—Bridge MAC address of the IRF fabric persists for 6 minutes after the master leaves. · always—Bridge MAC address of the IRF fabric does not change after the master leaves. · no—Bridge MAC address of the new master replaces the original one as soon as the old master leaves. |
|
Auto merge |
Whether the auto-reboot for IRF fabric merge is enabled: · yes—Enabled. · no—Disabled. |
display irf configuration
Use display irf configuration to display basic IRF settings, including the current member ID, new member ID, and physical ports bound to the IRF ports on each IRF member device. The new member IDs take effect at reboot.
Syntax
display irf configuration
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# In standalone mode, display the basic IRF settings of the device.
<Sysname> display irf configuration
MemberID Priority IRF-Port1 IRF-Port2
-- 1 disable disable
# In IRF mode, display all members' basic IRF settings.
<Sysname> display irf configuration
MemberID NewID IRF-Port1 IRF-Port2
1 1 Ten-GigabitEthernet1/8/0/1 disable
Ten-GigabitEthernet1/8/0/2
2 2 disable Ten-GigabitEthernet2/8/0/1
Ten-GigabitEthernet2/8/0/2
Table 2 Command output
|
Field |
Description |
|
MemberID |
Current member ID of the device. If no member ID is assigned, this field displays two hyphens (--). |
|
Priority |
Member priority. This field is displayed only when the device is operating in standalone mode. |
|
NewID |
Member ID assigned to the device. This member ID takes effect at reboot. This field is displayed only when the device is operating in IRF mode. |
|
IRF-Port1 |
Physical ports bound to IRF-port 1. The bindings take effect at reboot. If no physical port is bound to the IRF port, this field displays disable. |
|
IRF-Port2 |
Physical ports bound to IRF-port 2. The bindings take effect at reboot. If no physical port is bound to the IRF port, this field displays disable. |
display irf link
Use display irf link to display IRF link information, including IRF ports, physical IRF ports, IRF link status, and the MDC to which each physical port belongs.
Syntax
display irf link
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# Display IRF link information.
<Sysname> display irf link
Member 1
IRF Port Interface Status
1 disable --
2 GigabitEthernet1/3/0/1(MDC1) UP
GigabitEthernet1/5/0/1(MDC2) ADM
GigabitEthernet1/6/0/1(MDC3) DOWN
Member 2(IRF-Link-Down: MDC2, MDC3)
IRF Port Interface Status
1 GigabitEthernet2/3/0/1(MDC1) UP
GigabitEthernet2/5/0/1(MDC2) DOWN
GigabitEthernet2/6/0/1(MDC3) ADM
2 disable --
Table 3 Command output
|
Field |
Description |
|
Member ID |
IRF member ID. |
|
(IRF-Link-Down: MDC2, MDC3) |
The IRF links on MDC2 and MDC3 are down. Because of this, the network ports assigned to MDC2 and MDC3 are also shut down. |
|
IRF Port |
IRF port number: · 1—IRF-port 1. · 2—IRF-port 2. |
|
Interface |
Physical ports bound to the IRF port, and their respective MDCs. If no physical port has been bound to the IRF port, this field displays disable. |
|
Status |
Link state of IRF physical ports: · UP—Link is up. · DOWN—Link is down. · ADM—The port has been manually shut down with the shutdown command. · ABSENT—Interface module that hosts the port is not present. |
Related commands
irf link-status detect enable
display irf topology
Use display irf topology to display the IRF fabric topology.
Command output includes the member IDs, IRF port state, and adjacencies of IRF ports.
Syntax
display irf topology
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# Display the IRF fabric topology.
<Sysname> display irf topology
Topology Info
-------------------------------------------------------------------------
IRF-Port1 IRF-Port2
MemberID Link neighbor Link neighbor Belong To
3 DIS -- DOWN -- 0210-fc03-0007
Table 4 Command output
|
Field |
Description |
|
IRF-Port 1 |
Information about IRF-port 1, including its link state and neighbor. |
|
IRF-Port 2 |
Information about IRF-port 2, including its link state and neighbor. |
|
Link |
Link state of the IRF port: · UP—IRF link is up. · DOWN—IRF link is down. · DIS—No physical ports have been bound to the IRF port. You must use the port group interface command to bind at least one physical port to the IRF port. · TIMEOUT—IRF hello interval has timed out. You must examine the link for a connection loss. |
|
neighbor |
IRF member ID of the device connected to the IRF port. If no device is connected to the IRF 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. |
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
mdc-admin
mdc-operator
Parameters
verbose: Displays detailed MAD information. If this keyword is not provided, the command only displays whether a MAD mechanism is enabled.
Examples
# Display brief MAD information.
<Sysname> display mad
MAD ARP disabled.
MAD LACP disabled.
MAD BFD disabled.
# Display detailed MAD information.
<Sysname> display mad verbose
Current MAD status: Detect
Excluded ports(configurable):
GigabitEthernet 2/1/0/2
GigabitEthernet 2/1/0/3
Excluded ports(can not be configured):
Ten-GigabitEthernet 1/2/0/25
Ten-GigabitEthernet 2/2/0/26
MAD enabled aggregation port:
Bridge-Aggregation2
MAD BFD enabled interface:
Vlan-interface10
mad ip address 10.0.0.2 255.255.0.0 member 1
mad ip address 10.0.0.3 255.255.0.0 member 2
Table 5 Command output
|
Field |
Description |
|
Current MAD status |
MAD status: · Detect—The IRF fabric is integrated. · Recovery—IRF fabric is in Recovery state. When detecting a multi-active collision, MAD places the IRF fabric with higher master ID in Recovery state and shuts down all physical ports in the fabric but IRF physical ports and ports that are configured to not shut down. · Detect to Recovery—State of the IRF fabric is transitioning from Detect to Recovery, for example, as the result of an IRF split. · Recovery to Detect—State of the IRF fabric is transitioning from Recovery to Detect. |
|
Excluded ports(configurable) |
Ports manually configured to not shut down when the IRF fabric transitions to the Recovery state. |
|
Excluded ports(can not be configured) |
Ports set by default to not shut down when the IRF fabric transitions to the Recovery state. |
display restricted port
Use display restricted port to display the restricted ports.
Syntax
display restricted port [ chassis chassis-number [ slot slot-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
chassis chassis-number [ slot slot-number ]: Specifies an IRF member device or a card in the IRF fabric. The chassis-number argument represents the ID of an IRF member device, and the slot-number argument represents the slot number of a card. If an IRF member device is specified but a card is not specified, this command displays all restricted ports on that device. If neither IRF member ID nor card slot number is specified, this command displays all restricted ports in the IRF fabric.
Usage guidelines
The restricted ports in an IRF fabric cannot receive or forward multicast packets.
Examples
# Display the restricted ports on the card in slot 4 of IRF member 1.
[Sysname]display restricted port chassis 1 slot 4
Chassis: 1
slot: 4
restricted port:
GigabitEthernet1/4/0/1 GigabitEthernet1/4/0/2
irf auto-merge enable
Use irf auto-merge enable to enable auto reboot for IRF fabric merge. The function enables an IRF fabric to automatically reboot its member devices when it is defeated in the master election during an IRF fabric merge.
Use undo irf auto-merge enable to disable this function.
Syntax
irf auto-merge enable
undo irf auto-merge enable
Default
This function is disabled. To complete an IRF merge, you must manually reboot the IRF fabric that has been defeated in the master election.
Views
System view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
To avoid an auto reboot failure, make sure the auto reboot function is enabled on both IRF fabrics that are merging.
This command is available in IRF mode. The configuration of this command will be lost when you change to the standalone mode, even if you have saved the configuration.
The auto reboot function takes effect for an IRF merge that occurs when the IRF link recovers from a link failure, or when you connect the IRF physical ports of the member devices. It does not take effect for the IRF merge that occurs when you bind a physical port to an IRF port in IRF mode.
If two IRF members are connected with relay devices, the link failure between relay devices cannot cause the IRF fabric to split within 20 seconds. When the time limit exceeds, the IRF fabric splits. The member devices of the IRF fabric defeated in the master election will reboot automatically to join the reunited IRF fabric after the IRF link recovers, regardless of whether the auto reboot function is enabled or not.
Examples
# Enable auto reboot for IRF fabric merge.
<Sysname> system-view
[Sysname] irf auto-merge enable
irf auto-update enable
Use irf auto-update enable to enable the software auto-update function for propagating software images of the master in an IRF fabric to all its members.
Use undo irf auto-update enable to disable the software auto-update function.
Syntax
irf auto-update enable
undo irf auto-update enable
Default
The software auto-update function is enabled.
Views
System view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
To join an IRF fabric, a device must use the same set of software images as the master in the fabric.
The software auto-update function automatically synchronizes the current software images of the master in an IRF fabric to all its members.
Before enabling software auto-update, make sure the device you are adding to the IRF fabric has sufficient storage space for the new software images.
If no sufficient storage space is available, the device automatically deletes the current software images. If the reclaimed space is still insufficient, the device cannot complete the auto-update, and you must reboot the device and access the Boot menu to delete some files.
When you add a device to the IRF fabric, the software auto-update function compares the startup software images of the joining device with the current software images of the IRF master. If the two sets of images are different, the device automatically downloads the current software images of the master, sets the downloaded images as its main startup software images, and automatically reboots with the new software images to rejoin the IRF fabric.
If the device you are adding to the IRF fabric is incompatible with the software version running on the master, the software auto-update function cannot work correctly. For more information about the software version, see the release note for that version.
When the master is propagating its software images to the member devices, do not remove or reboot the active MPU of each member device, and make sure the IRF links between each pair of member devices are all in up state.
If software auto-update is disabled, you must manually update the device with the software images of the master before adding it to the IRF fabric.
This command is available in IRF mode. Changing the operating mode from IRF to standalone can cause loss of the irf auto-update enable command configuration, even if you have saved the configuration.
Examples
# Enable the software auto-update function.
<Sysname> system-view
[Sysname] irf auto-update enable
irf domain
Use irf domain to assign a domain ID to an IRF fabric.
Use undo irf domain to restore the default IRF domain setting.
Syntax
irf domain domain-id
undo irf domain
Default
IRF domain ID is 0.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
domain-id: Specifies a domain ID for the IRF fabric. The value range is 0 to 4294967295.
Usage guidelines
This command is available in IRF mode. Changing the operating mode from IRF to standalone can cause loss of the IRF domain setting, even if you have saved the configuration.
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 you use a member in one IRF fabric as the intermediate device for performing LACP MAD or ARP MAD for another IRF fabric, assign the two IRF fabrics different domain IDs to avoid false detection of IRF split.
Examples
# Set the IRF domain ID to 30.
<Sysname> system-view
[Sysname] irf domain 30
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 event report delay is 0 milliseconds.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
interval: Sets the IRF link down report delay in the range of 0 to 2000 milliseconds. If the interval is set to 0, link down events are reported without any delay.
Usage guidelines
This command is available in IRF mode. Changing the operating mode from IRF to standalone can cause loss of the irf link-delay setting, even if you have saved the configuration.
An IRF link down report delay helps avoid link flapping causing frequent IRF splits and merges during a short time.
An IRF port handles link down and link up events, as follows:
· When the IRF link changes from up to down, the port does not immediately report the change to the IRF fabric. If the IRF link state is still down when the delay time is reached, the port reports the change to the IRF fabric.
· When the IRF link changes from down to up, the link layer immediately reports the event to the IRF fabric.
Examples
# Set the IRF link down report delay to 300 milliseconds.
<Sysname> system-view
[Sysname] irf link-delay 300
irf link-status detect enable
Use irf link-status detect enable to enable IRF link failure detection.
Use undo irf link-status detect enable to disable this function.
Syntax
irf link-status detect enable
undo irf link-status detect enable
Default
The IRF link failure detection is enabled.
Views
System view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
This command is available in IRF mode. Changing the operating mode from IRF to standalone can cause loss of the undo irf link-status detect enable command configuration, even if you have saved the configuration.
After the IRF link failure detection is enabled, the system automatically examines the status of each IRF physical link to discover IRF link failure events.
Examples
# Disable the IRF link failure detection.
<Sysname> system-view
[Sysname] undo irf link-status detect enable
irf link-status auto-recovery enable
Use irf link-status auto-recovery enable to enable the IRF link failure auto recovery.
Use undo irf link-status auto-recovery enable to disable this function.
Syntax
irf link-status auto-recovery enable
undo irf link-status auto-recovery enable
Default
The IRF link failure auto recovery is enabled.
Views
System view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
The IRF link failure auto recovery enables the system to recover the failed IRF links automatically.
This command is available in IRF mode. Changing the operating mode from IRF to standalone can cause loss of the undo irf link-status auto-recovery enable command configuration, even if you have saved the configuration.
The command setting does not take effect if the IRF link failure detection is disabled.
Examples
# Disable the IRF link failure auto recovery.
<Sysname> system-view
[Sysname] undo irf link-status auto-recovery enable
irf mac-address persistent
Use irf mac-address persistent to configure IRF bridge MAC persistence so the IRF fabric continues using the bridge MAC address of the old master as its bridge MAC address for a period of time after a master re-election.
Use undo irf mac-address persistent to enable the IRF fabric to change its bridge MAC address as soon as the master leaves.
Syntax
irf mac-address persistent { always | timer }
undo irf mac-address persistent
Default
Bridge MAC address of the IRF fabric does not change after the master leaves.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
always: Enables the IRF bridge MAC address to be permanent regardless of master re-election or leaving of the master.
timer: Enables the IRF bridge MAC address to remain the same for 6 minutes after the master device leaves. If the device rejoins the IRF fabric before the time limit is reached, the IRF bridge MAC address does not change. If not, the IRF fabric uses the bridge MAC address of the new master as the IRF bridge MAC address.
Usage guidelines
Bridge MAC persistence is available in IRF mode. Changing the operating mode from IRF to standalone can cause loss of the bridge MAC persistence setting, even if you have saved the configuration.
An IRF fabric by default uses the bridge MAC address of the master device as its bridge MAC address. This bridge MAC address is used by Layer 2 protocols, for example, LACP, to identify the IRF fabric, and must be unique on a switched LAN for proper communication.
To avoid duplicate bridge MAC addresses, an IRF fabric can automatically change its bridge MAC address after its master leaves, but the change causes temporary service interruption. Depending on your network condition, you can enable the IRF fabric to preserve or change its bridge MAC address after the master leaves.
If ARP MAD is used, execute the undo irf mac-address persistent command to enable immediate bridge MAC address change after a master leaves.
If VRRP load balancing is used, execute the irf mac-address persistent always command to prevent the IRF bridge MAC address from changing. For more information about VRRP, see High Availability Configuration Guide.
If two IRF fabrics have the same bridge MAC address, they cannot merge.
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 a 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 device operates in standalone mode and has no member ID.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
member-id: Assigns an IRF member ID to the device. Value range is 1 to 4.
Usage guidelines
You must assign an IRF member ID to a device before enabling its IRF mode. The member ID takes effect after the 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 member-id renumber new-member-id command. The new member ID takes effect at reboot.
Examples
# Assign member ID 2 to the device in standalone mode.
<Sysname> system-view
[sysname] irf member 2
Info: Member ID change will take effect after the member reboots and operates in IRF mode.
Related commands
irf member renumber
irf member description
Use irf member description to configure a description for an IRF member.
Use undo irf member description to restore the default.
Syntax
irf member member-id description text
undo irf member member-id description
Default
No description is configured for any IRF member.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
member-id: Specifies the ID of an IRF member.
text: Configures the IRF member description, a string of 1 to 127 characters.
Usage guidelines
Configure a description to identify the physical location or purpose of an IRF member for easy maintenance.
This command is available in IRF mode. Changing the operating mode from IRF to standalone can cause loss of the IRF member description, even if you have saved the configuration.
Examples
# Configure a description for IRF member 1.
<Sysname> system-view
[Sysname] irf member 1 description F1Num001
irf member priority
Use irf member priority to change the priority of an IRF member.
Use undo irf member priority to restore the default.
Syntax
irf member member-id priority priority
undo irf member member-id priority
Default
IRF member priority is 1.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
member-id: Specifies an IRF member ID.
priority: Sets priority in the range of 1 to 32.
Usage guidelines
Change member priority assignment to affect the maser election result. The greater the priority value, the higher the priority. A member with higher priority is more likely to be the master.
This command is available in IRF mode. The new priority setting takes effect at the next master election, and does not trigger master election.
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
irf priority
irf member renumber
Use irf member renumber to change the member ID of a device in the IRF fabric.
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
In IRF mode, the device by default uses the member ID set by using the irf member command.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
member-id: Specifies the ID of an IRF member device, in the range of 1 to 4.
new-member-id: Assigns a new ID to the IRF member device, in the range of 1 to 4.
Usage guidelines
|
|
CAUTION: In IRF mode, an IRF member ID change can invalidate member ID relevant settings (including interface and file path settings) and even cause data loss. Be sure you fully understand its impact on your live network. |
Before enabling IRF mode, you must use the irf member command to assign a unique member ID to each member device in standalone mode. If two member devices have the same member ID, they cannot join the same IRF fabric.
After IRF mode is enabled, change member IDs before making any other configuration.
After an IRF fabric is formed, make sure you understand the impact of the member ID change on your network.
The new IRF member ID, including the one set by using the undo irf member renumber command, takes effect after you reboot the member device.
To cancel the change before you reboot the member device, use the undo irf member renumber command. This command loses effect after you reboot the member device.
Examples
# Change the member ID of an IRF member from 2 to 4.
<Sysname> system-view
[Sysname] irf member 2 renumber 4
Renumbering the member ID may result in configuration change or loss. Continue?[Y/N]y
# Before rebooting the device, cancel the change in the preceding example.
[Sysname] undo irf member 2 renumber
Renumbering the member ID may result in configuration change or loss. Continue?[Y/N]y
If you reboot the device after executing the irf member 2 renumber 4 command, the device member ID changes to 4 at system reboot. Using undo irf member 2 renumber cannot restore the member ID to 2.
Related commands
irf member
irf mode enhanced
Use irf mode enhanced to enable enhanced IRF mode.
Use undo irf mode enhanced to restore the default.
Syntax
irf mode enhanced
undo irf mode enhanced
Default
The enhanced IRF mode is disabled.
Views
System view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
The enhanced IRF mode allows you to create an IRF fabric that has up to four member devices. However, the enhanced IRF mode may downgrade the performance of some modules. You can enable enhanced IRF mode in both standalone and IRF modes.
Follow these guidelines when you configure the enhanced IRF mode:
· Each member device must have two MPUs.
· The member devices must be in ring topology and have no relay device in between.
· Connect every downstream device to each IRF member device and assign these links to one link aggregation group.
· Do not create MDCs on IRF member device, because the mdc mdc-name [ id mdc-id ] command is mutually exclusive with the irf mode enhanced command. For more information about MDC, see Fundamentals Configuration Guide.
· The enhanced IRF mode can be enabled directly in standalone mode.
· In IRF mode, follow these guidelines to enable the enhanced IRF mode:
? If no Layer 3 (route mode) Ethernet interfaces exist, you can enable enhanced IRF mode directly.
? If Layer 3 Ethernet interfaces exist, you must first change them to Layer 2 (bridge mode) Ethernet interfaces at the prompt.
For more information about Layer 3 Ethernet interfaces, see Interface Configuration Guide.
· Use the save command to save the configuration after you enable the enhanced IRF mode.
· To successfully disable enhanced IRF mode with the undo irf mode enhanced command after you enable it in IRF mode, make sure that the IRF fabric has no more than two member devices and each member device has only one IRF port to which one or more physical ports are bound.
· To successfully merge IRF fabrics, make sure the enhanced IRF mode is enabled or disabled on each member device. Devices that use different enhanced IRF mode settings cannot merge into one IRF fabric.
· To merge IRF fabrics operating in enhanced IRF mode, you must manually reboot at least the (M-1) member devices to complete the IRF merge. (The letter "M" represents the total number of member devices in all IRF fabrics.)
After the enhanced IRF mode is enabled, you cannot create Layer 3 Ethernet interfaces or subinterfaces or Layer 3 aggregate interfaces or subinterfaces.
Examples
# Enable enhanced IRF mode in standalone mode.
<Sysname> system-view
[Sysname] irf mode enhanced
# Enable enhanced IRF mode in IRF mode.
<Sysname> system-view
[Sysname] irf mode enhanced
irf priority
Use irf priority to assign an IRF member priority to a device in standalone mode.
Use undo irf priority to restore the default.
Syntax
irf priority priority
undo irf priority
Default
IRF member priority is 1.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
priority: Specifies an IRF member priority value in the range of 1 to 32.
Usage guidelines
Member priority is used for role election. The greater the priority value, the higher the priority. A member with higher priority is more likely to be the master.
The member priority configured in standalone mode takes effect after you enable IRF mode.
To change the member priority of a device in IRF mode, use the irf member member-id priority priority command. The new priority setting takes effect at the next master election, and does not trigger master election.
Examples
# Assign IRF member priority 32 to the device in standalone mode.
[Sysname] system-view
[sysname] irf priority 32
irf member priority
irf slot member
Use irf slot member to change the member ID of one IRF member on its standby MPU for fast restoring IRF configuration for another IRF member.
Syntax
In standalone mode:
irf slot slot-number member member-id
In IRF mode:
irf chassis chassis-number slot slot-number member member-id
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
slot slot-number: Specifies the standby MPU by its slot number.
chassis chassis-number slot slot-number: Specifies the standby MPU of the IRF member operating normally. The chassis-number argument represents the member ID of the IRF member, and the slot-number argument represents the slot number of the standby MPU.
member-id: Specifies the member ID of the IRF member that requires IRF configuration restoration.
Usage guidelines
Use the irf slot member commands only for fast-restoring IRF configuration. This command might cause unknown errors in other application scenarios.
If a member device has only one MPU, you must re-configure the basic IRF settings for the device after its MPU is damaged. The irf slot member command is part of the fast IRF restoration solutions. For more information about fast-restoring IRF configuration for one-MPU member, see IRF Configuration Guide.
Examples
# In IRF mode, set the member ID of member 2 to 1 on its standby MPU in slot 1.
<Sysname> irf chassis 2 slot 1 member 1
irf-port member-id/port-number
Use irf-port member-id/port-number to enter IRF port view in IRF mode.
Use undo irf-port member-id/port-number to removing all port bindings on an IRF port in IRF mode.
Syntax
irf-port member-id/port-number
undo irf-port member-id/port-number
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
member-id/port-number: Specifies an IRF port on an IRF member. The member-id argument represents the ID of the IRF member. The port-number argument represents the IRF port index and must be 1 or 2.
Usage guidelines
To set up an IRF link between two devices, you must enter IRF port view to bind physical ports to the IRF port used by each device for IRF connection.
Before removing all port bindings on an IRF port, shut down all its physical ports.
Examples
# In IRF mode, enter the view of IRF-port 1 on member 1.
<Sysname> system-view
[Sysname] irf-port 1/1
[Sysname-irf-port1/1]
port group interface
irf-port port-number
Use irf-port port-number to enter IRF port view in standalone mode.
Use undo irf-port port-number to remove all port bindings on an IRF port in standalone mode.
Syntax
irf-port port-number
undo irf-port port-number
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
port-number: Specifies an IRF port number, which must be 1 or 2.
Usage guidelines
To set up an IRF link between two devices, you must enter IRF port view to bind physical ports to the IRF port used by each device for IRF connection.
Before removing all port bindings on an IRF port, shut down all its physical ports.
Examples
# In standalone mode, enter IRF-port 1 view.
<Sysname> system-view
[Sysname] irf-port 1
[Sysname-irf-port1]
Related commands
port group interface
irf-port-configuration active
Use irf-port-configuration active to activate IRF port settings.
Syntax
irf-port-configuration active
Views
System view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
After connecting the physical ports between two devices and binding them to the correct IRF ports, you must manually activate the settings on the IRF ports to merge the two devices into one IRF fabric.
You do not need to activate the IRF port settings if the configuration file that the device starts with has included IRF port bindings or you are binding more physical ports to an IRF port after an IRF fabric is formed. The system automatically does the work.
Examples
To configure and activate IRF port 1/2:
# Create IRF port 1/2, and bind Ten-GigabitEthernet 3/1/0/27 to it.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/0/27
[Sysname-Ten-GigabitEthernet3/1/0/27] shutdown
[Sysname-Ten-GigabitEthernet3/1/0/27] quit
[Sysname] irf-port 1/2
[Sysname-irf-port1/2] port group interface ten-gigabitethernet 3/1/0/27
You are recommended to save the configuration after completing your IRF configu
ration; otherwise, it may be lost after system reboot.
[Sysname-irf-port1/2] quit
[Sysname] interface ten-gigabitethernet 3/1/0/27
[Sysname-Ten-GigabitEthernet3/1/0/27] undo shutdown
[Sysname-Ten-GigabitEthernet3/1/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 settings.
[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
Layer 3 interface view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
To avoid conflicts, do not use ARP MAD together with LACP MAD in an IRF fabric. However, you can use ARP MAD together with BFD MAD.
ARP MAD detects multi-active collisions by using extended ARP packets.
You can set up ARP MAD links between neighbor IRF members or more commonly, between each IRF member device and an intermediate device.
If the intermediate device is also in an IRF fabric, make sure the two IRF fabrics have different IRF domain IDs to avoid false detection of IRF splits.
You can enter the domain ID when you use the mad arp enable command. If the IRF fabric already has a unique domain ID in accordance with the network planning, press Enter to skip the step.
The IRF domain ID takes effect on all MDCs.
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
VLAN interface view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
To avoid conflicts, do not use BFD MAD together with LACP MAD in an IRF fabric. However, you can use BFD MAD together with ARP MAD.
BFD MAD uses the BFD protocol for detecting multi-active collisions, and can work with or without intermediate devices.
When you configure BFD MAD, follow these guidelines:
· You cannot enable BFD MAD on VLAN-interface 1.
· Do not use the BFD MAD VLAN for any other purpose. No Layer 2 or Layer 3 features, including ARP and LACP, can work on the BFD MAD-enabled VLAN interface or any port in the VLAN. If you configure any other feature on the VLAN, neither the configured feature nor the BFD MAD function can work correctly.
· If a trunk port is assigned to the BFD MAD VLAN, make sure the default VLAN of that port is not used for BFD MAD. If you configure the default VLAN to perform BFD MAD, other services configured on the port may work abnormally.
· Do not enable the spanning tree function on any port in a BFD MAD VLAN. The MAD function is mutually exclusive with the spanning tree function.
· Do not bind the VLAN interface to any VPN. The MAD function is mutually exclusive with VPN.
· To avoid anomalies, do not use any other command than the mad ip address command to configure IP addresses on the BFD MAD-enabled VLAN interface. For example, an IP address configured with the ip address command or a VRRP virtual IP address can cause problems.
· If an intermediate device is used, you must assign the ports of the BFD MAD links to the BFD MAD VLAN on the intermediate device.
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
mdc-admin
Usage guidelines
LACP MAD handles collisions in a different way than BFD MAD and ARP MAD. To avoid conflicts, do not enable LACP MAD together with BFD MAD or ARP MAD in an IRF fabric. However, you can use BFD MAD and ARP MAD together.
LACP MAD uses extended LACP packets for detecting multi-active collisions and requires an intermediate H3C device that also supports LACP MAD packets.
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 the intermediate device is also in an IRF fabric, make sure the two IRF fabrics have different domain IDs to avoid false detection of IRF splits.
You can enter the domain ID when you use the mad enable command. If the IRF fabric already has a unique domain ID in accordance with the network planning, press Enter to skip the step.
The IRF domain ID takes effect on all MDCs.
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] 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.
mad exclude interface
Use mad exclude interface to exclude a physical network port from being shut down when the IRF fabric transitions 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 network ports but the IRF physical ports and console port shut down when the IRF fabric transitions to the Recovery state.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
interface-type interface-number: Specifies a port by its type and number.
Usage guidelines
MAD action is not configurable for IRF physical ports.
When MAD detects that an IRF fabric has split into two or more identical active IRF fabrics, only the IRF fabric whose master has the lowest member ID among all the masters can still forward data traffic. MAD changes its status to Recovery on all the other IRF fabrics and shuts down all their physical ports except the physical IRF ports and those manually configured to not shut down.
If a port must be kept in up state for special purposes such as Telnet connection, exclude it from the shutdown action. To avoid problems, H3C recommends excluding only the one used for Telnet for the management purpose.
The ports that have shut down by MAD come up when the member devices reboot to join the recovered IRF fabric. If auto recovery fails because the current master fails or any other exception occurs, use the mad restore command to manually recover the member devices and bring up the ports.
Examples
# Exclude GigabitEthernet 2/3/0/1 from being shut down when the MAD status transitions to Recovery.
<Sysname> system-view
[Sysname] mad exclude interface gigabitethernet 2/3/0/1
mad ip address
Use mad ip address to assign a MAD IP address to an IRF member on a VLAN interface 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 on any VLAN interface.
Views
VLAN interface view
Predefined user roles
network-admin
mdc-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 dotted decimal notation.
mask-length: Specifies a subnet mask in length, in the range of 0 to 32.
member member-id: Specifies an IRF member ID.
Usage guidelines
To use BFD MAD, configure a MAD IP address on a BFD MAD-enabled VLAN interface for each IRF member, and make sure all the MAD IP addresses are on the same subnet.
To avoid anomalies, do not use any other command than the mad ip address command to configure IP addresses on the BFD MAD-enabled VLAN interface. For example, an IP address configured with the ip address command or a VRRP virtual IP address can cause problems.
The master tries to establish BFD sessions with other members 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 is effective, and 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, and the two 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 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
mdc-admin
Usage guidelines
When MAD detects that an IRF fabric has split into multiple IRF fabrics, only the one whose master has the lowest member ID among all the masters can still forward traffic. All the other fabrics are set in Recovery state and cannot forward traffic.
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 to 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 port to an IRF port.
Use undo port group interface to remove the binding of a physical port and an IRF port.
Syntax
port group [ mdc mdc-id ] interface interface-type interface-number
undo port group [ mdc mdc-id ] interface interface-name
Default
No physical ports are bound to any IRF port.
Views
IRF port view
Predefined user roles
network-admin
mdc-admin
Parameters
mdc mdc-id: Specifies the ID for an MDC, in the range of 1 to 4. If an MDC is specified, this command binds physical ports on the MDC to an IRF port. If no MDC is specified, this command binds physical ports on the default MDC to an IRF port.
interface-type interface-number: Specifies a physical port by its type and number.
interface-name: Specifies a physical port in the interface-typeinterface-number format. No space is allowed between the interface-type and interface-number arguments.
Usage guidelines
The MDC settings may lose effect after the device reboots to join an IRF fabric. H3C recommends creating an MDC and binding its physical ports to an IRF port after the IRF fabric is formed. For more information about MDC, see Fundamentals Configuration Guide.
In IRF mode, use the shutdown command to shut down the physical port before binding it to the IRF port or removing it from the IRF port. After the binding operation is complete, use the undo shutdown command to bring up the physical port, and execute the irf-port-configuration active command to active the IRF port configuration. After the binding removal operation is complete, use the undo shutdown command to bring up the physical port.
In standalone mode, the shutdown and undo shutdown operations are not required.
Repeat the port group interface command to bind up to 12 physical ports to an IRF port for link redundancy.
The system does not dynamically remove the binding between a physical port and an IRF port, even if the IRF link has been lost, for example, because the interface card holding the physical port is removed. To remove the binding, first shut down the physical port and then use the undo port group interface command. If the interface card holding the physical port is removed, you do not need to execute the shutdown command before removing the binding.
Examples
# In standalone mode, bind port Ten-GigabitEthernet 2/0/1 to IRF-port 1.
<Sysname> system-view
[Sysname] irf-port 1
[Sysname-irf-port1] port group interface ten-gigabitethernet 2/0/1
# In IRF mode, bind port Ten-GigabitEthernet 1/2/0/1 to IRF-port 1 of member 1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/2/0/1
[Sysname-Ten-GigabitEthernet1/2/0/1] shutdown
[Sysname-Ten-GigabitEthernet1/2/0/1] quit
[Sysname] irf-port 1/1
[Sysname-irf-port1/1] port group interface ten-gigabitethernet 1/2/0/1
[Sysname-irf-port1/1] quit
[Sysname] interface ten-gigabitethernet 1/2/0/1
[Sysname-Ten-GigabitEthernet1/2/0/1] undo shutdown
Related commands
irf-port
