Support - 29-IRF Fabric Command (2024)

IRF FabricCommands

changeself-unit

Syntax

change self-unit to { unit-id | auto-numbering }

View

System view

Parameters

unit-id: Changesthe unit ID of the current switch to a specified value which is in the range of1 to 8.

auto-numbering: Changes the numbering mode of unit ID onthe current switch to automaticnumbering mode.

Description

Use the change self-unit command tochange the unit ID of the current switch. If a user telnets to an IRF fabric,only the switch connecting with the network of the telnet user responds to thetelnet request, and this switch is the current switch. You can use the displayirf-fabric command to identify which device is the current device in an IRFfabric.

When you change the unit ID of the currentswitch, note the following:

lIf the modified unit ID is not used in the IRFfabric, the system sets its priority to 5 and saves it in the Flash memory ofthe current switch.

lIf the modified unit ID is being used, thesystem prompts you to confirm if you really want to change the unit ID. If youchoose to change it, the existing unit ID is replaced and the priority is setto 5. The original device which uses this unit ID will be auto-numbered again. Thenyou can use the fabric save-unit-id command to save the modified unit IDinto the Flash memory of the current switch.

lIf auto-numbering is selected, the systemsets the unit priority to 10. You can use the fabric save-unit-idcommand to save the modified unit ID into the Flash memory of the currentswitch.

By default, the unit ID of a switch that belongsto no IRF fabric is 1. After a switch is added to an IRF fabric, it isautomatically numbered through FTM function.

lIf you do not bring up the fabric port, youcannot change the unit ID of a switch.

lAfter the unit ID of a device is changed, the unitID-related information of this device in the configuration file of the fabric willbe upgraded automatically. If the unit ID of a device changes from 2 to 4, the portdescription of this device in the configuration file automatically changes from2/0/x to 4/0/x.

Examples

# Configure the unitID of the current switch to be automatically numbered.

<Sysname> system-view

System View: return to User View withCtrl+Z.

[Sysname] change self-unit toauto-numbering

changeunit-id

Syntax

change unit-id unit-id1 to { unit-id2 | auto-numbering }

View

System view

Parameters

unit-id1: Currentunit ID.

unit-id2: Newunit ID.

auto-numbering: Changes the numberingmode of unit ID on a specified switch (not the current switch) to automatic numbering mode.

Description

Use the change unit-id command to configurethe unit ID of a specified switch in an IRF fabric to a new value. By default, whena switch is added to an IRF fabric, it uses the automatically assigned unit ID.

When you change the unit ID of a switch inan IRF fabric, note the following:

lIf the modified unit ID of the switch is not usedin the fabric, the system sets its priority to 5 and saves it in the Flashmemory of the switch.

lIf auto-numbering is selected, the systemreserves the unit ID and sets the unit priority to 10. You can use the fabricsave-unit-id command to save the modified unit ID into the Flash memory ofthe switch.

lUnit IDs in an IRF fabric are not alwaysarranged in order of 1 to 8.

lUnit IDs in an IRF fabric can be inconsecutive.

lAfter the unit ID of a device is changed, theunit ID-related information of this device in the configuration file of thefabric will be upgraded automatically. If the unit ID of a device changes from2 to 4, the port description of this device in the configuration fileautomatically changes from 2/0/x to 4/0/x.

Related commands: fabric save-unit-id,display ftm.

Examples

# Display the unit ID information abouteach switch in an IRF fabric.

<Sysname> display ftm topology-database

Total number of units in fabric : 2,My CPU ID : 6

UID CPU-Mac PriorityStack-Port Board-ID A/M

1 000f-e20f-5002 10/Right 1 A

2 000f-e20f-5132 10 Left/1 A

3 000f-e20f-5252 10 /Right1 A

4 000f-e20f-8922 10 Left/1 A

5 000f-cbb7-2142 10/Right 1 A

*6 000f-cbb7-3264 10Left/ 1 A

7 000f-cbb7-2260 10/Right 1 A

8 000f-cbb7-2734 10Left/ 1 A

# Change the unit ID of the switch from 6to 4.

<Sysname> system-view

System View: return to User View withCtrl+Z.

[Sysname] change unit-id 6 to 4

The unit 4 already exists in fabric.

Continue? [Y/N] y

%Apr 2 00:48:34:574 2000 Sysname FTM/3/DDPFLA:-6 -Change unitid successful, un

it 4 saved UnitID(4) in flash!

# Display the unit ID information abouteach switch in the fabric.

[Sysname] display ftm topology-database

Total number of units in fabric : 2,My Unit ID : 4

UID CPU-Mac PriorityStack-Port Board-ID A/M

1 000f-e20f-5002 10 /Right1 A

2 000f-e20f-5132 10 Left/1 A

3 000f-e20f-5252 10 /Right1 A

*4 000f-cbb7-3264 5 Left/1 M

5 000f-cbb7-2142 10/Right 1 A

6 000f-e20f-8922 10Left/ 1 A

7 000f-cbb7-2260 10/Right 1 A

8 000f-cbb7-2734 10Left/ 1 A

From the aboveexample, you can see the original unit ID of the device with MAC address000f-cbb7-3264 is 6. After the configuration, this unit ID changes to 4, andthe priority of the device changes to 5.

display ftm

Syntax

display ftm {information | topology-database }

View

Any view

Parameters

information:Displays the FTM module information, including DDP status, unit ID, link statusof the fabric, status of the fabric port, and DDP packet statistics.

topology-database: Displays the topology database information of the fabric.

Description

Use the display ftm command todisplay the protocol information or the topology database information of thecurrent fabric.

Examples

# Display the FTM module information of the switch.

<Sysname> display ftm information

FTM State : HB STATE

Unit ID : 2 (FTM-Master)

Fabric Type : Line

Fabric Auth : NONE

Fabric Vlan ID : 4093

Left Port : Disable

RightPort : Normal

Advertise: Send = 5, Receive = 3

AdvertiseACK : Send = 0, Receive = 5

Field	Description
FTM State	FTM State: l DISC STATE: In the topology discovery state. l LISTEN STATE: In the topology discovery state, and the FTM slave device is listening. l HB STATE: The fabric operates normally.
Unit ID	Unit ID: l FTM-Master l FTM-Slave
Fabric Type	Fabric topology structure: l Line l Ring
Fabric Auth	Authentication mode for an IRF fabric You can use the irf-fabric authentication-mode command to configure the authentication mode and password for an IRF fabric.
Fabric Vlan ID	ID of the VLAN transmitting fabric synchronization information. You can use the ftm fabric-vlan command to specify the VLAN used to form an IRF fabric.
Left Port Right Port	Status of the two fabric ports on a device: l Link-Down l Isolated (temporary): The fabric is not in a normal state yet, and the fabric port is isolated temporarily. l Isolated (redundance port): Redundant link in a ring topology. l Isolated (reached max units) l Isolated (different system name): The fabric name of the device directly connected to the switch and the existing fabric name of the fabric are different. l Isolated (different version): The software version of the directly connected device and that of the current device are different. l Isolated (auth failure): The IRF fabric authentication modes configured for the local device and that of the fabric are not the same, or the password configured does not match. l Isolated (connection error): Fabric port connection error occurs. l Disable: Fabric is disabled on the port. l Normal Refer to the Operation Manual for the status and solution of the problems.
Advertise : Advertise ACK : Heart Beat : Left Check : Right Check : Auto update :	Numbers of various negotiation packets: l Advertise l Advertise ACK l Heart Beat: Heat beat packet, which is used to advertise topology connections to the units by the FTM-Master after convergence. l Left Check: Handshake packets between neighbors. They are sent from the left port and used to monitor the state of the neighbors periodically. l Right Check: Handshake packets between neighbors. They are sent from the right port and used to monitor the state of the neighbors periodically. l Auto update: Number of auto update packets sent and received You can use the above numbers to analyze whether the transmission of data among fabric units is normal, and thus to judge whether the fabric operates normally.
Left Port : Index = 255, IsEdge = 0 Right Port : Index = 25, IsEdge = 0	Indexes of the left and right ports: l IsEdge: Whether the device is at either end of a bus topology IRF fabric in which the number of member devices has reached the upper limit. l 0: No l 1: Yes
Units Num Left : 1 Units Num Right : 2	Number of units (both directly-connected and subtending units) connected to the port, including the device itself. l 1: The left port has no connected unit l 2: The right port connects to one unit
Units Num Backup: 2	Total number of units in a fabric

Field	Description
UID	Unit ID
Priority	Priority value: l 10 means the switch adopts automatic numbering l 5 means the switch adopts manual numbering Manual numbering has a higher priority than automatic numbering.
Fabric-Port	Fabric port l In a ring topology structure, the left and right ports of all units are connected, and are displayed as Left/Right. l In a bus topology structure, the units at both ends of the bus have only one fabric port connected, displayed as Left/ or /Right.
A/M	Indicates that the switch adopts automatic numbering or manual numbering: l A for automatic l M for manual

displayirf-fabric

Syntax

displayirf-fabric [ port | status ]

View

Any view

Parameters

port: Displaysthe fabric port information.

status:Displays operation status of the current fabric, including fabric name and unitID.

Description

Use the display irf-fabric commandto view the information of the entire fabric, including unit ID, unit name, andoperation mode of the system. If the fabric information is displayed on the consoleport of a device, an asterisk (*) will be added to the unit ID of the currentdevice.

Examples

# Display fabric information on the consoleport of unit 1.

<Sysname> display irf-fabric

Fabric name is Sysname, system modeis L3.

UnitName Unit ID

First1(*)

Second2

From the above example, you can see the following:

lThe name of the fabric is Sysname.

lThe system operation mode is Layer 3 forwarding.

lThe current device is 1 (marked by *)

lThe name of the current device is First (thename of a device can be configured by using the set unit name command)

lThe other unit in the fabric is numbered 2

# Display fabric operation status on the consoleport of unit 1.

<Sysname> display irf-fabricstatus

Fabric name is Sysname, system modeis L3.

UnitName Unit ID Status

First 1(*)Master

From the above example, you can see notonly the information displayed by using the display irf-fabric command,but also the roles of the units in the fabric (master or slave).

# Display the fabric port of the currentdevice.

<Sysname> display irf-fabricport

GigabitEthernet1/1/1

Fabric peer: Unknown

Fabric Status: Unknown

Fabric mode: Unknown-speed mode,Unknown-duplex mode

input: 0 packets, 0 bytes, 0 inputerrors

output: 7343 packets, 2250406bytes, 0 output errors

fabricmember-auto-update software enable

Syntax

fabric member-auto-update softwareenable

undo fabric member-auto-update softwareenable

View

System view

Parameters

None

Description

Use the fabric member-auto-updatesoftware enable command to enable the IRF automatic fabric function for aswitch.

Use the undo fabricmember-auto-update software enable command to disable the IRF automaticfabric function for a switch.

By default, the IRF automatic fabricfunction for a switch is disabled.

H3C S3600 series switches provide the IRFautomatic fabric function, which enables a candidate switch to automaticallydownload the software and change the fabric name in case that the softwareversion and fabric name of the candidate device and that of the device in thefabric are different, thus reducing the manual maintenance workload.

lYou need to enable the IRF automatic fabricfunction on all the devices including the candidate switch in the fabric toenable the candidate switch to download software and discovery neighbors andthus be added to the fabric normally.

lIf the candidate switch is going to downloadsoftware from a unit in an IRF fabric, you are recommended to set the ID of theunit to 1 to make the candidate switch download the software of correctversion.

lBefore configuring the IRF automatic fabricfunction, make sure that the candidate switch has enough Flash space todownload the software.

lAfter you configure the IRF automatic fabricfunction on Slave, execute the save command to save the configurationsas soon as possible. Otherwise, the device may synchronize the configurationsfrom Master and restart repeatedly because the configurations on the device arelost after the device automatically downloads the software and restarts.

Examples

# Enable the IRF automatic fabric functionfor a switch.

<Sysname> system-view

System View: return to User View withCtrl+Z.

[Sysname] fabric member-auto-updatesoftware enable

fabric save-unit-id

Syntax

fabric save-unit-id

undo fabric save-unit-id

View

User view

Parameters

None

Description

Use the fabric save-unit-id commandto save the unit IDs of all the units in an IRF fabric into the unit Flash and setthe unit priority to 5, that is, manual numbering.

Use the undo fabric save-unit-idcommand to remove the saved unit IDs and restore the unit priority to 10, thatis, automatic numbering.

Examples

# Display the unit IDs of the current fabric.

<Sysname> display ftm topology-database

Total number of units in fabric : 8,My Unit ID : 1

UID CPU-Mac PriorityStack-Port Board-ID A/M

*1 000f-e20f-5002 10 /Right1 A

2 000f-e20f-5132 10 Left/1 A

3 000f-e20f-5252 10 /Right1 A

4 000f-e20f-8922 10 Left/1 A

5 000f-cbb7-2142 10 /Right1 A

6 000f-cbb7-3264 10 Left/1 A

7 000f-cbb7-2260 10 /Right1 A

8 000f-cbb7-2734 10 Left/1 A

# Save the unit IDs of all the units in anIRF fabric to the unit Flash memory.

<Sysname> fabric save-unit-id

The unit ID will be saved to thedevice.

Are you sure? [Y/N] y

%Apr 2 02:13:44:413 2000 3600FTM/3/DDPFLA:- 4 -Save self unitid, unit 4 sav

ed UnitID(4) in flash!

Unit 1 saved unit ID successfully.

Unit 2 saved unit ID successfully.

Unit 3 saved unit ID successfully.

Unit 4 saved unit ID successfully.

Unit 5 saved unit ID successfully.

Unit 6 saved unit ID successfully.

Unit 7 saved unit ID successfully.

Unit 8 saved unit IDsuccessfully.

# Display the saved unit IDs of the currentfabric.

<Sysname> display ftm topology-database

Total number of units in fabric : 8,My Unit ID : 4

UID CPU-Mac PriorityStack-Port Board-ID A/M

*1 000f-e20f-5002 5 /Right1 M

2 000f-e20f-5132 5 Left/1 M

3 000f-e20f-5252 5 /Right1 M

4 000f-e20f-8922 5 Left/1 M

5 000f-cbb7-2142 5 /Right1 M

6 000f-cbb7-3264 5 Left/1 M

7 000f-cbb7-2260 5 /Right1 M

8 000f-cbb7-2734 5 Left/1 M

From the above example, you can see thepriority of each unit changes from 10 to 5, and the numbering mode changes fromA (automatic numbering) to M (manual numbering).

# Remove the saved unit ID of each unit.

<Sysname> undo fabricsave-unit-id

The saved unit ID will be erased.

Are you sure? [Y/N] y

Unit 1 removed unit ID successfully.

%Apr 2 19:43:24:368 2000 SysnameFTM/3/FTMCHIDAUTO:- 1 -Change unitid to auto successful, unit 1 removed UnitIDfrom flash!

Unit 2 removed unit ID successfully.

Unit 3 removed unit ID successfully.

Unit 4 removed unit ID successfully.

Unit 5 removed unit ID successfully.

Unit 6 removed unit ID successfully.

Unit 7 removed unit ID successfully.

Unit 8 removed unit ID successfully.

# Display the unit IDs of the current fabric.

<Sysname> display ftmtopology-database

Total number of units in fabric : 8,My Unit ID : 1

UID CPU-Mac PriorityStack-Port Board-ID A/M

*1 000f-e20f-5002 10/Right 1 A

2 000f-e20f-5132 10Left/ 1 A

3 000f-e20f-5252 10/Right 1 A

4 000f-e20f-8922 10Left/ 1 A

5 000f-cbb7-2142 10/Right 1 A

6 000f-cbb7-3264 10Left/ 1 A

7 000f-cbb7-2260 10/Right 1 A

8 000f-cbb7-2734 10Left/ 1 A

From the aboveexample, you can see the priority of each unit restores to 10 and the numberingmode changes from M (manual numbering) to A (automatic numbering).

fabric-port enable

Syntax

fabric-port interface-type interface-numberenable

undo fabric-port interface-type interface-numberenable

View

System view

Parameters

interface-typeinterface-number: Type and port number of a fabricport. On an S3600 series Ethernet switch, only four GigabitEthernet ports canbe configured as fabric ports: GigabitEthernet 1/1/1, GigabitEthernet 1/1/2,GigabitEthernet 1/1/3, and GigabitEthernet 1/1/4.

Description

Use the fabric-portenable command to configure a specified port as a fabric port.

Use the undofabric-port enable command to disable the fabric port function for a port. Whenthe last fabric port on a switch is disabled, the fabric function is disabled globally.

The four ports on an S3600 series Ethernetswitch fall into two groups according to their port numbers:

lGigabitEthernet 1/1/1 and GigabitEthernet 1/1/2form the first group.

lGigabitEthernet 1/1/3 and GigabitEthernet 1/1/4form the second group.

Only one group of ports can be configuredas fabric ports at a time. Given a group, either GigabitEthernet 1/1/1 orGigabitEthernet 1/1/3 can be configured as the left fabric port, and eitherGigabitEthernet 1/1/2 or GigabitEthernet 1/1/4 can be configured as the rightfabric port.

lEstablishing an IRF system requires a highconsistency of the configuration of each device. Hence, before you bring up thefabric port, do not perform any configuration for the port, and do not enablesome functions that affect the IRF (such as TACACS and VLAN-VPN) for otherports or globally. Otherwise, you cannot bring up the fabric port. For detailedrestrictions, refer to the error information output by devices.

lWhen you have brought up fabric port functionfor a fabric port group, if you need to change the fabric port group, you mustdisable the fabric function of the current fabric port group before you executethe enable command on another group. Otherwise, the system will prompt that thecurrent fabric port group is in use, you cannot change the fabric port group.

Examples

# Set GigabitEthernet 1/1/3 port as a fabricport.

<Sysname> system-view

System View: return to User View withCtrl+Z.

[Sysname] fabric-port GigabitEthernet1/1/3enable

ftmfabric-vlan

Syntax

ftm fabric-vlan vlan-id

undo ftm fabric-vlan

View

System view

Parameters

vlan-id: IDof the IRF fabric VLAN, in the range of 2 to 4094. The VLAN you specified mustbe the one that has not been created manually.

Description

Use the ftm fabric-vlan command tospecify the VLAN that the switch uses for IRF fabric.

Use the undo ftm fabric-vlan commandto restore the default VLAN.

By default, the number of the IRF Fabric VLANis 4093.

In an IRF fabric, the VLAN is used to synchronizeconfigurations and transmit IRF data among devices, avoiding packets being sentto non fabric ports

You need to specify the IRF fabricVLAN before the IRF fabric isestablished. Because after the fabric is established, theVLAN cannot be modified.

Examples

# Specify VLAN 2 of the switch as an IRF fabricVLAN.

<Sysname> system-view

System View: return to User View withCtrl+Z.

[Sysname] ftm fabric-vlan 2

irf-fabricauthentication-mode

Syntax

irf-fabric authentication-mode { simple password | md5 key }

undo irf-fabric authentication-mode

View

System view

Parameters

simple: Usessimple authentication mode.

password:Password for fabric authentication, a string of 1 to 16 characters.

md5: UsesMD5 encryption authentication mode.

key: MD5 key,a string of 1 to 16 characters.

Description

Use the irf-fabric authentication-modecommand to configure the authentication mode and password for an IRF fabric.

Use the undo irf-fabric authentication-modecommand to remove the IRF fabric authentication configuration.

By default, no authentication mode isconfigured on a switch.

IRF fabric authentication is used to ensurethe security of the devices accessing it. Only the device configured with thesame authentication mode and password with that of the fabric can access thecurrent IRF fabric.

Examples

# Set the authentication mode of the IRF fabric to simple, with thepassword being hello.

<Sysname> system-view

System View: return to User View withCtrl+Z.

[Sysname] irf-fabric authentication-modesimple hello

portlink-type irf-fabric

Syntax

port link-type irf-fabric

View

Ethernet port view

Parameters

None

Description

Use the port link-type command toconfigure an Ethernet port as the fabric port. This command has the samefunction with the fabric-port enable command, and is available only ingigabit port view.

By default, no port is configured as thefabric port.

Note that:

After you use the port link-typeirf-fabric command to specify a port as the fabric port, you cannot use theport link-type command to change the port to a port of other types. Youneed to use the undo fabric-port command first to disable the fabricport function of the port to change the port type.

Examples

# Set GigabitEthernet 1/1/1 port as a fabricport.

<Sysname> system-view

System View: return to User View withCtrl+Z.

[Sysname] interface GigabitEthernet1/1/1

[Sysname-GigabitEthernet1/1/1] portlink-type irf-fabric

reset ftm statistics

Syntax

reset ftm statistics

View

User view

Parameters

None

Description

Use the reset ftm statistics commandto clear FTM statistics. You can use this command together with the displayftm command to view the packet statistics processed by FTM in a period oftime, thus analyzing fabric operation status and locating problems.

Related commands: display ftm.

Examples

# Clear FTM statistics.

<Sysname> reset ftm statistics

set unit name

Syntax

set unit unit-id name unit-name

View

System view

Parameters

unit-id: Unit ID of a device.

unit-name: Name of the specified unit, a string of 1 to 64 characters.

Description

Use the set unit name command to set a name for a device. Devicename visually identifies a device by showing its location, role in the fabric,and connected networks, thus facilitating configuration and maintenance.

Examples

# Set the name to hello for the device with unit ID 1.

<Sysname> display irf-fabric

Fabric name is Sysname, system mode is L3.

Unit Name Unit ID

First 1

Second 2(*)

<Sysname> system-view

System View: return to User View withCtrl+Z.

[Sysname] set unit 1 name hello

[Sysname] display irf-fabric

Fabric name is Sysname, system modeis L3.

Unit Name Unit ID

hello 1

Second 2(*)

sysname

Syntax

sysname sysname

undo sysname

View

System view

Parameters

sysname: Nameof the specified fabric, a string of 1 to 30 characters.

Description

Use the sysname command to set thename for the fabric where a device belongs. The modification will affect the prompt character in the command line interface. Forexample, if the fabric name of the Ethernet switch is H3C, the prompt characterin user view is <H3C>.

Use the undo sysname commandto restore the default fabric name.

Before a new device is added into a fabric,make sure that the fabric name of the device and the fabric name of the devicesin the fabric are consistent. You can enable the IRF automatic fabric functionby using the fabric member-auto-update software enable command to configurethe device to synchronize the fabric name automatically.

By default, the fabric name of an S3600Series Ethernet switch is H3C.

Examples

# Change the fabric name of the device to hello.

<Sysname> display irf-fabric

Fabric name is Sysname, system mode is L3.

Unit Name Unit ID

First 1

Second 2(*)

<Sysname> system-view

System View: return to User View withCtrl+Z.

[Sysname] sysname hello

[hello] display irf-fabric

Fabric name is hello, system mode isL3.

Unit Name Unit ID

First 1

Second 2(*)