IRF commands -- 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 default for this command varies by device model.

Views

System view

Predefined user roles

network-admin

Usage guidelines

To set up an IRF fabric, place all member devices in IRF mode. In standalone mode, a device cannot join an IRF fabric.

The device automatically reboots for the mode change to take effect. During the reboot, you may choose to have the system automatically convert the startup configuration file. Automatic configuration conversion prevents slot- or interface-related settings from becoming invalid. For example, the system adds member ID information to interface numbers and file paths in IRF mode.

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 after a device is removed from an IRF fabric, restore its standalone mode if the device will not be used in an IRF fabric.

Examples

# Enable IRF mode.

<Sysname> system-view

[Sysname] chassis convert mode irf

The device will reboot to operate in IRF mode. You are recommended to save the running configuration to the next-startup configuration file. Continue? [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...

Configuration is saved to the device successfully.

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

The configuration file is converted successfully.

Now rebooting, please wait...

# Restore standalone mode.

<Sysname> system-view

[Sysname] undo chassis convert mode

The device will reboot to operate in standalone mode. You are recommended to save the running configuration to the next-startup configuration file. Continue? [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.

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

The configuration file is converted successfully.

Now rebooting, please wait...

IRF commands -- display irf

Use display irf to display IRF information.

Syntax

display irf

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

This command is supported only in IRF mode.

Examples

# Display IRF information.

<Sysname> display irf

Member ID Role Priority CPU MAC Description

1 Loading 1 00e0-fcbe-3102 F1Num001

*+2 Master 1 00e0-fcb1-ade2 F1Num002

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

The asterisk (*) indicates the master.

The plus sign (+) indicates the device through which you are logged in.

The right angle bracket (>) indicates the device's stack capability is disabled.

Bridge MAC of the IRF: 00e0-fc00-1000

Auto upgrade : Disabled

MAC persistence : Disabled

Domain ID : 30

Auto merge : Enabled

Table 1 Command output

Field | Description
Member ID | IRF member ID: · A prefix of asterisk sign (*) indicates the master device. · A prefix of plus sign (+) indicates the device where you are logged in. · A prefix of right angle bracket (>) indicates the device that has been temporarily removed from the IRF fabric by using the undo irf member stack enable command.
Role | Role of the member device in the IRF fabric: · Master—Master device. · Standby—Standby device. · Loading—The device is loading software images.
Priority | IRF member priority.
CPU MAC | MAC address of the CPU in the device.
Description | Description you have configured for the member device. · If no description is configured, this field displays a dashed line (---). · If the description exceeds the maximum number of characters that can be displayed, an ellipsis (…) is displayed in place of the exceeding text. To display the complete description, use the display current-configuration command.
Bridge MAC of the IRF | Bridge MAC address of the IRF fabric.
Auto upgrade | Status of the software auto-update feature: · Enabled. · Disabled.
MAC persistence | IRF bridge MAC persistence setting: · 6 min—Bridge MAC address of the IRF fabric remains unchanged for 6 minutes after the address owner leaves. · Always—Bridge MAC address of the IRF fabric does not change after the address owner leaves. · Disabled—Bridge MAC address of the current master replaces the original bridge MAC address as soon as the owner of the original address leaves.
Domain ID | Domain ID of the IRF fabric. The domain ID you assign to an IRF fabric must uniquely identify the IRF fabric in a multi-IRF network.
Auto merge | Status of the auto-merge feature: · Enabled. · Disabled.

IRF commands -- display irf configuration

Use display irf configuration to display IRF settings for each member device in an IRF fabric.

Syntax

display irf configuration

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display IRF settings on all member devices.

<Sysname> display irf configuration

The New ID, Domain, Stack, and Member interfaces fields display settings for the next startup.

Member ID New ID Domain Stack Member interfaces

1 1 0 Enabled Disabled

Table 2 Command output

Field | Description
Member ID | Current IRF member ID of the device.
New ID | IRF member ID assigned to the device. This member ID takes effect at reboot.
Domain | IRF domain ID. The domain ID takes effect at reboot.
Stack | Whether multimember stacking capability is enabled: · Enabled—The device can form an IRF fabric with other member devices. · Disabled—The device cannot form an IRF fabric with other member devices. The device will be removed from the IRF fabric in a maximum of 5 seconds (see "irf member stack enable "). This field is available only when the device is operating in IRF mode.
Member interfaces | Network interfaces bound to the IRF port. This field displays Disabled if no network interfaces have been bound to the IRF port. The channel type of each IRF link is enclosed in brackets. Available channel types include: · ctrl—Control channel. · data—Data channel. · ctrl&data—Hybrid channel.

IRF commands -- display irf forwarding

Use display irf forwarding to display information about the IRF hello packets received on a member device.

Syntax

display irf forwarding [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

slot slot-number: Specifies a member device by its IRF member ID. The member ID is in the range of 0 to 255. If you do not specify a member device, this command displays information about the IRF hello packets received on the master.

Usage guidelines

This command is supported only in IRF mode.

Examples

# Display information about the IRF hello packets received on the master.

<Sysname> display irf forwarding

Member ID CPU MAC Hello timeout (sec)

1 00e0-fc0f-8c02 5

2 00e0-fc0f-8c04 5

# Display information about the IRF hello packets received on member device 2.

<Sysname> display irf forwarding slot 2

Member ID CPU MAC Hello timeout (sec)

2 00e0-fc0f-8c04 5

1 00e0-fc0f-8c02 4

Table 3 Command output

Field | Description
Member ID | IRF member ID of the packet sender.
CPU MAC | CPU MAC address of the packet sender.
Hello timeout (sec) | The remaining amount of time before the hello packet times out, in seconds. If a new hello packet is not received before the existing hello packet expires, the member device determines that the sender has left the IRF fabric. If a new hello packet is received before the existing hello packet expires, the device refreshes the hello timeout time for the sender based on the received packet.

IRF commands -- display irf link

Use display irf link to display IRF link information.

Syntax

display irf link

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

This command is supported only in IRF mode.

Examples

# Display IRF link information.

<Sysname> display irf link

Member ID Member interfaces Status

1 Disabled --

Table 4 Command output

Field | Description
Member ID | IRF member ID.
Member interfaces | Network interfaces bound to the IRF port. This field displays Disabled if no network interfaces have been bound to the IRF port. The channel type of each IRF link is enclosed in brackets. Available channel types include: · ctrl—Control channel. · data—Data channel. · ctrl&data—Hybrid channel.
Status | Link status of the network interface: · Up—The link is up. · Down—The link is down. · ADM—The interface has been manually shut down by using the shutdown command. · Blocked—The link is blocked. In this state, the device cannot join an IRF fabric. For more information about this state, see "irf member stack enable." This field displays two hyphens (--) if no network interfaces are bound to the IRF port.

IRF commands -- irf auto-merge enable

Use irf auto-merge enable to enable IRF auto-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

Usage guidelines

This command is supported only in IRF mode.

IRF fabrics that are merging perform master election. The IRF auto-merge feature enables member devices in the IRF fabric that fails the master election to automatically reboot for completing the IRF merge. If the IRF auto-merge feature is disabled, you must follow the system instructions to manually reboot member devices in the IRF fabric that fails master election.

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

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

· The IRF link recovers from a link failure.

· The IRF network interfaces of the member devices are connected through a Layer 2 network after the interfaces are bound to IRF ports.

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

· You add a network interface to an IRF port.

· The network interface has been connected to the peer member device through a Layer 2 network before you bind it to the IRF port.

When you change the operating mode from IRF to standalone, the IRF auto-merge setting is restored to the default. To disable IRF auto-merge after you change the operating mode from standalone to IRF, use the undo form of this command.

Examples

# Enable IRF auto-merge.

<Sysname> system-view

[Sysname] irf auto-merge enable

IRF commands -- irf auto-update enable

Use irf auto-update enable to enable software auto-update.

Use undo irf auto-update enable to disable software auto-update.

Syntax

irf auto-update enable

undo irf auto-update enable

Default

Software auto-update is enabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

This command is supported only in IRF mode.

This command automatically propagates the current software images of the master in the IRF fabric to member devices you are adding to the IRF fabric.

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

When you change the operating mode from IRF to standalone, the IRF auto-update setting is restored to the default. To disable IRF auto-update after you change the operating mode from standalone to IRF, use the undo form of this command.

Examples

# Enable software auto-update.

<Sysname> system-view

[Sysname] irf auto-update enable

IRF commands -- irf domain

Use irf domain to assign an IRF domain ID to each member device or to an IRF fabric.

Use undo irf domain to restore the default.

Syntax

irf domain domain-id

undo irf domain

Default

In standalone mode, the IRF domain ID is 0.

In IRF mode, the device uses the domain ID that is set in standalone mode.

Views

System view

Predefined user roles

network-admin

Parameters

domain-id: Specifies an IRF domain ID. The value range is 0 to 4294967295.

Usage guidelines

An IRF domain ID uniquely identifies an IRF fabric.

You must assign the same domain ID to devices you are adding to the same IRF fabric.

For the domain ID change to take effect, you must reboot the device.

Examples

# Set the IRF domain ID to 30.

<Sysname> system-view

[Sysname] irf domain 10

The configuration will take effect at the next startup.

IRF commands -- 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 default for this command varies by device model.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Sets a delay interval in the range of 0 to 3000 milliseconds. If you set the interval to 0, link down events are reported without delay.

Usage guidelines

This command is supported only in IRF mode. When you change the operating mode from IRF to standalone, the command setting is restored to the default.

If the CFD or BFD feature is used on the IRF fabric, make sure the delay interval is shorter than the maximum CCM lifetime and BFD session lifetime. For more information about CFD and BFD, see High Availability Configuration Guide.

Examples

# Set the IRF link down report delay to 300 milliseconds.

<Sysname> system-view

[Sysname] irf link-delay 300

IRF commands -- irf mac-address persistent

Use irf mac-address persistent to configure IRF bridge MAC persistence.

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 | timer }

undo irf mac-address persistent

Default

The IRF bridge MAC address remains unchanged for 6 minutes after the address owner leaves the IRF fabric.

Views

System view

Predefined user roles

network-admin

Parameters

always: Enables the IRF bridge MAC address to be permanent. The IRF bridge MAC address does not change after the address owner leaves.

timer: Enables the IRF bridge MAC address to remain unchanged for 6 minutes after the address owner leaves. If the owner rejoins the IRF fabric within the time limit, the IRF bridge MAC address does not change. If the owner does not rejoin within the time limit, the IRF fabric uses the bridge MAC address of the current master as the bridge MAC address.

Usage guidelines

This command is supported only in IRF mode.

If the undo form of this command is configured, bridge MAC address of the current master replaces the original IRF bridge MAC as soon as the original address owner leaves.

If TRILL is used, configure the irf mac-address persistent always command to disable IRF bridge MAC change.

When you change the operating mode from IRF to standalone, the bridge MAC persistence setting is restored to the default.

Examples

# Enable the IRF bridge MAC address to be permanent.

<Sysname> system-view

[Sysname] irf mac-address persistent always

IRF commands -- irf member

Use irf member to assign an IRF 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 IRF member ID is 1.

Views

System view

Predefined user roles

network-admin

Parameters

member-id: Specifies an IRF member ID for the device. The value range for this argument varies by device model.

Usage guidelines

This command is supported only in standalone mode.

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 renumber command.

Examples

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

<Sysname> system-view

[Sysname] irf member 2

Related commands

irf member renumber

IRF commands -- irf member description

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

Use undo irf member description to restore the default.

Syntax

irf member member-id description text

undo irf member member-id description

Default

No description is configured for an IRF member device.

Views

System view

Predefined user roles

network-admin

Parameters

member-id: Specifies a member device by its IRF member ID.

text: Specifies a description, a string of 1 to 127 characters.

Usage guidelines

This command is supported only in IRF mode. When you change the operating mode from IRF to standalone, the command setting is restored to the default.

Examples

# Configure the description as F1Num001 for IRF member 1.

<Sysname> system-view

[Sysname] irf member 1 description F1Num001

IRF commands -- irf member priority

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

Use undo irf member priority to restore the default.

Syntax

irf member member-id priority priority

undo irf member member-id priority

Default

The device uses the IRF member priority that is set in standalone mode. (Mode conversion-capable devices.)

The IRF member priority is 1. (Mode conversion-incapable devices.)

Views

System view

Predefined user roles

network-admin

Parameters

member-id: Specifies a member device by its IRF member ID. The value range for this argument varies by device model.

priority: Sets the member 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

This command is supported only in IRF mode.

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

Examples

# Set the priority of IRF member 2 to 32.

<Sysname> system-view

[Sysname] irf member 2 priority 32

Related commands

irf priority

IRF commands -- irf member renumber

Use irf member renumber to change the IRF member ID of an IRF member device.

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

The device uses the member ID that is set in standalone mode. (Mode conversion-capable devices.)

The IRF member ID is 1. (Mode conversion-incapable devices.)

Views

System view

Predefined user roles

network-admin

Parameters

member-id: Specifies a member device by its IRF member ID.

new-member-id: Assigns a new ID to the IRF member device.

Usage guidelines

| CAUTION: In an IRF fabric, 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.

This command is supported only in IRF mode.

Make sure each member device in the IRF fabric has a unique member ID.

The new IRF member ID takes effect after you reboot the member device.

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

Examples

# Change the member ID of an IRF member device from 1 to 2.

<Sysname> system-view

[Sysname] irf member 1 renumber 2

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

Related commands

irf member

IRF commands -- irf member stack enable

Use irf member stack enable to enable an IRF member device to receive and send IRF control packets.

Use undo irf member stack enable to disable an IRF member device from receiving or sending IRF control packets.

Syntax

irf member member-id stack enable

undo irf member member-id stack enable

Default

An IRF member device receives and sends IRF control packets.

Views

System view

Predefined user roles

network-admin

Parameters

member-id: Specifies a member device by its IRF member ID.

Usage guidelines

This command is supported only in IRF mode.

You can use the undo form of this command to remove a member device from an IRF fabric for troubleshooting or maintenance purposes. The removed member device still operates in IRF mode and runs the original IRF settings. However, it does not send or receive IRF control packets.

After you finish the troubleshooting or maintenance tasks, you can execute this command to add the device back to the IRF fabric without having to reconfigure IRF settings. For this command to take effect, you must save the command setting and reboot the device.

When you change the operating mode from IRF to standalone, the command setting is restored to the default. To disable an IRF member device from receiving or sending IRF control packets after you change the operating mode from standalone to IRF, use the undo form of this command.

Examples

# Remove member device 2 from the IRF fabric.

<Sysname> system-view

[Sysname] undo irf member 2 stack enable

Member 2 will leave from the IRF and cannot form a IRF with any other devices. Continue? [Y/N]: y

Operation succeeded. Please check the configuration on member 2 with the IRF for configuration collisions.

# Add the removed device back to the IRF fabric.

<Sysname> system-view

[Sysname] irf member 2 stack enable

Please save the configuration, and then reboot the device for the configuration to take effect.

IRF commands -- irf priority

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

Use undo irf priority to restore the default.

Syntax

irf priority priority

undo irf priority

Default

The IRF member priority is 1.

Views

System view

Predefined user roles

network-admin

Parameters

priority: Specifies the member 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

This command is supported only in standalone mode.

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

To change the IRF member priority of a device in IRF mode, use the irf member 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 commands -- irf-port

Use irf-port to enter IRF port view.

Syntax

In standalone mode:

irf-port

In IRF mode:

irf-port member-id

Views

System view

Predefined user roles

network-admin

Parameters

member-id: Specifies an IRF member ID.

Usage guidelines

Each member device has only one IRF port. The IRF port ID is the IRF member ID.

You must enter IRF port view to bind links to the IRF port.

Examples

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

<Sysname> system-view

[Sysname] irf-port

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

<Sysname> system-view

[Sysname] irf-port 1

Related commands

port group interface

IRF commands -- 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

Usage guidelines

This command is supported only in IRF mode.

After you bind links to an IRF port, you must execute this command for the bindings to take effect. This command enables two devices to merge 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 links to an IRF port after an IRF fabric is formed.

Examples

# Activate the IRF port settings.

<Sysname> system-view

[Sysname] irf-port-configuration active

IRF commands -- port group interface

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

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

Syntax

port group interface interface-type interface-number [ type { control | data } ]

undo port group interface interface-name

Default

No network interfaces are bound to an IRF port.

Views

IRF port view

Predefined user roles

network-admin

Parameters

interface-type interface-number: Specifies a network interface by its type and number. For information about available network interfaces, see IRF configuration in the virtual technologies configuration guide for the device.

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

type { control | data }: Specifies a channel type for the IRF link. The hybrid channel type applies if you do not specify a channel type. The link can forward both data and control packets.

· control: Sets the link type to control. The link can forward only control packets, such as IRF protocol packets.

· data: Sets the link type to data. The link can forward only data packets.

Usage guidelines

An IRF port must have a minimum of one hybrid channel, or a minimum of one data channel and one control channel. As a best practice, use separate physical links as data and control channels to prevent control traffic from being delayed when a large amount of data traffic is present. The maximum number of these channels varies by device model.

To change the channel type of an IRF link, you must first remove the binding, and then rebind the link.

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

The system does not dynamically remove IRF port bindings when IRF links are lost. To remove IRF port bindings, you must use the undo port group interface command.

When you use network interfaces that are grouped in hardware for IRF connection, follow these restrictions and guidelines:

· You must use all or none of the network interfaces in a group for IRF connection.

· You must shut down all network interfaces in a group before you can assign or remove any of the interfaces to or from the IRF port. To bring up the interfaces after the assignment or removal is complete, execute the undo shutdown command.

· To shut down or bring up any network interfaces in a group, you must make sure all the interfaces in the group have been assigned to or removed from the IRF port.

Examples

# (In standalone mode.) Bind GigabitEthernet 2/0/1 as a hybrid channel to IRF-port 2 on IRF member 2.

<Sysname> system-view

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] shutdown

[Sysname-GigabitEthernet2/0/1] quit

[Sysname] irf-port 2

[Sysname-irf-port2] port group interface gigabitethernet 2/0/1

[Sysname-irf-port2] quit

[Sysname] interface gigabitethernet 2/0/1

[Sysname-GigabitEthernet2/0/1] undo shutdown

Related commands

irf-port