Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 01-IRF Commands | 210.35 KB |
chassis convert mode irf
Syntax
chassis convert mode irf
undo chassis convert mode
View
System view
Default level
3: Manage level
Parameters
None
Description
Use chassis convert mode irf to enable IRF mode.
Use undo chassis convert mode to restore standalone mode.
By default, the device operates in standalone mode.
To set up an IRF fabric, place all its member devices in IRF mode after configuring their member IDs, priorities, and IRF port settings. In standalone mode, a device cannot form an IRF fabric with other devices.
IRF generates packets on a device in IRF mode even if the device does not form an IRF fabric with any other device. To conserve system resources, set a device to operate in standalone mode after removing it from an IRF fabric.
Save any configuration you have made to avoid data loss before changing the device to operate in a different mode, because the device will reboot automatically 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.
The base cards and sub-cards can operate only when the device operates in standalone mode. Before switching the operating mode, check whether the related services will be affected. For more information about base cards and sub-cards, see H3C S9500E Series Routing Switches Installation Guide.
For a device operating in IRF mode, you cannot configure the system operating mode to hybrid. For more information about the system operating mode, see Fundamentals Configuration Guide.
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 stand-alone mode? [Y/N]:y
Please wait...
Saving the converted configuration file to the main board succeeded.
Chassis 2 Slot 1:
Saving the converted configuration file succeeded.
Now rebooting, please wait...
display irf
Syntax
display irf [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display irf to display IRF fabric information, including the member ID, role, priority, bridge MAC address, and description of each IRF member.
Examples
# Display information about the IRF fabric.
<Sysname> display irf
Switch Slot Role Priority CPU-Mac Description
*+1 0 Master 1 00e0-fc0a-15e0 F1Num001
1 1 Slave 1 00e0-fc0f-8c02 F1Num002
------------------------------------------------------
* indicates the device is the master.
+ indicates the device through which the user logs in.
The Bridge MAC of the IRF is: 000f-e26a-58ed
Auto upgrade : no
Mac persistent : always
Domain ID : 30
Auto merge : No
Table 1 Command output
|
Field |
Description |
|
Switch |
IRF member ID: · ID of the master is prefixed with an asterisk (*) sign. · ID of the device where you are logged in is prefixed with a plus (+) sign. |
|
Slot |
MPU slot number. |
|
Role |
Role of the MPU in the IRF fabric: · Slave—Standby MPU for the global active MPU. · Master—Global active MPU. · SlaveWait—MPU that is joining the IRF fabric as a standby for the global active MPU. · Loading—Standby MPU for the global active MPU. The standby MPU is loading system software image. |
|
CPU-MAC |
CPU MAC address of 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. · no—Disabled. |
|
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. |
|
Domain ID |
Domain ID assigned to the IRF fabric. A domain ID is used to uniquely identify an IRF fabric when there are multiple IRF fabrics in the network. |
|
Auto merge |
Whether the auto-reboot for IRF fabric merge is enabled: · yes—Enabled. · no—Disabled. |
display irf configuration
Syntax
display irf configuration [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display irf configuration to display basic IRF settings.
In standalone mode, this command displays the member ID, priority, and IRF port bindings of the device. These settings take effect after you enable IRF mode.
In IRF mode, this command displays each member's current member ID, new member ID, and IRF port bindings. The new member ID settings take effect at the next startup.
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/12/0/1
Ten-GigabitEthernet2/12/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 operates in standalone mode. |
|
New-ID |
Member ID assigned to the device. This member ID takes effect at reboot. This field is displayed only when the device operates in IRF mode. |
|
IRF-Port1 |
Physical ports bound to IRF-port 1. If no physical port is bound to the IRF port, this field displays disable. |
|
IRF-Port2 |
Physical ports bound to IRF-port 2. If no physical port is bound to the IRF port, this field displays disable. |
display irf link
Syntax
display irf link
View
Any view
Default level
1: Monitor level
Parameters
None
Description
Use display irf link to display IRF link information, including the IRF ports, physical IRF ports and IRF link status.
Examples
# Display IRF link information.
<Sysname>display irf link
Member 1
IRF Port Interface Status
1 disable --
2 GigabitEthernet1/3/0/1 UP
GigabitEthernet1/5/0/1 ADM
GigabitEthernet1/6/0/1 DOWN
Member 2
IRF Port Interface Status
1 GigabitEthernet2/3/0/1 UP
GigabitEthernet2/5/0/1 DOWN
GigabitEthernet2/6/0/1 ADM
2 disable --
Table 3 Command output
|
Field |
Description |
|
Member ID |
IRF member ID. |
|
IRF Port |
IRF port number: · 1—IRF-port 1. · 2—IRF-port 2. |
|
Interface |
Physical ports bound to the IRF port. 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. |
display irf topology
Syntax
display irf topology [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display irf topology to display IRF fabric topology information, including the member IDs, IRF port state, adjacencies of IRF ports, and CPU MAC address of the master.
Examples
# Display the IRF fabric topology.
<Sysname> display irf topology
Topology Info
-------------------------------------------------------------------------
IRF-Port1 IRF-Port2
Switch Link neighbor Link neighbor Belong To
1 DIS -- UP 2 00e0-fc0f-8c0f
2 UP 1 DOWN -- 00e0-fc0f-8c0f
Table 4 Command output
|
Field |
Description |
|
Switch |
This field displays member ID. |
|
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
Syntax
display mad [ verbose ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
verbose: Displays detailed MAD information. If this keyword is not provided, the command only displays whether a MAD mechanism is enabled.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display mad to display MAD status and settings.
Examples
# Display brief MAD information.
<Sysname> display mad
MAD LACP enabled.
MAD BFD disabled.
MAD ARP 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-GigabitEthernet1/2/0/25
Ten-GigabitEthernet2/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 |
Status of MAD detection: · Detect—The IRF fabric is integrated. · Recovery—The IRF fabric is in Recovery state. When detecting a multi-active collision, MAD places the IRF fabric with higher master ID in Recovery state. MAD also shuts down all physical ports in the fabric except IRF physical ports and ports that are configured to not shut down. · Detect to Recovery—The state of the IRF fabric is changing from Detect to Recovery, for example, as the result of an IRF split. · Recovery to Detect—The state of the IRF fabric is changing from Recovery to Detect when the failed IRF link is recovered. |
|
Excluded ports (configurable) |
Ports manually configured to not shut down when the IRF fabric transits to the Recovery state. |
|
Excluded ports (can not be configured) |
Ports set by default to not shut down when the IRF fabric transits to the Recovery state. |
|
MAD enabled aggregation port |
Aggregate interface where LACP MAD is enabled. |
display restricted port
Syntax
display restricted port [ chassis chassis-number [ slot slot-number ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
chassis chassis-number [ slot slot-number ]: Specifies an IRF member device or a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device, and the slot-number argument represents the slot number of the card. To display the member ID and slot number, use the display device command. If you specify an IRF member device without specifying a card, this command displays all restricted ports on the device. If neither IRF member ID nor card slot number is specified, this command displays all restricted ports in the IRF fabric.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display restricted port to display restricted ports.
A restricted port in the system does not 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
Table 6 Command output
|
Field |
Description |
|
Chassis |
Member ID of the device. |
irf auto-merge enable
Syntax
irf auto-merge enable
undo irf auto-merge enable
View
System view
Default level
3: Manage level
Parameters
None
Description
Use irf auto-merge enable to enable auto reboot for IRF fabric merge. The function enables an IRF fabric to reboot its member devices automatically if it fails in the master election during an IRF fabric merge.
Use undo irf auto-merge enable to disable this function.
By default, this function is disabled. To complete an IRF fabric merge, you must manually reboot the IRF fabric that has failed in the master election.
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 only when the device is operating in IRF mode. When the operating mode is changed to standalone, the configuration of this command is lost, regardless of whether 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.
For an IRF fabric that uses a relay device, a relay link failure on the relay device does not cause immediate IRF split. Instead, the IRF fabric splits only if the link fails to recover within 20 seconds. If an IRF merge occurs when the relay link recovers, the IRF fabric part that fails in the master election reboots its member devices automatically to complete the merge, regardless of whether the auto merge function is enabled.
Examples
# Enable auto reboot for the IRF fabric merge.
<Sysname> system-view
[Sysname] irf auto-merge enable
irf auto-update enable
Syntax
irf auto-update enable
undo irf auto-update enable
View
System view
Default level
3: Manage level
Parameters
None
Description
Use irf auto-update enable to enable the software auto-update function for propagating the system software image of the master to all its members.
Use undo irf auto-update enable to disable the software auto-update function.
By default, this function is enabled.
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.
When you add a device to the IRF fabric, the software auto-update function compares the system software versions of the device and the IRF master. If the versions are different, the device performs the following tasks automatically:
1. Downloads the system software image from the master.
2. Sets the downloaded image as the system software for the next startup.
3. Reboots with the new system software image to rejoin the IRF fabric.
To avoid an update failure, make sure the device has efficient storage space for the new system software image.
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. The wider the software version gap, the higher the failure risk. For more information about the software version, see the release note for that version.
When the master is propagating its system software image 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 function is disabled, you must manually update the device with the system software image of the master before adding it to the IRF fabric.
Examples
# Enable the software auto-update function.
<Sysname> system-view
[Sysname] irf auto-update enable
irf domain
Syntax
irf domain domain-id
undo irf domain
View
System view
Default level
3: Manage level
Parameters
domain-id: Specifies a domain ID for the IRF fabric. The value range is 0 to 4294967295.
Description
Use irf domain to assign a domain ID to an IRF fabric.
Use undo irf domain to restore the default.
By default, the domain ID of an IRF fabric is 0.
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 one IRF fabric as the intermediate device for LACP MAD or ARP MAD for another IRF fabric, assign the two IRF fabrics different domain IDs for correct split detection. False detection causes IRF split.
Examples
# Set the domain ID of the IRF fabric to 30.
<Sysname> system-view
[Sysname] irf domain 30
irf link-delay
Syntax
irf link-delay interval
undo irf link-delay
View
System view
Default level
3: Manage level
Parameters
interval: Sets the IRF link down report delay in milliseconds. The value range is 200 to 2000. If the interval is set to 0, link down events are reported without any delay.
Description
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.
By default, if an IRF link changes from up to down, the IRF port immediately reports the event to the IRF fabric.
An IRF link down report delay helps avoid link flapping. Link flapping causes 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.
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.
Examples
# Set the IRF link down report delay to 300 milliseconds.
<Sysname> system-view
[Sysname] irf link-delay 300
irf link-status detect enable
Syntax
irf link-status detect enable
undo irf link-status detect enable
View
System view
Default level
3: Manage level
Parameters
None
Description
Use irf link-status detect enable to enable IRF link failure detection.
Use undo irf link-status detect enable to disable IRF link failure detection.
By default, IRF link failure detection is enabled.
IRF link failure detection checks the health of IRF links automatically. Use this function when your IRF fabric has more than one IRF link.
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.
Examples
# Disable IRF link failure detection.
<Sysname> system-view
[Sysname] undo irf link-status detect enable
irf link-status auto-recover enable
Syntax
irf link-status auto-recover enable
undo irf link-status auto-recover enable
View
System view
Default level
3: Manage level
Parameters
None
Description
Use irf link-status auto-recover enable to enable IRF link auto-recovery.
Use undo irf link-status auto-recover enable to disable IRF link auto-recovery.
By default, IRF link auto-recovery is enabled.
IRF link auto-recovery enables the device to automatically recover a failed link that has been detected by the IRF link failure detection function.
You can enable the IRF link auto-recovery function only when the IRF link failure detection function is enabled.
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-recover enable command configuration even if you have saved the configuration.
Examples
# Disable IRF link auto-recovery.
<Sysname> system-view
[Sysname] undo irf link-status auto-recover enable
irf mac-address persistent
Syntax
irf mac-address persistent { always | timer }
undo irf mac-address persistent
View
System view
Default level
3: Manage level
Parameters
always: Enables the IRF bridge MAC address to be permanent. The IRF bridge MAC address does not change after master re-election.
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.
Description
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 master leaves.
By default, the bridge MAC address of the IRF fabric does not change after the master leaves.
IRF bridge MAC persistence specifies the amount of time an IRF fabric can continue using the old master bridge MAC address as its bridge MAC address after a master re-election.
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, regardless of whether you have saved the configuration.
An IRF fabric by default uses the bridge MAC address of the master device as its bridge MAC address. Layer 2 protocols, such as LACP, use this bridge MAC address to identify the IRF fabric. On a switched LAN, the bridge MAC address must be unique.
To avoid duplicate bridge MAC addresses, an IRF fabric can change its bridge MAC address automatically after its master leaves. However, the change causes temporary service disruption. 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
Syntax
irf member member-id
undo irf member
View
System view
Default level
3: Manage level
Parameters
member-id: Sets an IRF member ID for the device. The value range is 1 to 4.
Description
Use irf member to assign a member ID to a device in standalone mode.
Use undo irf member to restore the default.
By default, the device operates in standalone mode and has no member ID. After it switches to the IRF mode, it uses the member ID configured in standalone mode.
An IRF fabric uses member IDs to uniquely identify and manage members. You must assign an IRF member ID to a device before enabling its IRF mode.
When the operating mode of the device changes from standalone to IRF, the member ID of the device is needed for the auto-conversion of the configuration file.
To assign a member ID to the device when it operates in standalone mode, use the irf member command, and the member ID takes effect after the IRF mode is enabled. 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.
Related commands: irf member renumber.
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 switch reboots and operates in IRF mode
irf member description
Syntax
irf member member-id description text
undo irf member member-id description
View
System view
Default level
3: Manage level
Parameters
member-id: Specifies the ID of an IRF member.
text: Configures the IRF member description, a string of 1 to 127 characters.
Description
Use irf member description to configure a description for an IRF member.
Use undo irf member description to restore the default.
By default, no description is configured for any IRF member.
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
Syntax
irf member member-id priority priority
undo irf member member-id priority
View
System view
Default level
3: Manage level
Parameters
member-id: Specifies the ID of an IRF member, in the range of 1 to 4.
priority: Specifies the priority value in the range of 1 to 32. The greater the priority value, the higher the priority. A member with a higher priority is more likely to be a master.
Description
Use irf member priority to change the priority of an IRF member in IRF mode.
Use undo irf member priority to restore the default.
By default, the priority of an IRF member is 1.
Change member priority assignment to affect the maser election result.
This command is available in IRF mode. The new priority setting takes effect at the next master election, but it does not trigger master election.
To assign an IRF priority to a device in standalone mode, use the irf priority command.
Related commands: irf priority.
Examples
# Set the priority of IRF member 2 to 32 in IRF mode.
<Sysname> system-view
[Sysname] irf member 2 priority 32
irf member renumber
Syntax
irf member member-id renumber new-member-id
undo irf member member-id renumber
View
System view
Default level
3: Manage level
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.
Description
|
|
CAUTION: In IRF mode, an IRF member ID change can invalidate member ID-related settings, including interface and file path settings, and cause data loss. Be sure you fully understand its impact on your live network. |
Use irf member renumber to change the member ID of a member in the IRF fabric.
Use undo irf member renumber to set the member ID of a device in the IRF fabric to 1.
In IRF mode, the device by default uses the member ID set by using the irf member command.
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 irf member renumber command rather than its undo form. In the command, set the new member ID to be the same as the old member ID.
To set the member ID of a device in standalone mode, use the irf member command.
Related commands: irf member.
Examples
# Change the member ID of an IRF member from 1 to 2.
<Sysname> system-view
[Sysname] irf member 1 renumber 2
Warning: Renumbering the switch number may result in configuration change or loss. Continue?[Y/N]y
# Cancel the change in the preceding example.
[Sysname] irf member 1 renumber 1
Warning: Renumbering the switch number may result in configuration change or loss. Continue?[Y/N]y
irf mode enhanced
Syntax
irf mode enhanced
undo irf mode enhanced
View
System view
Default level
3: Manage level
Parameters
None
Description
Use irf mode enhanced to enable enhanced IRF mode.
Use undo irf mode enhanced to disable enhanced IRF mode.
By default, the enhanced IRF mode is disabled.
The enhanced IRF mode allows you to create an IRF fabric that has up to four member devices. 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.
· The enhanced IRF mode can be enabled directly in standalone mode.
· In IRF mode, follow these guidelines to enable the enhanced IRF mode:
? If neither Layer 3 (route mode) Ethernet interfaces nor VPLS and MAC-in-MAC instances 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.
? If VPLS or MAC-in-MAC instances exist but no Layer 3 Ethernet interfaces exist, you must first reboot the device at the prompt.
For more information about Layer 3 Ethernet interfaces, see Interface Configuration Guide. For more information about VPLS, see MPLS Configuration Guide. For more information about MAC-in-MAC, see Layer 2—LAN Switching 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 devices into an IRF fabric, make sure that the enhanced IRF mode is enabled or disabled on all the devices. The devices that use different enhanced IRF mode settings cannot form an IRF fabric.
· If the enhanced IRF mode is used, you must reboot all but one member device to complete IRF merge.
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 member 2
[Sysname] irf mode enhanced
[Sysname] save
[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.
# Enable enhanced IRF mode in IRF mode when both Layer 3 Ethernet interfaces and VPLS instances exist.
<Sysname> system-view
[Sysname] irf mode enhanced
Mode switch failed because the enhanced IRF mode does not support the Layer 3 Ethernet interface.
[Sysname] display ip interface brief
*down: administratively down
(s): spoofing
Interface Physical Protocol IP Address Description
GE2/3/0/44 *down down unassigned GigabitEt...
M-E1/0/0/0 up up 192.168.3.125 M-Etherne...
Vlan2 *down down unassigned Vlan-inte...
Vlan3 *down down unassigned Vlan-inte...
Vlan20 down down 20.0.0.1 Vlan-inte...
Vlan300 *down down unassigned Vlan-inte...
Vlan2011 *down down unassigned Vlan-inte...
[Sysname] interface GigabitEthernet 2/3/0/44
[Sysname-GigabitEthernet2/3/0/44] port link-mode bridge
[Sysname-GigabitEthernet2/3/0/44] quit
[Sysname] irf mode enhanced
VSI instances exist. Reboot the switch first. You are recommended to save the current running configuration and specify the configuration file for the next startup. Continue? [Y/N]:y
Please input the file name(*.cfg)[flash:/cfa0516.cfg]
(To leave the existing filename unchanged, press the enter key):
flash:/cfa0516.cfg exists, overwrite? [Y/N]:y
Validating file. Please wait......................................
The current configuration is saved to the active main board successfully.
irf priority
Syntax
irf priority priority
undo irf priority
View
System view
Default level
3: Manage level
Parameters
priority: Specifies the priority value in the range of 1 to 32. A greater value indicates a higher priority.
Description
Use irf priority to assign an IRF member priority to a device in standalone mode.
Use undo irf priority to restore the default.
By default, the IRF member priority is 1.
Member priority is used for role election. The greater the priority value, the higher the priority. A member with a 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 in IRF mode takes effect at the next master election, but it does not trigger master election.
Related commands: irf member priority.
Examples
# Assign IRF member priority 32 to the device in standalone mode.
<Sysname> system-view
[Sysname] irf priority 32
irf switch-to
Syntax
irf switch-to chassis chassis-number slot slot-number
View
System view
Default level
3: Manage level
Parameters
chassis chassis-number slot slot-number: Specifies a standby MPU. The chassis-number argument represents the member ID of the device that has this MPU, and the slot-number argument represents the slot number of the MPU. You can display the member ID and slot number with the display device command.
Description
Use irf switch-to to log in to a standby MPU in the IRF fabric.
When you log in to an IRF fabric, you are placed at the CLI of the global active MPU, regardless of at which member device you are logged in. After that, you can access the CLI of a standby MPU to execute the following maintenance commands:
· display
· quit
· return
· system-view
· debugging
· terminal debugging
· terminal logging
· terminal monitor
· terminal trapping
When you log in to a standby MPU's CLI, you are placed in the standby MPU's user view and the command prompt changes to <Sysname-Slave#member-ID/slot-number>, for example, <Sysname-Slave#1/0>.
To return to the CLI of the global active MPU, use the quit command.
Examples
# Log in to the CLI of the standby MPU in slot 1 of IRF member 1.
[Sysname] irf switch-to chassis 1 slot 1
[Sysname-Slave#1/1]
irf-port member-id/port-number
Syntax
irf-port member-id/port-number
undo irf-port member-id/port-number
View
System view
Default level
3: Manage level
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 value range is 1 to 4. The port-number argument represents the IRF port index and must be 1 or 2.
Description
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.
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 you remove all port bindings on an IRF port, shut down all its physical ports.
Related commands: port group interface.
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] quit
# In IRF mode, enter the view of IRF-port 2 on member 2.
<Sysname> system-view
[Sysname] irf-port 2/2
[Sysname-irf-port2/2] quit
irf-port port-number
Syntax
irf-port port-number
undo irf-port port-number
View
System view
Default level
3: Manage level
Parameters
port-number: Specifies the IRF port number, which must be 1 or 2.
Description
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.
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 you remove all port bindings on an IRF port, shut down all its physical ports.
Related commands: port group interface.
Examples
# In standalone mode, enter the view of IRF-port 1.
<Sysname> system-view
[Sysname] irf-port 1
[Sysname-irf-port1] quit
mad arp enable
Syntax
mad arp enable
undo mad arp enable
View
VLAN interface view
Default level
3: Manage level
Parameters
None
Description
Use mad arp enable to enable ARP MAD.
Use undo mad arp enable to disable ARP MAD.
By default, ARP MAD is disabled.
ARP MAD detects multi-active collisions by using extended gratuitous ARP packets.
You can use ARP MAD with BFD MAD, but not with LACP MAD.
You can set up ARP MAD links between neighbor IRF members or between each IRF member device and an intermediate device.
If the intermediate device is also an IRF fabric, make sure the two IRF fabrics have different IRF domain IDs for correct split detection. False detection causes IRF split.
You must enter the domain ID when you use the mad arp enable command.
Examples
# Enable ARP MAD on VLAN-interface 3.
<Sysname> system-view
[Sysname] interface vlan-interface 3
[Sysname-Vlan-interface3] mad arp enable
This command will enable ARP MAD on the VLAN interface. Continue? [Y/N]: Y
You need to assign a domain ID (range: 0-4294967295)
[Current domain is: 0]: 1
The assigned domain ID is: 1
mad bfd enable
Syntax
mad bfd enable
undo mad bfd enable
View
VLAN interface view
Default level
3: Manage level
Parameters
None
Description
Use mad bfd enable to enable BFD MAD.
Use undo mad bfd enable to disable BFD MAD.
By default, BFD MAD is disabled.
BFD MAD uses the BFD protocol for detecting multi-active collisions, and can work with or without intermediate devices.
You can use BFD MAD with ARP MAD, but not with LACP MAD.
When you configure BFD MAD, follow these guidelines:
|
Category |
Restrictions and guidelines |
|
BFD MAD VLAN |
· Do not enable BFD MAD on VLAN-interface 1. · If you are using an intermediate device, assign the ports of BFD MAD links to the BFD MAD VLAN on the device. · The IRF fabrics in a network must use different BFD MAD VLANs. |
|
BFD MAD VLAN and feature compatibility |
· Do not use the BFD MAD VLAN for any purpose other than configuring BFD MAD. Layer 2 or Layer 3 features, including ARP and LACP, cannot 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 will work correctly. · Disable the spanning tree feature on any port in the BFD MAD VLAN. The MAD function is mutually exclusive with the spanning tree feature. · Do not bind a BFD MAD-enabled VLAN interface to any VPN instance. The MAD function is mutually exclusive with VPN. |
|
MAD IP address |
· To avoid problems, only use the mad ip address command to configure IP addresses on the BFD MAD-enabled VLAN interface. Do not configure an IP address with the ip address command or configure a VRRP virtual address on the BFD MAD-enabled VLAN interface. · All MAD IP addresses on the BFD MAD-enabled VLAN interface must be on the same subnet. |
Examples
# Enable BFD MAD on VLAN-interface 3.
<Sysname> system-view
[Sysname] interface vlan-interface 3
[Sysname-Vlan-interface3] mad bfd enable
This command will enable BFD MAD on the VLAN interface. Continue? [Y/N]: Y
mad enable
Syntax
mad enable
undo mad enable
View
Aggregate interface view
Default level
3: Manage level
Parameters
None
Description
Use mad enable to enable LACP MAD.
Use undo mad enable to disable LACP MAD.
By default, LACP MAD is disabled.
LACP MAD uses extended LACP packets for detecting multi-active collisions and requires an intermediate H3C device that also supports LACP MAD packets.
LACP MAD handles collisions differently than BFD MAD and ARP MAD. To avoid conflicts, do not enable LACP MAD together with BFD MAD and ARP MAD in an IRF fabric. However, you can use BFD MAD and ARP MAD together.
You must set up a dynamic link aggregation group that spans all IRF member devices between the IRF fabric and the intermediate device. To enable dynamic link aggregation, configure the link-aggregation mode dynamic command on the aggregate interface.
If the intermediate device is also an IRF fabric, make sure the two IRF fabrics have different domain IDs for correct split detection. False detection causes IRF split.
You must enter the domain ID when you use the mad enable command.
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
This command will enable LACP MAD on the aggregate interface. Continue? [Y/N]: Y
You need to assign a domain ID (range: 0-4294967295)
[Current domain is: 0]: 1
The assigned domain ID is: 1
Info: 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] mad enable
This command will enable LACP MAD on the aggregate interface. Continue? [Y/N]: Y
You need to assign a domain ID (range: 0-4294967295)
[Current domain is: 0]: 1
The assigned domain ID is: 1
Info: MAD LACP only enable on dynamic aggregation interface.
mad exclude interface
Syntax
mad exclude interface interface-type interface-number
undo mad exclude interface interface-type interface-number
View
System view
Default level
3: Manage level
Parameters
interface-type interface-number: Specifies a port by its type and number.
Description
Use mad exclude interface to exclude a physical network port from being shut down when the IRF fabric transits to the Recovery state upon detection of a multi-active collision.
Use undo mad exclude interface to restore the default MAD action on a physical network port.
By default, all physical network ports but the IRF physical ports and console port shut down when the IRF fabric transits to the Recovery state.
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, it sets one of the IRF fabrics to the Detect state and other IRF fabrics to the Recovery state.
· The Detect-state IRF fabric is active and can continue to forward traffic.
· The Recovery-state IRF fabrics are inactive. MAD shuts down all their physical ports except the physical IRF ports and the ports 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 incorrect traffic forwarding, H3C recommends not excluding any ports except the ports used for Telnet and MAD.
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 IRF fabric transits to Recovery state.
<Sysname> system-view
[Sysname] mad exclude interface GigabitEthernet 2/3/0/1
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
View
VLAN interface view
Default level
3: Manage level
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 in the range of 1 to 4.
Description
Use mad ip address to 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.
By default, no MAD IP address is configured on any VLAN interface.
To use BFD MAD, you must 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 problems, only use the mad ip address command to configure IP addresses on the BFD MAD-enabled VLAN interface. Do not configure an IP address with the ip address command or configure a VRRP virtual address on the BFD MAD-enabled VLAN interface.
The master tries to establish BFD sessions with other members by using its MAD IP address as the source IP address:
· When 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
mad restore
Syntax
mad restore
View
System view
Default level
3: Manage level
Parameters
None
Description
Use mad restore to restore the normal MAD state of the IRF fabric in Recovery state.
When MAD detects that an IRF fabric has split into multiple IRF fabrics, it sets one of the IRF fabrics to the Detect state and other IRF fabrics to the Recovery state.
· The Detect-state IRF fabric is active and can continue to forward traffic.
· The Recovery-state IRF fabrics are inactive. MAD shuts down all their physical ports except the IRF ports and the ports manually configured to not shut down.
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
Syntax
port group interface interface-type interface-number
undo port group interface interface-name
View
IRF port view
Default level
3: Manage level
Parameters
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.
Description
Use port group interface to bind a physical IRF port to an IRF port.
Use undo port group interface to remove the binding of a physical port and an IRF port.
By default, no physical ports are bound to any IRF port.
Except for combo ports, any fiber or copper Ethernet ports can be used for IRF connection. For more information about combo ports, see Interface Configuration Guide.
In IRF mode, use the shutdown command to shut down a physical port before you bind it to or remove it from an IRF port. To bring up the physical port after a binding or binding removal operation, use the undo shutdown command.
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, this situation could occur when the interface card holding the physical port is removed.) To remove the binding, use the undo port group interface command.
Related commands: irf-port.
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 2/2/0/1 on member 2 to IRF-port 1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 2/2/0/1
[Sysname-ten-gigabitethernet2/2/0/1] shutdown
[Sysname-ten-gigabitethernet2/2/0/1] quit
[Sysname] irf-port 2/1
[Sysname-irf-port2/1] port group interface ten-gigabitethernet 2/2/0/1
[Sysname-irf-port2/1] quit
[Sysname] interface ten-gigabitethernet 2/2/0/1
[Sysname-ten-gigabitethernet2/2/0/1] undo shutdown
set irf slot member-id
Syntax
In standalone mode:
set irf slot slot-number member-id member-id
In IRF mode:
set irf chassis chassis-number slot slot-number member-id member-id
View
User view
Default level
2: System level
Parameters
slot slot-number: Specifies a standby MPU by its slot number. (In standalone mode.)
member-id member-id: Specifies the member ID of the IRF member that requires IRF configuration restoration.
chassis chassis-number slot slot-number: Specifies the standby MPU of the IRF member operating correctly. 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. To display member ID and slot number information, use the display device command.
Description
Use set irf slot member-id to change the member ID of one IRF member on its standby MPU for fast restoring IRF configuration for another IRF member.
Use the set irf slot member-id 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 set irf slot member-id 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 standalone mode, set the member ID on the standby MPU in slot 1 to 1.
<Sysname> set irf slot 1 member-id 1
# In IRF mode, set the member ID of member 2 to 1 on its standby MPU in slot 1.
<Sysname> set irf chassis 2 slot 1 member-id 1
