H3C S5560X-HI Series Installation manual

H3C S6520X-HI[EI][SI] & S6520-SI &
S5560X-HI & S5000-EI & MS4600 Switch Series
Virtual Technologies Command Reference
This command reference is applicable to the following switches and software versions:
H3C S6520X-HI switch series (Release 6510 and later)
H3C S6520X-EI switch series (Release 6510 and later)
H3C S6520X-SI switch series (Release 6510 and later)
H3C S6520-SI switch series (Release 6510 and later)
H3C S5560X-HI switch series (Release 6510 and later)
H3C S5000-EI switch series (Release 6510 and later)
H3C MS4600 switch series (Release 6515P06 and later)
New H3C Technologies Co., Ltd.
http://www.h3c.com
Software version: Release 65xx
Document version: 6W101-20210108

Copyright © 2021, New H3C Technologies Co., Ltd. and its licensors
All rights reserved
No part of this manual may be reproduced or transmitted in any form or by any means without prior written
consent of New H3C Technologies Co., Ltd.
Trademarks
Except for the trademarks of New H3C Technologies Co., Ltd., any trademarks that may be mentioned in this
document are the property of their respective owners.
Notice
The information in this document is subject to change without notice. All contents in this document, including
statements, information, and recommendations, are believed to be accurate, but they are presented without
warranty of any kind, express or implied. H3C shall not be liable for technical or editorial errors or omissions
contained herein.

Preface
This command reference describes the commands for configuring and maintaining IRF and IRF 3.1.
This preface includes the following topics about the documentation:
•
Audience.
•
Conventions.
•
Documentation feedback.
Audience
This documentation is intended for:
•
Network planners.
•
Field technical support and servicing engineers.
•
Network administrators.
Conventions
The following information describes the conventions used in the documentation.
Command conventions
Convention
Description
Boldface Bold text represents commands and keywords that you enter literally as shown.
Italic Italic text represents arguments that you replace with actual values.
[ ] Square brackets enclose syntax choices (keywords or arguments) that are optional.
{ x | y | ... }
Braces enclose a set of required syntax choices separated by vertical bars, from which
you select one.
[ x | y | ... ]
Square brackets enclose a set of optional syntax choices separated by vertical bars,
from which you select one or none.
{ x | y | ... } *
Asterisk marked braces enclose a set of required syntax choices separated by vertical
bars, from which you select a minimum of one.
[ x | y | ... ] *
Asterisk marked square brackets enclose optional syntaxchoices separated by vertical
bars, from which you select one choice, multiple choices, or none.
&<1-n> The argument or keyword and argument combination before the ampersand (&) sign
can be entered 1 to n times.
# A line that starts with a pound (#) sign is comments.
GUI conventions
Convention
Description
Boldface Window names, button names, field names, and menu items are in Boldface. For
example, the New User window opens; click OK.
> Multi-level menus are separated by angle brackets. For example, File > Create >
Folder.

Symbols
Convention
Description
WARNING! An alert that calls attention to important information that if not understood or followed
can result in personal injury.
CAUTION:
An alert that calls attention to important information that if not understood or followed
can result in data loss, data corruption, or damage to hardware or software.
IMPORTANT:
An alert that calls attention to essential information.
NOTE:
An alert that contains additional or supplementary information.
TIP:
An alert that provides helpful information.
Network topology icons
Convention
Description
Represents a generic network device, such as a router, switch, or firewall.
Represents a routing-capable device, such as a router or Layer 3 switch.
Represents a generic switch, such as a Layer 2 or Layer 3 switch, or a router that
supports Layer 2 forwarding and other Layer 2 features.
Represents an access controller, a unified wired-WLAN module, or the access
controller engine on a unified wired-WLAN switch.
Represents an access point.
Represents a wireless terminator unit.
Represents a wireless terminator.
Represents a mesh access point.
Represents omnidirectional signals.
Represents directional signals.
Represents a security product, such as a firewall, UTM, multiservice security
gateway, or load balancing device.
Represents a security module, such as a firewall, load balancing, NetStream, SSL
VPN, IPS, or ACG module.
Examples provided in this document
Examples in this document might use devices that differ from your device in hardware model,
configuration, or software version. It is normal that the port numbers, sample output, screenshots,
and other information in the examples differ from what you have on your device.
T
T
T
T

Documentation feedback
You can e-mail your comments about product documentation to inf[email protected]om.
We appreciate your comments.

i
Contents
IRF commands······························································································1
display irf····················································································································································1
display irf configuration ······························································································································2
display irf link··············································································································································3
display irf topology ·····································································································································4
display mad················································································································································5
easy-irf ·······················································································································································8
irf auto-update enable······························································································································10
irf domain ·················································································································································11
irf link-delay··············································································································································11
irf mac-address ········································································································································12
irf mac-address persistent························································································································13
irf member description······························································································································14
irf member priority····································································································································15
irf member renumber································································································································15
irf-port·······················································································································································16
irf-port-configuration active·······················································································································17
mad arp enable········································································································································18
mad bfd enable ········································································································································19
mad enable ··············································································································································22
mad exclude interface······························································································································23
mad ip address·········································································································································24
mad nd enable ·········································································································································25
mad restore··············································································································································26
port group interface··································································································································27
IRF 3.1 commands ······················································································29
description················································································································································29
display pex interface ································································································································29
display pex topology·································································································································31
pex associate···········································································································································32
pex auto-config enable·····························································································································32
pex group·················································································································································33
pex idle-cascade delete ···························································································································34
pex local-forwarding·································································································································34
pex persistent-forwarding·························································································································35
pex-capability enable ·······························································································································36
switchto pex ·············································································································································37

1
IRF commands
display irf
Use display irf to display IRF fabric information.
Syntax
display irf
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display IRF fabric information.
<Sysname> display irf
MemberID Role Priority CPU-Mac Description
1 Loading 1 00e0-fcbe-3102 F1Num001
*+2 Master 1 00e0-fcb1-ade2 F1Num002
--------------------------------------------------------
* indicates the device is the master.
+ indicates the device through which the user logs in.
The Bridge MAC of the IRF is: 00e0-fc00-1000
Auto upgrade : yes
Mac persistent : always
Domain ID : 30
Table 1 Command output
Field
Description
MemberID IRF member ID: •ID of the master is prefixed with an asterisk (*) sign.
•ID of the device where you are logged in is prefixed with a plus (+) sign.
Role
Role of the member device in the IRF fabric:
•Standby—Subordinate device.
•Master—Master device.
•Loading—The device is loading software images.
Priority IRF member priority.
CPU-MAC MAC address of the CPU in the device. This MAC address is used for internal
communication between nodes within the device.

2
Field
Description
Description
Description you have configured for the member device.
•If no description is configured, this field displays a dashed line (-----).
•If the description exceeds the maximum number of characters that can be
displayed, an ellipsis (…) is displayed in place of the exceeding text. To
display the complete description, use the display
current-configuration
command.
Bridge MAC of the IRF
is IRF bridge MAC address. This MAC address is used by the IRF fabric to communicate with external devices and hosts.
Auto upgrade Status of the software auto-update feature:
•yes—Enabled.
•no—Disabled.
MAC persistent
IRF bridge MAC persistence setting:
•6 min—Bridge MAC address of the IRF fabric remains unchanged for 6
minutes after the address owner leaves.
•always—Bridge MAC address of the IRF fabric does not change after the
address owner leaves.
•no—
Bridge MAC address of the current master replaces the original bridge
MAC address as soon as the owner of the original address leaves.
Domain ID Domain ID of the IRF fabric. The domain ID you assign to an IRF fabric must
uniquely identify the fabric in a multi-IRF fabric network.
Related commands
display irf configuration
display irf topology
display irf configuration
Use display irf configuration to display basic IRF settings for each member device.
Syntax
display irf configuration
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display basic IRF settings for all members.
<Sysname> display irf configuration
MemberID NewID IRF-Port1 IRF-Port2
1 1 Ten-GigabitEthernet1/0/1 Ten-GigabitEthernet1/0/3
2 2Ten-GigabitEthernet2/0/1 Ten-GigabitEthernet2/0/3
Ten-GigabitEthernet2/0/2
4 4 Ten-GigabitEthernet4/0/1 Ten-GigabitEthernet4/0/3
Ten-GigabitEthernet4/0/4

3
Table 2 Command output
Field
Description
MemberID Current member ID of the device.
NewID Member ID assigned to the device. This member ID takes effect at reboot.
IRF-Port1 Physical interfaces bound to IRF-port 1.
This field displays disable if no physical interfaces are bound to the IRF port.
IRF-Port2 Physical interfaces bound to IRF-port 2.
This field displays disable if no physical interfaces are bound to the IRF port.
Related commands
display irf
display irf topology
display irf link
Use display irf link to display IRF link information.
Syntax
display irf link
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display IRF link information.
<Sysname> display irf link
Member 1
IRF Port Interface Status
1 disable --
2 Ten-GigabitEthernet1/0/1 UP
Ten-GigabitEthernet1/0/2 ADM
Ten-GigabitEthernet1/0/3 DOWN
Member 2
IRF Port Interface Status
1 Ten-GigabitEthernet2/0/1 UP
Ten-GigabitEthernet2/0/2 DOWN
Ten-GigabitEthernet2/0/3 ADM
2 disable --
Table 3 Command output
Field
Description
Member ID IRF member ID.

4
Field
Description
IRF Port IRF port number:
•1—IRF-port 1.
•2—IRF-port 2.
Interface Physical interfaces bound to the IRF port. This field displays disable if no
physical interfaces have been bound to the IRF port.
Status
Link state of the IRF physical interface:
•UP—The link is up.
•DOWN—The link is down.
•ADM—The interface has been manually shut down by using the
shutdown command.
•ABSENT—Interface module that hosts the interface is not present.
display irf topology
Use display irf topology to display IRF fabric topology information.
Syntax
display irf topology
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display the IRF fabric topology.
<Sysname> display irf topology
Topology Info
-------------------------------------------------------------------------
IRF-Port1 IRF-Port2
MemberID Link neighbor Link neighbor Belong To
1 DOWN --- UP 2 000f-cbb8-1a82
2 UP 1 DIS --- 000f-cbb8-1a82
Table 4 Command output
Field
Description
IRF-Port1 Information about IRF-port 1, including its link state and neighbor.
IRF-Port2 Information about IRF-port 2, including its link state and neighbor.
MemberID IRF member ID.

5
Field
Description
Link
Link state of the IRF port:
•UP—The IRF link is up.
•DOWN—
The IRF link is down because the port has no physical link or
has not been activated by the irf-port-
configuration
active command.
•DIS—No physical interfaces have been bound to the IRF port.
•TIMEOUT—IRF hello interval has timed out.
•ISOLATE—The device is isolated from the IRF fabric. This issue might
be caused by the following reasons:
The IRF fabric does not support the device model.
The maximum number of member devices has exceeded the upper
limit.
neighbor IRF member ID of the device connected to the IRF port.
This field displays three hyphens (---) if no device is connected to the port.
Belong To IRF fabric that has the device, represented by the CPU MAC address of the
master in the IRF fabric.
Related commands
display irf
display irf configuration
display mad
Use display mad to display MAD status and settings.
Syntax
display mad [verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
verbose: Displays detailed MAD information. If you do not specify this keyword, the command only
displays whether a MAD mechanism is enabled or disabled.
Examples
# Display brief MAD information.
<Sysname> display mad
MAD ARP disabled.
MAD ND disabled.
MAD LACP enabled.
MAD BFD enabled.
# Display detailed MAD information.
<Sysname> display mad verbose
Multi-active recovery state: No

6
Excluded ports (user-configured):
Bridge-Aggregation4
Vlan-interface999
Excluded ports (system-configured):
IRF physical interfaces:
Ten-GigabitEthernet1/0/1
Ten-GigabitEthernet1/0/2
Ten-GigabitEthernet2/0/1
Ten-GigabitEthernet2/0/2
BFD MAD interfaces:
Ten-GigabitEthernet1/0/3
Ten-GigabitEthernet2/0/3
Vlan-interface3
Member interfaces of excluded interface Bridge-Aggregation 4:
Ten-GigabitEthernet1/0/4
Ten-GigabitEthernet2/0/4
MAD ARP disabled.
MAD ND disabled.
MAD LACP enabled interface: Bridge-Aggregation 1
MAD status : Normal
Member ID Port MAD status
1Ten-GigabitEthernet1/0/5 Normal
2Ten-GigabitEthernet2/0/5 Normal
MAD BFD enabled interface: VLAN-interface 3
MAD status : Normal
Member ID MAD IP address Neighbor MAD status
1 192.168.1.1/24 2 Normal
2192.168.1.2/24 1Normal
Table 5 Command output
Field
Description
MAD ARP disabled. Status of ARP MAD.
This field displays MAD ARP enabled if ARP MAD is enabled.
MAD ND disabled. Status of ND MAD.
This field displays MAD ND enabled if ND MAD is enabled.
MAD LACP enabled. Status of LACP MAD.
This field displays MAD LACP disabled if LACP MAD is disabled.
MAD BFD enabled. Status of BFD MAD.
This field displays MAD BFD disabled if BFD MAD is disabled.
Multi-active recovery state
Whether the IRF fabric is in Recovery state:
•Yes—The IRF fabric is in Recovery state. When MAD detects that an
IRF fabric has split into multiple IRF fabrics, it allows one fabric to
forward traffic. All the other IRF fabrics are set to the Recovery state. In
Recovery state, MAD shuts down all common network interfaces in the
fabric except for the system- and user-excluded network interfaces.
•No—The IRF fabric is not in
Recovery state. It is active and can forward
traffic.

7
Field
Description
Excluded ports
(user-configured) Network interfaces
manually configured to not shut down when the IRF fabric
transits to the Recovery state.
Excluded ports
(system-configured)
Network interfaces set to not shut down by the system when the IRF fabric
transits to the Recovery state. These interfaces are not manually configured.
•IRF physical interfaces.
•BFD MAD interfaces:
VLAN interfaces used for BFD MAD and the Layer 2 Ethernet ports in
the VLANs.
Layer 3 aggregate interfaces used for BFD MAD and their member
ports.
Management Ethernet ports used for BFD MAD.
•Member interfaces of a Layer 2 aggregate interface if the aggregate
interface is excluded from the MAD shutdown action.
•Member interfaces of a Layer 3 aggregate interface if the aggregate
interface is excluded from the MAD shutdown action.
MAD ARP enabled
interface: Interfaces on which ARP MAD is enabled.
This field displays MAD ARP disabled if ARP MAD is disabled.
MAD ND enabled
interface: Interfaces on which ND MAD is enabled.
This field displays MAD ND disabled if ND MAD is disabled.
MAD LACP enabled
interface
Interface on which LACP MAD is enabled. This field is displayed for each
interface enabled with LACP MAD.
This field displays MAD LACP disabled if LACP MAD is disabled.
MAD status
LACP MAD operating status:
•Normal—LACP MAD is operating correctly.
•Faulty—LACP MAD is not operating correctly. Verify the following items:
Verify that the ports on LACP MAD links are up.
Verify that the intermediate device supports extended LACPDUs.
Verify that all member devices have member ports used for LACP
MAD.
Member ID
Port
MAD status
LACP MAD details:
•Member ID—IRF member ID of a device.
•Port—Member ports of the aggregate interface used for LACP MAD.
•MAD status—LACP MAD operating state on a member port. Values
include Normal and Faulty.
MAD BFD enabled
interface: Layer 3 interface on which BFD MAD is enabled.
This field displays MAD BFD disabled if BFD MAD is disabled.
MAD status
BFD MAD operating status:
•Normal—BFD MAD is operating correctly.
•Faulty—BFD MAD is not operating correctly. Check the BFD MAD link
for connectivity issues.
•N/A—BFD MAD link status cannot be detected. If BFD MAD is enabled
on a management Ethernet port, it is normal that this field displays N/A.

8
Field
Description
Member ID
MAD IP address
Neighbor
MAD status
BFD MAD details:
•Member ID—IRF member ID of the local device.
•MAD IP address—MAD IP address of a member device.
•Neighbor—IRF member ID of the neighboring member device.
•MAD status—BFD MAD link state. The following values are available:
Normal—BFD MAD is operating correctly.
Faulty—BFD MAD is not operating correctly. Check the BFD MAD
link for connectivity issues.
N/A—BFD MAD link status cannot be detected. If BFD MAD is
enabled on a management Ethernet port, it is normal that this field
displays N/A.
easy-irf
Use easy-irf to bulk-configure basic IRF settings for an IRF member device.
Syntax
easy-irf [member member-id [renumber new-member-id ]domain domain-id
[priority priority ][irf-port1 interface-list1 ][irf-port2
interface-list2 ]]
Views
System view
Predefined user roles
network-admin
Parameters
member member-id: Specifies the member ID of a member device. The value range for the
member ID is 1 to 10.
renumber new-member-id: Specifies a new member ID for the device. The value range for the
member ID is 1 to 10. The member device automatically reboots for the new member ID to take
effect. If you do not specify this option, the command does not change the member ID.
domain domain-id: Specifies an IRF domain ID in the range of 0 to 4294967295. Assign the
same domain ID to all devices you are adding to the same IRF fabric.
priority priority: Specifies an IRF priority in the range of 1 to 32. The greater the priority
value, the higher the priority. A member with higher priority is more likely to be the master.
irf-port1 interface-list1: Specifies interfaces bound to IRF-port 1. The
interface-list1 argument represents a space-separated list of up to ninterface items. Each
interface item specifies one interface in the interface-type interface-number form. In
Release 6510, the value for nis 8. In R6515P06 and later, the value for nis 16.
irf-port2interface-list2: Specifies interfaces bound to IRF-port 2. A physical interface
can be bound to only one IRF port. The interface-list2 argument represents a
space-separated list of up to ninterface items. Each interface item specifies one interface in the
interface-type interface-number form. In Release 6510, the value for nis 8. In R6515P06
and later, the value for nis 16.
Usage guidelines
This command bulk-configures basic IRF settings for a member device, including the member ID,
domain ID, priority, and IRF port bindings.

9
The easy IRF feature provides the following configuration methods:
•
Interactive method—Enter the easy-irf command without parameters. The system will
guide you to set the parameters step by step.
•
Non-interactive method—Enter the easy-irf command with parameters.
As a best practice, use the interactive method if you are new to IRF.
If you execute this command multiple times, the following settings take effect:
•
The most recent settings for the member ID, domain ID, and priority.
•
IRF port bindings added through repeated executions of the command.
When you specify physical interfaces for an IRF port, you must follow the IRF port binding
requirements in Virtual Technologies Configuration Guide.
If you specify physical interfaces by using the interactive method, you must also follow these
restrictions and guidelines:
•
Do not enter spaces between the interface type and interface number.
•
Use a comma (,) to separate two physical interfaces. No spaces are allowed between
interfaces.
To remove an IRF physical interface from an IRF port, you must use the undo port group
interface command in IRF port view.
Examples
# Bulk-configure basic IRF settings by using the non-interactive method. Change the member ID
from 2 to 3, set the domain ID to 10, configure the member priority as 10, and bind
Ten-GigabitEthernet 2/0/1 and Ten-GigabitEthernet 2/0/2 to IRF-port 1.
<Sysname> system-view
[Sysname] easy-irf member 2 renumber 3 domain 10 priority 10 irf-port1 ten-gigabitethernet
2/0/1 ten-gigabitethernet 2/0/2
*****************************************************************************
Configuration summary for member 2
IRF new member ID: 3
IRF domain ID : 10
IRF priority : 10
IRF-port 1 : Ten-GigabitEthernet2/0/1, Ten-GigabitEthernet2/0/2
IRF-port 2 : Disabled
*****************************************************************************
Are you sure to use these settings to set up IRF? [Y/N] y
Starting to configure IRF...
Configuration succeeded.
The device will reboot for the new member ID to take effect. Continue? [Y/N] y
# Bulk-configure basic IRF settings by using the interactive method. Change the member ID from 2
to 3, set the domain ID to 10, configure the member priority as 10, and bind Ten-GigabitEthernet
2/0/1 and Ten-GigabitEthernet 2/0/2 to IRF-port 1.
<Sysname> system-view
[Sysname] easy-irf
*****************************************************************************
Welcome to use easy IRF.
To skip the current step, enter a dot sign (.).
To return to the previous step, enter a minus sign (-).
To use the default value (enclosed in []) for each parameter, press Enter without
entering a value.

10
To quit the setup procedure, press CTRL+C.
*****************************************************************************
Select a member by its ID <2> [2]:2
Specify a new member ID <1~10> [1]: 3
Specify a domain ID <0~4294967295> [0]: 10
Specify a priority <1~32> [1]: 10
Specify IRF-port 1 bindings (a physical interface or a comma-separated physical
interface list)[Disabled]: ten-gigabitethernet2/0/1,ten-gigabitethernet2/0/2
Specify IRF-port 2 bindings (a physical interface or a comma-separated physical
interface list)[Disabled]:
*****************************************************************************
Configuration summary for member 2
IRF new member ID: 3
IRF domain ID : 10
IRF priority : 10
IRF-port 1 : Ten-GigabitEthernet2/0/1, Ten-GigabitEthernet2/0/2
IRF-port 2 : Disabled
*****************************************************************************
Are you sure to use these settings to set up IRF? [Y/N] y
Starting to configure IRF...
Configuration succeeded.
The device will reboot for the new member ID to take effect. Continue? [Y/N] y
irf auto-update enable
Use irf auto-update enable to enable the software auto-update feature.
Use undo irf auto-update enable to disable the software auto-update feature.
Syntax
irf auto-update enable
undo irf auto-update enable
Default
Software auto-update is enabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command automatically propagates the current software images of the master device in the IRF
fabric to any devices you are adding to the IRF fabric.
To ensure a successful software update, verify that the new device you are adding to the IRF fabric
has sufficient storage space for the new software images. If sufficient storage space is not available,
the device automatically deletes the current software images. If the reclaimed space is still
insufficient, the device cannot complete the auto-update. You must reboot the device, and then
access the BootWare menu to delete files.

11
Examples
# Enable the software auto-update feature.
<Sysname> system-view
[Sysname] irf auto-update enable
irf domain
Use irf domain to assign a domain ID to the IRF fabric.
Use undo irf domain to restore the default.
Syntax
irf domain domain-id
undo irf domain
Default
The IRF domain ID is 0.
Views
System view
Predefined user roles
network-admin
Parameters
domain-id: Specifies a domain ID for the IRF fabric. The value range is 0 to 4294967295.
Usage guidelines
One IRF fabric forms one IRF domain. IRF uses IRF domain IDs to uniquely identify IRF fabrics and
prevent IRF fabrics from interfering with one another.
If one IRF fabric uses another IRF fabric as the intermediate device for LACPMAD, ARP MAD, or ND
MAD, you must assign the two IRF fabrics different domain IDs for correct split detection. False
detection causes IRF split.
An IRF fabric has only one IRF domain ID. You can change the IRF domain ID by using the following
commands: irf domain, mad enable, mad arp enable, or mad nd enable. The IRF domain
IDs configured by using these commands overwrite each other.
Examples
# Set the IRF domain ID to 10.
<Sysname> system-view
[Sysname] irf domain 10
irf link-delay
Use irf link-delay to set a delay for the IRF ports to report a link down event.
Use undo irf link-delay to restore the default.
Syntax
irf link-delay interval
undo irf link-delay

12
Default
The delay time is 4 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
interval: Sets the IRF link down report delay, in the range of 0 to 10000 milliseconds. If the
interval is set to 0, link down events are reported without any delay.
Usage guidelines
When you configure the IRF link down report delay, follow these restrictions and guidelines:
•
Make sure the IRF link down report delay is shorter than the heartbeat or hello timeout settings
of upper-layer protocols (for example, CFD and OSPF). If the report delay is longer than the
timeout setting of a protocol, unnecessary recalculations might occur.
•
Set the delay to 0 seconds in the following situations:
The IRF fabric requires a fast master/subordinate or IRF link switchover.
The RRPP, BFD, or GR feature is used.
You want to shut down an IRF physical interface or reboot an IRF member device. (After you
complete the operation, reconfigure the delay depending on the network condition.)
Examples
# Set the IRF link down report delay to 300 milliseconds.
<Sysname> system-view
[Sysname] irf link-delay 300
irf mac-address
Use irf mac-address to specify a MAC address as the IRF bridge MAC address.
Use undo irf mac-address to restore the default.
Syntax
irf mac-address mac-address
undo irf mac-address
Default
An IRF fabric uses the bridge MAC address of the master device as the IRF bridge MAC address.
Views
System view
Predefined user roles
network-admin
Parameters
mac-address: Specifies a MAC address in the format of H-H-H. The MAC address cannot be the
all-zero or all-F MAC address, or a multicast MAC address. You can omit the consecutive zeros at
the beginning of each segment. For example, you can enter f-e2-1 for 000f-00e2-0001.

13
Usage guidelines
CAUTION:
IRF bridge MAC address change will cause transient traffic disruption.
Before you replace an IRF fabric entirely, you can configure the new IRF fabric with the bridge MAC
address of the existing IRF fabric to minimize service interruption.
You must make sure the IRF bridge MAC address is unique on the switched LAN after the
replacement.
After you specify an IRF bridge MAC address, the IRF fabric always uses the specified address as
the IRF bridge MAC address.
If the IRF fabric splits after you configure the IRF bridge MAC address, both of the split IRF fabrics
use the configured bridge MAC address as the IRF bridge MAC address.
When IRF fabrics merge, IRF ignores the IRF bridge MAC address and checks the bridge MAC
address of each member device in the IRF fabrics. IRF merge fails if any two member devices have
the same bridge MAC address.
After IRF fabrics merge, the merged IRF fabric uses the bridge MAC address of the merging IRF
fabric that won the master election as the IRF bridge MAC address.
Examples
# Configure the IRF fabric to use c4ca-d9e0-8c3c as the IRF bridge MAC address.
<Sysname> system-view
[Sysname] irf mac-address c4ca-d9e0-8c3c
irf mac-address persistent
Use irf mac-address persistent to configure IRF bridge MAC persistence.
Use undo irf mac-address persistent to disable IRF bridge MAC persistence.
Syntax
irf mac-address persistent {always |timer }
undo irf mac-address persistent
Default
The IRF bridge MAC address remains unchanged for 6 minutes after the address owner leaves.
Views
System view
Predefined user roles
network-admin
Parameters
always:Enables the IRF bridge MAC address to be permanent. The IRF bridge MAC address does
not change after the address owner leaves the fabric.
timer: Enables the IRF bridge MAC address to remain unchanged for 6 minutes after the address
owner leaves. If the owner rejoins the IRF fabric within the time limit, the IRF bridge MAC address
does not change. If the owner does not rejoin the IRF fabric within the time limit, the IRF fabric uses
the bridge MAC address of the current master as the bridge MAC address.

14
Usage guidelines
If the undo form of this command is used, bridge MAC address of the current master replaces the
original IRF bridge MAC as soon as the original address owner leaves.
This command does not take effect if the IRF bridge MAC address is configured by using the irf
mac-address mac-address command.
If ARP MAD or ND MAD is used with the spanning tree feature, disable IRF bridge MAC persistence
by using the undo irf mac-address persistent command. In addition, do not specify an IRF
bridge MAC address by using the irf mac-address mac-address command.
If the IRF fabric uses a daisy-chain topology and has aggregate links with upstream or downstream
devices, do not execute the undo irf mac-address persistent command. Use of this
command might result in transmission delay or packet loss after the address owner leaves or
reboots.
If the IRF fabric has multichassis aggregate links, do not use the undo irf mac-address
persistent command. Use of this command might cause traffic disruption.
By default, an IRF fabric uses the bridge MAC address of the master device as its bridge MAC
address.
On a switched LAN, the IRF bridge MAC address must be unique for correct traffic transmission.
When IRF fabrics merge, IRF ignores the IRF bridge MAC address and checks the bridge MAC
address of each member device in the IRF fabrics. IRF merge fails if any two member devices have
the same bridge MAC address.
Examples
# Enable the IRF bridge MAC address to persist forever.
<Sysname> system-view
[Sysname] irf mac-address persistent always
irf member description
Use irf member description to configure a description for an IRF member device.
Use undo irf member description to restore the default.
Syntax
irf member member-id description text
undo irf member member-id description
Default
No description is configured for an IRF member device.
Views
System view
Predefined user roles
network-admin
Parameters
member-id: Specifies the ID of an IRF member.
text: Specifies a description, a string of 1 to 127 characters.
Examples
# Configure the description as F1Num001 for IRF member 1.