- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
06-Failover group commands | 47.54 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 { primary | secondary | vrrp }
undo bind slot slot-number
In IRF mode:
bind chassis chassis-number slot slot-number { primary | secondary | vrrp }
undo bind chassis chassis-number slot slot-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.)
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.
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
# (In IRF mode.) Configure slot 4 as the primary node in failover group group1.
<Sysname> system-view
[Sysname] failover group group1
[Sysname-failover-group-group1] bind chassis 1 slot 3 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.
Examples
# Bind failover group group1 to VRRP group 1 created on GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] failover group Group1
[Sysname-failover-group-Group1] bind-vrrp 1 interface 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.
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.
<Sysname> display failover group
Stateful failover group information:
ID Name Local Peer Active status
3 group3 1/4 1.1.1.2 Local
Table 1 Command output
Field |
Description |
Name |
Name of the failover group. |
Local |
The node on the local system. 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. If the primary node is not configured, this field displays N/A. |
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. |
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 with ID 1 and enter its view.
<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.
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