VSRP commands -- VSRP peer commands -- display vsrp peer

Use display vsrp peer to display VSRP group information.

Syntax

display vsrp peer [ peer-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

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

Examples

# Display information about VSRP group pname.

<Sysname> display vsrp peer pname

VSRP peer name: pname

TCP status: Connected

Peer IP: 11.0.0.3

Local IP: 10.0.0.3

Port: 6000

Track ID: 5

Track status: Positive

# Display information about all VSRP groups.

<Sysname> display vsrp peer

VSRP peer name: pname1

TCP status: Connected

Peer IP: 11.0.0.3

Local IP: 10.0.0.3

Port: 6000

Track ID: 5

Track status: Positive

VSRP peer name: pname2

TCP status: Disconnected

Peer IP: 10.0.0.2

Local IP: 11.0.0.2

Port: 5000

Track ID: 5

Track status: Negative

Table 1 Command output

Field | Description
VSRP peer name | Name of a VSRP group.
TCP status | TCP control channel state: Connected or Disconnected.
Peer IP | Peer IP address for VSRP channels.
Local IP | Local IP address for VSRP channels.
Port | Port number for the TCP control channel.
Track ID | ID of the track entry associated with the VSRP group.
Track status | Track entry state: · Positive. · NotReady. · Negative.

‌

VSRP commands -- VSRP peer commands -- peer

Use peer to configure the IPv4 TCP parameters for establishing VSRP channels to the peer.

Use undo peer to restore the default.

Syntax

peer peer-ip-address local local-ip-address [ port port-id ]

undo peer

Default

No IPv4 VSRP channels are established to the peer.

Views

VSRP peer view

Predefined user roles

network-admin

mdc-admin

Parameters

peer-ip-address: Specifies the IPv4 address of the peer.

local local-ip-address: Specifies the IPv4 address of the local device.

port port-id: Specifies the TCP port number for establishing the control channel. The value range is 1024 to 65535 and the default is 60032. The specified port number cannot be one that is in use.

Usage guidelines

You must specify different unicast IPv4 addresses for the peer device and the local device in a VSRP group. The IPv4 addresses cannot be all zeros or loopback addresses.

If you have multiple VSRP groups, make sure their IP address pairs are unique.

The specified IP addresses are also used to establish data channels. You can specify TCP ports for establishing data channels by service type in system view.

To change the TCP parameters for VSRP channel establishment, first execute the undo form of the command to remove the existing IPv4 VSRP channels.

Examples

# Specify channel establishment parameters for VSRP group pname. Set the local IPv4 address to 11.0.0.2, the peer IPv4 address to 10.0.0.1, and the TCP port number for the control channel to 7000.

<Sysname> system-view

[Sysname] vsrp peer pname

[Sysname-vsrp-peer-pname] peer 10.0.0.1 local 11.0.0.2 port 7000

VSRP commands -- VSRP peer commands -- peer ipv6

Use peer ipv6 to configure the IPv6 TCP parameters for establishing VSRP channels to the peer.

Use undo peer ipv6 to restore the default.

Syntax

peer ipv6 peer-ipv6-address local local-ipv6-address [ port port-id ]

undo peer ipv6

Default

No IPv6 VSRP channels are established to the peer.

Views

VSRP peer view

Predefined user roles

network-admin

mdc-admin

Parameters

peer-ipv6-address: Specifies the IPv6 address of the peer.

local local-ipv6-address: Specifies the IPv6 address of the local device.

port port-id: Specifies the TCP port number for establishing the control channel. The value range is 1024 to 65535 and the default is 60032. The specified port number cannot be one that is in use.

Usage guidelines

You must specify different IPv6 unicast addresses for the peer device and the local device in a VSRP group. The IPv6 addresses cannot be all zeros or loopback addresses.

If you have multiple VSRP groups, make sure their IP address pairs are unique.

The specified IP addresses are also used to establish data channels. You can specify TCP ports for establishing data channels by service type in system view.

To change the TCP parameters for VSRP channel establishment, first execute the undo form of the command to remove the existing IPv4 VSRP channels.

Examples

# Specify the channel establishment parameters for VSRP group pname. Set the local IPv6 address to 1::1, the peer IPv6 address to 2::2, and the TCP port number for the control channel to 7000.

<Sysname> system-view

[Sysname] vsrp peer pname

[Sysname-vsrp-peer-pname] peer ipv6 2::2 local 1::1 port 7000

VSRP commands -- VSRP peer commands -- track

Use track to associate a VSRP group with a track entry.

Use undo track to restore the default.

Syntax

track track-entry-number

undo track

Default

A VSRP group is not associated with any track entry.

Views

VSRP peer view

Predefined user roles

network-admin

mdc-admin

Parameters

track-entry-number: Specifies a track entry by its number in the range of 1 to 1024.

Usage guidelines

By default, a VSRP group can detect the state of the failover link based only on the state of the TCP control channel.

You can associate a VSRP group with a track entry to identify the state of the failover link.

· When the track entry is in Positive or NotReady state, a device in the VSRP group attempts to establish a TCP control channel to the peer.

· When the track entry changes to Negative state, the device terminates the TCP control channel.

A VSRP group takes effect only when a TCP control channel is established.

For more information about track entries, see High Availability Configuration Guide.

Examples

# Associate VSRP group pname with track entry 10.

<Sysname> system-view

[Sysname] vsrp peer pname

[Sysname-vsrp-peer-pname] track 10

VSRP commands -- VSRP peer commands -- vsrp peer

Use vsrp peer to create a VSRP group and enter VSRP peer view, or enter the VSRP peer view of an existing VSRP group.

Use undo vsrp peer to remove a VSRP group.

Syntax

vsrp peer peer-name

undo vsrp peer peer-name

Default

No VSRP groups exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

peer-name: Specifies a VSRP group by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

You can create a maximum of 64 VSRP groups on the device.

If a VSRP instance exists on a VSRP group, you must use the undo backup id command to remove that VSRP instance before you can remove the VSRP group.

Examples

# Create a VSRP group named pname and enter VSRP peer view.

<Sysname> system-view

[Sysname] vsrp peer pname

[Sysname-vsrp-peer-pname]

VSRP commands -- VSRP instance commands -- backup id

Use backup id to specify a backup ID for a VSRP instance.

Use undo backup id to restore the default.

Syntax

backup id backup-id peer peer-name

undo backup id

Default

A VSRP instance has no backup ID.

Views

VSRP instance view

Predefined user roles

network-admin

mdc-admin

Parameters

backup-id: Specifies a VSRP instance by its backup ID in the range of 1 to 1024.

peer-name: Specifies a VSRP group by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

A VSRP instance can be associated with only one VSRP group. The backup ID uniquely identifies a VSRP instance in a VSRP group.

You must specify the same backup ID for a VSRP instance on both devices in a VSRP group.

When you specify a backup ID for a VSRP instance, make sure the following conditions are met:

· The associated VSRP group already exists.

· The backup ID is unique in the VSRP group.

To specify a new backup ID for a VSRP instance, first execute the undo form of the command to remove the existing backup ID setting.

Examples

# Specify the backup ID of VSRP instance aaa as 5 in VSRP group pname.

<Sysname> system-view

[Sysname] vsrp instance aaa

[Sysname-vsrp-instance-aaa] backup id 5 peer pname

VSRP commands -- VSRP instance commands -- backup mode

Use backup mode to set the backup mode for a VSRP instance.

Use undo backup mode to restore the default.

Syntax

backup mode { hot | warm }

undo backup mode

Default

A VSRP instance operates in hot backup mode.

Views

VSRP instance view

Predefined user roles

network-admin

mdc-admin

Parameters

hot: Specifies hot backup mode.

warm: Specifies warm backup mode.

Usage guidelines

In hot backup mode, the backup device issues backup information to the data plane immediately upon receiving the information from the master. This allows the VSRP instance to perform a fast master and backup switchover to enable the backup to forward packets when the master fails.

In warm backup mode, the backup device does not issue received backup information to the data plane immediately. When the master fails and a switchover occurs, the backup begins to set backup information to the data plane. As a result, the switchover takes longer in warm backup mode than in hot backup mode.

Examples

# Set VSRP instance aaa to operate in warm backup mode.

<Sysname> system-view

[Sysname] vsrp instance aaa

[Sysname-vsrp-instance-aaa] backup mode warm

VSRP commands -- VSRP instance commands -- bind vrrp ipv6 vrid

Use bind vrrp ipv6 vrid to bind a VSRP instance to an IPv6 VRRP group.

Use undo bind vrrp ipv6 to restore the default.

Syntax

bind vrrp ipv6 vrid virtual-router-id interface interface-type interface-number

undo bind vrrp ipv6

Default

A VSRP instance is not bound to any IPv6 VRRP group.

Views

VSRP instance view

Predefined user roles

network-admin

mdc-admin

Parameters

virtual-router-id: Specifies an IPv6 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.

Usage guidelines

A VSRP instance is bound to an IPv6 VRRP group to determine the device role (master or backup) in a VSRP group.

You can bind a VSRP instance to only one IPv6 VRRP group. The IPv6 VRRP group can be on any interface.

Examples

# Bind VSRP instance aaa to IPv6 VRRP group 2 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] vsrp instance aaa

[Sysname-vsrp-instance-aaa] bind vrrp ipv6 vrid 2 interface gigabitethernet 1/0/1

VSRP commands -- VSRP instance commands -- bind vrrp vrid

Use bind vrrp vrid to bind a VSRP instance to an IPv4 VRRP group.

Use undo bind vrrp to restore the default.

Syntax

bind vrrp vrid virtual-router-id interface interface-type interface-number

undo bind vrrp

Default

A VSRP instance is not bound to any IPv4 VRRP group.

Views

VSRP instance view

Predefined user roles

network-admin

mdc-admin

Parameters

virtual-router-id: Specifies an IPv4 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.

Usage guidelines

A VSRP instance is bound to an IPv4 VRRP group to determine the device role (master or backup) in a VSRP group.

You can bind a VSRP instance to only one IPv4 VRRP group. The IPv4 VRRP group can be on any interface.

Examples

# Bind VSRP instance aaa to IPv4 VRRP group 2 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] vsrp instance aaa

[Sysname-vsrp-instance-aaa] bind vrrp vrid 2 interface gigabitethernet 1/0/1

VSRP commands -- VSRP instance commands -- display vsrp instance

Use display vsrp instance to display VSRP instance information.

Syntax

display vsrp instance [ instance-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSRP instance, this command displays information about all VSRP instances.

Examples

# Display information about VSRP instance aaa.

<Sysname> display vsrp instance aaa

VSRP instance name: aaa

VSRP peer name: pname1

Backup ID: 10

Bound VRID: VRRP VRID 1 interface GigabitEthernet1/0/1

Instance status: Master

Local status: Master

Peer status: Backup

Backup mode: Warm

Traffic backup interval: 10(minutes)

Traffic backup threshold: 50(MB)

NAS IP: 10.0.0.1

NAS port: GigabitEthernet1/0/2

NAS ID: h3c

# Display information about all VSRP instances.

<Sysname> display vsrp instance

VSRP instance name: aaa

VSRP peer name: pname1

Backup ID: 10

Bound VRID: VRRP VRID 1 interface GigabitEthernet1/0/1

Instance status : Master

Local status: Master

Peer status: Backup

Backup mode: Warm

Traffic backup interval: 10(minutes)

Traffic backup threshold: 50(MB)

NAS IP: 10.0.0.1

NAS port: GigabitEthernet1/0/2

NAS ID: h3c

VSRP instance name: bbb

VSRP peer name: pname2

Backup ID: 10

Bound VRID: VRRP VRID 2 interface GigabitEthernet1/0/3

Instance status : Master

Local status: Master

Peer status: Backup

Backup mode: Warm

Traffic backup interval: 5(minutes)

Traffic backup threshold: 100(MB)

NAS IP: 10.0.0.2

NAS port: GigabitEthernet1/0/4

NAS ID: h3c

Table 2 Command output

Field | Description
VSRP peer name | Name of a VSRP group associated with the VSRP instance.
Bound VRID | Number of the VRRP group bound to the VSRP instance.
Instance status | VSRP instance state: · Master—The device acts as the master in the VSRP instance. · Backup—The device acts as the backup in the VSRP instance. · Down—The device is not running in the VSRP instance.
Local status | Local device state: · Master—The local device is acting as the master. · Backup—The local device is acting as the backup. · Init—The local device is in initialized state. · Down—The state of the local device is unknown.
Peer status | Peer state: · Master—The peer is acting as the master. · Backup—The peer is acting as the backup. · Init—The peer is in initialized state. · Down—The state of the peer is unknown.
Backup mode | VSRP instance backup mode: Hot or Warm.
Traffic backup threshold | Traffic threshold that triggers a traffic backup.
NAS IP | Logical NAS IP address.
NAS port | Logical NAS port.
NAS ID | Logical host name.

‌

VSRP commands -- VSRP instance commands -- nas

Use nas to configure NAS parameters.

Use undo nas to remove the NAS parameters.

Syntax

nas { id host-name | ip ip-address | port interface-type interface-number }

undo nas [ id | ip | port ]

Default

No NAS parameters are configured.

Views

VSRP instance view

Predefined user roles

network-admin

mdc-admin

Parameters

id host-name: Specifies a logical host name, a case-insensitive string of 1 to 127 characters.

ip ip-address: Specifies a logical unicast IP address. The IP address cannot be all zeros or a loopback address.

port interface-type interface-number: Specifies a logical interface by its type and number. It can be a Layer 3 Ethernet interface or a Layer 3 aggregate interface. The logical interface can be an interface that does not belong to the device. Make sure the logical interface number contains three segments in interface-type A/B/C format.

Usage guidelines

This command specifies NAS parameters for outgoing packets. This command enables devices in a VSRP group to share parameters when the devices have the following settings:

· The same NAS-IP-address, NAS-Port, and host name in packets sent to the RADIUS server.

· The same Option 82 in packets sent to the DHCP server.

In this way, the VSRP group is not required to be authenticated again after a master and backup switchover.

Examples

# Specify the logical IP address as 2.2.2.2.

<Sysname> system-view

[Sysname] vsrp instance aaa

[Sysname-vsrp-instance-aaa] nas ip 2.2.2.2

# Specify the logical interface as GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] vsrp instance aaa

[Sysname-vsrp-instance-aaa] nas port gigabitethernet 1/0/1

# Specify the logical host name as bbb.

<Sysname> system-view

[Sysname] vsrp instance aaa

[Sysname-vsrp-instance-aaa] nas id bbb

VSRP commands -- VSRP instance commands -- traffic backup

Use traffic backup to set a traffic backup interval or a traffic threshold that triggers a traffic backup.

Use undo traffic backup to remove the specified traffic backup interval or traffic threshold settings.

Syntax

traffic backup { interval interval-value | threshold threshold-value } *

undo traffic backup [ interval | threshold ]

Default

A VSRP instance backs up traffic at an interval of 10 minutes or when the traffic reaches 50 MB.

Views

VSRP instance view

Predefined user roles

network-admin

mdc-admin

Parameters

interval interval-value: Specifies a traffic backup interval in the range of 0 to 1440 minutes.

threshold threshold-value: Specifies a traffic threshold that triggers a traffic backup. The value range for the threshold-value argument is 0 to 100000 MB.

Usage guidelines

A VSRP instance backs up service data at the specified interval or when the specified traffic threshold is reached.

If traffic is not required to be backed up, set both the interval-value argument and the threshold-value argument to 0.

Examples

# Configure VSRP instance aaa to back up traffic every 50 minutes.

<Sysname> system-view

[Sysname] vsrp instance aaa

[Sysname-vsrp-instance-aaa] traffic backup interval 50

# Configure VSRP instance aaa to back up traffic when the traffic reaches 200 MB.

<Sysname> system-view

[Sysname] vsrp instance aaa

[Sysname-vsrp-instance-aaa] traffic backup threshold 200

# Set the traffic backup interval and the traffic threshold to the default value for VSRP instance aaa.

<Sysname> system-view

[Sysname] vsrp instance aaa

[Sysname-vsrp-instance-aaa] undo traffic backup

VSRP commands -- VSRP instance commands -- vsrp instance (system view)

Use vsrp instance to create a VSRP instance and enter its view, or enter the view of an existing VSRP instance.

Use undo vsrp instance to remove a VSRP instance.

Syntax

vsrp instance instance-name

undo vsrp instance instance-name

Default

No VSRP instances exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

A VSRP instance is associated with a service module. To enable a VSRP instance to function, you must configure the following items for the VSRP instance:

· A VSRP group.

· A bound VRRP group.

· The backup mode.

· The traffic backup interval or traffic threshold.

The device supports a maximum of 1024 VSRP instances.

Examples

# Create a VSRP instance named aaa, and enter VSRP instance view.

<Sysname> system-view

[Sysname] vsrp instance aaa

[Sysname-vsrp-instance-aaa]

VSRP commands -- IPv6 virtual address commands -- ipv6 virtual-address

Use ipv6 virtual-address to specify a virtual IPv6 address for an interface that is associated with a VSRP instance.

Use undo ipv6 virtual-address to restore the default.

Syntax

ipv6 virtual-address ipv6-address vsrp vsrp-instance

undo ipv6 virtual-address

Default

No virtual IPv6 address is configured.

Views

Layer 3 Ethernet interface/subinterface view

Layer 3 aggregate interface/subinterface view

Layer 3 RPR logical interface view

VLAN interface view

Predefined user roles

network-admin

mdc-admin

Parameters

ipv6-address: Specifies a virtual IPv6 address. The virtual IPv6 address must be a link local address that can be used as the gateway address by hosts in a LAN.

vsrp vsrp-instance: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

Use this command when you enable VSRP for IPv6 IPoE or DHCPv6 services on an interface. For VSRP to operate correctly, specify the same VSRP instance in this command and in the ipv6 subscriber vsrp-instance or the ipv6 dhcp vsrp-instance command. If different VSRP instances are specified, the hosts in the LAN cannot access the Internet after a master and backup switchover.

For the original link local address of the device to take effect, do not use this command when VSRP is disabled for IPv6 IPoE or DHCPv6 on the interface.

To enable VSRP to operate correctly, do not use this command on the same interface where a VRRP group is configured.

Examples

# Specify virtual IPv6 address fe80::10 for GigabitEthernet 1/0/1 that is associated with VSRP instance aaa.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 virtual-address fe80::10 vsrp aaa

VSRP commands -- IPoE VSRP commands -- ip subscriber vsrp-instance

Use ip subscriber vsrp-instance to associate an IPv4 IPoE-enabled interface with a VSRP instance.

Use undo ip subscriber vsrp-instance to restore the default.

Syntax

ip subscriber vsrp-instance instance-name

undo ip subscriber vsrp-instance

Default

An IPv4 IPoE-enabled interface is not associated with a VSRP instance.

Views

Layer 3 Ethernet interface/subinterface view

Layer 3 aggregate interface/subinterface view

Predefined user roles

network-admin

mdc-admin

Parameters

instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

After you execute this command, the associated VSRP instance backs up dynamic IPv4 IPoE sessions in real time through the data channel between the master and the backup.

When the master fails and a switchover occurs, the new master takes over the IPv4 IPoE service. The new master has the authorization and accounting information for the users. The original online dynamic IPv4 IPoE users can remain online.

Examples

# Associate IPv4 IPoE-enabled interface GigabitEthernet 1/0/1 with VSRP instance instance1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ip subscriber vsrp-instance instance1

Related commands

ip subscriber vsrp-port

VSRP commands -- IPoE VSRP commands -- ip subscriber vsrp-port

Use ip subscriber vsrp-port to specify a TCP port number for VSRP to establish data channels for IPoE services.

Use undo ip subscriber vsrp-port to restore the default.

Syntax

ip subscriber vsrp-port port-number

undo ip subscriber vsrp-port

Default

TCP port number 60033 is used to establish the data channels for IPoE sessions backup.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

port-number: Specifies a TCP number in the range of 1 to 65535.

Usage guidelines

To back up the dynamic IPoE sessions on an interface, the master must establish a TCP data channel with the backup. You can use this command to change the TCP port number for establishing the data channel.

Examples

# Specify TCP port 20000 for VSRP to establish data channels for IPoE services.

<Sysname> system-view

[Sysname] ip subscriber vsrp-port 20000

Related commands

ip subscriber vsrp-instance

VSRP commands -- IPoE VSRP commands -- ipv6 subscriber vsrp-instance

Use ipv6 subscriber vsrp-instance to associate an IPv6 IPoE-enabled interface with a VSRP instance.

Use undo ipv6 subscriber vsrp-instance to restore the default.

Syntax

ipv6 subscriber vsrp-instance instance-name

undo ipv6 subscriber vsrp-instance

Default

An IPv6 IPoE-enabled interface is not associated with a VSRP instance.

Views

Layer 3 Ethernet interface/subinterface view

Layer 3 aggregate interface/subinterface view

Predefined user roles

network-admin

mdc-admin

Parameters

instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

After you execute this command, the associated VSRP instance backs up dynamic IPv6 IPoE sessions in real time through the data channel between the master and the backup.

When the master fails and a switchover occurs, the new master takes over the IPv6 IPoE service. The new master has the authorization and accounting information for the users. The original online IPv6 IPoE users can remain online.

Examples

# Associate IPv6 IPoE-enabled interface GigabitEthernet 1/0/1 with VSRP instance instance1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 subscriber vsrp-instance instance1

Related commands

ipv6 subscriber vsrp-port

VSRP commands -- IPoE VSRP commands -- ipv6 subscriber vsrp-port

Use ipv6 subscriber vsrp-port to specify a TCP port number for establishing the data channel through which dynamic IPv6 IPoE sessions are backed up.

Use undo ipv6 subscriber vsrp-port to restore the default.

Syntax

ipv6 subscriber vsrp-port port-number

undo ipv6 subscriber vsrp-port

Default

The TCP port number 60040 is used for establishing the data channel through which dynamic IPv6 IPoE sessions are backed up.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

port-number: Specifies a TCP number in the range of 1 to 65535.

Usage guidelines

To back up dynamic IPv6 IPoE sessions, the master must establish a TCP data channel with the backup. You can use this command to change the TCP port number for establishing the data channel.

Examples

# Specify the TCP port number 20000 for the data channel through which dynamic IPv6 IPoE sessions are backed up.

<Sysname> system-view

[Sysname] ipv6 subscriber vsrp-port 20000

Related commands

ipv6 subscriber vsrp-instance

VSRP commands -- PPPoE VSRP commands -- display ppp sync-session

Use display ppp sync-session to display PPP sessions synchronized by VSRP instances.

Syntax

display ppp sync-session [ vsrp-instance vsrp-instance-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vsrp-instance vsrp-instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays PPP sessions synchronized by all VSRP instances on the device.

Usage guidelines

When you specify a VSRP instance, this command displays the following PPP sessions:

· On the master—PPP sessions synchronized to the backup.

· On the backup—PPP sessions synchronized from the master.

Examples

# Display PPP sessions synchronized by all VSRP instances on the device.

<Sysname> display ppp sync-session

VSRP instance: vsrp1

VSRP instance state: Master

Total synchronized PPP sessions: 2

SID MAC address Interface IP address Username

1 00e0-1500-0410 GE1/0/1 2.2.2.2 user1@isp1

2 00e0-1500-0411 GE1/0/1 2.2.2.3 user1@isp1

VSRP instance: vsrp2

VSRP instance state: Backup

Total synchronized PPP sessions: 1

SID MAC address Interface IP address Username

1 00e0-1500-0413 GE1/0/2 2.3.2.2 user1@isp1

VSRP instance: vsrp3

VSRP instance state: Down

Total synchronized PPP sessions: 0

SID MAC address Interface IP address Username

Table 3 Command output

Field | Description
VSRP instance | VSRP instance name.
VSRP instance state | VSRP instance state: · Master—The device acts as the master in the VSRP instance. The command displays PPP sessions synchronized to the backup. · Backup—The device acts as the backup in the VSRP instance. The command displays PPP sessions synchronized from the master. · Down—The device is not running. The device has no PPP sessions synchronized by the VSRP instance. This field displays Down in either of the following situations: ?span style='font:7.0pt "Times New Roman"'> The associated VRRP group is in Initialize state. ?span style='font:7.0pt "Times New Roman"'> The VSRP instance does not exist or is not correctly configured on the device.
SID | PPP session ID.

‌

VSRP commands -- PPPoE VSRP commands -- display pppoe-server sync-session

Use display pppoe-server sync-session to display PPPoE sessions synchronized by VSRP instances.

Syntax

display pppoe-server sync-session [ vsrp-instance vsrp-instance-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vsrp-instance vsrp-instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays PPPoE sessions synchronized by all VSRP instances on the device.

Usage guidelines

When you specify a VSRP instance, this command displays the following PPPoE sessions:

· PPPoE sessions synchronized to the backup (on the master).

· PPPoE sessions synchronized from the master (on the backup).

Examples

# Display PPPoE sessions synchronized by all VSRP instances on the device.

<Sysname> display pppoe-server sync-session

VSRP instance: vsrp1

VSRP instance state: Master

Total synchronized PPPoE sessions: 2

SID Service VLAN Customer VLAN MAC address Interface

1 1 1 00e0-1500-0410 GE1/0/1

2 1 1 00e0-1500-0411 GE1/0/1

VSRP instance: vsrp2

VSRP instance state: Backup

Total synchronized PPPoE sessions: 1

SID Service VLAN Customer VLAN MAC address Interface

1 1 2 00e0-1500-0413 GE1/0/2

VSRP instance: vsrp3

VSRP instance state: Down

Total synchronized PPPoE sessions: 0

SID Service VLAN Customer VLAN MAC address Interface

Table 4 Command output

Field | Description
VSRP instance | VSRP instance name.
VSRP instance state | VSRP instance state: · Master—The device acts as the master in the VSRP instance. The command displays PPPoE sessions synchronized to the backup. · Backup—The device acts as the backup in the VSRP instance. The command displays PPPoE sessions synchronized from the master. · Down—The device is not running. The device has no PPPoE sessions synchronized by the VSRP instance. This field displays Down in either of the following situations: ?span style='font:7.0pt "Times New Roman"'> The associated VRRP group is in Initialize state. ?span style='font:7.0pt "Times New Roman"'> The VSRP instance does not exist or is not correctly configured on the device.
SID | PPPoE session ID.
Service VLAN | Service provider network VLAN.
Customer VLAN | Customer network VLAN.

‌

VSRP commands -- PPPoE VSRP commands -- ppp vsrp-port

Use ppp vsrp-port to specify a TCP port number for VSRP to establish data channels for PPPoE services.

Use undo ppp vsrp-port to restore the default.

Syntax

ppp vsrp-port port-number

undo ppp vsrp-port

Default

TCP port 60035 is used to establish the data channels for PPP and PPPoE session backup.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

port-number: Specifies a TCP port number in the range of 1 to 65535. The specified port number cannot be used by other services.

Usage guidelines

To back up PPP or PPPoE sessions on an interface, the master must establish a TCP data channel with the backup. You can use this command to change the TCP port number for establishing the data channel.

You must specify the same port number on the master and the backup in a VSRP instance. Otherwise, the data channel cannot be established.

Examples

# Specify the TCP port number 20000 for VSRP to establish data channels for PPPoE services.

<Sysname> system-view

[Sysname] ppp vsrp-port 20000

VSRP commands -- PPPoE VSRP commands -- pppoe-server vsrp-instance

Use pppoe-server vsrp-instance to associate a PPPoE server-enabled interface with a VSRP instance.

Use undo pppoe-server vsrp-instance to remove the association.

Syntax

pppoe-server vsrp-instance vsrp-instance-name

undo pppoe-server vsrp-instance

Default

A PPPoE server-enabled interface is not associated with a VSRP instance.

Views

Layer 3 Ethernet interface/subinterface view

Layer 3 aggregate interface/subinterface view

EFM interface/subinterface view

Predefined user roles

network-admin

mdc-admin

Parameters

vsrp-instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

You must remove all online PPPoE clients on the interface before you execute this command.

After you execute this command, the associated VSRP instance backs up PPPoE and PPP sessions in real time through the data channel between the master and the backup.

You can specify a nonexistent VSRP instance in this command, but this command takes effect only when the specified VSRP instance exists.

An interface can be associated with only one VSRP instance.

You cannot associate different interfaces on a device with the same VSRP instance. However, you can associate subinterfaces of an interface with the same VSRP instance.

To associate an interface with a VSRP instance that has been associated with another interface, remove the original association of the VSRP instance first.

Examples

# Associate PPPoE server-enabled interface GigabitEthernet 1/0/1 with VSRP instance vsrp1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] pppoe-server vsrp-instance vsrp1

VSRP commands -- PPPoE VSRP commands -- pppoe-server vsrp-port

Use pppoe-server vsrp-port to specify a TCP port number for establishing the data channel through which PPPoE sessions are backed up.

Use undo pppoe-server vsrp-port to restore the default.

Syntax

pppoe-server vsrp-port port-number

undo pppoe-server vsrp-port

Default

The TCP port number 60034 is used for establishing the data channel through which PPPoE sessions are backed up.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

port-number: Specifies a TCP port number in the range of 1 to 65535. The specified port number cannot be used by other services.

Usage guidelines

To back up PPPoE sessions, the master must establish a TCP data channel with the backup. You can use this command to change the TCP port number for establishing the data channel.

For the data channel to be successfully established, you must specify the same port number on the master and the backup in a VSRP instance.

Examples

# Specify the TCP port number 30000 for establishing the data channel through which PPPoE sessions are backed up.

<Sysname> system-view

[Sysname] pppoe-server vsrp-port 30000

VSRP commands -- L2TP VSRP commands -- display l2tp session vsrp

Use display l2tp session vsrp to display L2TP sessions backed up by VSRP instances.

Syntax

display l2tp session vsrp [ vsrp-instance-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vsrp-instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSRP instance, this command displays L2TP sessions backed up by all VSRP instances on the device.

Examples

# Display information about the L2TP sessions backed up by VSRP instance abc.

<Sysname> display l2tp session vsrp abc

VSRP instance name: abc

Local session ID: 1

Remote session ID: 1

Local tunnel ID: 1

State: Established

User ID: 00e0fc112233000300000004

Interface: Virtual-Access0

Table 5 Command output

Field | Description
VSRP instance name | Name of the VSRP instance that backs up the L2TP session.
State | Session state: · Idle. · Wait-tunnel—Waits for the tunnel to be established. · Wait-reply—Waits for an Incoming-Call-Reply (ICRP) message indicating the call is accepted. · Established.
Interface | VA interface on the LAC.

‌

VSRP commands -- L2TP VSRP commands -- display l2tp tunnel vsrp

Use display l2tp tunnel vsrp to display information about the L2TP tunnels backed up by VSRP instances.

Syntax

display l2tp tunnel vsrp [ vsrp-instance-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vsrp-instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSRP instance, this command displays L2TP tunnel information backed up by all VSRP instances.

Examples

# Display information about the L2TP tunnels backed up by VSRP instance abc.

<Sysname> display l2tp tunnel vsrp abc

VSRP instance name: abc

Local tunnel ID: 1

Remote tunnel ID: 1

State: Established

Sessions: 1

Remote address: 20.1.1.2

Remote port: 1701

Remote name: lns

Local address: 2.2.2.2

Sequence number sent (Ns): 2

Sequence number expected (Nr): 3

Table 6 Command output

Field | Description
VSRP instance name | Name of the VSRP instance that backs up the L2TP tunnel.
State | Tunnel state: · Idle. · Wait-reply—Waits for a Start-Control-Connection-Reply (SCCRP) message. · Established. · Stopping—The tunnel is being disconnected.
Sessions | Number of sessions within the tunnel.
Remote address | IP address of the peer.
Remote port | UDP port number of the peer.
Remote name | Name of the tunnel peer.
Local address | IP address of the local device.
Sequence number sent (Ns) | Sequence number for the control message sent.
Sequence number expected (Nr) | Sequence number expected in the next control message to be received.

‌

Related commands

reset l2tp tunnel (Layer 2—WAN Access Command Reference)

VSRP commands -- L2TP VSRP commands -- display l2tp vsrp

Use display l2tp vsrp to display information about the VSRP instance that backs up L2TP services.

Syntax

display l2tp vsrp [ vsrp-instance-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vsrp-instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSRP instance, this command displays information about all VSRP instances that back up L2TP services.

Examples

# Display information about VSRP instance abc, which backs up L2TP services.

<Sysname> display l2tp vsrp abc

VSRP instance name: abc

VSRP mode: Hot

VSRP status: Switched

Local VSRP state: Master/Up

Remote VSRP state: Backup

VSRP channel state: Synced

Sent messages: 13005

Received messages: 23

Discarded sent messages: 22

Discarded received messages: 13

Sent tunnel add messages: 8000

Received tunnel add messages: 0

Sent tunnel delete messages: 5500

Received tunnel delete messages: 0

Sent session add messages: 20000

Received session add messages: 0

Sent session delete messages: 10000

Received session delete messages: 0

Current tunnels: 2500

Current sessions: 10000

Added tunnels: 8000

Deleted tunnels: 5500

Added sessions: 20000

Deleted sessions: 10000

Table 7 Command output

Field | Description
VSRP mode | VSRP backup mode: · Hot. · Warm.
VSRP status | State of the master and backup switchover: · Switching. · Switched.
Local VSRP state | VSRP group state on the local device: · Master/Up—The device is acting as the master and the VSRP group is operating correctly. · Backup/Up—The device is acting as the backup and the VSRP group is operating correctly. · Master/Down—The device is acting as the master and the VSRP group is operating incorrectly. · Backup/Down—The device is acting as the backup and the VSRP group is operating incorrectly.
Remote VSRP state | VSRP group state on the peer: · Master—The peer is acting as the master. · Backup—The peer is acting as the backup.
VSRP channel state | The data channel state: · Disconnected. · Syncing—Data is being synchronized. · Synced—Data has been synchronized.
Sent messages | Number of backup messages sent by the device.
Received messages | Number of backup messages received by the device.
Discarded sent messages | Number of outgoing messages discarded by the device.
Discarded received messages | Number of incoming messages discarded by the device.
Sent tunnel add messages | Number of tunnel adding messages sent by the device.
Received tunnel add messages | Number of tunnel adding messages received by the device.
Sent tunnel delete messages | Number of tunnel deleting messages sent by the device.
Received tunnel delete messages | Number of tunnel deleting messages received by the device.
Sent session add messages | Number of session adding messages sent by the device.
Received session add messages | Number of session adding messages received by the device.
Sent session delete messages | Number of session deleting messages sent by the device.
Received session delete messages | Number of session deleting messages received by the device.
Current tunnels | Number of tunnels in the VSRP instance.
Current sessions | Number of L2TP sessions in the VSRP instance.
Added tunnels | Number of L2TP tunnels established in a VSRP instance.
Deleted tunnels | Number of L2TP tunnels deleted in a VSRP instance.
Added sessions | Number of L2TP sessions established in a VSRP instance.
Deleted sessions | Number of L2TP sessions deleted in a VSRP instance.

‌

VSRP commands -- L2TP VSRP commands -- l2tp tunnel-id

Use l2tp tunnel-id to specify an L2TP tunnel ID range.

Use undo l2tp tunnel-id to restore the default.

Syntax

l2tp tunnel-id low-id high-id

undo l2tp tunnel-id

Default

The L2TP tunnel ID is in the range of 1 to 65535.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

low-id: Specifies the lower limit of the L2TP tunnel ID. The value range is 1 to 65535.

high-id: Specifies the upper limit of the L2TP tunnel ID. The value range is 1 to 65535. The upper limit must be greater than or equal to the lower limit.

Usage guidelines

To avoid tunnel ID conflicts after a master/backup switchover, you must specify different L2TP tunnel ID ranges on the peer LACs in the following scenario:

You assign the peer LACs to two VSRP instances with their roles exchanged for load sharing purposes. For example, use LAC 1 as the master and LAC 2 as the backup in VSRP instance 1. Use LAC 2 as the master and LAC 1 as the backup in VSRP instance 2.

You cannot change the L2TP tunnel ID range for an LAC when it has an L2TP tunnel.

Examples

# Specify a L2TP tunnel ID range from 20 to 100 on the LAC.

<Sysname> system-view

[Sysname] l2tp tunnel-id 20 100

VSRP commands -- L2TP VSRP commands -- l2tp vsrp-port

Use l2tp vsrp-port to specify a TCP port number for VSRP to establish data channels for L2TP services.

Use undo l2tp vsrp-port to restore the default.

Syntax

l2tp vsrp-port port-number

undo l2tp vsrp-port

Default

TCP port 60036 is used to establish the data channels for L2TP service backup.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

port-number: Specifies a TCP port number in the range of 1 to 65535. The specified port number cannot be used by other services.

Usage guidelines

To back up a L2TP service, the master must establish a TCP data channel with the backup. You can use this command to change the TCP port number for establishing the data channel.

You must specify the same TCP port number on the master and the backup in a VSRP instance. Otherwise, the data channel cannot be established.

Examples

# Specify TCP port 20000 for VSRP to establish data channels for L2TP service backup.

<Sysname> system-view

[Sysname] l2tp vsrp-port 20000

VSRP commands -- L2TP VSRP commands -- tunnel vsrp source-ip

Use tunnel vsrp source-ip to specify a source address for an L2TP tunnel when VSRP is enabled for L2TP. This address is used as the source IP address of tunneled packets.

Use undo tunnel vsrp source-ip to restore the default.

Syntax

tunnel vsrp source-ip ip-address

undo tunnel vsrp source-ip

Default

The L2TP tunnel source address is the IP address of the tunnel interface.

Views

L2TP group view

Predefined user roles

network-admin

mdc-admin

Parameters

ip-address: Specifies a source address for the L2TP tunnel when VSRP is enabled for L2TP. The tunnel source address can only be the loopback interface address with a 32-bit mask or an IP address that does not exist on the network.

Usage guidelines

You must use this command to specify the same L2TP tunnel source address on the master and backup LACs. The master LAC automatically generates a static route to the source address with the loopback interface as the output interface.

After a master and backup switchover, the original master deletes the static route and uses a dynamic routing protocol to advertise the route deletion. Meanwhile, the new master generates a static route to the tunnel source address and uses a dynamic routing protocol to advertise the route. In this way, the traffic from the LNS can be automatically switched to the new master LAC. The LNS considers that the original L2TP tunnel remains established.

When you specify the source address for an L2TP tunnel, follow these restrictions and guidelines:

· As a best practice, specify different L2TP tunnel source addresses for L2TP tunnels in different L2TP groups.

· To specify an L2TP tunnel source address, you must first associate the L2TP group with a VSRP instance.

· You cannot change or remove the specified tunnel source address for the existing L2TP tunnel in an L2TP group.

· When you enable VSRP for L2TP services, the tunnel source address specified by the tunnel vsrp source-ip command rather than that specified by the source-ip command takes effect. If you configure the source-ip command but not the tunnel vsrp source-ip command, VSRP for L2TP cannot operate correctly.

Examples

# Specify the source address for the L2TP tunnel in L2TP group 1 as 2.2.2.2.

<Sysname> system-view

[Sysname] l2tp-group 1 mode lac

[Sysname-l2tp1] tunnel vsrp source-ip 2.2.2.2

Related commands

source-ip (Layer 2—WAN Access Command Reference)

VSRP commands -- L2TP VSRP commands -- vsrp-instance (L2TP group view)

Use vsrp-instance to associate an L2TP group with a VSRP instance.

Use undo vsrp-instance to remove the VSRP instance association.

Syntax

vsrp-instance vsrp-instance-name

undo vsrp-instance

Default

An L2TP group is not associated with a VSRP instance.

Views

L2TP group view

Predefined user roles

network-admin

mdc-admin

Parameters

vsrp-instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

To back up L2TP services, you must associate an L2TP group with a VSRP instance. Then, the master LAC backs up information about the L2TP group to the backup LAC in real time over the VSRP data channel. In some situations, such as a device reboot, the backup LAC also requests L2TP group information from the master LAC over the VSRP data channel.

You must associate the peer L2TP groups on the master and backup LACs with the same VSRP instance.

Using this command removes the existing L2TP tunnel in the L2TP group.

You cannot change or remove the association between an L2TP group and a VSRP instance when an L2TP tunnel exists in the L2TP group.

Examples

# Associate L2TP group 1 in LAC mode with VSRP instance abc.

<Sysname> system-view

[Sysname] l2tp-group 1 mode lac

[Sysname-l2tp1] vsrp-instance abc

VSRP commands -- Portal VSRP commands -- portal vsrp-instance

Use portal vsrp-instance to associate a portal-enabled interface with a VSRP instance.

Use undo portal vsrp-instance to restore the default.

Syntax

portal vsrp-instance vsrp-instance-name

undo portal vsrp-instance

Default

A portal-enabled interface is not associated with a VSRP instance.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

vsrp-instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

The master backs up portal services to the backup so that the backup can take over the portal services when the master or its link fails. This backup ensures that the online portal users remain online without re-authentication after a master/backup switchover, because the new master has obtained their accounting and authorization information.

You must associate the peer interfaces on the master and backup access devices with the same VSRP instance.

VSRP backup for a portal-enabled interface takes effect on all IPv4 and IPv6 portal users that use direct authentication on the interface.

If you configure VLAN termination on the subinterfaces on the master and backup access devices, make sure the peer subinterfaces terminate the same VLAN IDs.

You cannot associate different interfaces on a device with the same VSRP instance. However, you can associate subinterfaces of an interface with the same VSRP instance or different VSRP instances.

Any change to the VSRP instance that is associated with a portal-enabled interface can make portal users on the interface go offline.

Examples

# Associate portal-enabled interface GigabitEthernet 1/0/1 with VSRP instance aaa.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] portal vsrp-instance aaa

Related commands

display portal interface

portal vsrp-port

VSRP commands -- Portal VSRP commands -- portal vsrp-port

Use portal vsrp-port to specify a TCP port number for VSRP to establish data channels for portal service backup.

Use undo portal vsrp-port to restore the default.

Syntax

portal vsrp-port port-number

undo portal vsrp-port

Default

TCP port 60038 is used to establish data channels for portal service backup.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

port-number: Specifies a TCP port number in the range of 1 to 65535. The specified port number cannot be used by other services.

Usage guidelines

To back up a portal service, the master must establish a TCP data channel with the backup. You can use this command to change the TCP port number for establishing the data channel.

Examples

# Specify TCP port 20000 for VSRP to establish data channels for portal service backup.

<Sysname> system-view

[Sysname] portal vsrp-port 20000

Related commands

portal vsrp-instance

VSRP commands -- DHCP VSRP commands -- dhcp vsrp port

Use dhcp vsrp port to specify a TCP port number for VSRP to establish data channels for DHCPv4 server or relay agent service backup.

Use undo dhcp vsrp port to restore the default.

Syntax

dhcp vsrp port port-number

undo dhcp vsrp port

Default

TCP port 60037 is used to establish data channels for DHCPv4 server or relay agent service backup.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

port-number: Specifies a TCP port number in the range of 1 to 65535. The specified port number cannot be used by other services.

Usage guidelines

To back up data for a DHCPv4 address pool, the master DHCPv4 server must establish a TCP data channel with the backup DHCPv4 server.

To back up DHCPv4 relay agent data for a client-side interface, the master DHCPv4 relay agent must establish a TCP data channel with the backup DHCPv4 relay agent.

You can use this command to change the TCP port number for establishing the data channel.

Examples

# Specify TCP port 30000 for VSRP to establish data channels for DHCPv4 server or relay agent service backup.

<Sysname> system-view

[Sysname] dhcp vsrp port 30000

VSRP commands -- DHCP VSRP commands -- dhcp vsrp-instance

Use dhcp vsrp-instance to associate a client-side interface on the DHCPv4 server with a VSRP instance.

Use undo dhcp vsrp-instance to remove the VSRP instance association.

Syntax

dhcp vsrp-instance vsrp-instance-name

undo dhcp vsrp-instance

Default

The client-side interfaces on the DHCPv4 server are not associated with VSRP instances.

Views

Layer 3 Ethernet interface/subinterface view

Layer 3 aggregate interface/subinterface view

Layer 3 RPR logical interface view

Predefined user roles

network-admin

mdc-admin

Parameters

vsrp-instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

You can specify a nonexistent VSRP instance for this command, but this command takes effect only after the VSRP instance is created.

Use this command on the master and backup DHCPv4 servers to match their interfaces that connect to the same client.

You can associate an interface or subinterface with only one VSRP instance.

You can associate a VSRP instance with one interface or multiple subinterfaces on the same interface.

If a VSRP instance has been associated with one interface, you must remove the VSRP instance from that interface before you can specify it on another interface.

Examples

# Associate GigabitEthernet 1/0/1 with VSRP instance vsrp1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] dhcp vsrp-instance vsrp1

VSRP commands -- DHCP VSRP commands -- ipv6 dhcp vsrp port

Use ipv6 dhcp vsrp port to specify a TCP port number for VSRP to establish data channels for DHCPv6 server or relay agent service backup.

Use undo ipv6 dhcp vsrp port to restore the default.

Syntax

ipv6 dhcp vsrp port port-number

undo ipv6 dhcp vsrp port

Default

TCP port 60039 is used to establish data channels for DHCPv6 server or relay agent service backup.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

port-number: Specifies a TCP port number in the range of 1 to 65535. The specified port number cannot be one that is in use.

Usage guidelines

To back up data for a DHCPv6 address pool, the master DHCPv6 server must establish a TCP data channel with the backup DHCPv6 server.

To back up DHCPv6 relay agent data for a client-side interface, the master DHCPv6 relay agent must establish a TCP data channel with the backup DHCPv6 relay agent.

You can use this command to change the TCP port number for establishing the data channel.

Examples

# Specify TCP port 30000 for VSRP to establish data channels for DHCPv6 server or relay agent service backup.

<Sysname> system-view

[Sysname] ipv6 dhcp vsrp port 30000

VSRP commands -- DHCP VSRP commands -- ipv6 dhcp vsrp-instance

Use ipv6 dhcp vsrp-instance to associate a client-side interface on the DHCPv6 server with a VSRP instance.

Use undo ipv6 dhcp vsrp-instance to remove the VSRP instance association.

Syntax

ipv6 dhcp vsrp-instance vsrp-instance-name

undo ipv6 dhcp vsrp-instance

Default

The client-side interfaces on the DHCPv6 server are not associated with VSRP instances.

Views

Layer 3 Ethernet interface/subinterface view

Layer 3 aggregate interface/subinterface view

Layer 3 RPR logical interface view

Predefined user roles

network-admin

mdc-admin

Parameters

vsrp-instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

You can specify a nonexistent VSRP instance for this command, but this command takes effect only after the VSRP instance is created.

Use this command on the master and backup DHCPv6 servers to match their interfaces that connect to the same client.

You can associate an interface or subinterface with only one VSRP instance.

You can associate a VSRP instance with one interface or multiple subinterfaces on the same interface.

If a VSRP instance has been associated with one interface, you must remove the VSRP instance from that interface before you can specify it on another interface.

Examples

# Associate GigabitEthernet 1/0/1 with VSRP instance vsrp1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] ipv6 dhcp vsrp-instance vsrp1

VSRP commands -- DHCP VSRP commands -- virtual-duid

Use virtual-duid to generate a virtual DUID for a DHCPv6 server.

Use undo virtual-duid to restore the default.

Syntax

virtual-duid { enterprise-number enterprise-number identifier identifier | hardware-type hardware-type address address }

undo virtual-duid

Default

No virtual DUID is generated for a DHCPv6 server.

Views

DHCPv6 address pool view

Predefined user role

network-admin

mdc-admin

Parameters

enterprise-number enterprise-number: Specifies a registered private enterprise number. The value range for the enterprise-number argument is 0 to FFFFFFFF in hexadecimal format.

identifier identifier: Specifies a device identifier in hexadecimal format. The number of hexadecimal digits must be an even number between 2 and 128.

hardware-type hardware-type: Specifies the hardware type, a hexadecimal number in the range of 0 to FFFF.

address address: Specifies a link layer address in hexadecimal format. The number of hexadecimal digits must be an even number between 2 to 128.

Usage guidelines

By default, the master and backup DHCPv6 servers use their respective DUIDs for DHCP communication. For DHCPv6 clients to correctly renew leases or release IPv6 addresses after a switchover, use this command to generate the same virtual DUID for the master and the backup.

Examples

# Configure DHCPv6 address pool pool1 to use the virtual DUID generated based on enterprise number 1 and identifier 1234.

<Sysname> system-view

[Sysname] ipv6 dhcp pool pool1

[Sysname-dhcp6-pool-pool1] virtual-duid enterprise-number 1 identifier 1234

VSRP commands -- DHCP VSRP commands -- vsrp-instance (DHCPv4/DHCPv6 address pool view)

Use vsrp-instance to associate a DHCPv4 or DHCPv6 address pool with a VSRP instance.

Use undo vsrp-instance to remove the VSRP instance association.

Syntax

vsrp-instance vsrp-instance-name

undo vsrp-instance

Default

A DHCPv4 or DHCPv6 address pool is not associated with a VSRP instance.

Views

DHCPv4 or DHCPv6 address pool view

Predefined user roles

network-admin

mdc-admin

Parameters

vsrp-instance-name: Specifies a VSRP instance by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

When you execute this command, the master and backup DHCPv4 or DHCPv6 servers establish a data channel to back up address pool data.

You can specify a nonexistent VSRP instance, but this command takes effect only when the specified VSRP instance exists.

Examples

# Associate DHCPv4 address pool p1 with VSRP instance vsrp1.

<Sysname> system-view

[Sysname] dhcp server ip-pool p1

[Sysname-dhcp-pool-p1] vsrp-instance vsrp1

# Associate DHCPv6 address pool p1 with VSRP instance vsrp1.

<Sysname> system-view

[Sysname] ipv6 dhcp pool p1

[Sysname-dhcp6-pool-p1] vsrp-instance vsrp1