Failover group commands -- bind

Use bind to assign a node to a failover group.

Use undo bind to remove a node from a failover group.

Syntax

Distributed devices in standalone mode:

bind slot slot-number cpu cpu-number { primary | secondary }

undo bind slot slot-number cpu cpu-number

Distributed devices in IRF mode:

bind chassis chassis-number slot slot-number cpu cpu-number { primary | secondary }

undo bind chassis chassis-number slot slot-number cpu cpu-number

Default

A failover group has no nodes.

Views

Failover group view

Predefined user roles

network-admin

mdc-admin

Parameters

slot slot-number: Specifies a card by its slot number. (Distributed devices in standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (Distributed devices in IRF mode.)

cpu cpu-number: Specifies a CPU by its number.

primary: Configures a node as the primary node.

secondary: Configures a node as the secondary node.

Usage guidelines

Each failover group contains a maximum of two nodes. One is the primary node, and the other is the secondary node. The primary node processes services and backs up service data to the secondary node. When the primary node fails, the secondary node takes over to avoid service interruption.

As a best practice, assign two nodes of similar performance on different cards to a failover group to ensure service continuity after a node switchover.

The primary node and the secondary node in a failover group cannot be the same node. Different failover groups cannot share the same primary node.

You can assign only existing nodes to a failover group. For a node that has been uninstalled from the device, you must also use the undo bind command to remove it from the failover group.

Examples

# (Distributed devices in IRF mode.) Configure the CPU on the card in the specified slot as the primary node in failover group group1.

<Sysname> system-view

[Sysname] failover group group1

[Sysname-failover-group-group1] bind chassis 1 slot 4 cpu 1 primary

Failover group commands -- display failover group

Use display failover group to display failover group information.

Syntax

display failover group [ group-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

group-name: Specifies a failover group by its name, a case-sensitive string of 1 to 63 characters. If you do not specify a failover group, this command displays information about all failover groups.

Examples

# (Distributed devices in IRF mode.) Display failover group information.

<Sysname> display failover group

Stateful failover group information:

Name Primary Secondary Active Status

group1 1/4.1 NA Primary

AutoBackup 1/4.1 NA Primary

AutoBackup 1/3.1 NA Initial

Table 1 Command output

Field | Description
ID | ID of the failover group.
Name | Name of the failover group.
Primary | The primary node in the failover group. If no primary node is configured, this field displays NA.
Secondary | The secondary node in the failover group. If no secondary node is configured, this field displays NA.
Active Status | The state of the failover group: · Primary—The primary node is processing services. · Secondary—The secondary node is processing services. · Initial—No node in the failover group is processing services.

‌

Failover group commands -- failover group

Use failover group to create a failover group and enter its view, or enter the view of an existing failover group.

Use undo failover group to delete a failover group.

Syntax

failover group group-name

undo failover group group-name

Default

Automatic failover group AutoBackup exists. No manual failover groups exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies a failover group by its name, a case-sensitive string of 1 to 63 characters.

Usage guidelines

A failover group backs up services (such as NAT) between two CPUs to ensure high availability.

You can execute this command multiple times to create more failover groups.

The automatic failover group AutoBackup cannot be manually created or deleted.

Examples

# Create failover group group1 and enter its view.

<Sysname> system-view

[Sysname] failover group group1

[Sysname-failover-group-group1]