02-IRF Command Reference

HomeSupportResource CenterReference GuidesCommand ReferencesH3C S12500-X & S12500X-AF Switch Series Command References-Release 113x-6W10102-IRF Command Reference
Table of Contents
Related Documents
01-Text
Title Size Download
01-Text 186.10 KB

IRF commands

All IRF commands are available only on the default MDC, except for the commands in Table 1.

Table 1 IRF commands available on both default and non-default MDCs

Command category

Commands

Display commands

display irf link

MAD commands

mad bfd enable

mad enable

mad exclude interface

mad ip address

 

For more information about MDC, see Fundamentals Configuration Guide.

chassis convert mode irf

Use chassis convert mode irf to enable IRF mode.

Use undo chassis convert mode to restore standalone mode.

Syntax

chassis convert mode irf

undo chassis convert mode

Default

The device operates in standalone mode.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

To set up an IRF fabric, place all member devices in IRF mode after you configure member IDs, priorities, and IRF port settings for the member devices. In standalone mode, a device cannot form an IRF fabric with other devices.

IRF generates packets on a device in IRF mode even if the device does not form an IRF fabric with any other devices. To conserve system resources, set a device to standalone mode after you remove the device from an IRF fabric.

Examples

# Enable IRF mode.

<Sysname> system-view

[Sysname] chassis convert mode irf

The device will switch to IRF mode and reboot.

You are recommended to save the current running configuration and specify the configuration file for the next startup. Continue? [Y/N]:y

 Do you want to convert the content of the next startup configuration file flash:/startup.cfg to make it available in IRF mode? [Y/N]:y

 Please wait...

 Saving the converted configuration file to the main board succeeded.

Slot 17:

 Saving the converted configuration file succeeded.

 Now rebooting, please wait...

# Restore standalone mode.

<Sysname> system-view

[Sysname] undo chassis convert mode

The device will switch to stand-alone mode and reboot.

You are recommended to save the current running configuration and specify the configuration file for the next startup. Continue? [Y/N]:y

Do you want to convert the content of the next startup configuration file flash:/startup.cfg to make it available in stand-alone mode? [Y/N]:y

Please wait...

Saving the converted configuration file to the main board succeeded.

Chassis 2 Slot 16:

Saving the converted configuration file succeeded.

Now rebooting, please wait...

display irf

Use display irf to display IRF fabric information, including the member ID, role, priority, bridge MAC address, and description of each IRF member.

Syntax

display irf

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Examples

# Display IRF fabric information.

<Sysname> display irf

MemberID  Slot  Role   Priority  CPU-Mac           Description

 *+1       16    Master  1           0210-fc03-0007  -----

--------------------------------------------------

 * indicates the device is the master.

 + indicates the device through which the user logs in.

 The Bridge MAC of the IRF is: 3ce5-a6b8-3800

 Auto upgrade                   : yes

 Mac persistent                : always

 Domain ID                      : 0

 Auto merge                     : no

Table 2 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.

Slot

MPU slot number.

Role

Role of the MPU in the IRF fabric:

·     Standby—Standby MPU for the global active MPU.

·     Master—Global active MPU.

·     Loading—Standby MPU for the global active MPU. The standby MPU is loading software images.

Priority

IRF member priority.

CPU-MAC

MAC address of the CPU on the MPU.

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.

Auto upgrade

Status of the software auto-update feature:

·     yes—Enabled. The global active MPU automatically pushes its software images to the MPUs you are adding to the IRF fabric.

·     no—Disabled. You must manually make sure the joining MPUs use the same software images as the global active MPU. If the software images are different, the joining MPUs cannot be added to the IRF fabric.

MAC persistent

IRF bridge MAC persistence setting:

·     alwaysBridge 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.

Auto merge

State of the auto-merge feature:

·     yesEnabled. The IRF fabric automatically reboots its member devices when it fails in the master election during an IRF fabric merge.

·     noDisabled. Manual reboot is required to complete an IRF fabric merge.

 

display irf configuration

Use display irf configuration to display basic IRF settings on each IRF member device, including the current member ID, new member ID, and physical interfaces bound to the IRF ports. The new member IDs take effect at reboot.

Syntax

display irf configuration

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Examples

# (In standalone mode.) Display the basic IRF settings of the device.

<Sysname> display irf configuration

 MemberID Priority IRF-Port1                   IRF-Port2

 --         1         disable                     disable

# (In IRF mode.) Display all members' basic IRF settings.

<Sysname> display irf configuration

MemberID  NewID  IRF-Port1                     IRF-Port2

  1        1       FortyGigE1/8/0/1             disable

                   FortyGigE1/8/0/2

  2        2       disable                        FortyGigE2/8/0/1

                                                    FortyGigE2/8/0/2

Table 3 Command output

Field

Description

MemberID

Current member ID of the device.

If no member ID is assigned, this field displays two hyphens (--).

Priority

Member priority.

This field is displayed only when the device is operating in standalone mode.

NewID

Member ID assigned to the device. This member ID takes effect at reboot.

This field is displayed only when the device is operating in IRF mode.

IRF-Port1

Physical interfaces bound to IRF-port 1. The bindings take effect at reboot.

If this IRF port is not enabled, this field displays disable.

IRF-Port2

Physical interfaces bound to IRF-port 2. The bindings take effect at reboot.

If this IRF port is not enabled, this field displays disable.

 

display irf link

Use display irf link to display IRF link information, including IRF ports, IRF physical interfaces, and IRF link status.

Syntax

display irf link

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Examples

# Display IRF link information.

<Sysname> display irf link

Member 1

 IRF Port  Interface                   Status

 1          FortyGigE1/9/0/1(MDC1)    UP

            FortyGigE1/9/0/2(MDC1)    UP

            FortyGigE1/9/0/3(MDC1)    DOWN

            FortyGigE1/9/0/4(MDC1)    ADM

 2          disable                     --

Member 2

 IRF Port  Interface                   Status

 1          disable                      --

 2          FortyGigE2/8/0/1(MDC2)    UP

            FortyGigE2/8/0/2(MDC2)    UP

            FortyGigE2/8/0/3(MDC2)    DOWN

            FortyGigE2/8/0/4(MDC2)    ADM

Table 4 Command output

Field

Description

Member ID

IRF member ID.

IRF Port

IRF port number:

·     1—IRF-port 1.

·     2—IRF-port 2.

Interface

Physical interfaces bound to the IRF port, and their respective MDCs. This field displays disable if no physical interfaces have been bound to the IRF port.

Status

Link state of IRF physical interfaces:

·     UP—The link is up.

·     DOWN—The link is down.

·     ADM—The interface has been manually shut down with 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, including the member IDs, IRF port state, adjacencies of IRF ports, and CPU MAC address of the master.

Syntax

display irf topology

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-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            UP          2              DIS         ---         00e0-fc0f-8c0f

2            DIS        ---             UP         1            00e0-fc0f-8c0f

Figure 1 IRF topology

 

Table 5 Command output

Field

Description

IRF-Port 1

Information about IRF-port 1, including its link state and neighbor.

IRF-Port 2

Information about IRF-port 2, including its link state and neighbor.

Link

Link state of the IRF port:

·     UPThe IRF link is up.

·     DOWNThe IRF link is down.

·     DISNo physical interfaces have been bound to the IRF port.

·     TIMEOUTIRF hello interval has timed out.

neighbor

IRF member ID of the device connected to the IRF port.

If no device is connected to the IRF port, this field displays three hyphens (---).

Belong To

IRF fabric that has the device, represented by the CPU MAC address of the master in the IRF fabric.

 

display irf-port load-sharing mode

Use display irf-port load-sharing mode to display IRF link load sharing mode.

Syntax

display irf-port load-sharing mode [ irf-port [ member-id/port-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

irf-port: Displays IRF port-specific load sharing modes.

member-id/port-number: Specifies an IRF port number. The member-id argument represents an IRF member ID. The port-number argument represents the index number (1 or 2) of the IRF port on the member device.

Usage guidelines

To display the global load sharing mode for IRF links, execute this command without any keywords or arguments.

To display the load sharing mode used on each IRF port in the IRF fabric, specify the irf-port keyword but not any IRF port.

To display the load sharing mode used on a specific IRF port, specify both the irf-port keyword and the member-id/port-number argument.

Examples

# Display the global load sharing mode for IRF links. In this example, because no user-defined global load sharing mode has been configured, the default global load sharing mode applies.

<Sysname> display irf-port load-sharing mode

irf-port Load-Sharing Mode:

Layer 2 traffic: destination-mac address, source-mac address

Layer 3 traffic: destination-ip address,  source-ip address

Layer 4 traffic: destination-port,         source-port

# Display the global load sharing mode for IRF links. In this example, because a global load sharing mode based on source and destination IP addresses have been configured, the configured mode applies.

<Sysname> display irf-port load-sharing mode

irf-port Load-Sharing Mode:

  destination-ip address,  source-ip address

# Display the load sharing mode of IRF-port 1/1. In this example, because neither port-specific load sharing mode nor user-defined global load sharing mode has been configured, the default global load sharing mode applies.

<Sysname> display irf-port load-sharing mode irf-port 1/1

irf-port 1/1 Load-Sharing Mode:

Layer 2 traffic: destination-mac address, source-mac address

Layer 3 traffic: destination-ip address,  source-ip address

Layer 4 traffic: destination-port,         source-port

# Display the load sharing mode of IRF-port 1/1. In this example, a load sharing mode based on source and destination MAC addresses has been configured on the port.

<Sysname> display irf-port load-sharing mode irf-port 1/1

irf-port1/1 Load-Sharing Mode:

  destination-mac address, source-mac address

# Display the load sharing mode used on each IRF port.

<Sysname> display irf-port load-sharing mode irf-port

irf-port1/1 Load-Sharing Mode:

destination-mac address, source-mac address

 

irf-port1/2 Load-Sharing Mode:

Layer 2 traffic: destination-mac address, source-mac address

Layer 3 traffic: destination-ip address,  source-ip address

Layer 4 traffic: destination-port,         source-port

Table 6 Command output

Field

Description

irf-port Load-Sharing Mode

Global load sharing mode for IRF links:

·     If no global IRF link load sharing mode has been configured, the default global load sharing mode applies.

·     If a user-defined global load sharing mode has been configured, the configured mode applies.

irf-port 1/1 Load-Sharing Mode

Link load sharing mode of IRF-port 1/1:

·     If you have not configured a port-specific load sharing mode, the global IRF link load sharing mode applies.

·     If you have configured a port-specific load sharing mode, the configured mode applies.

Layer 2 traffic: destination-mac address, source-mac address

Default load sharing mode for traffic that has no IP header. By default, this type of traffic is distributed based on source and destination MAC addresses.

Layer 3 traffic: destination-ip address,  source-ip address

Default load sharing mode for non-TCP/-UDP IP packets. By default, this type of traffic is distributed based on source and destination IP addresses.

Layer 4 traffic: destination-port,        source-port

Default load sharing mode for TCP/UDP packets. By default, this type of traffic is distributed based on source and destination port numbers.

destination-ip address,  source-ip address

User-configured IRF link load sharing mode. In this sample output, traffic on the IRF port is distributed based on source and destination IP addresses.

destination-mac address, source-mac address

User-configured IRF link load sharing criteria. In this sample output, the criteria are source and destination MAC addresses.

 

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

mdc-admin

mdc-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 disabled.

# Display detailed MAD information.

<Sysname> display mad verbose

Multi-active recovery state: No

Excluded ports(user-configured):

  Vlan-interface999

Excluded ports(system-configured):

  Ten-GigabitEthernet1/3/0/25

  Ten-GigabitEthernet1/3/0/26

  Ten-GigabitEthernet2/3/0/27

  Ten-GigabitEthernet2/3/0/28

MAD ARP disabled.

MAD ND disabled.

MAD LACP enabled interface: Bridge-Aggregation 1

  MAD status                 : Normal

  Member ID       Port                             MAD status

  1                Ten-GigabitEthernet1/3/0/1       Normal

  2                Ten-GigabitEthernet2/3/0/1       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

  2            192.168.1.2/24        1            Normal

Table 7 Command output

Field

Description

MAD ARP disabled.

ARP MAD is not supported in the current software version.

MAD ND disabled.

ND MAD is not supported in the current software version.

MAD LACP enabled.

Status of LACP MAD:

·     enabled.

·     disabled.

MAD BFD disabled.

Status of LACP MAD:

·     enabled.

·     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 physical ports in the fabric except for the IRF physical interfaces and ports configured to not shut down.

·     No—The IRF fabric is not in Recovery state. It is active and can forward traffic.

Excluded ports(user-configured)

Ports manually configured to not shut down when the IRF fabric transits to the Recovery state.

Excluded ports(system-configured)

Ports set to not shut down by default when the IRF fabric transits to the Recovery state.

MAD status

MAD operating status:

·     Normal—The MAD mechanism is operating correctly.

·     Faulty—The MAD mechanism is not operating correctly. Check the interface or port for connectivity or configuration problems. For example, you can check whether all member devices have member ports used for LACP MAD.

·     N/A—MAD link status cannot be detected. This field always displays N/A if BFD MAD is enabled on a management Ethernet port.

Member ID

IRF member ID of the local device.

Port

Member ports of the aggregate interface used for LACP MAD.

Neighbor

IRF member ID of the neighbor member device.

 

irf auto-merge enable

Use irf auto-merge enable to enable IRF auto-merge. This feature enables an IRF fabric to automatically reboot its member devices if it fails in the master election during an IRF fabric merge.

Use undo irf auto-merge enable to disable IRF auto-merge.

Syntax

irf auto-merge enable

undo irf auto-merge enable

Default

IRF auto-merge is enabled.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

For a successful merge, make sure IRF auto-merge is enabled on both IRF fabrics that are merging.

This command is available in IRF mode. When you change the operating mode from IRF to standalone, the setting for this command is lost, regardless of whether you have saved the configuration. To disable IRF auto-merge after you change the operating mode from standalone to IRF, use the undo form of this command.

IRF auto-merge takes effect on merges caused by any of the following events:

·     The IRF link recovers from a link failure.

·     The IRF physical interfaces of the member devices are connected after the interfaces are bound to IRF ports.

The feature does not take effect on a merge that occurs in the following conditions:

·     You bind a physical interface to an IRF port.

·     The interface has been connected to the peer IRF physical interface before the binding operation.

If the IRF auto-merge feature does not take effect, you must save the running configuration, and then follow the system instructions to manually reboot one or multiple member devices.

Examples

# Enable IRF auto-merge.

<Sysname> system-view

[Sysname] irf auto-merge enable

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

mdc-admin

Usage guidelines

This command is available in IRF mode. When you change the operating mode from IRF to standalone, the setting for this command is lost, regardless of whether you have saved the configuration. To disable software auto-update after you change the operating mode from standalone to IRF, use the undo form of this command.

This command automatically propagates the current software images of the master MPU in the IRF fabric to any MPUs you are adding to the IRF fabric.

To ensure a successful software update, verify that the new MPU you are adding to the IRF fabric has sufficient storage space for the new software images. If sufficient storage space is not available, the MPU automatically deletes the current software images. If the reclaimed space is still insufficient, the MPU cannot complete the auto-update. You must reboot the device that holds the MPU, and then access the BootWare menus to delete files.

You must manually update the new MPU with the software images running on the IRF fabric in the following situations:

·     Software auto-update is disabled.

·     Software auto-update fails to update software. This situation might occur if the IRF fabric cannot identify the software version used on the new MPU.

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 an IRF fabric.

Use undo irf domain to restore the default IRF domain setting.

Syntax

irf domain domain-id

undo irf domain

Default

IRF domain ID is 0.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

domain-id: Specifies a domain ID for the IRF fabric. The value range is 0 to 4294967295.

Usage guidelines

This command is available in IRF mode. When you change the operating mode from IRF to standalone, the IRF domain setting is lost, regardless of whether you have saved the configuration.

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 LACP MAD or BFD 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 irf domain or mad enable command. The IRF domain IDs configured by using these commands overwrite each other.

In an MDC environment, the irf domain command is available only on the default MDC. The mad enable command is available on all MDCs. If you change the IRF domain ID in one MDC, the IRF domain IDs in all other MDCs change automatically.

Examples

# Set the IRF domain ID to 30.

<Sysname> system-view

[Sysname] irf domain 30

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

Default

The IRF link down event report delay is 4000 milliseconds (4 seconds).

Views

System view

Predefined user roles

network-admin

mdc-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

This command is available in IRF mode. When you change the operating mode from IRF to standalone, the command configuration is lost, regardless of whether you have saved the configuration.

As a best practice, set the delay to 0 seconds in the following situations:

·     The IRF fabric requires a quick master/subordinate or IRF link switchover.

·     The BFD or GR feature is used.

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 configure 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.

Usage guidelines

CAUTION

CAUTION:

IRF bridge MAC address change causes transient traffic disruption.

 

This command is available in IRF mode and in Release 1138P01 and later versions.

When you change the operating mode from IRF to standalone, the IRF bridge MAC address configuration is lost, regardless of whether you have saved the configuration.

On a switched LAN, the IRF bridge MAC address must be unique.

When IRF fabrics merge, IRF ignores the configured IRF bridge MAC address and only checks the bridge MAC address of each member device in the IRF fabrics. IRF merge fails if any of the 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 whose master has the higher priority as the IRF bridge MAC address.

If an IRF fabric splits after you configure the IRF bridge MAC address, both the split IRF fabrics use the configured bridge MAC address 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 always

Use irf mac-address persistent always to enable the IRF fabric to retain the IRF bridge MAC address after the address owner leaves.

Use undo irf mac-address persistent to enable the IRF fabric to change its bridge MAC address as soon as the address owner leaves.

Syntax

irf mac-address persistent always

undo irf mac-address persistent

Default

Bridge MAC address of the IRF fabric does not change after the address owner leaves.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

This command is available in IRF mode. When you change the operating mode from IRF to standalone, the bridge MAC persistence setting is lost, regardless of whether you have saved the configuration.

This command does not take effect if the IRF bridge MAC address is configured by using the irf mac-address mac-address command.

Depending on the network condition, enable the IRF fabric to retain or change its bridge MAC address after the address owner leaves.

On a switched LAN, the bridge MAC address must be unique for correct traffic transmission.

IRF fabrics cannot merge if they contain member devices that have the same bridge MAC address.

Examples

# Enable the IRF bridge MAC address to be permanent.

<Sysname> system-view

[Sysname] irf mac-address persistent always

irf member

Use irf member to assign a member ID to the device in standalone mode.

Use undo irf member to restore the default.

Syntax

irf member member-id

undo irf member

Default

The device operates in standalone mode and does not have a member ID.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

member-id: Assigns an IRF member ID to the device. The value range for this argument is 1 to 4. However, the assigned IRF member ID must be 1 or 2. If you use 3 or 4, the S12500-X or S12500X-AF IRF fabric cannot be set up.

Usage guidelines

You must assign an IRF member ID to a device before enabling IRF mode. The member ID takes effect after IRF mode is enabled. This member ID must be unique among all IRF member devices.

To change the member ID of a device in IRF mode, use the irf member member-id renumber new-member-id command. The new member ID takes effect at reboot.

Examples

# (In standalone mode.) Assign member ID 2 to the device.

<Sysname> system-view

[Sysname] irf member 2

 Info: Member ID change will take effect after the member reboots and operates in IRF mode.

Related commands

irf member renumber

irf member description

Use irf member description to configure a description for an IRF member.

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 any IRF member.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

member-id: Specifies the ID of an IRF member. The IRF member ID can only be 1 or 2.

text: Configures the IRF member description, a string of 1 to 127 characters.

Usage guidelines

You can configure a description to describe the location or purpose of a member device.

This command is available in IRF mode. When you change the operating mode from IRF to standalone, the IRF member description is lost, regardless of whether you have saved the configuration.

Examples

# Configure a description for IRF member 1.

<Sysname> system-view

[Sysname] irf member 1 description F1Num001

irf member priority

Use irf member priority to change the priority of an IRF member.

Use undo irf member priority to restore the default.

Syntax

irf member member-id priority priority

undo irf member member-id priority

Default

IRF member priority is 1.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

member-id: Specifies an IRF member ID. The IRF member ID can only be 1 or 2.

priority: Sets 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.

Usage guidelines

Change member priority assignment to affect the maser election result.

This command is available in IRF mode. The new priority setting takes effect at the next master election, but it does not trigger a master election.

To assign an IRF priority to a device in standalone mode, use the irf priority command.

Examples

# (In IRF mode.) Set the priority of IRF member 2 to 32.

<Sysname> system-view

[Sysname] irf member 2 priority 32

Related commands

irf priority

irf member renumber

Use irf member renumber to change the member ID of a device in the IRF fabric.

Use undo irf member renumber to restore the previous IRF member ID of the device.

Syntax

irf member member-id renumber new-member-id

undo irf member member-id renumber

Default

In standalone mode, the device does not have a member ID.

In IRF mode, the device uses the member ID that is set by using the irf member command.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

member-id: Specifies the current ID of an IRF member device. The ID can only be 1 or 2.

new-member-id: Assigns a new ID to the IRF member device. The value range for this argument is 1 to 4. However, the assigned IRF member ID must be 1 or 2. If you use 3 or 4, the S12500-X or S12500X-AF IRF fabric cannot be set up.

Usage guidelines

CAUTION:

In IRF mode, an IRF member ID change can invalidate member ID-related settings, including interface and file path settings, and cause data loss. Make sure you fully understand its impact on your live network.

 

The new IRF member ID, including the one set by using the undo irf member renumber command, takes effect after you reboot the member device.

To cancel the change before you reboot the member device, use the undo irf member renumber command. In the command, set the new member ID to be the same as the old member ID.

To set the member ID of a device in standalone mode, use the irf member command.

Examples

# (In IRF mode.) Change the member ID of an IRF member from 1 to 2.

<Sysname> system-view

[Sysname] irf member 1 renumber 2

Warning: Renumbering the member ID may result in configuration change or loss. Continue?[Y/N]y

# (In IRF mode.) Before rebooting the device, cancel the change in the preceding example.

[Sysname] undo irf member 1 renumber

Warning: Renumbering the member ID may result in configuration change or loss. Continue?[Y/N]y

If you reboot the device after executing the irf member 1 renumber 2 command, the device member ID changes to 2 at system reboot. Using undo irf member 1 renumber cannot restore the member ID to 1.

Related commands

irf member

irf priority

Use irf priority to assign an IRF member priority to a device in standalone mode.

Use undo irf priority to restore the default.

Syntax

irf priority priority

undo irf priority

Default

IRF member priority is 1.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

priority: Specifies an IRF member priority value in the range of 1 to 32.

Usage guidelines

Member priority is used for role election. The greater the priority value, the higher the priority. A member with higher priority is more likely to be the master.

The member priority configured in standalone mode takes effect after you enable IRF mode.

To change the member priority of a device in IRF mode, use the irf member member-id priority priority command. The new priority setting takes effect at the next master election, but it does not trigger a master election.

Examples

# (In standalone mode.) Assign IRF member priority 32 to the device.

[Sysname] system-view

[Sysname] irf priority 32

Related commands

irf member priority

irf-port global load-sharing mode

Use irf-port global load-sharing mode to set the global load sharing mode for IRF links.

Use undo irf-port global load-sharing mode to restore the default.

Syntax

irf-port global load-sharing mode { destination-ip | destination-mac | ingress-port | source-ip | source-mac } *

undo irf-port global load-sharing mode

Default

The following are criteria for distributing different types of packets across IRF links:

·     TCP/UDP packets—Source and destination TCP/UDP port numbers.

·     Non-TCP/-UDP IP packets—Source and destination IP addresses.

·     Non-IP packets (packets without an IP header)—Source and destination MAC addresses.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

destination-ip: Distributes traffic across IRF member links based on destination IP address.

destination-mac: Distributes packets across IRF member links based on destination MAC address.

ingress-port: Distributes packets across IRF member links based on incoming port.

source-ip: Distributes packets across IRF member links based on source IP address.

source-mac: Distributes packets across IRF member links based on source MAC address.

Usage guidelines

The global IRF link load sharing mode applies to all IRF ports in the IRF fabric. You can configure the sharing mode to include a combination of multiple criteria for making traffic distribution decisions. For example, criteria could include source MAC address and IP address. The device displays an error message if it does not support a criterion combination.

If you configure the global load sharing mode multiple times, the most recent configuration takes effect.

You can also configure a port-specific load sharing mode for an IRF port in IRF port view.

An IRF port preferentially uses the port-specific load sharing mode. If no port-specific load sharing mode is available, the port uses the global load sharing mode.

Examples

# Configure the global IRF link load sharing mode to distribute traffic based on destination MAC address.

<Sysname> system-view

[Sysname] irf-port global load-sharing mode destination-mac

irf-port load-sharing mode

Use irf-port load-sharing mode to configure a port-specific load sharing mode for an IRF port.

Use undo irf-port load-sharing mode to restore the default.

Syntax

irf-port load-sharing mode { destination-ip | destination-mac | ingress-port | source-ip | source-mac } *

undo irf-port load-sharing mode

Default

The global IRF link load sharing mode applies.

Views

IRF port view

Predefined user roles

network-admin

mdc-admin

Parameters

destination-ip: Distributes traffic across IRF member links based on destination IP address.

destination-mac: Distributes packets across IRF member links based on destination MAC address.

ingress-port: Distributes packets across IRF member links based on incoming port.

source-ip: Distributes packets across IRF member links based on source IP address.

source-mac: Distributes packets across IRF member links based on source MAC address.

Usage guidelines

To configure a port-specific load sharing mode successfully for an IRF port, make sure you have bound a minimum of one physical interface to the IRF port.

You can configure an IRF port-specific load sharing mode to include a combination of multiple criteria for making traffic distribution decisions. For example, criteria could include source MAC address and IP address. The device displays an error message if it does not support a criterion combination.

If you configure the port-specific load sharing mode multiple times on an IRF port, the most recent configuration takes effect.

An IRF port preferentially uses the port-specific load sharing mode. If no port-specific load sharing mode is available, the port uses the global load sharing mode.

Examples

# Configure a port-specific load sharing mode for IRF-port 1/1 to distribute traffic based on destination MAC address.

<Sysname> system-view

[Sysname] irf-port 1/1

[Sysname-irf-port1/1] irf-port load-sharing mode destination-mac

irf-port member-id/port-number

Use irf-port member-id/port-number to enter IRF port view in IRF mode.

Use undo irf-port member-id/port-number to removing all port bindings on an IRF port in IRF mode.

Syntax

irf-port member-id/port-number

undo irf-port member-id/port-number

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

member-id/port-number: Specifies an IRF port on an IRF member. The member-id argument represents the ID of the IRF member. The port-number argument represents the IRF port index and must be 1 or 2.

Usage guidelines

To bind physical interfaces to IRF ports for IRF links, you must enter IRF port view.

Before you remove all port bindings on an IRF port, shut down all its physical interfaces.

Examples

# (In IRF mode.) Enter the view of IRF-port 1 on member 1.

<Sysname> system-view

[Sysname] irf-port 1/1

[Sysname-irf-port1/1]

Related commands

port group interface

irf-port port-number

Use irf-port port-number to enter IRF port view in standalone mode.

Use undo irf-port port-number to remove all port bindings on an IRF port in standalone mode.

Syntax

irf-port port-number

undo irf-port port-number

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

port-number: Specifies an IRF port number, which must be 1 or 2.

Usage guidelines

To bind physical interfaces to IRF ports for IRF links, you must enter IRF port view.

Before you remove all port bindings on an IRF port, shut down all its physical interfaces.

Examples

# (In standalone mode.) Enter IRF-port 1 view.

<Sysname> system-view

[Sysname] irf-port 1

[Sysname-irf-port1]

Related commands

port group interface

irf-port-configuration active

Use irf-port-configuration active to activate IRF port settings.

Syntax

irf-port-configuration active

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

After you connect the physical interfaces between two devices and bind them to the correct IRF ports, you must use this command to activate the settings on the IRF ports. This command merges the two devices into one IRF fabric.

The system activates the IRF port settings automatically in the following situations:

·     The configuration file that the device starts with contains IRF port bindings.

·     You are binding physical interfaces to an IRF port in up state.

Examples

To configure and activate IRF-port 1/2:

# Bind FortyGigE 1/1/0/2 to IRF-port 1/2.

<Sysname> system-view

[Sysname] interface fortygige 1/1/0/2

[Sysname-FortyGigE1/1/0/2] shutdown

[Sysname-FortyGigE1/1/0/2] quit

[Sysname] irf-port 1/2

[Sysname-irf-port1/2] port group interface fortygige 1/1/0/2

 Info : You are recommended to save the configuration now; otherwise, it will be lost after system reboot.

[Sysname-irf-port1/2] quit

[Sysname] interface fortygige 1/1/0/2

[Sysname-FortyGigE1/1/0/2] undo shutdown

[Sysname-FortyGigE1/1/0/2] quit

# Save the configuration so the IRF port settings can take effect after the device reboots.

[Sysname] save

The current configuration will be written to the device. Are you sure? [Y/N]:y

Please input the file name(*.cfg)[flash:/startup.cfg]

(To leave the existing filename unchanged, press the enter key):

flash:/startup.cfg exists, overwrite? [Y/N]:y

 Validating file. Please wait............................

 Saved the current configuration to mainboard device successfully.

Chassis 1 Slot 17:

 Save next configuration file successfully.

 Configuration is saved to device successfully.

# Activate the IRF port settings.

[Sysname] irf-port-configuration active

mad bfd enable

Use mad bfd enable to enable BFD MAD.

Use undo mad bfd enable to disable BFD MAD.

Syntax

mad bfd enable

undo mad bfd enable

Default

BFD MAD is disabled.

Views

Management Ethernet interface view, VLAN interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

This command is available in management Ethernet interface view in Release 1138P01 and later versions.

BFD MAD uses the BFD protocol to detect multi-active collisions. This MAD mechanism can work with or without intermediate devices.

You cannot use BFD MAD with LACP MAD.

If one IRF fabric uses another IRF fabric as the intermediate device for BFD MAD, you must assign the two IRF fabrics different domain IDs for correct split detection. False detection causes IRF split.

When you configure BFD MAD that uses common Ethernet ports, follow these restrictions and guidelines:

 

Category

Restrictions and guidelines

BFD MAD VLAN

·     Do not enable BFD MAD on VLAN-interface 1.

·     If you are using an intermediate device, perform the following tasks on both the IRF fabric and the intermediate device:

¡     Create a VLAN and VLAN interface for BFD MAD.

¡     Assign the ports of BFD MAD links to the BFD MAD VLAN.

·     Make sure the IRF fabrics on the network must use different BFD MAD VLANs.

BFD MAD VLAN and feature compatibility

·     Do not use the BFD MAD VLAN for any purpose other than configuring BFD MAD. Layer 2 or Layer 3 features, including ARP and LACP, cannot work on the BFD MAD-enabled VLAN interface or any port in the VLAN. If you configure any other feature on the VLAN, neither the configured feature nor the BFD MAD feature will work correctly.

·     Disable the spanning tree feature on any Layer 2 Ethernet ports in the BFD MAD VLAN. The MAD feature is mutually exclusive with the spanning tree feature.

MAD IP address

·     To avoid problems, only use the mad ip address command to configure IP addresses on the BFD MAD-enabled VLAN interface. Do not configure an IP address with the ip address command or configure a VRRP virtual address on the BFD MAD-enabled VLAN interface.

·     Make sure all the MAD IP addresses are on the same subnet.

·     The MAD IP addresses must not be the same as any IP addresses assigned to interfaces or VRRP groups in the IRF fabric.

 

When you configure BFD MAD that uses management Ethernet ports, follow these restrictions and guidelines:

 

Category

Restrictions and guidelines

Ports on the intermediate device for BFD MAD

Use common Ethernet ports on the intermediate device to connect the management Ethernet ports on the IRF fabric.

BFD MAD VLAN

·     On the intermediate device, create a VLAN for BFD MAD, and assign the ports used for BFD MAD to the VLAN. On the IRF fabric, you do not need to assign the management Ethernet ports to the VLAN.

·     Make sure the IRF fabrics on the network use different BFD MAD VLANs.

MAD IP address

·     To avoid problems, only use the mad ip address command to configure IP addresses on the BFD MAD-enabled management Ethernet port. Do not configure an IP address with the ip address command or configure a VRRP virtual address on the BFD MAD-enabled management Ethernet port.

·     Make sure all the MAD IP addresses are on the same subnet.

·     The MAD IP addresses must not be the same as any IP addresses assigned to interfaces or VRRP groups in the IRF fabric.

 

Examples

# Enable BFD MAD on VLAN-interface 3.

<Sysname> system-view

[Sysname] interface vlan-interface 3

[Sysname-Vlan-interface3] mad bfd enable

mad enable

Use mad enable to enable LACP MAD.

Use undo mad enable to disable LACP MAD.

Syntax

mad enable

undo mad enable

Default

LACP MAD is disabled.

Views

Aggregate interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

LACP MAD uses extended LACP packets to detect multi-active collisions. This MAD mechanism requires an intermediate H3C device that supports extended LACPDUs.

LACP MAD handles collisions differently than BFD MAD. To avoid conflicts, do not use LACP MAD together with BFD MAD.

You must set up a dynamic link aggregation group that spans all IRF member devices between the IRF fabric and the intermediate device. To enable dynamic link aggregation, configure the link-aggregation mode dynamic command on the aggregate interface.

If one IRF fabric uses another IRF fabric as the intermediate device for LACP MAD, you must assign the two IRF fabrics different domain IDs for correct split detection. False detection causes IRF split.

When you use the mad enable command, the system prompts you to enter a domain ID. If you do not want to change the current domain ID, press Enter at the prompt.

 

 

NOTE:

·     An IRF fabric has only one IRF domain ID. You can change the IRF domain ID by using the irf domain or mad enable command. The IRF domain IDs configured by using these commands overwrite each other.

·     You can execute the mad enable command on any MDCs. If you change the IRF domain ID in one MDC, the new IRF domain ID takes effect immediately on all MDCs.

 

Examples

# Enable LACP MAD on Bridge-Aggregation 1, a Layer 2 dynamic aggregate interface.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] mad enable

 You need to assign a domain ID (range: 0-4294967295)

 [Current domain is: 0]: 1

 The assigned  domain ID is: 1

MAD LACP only enable on dynamic aggregation interface.

mad exclude interface

Use mad exclude interface to exclude a physical network port from being shut down when the IRF fabric transits to the Recovery state upon detection of a multi-active collision.

Use undo mad exclude interface to restore the default MAD action on a physical network port.

Syntax

mad exclude interface interface-type interface-number

undo mad exclude interface interface-type interface-number

Default

All physical network ports but the IRF physical interfaces and console port shut down when the IRF fabric transits to the Recovery state.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

interface-type interface-number: Specifies a port by its type and number.

Usage guidelines

MAD shuts down all physical ports on the Recovery-state IRF fabric except the IRF physical interfaces and the ports manually configured to not shut down.

If a port must be kept in up state for special purposes such as Telnet connection, exclude the port from the shutdown action. As a best practice to avoid incorrect traffic forwarding, do not exclude any ports except for the ports used for Telnet and MAD.

The ports that have shut down by MAD come up when the member devices reboot to join the recovered IRF fabric. If auto recovery fails because the current master fails or any other exception occurs, use the mad restore command to manually recover the member devices and bring up the ports.

 Examples

# Exclude FortyGigE 2/0/5/1 from being shut down when the MAD status transits to Recovery.

<Sysname> system-view

[Sysname] mad exclude interface fortygige 2/0/5/1

mad ip address

Use mad ip address to assign a MAD IP address to an IRF member device for BFD MAD.

Use undo mad ip address to delete the MAD IP address for an IRF member device.

Syntax

mad ip address ip-address { mask | mask-length } member member-id

undo mad ip address ip-address { mask | mask-length } member member-id

Default

No MAD IP address is configured for an IRF member device.

Views

Management Ethernet interface view, VLAN interface view

Predefined user roles

network-admin

mdc-admin

Parameters

ip-address: Specifies an IP address in dotted decimal notation. This IP address is bound to an IRF member for BFD detection and is called a MAD IP address.

mask: Specifies a subnet mask in dotted decimal notation.

mask-length: Specifies a subnet mask in length, in the range of 0 to 32.

member member-id: Specifies an IRF member ID.

Usage guidelines

This command is available in management Ethernet interface view in Release 1138P01 and later versions.

To use BFD MAD, configure a MAD IP address for each IRF member. Make sure all the MAD IP addresses are on the same subnet.

To avoid problems, only use the mad ip address command to configure MAD IP addresses. Do not configure an IP address with the ip address command or configure a VRRP virtual address on the BFD MAD-enabled port or interface.

The master attempts to establish BFD sessions with other members by using its MAD IP address as the source IP address.

·     When the IRF fabric is integrated, only the MAD IP address of the master takes effect. The master cannot establish a BFD session with any other member. If you execute the display bfd session command, the state of the BFD sessions is Down.

·     When the IRF fabric splits, the IP addresses of the masters in the partitioned IRF fabrics take effect. The masters can establish a BFD session. If you execute the display bfd session command, the state of the BFD session between the two devices is Up.

Examples

# Assign a MAD IP address to IRF member 1 on VLAN-interface 3.

<Sysname> system-view

[Sysname] interface vlan-interface 3

[Sysname-Vlan-interface3] mad ip address 192.168.0.1 255.255.255.0 member 1

# Assign a MAD IP address to IRF member 2 on VLAN-interface 3.

[Sysname-Vlan-interface3] mad ip address 192.168.0.2 255.255.255.0 member 2

Related commands

mad bfd enable

mad restore

Use mad restore to restore the normal MAD state of the IRF fabric in Recovery state.

Syntax

mad restore

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

If the active IRF fabric has failed to work before the IRF split problem is fixed, use this command to restore an IRF fabric in Recovery state. The recovered IRF fabric will take over the active IRF fabric role.

Examples

# Restore the normal MAD state of the IRF fabric in Recovery state.

<Sysname> system-view

[Sysname] mad restore

   This command will restore the device from multi-active conflict state. Continue? [Y/N]:Y

Restoring from multi-active conflict state, please wait...

port group interface

Use port group interface to bind a physical interface to an IRF port.

Use undo port group interface to remove the binding of a physical interface and an IRF port.

Syntax

port group [ mdc mdc-id ] interface interface-type interface-number [ mode enhanced ]

undo port group [ mdc mdc-id ] interface interface-name

Default

No physical interfaces are bound to any IRF port.

Views

IRF port view

Predefined user roles

network-admin

mdc-admin

Parameters

mdc mdc-id: Specifies an MDC by its ID. The MDC must already exist on the device. If the candidate IRF physical interface is on a non-default MDC, you must specify the MDC. If the candidate IRF physical interface is on the default MDC, you do not need to specify the MDC.

interface-type interface-number: Specifies a physical interface by its type and number.

interface-name: Specifies a physical interface in the interface-typeinterface-number format. No space is allowed between the interface-type and interface-number arguments.

mode enhanced: Specifies the enhanced binding mode for the physical interface. An IRF physical interface operates in enhanced mode regardless of whether you have specified these keywords.

Usage guidelines

The MDC settings might lose effect after the device reboots to join an IRF fabric. As a best practice, create an MDC and bind its physical interfaces to an IRF port after the IRF fabric is formed. For more information about MDCs, see Fundamentals Configuration Guide.

In IRF mode, use the shutdown command to shut down a physical interface before you bind it to or remove it from an IRF port. To bring up the physical interface after a binding or binding removal operation, use the undo shutdown command.

In standalone mode, the shutdown and undo shutdown operations are not required.

Repeat the port group interface command to bind a maximum of eight physical interfaces to an IRF port for link redundancy.

The binding mode takes effect only after the IRF binding takes effect.

The system does not dynamically remove the binding between a physical interface and an IRF port even if the IRF link has been lost. For example, this situation occurs when the interface card holding the physical interface is removed. To remove the binding, use the undo port group interface command.

For more information about the IRF physical interface binding requirements, see IRF Configuration Guide.

Examples

# (In standalone mode.) Bind FortyGigE 1/0/1 to IRF-port 1.

<Sysname> system-view

[Sysname] irf-port 1

[Sysname-irf-port1] port group interface FortyGigE 1/0/1

# (In IRF mode.) Bind FortyGigE 1/1/0/1 to IRF-port 1 of member 1.

<Sysname> system-view

[Sysname] interface fortygige 1/1/0/1

[Sysname-FortyGigE1/1/0/1] shutdown

[Sysname-FortyGigE1/1/0/1] quit

[Sysname] irf-port 1/1

[Sysname-irf-port1/1] port group interface fortygige 1/1/0/1

[Sysname-irf-port1/1] quit

[Sysname] interface fortygige 1/1/0/1

[Sysname-FortyGigE1/1/0/1] undo shutdown

[Sysname-FortyGigE1/1/0/1] quit

Related commands

irf-port


Index

C D I M P


C

chassis convert mode irf,1

D

display irf,2

display irf configuration,3

display irf link,4

display irf topology,5

display irf-port load-sharing mode,6

display mad,8

I

irf auto-merge enable,10

irf auto-update enable,11

irf domain,12

irf link-delay,13

irf mac-address,13

irf mac-address persistent always,14

irf member,15

irf member description,16

irf member priority,16

irf member renumber,17

irf priority,18

irf-port global load-sharing mode,19

irf-port load-sharing mode,20

irf-port member-id/port-number,21

irf-port port-number,21

irf-port-configuration active,22

M

mad bfd enable,23

mad enable,25

mad exclude interface,26

mad ip address,26

mad restore,27

P

port group interface,28


 

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网