- Table of Contents
-
- 14-High Availability Command Reference
- 00-Preface
- 01-Ethernet OAM commands
- 02-CFD commands
- 03-DLDP commands
- 04-Monitor Link commands
- 05-S-Trunk commands
- 06-Error code detection commands
- 07-VRRP commands
- 08-VSRP commands
- 09-Failover group commands
- 10-Service instance group commands
- 11-BFD commands
- 12-Track commands
- 13-Process placement commands
- Related Documents
-
Title | Size | Download |
---|---|---|
09-Failover group commands | 88.79 KB |
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
In standalone mode:
bind slot slot-number cpu cpu-number { primary | secondary | vrrp }
undo bind slot slot-number cpu cpu-number
In IRF mode:
bind chassis chassis-number slot slot-number cpu cpu-number { primary | secondary | vrrp }
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
Parameters
slot slot-number: Specifies a card by its slot number. (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. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
primary: Configures a node as the primary node. This keyword is applicable to intra-system service backup.
secondary: Configures a node as the secondary node. This keyword is applicable to intra-system service backup.
vrrp: Configures the status of a node to be determined by a VRRP group. This keyword is applicable to inter-system service backup.
Usage guidelines
Each failover group contains a maximum of two nodes.
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.
Different failover groups cannot share the same primary node. The primary node and the secondary node in a failover group cannot be the same node, and they cannot be different CPUs on the same card.
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
# (In standalone 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 slot 4 cpu 1 primary
# (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
bind-vrrp
Use bind vrrp to bind a failover group to a VRRP group.
Use undo bind vrrp to unbind a failover group from a VRRP group.
Syntax
bind-vrrp virtual-router-id interface interface-type interface-number
undo bind-vrrp
Default
A failover group is not bound to any VRRP group.
Views
Failover group view
Predefined user roles
network-admin
Parameters
virtual-router-id: Specifies a VRRP group by its virtual router ID in the range of 1 to 255.
interface interface-type interface-number: Specifies an interface by its type and number. The VRRP group is created on the interface.
Usage guidelines
To back up services for nodes on two independent systems, configure inter-system service backup by binding the failover group to a VRRP group. VRRP determines the status of the nodes in the failover group and backs up services from the node on the master to the node on the backup.
You cannot bind a failover group to a VRRP group if the following conditions exist:
· The failover group is associated with a service instance group.
· The service instance group is used by a NAT instance configured with load sharing or bound to a static address pool.
Examples
# Bind failover group group1 to VRRP group 1 created on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] failover group Group1
[Sysname-failover-group-Group1] bind-vrrp 1 interface ten-gigabitethernet 3/1/1
display failover
Use display failover to display failover group information.
Syntax
display failover { group [ group-name ] | group-name group-name }
Views
Any view
Predefined user roles
network-admin
network-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. (Devices that do not support inter-system service backup.)
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 brief information about all failover groups. If you specify a failover group used for inter-system service backup, this command displays detailed information about the specified failover group. If you specify a failover group used for intra-system service backup, this command displays brief information about the specified failover group. (Devices that support inter-system service backup.)
Usage guidelines
You can use either the display failover group [ group-name ] or display failover group-name group-name command to display failover group information. The commands have the same output. To display information about a failover group named >, >>, or |, use the display failover group-name group-name command.
Examples
# (In IRF mode.) Display information about all failover groups. (Devices that do not support inter-system service backup.)
<Sysname> display failover group
Stateful failover group information:
Name Primary Secondary Active Status
group1 1/4.1 NA Primary
AutoBackupf0000829 1/5.1 NA Initial
AutoBackupf0000819 1/3.1 NA Initial
AutoBackupf0000821 1/4.1 NA Primary
Table 1 Command output
Field |
Description |
Name |
Name of the failover group. The name of an automatic failover group contains the string AutoBackup. |
Primary |
The primary node in the failover group. The format of this field is chassis-number/slot-number.CPU-number. The chassis-number segment represents the member ID of the IRF member device. The slot-number segment represents the slot number of the card. The CPU-number segment represents the CPU number. If the card has only one CPU, the CPU number is not displayed. (For devices with multiple CPUs.) The format of this field is chassis-number/slot-number. The chassis-number segment represents the member ID of the IRF member device. The slot-number segment represents the slot number of the card. (For devices with one CPU.) If no primary node is configured, this field displays NA. |
Secondary |
The secondary node in the failover group. The format of this field is chassis-number/slot-number.CPU-number. The chassis-number segment represents the member ID of the IRF member device. The slot-number segment represents the slot number of the card. The CPU-number segment represents the CPU number. If the card has only one CPU, the CPU number is not displayed. (For devices with multiple CPUs.) The format of this field is chassis-number/slot-number. The chassis-number segment represents the member ID of the IRF member device. The slot-number segment represents the slot number of the card. (For devices with one CPU.) 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. |
# (In IRF mode.) Display information about all failover groups. (Devices that support inter-system service backup.)
<Sysname> display failover group
Stateful failover local group information:
ID Name Primary Secondary Active status
1 group1 1/4 NA Primary
2 group2 1/3 NA Secondary
Stateful failover remote group information:
ID Name Local Peer Active status
3 group3 1/4 1.1.1.2 Local
# (In IRF mode.) Display detailed information about failover group group3. (Devices that support inter-system service backup.)
<Sysname> display failover group group3
ID : 3
Active status : Local
Local node : Chassis 1 slot 4
Local IP address : NA
Peer IP address : NA
Port number : NA
Bound VRRP ID : NA
VRRP interface : NA
VRRP status : Inactive
Table 2 Command output
Field |
Description |
Stateful failover local group information |
Information about the failover group used for intra-system service backup. |
ID |
ID of the failover group. |
Name |
Name of the failover group. The name of an automatic failover group contains the string AutoBackup. |
Primary |
The primary node in the failover group. The format of this field is chassis-number/slot-number.CPU-number. The chassis-number segment represents the member ID of the IRF member device. The slot-number segment represents the slot number of the card. The CPU-number segment represents the CPU number. If the card has only one CPU, the CPU number is not displayed. (For devices with multiple CPUs.) The format of this field is chassis-number/slot-number. The chassis-number segment represents the member ID of the IRF member device. The slot-number segment represents the slot number of the card. (For devices with one CPU.) If no primary node is configured, this field displays NA. |
Secondary |
The secondary node in the failover group. The format of this field is chassis-number/slot-number.CPU-number. The chassis-number segment represents the member ID of the IRF member device. The slot-number segment represents the slot number of the card. The CPU-number segment represents the CPU number. If the card has only one CPU, the CPU number is not displayed. (For devices with multiple CPUs.) The format of this field is chassis-number/slot-number. The chassis-number segment represents the member ID of the IRF member device. The slot-number segment represents the slot number of the card. (For devices with one CPU.) · If no secondary node is configured, this field displays NA. |
Stateful failover remote group information |
Information about the failover group used for inter-system service backup. |
Local |
The node on the local system. The format of this field is chassis-number/slot-number.CPU-number. The chassis-number segment represents the member ID of the IRF member device. The slot-number segment represents the slot number of the card. The CPU-number segment represents the CPU number. If the card has only one CPU, the CPU number is not displayed. (For devices with multiple CPUs.) The format of this field is chassis-number/slot-number. The chassis-number segment represents the member ID of the IRF member device. The slot-number segment represents the slot number of the card. (For devices with one CPU.) |
Peer |
IP address of the peer interface on the backup link. |
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. · Local—The local node is processing services. · Peer—The peer node is processing services. |
Local node |
The node on the local system. |
Local IP address |
IP address of the local interface on the backup link. |
Peer IP address |
IP address of the peer interface on the backup link. |
Port number |
Port number of the failover group. |
Bound VRRP ID |
Number of the VRRP group that is bound to the failover group. |
VRRP interface |
Interface where the VRRP group is created. |
VRRP status |
Role of the device in the VRRP group. |
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 [ id group-id ]
undo failover group group-name
Default
No failover groups exist.
Views
System view
Predefined user roles
network-admin
Parameters
group-name: Specifies a failover group by its name, a case-sensitive string of 1 to 63 characters.
id group-id: Specifies a failover group by its ID, in the range of 1 to 64. This option is required when you create a failover group. It is optional when you enter failover group view. The group ID and the group name can both identify a failover group. The group name is mainly used to identify a failover group on the local device. The group ID is mainly used to exchange messages between devices in a failover group.
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.
Examples
# Create failover group group1 and enter its view. (Devices that do not support inter-system service backup.)
<Sysname> system-view
[Sysname] failover group group1
[Sysname-failover-group-group1]
# Create failover group Group1 with group ID 1 and enter its view. (Devices that support inter-system service backup.)
<Sysname> system-view
[Sysname] failover group Group1 id 1
[Sysname-failover-group-group1]
remote-backup
Use remote-backup to specify a backup channel for inter-system service backup.
Use undo remote-backup to remove the backup channel configuration.
Syntax
remote-backup local ip-address peer peer-ip-address port port-number
undo remote-backup
Default
No backup channel is specified for inter-system service backup.
Views
System view
Predefined user roles
network-admin
Parameters
local ip-address: Specifies a local IP address.
peer peer-ip-address: Specifies a peer IP address.
port port-number: Specifies a port number in the range of 1024 to 55535. The port number cannot be a known port number or port number in use.
Usage guidelines
Set up the backup link by using two IP addresses that can reach each other.
This command applies to inter-system service backup. You must execute this command on both of the systems and configure the same port number for them.
As a best practice, use a direct link for backup packets. If the physical interface on the link transmits multiple types of traffic, create a dedicated subinterface for each kind of traffic.
Examples
# Specify a backup channel for inter-system service backup. The local IP address is 192.168.2.125, the peer IP address is 192.168.3.142, and the port number is 3000.
<Sysname> system-view
[Sysname] failover group group1 id 1
[Sysname-failover-group-group1] remote-backup local 192.168.2.125 peer 192.168.3.142 port 3000