Table of Contents

1 IRF Fabric Commands· 1-1

IRF Fabric Commands· 1-1

change self-unit 1-1

change unit-id· 1-2

display ftm·· 1-4

display irf-fabric· 1-7

fabric member-auto-update software enable· 1-8

fabric save-unit-id· 1-9

fabric-port enable· 1-11

ftm fabric-vlan· 1-12

irf-fabric authentication-mode· 1-12

port link-type irf-fabric· 1-13

reset ftm statistics· 1-14

set unit name· 1-14

sysname· 1-15

 

IRF Fabric Commands

change self-unit

Syntax

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

View

System view

Parameters

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

auto-numbering: Changes the numbering mode of unit ID on the current switch to automatic numbering mode.

Description

Use the change self-unit command to change 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 the telnet request, and this switch is the current switch. You can use the display irf-fabric command to identify which device is the current device in an IRF fabric.

When you change the unit ID of the current switch, note the following:

l          If the modified unit ID is not used in the IRF fabric, the system sets its priority to 5 and saves it in the Flash memory of the current switch.

l          If the modified unit ID is being used, the system prompts you to confirm if you really want to change the unit ID. If you choose to change it, the existing unit ID is replaced and the priority is set to 5. The original device which uses this unit ID will be auto-numbered again. Then you can use the fabric save-unit-id command to save the modified unit ID into the Flash memory of the current switch.

l          If auto-numbering is selected, the system sets the unit priority to 10. You can use the fabric save-unit-id command to save the modified unit ID into the Flash memory of the current switch.

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

 

 

Examples

# Configure the unit ID of the current switch to be automatically numbered.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] change self-unit to auto-numbering

change unit-id

Syntax

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

View

System view

Parameters

unit-id1: Current unit ID.

unit-id2: New unit ID.

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

Description

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

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

l          If the modified unit ID of the switch is not used in the fabric, the system sets its priority to 5 and saves it in the Flash memory of the switch.

l          If the modified unit ID is being used, the system prompts you to confirm if you really want to change the unit ID. If you choose to change it, the existing unit ID is replaced and the priority is set to 5. The original device which uses this unit ID will be auto-numbered again. Then you can use the fabric save-unit-id command to save the modified unit ID into the Flash memory of the switch.

l          If auto-numbering is selected, the system reserves the unit ID and sets the unit priority to 10. You can use the fabric save-unit-id command to save the modified unit ID into the Flash memory of the switch.

 

 

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

Examples

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

<Sysname> display ftm topology-database

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

UID CPU-Mac        Priority Stack-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           /Right 1        A

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

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

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

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

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

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

<Sysname> system-view

System View: return to User View with Ctrl+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 about each switch in the fabric.

[Sysname] display ftm topology-database

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

UID CPU-Mac        Priority Stack-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           /Right 1        A

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

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

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

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

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

From the above example, you can see the original unit ID of the device with MAC address 000f-cbb7-3264 is 6. After the configuration, this unit ID changes to 4, and the 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 status of 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 to display the protocol information or the topology database information of the current 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

Right Port      : Normal

 

Advertise       : Send = 5, Receive = 3

Advertise ACK   : Send = 0, Receive = 5

Heart Beat      : Send = 20, Receive = 0

 

Left Port       : Index = 255, IsEdge = 0

Right Port      : Index = 25, IsEdge = 0

 

Units Num Left  : 1

Units Num Right : 2

 

Units Num Backup: 2

Table 1-1 display ftm information command output description

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

 

# Display the topology database information of the current fabric.

<Sysname> display ftm topology-database

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

UID CPU-Mac        Priority Fabric-Port Board-ID A/M

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

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

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

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

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

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

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

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

Table 1-2 display ftm topology-database command output description

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

 

display irf-fabric

Syntax

display irf-fabric [ port | status ]

View

Any view

Parameters

port: Displays the fabric port information.

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

Description

Use the display irf-fabric command to view the information of the entire fabric, including unit ID, unit name, and operation mode of the system. If the fabric information is displayed on the console port of a device, an asterisk (*) will be added to the unit ID of the current device.

Examples

# Display fabric information on the console port of unit 1.

<Sysname> display irf-fabric

Fabric name is Sysname, system mode is L3.

Unit Name                                 Unit ID

First                                     1(*)

Second                                    2

From the above example, you can see the following:

l          The name of the fabric is Sysname.

l          The system operation mode is Layer 3 forwarding.

l          The current device is 1 (marked by *)

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

l          The other unit in the fabric is numbered 2

# Display fabric operation status on the console port of unit 1.

<Sysname> display irf-fabric status

Fabric name is Sysname, system mode is L3.

Unit Name                                 Unit ID               Status

First                                     1(*)                  Master

From the above example, you can see not only 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 current device.

<Sysname> display irf-fabric port

 

 GigabitEthernet1/1/1

 Fabric peer: Unknown

 Fabric Status:  Unknown

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

 input:   0 packets, 0 bytes, 0 input errors

 output:  7343 packets, 2250406 bytes, 0 output errors

fabric member-auto-update software enable

Syntax

fabric member-auto-update software enable

undo fabric member-auto-update software enable

View

System view

Parameters

None

Description

Use the fabric member-auto-update software enable command to enable the IRF automatic fabric function for a switch.

Use the undo fabric member-auto-update software enable command to disable the IRF automatic fabric function for a switch.

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

H3C S3600 series switches provide the IRF automatic fabric function, which enables a candidate switch to automatically download the software and change the fabric name in case that the software version and fabric name of the candidate device and that of the device in the fabric are different, thus reducing the manual maintenance workload.

 

 

Examples

# Enable the IRF automatic fabric function for a switch.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] fabric member-auto-update software 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 command to save the unit IDs of all the units in an IRF fabric into the unit Flash and set the unit priority to 5, that is, manual numbering.

Use the undo fabric save-unit-id command to remove the saved unit IDs and restore the unit priority to 10, that is, 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        Priority Stack-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           /Right 1        A

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

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

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

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

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

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

<Sysname> fabric save-unit-id

 The unit ID will be saved to the device.

 Are you sure? [Y/N] y

%Apr  2 02:13:44:413 2000 3600 FTM/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 ID successfully.        

# Display the saved unit IDs of the current fabric.

<Sysname> display ftm topology-database

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

UID CPU-Mac        Priority Stack-Port Board-ID A/M

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

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

 3  000f-e20f-5252 5            /Right 1        M

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

 5  000f-cbb7-2142 5            /Right 1        M

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

 7  000f-cbb7-2260 5            /Right 1        M

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

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

# Remove the saved unit ID of each unit.

<Sysname> undo fabric save-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 Sysname FTM/3/FTMCHIDAUTO:- 1 -Change unitid to auto successful, unit 1 removed UnitID from 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 ftm topology-database

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

UID CPU-Mac        Priority Stack-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           /Right 1        A

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

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

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

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

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

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

fabric-port enable

Syntax

fabric-port interface-type interface-number enable

undo fabric-port interface-type interface-number enable

View

System view

Parameters

interface-type interface-number: Type and port number of a fabric port. On an S3600 series Ethernet switch, only four GigabitEthernet ports can be 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-port enable command to configure a specified port as a fabric port.

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

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

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

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

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

 

 

Examples

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

<Sysname> system-view

System View: return to User View with Ctrl+Z.

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

ftm fabric-vlan

Syntax

ftm fabric-vlan vlan-id

undo ftm fabric-vlan

View

System view

Parameters

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

Description

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

Use the undo ftm fabric-vlan command to restore the default VLAN.

By default, the number of the IRF Fabric VLAN is 4093.

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

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

Examples

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

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] ftm fabric-vlan 2

irf-fabric authentication-mode

Syntax

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

undo irf-fabric authentication-mode

View

System view

Parameters

simple: Uses simple authentication mode.

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

md5: Uses MD5 encryption authentication mode.

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

Description

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

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

By default, no authentication mode is configured on a switch.

IRF fabric authentication is used to ensure the security of the devices accessing it. Only the device configured with the same authentication mode and password with that of the fabric can access the current IRF fabric.

Examples

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

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] irf-fabric authentication-mode simple hello

port link-type irf-fabric

Syntax

port link-type irf-fabric

View

Ethernet port view

Parameters

None

Description

Use the port link-type command to configure an Ethernet port as the fabric port. This command has the same function with the fabric-port enable command, and is available only in gigabit port view.

By default, no port is configured as the fabric port.

Note that:

After you use the port link-type irf-fabric command to specify a port as the fabric port, you cannot use the port link-type command to change the port to a port of other types. You need to use the undo fabric-port command first to disable the fabric port function of the port to change the port type.

Examples

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

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface GigabitEthernet 1/1/1

[Sysname-GigabitEthernet1/1/1] port link-type irf-fabric

reset ftm statistics

Syntax

reset ftm statistics

View

User view

Parameters

None

Description

Use the reset ftm statistics command to clear FTM statistics. You can use this command together with the display ftm command to view the packet statistics processed by FTM in a period of time, 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. Device name 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 with Ctrl+Z.

[Sysname] set unit 1 name hello

[Sysname] display irf-fabric

Fabric name is Sysname, system mode is L3.

Unit Name     Unit ID       

hello            1          

Second          2(*)           

sysname

Syntax

sysname sysname

undo sysname

View

System view

Parameters

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

Description

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

Use the undo sysname command to 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 devices in the fabric are consistent. You can enable the IRF automatic fabric function by using the fabric member-auto-update software enable command to configure the device to synchronize the fabric name automatically.

By default, the fabric name of an S3600 Series 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 with Ctrl+Z.

[Sysname] sysname hello

[hello] display irf-fabric

Fabric name is hello, system mode is L3.

Unit Name     Unit ID            

First             1             

Second          2(*)