Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 01-IRF Commands | 193.8 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 the chassis convert mode irf command to switch the operating mode of the switch to Intelligent Resilient Framework (IRF) mode.
Use the undo chassis convert mode command to switch the operating mode of the switch to standalone mode.
The switch operates in standalone mode when shipped. If the operating mode is switched, the switch reboots automatically to make the new operating mode take effect. If the operating mode is not switched, the switch operates in the same mode when it reboots.
Configure the operating mode of the switch according to the network requirements: when the operating mode switches to IRF, an IRF fabric is formed even if there is only one member. A one-member IRF fabric also needs to be managed and maintained, and thus consumes system resources. Therefore, if a switch does not need to form an IRF fabric with other switches, you are recommended to configure its operating mode as standalone mode.
Configure the operating mode of the switch according to the network requirements: when the operating mode of the switch switches to IRF, an IRF fabric is formed even if there is only one member. A one-member IRF fabric also needs to be managed and maintained, and thus consumes system resources. Therefore, if a switch does not need to form an IRF fabric with other devices, H3C recommends that you configure its operating mode as standalone mode.
· As soon as you switch the operating mode, the switch automatically reboots to make the changes effective. It is a good practice to save the running configuration before switching operating mode.
· Base cards and the sub-cards can operate only when the switch 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.
· If the member ID of the device is not set, you must first set the member ID of the switch, and then execute the chassis convert mode irf command. To display the member ID of the switch, use the display irf configuration command. If the MemberID field is displayed as —, the member ID of the switch is not set yet.
· To avoid member ID collision with other members when the switch is added into an IRF fabric, plan the member ID of this switch when it operates in standalone mode.
· For a switch operating in IRF mode, you cannot configure the system working mode to hybrid. For more information about the system working mode, see Fundamentals Configuration Guide.
Examples
# Switch the operating mode of the switch from standalone to 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...
# When the switch operates in IRF mode, switch the operating mode of the switch to 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 the display irf command to display information about the IRF fabric.
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 Output description
|
Field |
Description |
|
Switch |
Member ID. The ID of the master is prefixed with an asterisk (*) sign. The ID of the switch where you are logged in is prefixed with a plus (+) sign. |
|
Slot |
Number of the slot on which the active main processing unit (MPU) resides |
|
Role |
Role of a MPU of the IRF fabric: · Slave—Standby MPU of the IRF fabric. · Master—Active MPU of the IRF fabric. · SlaveWait—Standby MPU of the IRF fabric. It is joining the IRF fabric. · Loading—Standby MPU of the IRF fabric. It is loading the system boot file. |
|
CPU-MAC |
Bridge MAC address of the CPU of the switch. |
|
Description |
Description of the member switch (— is displayed if the description of the switch is not configured) If the description of the member switch exceeds one line, … is displayed at the end of the line and the reset information is not displayed. To view the complete description, execute the display current-configuration command. |
|
Auto upgrade |
Whether the auto upgrade of configuration files is enabled: · yes—Enabled. · no—Disabled. |
|
MAC persistent |
Preservation information about the bridge MAC address of the IRF fabric: · 6 min—When the master leaves, the bridge MAC address does not change for six minutes. · always—The bridge MAC address remains unchanged even if the master leaves the IRF fabric. · no—As soon as the master leaves, the IRF fabric uses the bridge MAC address of the newly elected master as its bridge MAC address. |
|
Domain ID |
Domain ID assigned to an 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 the display irf configuration command to display all members’ IRF configurations that take effect after switch reboot.
Examples
# When the switch operates in standalone mode, display all members’ IRF configurations that take effect after switch reboot.
<Sysname> display irf configuration
MemberID Priority IRF-Port1 IRF-Port2
-- 1 disable disable
# When the switch operates in IRF mode, display all members’ IRF configurations that take effect after switch reboot.
<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 Output description
|
Field |
Description |
|
MemberID |
Current member ID of the switch. If this field is displayed as two hyphens (--), the member ID of this switch is not set. |
|
Priority |
Member priority. This field is displayed only when the switch operates in standalone mode. |
|
New-ID |
The member ID configured for a switch after its reboot. This field is displayed only when the switch operates in IRF mode. |
|
IRF-Port1 |
Configuration of IRF–Port1. If it is displayed as multiple ports, it indicates that the IRF port is aggregated from these physical IRF ports; If it is displayed as disable, it indicates that the IRF port is not enabled. |
|
IRF-Port2 |
Configuration of IRF–Port2. If it is displayed as multiple ports, it indicates that the IRF port is aggregated from these physical IRF ports; If it is displayed as disable, it indicates that the IRF port is not enabled. |
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 the display irf topology command to display topology information about the IRF fabric.
Examples
# Display the topology information for the IRF fabric.
<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
The above information shows that IRF-port 2 of member switch 1 connects with IRF-port 1 of member switch 1.
Table 3 Output description
|
Field |
Description |
|
Switch |
Member ID. |
|
IRF-Port 1 |
Information of IRF-Port 1, including link (link state) and neighbor. |
|
IRF-Port 2 |
Information of the IRF-Port 2, including link and neighbor. |
|
Link |
Link state of the IRF port: · UP · DOWN · DIS—The IRF port is not bound to any physical IRF port. · TIMEOUT—The IRF packet has been timed out. |
|
neighbor |
ID of the switch that connects to this IRF port. If the IRF port does not connect to any switch, a hyphen (--) is displayed. |
|
Belong To |
The IRF fabric that the switch belongs to, represented by the CPU MAC address of the master. |
display mad
Syntax
display mad [ verbose ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
verbose: Displays detailed information about the MAD detection. If this keyword is not provided, the system displays brief information about the MAD detection.
|: 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 the display mad command to display information about the MAD detection.
Examples
# Display the enable status of MAD detection.
<Sysname> display mad
MAD LACP enabled.
MAD BFD enabled.
# Display the detailed information about the MAD detection.
<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 4 Output description
|
Field |
Description |
|
MAD LACP enabled |
The LACP MAD is enabled (the output information depends on your configuration). |
|
MAD BFD enabled |
The BFD MAD is enabled (the output information depends on your configuration). |
|
MAD ARP enabled. |
The ARP MAD is enabled. |
|
MAD LACP disabled |
The LACP MAD disabled. |
|
MAD BFD disabled |
The BFD MAD is disabled. |
|
MAD ARP disabled |
The ARP MAD is disabled. |
|
Current MAD status |
Status of MAD detection: · Detect—The IRF fabric is normal. · 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 and shuts down all physical ports in the switch but the IRF ports and the ports that are configured not to shut down. · Detect to Recovery—The state of the IRF fabric is transitioning from detect to recovery due to IRF fabric partition. · Recovery to Detect—The state of the IRF fabric is transitioning from recovery to detect when the failed IRF link is recovered. |
|
Excluded ports (configurable) |
Ports manually configured not to shut down when the IRF fabric transitions to recovery state. |
|
Excluded ports (can not be configured) |
Ports set by default not to shut down when the IRF fabric transitions to recovery state. |
|
MAD enabled aggregation port |
The aggregate interface where LACP MAD is enabled. |
|
MAD BFD enabled interface |
The aggregate interface where BFD MAD is enabled. |
|
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 |
MAD IP addresses in the IRF fabric, including the Layer 3 interface on which the MAD IP is configured, and the MAD IP address of each member switch. |
|
MAD ARP enabled interface |
The interface where ARP 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 a card on an IRF member switch. The chassis-number argument represents the ID of the IRF member switch, and the slot-number argument represents the number of the slot that holds the card. You can display the member ID and slot number with the display device command.
|: 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 the display restricted port command to display restricted ports.
A restricted port in the system does not receive or forward multicast packets.
If you do not provide the slot keyword, the command displays the restricted ports on all cards of the specified member switch.
If you do not provide the chassis and slot keywords, the command displays the restricted ports on all cards in the IRF fabric.
Examples
# Display the restricted ports on the card in slot 4 of the member switch 1.
[Sysname]display restricted port chassis 1 slot 4
Chassis: 1
slot: 4
restricted port:
GigabitEthernet1/4/0/1 GigabitEthernet1/4/0/2e
Table 5 Output description
|
Field |
Description |
|
Chassis |
Member ID of the switch |
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 the irf auto-merge enable command to enable auto reboot for IRF fabric merge. The function enables an IRF fabric to automatically reboot its member switches when it is defeated in the master election during an IRF fabric merge.
Use the undo irf auto-merge enable command 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 been defeated in the master election.
This command is available only when the switch is operating 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 switches. It does not take effect for the IRF merge that occurs when you bind a physical port to an IRF port in IRF mode.
This function can work only when it is enabled on both IRF fabrics that are merging.
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 the irf auto-update enable command to automatically synchronize the boot file of the master switch to the switch you are adding to the IRF fabric.
Use the undo irf auto-update enable command to disable this function.
By default, this function is enabled.
This command is available in IRF mode.
When you add a switch to the IRF fabric, the automatic boot file updating function compares the software versions of the switch and the IRF master. If the versions are different, the switch automatically downloads the boot file from the master, sets the downloaded file as the boot file for the next reboot, and automatically reboots with the new boot file to re-join the IRF fabric.
If this function is disabled, you must manually make sure that the joining switch uses the same boot file as the master switch. If not, the new switch cannot join the IRF fabric.
|
|
IMPORTANT: · Auto upgrade of boot files may not work normally if the software versions of the member switches in an IRF fabric are too different from each other. For more information, see the release notes for the software versions. · During auto upgrade of boot files, make sure all IRF links are OK and do not plug, unplug, or reboot the MPUs of member devices. · Make sure that the switch you are adding to the IRF fabric is compatible with the software version running on the master switch. If not, the automatic boot file updating function cannot correctly work. · After automatically loading the master’s boot file, a slave configures the file as the boot file to be used at the next boot and reboots automatically. · Check that the switch has efficient space for the new boot file. · Changing the operating mode from IRF to standalone can cause the loss of the irf auto-update enable command configuration, even if you have saved the configuration. |
Examples
# Enable the automatic boot file upgrading function on the IRF fabric.
<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 the domain ID assigned to an IRF fabric, ranging from 0 to 4294967295.
Description
Use the irf domain command to assign a domain ID for an IRF fabric.
Use the irf domain command to restore the default.
By default, the domain ID of an IRF fabric is 0.
You may deploy multiple IRF fabrics in one network for various networking applications. Domain IDs are used to differentiate these IRF fabrics.
In a network that applies LACP MAD or ARP MAD detection, if the intermediate switch is in an IRF fabric, you must assign this fabric a different domain ID than the LACP MAD-enabled fabric to avoid false detection of IRF partition.
This command is available only when the switch operates in IRF mode. If you assign a domain ID for an IRF fabric, save the configuration, and then switch the operating mode of an IRF member switch to standalone, this configuration loses effect even if you switch the operating mode of the switch to IRF again. In this case, you need to re-assigned the domain ID as needed.
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: Delay time for the link layer to report a link-down event of an IRF fabric, ranging from 200 to 2000 milliseconds.
Description
Use the irf link-delay command to set the delay time for the link layer to report a link-down event of an IRF fabric.
Use the undo irf link-delay command to restore the default.
By default, the delay time for the link layer to report a link-down event of an IRF fabric is 0 milliseconds.
This command is available only when the switch is operating 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.
Examples
# Set the delay time for the link layer to report a link-down event of the IRF fabric 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 the irf link-status detect enable command to enable IRF link failure detection.
Use the undo irf link-status detect enable command to disable IRF link failure detection.
By default, IRF link failure detection is enabled.
IRF link failure detection automatically checks the health of IRF links. Use this function when your IRF fabric has more than one IRF link.
This command is available only when the switch is operating in IRF mode.
The undo form of the command cannot survive an operating mode switch. It is lost when you switch the operating mode of the switch to standalone, 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-recovery enable
Syntax
irf link-status auto-recovery enable
undo irf link-status auto-recovery enable
View
System view
Default level
3: Manage level
Parameters
None
Description
Use the irf link-status auto-recovery enable command to enable IRF link auto-recovery.
Use the undo irf link-status auto-recovery enable command to disable IRF link auto-recovery.
By default, IRF link auto-recovery is enabled.
IRF link auto-recovery enables the switch to automatically recover a failed link that has been detected by the IRF link failure detection function.
This command is available only when the switch is operating in IRF mode. You can enable the IRF link auto-recovery function only when the IRF link failure detection function is enabled.
The undo form of the command cannot survive an operating mode switch. It is lost when you switch the operating mode of the switch to standalone, even if you have saved the configuration.
Examples
# Disable IRF link auto-recovery.
<Sysname> system-view
[Sysname] undo irf link-status auto-recovery 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: Bridge MAC address preservation mode for an IRF fabric. With this keyword specified, the bridge MAC address is preserved permanently.
timer: Bridge MAC address preservation mode for an IRF fabric. With this keyword specified, the bridge MAC address is preserved for 6 minutes when the master leaves.
Description
Use the irf mac-address persistent command to configure the preservation time of the bridge MAC address of an IRF fabric.
Use the undo irf mac-address persistent command to configure the IRF fabric not to preserve the bridge MAC address when the master leaves.
By default, the bridge MAC address of the IRF fabric remains unchanged, even if the master leaves the IRF fabric.
· Preserve for six minutes: When the master leaves, the bridge MAC address does not change within six minutes. If the master does not come back when the preservation time expires, the IRF fabric uses the bridge MAC address of the newly elected master as its bridge MAC address.
· Preserve permanently: The bridge MAC address of the IRF fabric remains unchanged, even if the master leaves the IRF fabric.
· Not preserved: As soon as the master leaves, the IRF fabric uses the bridge MAC address of the newly elected master as its bridge MAC address.
If IRF fabrics have the same bridge MAC address, they cannot be merged into one IRF fabric.
When you plan a network that uses ARP MAD and MSTP, use the undo irf mac-address persistent command to configure the bridge MAC address of the IRF fabric to change as soon as the master leaves.
If the VRRP load balancing function is enabled when the switch operates in IRF mode, you must configure the preservation time of the IRF bridge MAC address as permanently preserved (which is the default setting). For more information about VRRP, see High Availability Configuration Guide.
This command is available only when the switch is operating 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.
Examples
# Configure the bridge MAC address of the IRF fabric to be preserved permanently.
<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 switch. The value is in the range of 1 to 4.
Description
Use the irf member command to set a member ID for a switch in standalone mode.
Use the undo irf member command to restore the default.
If the switch supports pre-configuration, it has no default ID in standalone mode. After it switches to the IRF mode, it uses the member ID pre-configured in standalone mode by default.
If the switch does not support pre-configuration, its member ID defaults to 1.
The member ID functions in the following ways:
· When the operating mode of the switch changes from standalone to IRF, the member ID of the switch is needed for the auto-conversion of the configuration file. If the switch has no member ID configured, use the irf member command to set a member ID for it.
· An IRF fabric uses member IDs to uniquely identify and manage members. To set a member ID for the switch when it operates in standalone mode, use the irf member command, and the member ID takes effect after the operating mode of the switch changes to IRF. To set a member ID the switch when it operates in IRF mode, use the irf member member-id renumber new-member-id command, and the member ID takes effect after the switch reboot.
Related commands: irf member renumber.
Examples
# Set the member ID of the switch operating in standalone mode to 2.
<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 switch.
text: Specifies the description of the member, which is a string of 1 to 127 characters.
Description
Use the irf member description command to configure a description for an IRF member switch.
Use the undo irf member description command to restore the default.
By default, no description is configured for a member switch.
This command is available only when the switch operates in IRF mode. If you configure the description of a specified member switch, and then switch the operating mode of an IRF member switch to standalone, this configuration loses effect even if you switch the operating mode of the switch to IRF again. In this case, you need to re-configure the description as needed.
Examples
# Configure a description for IRF member switch 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 switch, which is in the range of 1 to 4.
priority: Specifies the priority value, which is 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 the irf member priority command to specify a priority for a member of an IRF fabric.
Use the undo irf member priority command to restore the default.
By default, the priority of a member of an IRF fabric is 1.
When the switch operates in different modes, use different commands to specify a priority for it:
· In standalone mode, use the irf priority command. If you want this switch to be elected as the master, specify its priority with the irf priority command.
· In IRF mode, use the irf member member-id priority priority command. The priority specified by using this command will influence role election during the running process of the IRF fabric. For example, when the master leaves the IRF fabric, the switch with the highest priority is elected as the new master. When the IRF fabric merge happens, the IRF fabric whose master has the highest priority wins the election.
Related commands: irf priority.
Examples
# When the switch with the member ID of 2 operates in IRF mode, specify its priority as 32.
<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 switch, which is in the range of 1 to 4.
new-member-id: Specifies the new ID of the member of the IRF fabric, which is in the range of 1 to 4.
Description
Use the irf member renumber command to set a member ID for a member of an IRF fabric.
Use the undo irf member renumber command to remove the configuration.
If the switch supports pre-configuration, it has no default ID in standalone mode. After it switches to the IRF mode, it uses the member ID pre-configured in standalone mode by default.
If the switch does not support pre-configuration, its member ID defaults to 1.
The member ID functions in the following ways:
· When the operating mode of the switch changes from standalone to IRF, member ID of the switch is needed for the auto-conversion of the configuration file. If the switch has no member ID configured, use this command to set a member ID for it.
· An IRF fabric uses member IDs to uniquely identify and manage member switches. To set a member ID for the switch when it operates in standalone mode, use the irf member command, and the member ID takes effect when the operating mode of the switch changes to IRF. To set a member ID for the switch when it operates in IRF mode, use the irf member member-id renumber new-member-id command, and the member ID takes effect when the switch reboots.
The above setting takes effect at the reboot of the switch.
Execution of the undo irf member renumber command cancels the member ID set this time. After switch reboot, the member ID of the switch is new-member-id, and cannot be cancelled by the undo command. To change the new-member-id, set another member ID for the switch.
For an IRF fabric, member IDs are used to identify switches and ports, and are also relevant to some command lines. Therefore, modifying a member ID may cause switch configuration change or even loss. Modify member IDs with caution.
Related commands: irf member.
Examples
# Set the member ID of IRF member (the current member ID is 1) of an IRF fabric 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
To cancel the above configuration and restore the original member ID of the switch, execute the following command:
[Sysname] undo irf member 1 renumber
Warning: Renumbering the switch number may result in configuration change or loss. Continue?[Y/N]y
If you reboot the switch after you execute the irf member 1 renumber 2 command, the member ID of the switch changes to 2. If you want to restore the member ID of the switch to 1, use the undo irf member 2 renumber command, or configure a new member ID by using the irf member 2 renumber 1 command.
irf mode enhanced
Syntax
irf mode enhanced
undo irf mode enhanced
View
System view
Default level
3: Manage level
Parameters
None
Description
Use the irf mode enhanced command to enable enhanced IRF mode.
Use the undo irf mode enhanced command to disable enhanced IRF mode.
The enhanced IRF mode enables up to four switches to form an IRF fabric.
Follow these guidelines when configuring enhanced IRF mode:
· Each member switch must be equipped with two MPUs.
· The member switches must be in ring topology and no relay can be deployed. For more information, see IRF Configuration Guide.
· A downstream device must be connected to each IRF member switch through an aggregate link. For more information, see IRF Configuration Guide.
· In standalone mode, you can enable enhanced IRF mode directly.
· In IRF mode,
? If no Layer-3 Ethernet ports exist and no VPLS and MAC-in-MAC instances exist, you can enable enhanced IRF mode directly.
? If Layer-3 Ethernet ports exist, you must change them to Layer-2 Ethernet ports (prompt information available) before you can enable enhanced IRF mode.
? If no Layer-3 Ethernet ports exist but VPLS or MAC-in-MAC instances exist, you must reboot the switch (prompt information available) before you can enable enhanced IRF mode.
For more information about Layer-3 Ethernet ports, 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.
· You must use the save command to save the configuration after you perform this task.
· To disable enhanced IRF mode with the undo irf mode enhanced command after you enable enhanced IRF mode in IRF mode, the member switches must be no more than two and each member switch must have only one IRF port; otherwise, the enhanced IRF mode cannot be disabled.
· Before emerging IRF fabrics, check that enhanced IRF mode is enabled on all member switches or disabled on all member switches. If enhanced IRF mode is enabled on some member switches but disabled on the others, the IRF fabrics cannot be merged.
· Before IRF merge, if enhanced IRF mode is enabled on all IRF member switches, you must reboot all IRF members except any one of them to complete IRF merge.
Examples
# Enable enhanced IRF mode on a switch 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 on a switch in IRF mode where both Layer-3 Ethernet ports 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, which is in the range of 1 to 32. A greater value indicates a higher priority.
Description
Use the irf priority command to specify a priority for a member switch operating in standalone mode.
Use the undo irf priority command to restore the default.
By default, the priority of a member switch 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 a master.
To specify a priority for the switch:
· Use the irf priority command when the switch operates in standalone mode. If you want this switch to be elected as the master, specify its priority with the irf priority command.
· Use the irf member member-id priority priority command when the switch operates in IRF mode. The priority specified by using this command will influence role election during the running process of the IRF fabric. For example, when the IRF fabric merge happens, the IRF fabric whose master has the highest priority wins the election.
Related commands: irf member priority.
Examples
# Specify the priority as 32 for the switch operating 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 card on an IRF member switch. The chassis-number argument represents the ID of the IRF member switch, and the slot-number argument represents the number of the slot that holds the card. You can display the member ID and slot number with the display device command.
Description
Use the irf switch-to command to log in to a standby MPU of the IRF fabric.
When you log in to an IRF fabric, you are placed at the CLI of its active MPU.
You can log in to the CLI of a standby MPU of the IRF fabric to display its configurations and debug the standby MPU. When you switch from the active MPU’s CLI to the standby MPU’s CLI, you are placed in the user view of the standby MPU and the command prompt changes to <Sysname-Slave#member-ID/slot-number>, for example, <Sysname-Slave#1/0>. You can perform the following commands at the CLI of the standby MPU of an IRF fabric:
· display
· quit
· return
· system-view
· debugging
· terminal debugging
· terminal logging
· terminal monitor
· terminal trapping
To return to the console of the active MPU of the IRF fabric, execute the quit command. The active MPU of the IRF fabric is reactivated and ready for outputting information. However, you cannot redirect to the active MPU of the IRF fabric with the irf switch-to command.
Examples
# Log in to the CLI of the standby MPU in the slot of member switch 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 the IRF port number, where member-id represents the ID of an IRF member switch. The member ID can be 1 or 2, and you can display it with the display irf command. The port-number argument specifies the port index, and the value is in the range of 1 to 4.
Description
Use the irf-port member-id/port-number command to create an IRF port and enter IRF port view when the switch operates in IRF mode. If the IRF port is already created, this command enters IRF port view.
Use the undo irf-port member-id/port-number command to delete the specified IRF port.
By default, no IRF port is created on the switch.
When an IRF port is created, you must bind physical IRF port(s) to this IRF port, and then the IRF port is available for the IRF fabric.
Related commands: port group interface.
Examples
# Create IRF port 1/1 for member 1 operating in IRF mode.
<Sysname> system-view
[Sysname] irf-port 1/1
[Sysname-irf-port 1/1] quit
# Create IRF port 2/2 for member 2 operating in IRF mode.
<Sysname> system-view
[Sysname] irf-port 2/2
[Sysname-irf-port 2/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. The value can be either 1 or 2.
Description
Use the irf-port port-number command to create an IRF port and enter IRF port view when the switch operates in standalone mode. If the IRF port is already created, this command enters IRF port view.
Use the undo irf-port port-number command to delete the specified IRF port.
By default, no IRF port is created on the switch.
Related commands: port group interface.
Examples
# Create IRF port 1 on the switch operating in standalone mode.
<Sysname> system-view
[Sysname] irf-port 1
[Sysname-irf-port 1] 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 the mad arp enable command to enable ARP MAD to detect the IRF fabric for multi-active collisions.
Use the undo mad arp enable command to disable ARP MAD.
By default, ARP MAD is disabled.
When executing the mad arp enable command, you are required to input the IRF domain ID to avoid the situation that the MAD detection packets of this IRF fabric are sent to a neighbor IRF fabric.
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
mad bfd enable
Syntax
mad bfd enable
undo mad bfd enable
View
VLAN interface view
Default level
3: Manage level
Parameters
None
Description
Use the mad bfd enable command to enable BFD MAD to detect the IRF fabric for multi-active collisions.
Use the undo mad bfd enable command to disable BFD MAD.
By default, BFD MAD is disabled.
|
|
CAUTION: · Do not configure any services (such as ARP) on a BFD MAD enabled VLAN interface. Doing so can cause both the configured services and BFD MAD to work inappropriately. · Use the mad ip address to configure the MAD IP address for the interface used for BFD MAD and do not configure other IP addresses such as a common IP address and VRRP virtual IP address with the ip address command to avoid affecting the MAD function. · Do not bind a BFD MAD enabled VLAN interface to any VPN or enable the spanning tree feature on the ports in the VLAN that corresponds to this interface. Doing so can cause BFD MAD to work inappropriately. |
Examples
# Enable BFD MAD on VLAN-interface 3.
<Sysname> system-view
[Sysname] interface vlan-interface 3
[Sysname-Vlan-interface3] mad bfd enable
mad enable
Syntax
mad enable
undo mad enable
View
Aggregate interface view
Default level
3: Manage level
Parameters
None
Description
Use the mad enable command to enable LACP MAD to detect the IRF fabric for multi-active collisions.
Use the undo mad enable command to disable LACP MAD.
By default, LACP MAD is disabled.
This command can be configured on both static and dynamic aggregate interfaces, but it takes effect only on dynamic aggregate interfaces because of LACP.
When executing the mad enable command, you are required to input the IRF domain ID to avoid the situation that the MAD detection packets of this IRF fabric are sent to a neighbor IRF fabric.
Examples
# Enable LACP MAD on LACP-enabled Layer 2 dynamic aggregate interface 1.
<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
Info: MAD LACP only enable on dynamic aggregation interface.
# Enable LACP MAD on LACP-enabled Layer 3 dynamic aggregate interface 1.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1] mad enable
You need to assign a domain ID (range: 0-4294967295)
[Current domain is: 0]: 1
The assigned domain ID is: 1
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 the mad exclude interface command to configure a service port not to shut down when the IRF fabric transitions to recovery state upon detection of a multi-active collision.
Use the undo mad exclude interface command to restore the default.
By default, all physical ports of an IRF fabric shut down when the IRF fabric transitions to recovery state.
When a MAD-enabled IRF fabric is detected having partitioned into identical active IRF fabrics, all IRF fabrics but the one with the lowest master ID are placed in recovery state to stop forwarding traffic to ensure the uniqueness of the IRF fabrics. All their physical ports are shut down but the IRF ports and those manually configured not to shut down.
If a port must be kept in up state for special purposes such as a telnet connection, you can exclude it from the shut down action. To avoid problems, H3C recommends that you keep all ports down but the one used for telnet for the management purpose. The ports shut down come up when the member switches reboot to join the recovered IRF fabric. If auto recovery fails because of the failure of the current master or any other exceptions, use the mad restore command to manually recover the members and bring up the ports.
Examples
# Configure port GigabitEthernet 2/3/0/1 not to shut down when the IRF fabric transitions 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 for the Layer 3 interface.
mask: Specifies a subnet mask in decimal dotted notation.
mask-length: Specifies the subnet mask length, that is, the number of successive 1s in the mask. The value ranges from 0 to 32.
member member-id: Specifies the ID of an IRF member switch, which is in the range of 1 to 4.
Description
Use the mad ip address command to configure the MAD IP address for the specified member switch.
Use the undo mad ip address command to delete the configured MAD IP address.
By default, no MAD IP address is configured for any interface.
BFD MAD is implemented with the BFD protocol. In this approach, you need to configure a MAD IP address on a BFD-enabled Layer 3 interface for each member of the IRF fabric. This MAD address identifies the member during BFD MAD detection. The MAD IP addresses assigned to the members of an IRF fabric must be from the same network segment.
You can assign the MAD IP address for an interface used for BFD MAD detection only with this command, and do not configure other IP addresses for it (including the common IP address or VRRP virtual IP address configured with the ip address command).
Examples
# Configure the MAD IP address for VLAN-interface 3 on IRF member 1.
<Sysname> system-view
[Sysname] interface vlan-interface 3
[Sysname-Vlan-interface3] mad ip address 192.12168.0.1 255.255.255.0 member 1
# Configure the MAD IP address for VLAN-interface 3 on IRF member 2.
[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 the mad restore command to recover the member switches of the IRF fabric in recovery state to normal state.
An IRF link failure triggers IRF fabric partition and thus causes multi-active collision. In this case, one IRF fabric can keep active state and other IRF fabrics change into recovery state (in this state, the IRF fabric cannot forward packets). If the IRF fabric in recovery state fails before the failure is recovered, repair both the failed IRF fabric and the failed IRF link, and then the collided IRF fabrics can merge into one and the failure is recovered. If the IRF fabric in active state fails before the failure is recovered, enable the IRF fabric in recovery state at the CLI to make it take over the active IRF fabric and protect the services from being affected.
Examples
# Restore IRF fabrics in recovery state to the normal 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 port type and port number.
interface-name: Specifies the interface name, in the format of interface-typeinterface-number. There is no space between interface-type and interface-number.
Description
Use the port group interface command to bind a physical IRF port to an IRF port.
Use the undo port group interface command to cancel the binding between the physical IRF port and the corresponding IRF port and to restore the default operating mode of the physical IRF port.
By default, no IRF port is created on the switch.
A combo port, whether optical or electrical, cannot function as a physical IRF port, and cannot be bound to an IRF port. For more information about combo ports, see Interface Configuration Guide.
You can bind one IRF port to multiple physical IRF ports by executing this command multiple times. The maximum number of physical IRF ports that can be bound to an IRF port is 12.
In IRF mode, before binding a physical port to an IRF port, first shut down the physical port with the shutdown command, and then execute the port group interface command. Then, bring up the physical port with the undo shutdown command, and the physical port can establish an IRF connection as a physical IRF port; when the switch operates in standalone mode, you can execute the port group interface command directly, and do not need to shut down the physical port.
In IRF mode, before canceling the binding between a physical port and an IRF port, first shut down the physical port with the shutdown command, and then execute the undo port group interface command. After that, bring up the physical port with the undo shutdown command, and then the physical port can forward packets; when the switch operates in standalone mode, you can execute the undo port group interface command directly, and do not need to shut down the physical port.
When you configure this command, if the physical IRF port which is already bound to the IRF port does not exist because the interface card is plugged out, the binding between the two ports still exists. To cancel the binding between the two ports, use the undo port group interface command.
Related commands: irf-port.
Examples
# Bind physical IRF port Ten-GigabitEthernet 2/0/1 on the switch operating in standalone mode to IRF port 1.
<Sysname> system-view
[Sysname] irf-port 1
[Sysname-irf-port 1] port group interface ten-gigabitethernet 2/0/1
# When the switch operates in IRF mode, bind physical IRF 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-port 2/1] port group interface ten-gigabitethernet 2/2/0/1
[Sysname-irf-port 2/1] quit
[Sysname] interface ten-gigabitethernet 2/2/0/1
[Sysname-ten-gigabitethernet2/2/0/1] undo shutdown
set irf slot member-id
Syntax
Standalone mode
set irf slot slot-number member-id member-id
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. Use this option when your switch is operating in standalone (the default) mode.
member-id member-id: Specifies the member ID of the target switch.
chassis chassis-number slot slot-number: Specifies the member ID of the IRF member switch, and the slot-number argument represents the number of the slot that holds the standby MPU. You can display the member ID and slot number with the display device command.
Description
Use the set irf slot member-id command to specify the member ID of the MPU in the specified slot of the specified switch.
|
|
CAUTION: Use this command with caution. It is applicable to fast recovery of the IRF fabric only. If you use this command in other cases, unknown errors may occur. For more information about the fast recovery function, see IRF Configuration Guide. |
Examples
# Set the member ID of the MPU in slot 1 to 1 when the switch operates in standalone mode.
<Sysname> set irf slot 1 member-id 1
# Set the member ID of the MPU in slot 1 of switch 2 to 1 when the switch operates in IRF mode.
<Sysname> set irf chassis 2 slot 1 member-id 1
