H3C S5500-EI series Installation manual

H3C S5500-EI Series Ethernet Switches
IRF
Command Reference
Hangzhou H3C Technologies Co., Ltd.
http://www.h3c.com
Document Version: 20100708-C-1.03
Product Version: Release 2202

Copyright © 2008-2010, Hangzhou 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 Hangzhou H3C Technologies Co., Ltd.
Trademarks
H3C, , Aolynk, , H3Care, , TOP G, , IRF, NetPilot, Neocean, NeoVTL,
SecPro, SecPoint, SecEngine, SecPath, Comware, Secware, Storware, NQA, VVG, V2G, VnG, PSPT,
XGbus, N-Bus, TiGem, InnoVision and HUASAN are trademarks of Hangzhou H3C Technologies Co.,
Ltd.
All other trademarks that may be mentioned in this manual are the property of their respective owners.
Notice
The information in this document is subject to change without notice. Every effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute the warranty of any kind, express or implied.

Preface
The H3C S5500-EI documentation set includes 10 command references, which describe the
commands and command syntax options for the S5500-EI Release 2202.
The IRF Command Reference describes IRF configuration commands for creating an IRF virtual device.
It covers the commands for binding physical ports to an IRF port, configuring the member switch ID and
priority, and accessing the IRF virtual device.
This preface includes:
zAudience
zDocument Organization
zConventions
zAbout the H3C S5500-EI Documentation Set
zObtaining Documentation
zDocumentation Feedback
Audience
This documentation set is intended for:
zNetwork planners
zField technical support and servicing engineers
zNetwork administrators working with the S5500-EI series
Document Organization
The IRF Command Reference comprises the following part:
IRF Configuration
Commands
Conventions
This section describes the conventions used in this documentation set.
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

Convention Description
vertical bars, from which you select at least one.
[ x | y | ... ] *
Asterisk marked square brackets enclose optional syntax choices separated by
vertical bars, from which you may select 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.
Symbols
Convention Description
Means reader be careful. Improper operation may cause data loss or damage to
equipment.
Means a complementary description.
About the H3C S5500-EI Documentation Set
The H3C S5500-EI documentation set also includes:
Category Documents Purposes
Marketing brochures Describe product specifications and benefits.
Technology white papers Provide an in-depth description of software features
and technologies.
PSR150-A [ PSR150-D ] Power
Modules User Manual
Describes the appearances, features, specifications,
installation, and removal of the pluggable 150W power
modules available for the products.
RPS User Manual Describes the appearances, features, and
specifications of the RPS units available for the
products.
RPS Ordering Information for
H3C Low-End Ethernet
Switches
Provides the RPS and switch compatibility matrix and
RPS cable specifications.
H3C Low End Series Ethernet
Switches Pluggable Modules
Manual
Describes the models, appearances, and
specifications of the pluggable modules available for
the products.
Product
description and
specifications
Interface Card User Manual Describes the appearance and specifications of the
interface card.
H3C S5500-EI Quick Start
Provides regulatory information and the safety
instructions that must be followed during installation.
Guides you through initial installation and setup
procedures to help you quickly set up and use your
device with the minimum configuration.
S5500-EI Series Ethernet
Switches Installation Manual Provides a complete guide to hardware installation
and hardware specifications.
Pluggable SFP[SFP+][XFP]
Transceiver Modules Installation
Guide
Guides you through installing SFP/SFP+/XFP
transceiver modules.
Hardware
installation
Interface Card User Manual Describes how to install the interface card.

Category Documents Purposes
Configuration guides Describe software features and configuration
procedures.
Software
configuration Command references Provide a quick reference to all available commands.
H3C Series Ethernet Switches
Login Password Recovery
Manual
Tells how to find the lost password or recover the
password when the login password is lost.
Operations and
maintenance Release notes
Provide information about the product release,
including the version history, hardware and software
compatibility matrix, version upgrade information,
technical support information, and software upgrading.
Obtaining Documentation
You can access the most up-to-date H3C product documentation on the World Wide Web at
http://www.h3c.com.
Click the links on the top navigation bar to obtain different categories of product documentation:
[Technical Support & Documents > Technical Documents] – Provides hardware installation, software
upgrading, and software feature configuration and maintenance documentation.
[Products & Solutions] – Provides information about products and technologies, as well as solutions.
[Technical Support & Documents > Software Download] – Provides the documentation released with
the software version.
Documentation Feedback
You can e-mail your comments about product documentation to [email protected].
We appreciate your comments.

i
Table of Contents
1 IRF Configuration Commands··················································································································1-1
IRF Configuration Commands ················································································································1-1
display irf ·········································································································································1-1
display irf configuration····················································································································1-2
display irf topology···························································································································1-3
display switchover state···················································································································1-5
irf auto-update enable······················································································································1-6
irf link-delay ·····································································································································1-7
irf mac-address persistent···············································································································1-7
irf member priority····························································································································1-8
irf member renumber·······················································································································1-9
irf member irf-port··························································································································1-10
irf switch-to ····································································································································1-11
2 Index ···························································································································································2-1

1-1
1 IRF Configuration Commands
IRF Configuration Commands
display irf
Syntax
display irf
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display irf command to display information about the current Intelligent Resilient Framework
(IRF) virtual device, which has the device you are working on as its member.
The command displays information of an members of an IRF virtual device, and information about
devices that are joining this IRF virtual device.
Examples
# Display information about the current IRF virtual device.
<Sysname> display irf
Switch Role Priority CPU-MAC
1 Slave 13 000f-e2b8-1f84
2 Slave 1 000f-e220-2122
*3 Master 20 000f-e2b8-1a82
+4 SlaveWait 1 000f-e2c8-1b82
5 Loading 1 000f-e2c8-1c82
--------------------------------------------------------
* indicates the device is the master.
+ indicates the device through which the user logs in.
The Bridge MAC of the IRF is : 000f-e2b8-1a61
Auto upgrade : yes
Mac persistent : 6 min
Table 1-1 display irf command output description
Field Description
Switch Member ID.
zThe ID with * indicates that the device is the master;
zThe ID with + indicates that it is the device that you are working on.
Role The role of a member of the IRF virtual device, which takes the following values:

1-2
Field Description
zSlave
zMaster
zSlaveWait: Joining the IRF virtual device.
zLoading: Loading the system boot file.
CPU-MAC Bridge MAC address of the CPU of the device
Auto upgrade Whether the auto upgrade of configuration files is enabled:
zyes: Enabled
zno: Disabled
Mac persistent
Whether the bridge MAC address preservation is enabled:
z6 min: When the master leaves, the bridge MAC address does not change within
six minutes.
zalways: No matter whether the master leaves the IRF virtual device or not, the
bridge MAC address remains unchanged.
zno: As soon as the master leaves, the IRF virtual device uses the bridge MAC
address of the newly elected master as its bridge MAC address.
display irf configuration
Syntax
display irf configuration
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display irf configuration command to display the pre-configurations of members of the
current IRF virtual device.
The pre-configurations take effect at the reboot of the device. The command displays the member ID,
priority, IRF port state, and port information.
Examples
# Display the pre-configurations of all members of the current IRF virtual device.
<Sysname> display irf configuration
MemberID NewID IRF-Port1 IRF-Port2
1 5 1,2 3,4
2 2 1,2 3
*3 3 1 3
+4 4 1 disable
--------------------------------------------------------
* indicates the device is the master.
+ indicates the device through which the user logs in.

1-3
Table 1-2 display irf configuration command output description
Field Description
MemberID
Member ID
zThe ID with * indicates that the device is the master;
zThe ID with + indicates that it is the device through which the users logs in to
the IRF.
NewID The member ID configured for a device after its reboot
IRF-Port1
The physical IRF port number corresponding to IRF port 1 of a device after its
reboot.
zIf it is displayed as x, it indicates that the IRF port is bound with the physical
IRF port x;
zIf it is displayed as x.y, it indicates that the IRF port is aggregated from the
physical IRF ports xand y;
zIf it is displayed as disable, it indicates that the IRF port is not enabled.
IRF-Port2
The physical IRF port number corresponding to IRF port 2 of a device after its
reboot.
zIf it is displayed as x, it indicates that the IRF port is bound with the physical
IRF port x;
zIf it is displayed as x.y, it indicates that the IRF port is aggregated from the
physical IRF ports xand y;
zIf it is displayed as disable, it indicates that the IRF port is not enabled.
display irf topology
Syntax
display irf topology
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display irf topology command to display topology information about the current IRF virtual
device.
The command displays all topology information learned by the current device.
Examples
# Display topology information about the current IRF virtual device.
<Sysname> display irf topology
Topology Info
-----------------------------------------------------------------------
IRF-Port1 IRF-Port2
Switch Link member neighbor Link member neighbor Belong To
1 DOWN 1,2 -- UP 3,4 2 000f-cbb8-1a82
2 UP 1,2 1 UP 3 3 000f-cbb8-1a82

1-4
*+3 UP 1 2 DIS -- -- 000f-cbb8-1a82
--------------------------------------------------------------------------
* indicates the device is the master.
+ indicates the device through which the user logs in.
The above information indicates following:
zOn device 1, IRF port 1 is aggregated from physical IRF ports 1 and 2, and it is down; IRF port 2 is
aggregated from physical IRF ports 3 and 4, and it is up.
zOn device 2, IRF port 1 is aggregated from physical IRF ports 1 and 2, and it is up; IRF port 2
corresponds to physical IRF port 3, and it is up.
zOn device 3, IRF port 1 corresponds to physical IRF port 1, and it is up; IRF is disabled on IRF port
2.
zIRF port 1 of device 1 does not connect with any other device; IRF port 2 of device 1 connects to
IRF port 1 of device 2; IRF port 2 connects to IRF port 1 of device 3; IRF port 2 of device 3 does not
connect with any other device.
zAll the three devices belong to one IRF virtual device . The bridge MAC address of the master is
000f-cbb8-1a82.
Network topology view is as shown in Figure 1-1:
Figure 1-1 Network topology view
21 Device 1
4Device 2
2 43 Device 3
1
3
2
4
3
1
Link aggregation
Table 1-3 display irf topology command output description
Field Description
Switch Member ID
zThe ID with * indicates that the device is the master;
zThe ID with + indicates t that it is the device that you are working on.
IRF-Port 1 Information of IRF port 1, including link (link state), member (corresponding
physical port), and neighbor.
IRF-Port 2 Information of IRF port 2, including link, member, and neighbor.
BelongTo The IRF that the device belongs to, represented by the IRF CPU MAC address.
Link
Link state of the IRF port:
zUP
zDOWN
zISOLATE: The corresponding physical IRF port is isolated because it cannot
meet the requirement of the IRF. The reason may be that the physical IRF
port connects to a non-S5500-EI device, or the IRF port of the peer end is not
connected according to the port serial numbers.

1-5
Field Description
zTIMEOUT: The port does not receive any Hello packet from the peer end
after the expected time, that is, the Hello packet sent to the port times out.
zDIS: The IRF port is not enabled.
member The corresponding physical port(s) of the IRF port.
If the IRF port is disabled, -- will be displayed.
neighbor The device ID that connects with this IRF port
If the IRF port does not connect with any device, -- will be displayed.
display switchover state
Syntax
display switchover state [ slot slot-id ]
View
Any view
Default Level
1: Monitor level
Parameters
slot slot-id: ID of the IRF member device. With this argument, the command displays the master/slave
switchover state of the specified member. Without this argument, the command displays the
master/slave switchover state of the master.
Description
Use the display switchover state command to display the master/slave switchover states of IRF
members.
An IRF virtual device functions like a logical distributed device with multiple standby switching and
routing processing units (SRPUs). The master is like the active SRPU, and the slaves are like the
standby SRPUs. An IRF system uses member ID to uniquely identify a member device, whereas a
distributed device uses slot ID to uniquely identify a board. Therefore, in the displayed information of
this command, a member device is also identified by the slot ID, which is equal to the member ID.
Examples
# Display the master/slave switchover states of the master.
<Sysname> display switchover state
Master HA State to Slot [1]: Slave is absent.
Master HA State to Slot [2]: Slave is absent.
Master HA State to Slot [4]: Waiting batch backup request from slave.
Master HA State to Slot [5]: Slave is absent.
Master HA State to Slot [6]: Realtime backup to slave.
Master HA State to Slot [7]: Realtime backup to slave.
Master HA State to Slot [8]: Slave is absent.
Master HA State to Slot [9]: Slave is absent.
The above information indicates the following:
zSlaves 1, 2, 5, 8, and 9 are absent, which means that these devices are not in use
zThe master is waiting for the batch backup request from slave 4

1-6
zSlaves 6 and 7 are performing real time backup
Table 1-4 display switchover state command output description for the master
Field Description
Master HA State to Slot slot-id Indicates that this output information is generated by the master.
Describes the master/slave switchover states between the master and
the slave whose slot-id represents its member ID.
Data smooth The master and the slave are smoothing data.
# Display the master/slave switchover state of slave 6.
<Sysname> display switchover state slot 6
Slave HA State: Receiving realtime data.
The above information indicates that slave 6 is receiving real time backup data.
Table 1-5 display switchover state command output description for a slave
Field Description
Slave HA State Indicates that this output information is generated by a slave.
Describes the master/slave switchover state of the slave.
Waiting The slave is ready, and is waiting to enter the batch backup state.
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 enable the auto update of boot files for an IRF virtual
device.
Use the undo irf auto-update enable command to disable this function.
This function is enabled by default.
Note the following:
zBefore adding a device into an IRF virtual device, ensure that the device and the master have the
same software version
zAfter loading the master’s boot file automatically, a slave configures the file as the boot file for the
next boot and reboots automatically.

1-7
zBecause system boot file occupies large memory space, to make the auto upgrade succeed,
ensure that there is enough space on the storage media of the slave.
zIf the downloaded boot file and the local file have duplicate filenames, the local file is overwritten.
To avoid this, check the names of local files and make sure whether you need to save the one with
the same filename or back it up before downloading the boot file.
Examples
# Enable auto upgrade of boot files for an IRF virtual device.
<Sysname> system-view
[Sysname] irf auto-update enable
irf link-delay
Syntax
irf link-delay interval
undo irf link-delay
View
System view
Default Level
3: Manage level
Parameters
interval: Time interval for the link layer to report a link-down event of an IRF virtual device, which ranges
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 virtual device.
Use the undo irf link-delay command to restore the default.
This function is disabled by default.
Examples
# Set the delay time for the link layer to report a link-down event of the current IRF virtual device to 300
milliseconds.
<Sysname> system-view
[Sysname] irf link-delay 300
irf mac-address persistent
Syntax
irf mac-address persistent { timer | always }
undo irf mac-address persistent
View
System view
Default Level
3: Manage level

1-8
Parameters
timer: IRF bridge MAC address preservation mode for an IRF virtual device. With this keyword, the
bridge MAC address is preserved for 6 minutes when the master leaves.
always: Bridge MAC address preservation mode for an IRF virtual device. With this keyword specified,
the bridge MAC address is preserved permanently.
Description
Use the irf mac-address persistent command to configure the preservation time of bridge MAC
address.
Use the undo irf mac-address persistent command to configure the IRF virtual device not to preserve
the bridge MAC address when the master leaves.
zPreserve 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 virtual
device uses the bridge MAC address of the newly elected master as its bridge MAC address.
zPreserve permanently: No matter whether the master leaves the IRF virtual device or not, the
bridge MAC address of the IRF virtual device remains unchanged.
zNot preserved: As soon as the master leaves, the IRF virtual device uses the bridge MAC address
of the newly elected master as its bridge MAC address.
Note the following:
zIf two IRF virtual devices have the same bridge MAC address, they cannot be merged into one IRF
virtual device.
Examples
# Configure the bridge MAC address of the IRF virtual device to be preserved permanently.
<Sysname> system-view
[Sysname] irf mac-address persistent always
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: ID of an IRF member device, in the range 1 to 9.
priority: Priority value, which ranges from 1 to 32.
Description
Use the irf member priority command to specify a priority for a member device.
Use the undo irf member priority command to restore the default.
By default, the priority of a member device is 1.

1-9
The greater the priority value, the higher the priority. Amember with a higher priority is more likely to be
the master, and more likely to preserve its ID in a member ID collision.
Note the following:
zThe setting of priority takes effect right after your configuration.
Examples
# Specify a priority for the local device.
<Sysname> display irf
Switch Role Priority CPU-MAC
1 Slave 13 000f-e2b8-1f84
2 Slave 1 000f-e220-2122
*3 Master 20 000f-e2b8-1a82
+4 SlaveWait 1 000f-e2c8-1b82
5 Loading 1 000f-e2c8-1c82
--------------------------------------------------------
* indicates the device is the master.
+ indicates the device through which the user logs in.
The Bridge MAC of the IRF is : 000f-e2b8-1a67
Auto upgrade : yes
Mac persistent : 6 min
The above information indicates that the member ID of the local device is 4, and you can specify a
priority for the local device by providing its member ID.
<Sysname> system-view
[Sysname] irf member 4 priority 16
# Specify a priority for member 2 in the current IRF.
<Sysname> system-view
[Sysname] irf member 2 priotiry 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: ID of an IRF member device, in the range 1 to 9. With this argument, you can modify a
member ID of another IRF member on this device. You can view the member IDs of in an IRF virtual
device by using the display irf command.
new-member-id: New ID of the member of the IRF virtual device, in the range 1 to 9.
Description
Use the irf member renumber command to set a member for a member of an IRF virtual device.
Use the undo irf member renumber command to remove the configuration.

1-10
By default, the member ID of a member device is 1.
Note the following:
zThe above setting takes effect after the reboot of the device.
zFor an IRF virtual device, member IDs are not only used to identify devices, but also used to
configure IRF ports and member priorities. Therefore, member ID change may cause device
configuration changes or even losses, so change member ID with caution. For example, three
members (of same devicemodel) with the member IDs of 1, 2 and 3 belong to an IRF virtual device.
Assume that each member has several ports: change the member ID of device 2 to 3, change that
of device 3 to 2, reboot both devices, and add them into the IRF virtual device again. Then device 2
uses the original port configurations of device 3, and device 3 uses those of device 2.
zWhen the newly added device and another member have duplicated member IDs, the existing
member can preserve its ID, and the IRF virtual device automatically assigns the smallest unused
member ID to the new member.
Examples
# Set the member ID of the local device (the current member ID is 1) to 3.
<Sysname> system-view
[Sysname] irf member 1 renumber 3
Warning: Renumbering the switch number may result in configuration change or loss.
Continue?[Y/N]:Y
irf member irf-port
Syntax
irf member member-id irf-port irf-port-id port port-list
undo irf member member-id irf-port irf-port-id
View
System view
Default Level
3: Manage level
Parameters
member-id: ID of the IRF member device, in the range 1 to 9. With this argument, you can configure the
IRF ports of another IRF member on this device. You can view the member IDs of in IRF virtual device
by using the display irf command.
irf-port-id: ID of an enabled IRF port, the value can be either 1 or 2.
port-list: Physical IRF port list. The port-list is in the format of { port }&<1-4>, where
zport indicates the port ID. The physical IRF ports are numbered according to their physical
locations on the rear panel of the S5500-EI series. With the rear panel facing you, the physical IRF
ports are numbered successively from left to right: ports on the interface module in slot 1 are
numbered 1 and 2, and ports on the interface module in slot 2 are numbered 3 and 4.
z&<1-4> indicates that you can specify one to four ports at one time. When multiple ports are
specified, they aggregate together to form an IRF port. On the S5500-EI series, only the physical
IRF ports that are on the same interface module can be aggregated together.

1-11
For the correspondence between an IRF port and physical IRF port, see the related part in IRF
Configuration Guide.
Description
Use the irf member irf-port command to bind the physical IRF port(s) to an IRF port of a device, and
enable IRF on the IRF port simultaneously.
Use the undo irf member irf-port command to disable IRF on an IRF port. If this IRF port is
aggregated from multiple physical IRF ports, the aggregated physical ports are disaggregated.
Note the following:
zThe above configuration takes effect after the reboot of the device.
zAn IRF port should be enabled first before it can connect to other devices to form an IRF.
Examples
# Bind physical IRF port 1 to IRF port 1, and enable IRF port 1 of the local device.
<Sysname> system-view
[Sysname] irf member 1 irf-port 1 port 1
# Bind physical IRF ports 3 and 4 to IRF port 2 of member 3, and enable IRF on the IRF port.
<Sysname> system-view
[Sysname] irf member 3 irf-port 2 port 3 4
irf switch-to
Syntax
irf switch-to member-id
View
System view
Default Level
3: Manage level
Parameters
member-id: ID of an IRF member device. The member-id argument in this command cannot be the
member ID of the master.. You can view the member IDs of in an IRF virtual device by using thedisplay
irf command.
Description
Use the irf switch-to command to redirect to the specified slave device, so that you can access the
slave device directly.
When you access an IRF virtual device, you actually log in to the master device. The console of the
master is displayed as the operation interface of the access terminal.After you execute this command,
you are redirected to the specified slave device, which is equal to directly log in to the salve. The
operation interface of the access terminal switches from the console of the master to that of the slave,

1-12
and the system enters the user view of the slave and the command prompt is changed to
<Sysname-Slave#X>, where X is the member ID of the device, for example, <Sysname-Slave#2>.
After this command is executed, the instructions that you input at the terminal will be forwarded to the
specified slave, without being processed by the local device. Currently, you can execute the following
commands on a slave:
zdisplay
zquit
zreturn
zsystem-view
zdebugging
zterminal debugging
zterminal trapping
zterminal logging
You can return to the console of the master by executing the quit command. The master is therefore
reactivated and is ready for outputting information. However, you cannot redirect to the master of the
IRF virtual device with the irf switch-to command.
Examples
# Redirect to member 2.
<Sysname> system-view
[Sysname] irf switch-to 2
<Sysname-Slave#2>

2-1
2 Index
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
A
B
C
D
display irf configuration 1-2
display irf topology 1-3
display irf 1-1
display switchover state 1-5
E
F
G
H
I
irf auto-update enable 1-6
irf link-delay
1-7
irf mac-address persistent 1-7
irf member irf-port 1-10
irf member priority 1-8
irf member renumber 1-9
irf switch-to 1-11
J
K
L
M
N
O
P
Q
R
S
T
U
V
W
X
Y
Z