16-High Availability Command Reference

HomeSupportReference GuidesCommand ReferencesH3C MSR Router Series Comware 7 Command References-R0615-6W20316-High Availability Command Reference
Table of Contents
Related Documents
01-Text
Title Size Download
01-Text 803.46 KB

Contents

Interface backup commands· 1

backup interface· 1

backup threshold· 2

backup timer delay· 3

backup timer flow-check· 4

backup track· 5

display interface-backup state· 6

display interface-backup statistics· 7

CFD commands· 10

cfd ais enable· 10

cfd ais level 10

cfd ais period· 11

cfd cc enable· 12

cfd cc interval 13

cfd dm one-way· 13

cfd dm two-way· 14

cfd dm two-way continual 15

cfd dm two-way threshold· 17

cfd enable· 18

cfd hardware-cc· 18

cfd linktrace· 19

cfd linktrace auto-detection· 20

cfd loopback· 20

cfd md· 22

cfd mep· 23

cfd meplist 24

cfd port-trigger 25

cfd mip-rule· 27

cfd service-instance· 27

cfd slm·· 29

cfd slm continual 30

cfd slm port-trigger up-delay· 31

cfd slm threshold· 33

cfd tst 34

cfd tst continual 35

cfd tst threshold· 36

display cfd ais· 37

display cfd dm one-way history· 38

display cfd dm two-way history· 40

display cfd linktrace-reply· 41

display cfd linktrace-reply auto-detection· 43

display cfd md· 44

display cfd mep· 45

display cfd meplist 49

display cfd mp· 49

display cfd remote-mep· 50

display cfd service-instance· 51

display cfd slm history· 52

display cfd status· 54

display cfd tst history· 54

reset cfd dm one-way history· 56

reset cfd tst 56

BFD commands· 58

bfd authentication-mode· 58

bfd demand enable· 59

bfd detect-interface· 59

bfd detect-multiplier 60

bfd echo enable· 61

bfd echo-source-ip· 62

bfd echo-source-ipv6· 62

bfd init-fail timer 63

bfd min-echo-receive-interval 64

bfd min-receive-interval 65

bfd min-transmit-interval 66

bfd multi-hop authentication-mode· 68

bfd multi-hop destination-port 68

bfd multi-hop detect-multiplier 69

bfd multi-hop min-receive-interval 70

bfd multi-hop min-transmit-interval 71

bfd session init-mode· 72

bfd template· 73

display bfd session· 73

reset bfd session statistics· 76

snmp-agent trap enable bfd· 76

Track commands· 78

delay· 78

display track· 79

object 83

threshold percentage· 84

threshold weight 84

track bfd· 85

track interface· 86

track interface physical 87

track interface protocol 88

track ip route reachability· 89

track list boolean· 90

track list threshold percentage· 91

track list threshold weight 92

track nqa· 93

VRRP commands· 94

IPv4 VRRP commands· 94

display vrrp· 94

display vrrp statistics· 101

reset vrrp statistics· 104

snmp-agent trap enable vrrp· 104

vrrp check-ttl enable· 105

vrrp dscp· 106

vrrp mode· 106

vrrp version· 107

vrrp vrid· 108

vrrp vrid authentication-mode· 109

vrrp vrid preempt-mode· 110

vrrp vrid priority· 111

vrrp vrid shutdown· 112

vrrp vrid source-interface· 112

vrrp vrid timer advertise· 113

vrrp vrid track· 114

IPv6 VRRP commands· 116

display vrrp ipv6· 116

display vrrp ipv6 statistics· 123

reset vrrp ipv6 statistics· 126

vrrp ipv6 dscp· 126

vrrp ipv6 mode· 127

vrrp ipv6 vrid· 128

vrrp ipv6 vrid preempt-mode· 129

vrrp ipv6 vrid priority· 130

vrrp ipv6 vrid shutdown· 130

vrrp ipv6 vrid timer advertise· 131

vrrp ipv6 vrid track· 132

Process placement commands· 135

affinity location-set 136

affinity location-type· 137

affinity program·· 138

affinity self 138

display ha service-group· 139

display placement location· 142

display placement policy· 144

display placement program·· 145

display placement reoptimize· 146

placement program·· 147

placement reoptimize· 148

DLDP commands· 151

display dldp· 151

display dldp statistics· 152

dldp authentication-mode· 153

dldp authentication-password· 154

dldp delaydown-timer 155

dldp enable· 156

dldp global enable· 156

dldp interval 157

dldp unidirectional-shutdown· 158

reset dldp statistics· 158

Index· 160

 


Interface backup commands

backup interface

Use backup interface to specify a backup interface for an interface.

Use undo backup interface to remove a backup interface.

Syntax

backup interface interface-type interface-number [ priority ]

undo backup interface interface-type interface-number

Default

An interface does not have backup interfaces.

Views

Interface view

Predefined user roles

network-admin

Parameters

interface-type interface-number: Specifies a backup interface by its type and number.

priority: Assigns a priority to the backup interface. The value range is 0 to 255, and the default is 0. The greater the value, the higher the priority.

Usage guidelines

Use this command on the primary interface to specify its backup interfaces. If you also configure the traffic thresholds, the primary and backup interfaces operate in load balancing mode. If you do not configure the traffic thresholds, the primary and backup interfaces operate in strict active/standby mode.

Backup interface priority is used for interface backup to make interface activation or deactivation decisions when the primary interface fails or is overloaded. Backup interfaces are activated in descending order of priority, with the highest-priority interface deactivated first. In contrast, they are deactivated in ascending order of priority, with the lowest-priority interface deactivated first.

Once a backup interface is activated to forward traffic, only the primary interface can preempt it. A higher-priority backup interface cannot preempt a lower-priority backup interface that has taken over the primary interface.

Use Table 1 when you configure primary and backup interfaces.

Table 1 Restrictions on the primary and backup interfaces

Item

Restrictions

Maximum number of primary interfaces/device

10.

Backup interfaces/primary interface

3.

Configuration restrictions

·     An interface can only be the backup of one interface.

·     A primary interface cannot be configured as a backup interface at the same time.

·     A main interface and its subinterfaces cannot be the backup of each other.

·     The primary and backup interfaces cannot be members of a logical link. For example, they cannot be members of a Layer 3 aggregation group.

 

This command and the backup track command are mutually exclusive.

·     If you have configured the backup interface command on the primary interface, you cannot configure the backup track command on the primary or backup interface.

·     If you have associated a backup interface with a track entry, you cannot configure the backup interface command on it or specify it as a backup interface by using the backup interface command.

Examples

# Specify GigabitEthernet 1/0/2 as a backup interface of GigabitEthernet 1/0/1, with a priority of 50.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] backup interface gigabitethernet 1/0/2 50

Related commands

backup track

backup threshold

Use backup threshold to configure traffic thresholds on a primary interface for load sharing.

Use undo backup threshold to restore the default.

Syntax

backup threshold upper-threshold lower-threshold

undo backup threshold

Default

No traffic thresholds are configured.

Views

Interface view

Predefined user roles

network-admin

Parameters

upper-threshold: Specifies the upper threshold as a percentage of bandwidth available on the primary interface. The value range is 1 to 99.

lower-threshold: Specifies the lower threshold as a percentage of bandwidth available on the primary interface. The value range is 1 to 99.

 

 

NOTE:

To set the bandwidth used for load sharing calculation in this command, use the bandwidth command on the primary interface.

 

Usage guidelines

Before you can use this command on an interface, you must specify a minimum of one backup interface for the interface.

This command enables a primary interface and its backup interfaces to be load shared. In load sharing mode, interface backup regularly compares the amount of traffic with the thresholds.

·     When the amount of traffic on the primary interface exceeds the upper threshold, the backup interfaces are activated to share load in descending order of backup priority.

·     When the total amount of traffic on all the load-shared interfaces drops below the lower threshold, the backup interfaces are deactivated in ascending order of priority. To prevent link flapping from causing frequent interface switchovers, configure the lower threshold smaller than half of the upper threshold as a best practice.

·     When the primary interface goes down, the active/standby mode applies. Only the highest-priority interface is activated.

You can configure the traffic polling interval by using the backup timer flow-check command.

 

 

NOTE:

·     "Traffic" on an interface refers to the amount of incoming or outgoing traffic, whichever is higher.

·     If two backup interfaces have the same priority, the one configured first has preference.

 

Examples

# On GigabitEthernet 1/0/1, set the upper and lower traffic thresholds to 80 and 20, respectively.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] backup threshold 80 20

Related commands

backup interface

backup timer flow-check

backup timer delay

Use backup timer delay to set interface state switchover delay timers on a primary interface.

Use undo backup timer delay to restore the default.

Syntax

backup timer delay up-delay down-delay

undo backup timer delay

Default

Both up and down delay timers are 5 seconds.

Views

Interface view

Predefined user roles

network-admin

Parameters

up-delay: Specifies the number of seconds that the primary or backup interface must wait before it can come up. The value range is 1 to 65535 seconds.

down-delay: Specifies the number of seconds that the active primary or backup interface must wait before it is set to down state. The value range is 1 to 65535 seconds.

Usage guidelines

Before you can use this command on an interface, you must specify a minimum of one backup interface for the interface.

The switchover delay mechanism prevents link flapping from causing frequent interface switchovers. When the link of the active interface fails, the interface state does not change immediately. Instead, a down delay timer starts. If the link recovers before the timer expires, the interface state does not change. If the link is still down when the timer expires, the interface state changes to down.

Examples

# Specify GigabitEthernet 1/0/2 as a backup of GigabitEthernet 1/0/1, and set both up and down delay timers to 10 seconds.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] backup interface gigabitethernet 1/0/2

[Sysname-GigabitEthernet1/0/1] backup timer delay 10 10

Related commands

backup interface

backup timer flow-check

Use backup timer flow-check to configure the traffic polling interval on a primary interface.

Use undo backup timer flow-check to restore the default.

Syntax

backup timer flow-check interval

undo backup timer flow-check

Default

The traffic polling interval is 30 seconds.

Views

Interface view

Predefined user roles

network-admin

Parameters

interval: Specifies a traffic polling interval in the range of 30 to 600 seconds.

Usage guidelines

Before you can use this command on an interface, you must specify a minimum of one backup interface for the interface.

This command takes effect when the primary and backup interfaces operate in load sharing mode. Interface backup compares the amount of traffic with the thresholds at this interval to determine whether to activate or deactivate a backup interface.

Examples

# Set the traffic polling interval to 60 seconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] backup timer flow-check 60

Related commands

backup interface

backup track

Use backup track to associate a backup interface with a track entry.

Use undo backup track to restore the default.

Syntax

backup track track-entry-number

undo backup track

Default

An interface is not associated with a track entry.

Views

Interface view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

To change the state of a backup interface response to the link state of the primary interface, use this command. For the setting to work, you must configure the track entry to monitor the state of the primary link. For more information about configuring a track entry, see High Availability Configuration Guide.

You can associate an interface with only one track entry. If you execute this command multiple times, the most recent configuration takes effect.

You can create the associated track entry before or after the association. The association takes effect after the track entry is created.

To maintain performance, limit the number of associations to 64.

This command and the backup interface command are mutually exclusive.

·     If you have configured the backup interface command on the primary interface, you cannot configure the backup track command on the primary or backup interface.

·     If you have associated a backup interface with a track entry, you cannot configure the backup interface command on it or specify it as a backup interface by using the backup interface command.

Examples

# Associate GigabitEthernet 1/0/1 with track entry 1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] backup track 1

Related commands

backup interface

display interface-backup state

Use display interface-backup state to display state information for primary and backup interfaces.

Syntax

display interface-backup state

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display state information for primary and backup interfaces.

<Sysname> display interface-backup state

Interface: GE1/0/1

  UpDelay: 10 s

  DownDelay: 5 s

  State: UP

  Backup interfaces:

    GE1/0/2            Priority: 30   State: STANDBY

    GE1/0/3            Priority: 20   State: STANDBY

 

Interface: GE1/0/5

  UpDelay: 10 s

  DownDelay: 5 s

  Upper threshold: 80

  Lower threshold: 20

State: DOWN

  Backup interfaces:

    GE1/0/6            Priority: 30   State: UP_DELAY

    GE1/0/7            Priority: 20   State: STANDBY

 

IB Track Information:

  GE1/0/4             Track: 1  State: STANDBY

  GE1/0/8             Track: 2  State: UP

Table 2 Command output

Field

Description

Interface

Name of the primary interface.

UpDelay

The number of seconds that elapse after the primary interface goes down before the backup interface is activated.

DownDelay

The number of seconds that elapse after the primary interface comes up before the backup interface is deactivated.

Upper threshold

The upper traffic threshold specified as a percentage of bandwidth available on the primary interface.

When the traffic on the primary interface exceeds the upper threshold, the backup interfaces are activated to share load in descending order of backup priority.

Lower threshold

The lower traffic threshold specified as a percentage of bandwidth available on the primary interface.

When the total amount of traffic on all the load-shared interfaces drops below the lower threshold, the backup interfaces are deactivated in ascending order of priority.

State

State of the primary interface:

·     UP—The interface is operating correctly.

·     DOWN—The interface is down and cannot forward traffic.

·     UP_DELAY—The interface has recovered, and it is waiting to preempt the active backup interface.

·     DOWN_DELAY—The interface has failed, and it is waiting to be taken over by a backup interface. During this period, packet loss occurs on the primary interface.

The interface can forward traffic only when it is in UP state.

Backup interfaces

Backup interfaces assigned to the primary interface.

Priority

Priority of the backup interface.

State

State of the backup interface:

·     UP—The interface has taken over the primary interface to forward traffic.

·     DOWN—The interface is down and cannot forward traffic.

·     UP_DELAY—The backup interface is waiting to take over the primary interface.

·     DOWN_DELAY—The interface is waiting to be preempted by the primary interface that has recovered.

·     STANDBY—The interface is on standby while the primary interface is operating correctly.

The interface can forward traffic only when it is in UP state.

IB Track Information

Associations of backup interfaces and track entries.

GE1/0/4

Backup interface. In this sample output, GE 1/0/4 is a backup interface.

Track

Track entry ID associated with the backup interface.

State

State of the backup interface associated with a track entry:

·     INVALID—The backup role of the interface has not taken effect, for example, because the track entry has not been created.

·     UP—The interface has taken over forwarding traffic.

·     DOWN—The backup interface is down and cannot forward traffic.

·     STANDBY—The backup interface is on standby while the primary link is operating correctly.

 

display interface-backup statistics

Use display interface-backup statistics to display traffic statistics for load-shared interfaces.

Syntax

display interface-backup statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display traffic statistics for load-shared interfaces.

<Sysname> display interface-backup statistics

Interface: GigabitEthernet1/0/2

  Statistics interval: 30 s

  Bandwidth: 100000000 bps

  ActiveTotalIn: 102 bytes

  ActiveTotalOut: 108 bytes

  ActiveIntervalIn: 102 bytes

  ActiveIntervalOut: 108 bytes

  Active used bandwidth: 28 bps

  TotalIn: 102 bytes

  TotalOut: 108 bytes

  TotalIntervalIn: 102 bytes

  TotalIntervalOut: 108 bytes

  Total used bandwidth: 28 bps

Table 3 Command output

Field

Description

Interface

Name of the primary interface.

Statistics interval

Traffic polling interval, in seconds.

Bandwidth

Expected bandwidth (in bps) of the primary interface. This bandwidth is used for load sharing computation. You can use the bandwidth command in interface view to set its value.

PrimaryTotalIn

Cumulative sum of incoming bytes on the primary interface at the most recent traffic polling.

PrimaryTotalOut

Cumulative sum of outgoing bytes on the primary interface at the most recent traffic polling.

PrimaryIntervalIn

Number of incoming bytes on the primary interface for the most recent polling interval.

PrimaryIntervalOut

Number of outgoing bytes on the primary interface for the most recent polling interval.

Primary used bandwidth

The primary interface's used bandwidth that was counted in load sharing computation.

TotalIn

Cumulative sum of incoming bytes on the load-shared primary and backup interfaces at the most recent traffic polling.

TotalOut

Cumulative sum of outgoing bytes on the load-shared primary and backup interfaces at the most recent traffic polling.

TotalIntervalIn

Number of incoming bytes on the load-shared primary and backup interfaces for the most recent polling interval.

TotalIntervalOut

Number of outgoing bytes on the load-shared primary and backup interfaces for the most recent polling interval.

Total used bandwidth

Total used bandwidth (in bps) of the load-shared primary and backup interfaces for the most recent polling interval.

 


CFD commands

cfd ais enable

Use cfd ais enable to enable AIS.

Use undo cfd ais enable to disable AIS.

Syntax

cfd ais enable

undo cfd ais enable

Default

AIS is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

This command takes effect only in Ethernet networks.

Examples

# Enable AIS.

<Sysname> system-view

[Sysname] cfd ais enable

Related commands

cfd ais level

cfd ais period

cfd ais level

Use cfd ais level to configure the AIS frame transmission level.

Use undo cfd ais level to remove the AIS frame transmission level.

Syntax

cfd ais level level-value service-instance instance-id

undo cfd ais level level-value service-instance instance-id

Default

The AIS frame transmission level is not configured.

Views

System view

Predefined user roles

network-admin

Parameters

level level-value: Specifies the AIS frame transmission level in the range of 1 to 7.

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

Usage guidelines

If no AIS frame transmission level is configured for a service instance, the MEPs in the service instance cannot send AIS frames.

This command can be configured only in Ethernet networks. You cannot specify a Layer 2 VPN service instance for the service-instance instance-id option.

Examples

# Configure the AIS frame transmission level as 3 in service instance 1.

<Sysname> system-view

[Sysname] cfd ais level 3 service-instance 1

Related commands

cfd ais enable

cfd ais period

cfd ais period

Use cfd ais period to configure the AIS frame transmission period.

Use undo cfd ais period to remove the AIS frame transmission period.

Syntax

cfd ais period period-value service-instance instance-id

undo cfd ais period period-value service-instance instance-id

Default

The AIS frame transmission period is 1 second.

Views

System view

Predefined user roles

network-admin

Parameters

period period-value: Specifies the AIS frame transmission period in the range of 1 to 60 seconds.

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

Usage guidelines

This command can be configured only in Ethernet networks. You cannot specify a Layer 2 VPN service instance for the service-instance instance-id option.

Examples

# Configure the AIS frame transmission period as 60 seconds in service instance 1.

<Sysname> system-view

[Sysname] cfd ais period 60 service-instance 1

Related commands

cfd ais enable

cfd ais level

cfd cc enable

Use cfd cc enable to enable CCM sending on a MEP.

Use undo cfd cc enable to disable CCM sending on a MEP.

Syntax

cfd cc service-instance instance-id mep mep-id enable

undo cfd cc service-instance instance-id mep mep-id enable

Default

The CCM sending feature is disabled.

Views

Layer 2/Layer 3 Ethernet interface view

Layer 2 aggregate interface view

Layer 3 Ethernet subinterface view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies the service instance ID in the range of 1 to 32767.

mep mep-id: Specifies a MEP by its ID in the range of 1 to 8191.

Usage guidelines

Follow these guidelines when you use the command:

·     Configurations in Ethernet interface view take effect only on the current interface.

·     Configurations in aggregate interface view take effect only on the aggregate interface.

·     If the MEP belongs to an MA that does not carry VLAN attribute, configurations on a member port of an aggregate interface take effect only on the member port.

·     If the MEP belongs to an MA that carries VLAN attribute, configurations on a member port of an aggregate interface take effect only when the member port leaves the aggregation group.

In an Ethernet network, you can enable CCM sending only on Layer 2/Layer 3 Ethernet interfaces and Layer 2 aggregate interfaces.

In an MPLS Layer 2 VPN, you can enable CCM sending only on Layer 3 Ethernet subinterfaces.

Examples

# On GigabitEthernet 1/0/1, enable CCM sending on MEP 3 in service instance 5.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] cfd cc service-instance 5 mep 3 enable

# On GigabitEthernet 1/0/1.1, enable CCM sending on MEP 3 in service instance 5.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1.1

[Sysname-GigabitEthernet1/0/1.1] cfd cc service-instance 5 mep 3 enable

Related commands

cfd cc interval

cfd cc interval

Use cfd cc interval to set the value of the interval field in the CCM messages.

Use undo cfd cc interval to remove the value of the interval field in the CCM messages.

Syntax

cfd cc interval interval-value service-instance instance-id

undo cfd cc interval [ interval-value ] service-instance instance-id

Default

The value of this field is 4 for all CCMs sent.

Views

System view

Predefined user roles

network-admin

Parameters

interval interval-value: Specifies the value of the interval field in CCM messages, in the range of 1 to 7.

service-instance instance-id: Specifies the service instance ID in the range of 1 to 32767.

Usage guidelines

When setting the CCM interval, use the settings described in Table 4.

Table 4 CCM interval field encoding

CCM interval field

Transmission interval

Maximum CCM lifetime

1

10/3 milliseconds

35/3 milliseconds

2

10 milliseconds

35 milliseconds

3

100 milliseconds

350 milliseconds

4

1 second

3.5 seconds

5

10 seconds

35 seconds

6

60 seconds

210 seconds

7

600 seconds

2100 seconds

 

Examples

# Set the value of the interval field to 7 in CCMs sent by MEPs in service instance 2.

<Sysname> system-view

[Sysname] cfd cc interval 7 service-instance 2

Related commands

cfd cc enable

cfd dm one-way

Use cfd dm one-way to enable one-way delay measurement (DM).

Syntax

cfd dm one-way service-instance instance-id mep mep-id { target-mac mac-address | target-mep target-mep-id } [ number number ]

Views

Any view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

mep mep-id: Specifies the source MEP by its ID in the range of 1 to 8191.

target-mac mac-address: Specifies the target MEP by its MAC address in the format of H-H-H.

target-mep target-mep-id: Specifies the target MEP by its ID in the range of 1 to 8191.

number number: Specifies the number of 1DM frames sent. The value range for the number argument is 2 to 10, and the default is 5.

Usage guidelines

The one-way DM function measures the one-way frame delay between the source and target MEPs by using 1DM frames.

To view the one-way delay test result, use the display cfd dm one-way history command on the target MEP.

This command can be configured only in Ethernet networks. You cannot specify a Layer 2 VPN service instance for the service-instance instance-id option.

Examples

# Enable the one-way DM function to test the one-way frame delay from source MEP 1101 to target MEP 1003 in service instance 1.

<Sysname> cfd dm one-way service-instance 1 mep 1101 target-mep 1003

5 1DMs have been sent. Please check the result on the remote device.

Related commands

display cfd dm one-way history

reset cfd dm one-way history

cfd dm two-way

Use cfd dm two-way to configure short-period two-way DM.

Syntax

cfd dm two-way service-instance instance-id mep mep-id { target-mac mac-address | target-mep target-mep-id } [ dot1p dot1p-value ] [ number number ] [ interval interval ]

Views

Any view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

mep mep-id: Specifies the source MEP by its ID in the range of 1 to 8191.

target-mac mac-address: Specifies the target MEP by its MAC address, which is in the format of H-H-H.

target-mep target-mep-id: Specifies the target MEP by its ID in the range of 1 to 8191.

dot1p dot1p-value: Specifies the 802.1p priority of DMM frames to be sent. The value range for the dot1p-value argument is 0 to 7, and the default is 7.

number number: Specifies the number of DMM frames to be sent. The value range for the number argument is 2 to 10, and the default is 5.

interval interval: Specifies the interval for sending DMM frames. The value for the interval argument can be 1 or 10 seconds, and the default is 1.

Usage guidelines

Short-period two-way DM sends a configurable number of DMM frames at a configuration interval. It measures the two-way frame delay between the source and target MEPs after receiving DMR frames.

Short-period and continual two-way DM cannot be configured at the same time for one source MEP. If you have configured continual two-way DM, you can configure short-period two-way DM only after you disable continual two-way DM. If you have configured short-period two-way DM, you can configure continual two-way DM only after the short-period two-way DM ends.

Examples

# Configure short-period two-way DM to test the two-way frame delay between source MEP 1101 and target MEP 2001 in service instance 1.

<Sysname> cfd dm two-way service-instance 1 mep 1101 target-mep 2001

Frame delay:

Reply from 0010-fc00-6512: 10us

Reply from 0010-fc00-6512: 9us

Reply from 0010-fc00-6512: 11us

Reply from 0010-fc00-6512: 5us

Reply from 0010-fc00-6512: 5us

Average: 8us

Sent DMMs: 5        Received: 5        Lost: 0

 

Frame delay variation: 1us 2us 6us 0us

Average: 2us

Table 5 Command output

Field

Description

Reply from 0010-fc00-6512

Delay of the DMR frames returned from the MEP with MAC address 0010-FC00-6512.

Average

Average frame delay or average frame delay variation.

Sent DMMs

Number of sent DMM frames .

Received

Number of received DMR frames.

Lost

Number of lost DMM frames.

 

cfd dm two-way continual

Use cfd dm two-way continual to configure continual two-way DM.

Use undo cfd dm two-way continual to disable continual two-way DM.

Syntax

cfd dm two-way continual service-instance instance-id mep mep-id { target-mac mac-address | target-mep target-mep-id } [ dot1p dot1p-value ] [ interval interval ]

undo cfd dm two-way continual service-instance instance-id mep mep-id

Default

Continual two-way DM is not configured.

Views

System view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

mep mep-id: Specifies the source MEP by its ID in the range of 1 to 8191.

target-mac mac-address: Specifies the target MEP by its MAC address, which is in the format of H-H-H. The MAC address cannot be a MAC address of a local MEP or a non-unicast MAC address.

target-mep target-mep-id: Specifies the target MEP by its ID in the range of 1 to 8191.

dot1p dot1p-value: Specifies the 802.1p priority of DMM frames to be sent. The value range for the dot1p-value argument is 0 to 7, and the default is 7. The larger the value, the higher the priority.

interval interval: Specifies the interval for sending DMM frames. The value for the interval argument can be 1 or 10 seconds, and the default is 1.

Usage guidelines

Continual two-way DM continually sends DMM frames at a configurable interval. It measures the two-way frame delay between the source and target MEPs after receiving the returned DMR frames.

If the device supports hardware CC, you can only specify the target MEP by its MAC address. You cannot specify the target MEP by its ID.

To modify continual two-way DM settings for a source MEP, disable continual two-way DM and then reconfigure the function for the source MEP.

Short-period and continual two-way DM cannot be configured at the same time for one source MEP. If you have configured continual two-way DM, you can configure short-period two-way DM only after you disable continual two-way DM. If you have configured short-period two-way DM, you can configure continual two-way DM only after the short-period two-way DM ends.

To display the continual two-way DM result, use the display cfd dm two-way history command on the device where the source MEP resides.

The cfd dm two-way continual command can be configured only in Ethernet networks.

Examples

# Configure continual two-way DM to test the two-way frame delay between source MEP 1101 and target MEP 2001 in service instance 1.

<Sysname> system-view

[Sysname] cfd dm two-way continual service-instance 1 mep 1101 target-mep 2001

Related commands

cfd dm two-way

cfd dm two-way threshold

display cfd dm two-way history

cfd dm two-way threshold

Use cfd dm two-way threshold to configure the lower limit and upper limit for continual two-way DM.

Use undo cfd dm two-way threshold to restore the default.

Syntax

cfd dm two-way threshold service-instance instance-id mep mep-id { lower-limit lower-limit | upper-limit upper-limit } *

undo cfd dm two-way threshold service-instance instance-id mep mep-id [ lower-limit | upper-limit ]

Default

The lower limit and upper limit for continual two-way DM are 0 and 4294967295 microseconds, respectively.

Views

System view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

mep mep-id: Specifies the source MEP by its ID in the range of 1 to 8191.

lower-limit lower-limit: Specifies the lower limit in the range of 0 to 4294967295 microseconds.

upper-limit upper-limit: Specifies the upper limit in the range of 0 to 4294967295 microseconds. The lower limit must be smaller than the upper limit.

Usage guidelines

This command takes effect only after you configure continual two-way DM.

If the cfd port-trigger dm action { block | shutdown } command is configured, the following rules apply:

·     If the delay time reaches or exceeds the upper limit for three consecutive times, the port is blocked or shut down.

·     If the delay time reaches or falls below the lower limit for three consecutive times, the port is unblocked or brought up.

The cfd dm two-way threshold command can be configured only in Ethernet networks.

Examples

# Configure the continual two-way DM lower limit and upper limit as 10000 and 5000000 microseconds, respectively, for source MEP 1101 in service instance 1.

<Sysname> system-view

[Sysname] cfd dm two-way threshold service-instance 1 mep 1101 lower-limit 10000 upper-limit 5000000

Related commands

cfd dm two-way continual

cfd port-trigger

display cfd dm two-way history

cfd enable

Use cfd enable to enable CFD.

Use undo cfd enable to disable CFD.

Syntax

cfd enable

undo cfd enable

Default

CFD is disabled.

Views

System view

Predefined user roles

network-admin

Examples

# Enable CFD.

<Sysname> system-view

[Sysname] cfd enable

cfd hardware-cc

Use cfd hardware-cc to enable hardware CC.

Use undo cfd hardware-cc to disable hardware CC.

Syntax

cfd hardware-cc service-instance instance-id remote-mep mep-list

undo cfd hardware-cc service-instance instance-id remote-mep mep-list

Default

Hardware CC is disabled.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

remote-mep mep-list: Specifies remote MEPs. The mep-list argument specifies a space-separated list of up to 10 MEP items. Each item specifies a MEP ID or a range of MEP IDs in the form of mep-id [ to mep-id ]. The value range for MEP IDs is 1 to 8191.

Examples

# Enable hardware CC on GigabitEthernet 1/0/1 to detect remote MEP 5 in service instance 1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] cfd hardware-cc service-instance 1 remote-mep 5

cfd linktrace

Use cfd linktrace to identify the path between the source MEP and target MP.

Syntax

cfd linktrace service-instance instance-id mep mep-id { target-mac mac-address | target-mep target-mep-id } [ ttl ttl-value ] [ hw-only ]

Views

Any view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

mep mep-id: Specifies the source MEP by its ID in the range of 1 to 8191.

target-mac mac-address: Specifies the destination MAC address, in the format of H-H-H.

target-map target-mep-id: Specifies the destination MEP by its ID in the range of 1 to 8191.

ttl ttl-value: Specifies the TTL value in the range of 1 to 255. The default value is 64.

hw-only: Sets the hw-only bits of the LTMs sent. If you specify this keyword, the MIP does not flood LTM messages that have an unknown destination MAC address.

Usage guidelines

Linktrace identifies the path between the source MEP and target MP by sending LTM frames and receiving LTR frames.

Examples

# Identify the path between source MEP 1101 and target MEP 2001 in service instance 1.

<Sysname> cfd linktrace service-instance 1 mep 1101 target-mep 2001

Linktrace to MEP 2001 with the sequence number 1101-43361:

MAC address               TTL     Last MAC         Relay action

0010-fc00-6512            63      0010-fc00-6500   Hit

Table 6 Command output

Field

Description

Linktrace to MEP 2001 with the sequence number 1101-43361

Linktrace to target MEP 2001 with the sequence number 1101-43361.

MAC address

Source MAC address in the LTR messages.

TTL

TTL of the LTM when it passes the device.

Last MAC

MAC address of the last-hop device the LTM passes.

Relay action

Indicates whether the forwarding device found the destination MAC address in its MAC address table.

When the standard version (IEEE 802.1ag) of CFD is used:

·     Hit—The current device is the destination device.

·     FDB—The forwarding device found the destination MAC address.

·     MPDB—The destination MAC address is not found, or the destination MAC address is found in the MEP or MIP database.

 

Related commands

cfd linktrace auto-detection

display cfd linktrace-reply

cfd linktrace auto-detection

Use cfd linktrace auto-detection to enable automatic sending of LTMs.

Use undo cfd linktrace auto-detection to disable automatic sending of LTMs.

Syntax

cfd linktrace auto-detection [ size size-value ]

undo cfd linktrace auto-detection

Default

Automatic sending of LTMs is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

size size-value: Specifies the size of the buffer used to store the auto-detection result, in the range of 1 to 100 (in terms of auto-detection times). The default value is 5, which means the buffer stores the results of the recent five auto-detections.

Usage guidelines

This command enables the source MEP to send LTMs when it fails to receive CCMs from the target MEP within 3.5 times the sending interval. The destination of the LTMs is the target MEP, and the TTL field value is 255. Based on the returned LTRs, the fault source can be located on the faulty link.

If you disable automatic LTM sending, the content stored in the buffer will be removed.

The outward-facing MEP on a hardware CC-supported card does not automatically send LTMs.

Examples

# Enable automatic LTM sending, and set the size of the buffer used to store the auto-detection result to 100 (in terms of auto-detection times).

<Sysname> system-view

[Sysname] cfd linktrace auto-detection size 100

Related commands

cfd linktrace

display cfd linktrace-reply auto-detection

cfd loopback

Use cfd loopback to enable loopback (LB).

Syntax

cfd loopback service-instance instance-id mep mep-id { target-mac mac-address | target-mep target-mep-id } [ number number ]

Views

Any view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

mep mep-id: Specifies the source MEP by its ID in the range of 1 to 8191.

target-mac mac-address: Specifies the destination MAC address of the MP, in the format of H-H-H.

target-mep target-mep-id: Specifies the target MEP by its ID in the range of 1 to 8191.

number number: Specifies the number of the sent LBMs packets. The value is in the range of 1 to 10. The default value is 5.

Usage guidelines

Loopback verifies link connectivity between the source MEPand target MP by using LBMs and LBRs.

Examples

# Enable LB for the link between MEP 1101 and MEP 2001 in service instance 1 (assume that the link status is normal).

<Sysname> cfd loopback service-instance 1 mep 1101 target-mep 2001

Loopback to MEP 2001 with the sequence number start from 1101-43404:

Reply from 0010-fc00-6512: sequence number=1101-43404 Time=5ms

Reply from 0010-fc00-6512: sequence number=1101-43405 Time=5ms

Reply from 0010-fc00-6512: sequence number=1101-43406 Time=5ms

Reply from 0010-fc00-6512: sequence number=1101-43407 Time=5ms

Reply from 0010-fc00-6512: sequence number=1101-43408 Time=5ms

Sent: 5        Received: 5        Lost: 0

# Enable LB for the link between MEP 1101 and MEP 2001 in service instance 1 (assume that the link status is abnormal).

<Sysname> cfd loopback service-instance 1 mep 1101 target-mep 2001

Loopback to MEP 2001 with the sequence number start from 1101-43404:

Sent: 5        Received: 0        Lost: 5

Table 7 Command output

Field

Description

Loopback to MEP 2001 with the sequence number start from 1101-43404

Sends LBMs to MEP 2001 with the sequence number starting with 1101-43404.

Reply from 0010-fc00-6512

Reply from the MP with the MAC address 0010-FC00-6512.

sequence number

Sequence number in the LBR messages.

Time=5ms

The interval between the sending of LBMs and receiving of LBRs is 5 milliseconds.

Sent

Number of sent LBMs.

Received

Number of received LBRs.

Lost

Number of lost LBRs.

 

cfd md

Use cfd md to create an MD.

Use undo cfd md to delete an MD.

Syntax

cfd md md-name [ index index-value ] level level-value [ md-id { dns dns-name | mac mac-address subnumber | none } ]

undo cfd md md-name

Default

No MDs exist.

Views

System view

Predefined user roles

network-admin

Parameters

md md-name: Specifies the name of an MD, which is a string of 1 to 43 characters that can contain letters, numbers, and special characters such as grave accent (`), tilde (~), exclamation mark (!), at sign (@), number sign (#), dollar sign ($), percent (%), caret (^), ampersand (&), asterisk (*), brackets ({ }, ( ),[ ], < >), hyphen (-), underscore (_), plus (+), equal sign (=), vertical bar (|), colon (:), semicolon (;), quotation mark ('), comma (,), period (.), and slash (/).

index index-value: Specifies an MD index in the range of 1 to 4294967295. If you do not specify this option, the system automatically assigns the smallest index number that is not in use. As a best practice, use the index automatically assigned by the system.

level level-value: Specifies an MD level in the range of 0 to 7.

md-id: Specifies the MD name carried by packets sent by the MEP. If you do not provide this keyword, the MD name is represented by md-name.

dns dns-name: Specifies an MD name in the format of DNS name, where dns-name represents the DNS name.

mac mac-address subnumber: Specifies an MD name containing the MAC address and an integer. The mac-address argument represents the MAC address of the MD, and the subnumber argument is in the range of 0 to 65535.

none: Specifies that no MD name is carried in the packets sent by the MEP.

Usage guidelines

An MD name must be in compliant with the specifications in IEEE802.1ag-2007.

You can create only one MD with a specific level. MD cannot be created if you enter an invalid MD name or an existing MD name or the MD index is in use.

When deleting an MD, you will also delete the configurations related to that MD.

Examples

# Create an MD named test_md1, with its level being 3.

<Sysname> system-view

[Sysname] cfd md test_md1 level 3

# Create an MD named test_md2, and the MD name carried in the packet sent by the MEP comprises the MAC address 1-1-1 and integer 1.

<Sysname> system-view

[Sysname] cfd md test_md2 level 5 md-id mac 1-1-1 1

cfd mep

Use cfd mep to create a MEP.

Use undo cfd mep to delete a MEP.

Syntax

Layer 2 Ethernet interface view or Layer 2 aggregate interface view:

cfd mep mep-id service-instance instance-id { inbound | outbound }

undo cfd mep mep-id service-instance instance-id

Layer 3 Ethernet interface view:

cfd mep mep-id service-instance instance-id outbound

undo cfd mep mep-id service-instance instance-id

Default

No MEPs exist.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Layer 2 aggregate interface view

Predefined user roles

network-admin

Parameters

mep mep-id: Specifies the MEP ID, in the range of 1 to 8191.

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

inbound: Creates an inward-facing MEP.

outbound: Creates an outward-facing MEP.

Usage guidelines

In creating a MEP, the service instance you specified defines the MD and MA to which the MEP belongs.

You cannot create a MEP if the MEP ID is not included in the MEP list of the relevant service instance.

Follow these guidelines when you use the command:

·     Configurations in Ethernet interface view take effect only on the current interface.

·     Configurations in aggregate interface view take effect only on the aggregate interface.

·     If the MEP belongs to an MA that does not carry the VLAN attribute, configurations on a member port of an aggregate interface take effect only on the member port.

·     If the MEP belongs to an MA that carries the VLAN attribute, configurations on a member port of an aggregate interface take effect only when the member port leaves the aggregation group.

Examples

# In an Ethernet network, configure a MEP list in service instance 5, and create inward-facing MEP 3 in service instance 5 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] cfd md test_md level 3

[Sysname] cfd service-instance 5 ma-id vlan-based md test_md vlan 100

[Sysname] cfd meplist 3 service-instance 5

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] cfd mep 3 service-instance 5 outbound

Related commands

cfd meplist

cfd meplist

Use cfd meplist to create a MEP list. A MEP list is a collection of local MEPs allowed to be configured and the remote MEPs to be monitored in the same MA.

Use undo cfd meplist to delete a MEP list.

Syntax

cfd meplist mep-list service-instance instance-id

undo cfd meplist mep-list service-instance instance-id

Default

No MEP list is created.

Views

System view

Predefined user roles

network-admin

Parameters

meplist mep-list: Specifies a space-separated list of up to 10 MEP items. Each item specifies a MEP ID or a range of MEP IDs in the form of mep-id 1 to mep-id 2. The value range for the MEP ID is 1 to 8191. The ID for mep-id 2 must be equal to or greater than the ID for mep-id 1.

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

Usage guidelines

Before creating a MEP list, create the relevant MD and service instance.

After you delete a MEP list, all local MEP configurations based on this list are deleted.

Examples

# In an Ethernet network, create a MEP list that includes MEP 9 through MEP 15 in service instance 5.

<Sysname> system-view

[Sysname] cfd md test_md level 3

[Sysname] cfd service-instance 5 ma-id vlan-based md test_md vlan 100

[Sysname] cfd meplist 9 to 15 service-instance 5

Related commands

cfd md

cfd service-instance

cfd port-trigger

Use cfd port-trigger to specify the triggering event and triggered action for port collaboration.

Use undo cfd port-trigger to cancel the triggering event and triggered action for port collaboration.

Syntax

cfd port-trigger { cc-expire | dm | rdi | slm | tst } action { block | shutdown }

undo cfd port-trigger { cc-expire | dm | rdi | slm | tst } action

The following matrixes show the command and hardware compatibility:

 

Hardware

Command compatibility

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/810-LMS/810-LUS

No

MSR2600-6-X1/2600-10-X1

Yes

MSR 2630

Yes

MSR3600-28/3600-51

Yes

MSR3600-28-SI/3600-51-SI

Yes

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC

Yes

MSR 3610/3620/3620-DP/3640/3660

Yes

MSR5620/5660/5680

Yes

 

Hardware

Command compatibility

MSR810-LM-GL

No

MSR810-W-LM-GL

No

MSR830-6EI-GL

No

MSR830-10EI-GL

No

MSR830-6HI-GL

No

MSR830-10HI-GL

No

MSR2600-6-X1-GL

Yes

MSR3600-28-SI-GL

Yes

 

Default

No triggering event and triggered action are configured for port collaboration.

Views

Layer 2 Ethernet interface view

Layer 2 aggregate interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Parameters

cc-expire: Triggers port collaboration when continuity check expires.

dm: Triggers port collaboration when the link transmission delay in continual two-way DM reaches or exceeds the upper limit, or reaches or falls below the lower limit.

rdi: Triggers port collaboration when the CCMs with the RDI flag bit set are received.

slm: Triggers port collaboration when the packet loss ratio in continual LM reaches or exceeds the upper limit, or reaches or falls below the lower limit.

tst: Triggers port collaboration when the bit error ratio in continual TST reaches or exceeds the upper limit, or reaches or falls below the lower limit.

block: Blocks the port by changing its link layer protocol state to DOWN (CFD). The port cannot send or receive any data packets.

shutdown: Shuts down the port by changing its physical state to CFD DOWN. The port cannot send or receive any data packets or protocol packets.

Usage guidelines

If a port is blocked by CFD, it can automatically come up when the link recovers, except that the block action is triggered by continual LM. To bring up the port blocked in continual LM, execute the undo cfd port-trigger slm action or cfd slm port-trigger up-delay command.

If a port is shut down by CFD, it cannot automatically come up when the link recovers. To bring up the port, you must execute the undo shutdown or undo cfd port-trigger command.

You can specify multiple triggering events for an interface. All the triggering events can take effect. When you specify multiple triggered actions for a triggering event on a port, the most recent configuration takes effect.

The cfd port-trigger command takes effect only on the ports with outward-facing MEPs configured.

Examples

# Specify the triggering event as cc-expire and the triggered action as block for port collaboration on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] cfd port-trigger cc-expire action block

# Specify the triggering event as cc-expire and the triggered action as shutdown for port collaboration on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] cfd port-trigger cc-expire action shutdown

Related commands

cfd cc enable

cfd dm two-way continual

cfd dm two-way threshold

cfd mep

cfd slm continual

cfd slm threshold

cfd tst continual

cfd tst threshold

cfd mip-rule

Use cfd mip-rule to configure the rules for generating MIPs. The system automatically generates MIPs on each interface according to the rules configured.

Use undo cfd mip-rule to remove the rules for generating MIPs and the MIPs created in the specified service instance.

Syntax

cfd mip-rule { default | explicit } service-instance instance-id

undo cfd mip-rule [ default | explicit ] service-instance instance-id

Default

No rules for generating MIPs are configured and the system does not automatically generate any MIPs.

Views

System view

Predefined user roles

network-admin

Parameters

default: Specifies the default rule. If no lower-level MIP exists on an interface, a MIP is created on the current level. A MIP can be created even if no MEP is configured on the interface.

explicit: Specifies the explicit rule. If no lower-level MIP exists and a lower-level MEP exists on an interface, a MIP is created at the current level. A MIP can be created only when a lower-level MEP is created on the interface.

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

Usage guidelines

This command takes effect only in Ethernet networks.

Examples

# Configure the MIP generation rule as default in service instance 5.

<Sysname> system-view

[Sysname] cfd mip-rule default service-instance 5

cfd service-instance

Use cfd service-instance to create a service instance.

Use undo cfd service-instance to remove a service instance.

Syntax

cfd service-instance instance-id ma-id { icc-based ma-name | integer ma-num | string ma-name | vlan-based [ vlan-id ] } [ ma-index index-value ] md md-name vlan vlan-id

undo cfd service-instance instance-id

Default

No service instances exist.

Views

System view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies the service instance ID in the range of 1 to 32767.

ma-id: Creates an MA.

icc-based ma-name: Specifies that an MA is identified by an ICC. The ma-name argument is a string of 1 to 13 characters. An MD name must be compliant with the specifications in IEEE802.1ag-2007.

integer ma-num: Specifies that an MA is identified by an integer, where the ma-num argument is in the range of 0 to 65535.

string ma-name: Specifies that an MA is identified by a string, where the ma-name argument is string of 1 to 45 characters that can contain letters, numbers, and special characters such as grave accent (`), tilde (~), exclamation mark (!), at sign (@), number sign (#), dollar sign ($), percent (%), caret (^), ampersand (&), asterisk (*), brackets ({ }, ( ),[ ], < >), hyphen (-), underscore (_), plus (+), equal sign (=), vertical bar (|), colon (:), semicolon (;), quotation mark ('), comma (,), period (.), and slash (/).

vlan-based [ vlan-id ]: Specifies that an MA is identified by a VLAN ID, where the vlan-id argument is in the range of 1 to 4094. If you do not provide the vlan-id argument, the VLAN ID specified by vlan vlan-id is used. If the vlan vlan-id option is not provided, you must specify the vlan-id argument for the vlan-based [ vlan-id ] option.

ma-index index-value: Specifies an MA index in the range of 1 to 4294967295. If you do not specify this option, the system automatically assigns the smallest index number that is not in use. As a best practice, use the index automatically assigned by the system.

md md-name: Specifies the name of an MD. The md-name argument is a string of 1 to 43 characters that can contain letters, numbers, and special characters such as grave accent (`), tilde (~), exclamation mark (!), at sign (@), number sign (#), dollar sign ($), percent (%), caret (^), ampersand (&), asterisk (*), brackets ({ }, ( ),[ ], < >), hyphen (-), underscore (_), plus (+), equal sign (=), vertical bar (|), colon (:), semicolon (;), quotation mark (’), comma (,), period (.), and slash (/).

vlan vlan-id: Specifies the VLAN that the MA serves. The value range for the vlan-id argument is 1 to 4094.

Usage guidelines

You must create the relevant MD before creating a service instance with the MD name.

Deleting a service instance also deletes the configurations related to that service instance.

Deleting a service instance not only removes the connection between the service instance and the relevant MA, but also deletes the MA.

When you create a service instance in an Ethernet network, follow these restrictions and guidelines:

·     A service instance is indicated by an integer to represent an MA in an MD. An MA index uniquely identifies a specific MA in an MD. An MA index can be used in different MDs.

·     With the vlan-based [ vlan-id ] or vlan vlan-id option, the command creates an MA carrying the VLAN attribute. If you do not specify the option, the command creates an MA carrying no VLAN attribute.

Examples

# Create a level-3 MD named test_md and create service instance 5, in which the MA is identified by a VLAN and serves VLAN 100.

<Sysname> system-view

[Sysname] cfd md test_md level 3

[Sysname] cfd service-instance 5 ma-id vlan-based md test_md vlan 100

Related commands

cfd md

cfd slm

Use cfd slm to configure short-period loss measurement (LM).

Syntax

cfd slm service-instance instance-id mep mep-id { target-mac mac-address | target-mep target-mep-id } [ dot1p dot1p-value ] [ number number ] [ interval interval ]

Views

Any view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

mep mep-id: Specifies the source MEP by its ID in the range of 1 to 8191.

target-mac mac-address: Specifies the target MEP by its MAC address, which is in the format of H-H-H.

target-mep target-mep-id: Specifies the target MEP by its ID in the range of 1 to 8191.

dot1p dot1p-value: Specifies the 802.1p priority of LMM frames to be sent. The value range for the dot1p-value argument is 0 to 7, and the default is 7.

number number: Specifies the number of LMM frames to be sent. The value range for the number argument is 2 to 10, and the default is 5.

interval interval: Specifies the interval for sending LMM frames. The value for the interval argument can be 1 or 10 seconds, and the default is 1.

Usage guidelines

Short-period LM sends a configurable number of LMM frames at a configuration interval. It measures the frame loss between the source and target MEPs after receiving LMR frames.

Before configuring short-period LM in an MPLS Layer 2 VPN, you must configure the same frame counting mode on the source MEP and target MEP.

If the frame counting mode is dot1p-based, you must specify the dot1p dot1p-value option. If the frame counting mode is port-based, do not specify the dot1p dot1p-value option.

Short-period LM and continual LM cannot be configured at the same time for one source MEP. If you have configured continual LM, you can configure short-period LM only after you disable continual LM. If you have configured short-period LM, you can configure continual LM only after the short-period LM ends.

Examples

# Configure short-period LM to measure the frame loss between source MEP 1101 and target MEP 2001 in service instance 1.

<Sysname> cfd slm service-instance 1 mep 1101 target-mep 2001

Reply from 0010-fc00-6512

Far-end frame loss: 10    Near-end frame loss: 20

Reply from 0010-fc00-6512

Far-end frame loss: 40    Near-end frame loss: 40

Reply from 0010-fc00-6512

Far-end frame loss: 0     Near-end frame loss: 10

Reply from 0010-fc00-6512

Far-end frame loss: 30    Near-end frame loss: 30

 

Average

Far-end frame loss: 20    Near-end frame loss: 25

Far-end frame loss rate: 25.00%      Near-end frame loss rate: 32.00%

Sent LMMs: 5    Received: 5    Lost: 0

Table 8 Command output

Field

Description

Reply from 0010-fc00-6512

LMR frames returned from the target MEP with MAC address 0010-FC00-6512.

Far-end frame loss

Number of lost frames on the target MEP.

Near-end frame loss

Number of lost frames on the source MEP.

Far-end frame loss rate

Frame loss ratio on the target MEP.

Near-end frame loss rate

Frame loss ratio on the source MEP.

Average

Average number of lost frames.

Sent LMMs

Number of sent LMM frames.

Received

Number of received LMR frames.

Lost

Number of lost LMR frames.

 

Related commands

cfd frame-count mode

cfd slm continual

Use cfd slm continual to configure continual LM.

Use undo slm continual to disable continual LM.

Syntax

cfd slm continual service-instance instance-id mep mep-id { target-mac mac-address | target-mep target-mep-id } [ dot1p dot1p-value ] [ interval interval ]

undo cfd slm continual service-instance instance-id mep mep-id

Default

Continual LM is not configured.

Views

System view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

mep mep-id: Specifies the source MEP by its ID in the range of 1 to 8191.

target-mac mac-address: Specifies the target MEP by its MAC address, which is in the format of H-H-H. The MAC address cannot be a MAC address of a local MEP or a non-unicast MAC address.

target-mep target-mep-id: Specifies the target MEP by its ID in the range of 1 to 8191.

dot1p dot1p-value: Specifies the 802.1p priority of LMM frames to be sent. The value range for the dot1p-value argument is 0 to 7, and the default is 7. The larger the value, the higher the priority.

interval interval: Specifies the interval for sending LMM frames. The value for the interval argument can be 1 or 10 seconds, and the default is 1 second.

Usage guidelines

Continual LM continually sends LMM frames at a configurable interval. It measures the frame loss between the source and target MEPs after receiving LMR frames.

If the device supports hardware CC, you can only specify the target MEP by its MAC address. You cannot specify the target MEP by its ID.

To modify continual LM settings for a source MEP, disable continual LM and then reconfigure the function for the source MEP.

Short-period LM and continual LM cannot be configured at the same time for one source MEP. If you have configured continual LM, you can configure short-period LM only after you disable continual LM. If you have configured short-period LM, you can configure continual LM only after the short-period LM ends.

To display the continual LM result, use the display cfd slm history command on the device where the source MEP resides.

The cfd slm continual command can be configured only in Ethernet networks.

Examples

# Configure continual LM to measure the frame loss between source MEP 1101 and target MEP 2001 in service instance 1.

<Sysname> system-view

[Sysname] cfd slm continual service-instance 1 mep 1101 target-mep 2001

Related commands

cfd slm

cfd slm threshold

display cfd slm history

cfd slm port-trigger up-delay

Use cfd slm port-trigger up-delay to enable automatic port recovery for continual LM and set the delay time for automatic recovery.

Use undo slm port-trigger up-delay to restore the default.

Syntax

cfd slm port-trigger up-delay delay

undo cfd slm port-trigger up-delay

Default

A port blocked in continual LM cannot come up automatically. The undo cfd port-trigger slm action command is required to bring up the port.

Views

System view

Predefined user roles

network-admin

Parameters

delay: Specifies the delay time for automatic recovery, in the range of 10 to 300 minutes.

Usage guidelines

The following matrix shows the command and hardware compatibility:

 

Hardware

Command compatibility

 

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/810-LMS/810-LUS

No

 

MSR2600-6-X1/2600-10-X1

Yes

 

MSR 2630

Yes

MSR3600-28/3600-51

Yes

MSR3600-28-SI/3600-51-SI

Yes

MSR 3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC

Yes

MSR 3610/3620/3620-DP/3640/3660

Yes

MSR 5620/5660/5680

Yes

 

Hardware

Command compatibility

MSR810-LM-GL

No

MSR810-W-LM-GL

No

MSR830-6EI-GL

No

MSR830-10EI-GL

No

MSR830-6HI-GL

No

MSR830-10HI-GL

No

MSR2600-6-X1-GL

Yes

MSR3600-28-SI-GL

Yes

 

After this command is configured, continual LM stops when port collaboration blocks a port. The port automatically comes up after the specified delay time, and continues with continual LM.

Examples

# Enable automatic port recovery for continual LM and set the delay time for automatic recovery to 10 minutes.

<Sysname> system-view

[Sysname] cfd slm port-trigger up-delay 10

Related commands

cfd port-trigger

cfd slm continual

cfd slm threshold

display cfd slm history

cfd slm threshold

Use cfd slm threshold to configure the lower limit and upper limit for continual LM.

Use undo cfd slm threshold to restore the default.

Syntax

cfd slm { far-end | near-end } threshold service-instance instance-id mep mep-id { lower-limit lower-limit | upper-limit upper-limit } *

undo cfd slm { far-end | near-end } threshold service-instance instance-id mep mep-id [ lower-limit | upper-limit ]

Default

The lower limit and upper limit for continual LM are 0 and 100%, respectively, for both the source and target MEPs.

Views

System view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

far-end: Configures the lower limit and upper limit for the target MEP.

near-end: Configures the lower limit and upper limit for the source MEP.

mep mep-id: Specifies a MEP by its ID in the range of 1 to 8191.

lower-limit lower-limit: Specifies the lower limit in the range of 0 to 100%. It can contain a maximum of 8 digits, including the dot (.).

upper-limit upper-limit: Specifies the upper limit in the range of 0 to 100%. It can contain a maximum of 8 digits, including the dot (.). The lower limit must be smaller than the upper limit.

Usage guidelines

This command takes effect only after you configure continual LM.

If the cfd port-trigger slm action { block | shutdown } command is configured, the following rules apply:

·     If the packet loss ratio for the source MEP or target MEP reaches or exceeds the upper limit for three consecutive times, the port is blocked or shut down.

To bring up the port when the link recovers, execute the undo cfd port-trigger slm action command.

·     If the packet loss ratios for both the source MEP and target MEP reach or fall below the lower limit for three consecutive times, the port remains in up state.

The cfd slm threshold command can be configured only in Ethernet networks.

Examples

# Configure the continual LM lower limit and upper limit as 0.2% and 0.8%, respectively, for source MEP 1101 in service instance 1.

<Sysname> system-view

[Sysname] cfd slm near-end threshold service-instance 1 mep 1101 lower-limit 0.2 upper-limit 0.8

Related commands

cfd port-trigger

cfd slm continual

display cfd slm history

cfd tst

Use cfd tst to configure short-period test (TST).

Syntax

cfd tst service-instance instance-id mep mep-id { target-mac mac-address | target-mep target-mep-id } [ number number ] [ length-of-test length ] [ pattern-of-test { all-zero | prbs } [ with-crc ] ]

Views

Any view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

mep mep-id: Specifies the source MEP by its ID in the range of 1 to 8191.

target-mac mac-address: Specifies the target MEP by its MAC address, which is in the format of H-H-H.

target-mep target-mep-id: Specifies the target MEP by its ID in the range of 1 to 8191.

number number: Specifies the number of sent TST frames. The value range for the number argument is 1 to 10, and the default is 5.

length-of-test length: Specifies the length of the Test TLV (Type/Length/Value) in the TST frame. The value range for the length argument is 4 to 1400, and the default is 64.

pattern-of-test { all-zero | prbs } [ with-crc ]: Specifies the pattern of the Test TLV in the TST frame:

·     all-zero (all-zero value without CRC-32), which is the default pattern.

·     prbs (pseudo random bit sequence without CRC-32).

·     all-zero with-crc (all-zero value with CRC-32).

·     prbs with-crc (pseudo random bit sequence with CRC-32).

Usage guidelines

Short-period TST detects bit errors between the source and target MEPs by sending a configurable number of TST frames.

To view the TST test result, use the display cfd tst history command on the target MEP.

Short-period TST and continual TST cannot be configured at the same time for one source MEP. If you have configured continual TST, you can configure short-period TST only after you disable continual TST. If you have configured short-period TST, you can configure continual TST only after the short-period TST ends.

This command can be configured only in Ethernet networks. You cannot specify a Layer 2 VPN service instance for the service-instance instance-id option.

Examples

# Configure short-period TST to test the bit errors between source MEP 1101 and target MEP 1003 in service instance 1.

<Sysname> cfd tst service-instance 1 mep 1101 target-mep 1003

5 TSTs have been sent. Please check the result on the remote device.

Related commands

display cfd tst history

reset cfd tst

cfd tst continual

Use cfd tst continual to configure continual TST.

Use undo tst continual to disable continual TST.

Syntax

cfd tst continual service-instance instance-id mep mep-id { target-mac mac-address | target-mep target-mep-id } [ length-of-test length ] [ pattern-of-test { all-zero | prbs } [ with-crc ] ] [ interval interval ]

undo cfd tst continual service-instance instance-id mep mep-id

Default

Continual TST is not configured.

Views

System view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

mep mep-id: Specifies the source MEP by its ID in the range of 1 to 8191.

target-mac mac-address: Specifies the target MEP by its MAC address, which is in the format of H-H-H. The MAC address cannot be a MAC address of a local MEP or a non-unicast MAC address.

target-mep target-mep-id: Specifies the target MEP by its ID in the range of 1 to 8191.

length-of-test length: Specifies the length of the Test TLV (Type/Length/Value) in the TST frame. The value range for the length argument is 4 to 1400 bytes, and the default is 64.

pattern-of-test { all-zero | prbs } [ with-crc ]: Specifies the pattern of the Test TLV in the TST frame:

·     all-zero (all-zero value without CRC-32), which is the default pattern.

·     prbs (pseudo random bit sequence without CRC-32).

·     all-zero with-crc (all-zero value with CRC-32).

·     prbs with-crc (pseudo random bit sequence with CRC-32).

interval interval: Specifies the interval for sending TST frames. The value for the interval argument can be 100 or 1000 milliseconds, and the default is 1000.

Usage guidelines

Continual TST detects bit errors between the source and target MEPs by sending TST frames continuously.

If the device supports hardware CC, you can only specify the target MEP by its MAC address. You cannot specify the target MEP by its ID.

To modify continual TST settings for a source MEP, you must disable continual TST and then reconfigure the function  for the source MEP.

Short-period TST and continual TST cannot be configured at the same time for one source MEP. If you have configured continual TST, you can configure short-period TST only after you disable continual TST. If you have configured short-period TST, you can configure continual TST only after the short-period TST ends.

To display the continual TST result, use the display cfd tst history command on the device where the source MEP resides.

The cfd tst continual command can be configured only in Ethernet networks.

Examples

# Configure continual TST to test the bit errors between source MEP 1101 and target MEP 2001 in service instance 1.

<Sysname> system-view

[Sysname] cfd tst continual service-instance 1 mep 1101 target-mep 2001

Related commands

cfd tst

cfd tst threshold

display cfd tst history

cfd tst threshold

Use cfd tst threshold to configure the lower limit and upper limit for continual TST.

Use undo cfd tst threshold to restore the default.

Syntax 

cfd tst threshold service-instance instance-id mep mep-id { lower-limit lower-limit | upper-limit upper-limit } *

undo cfd tst threshold service-instance instance-id mep mep-id [ lower-limit | upper-limit ]

Default

The lower limit and upper limit for continual TST are 0 and 100%, respectively.

Views

System view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

mep mep-id: Specifies the source MEP by its ID in the range of 1 to 8191.

lower-limit lower-limit: Specifies the lower limit in the range of 0 to 100%. It can contain a maximum of 8 digits, including the dot (.).

upper-limit upper-limit: Specifies the upper limit in the range of 0 to 100%. It can contain a maximum of 8 digits, including the dot (.). The lower limit must be smaller than the upper limit.

Usage guidelines

This command takes effect only after you configure continual TST.

If the cfd port-trigger tst action { block | shutdown } command is configured, the following rules apply:

·     If the bit error ratio reaches or exceeds the upper limit for three consecutive times, the port is blocked or shut down.

·     If the bit error ratio reaches or falls below the lower limit for three consecutive times, the port is unblocked or brought up.

The cfd tst threshold command can be configured only in Ethernet networks.

Examples

# Configure the continual TST lower limit and upper limit as 4.5% and 80.7%, respectively, for source MEP 1101 in service instance 1.

<Sysname> system-view

[Sysname] cfd tst threshold service-instance 1 mep 1101 lower-limit 4.5 upper-limit 80.7

Related commands

cfd port-trigger

cfd tst continual

display cfd tst history

display cfd ais

Use display cfd ais to display the AIS configuration and information on the specified MEP or all MEPs.

Syntax

display cfd ais [ service-instance instance-id [ mep mep-id ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767. If you do not specify this option, the command displays the AIS configuration and information for all service instances.

mep mep-id: Specifies a MEP by its ID in the range of 1 to 8191. If you do not specify this option, the command displays the AIS configuration and information for all MEPs.

Examples

# Display the AIS configuration and information for all the MEPs in all service instances.

<Sysname> display cfd ais

Service instance: 5

AIS level: 4    AIS period: 1s

MEP ID: 1

AIS condition: yes   Time to enter the condition: 2013/01/22 10:43:57

AIS state machine: Previous state: NO_RECEIVE

                   Current state: RECEIVE

MEP ID: 2

AIS condition: yes   Time to enter the condition: 2013/01/22 10:43:57

AIS state machine: Previous state: NO_RECEIVE

                   Current state: RECEIVE

 

Service instance: 20

AIS level: 3    AIS period: 60s

MEP ID: 10

AIS condition: yes   Time to enter the condition: 2013/01/22 10:43:57

AIS state machine: Previous state: NO_RECEIVE

                   Current state: RECEIVE

 

Service instance: 100

AIS level: 6    AIS period: 1s

MEP ID: 20

AIS condition: no    Time to enter the condition: 2013/01/22 11:40:01

AIS state machine: Previous state: IDLE

                   Current state: NO_RECEIVE

 

MEP ID: 50

AIS condition: no    Time to enter the condition: -

AIS state machine: Previous state: IDLE

                   Current state: NO_RECEIVE

Table 9 Command output

Field

Description

Service instance

Service instance of the MEP.

AIS level

AIS frame transmission level.

AIS period

AIS frame transmission period.

AIS condition

AIS status:

·     yes—AIS is running.

·     no—AIS is not running.

Time to enter the condition

Time when the AIS status began. (- means AIS is enabled but the MEP does not receive any AIS frame.)

AIS state machine

AIS frame receiving state machine.

Previous state

Previous state:

·     IDLE—Not activated.

·     NO_RECEIVE—Activated.

·     RECEIVE—AIS frames are received.

Current state

Current state:

·     IDLE—Not activated.

·     NO_RECEIVE—Activated.

·     RECEIVE—AIS frames are received.

 

display cfd dm one-way history

Use display cfd dm one-way history to display the one-way DM result.

Syntax

display cfd dm one-way history [ service-instance instance-id [ mep mep-id ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767. If you do not specify this option, the command displays the one-way DM results for all service instances.

mep mep-id: Specifies a MEP by its ID in the range of 1 to 8191. If you do not specify this option, the command displays the one-way DM results for all MEPs.

Usage guidelines

The one-way DM results for all inward-facing MEPs in a service instance are the same.

Examples

# Display the one-way DM results for all the MEPs in all service instances.

<Sysname> display cfd dm one-way history

Service instance: 1

MEP ID: 1003

Sent 1DM total number: 0

Received 1DM total number: 5

Frame delay: 10ms 9ms 11ms 5ms 5ms

Delay average: 8ms

Frame delay variation: 5ms 4ms 6ms 0ms 0ms

Variation average: 3ms

MEP ID: 1004

Sent 1DM total number: 0

Received 1DM total number: 5

Frame delay: 10ms 9ms 11ms 5ms 5ms

Delay average: 8ms

Delay variation: 5ms 4ms 6ms 0ms 0ms

Variation average: 3ms

 

Service instance: 2

No MEP exists in the service instance.

 

Service instance: 3

MEP ID: 1023

Sent 1DM total number: 5

Received 1DM total number: 10

Frame delay: 20ms 9ms 8ms 7ms 1ms 5ms 13ms 17ms 9ms 10ms

Delay average: 9ms

Delay variation: 19ms 8ms 7ms 6ms 0ms 4ms 12ms 16ms 8ms 9ms

Variation average: 8ms

 

Service instance: 4

MEP ID: 1023

Sent 1DM total number: 77

Received 1DM total number: 0

Table 10 Command output

Field

Description

Service instance

Service instance of the MEP.

Sent 1DM total number

Number of sent 1DM frames.

Received 1DM total number

Number of received 1DM frames.

Delay average

Average frame delay.

Delay variation

Frame delay variation.

Variation average

Average frame delay variation.

 

Related commands

cfd dm one-way

reset cfd dm one-way history

display cfd dm two-way history

Use display cfd dm two-way history to display the two-way DM result.

Syntax

display cfd dm two-way history [ service-instance instance-id [ mep mep-id ] ] [ number number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767. If you do not specify this option, the command displays the two-way DM results for all service instances.

mep mep-id: Specifies a MEP by its ID in the range of 1 to 8191. If you do not specify this option, the command displays the two-way DM results for all MEPs.

number number: Specifies the number of most recent two-way DM result entries to be displayed, in the range of 1 to 64. The default is 5.

Examples

# Display the two-way DM results for all the MEPs in all service instances.

<Sysname> display cfd dm two-way history

Service instance: 1

MEP ID: 1003

Send status: Testing

Frame delay:

Reply from 0010-fc00-6512: 10us

Reply from 0010-fc00-6512: 9us

Reply from 0010-fc00-6512: 11us

Reply from 0010-fc00-6512: 5us

Reply from 0010-fc00-6512: 5us

Average: 8us

Frame delay variation: 1us 2us 6us 0us

Average: 2us

Packet statistics:

Sent DMMs: 5        Received: 5        Lost: 0

 

MEP ID: 1004

Send status: Init

Frame delay:

Reply from 0010-fc00-6512: 10us

Reply from 0010-fc00-6512: 9us

Reply from 0010-fc00-6512: 11us

Reply from 0010-fc00-6512: 5us

Reply from 0010-fc00-6512: 5us

Average: 8us

Frame delay variation: 1us 2us 6us 0us

Average: 2us

Packet statistics:

Sent DMMs: 5        Received: 5        Lost: 0

 

Service instance: 2

No MEP exists in the service instance.

Table 11 Command output

Field

Description

Send status

Two-way DM test status:

·     Testing—A two-way DM test is in progress.

·     Init—A two-way DM test is in initialization state and is about to start.

·     Stop—A two-way DM test stopped.

If a two-way DM test has never been performed on a source MEP, this field displays a hyphen (-).

Average

Average frame delay or average frame delay variation.

Sent DMMs

Number of sent DMM frames.

Received

Number of received DMR frames.

Lost

Number of lost DMR frames.

 

Related commands

cfd dm two-way

cfd dm two-way continual

display cfd linktrace-reply

Use display cfd linktrace-reply to display the LTR information received by a MEP.

Syntax

display cfd linktrace-reply [ service-instance instance-id [ mep mep-id ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

service-instance instance-id: Specifies the service instance ID in the range of 1 to 32767. If you do not specify this option, the command displays the LTR information for all service instances.

mep mep-id: Specifies the ID of a MEP, in the range of 1 to 8191. If you do not specify this option, the command displays the LTR information for all MEPs.

Usage guidelines

This command displays only information about LTRs received by execution of the cfd linktrace command.

Examples

# Display the LTR information saved on all the MEPs in every service instance.

[Sysname] display cfd linktrace-reply

Service instance: 1       MEP ID: 1003

MAC address               TTL     Last MAC          Relay action

0000-fc00-6505            63      0000-fc00-6504    MPDB

000f-e269-a852            62      0000-fc00-6505    FDB

0000-fc00-6508            61      000f-e269-a852    Hit

Service instance: 2       MEP ID: 1023

MAC address               TTL     Last MAC          Relay action

0000-fc00-6508            61      000f-e269-a852    Hit

Table 12 Command output

Field

Description

Service instance

Service instance to which the MEPs that send LTMs belong.

MEP ID

ID of the MEP that sends LTMs.

MAC address

Source MAC address in the LTR message.

TTL

TTL of the LTM when it passes the device.

Last MAC

MAC address of the last-hop device the LTM passes.

Relay action

Indicates whether the forwarding device found the destination MAC address in its MAC address table.

When the standard version (IEEE 802.1ag) of CFD is used:

·     Hit—The current device is the destination device.

·     FDB—The forwarding device found the destination MAC address.

·     MPDB—The destination MAC address is not found, or the destination MAC address is found in the MEP or MIP database.

 

Related commands

cfd linktrace

display cfd linktrace-reply auto-detection

Use display cfd linktrace-reply auto-detection to display information about the LTR messages received as responses to the automatically sent LTMs.

Syntax

display cfd linktrace-reply auto-detection [ size size-value ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

size size-value: Specifies the times of recent auto-detections, in the range of 1 to 100. If you do not specify this option, the command displays all information in the buffer.

Usage guidelines

This command displays only information about LTRs received by execution of the cfd linktrace auto-detection command.

Examples

# Display the contents of the LTRs received as responses to the LTMs automatically sent.

<Sysname> display cfd linktrace-reply auto-detection

Service instance: 1       MEP ID: 1003    Time: 2013/05/22 10:43:57

Target MEP ID: 2005       TTL: 64

MAC address               TTL     Last MAC          Relay action

0000-fc00-6505            63      0000-fc00-6504    MPDB

000f-e269-a852            62      0000-fc00-6505    FDB

0000-fc00-6508            61      000f-e269-a852    Hit

Service instance: 2       MEP ID: 1023    Time: 2013/05/22 10:44:06

Target MEP ID: 2025       TTL: 64

MAC address               TTL     Last MAC          Relay action

0000-fc00-6508            61      000f-e269-a852    Hit

Table 13 Command output

Field

Description

Service instance

Service instance to which the MEPs that sent LTM messages belong.

MEP ID

ID of the MEP that sends LTMs.

Time

Time of the LTMs automatically sent.

Target MEP ID

ID of the target MEP.

TTL

Initial TTL of the automatically sent LTMs.

MAC address

Source MAC address in the LTR messages.

TTL

TTL of the LTM when it passes the device.

Last MAC

MAC address of the last-hop device the LTM passes.

Relay action

Indicates whether the forwarding device found the destination MAC address in its MAC address table.

When the standard version (IEEE 802.1ag) of CFD is used:

·     Hit—The current device is the destination device.

·     FDB—The forwarding device found the destination MAC address.

·     MPDB—The destination MAC address is not found, or the destination MAC address is found in the MEP or MIP database.

 

Related commands

cfd linktrace auto-detection

display cfd md

Use display cfd md to display the MD configuration information.

Syntax

display cfd md

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the MD configuration information.

<Sysname> display cfd md

CFD is enabled.

Maintenance domains configured: 4 in total

Level  Index      Maintenance domain                          MD format  MD ID

0      1          md_0                                        CHARSTRING md_0

1      2          md_1                                        DNS        dns1

2      3          md_2                                        MAC        0001-00

01-0001-1

3      4          md_3                                        NONE       Without

 ID

Table 14 Command output

Field

Description

Maintenance domains configured

Number of MDs configured.

Level

Level of MD.

Index

MD index.

Maintenance domain

Name of MD.

MD format

MD name format:

·     CHARSTRING—Character string.

·     DNS—DNS name.

·     MAC—MAC address and an integer.

·     NONE—No MD name is carried.

MD ID

MD ID value:

·     A character string if the MD format is CHARSTRING.

·     A DNS name if the MD format is DNS.

·     A MAC address-subnumber if the MD format is MAC.

·     No ID if the MD format is NONE.

 

display cfd mep

Use display cfd mep to display the attribute and operating information of a MEP.

Syntax

display cfd mep mep-id service-instance instance-id

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

mep mep-id: Specifies a MEP by its ID in the range of 1 to 8191.

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

Examples

# In an Ethernet network, display the attribute and operating information of MEP 50 in service instance 1.

<Sysname> display cfd mep 50 service-instance 1

Interface: GigabitEthernet1/0/2

Maintenance domain: md_0

Maintenance domain index: 1

Maintenance association: ma_0

Maintenance association index: 1

Level: 0        VLAN: 1         Direction: Outbound

Current state: Active          CCM send: Enabled

FNG state: FNG_DEFECT_REPORTED

 

CCM:

Current state: CCI_WAITING

Interval: 1s        SendCCM: 12018

 

Loopback:

NextSeqNumber: 8877

SendLBR: 0          ReceiveInOrderLBR: 0          ReceiveOutOrderLBR: 0

 

Linktrace:

NextSeqNumber: 8877

SendLTR: 0          ReceiveLTM: 0

 

No CCM received from some remote MEPs.

 

One or more streams of error CCMs is received. The last received CCM:

Maintenance domain: (Without ID)

Maintenance association: matest1

MEP ID: 5      Sequence Number:0x50A

MAC Address: 0011-2233-4402

Received Time: 2013/03/06 13:01:34

 

One or more streams of cross-connect CCMs is received. The last received CCM:

Maintenance domain: mdtest1

Maintenance association:matest1

MEP ID: 6      Sequence Number:0x63A

MAC Address: 0011-2233-4401

Received Time: 2013/03/06 13:01:34

 

Some other MEPs are transmitting the RDI bit.

# (On routers.) In an MPLS Layer 2 VPN, display the attribute and operating information of MEP 50 in service instance 1.

<Sysname> display cfd mep 50 service-instance 1

Interface: GigabitEthernet1/0/2.1

Maintenance domain: md_0

Maintenance domain index1

Maintenance association: ma_0

Maintenance association index1

Level: 0                         Direction: Inbound

Current state: Active          CCM send: Enabled

FNG state: FNG_DEFECT_REPORTED

 

CCM:

Current state: CCI_WAITING

Interval: 1s        SendCCM: 12018

 

Loopback:

NextSeqNumber: 8877

SendLBR: 0          ReceiveInOrderLBR: 0          ReceiveOutOrderLBR: 0

 

Linktrace:

NextSeqNumber: 8877

SendLTR: 0          ReceiveLTM: 0

 

No CCM received from some remote MEPs.

# (On switches.) In an MPLS Layer 2 VPN, display the attribute and operating information of MEP 50 in service instance 1.

<Sysname> display cfd mep 50 service-instance 1

Interface: GigabitEthernet1/0/2

Maintenance domain: md_0

Maintenance domain index1

Maintenance association: ma_0

Maintenance association index1

Level: 0        EthSrv: 1         Direction: Inbound

Current state: Active          CCM send: Enabled

FNG state: FNG_DEFECT_REPORTED

 

CCM:

Current state: CCI_WAITING

Interval: 1s        SendCCM: 12018

 

Loopback:

NextSeqNumber: 8877

SendLBR: 0          ReceiveInOrderLBR: 0          ReceiveOutOrderLBR: 0

 

Linktrace:

NextSeqNumber: 8877

SendLTR: 0          ReceiveLTM: 0

 

No CCM received from some remote MEPs.

Table 15 Command output

Field

Description

Interface

Interface on which the MEP is configured.

Maintenance domain

MD to which the MEP belongs. (If the MD does not have a name, this field is displayed as Without ID.)

Maintenance domain index

Index of the MD to which the MEP belongs..

Maintenance association

MA to which the MEP belongs.

Maintenance association index

Index of the MA to which the MEP belongs.

Level

Level of the MD.

VLAN

VLAN to which the MA belongs.

EthSrv

Service instance for the MEP.

Direction

Direction of the MEPs.

Current state

State of MEP:

·     Active.

·     Inactive.

CCM send

Whether the MEP sends CCM.

FNG state

State of FNG (Fault Notification Generator):

·     FNG_RESET—A fault has been cleared.

·     FNG_DEFECT—A fault has been detected.

·     FNG_REPORT_DEFECT—Report a fault.

·     FNG_DEFECT_REPORTED—A fault has been reported.

·     FNG_DEFECT_CLEARING—A fault is being cleared.

If this field is not supported, a hyphen (-) is displayed.

CCM

Information related to CCM.

Current state

State of CCMs sent:

·     CCI_IDLE—Initial state.

·     CCI_WAITING—Sending state.

If this field is not supported, a hyphen (-) is displayed.

Interval

Interval to send CCM. Not supported means the MEP does not support CCM sending.

SendCCM

Number of CCMs that have been sent by the MEPs.

If this field is not supported, a hyphen (-) is displayed.

Loopback

Information related to Loopback.

NextSeqNumber

Sequence number of the next LBM to be sent.

SendLBR

Number of LBRs that have been sent. If the MEP is inward-facing, the number of LBRs will not be counted.

ReceiveInOrderLBR

Number of LBR messages received in correct sequence.

ReceiveOutOrderLBR

Number of LBR messages received out of order.

Linktrace

Information related to linktrace.

NextSeqNumber

Sequence number of the next LTM to be sent.

SendLTR

Number of LTRs sent. If the MEP is inward-facing, the number of LTRs will not be counted.

ReceiveLTM

Number of LTMs received.

No CCM received from some remote MEPs.

Failure to receive CCMs from some remote MEPs. (This information is displayed only when some CCMs are lost.)

One or more streams of error CCMs is received. The last received CCM:

Display the content of the last error CCM when one or more error CCMs are received. (This information is displayed only when error CCMs are received.)

Maintenance domain

MD of the last error CCM message.

If this field is not supported, a hyphen (-) is displayed.

Maintenance association

MA of the last error CCM message.

If this field is not supported, a hyphen (-) is displayed.

MEP

ID of the MEP that sent the last error CCM message.

If this field is not supported, a hyphen (-) is displayed.

Sequence Number

Sequence number of the last error CCM.

If this field is not supported, a hyphen (-) is displayed.

Received Time

Time when the last error CCM is received.

If this field is not supported, a hyphen (-) is displayed.

One or more streams of cross-connect CCMs is received. The last received CCM:

Cross-connect CCMs are received, and the content of the last cross-connect CCM is displayed. (This information is displayed only when cross-connect CCMs are received.)

Some other MEPs are transmitting the RDI bit.

CCMs with the RDI flag bits set are received from other MEPs. (This information is displayed only when this type of CCMs are received.)

 

display cfd meplist

Use display cfd meplist to display the MEP list in a service instance.

Syntax

display cfd meplist [ service-instance instance-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767. If you do not specify this option, the command displays MEP lists in all service instances.

Examples

# Display the MEP list in service instance 5.

<Sysname> display cfd meplist service-instance 5

Service instance: 5

MEP list: 1 to 20, 30, 50.

display cfd mp

Use display cfd mp to display the MP information.

Syntax

display cfd mp [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify this option, the command displays MP information for all interfaces.

Examples

# Display the MP information on all interfaces.

<Sysname> display cfd mp

Interface GigabitEthernet1/0/1   VLAN 100

MIP              Level: 1    Service instance: 101

Maintenance domain: md_1

Maintenance domain index2

Maintenance association: ma_1

Maintenance association index: 2

MEP ID: 100      Level: 0    Service instance: 100    Direction: Outbound

Maintenance domain: md_0

Maintenance domain index1

Maintenance association: ma_0

Maintenance association index: 1

Interface GigabitEthernet1/0/2   VLAN NONE

MEP ID: 101      Level: 2    Service instance: 102    Direction: Inbound

Maintenance domain: md_2

Maintenance domain index: 3

Maintenance association: ma_2

Maintenance association index: 3

Table 16 Command output

Field

Description

Interface GigabitEthernet1/0/1   VLAN 100

MP configuration of VLAN 100 on GigabitEthernet 1/0/1.

Interface GigabitEthernet1/0/2   VLAN NONE

Configuration of the MP that does not serve any VLAN or configuration of the MP in an MPLS Layer 2 VPN.

MIP

A MIP in the MP.

Level

MD level to which the MP belongs.

Service instance

Service instance to which the MP belongs.

Maintenance domain

MD to which the MP belongs.

Maintenance domain index

Index of the MD to which the MP belongs.

Maintenance association

MA to which the MP belongs.

Maintenance association index

Index of the MA to which the MP belongs.

Direction

Direction of the MEP, inbound or outbound.

 

display cfd remote-mep

Use display cfd remote-mep to display information about a remote MEP.

Syntax

display cfd remote-mep service-instance instance-id mep mep-id

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767.

mep mep-id: Specifies a MEP by its ID in the range of 1 to 8191.

Examples

# Display remote MEP information for MEP 10 in service instance 4.

<Sysname> display cfd remote-mep service-instance 4 mep 10

MEP ID   MAC address      State        Time                  MAC status

20       00e0-fc00-6565   OK           2013/03/06 02:36:38   UP

30       00e0-fc27-6502   OK           2013/03/06 02:36:38   DOWN

40       00e0-fc00-6510   FAILED       2013/03/06 02:36:39   DOWN

50       00e0-fc52-baa0   OK           2013/03/06 02:36:44   DOWN

60       0010-fc00-6502   OK           2013/03/06 02:36:42   DOWN

Table 17 Command output

Field

Description

MEP ID

ID of the remote MED.

MAC address

MAC address of the remote MEP device.

If this field is not supported, a hyphen (-) is displayed.

State

Running state of the remote MEP:

·     OK.

·     FAILED.

Time

Time when the remote MEP entered the FAILED or OK state for the last time.

If this field is not supported, a hyphen (-) is displayed.

MAC status

State of the interface indicated by the last CCM received from the remote MEP:

·     UP—The interface is ready to pass packets.

·     DOWN—The interface cannot pass packets.

·     TESTING—The interface is in some test mode.

·     UNKNOWN—The interface status cannot be determined.

·     DORMANT—The interface is not in a state to pass packets. Instead, it is in a pending state, waiting for some external event.

·     NOT-PRESENT—Some component of the interface is missing.

·     LLD—The interface is down due to state of the lower layer interfaces.

If this field is not supported, a hyphen (-) is displayed.

 

display cfd service-instance

Use display cfd service-instance to display the configuration information of service instances.

Syntax

display cfd service-instance [ instance-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance-id: Specifies a service instance ID in the range of 1 to 32767. If you do not specify this argument, the command displays configuration information for all service instances.

Examples

# Display the configuration information of all service instances.

<Sysname> display cfd service-instance

Service instances configured (2 in total):

Service instance 5:

Maintenance domain: md_5

Maintenance domain index: 5

Maintenance association: ma_5

Maintenance association index: 5

Level: 5  VLAN: 5   MIP rule: NONE   CCM interval: 1s   Direction: Inbound

MEP ID: 730  Interface: GigabitEthernet1/0/1

 

Service instance 6:

Maintenance domain: (Without ID)

Maintenance domain index: 6

Maintenance association: ma_6

Maintenance association index: 6

Level: 6  VLAN: 6   MIP rule: NONE   CCM interval: 1s   Direction: Outbound

MEP ID: 731  Interface: GigabitEthernet1/0/2

Table 18 Command output

Field

Description

Service instances are configured.

Number of service instances configured.

Service instance

Service instance ID.

Maintenance domain

MD of the service instances. (If the MD does not have a name, this field displays Without ID.)

Maintenance domain index

Index of the MD to which the service instances belong.

Maintenance association:

MA of the service instances.

Maintenance association index

Index of the MA to which the service instances belong.

Level

MD level.

VLAN

VLAN to which the MA belongs.

MIP rule

MIP generation rules configured on the service instance.

CCM interval

Interval to send CCMs.

Direction

Direction of the MEPs configured on the service instance.

MEP ID

ID of MEPs configured on the service instance.

Interface

Interface of the MEP configured on the service instance.

 

display cfd slm history

Use display cfd slm history to display the LM result.

Syntax

display cfd slm history [ service-instance instance-id [ mep mep-id ] ] [ number number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767. If you do not specify this option, the command displays the LM results for all service instances.

mep mep-id: Specifies a MEP by its ID in the range of 1 to 8191. If you do not specify this option, the command displays the LM results for all MEPs.

number number: Specifies the number of most recent LM result entries to be displayed, in the range of 1 to 64. The default is 5.

Examples

# Display the LM results for MEP 1101 in service instance 1.

<Sysname> display cfd slm history service-instance 1 mep 1101

Service instance: 1

MEP ID: 1101

Send status: Testing

Reply from 0010-fc00-6512

Far-end frame loss: 10    Near-end frame loss: 20

Reply from 0010-fc00-6512

Far-end frame loss: 40    Near-end frame loss: 40

Reply from 0010-fc00-6512

Far-end frame loss: 0     Near-end frame loss: 10

Reply from 0010-fc00-6512

Far-end frame loss: 30    Near-end frame loss: 30

Reply from 0010-fc00-6512

Far-end frame loss: 20    Near-end frame loss: 25

Average:

Far-end frame loss: 20    Near-end frame loss: 25

Far-end frame loss rate: 25.00%      Near-end frame loss rate: 32.00%

Packet statistics:

Sent LMMs: 100    Received: 100    Lost: 0

Table 19 Command output

Field

Description

Send status

LM test status:

·     Testing—An LM test is in progress.

·     Init—An LM test is in initialization state and is about to start.

·     Stop—An LM test stopped.

If an LM test has never been performed on a source MEP, this field displays a hyphen (-).

Reply from 0010-fc00-6512

LMR frames returned from the target MEP with MAC address 0010-FC00-6512.

Far-end frame loss

Number of lost frames on the target MEP.

Near-end frame loss

Number of lost frames on the source MEP.

Far-end frame loss rate

Frame loss ratio on the target MEP.

Near-end frame loss rate

Frame loss ratio on the source MEP.

Average

Average number of lost frames.

Sent LMMs

Number of sent LMM frames.

Received

Number of received LMR frames.

Lost

Number of lost LMR frames.

 

Related commands

cfd slm

cfd slm continual

display cfd status

Use display cfd status to display the CFD and AIS status.

Syntax

display cfd status

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the CFD status.

<Sysname> display cfd status

CFD is enabled.

AIS is disabled.

display cfd tst history

Use display cfd tst history to display the TST result.

Syntax

display cfd tst history [ service-instance instance-id [ mep mep-id ] ] [ number number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767. If you do not specify this option, the command displays the TST results for all service instances.

mep mep-id: Specifies a MEP by its ID in the range of 1 to 8191. If you do not specify this option, the command displays the TST results for all MEPs.

number number: Specifies the number of most recent TST result entries to be displayed, in the range of 1 to 64. The default is 5.

Usage guidelines

The TST DM results for all inward-facing MEPs in a service instance are the same.

Examples

# Display the TST results for all the MEPs in all service instances.

<Sysname> display cfd tst history

Service instance: 1

MEP ID: 1003

Send status: Testing

Received from 0010-fc00-6510, Bit True,  sequence number 0

Received from 0010-fc00-6510, Bit True,  sequence number 1

Received from 0010-fc00-6510, Bit True,  sequence number 2

Received from 0010-fc00-6510, Bit True,  sequence number 3

Received from 0010-fc00-6510, Bit True,  sequence number 4

Sent TST total number: 7

Received TST total number: 5

Received bit error TST number0

Percentage of error messages0.00%

MEP ID: 1004

Send status: Init

Sent TST total number: 5

Received TST total number: 0

Received bit error TST number0

Percentage of error messages0.00%

Service instance: 2

No MEP exists in the service instance.

Service instance: 3

MEP ID: 1023

Send status: Stop

Sent TST total number: 5

Received TST total number: 0

Received bit error TST number0

Percentage of error messages0.00%

Table 20 Command output

Field

Description

Service instance

Service instance of the MEP.

Send status

TST test status:

·     Testing—A TST test is in progress.

·     Init—A TST test is in initialization state and is about to start.

·     Stop—A TST test stopped.

If a TST test has never been performed on the source MEP, this field displays a hyphen (-).

Received from 0010-fc00-6510, Bit True,  sequence number 0

TST frame with sequence number 0 was received from the MEP with MAC address 0010-FC00-6510:

·     Bit True—No bit error occurred.

·     Bit False—Bit errors occurred.

Sent TST total number

Number of sent TST frames.

Received TST total number

Number of received TST frames.

Received bit error TST number

Number of received TST frames with bit errors.

Percentage of error messages

Percentage of received TST frames with bit errors.

 

Related commands

cfd tst

cfd tst continual

reset cfd tst

reset cfd dm one-way history

Use reset cfd dm one-way history to clear the one-way DM result.

Syntax

reset cfd dm one-way history [ service-instance instance-id [ mep mep-id ] ]

Views

User view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767. If you do not specify this option, the command clears the one-way DM results for all service instances.

mep mep-id: Specifies a MEP by its ID in the range of 1 to 8191. If you do not specify this option, the command clears the one-way DM results for all MEPs.

Usage guidelines

Clearing the one-way DM result for an inward-facing MEP clears all one-way DM results for the service instance where the inward-facing MEP resides.

Examples

# Clear the one-way DM results for all MEPs in all service instances.

<Sysname> reset cfd dm one-way history

Related commands

cfd dm one-way

display cfd dm one-way history

reset cfd tst

Use reset cfd tst to clear the TST result.

Syntax

reset cfd tst [ service-instance instance-id [ mep mep-id ] ]

Views

User view

Predefined user roles

network-admin

Parameters

service-instance instance-id: Specifies a service instance by its ID in the range of 1 to 32767. If you do not specify this option, the command clears the TST results for all service instances.

mep mep-id: Specifies a MEP by its ID in the range of 1 to 8191. If you do not specify this option, the command clears the TST results for all MEPs.

Usage guidelines

Clearing the TST result for an inward-facing MEP clears all TST results for the service instance where the inward-facing MEP resides.

Examples

# Clear the TST results for all MEPs in all service instances.

<Sysname> reset cfd tst

Related commands

cfd tst

display cfd tst

 


BFD commands

bfd authentication-mode

Use bfd authentication-mode to configure the BFD authentication mode for single-hop BFD control packets.

Use undo bfd authentication-mode to restore the default.

Syntax

bfd authentication-mode { m-md5 | m-sha1 | md5 | sha1 | simple } key-id { cipher | plain } string

undo bfd authentication-mode

Default

Single-hop BFD control packets are not authenticated.

Views

Interface view

BFD template view

Predefined user roles

network-admin

Parameters

m-md5: Specifies the Meticulous MD5 algorithm.

m-sha1: Specifies the Meticulous SHA1 algorithm.

md5: Specifies the MD5 algorithm.

sha1: Specifies the SHA1 algorithm.

simple: Specifies the simple authentication mode.

key-id: Sets the authentication key ID in the range of 1 to 255.

cipher: Specifies a key in encrypted form.

plain: Specifies a key in plaintext form. For security purposes, the key specified in plaintext form will be stored in encrypted form.

string: Specifies the key. Its plaintext form is a case-sensitive string of 1 to 16 characters. Its encrypted form is a case-sensitive string of 33 to 53 characters.

Usage guidelines

Use this command to enhance BFD session security.

BFD version 0 does not support this command. The configuration does not take effect.

Examples

# Configure GigabitEthernet 1/0/1 to perform simple authentication for single-hop BFD control packets, setting the authentication key ID to 1 and plaintext key to 123456.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] bfd authentication-mode simple 1 plain 123456

bfd demand enable

Use bfd demand enable to enable the Demand BFD session mode.

Use undo bfd demand enable to restore the default.

Syntax

bfd demand enable

undo bfd demand enable

Default

The BFD session is in Asynchronous mode.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

In Demand mode, the device periodically sends BFD control packets. If the peer end is operating in Asynchronous mode (default), the peer end stops sending BFD control packets. If the peer end is operating in Demand mode, both ends stop sending BFD control packets. When the connectivity to another system needs to be verified explicitly, a system sends several BFD control packets with the Poll (P) bit set at the negotiated transmit interval. If no response is received within the detection interval, the session is considered down. If the connectivity is found to be up, no more BFD control packets are sent until the next command is issued.

In Asynchronous mode, the device periodically sends BFD control packets. The device considers that the session is down if it does not receive any BFD control packets within a specific interval.

BFD version 0 does not support this command. The configuration does not take effect.

Examples

# Enable the Demand BFD session mode on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] bfd demand enable

bfd detect-interface

Use bfd detect-interface source-ip to create a BFD session for detecting the local interface state.

Use undo bfd detect-interface to remove the BFD session.

Syntax

bfd detect-interface source-ip ip-address

undo bfd detect-interface

Default

No BFD session is created for detecting the local interface state.

Views

Interface view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for BFD control packets.

Usage guidelines

For BFD detection to take effect, do not configure this command on both a Layer 3 Ethernet interface and its subinterface.

This command implements fast collaboration between interface state and BFD session state. When BFD detects a link fault, it sets the link layer protocol state to DOWN(BFD). This behavior helps applications relying on the link layer protocol state achieve fast convergence. The member ports in Layer 3 aggregation groups do not have IP addresses, and they do not support fast detection mechanisms. You can use this command to detect link faults and locate faulty member ports of Layer 3 aggregate interfaces. This command applies to common Layer 3 Ethernet interfaces, member ports in Layer 3 aggregation groups, Ethernet subinterfaces, and VLAN interfaces.

Before you configure this command, you must enable the BFD control packet mode on both ends of the BFD session. The destination IP address for BFD control packets is 224.0.0.184, and it cannot be configured.

As a best practice, configure the IP address of the interface as the source IP address. If the interface has no IP address configured, configure a unicast address other than 0.0.0.0.

If you configure both the bfd detect-interface and bfd echo enable commands for an interface, only the bfd detect-interface command takes effect.

Examples

# Create a BFD session to detect the state of GigabitEthernet 1/0/1, and specify the source IP address as 20.1.1.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] bfd detect-interface source-ip 20.1.1.1

bfd detect-multiplier

Use bfd detect-multiplier to set the single-hop detection time multiplier.

Use undo bfd detect-multiplier to restore the default.

Syntax

bfd detect-multiplier value

undo bfd detect-multiplier

Default

The single-hop detection time multiplier is 5.

Views

Interface view

BFD template view

Predefined user roles

network-admin

Parameters

value: Specifies a single-hop detection time multiplier in the range of 3 to 50.

Usage guidelines

The detection time multiplier determines the maximum number of concurrent BFD packets (including control packets and echo packets) that can be discarded.

Table 21 Detection interval calculation method

Mode

Detection interval

Echo packet mode

Detection time multiplier of the sender × actual packet sending interval of the sender

Control packet mode BFD session in asynchronous mode

Detection time multiplier of the receiver × actual packet sending interval of the receiver

Control packet mode BFD session in demand mode

Detection time multiplier of the sender × actual packet sending interval of the sender

 

Examples

# Set the single-hop detection time multiplier to 6 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] bfd detect-multiplier 6

bfd echo enable

Use bfd echo enable to enable the echo packet mode.

Use undo bfd echo enable to disable the echo packet mode.

Syntax

bfd echo [ receive | send ] enable

undo bfd echo [ receive | send ] enable

Default

The echo packet mode is disabled.

Views

Interface view

Predefined user roles

network-admin

Parameters

receive: Specifies the echo packet receiving capability.

send: Specifies the echo packet sending capability.

Usage guidelines

If you enable the echo packet mode for a BFD session in which control packets are sent and the session comes up, BFD performs the following operations:

·     Periodically sends echo packets to detect link connectivity.

·     Decreases the control packet receiving rate at the same time.

To enable only the echo packet receiving capability, use the bfd echo receive enable command.

To enable only the echo packet sending capability, use the bfd echo send enable command.

If you do not specify the receive or send keyword, the command enables both the echo packet receiving and sending capabilities.

If you configure both the bfd detect-interface and bfd echo enable commands for an interface, only the bfd detect-interface command takes effect.

BFD version 0 does not support this command. The configuration does not take effect.

Examples

# Enable the echo packet mode on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] bfd echo enable

bfd echo-source-ip

Use bfd echo-source-ip to configure the source IP address of BFD echo packets.

Use undo bfd echo-source-ip to remove the configured source IP address of BFD echo packets.

Syntax

bfd echo-source-ip ip-address

undo bfd echo-source-ip

Default

No source IP address is configured for BFD echo packets.

Views

System view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address of BFD echo packets.

Usage guidelines

The source IP address cannot be on the same network segment as any local interface's IP address. Otherwise, a large number of ICMP redirect packets might be sent from the peer, resulting in link congestion.

Examples

# Configure the source IP address of BFD echo packets as 8.8.8.8.

<Sysname> system-view

[Sysname] bfd echo-source-ip 8.8.8.8

bfd echo-source-ipv6

Use bfd echo-source-ipv6 to configure the source IPv6 address of BFD echo packets.

Use undo bfd echo-source-ipv6 to remove the configured source IPv6 address of BFD echo packets.

Syntax

bfd echo-source-ipv6 ipv6-address

undo bfd echo-source-ipv6

Default

No source IPv6 address is configured for BFD echo packets.

Views

System view

Predefined user roles

network-admin

Parameters

ipv6-address: Specifies the source IPv6 address for BFD echo packets.

Usage guidelines

The source IPv6 address of echo packets can only be a global unicast address.

The source IPv6 address cannot be on the same network segment as any local interface's IP address. Otherwise, a large number of ICMP redirect packets might be sent from the peer, resulting in link congestion.

Examples

# Configure the source IPv6 address of BFD echo packets as 80::2.

<Sysname> system-view

[Sysname] bfd echo-source-ipv6 80::2

bfd init-fail timer

Use bfd init-fail-timer to set the delay timer for BFD to notify upper-layer protocols of session establishment failures.

Use undo bfd init-fail-timer to restore the default.

Syntax

bfd init-fail-timer seconds

undo bfd init-fail-timer

Default

BFD does not notify upper-layer protocols of session establishment failures.

Views

System view

Predefined user roles

network-admin

Parameters

seconds: Specifies the delay timer in the range of 5 to 600 seconds.

Usage guidelines

This command takes effect only for control packet mode.

In some cases, for an upper-layer protocol to act correctly, BFD must notify the upper-layer protocol of session establishment failures. For example, with this command configured, the link aggregation module can promptly set the state of a member port from Selected to Unselected in the case of a link failure.

For session establishment failures caused by configuration mismatches at the two ends, this command can cause the upper-layer protocol to act incorrectly. Therefore, use this command with caution. BFD status mismatch and BFD authentication configuration mismatch are examples of configuration mismatches.

Examples

# Set the delay timer to 10 seconds for BFD to notify upper-layer protocols of session establishment failures.

<Sysname> system-view

[Sysname] bfd init-fail-timer 10

bfd min-echo-receive-interval

Use bfd min-echo-receive-interval to set the minimum interval for receiving BFD echo packets.

Use undo bfd min-echo-receive-interval to restore the default.

Syntax

bfd min-echo-receive-interval interval

undo bfd min-echo-receive-interval

Default

The minimum interval for receiving BFD echo packets is 1000 milliseconds.

Views

Interface view

Predefined user roles

network-admin

Parameters

interval: Specifies the minimum interval for receiving BFD echo packets, in milliseconds.

The following matrix shows the value ranges for the interval argument:

 

Hardware

Value range

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/MSR810-W-LM-HK/810-LMS/810-LUS

0; 30 to 10000

MSR2600-6-X1/2600-10-X1

0; 30 to 10000

MSR 2630

0; 30 to 10000

MSR3600-28/3600-51

0; 30 to 10000

MSR3600-28-SI/3600-51-SI

0; 30 to 10000

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC

0; 10 to 10000

MSR 3610/3620/3620-DP/3640/3660

0; 10 to 10000

MSR5620/5660/5680

0; 10 to 10000

 

Hardware

Value range

MSR810-LM-GL

0; 30 to 10000

MSR810-W-LM-GL

0; 30 to 10000

MSR830-6EI-GL

0; 30 to 10000

MSR830-10EI-GL

0; 30 to 10000

MSR830-6HI-GL

0; 30 to 10000

MSR830-10HI-GL

0; 30 to 10000

MSR2600-6-X1-GL

0; 30 to 10000

MSR3600-28-SI-GL

0; 30 to 10000

 

Usage guidelines

This command sets the BFD echo packet receiving interval, which is the actual BFD echo packet sending interval.

The local end stops sending echo packets after autonegotiation with the remote end if the following conditions are met:

·     The echo packet mode is enabled on the local end.

·     The minimum interval for receiving BFD echo packets is set to 0 milliseconds on the remote end.

Examples

# Set the minimum interval for receiving BFD echo packets to 500 milliseconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] bfd min-echo-receive-interval 500

bfd min-receive-interval

Use bfd min-receive-interval to set the minimum interval for receiving single-hop BFD control packets.

Use undo bfd min-receive-interval to restore the default.

Syntax

bfd min-receive-interval interval

undo bfd min-receive-interval

Default

The minimum interval for receiving single-hop BFD control packets is 1000 milliseconds.

Views

Interface view

BFD template view

Predefined user roles

network-admin

Parameters

interval: Specifies the minimum interval for receiving single-hop BFD control packets, in milliseconds.

The following matrix shows the value ranges for the interval argument:

 

Hardware

Value range

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/MSR810-W-LM-HK/810-LMS/810-LUS

30 to 10000

MSR2600-6-X1/2600-10-X1

30 to 10000

MSR 2630

30 to 10000

MSR3600-28/3600-51

30 to 10000

MSR3600-28-SI/3600-51-SI

30 to 10000

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC

10 to 10000

MSR 3610/3620/3620-DP/3640/3660

10 to 10000

MSR5620/5660/5680

10 to 10000

 

Hardware

Value range

MSR810-LM-GL

0; 30 to 10000

MSR810-W-LM-GL

0; 30 to 10000

MSR830-6EI-GL

30 to 10000

MSR830-10EI-GL

30 to 10000

MSR830-6HI-GL

30 to 10000

MSR830-10HI-GL

30 to 10000

MSR2600-6-X1-GL

0; 30 to 10000

MSR3600-28-SI-GL

0; 30 to 10000

 

Usage guidelines

Use this command to prevent the control packet sending rate of the peer end from exceeding the control packet receiving rate of the local end.

The actual control packet sending interval of the peer end takes the greater value between the following values:

·     Minimum interval for transmitting BFD control packets on the peer end.

·     Minimum interval for receiving BFD control packets on the local end.

Examples

# Set the minimum interval for receiving single-hop BFD control packets to 500 milliseconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] bfd min-receive-interval 500

bfd min-transmit-interval

Use bfd min-transmit-interval to set the minimum interval for transmitting single-hop BFD control packets.

Use undo bfd min-transmit-interval to restore the default.

Syntax

bfd min-transmit-interval interval

undo bfd min-transmit-interval

Default

The minimum interval for transmitting single-hop BFD control packets is 1000 milliseconds.

Views

Interface view

BFD template view

Predefined user roles

network-admin

Parameters

interval: Specifies the minimum interval for transmitting single-hop BFD control packets, in milliseconds.

The following matrix shows the value ranges for the interval argument:

 

Hardware

Value range

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/MSR810-W-LM-HK/810-LMS/810-LUS

30 to 10000

MSR2600-6-X1/2600-10-X1

30 to 10000

MSR 2630

30 to 10000

MSR3600-28/3600-51

30 to 10000

MSR3600-28-SI/3600-51-SI

30 to 10000

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC

10 to 10000

MSR 3610/3620/3620-DP/3640/3660

10 to 10000

MSR5620/5660/5680

10 to 10000

 

Hardware

Value range

MSR810-LM-GL

0; 30 to 10000

MSR810-W-LM-GL

0; 30 to 10000

MSR830-6EI-GL

30 to 10000

MSR830-10EI-GL

30 to 10000

MSR830-6HI-GL

30 to 10000

MSR830-10HI-GL

30 to 10000

MSR2600-6-X1-GL

0; 30 to 10000

MSR3600-28-SI-GL

30 to 10000

 

Usage guidelines

Use this command to prevent the BFD packet sending rate from exceeding the device capability. The actual BFD control packet transmitting interval on the local end is the greater value between the following values:

·     Minimum interval for transmitting BFD control packets on the local end.

·     Minimum interval for receiving BFD control packets on the peer end.

Examples

# Set the minimum interval for transmitting single-hop BFD control packets to 500 milliseconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] bfd min-transmit-interval 500

bfd multi-hop authentication-mode

Use bfd multi-hop authentication-mode to configure the authentication mode for multihop BFD control packets.

Use undo bfd multi-hop authentication-mode to restore the default.

Syntax

bfd multi-hop authentication-mode { m-md5 | m-sha1 | md5 | sha1 | simple } key-id { cipher | plain } string

undo bfd multi-hop authentication-mode

Default

No authentication is performed.

Views

System view

Predefined user roles

network-admin

Parameters

m-md5: Specifies the Meticulous MD5 algorithm.

m-sha1: Specifies the Meticulous SHA1 algorithm.

md5: Specifies the MD5 algorithm.

sha1: Specifies the SHA1 algorithm.

simple: Specifies the simple authentication mode.

key-id: Sets the authentication key ID in the range of 1 to 255.

cipher: Specifies a key in encrypted form.

plain: Specifies a key in plaintext form. For security purposes, the key specified in plaintext form will be stored in encrypted form.

string: Specifies the key. Its plaintext form is a case-sensitive string of 1 to 16 characters. Its encrypted form is a case-sensitive string of 33 to 53 characters.

Usage guidelines

Use this command to enhance BFD session security.

BFD version 0 does not support this command. The configuration does not take effect.

Examples

# Configure the simple authentication mode for multihop BFD control packets, setting the authentication key ID to 1 and key to 123456.

<Sysname> system-view

[Sysname] bfd multi-hop authentication-mode simple 1 plain 123456

bfd multi-hop destination-port

Use bfd multi-hop destination-port to configure the destination port number for multihop BFD control packets.

Use undo bfd multi-hop destination-port to restore the default.

Syntax

bfd multi-hop destination-port port-number

undo bfd multi-hop destination-port

Default

The destination port number for multihop BFD control packets is 4784.

Views

System view

Predefined user roles

network-admin

Parameters

port-number: Specifies the destination port number of multihop BFD control packets, 3784 or 4784.

Examples

# Specify the destination port number for multihop BFD control packets as 3784.

<Sysname> system-view

[Sysname] bfd multi-hop destination-port 3784

bfd multi-hop detect-multiplier

Use bfd multi-hop detect-multiplier to set the multihop detection time multiplier.

Use undo bfd multi-hop detect-multiplier to restore the default.

Syntax

bfd multi-hop detect-multiplier value

undo bfd multi-hop detect-multiplier

Default

The multihop detection time multiplier is 5.

Views

System view

Predefined user roles

network-admin

Parameters

value: Specifies the multihop detection time multiplier in the range of 3 to 50.

Usage guidelines

The detection time multiplier determines the maximum number of concurrent BFD control packets that can be discarded.

Table 22 Detection interval calculation method

Mode

Detection interval

Control packet mode BFD session in asynchronous mode

Detection time multiplier of the receiver × actual packet sending interval of the receiver

Control packet mode BFD session in demand mode

Detection time multiplier of the sender × actual packet sending interval of the sender

 

Examples

# Set the multihop detection time multiplier to 6.

<Sysname> system-view

[Sysname] bfd multi-hop detect-multiplier 6

bfd multi-hop min-receive-interval

Use bfd multi-hop min-receive-interval to set the minimum interval for receiving multihop BFD control packets.

Use undo bfd multi-hop min-receive-interval to restore the default.

Syntax

bfd multi-hop min-receive-interval interval

undo bfd multi-hop min-receive-interval

Default

The minimum interval for receiving multihop BFD control packets is 1000 milliseconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the minimum interval for receiving multihop BFD control packets, in milliseconds.

The following matrix shows the value ranges for the interval argument:

 

Hardware

Value range

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/MSR810-W-LM-HK/810-LMS/810-LUS

30 to 10000

MSR2600-6-X1/2600-10-X1

30 to 10000

MSR 2630

30 to 10000

MSR3600-28/3600-51

30 to 10000

MSR3600-28-SI/3600-51-SI

30 to 10000

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC

10 to 10000

MSR 3610/3620/3620-DP/3640/3660

10 to 10000

MSR5620/5660/5680

10 to 10000

 

Hardware

Value range

MSR810-LM-GL

0; 30 to 10000

MSR810-W-LM-GL

0; 30 to 10000

MSR830-6EI-GL

30 to 10000

MSR830-10EI-GL

30 to 10000

MSR830-6HI-GL

30 to 10000

MSR830-10HI-GL

30 to 10000

MSR2600-6-X1-GL

0; 30 to 10000

MSR3600-28-SI-GL

30 to 10000

 

Usage guidelines

Use this command to prevent the packet sending rate of the peer end from exceeding the packet receiving capability (minimum control packet receiving interval) of the local end. If the receiving capability is exceeded, the peer end dynamically adjusts the BFD control packet sending interval to the minimum control packet receiving interval of the local end.

Examples

# Set the minimum interval for receiving multihop BFD control packets to 500 milliseconds.

<Sysname> system-view

[Sysname] bfd multi-hop min-receive-interval 500

bfd multi-hop min-transmit-interval

Use bfd multi-hop min-transmit-interval to set the minimum interval for transmitting multihop BFD control packets.

Use undo bfd multi-hop min-transmit-interval to restore the default.

Syntax

bfd multi-hop min-transmit-interval interval

undo bfd multi-hop min-transmit-interval

Default

The minimum interval for transmitting multihop BFD control packets is 1000 milliseconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the minimum interval for transmitting multihop BFD control packets, in milliseconds.

The following matrix shows the value ranges for the interval argument:

 

Hardware

Value range

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/MSR810-W-LM-HK/810-LMS/810-LUS

30 to 10000

MSR2600-6-X1/2600-10-X1

30 to 10000

MSR 2630

30 to 10000

MSR3600-28/3600-51

30 to 10000

MSR3600-28-SI/3600-51-SI

30 to 10000

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC

10 to 10000

MSR 3610/3620/3620-DP/3640/3660

10 to 10000

MSR5620/5660/5680

10 to 10000

 

Hardware

Value range

MSR810-LM-GL

0; 30 to 10000

MSR810-W-LM-GL

0; 30 to 10000

MSR830-6EI-GL

30 to 10000

MSR830-10EI-GL

30 to 10000

MSR830-6HI-GL

30 to 10000

MSR830-10HI-GL

30 to 10000

MSR2600-6-X1-GL

0; 30 to 10000

MSR3600-28-SI-GL

30 to 10000

 

Usage guidelines

Use this command to prevent the BFD packet sending rate from exceeding the device capability. The actual BFD control packet transmitting interval on the local end is the greater value between the following values:

·     Minimum interval for transmitting BFD control packets on the local end.

·     Minimum interval for receiving BFD control packets on the peer end.

Examples

# Set the minimum interval for transmitting multihop BFD control packets to 500 milliseconds.

<Sysname> system-view

[Sysname] bfd multi-hop min-transmit-interval 500

bfd session init-mode

Use bfd session init-mode to configure the mode for establishing a BFD session.

Use undo bfd session init-mode to restore the default.

Syntax

bfd session init-mode { active | passive }

undo bfd session init-mode

Default

BFD uses the active mode.

Views

System view

Predefined user roles

network-admin

Parameters

active: Specifies the active mode. In active mode, BFD actively transmits BFD control packets to the remote device, regardless of whether it receives a BFD control packet from the remote device.

passive: Specifies the passive mode. In passive mode, BFD does not actively transmit a BFD control packet to the remote end; it transmits a BFD control packet only after receiving a BFD control packet from the remote end.

Usage guidelines

A minimum of one end must operate in active mode for a BFD session to be established.

BFD version 0 does not support this command. The configuration does not take effect.

Examples

# Configure the session establishment mode as passive.

<Sysname> system-view

[Sysname] bfd session init-mode passive

bfd template

Use bfd template to create a BFD template and enter its view, or enter the view of an existing BFD template.

Use undo bfd template to delete the BFD template.

Syntax

bfd template template-name

undo bfd template template-name

Default

No BFD templates exist.

Views

System view

Predefined user roles

network-admin

Parameters

template-name: Specifies the template name, a case-sensitive string of 1 to 63 characters.

Examples

# Create BFD template bfd1 and enter BFD template view.

<Sysname> system-view

[Sysname] bfd template bfd1

[Sysname-bfd-template-bfd1]

display bfd session

Use display bfd session to display BFD session information.

Syntax

display bfd session [ discriminator value | verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

discriminator value: Specifies a local ID in the range of 1 to 4294967295. If this option is not specified, the command displays brief information about all BFD sessions.

verbose: Displays detailed BFD session information. If this keyword is not specified, the command displays brief BFD session information.

Examples

# Display all IPv4 BFD session information.

<Sysname> display bfd session

 

 Total Session Num: 1     Up Session Num: 1     Init Mode: Active

 

 IPv4 Session Working Under Ctrl Mode:

 

 LD/RD          SourceAddr      DestAddr        State    Holdtime    Interface

 513/513        1.1.1.1         1.1.1.2         Up       2297ms      GE1/0/1

# Display all IPv6 BFD session information.

<Sysname> display bfd session

 

 Total Session Num: 1     Up Session Num: 1     Init Mode: Active

 

 IPv6 Session Working Under Ctrl Mode:

 

       Local Discr: 513                  Remote Discr: 513

         Source IP: FE80::20C:29FF:FED4:7171

    Destination IP: FE80::20C:29FF:FE72:AC4D

     Session State: Up                      Interface: GE1/0/2

# Display detailed IPv4 BFD session information.

<Sysname> display bfd session verbose

 

 Total Session Num: 1     Up Session Num: 1     Init Mode: Active

 

 IPv4 Session Working Under Ctrl Mode:

 

       Local Discr: 513                  Remote Discr: 513

         Source IP: 1.1.1.1            Destination IP: 1.1.1.2

     Session State: Up                      Interface: GigabitEthernet1/0/1

      Min Tx Inter: 500ms                Act Tx Inter: 500ms

      Min Rx Inter: 500ms                Detect Inter: 2500ms

          Rx Count: 42                       Tx Count: 43

      Connect Type: Direct             Running Up for: 00:00:20

         Hold Time: 2078ms                  Auth mode: None

       Detect Mode: Async                        Slot: 0

          Protocol: OSPF

           Version: 1

         Diag Info: No Diagnostic

# Display detailed IPv6 BFD session information.

<Sysname> display bfd session verbose

 

 Total Session Num: 1     Up Session Num: 1     Init Mode: Active

 

 IPv6 Session Working Under Ctrl Mode:

 

       Local Discr: 513                  Remote Discr: 513

         Source IP: FE80::20C:29FF:FED4:7171

    Destination IP: FE80::20C:29FF:FE72:AC4D

     Session State: Up                      Interface: GigabitEthernet1/0/2

      Min Tx Inter: 500ms                Act Tx Inter: 500ms

      Min Rx Inter: 500ms                Detect Inter: 2500ms

          Rx Count: 38                       Tx Count: 38

      Connect Type: Direct             Running Up for: 00:00:15

         Hold Time: 2211ms                  Auth mode: None

       Detect Mode: Async                        Slot: 0

          Protocol: OSPFv3

           Version: 1

         Diag Info: No Diagnostic

Table 23 Command output

Field

Description

Total Session Num

Total number of BFD sessions.

Up Session Num

Total number of active BFD sessions.

Init Mode

BFD operating mode: Active or passive.

Session Working Under Ctrl Mode

IPv4/IPv6 BFD session mode:

·     Ctrl—Control packet mode.

·     Echo—Echo packet mode.

Local Discr/LD

Local ID of the session.

Remote Discr/RD

Remote ID of the session.

Source IP/SourceAddr

Source IP address of the session.

Destination IP/DestAddr

Destination IP address of the session.

Session State/State

Session state: Down, Init, or Up.

Interface

Name of the interface of the session.

Min Tx Inter

Minimum transmit interval.

Min Rx Inter

Minimum receive interval.

Act Tx Inter

Actual transmit interval.

Detect Inter

Actual session detection timer.

Rx Count

Number of packets received.

Tx Count

Number of packets sent.

Hold Time/Holdtime

Length of time before session detection timer expires.

For a BFD session in down state, this field displays 0ms.

Auth mode

Session authentication mode.

Connect Type

Connection type of the interface: Direct or indirect.

Running up for

Time period for which the session has been up.

Detect Mode

Detection mode:

·     Async—Asynchronous mode.

·     Demand—Demand mode.

·     Async/Echo—Asynchronous mode with echo detection enabled.

·     Demand/Echo—Demand mode with echo detection enabled.

Slot

Slot number.

Diag Info

Diagnostic information about the session.

 

reset bfd session statistics

Use reset bfd session statistics to clear the BFD session statistics.

Syntax

reset bfd session statistics

Views

User view

Predefined user roles

network-admin

Examples

# Clear the BFD session statistics.

<Sysname> reset bfd session statistics

snmp-agent trap enable bfd

Use snmp-agent trap enable bfd to enable SNMP notifications for BFD.

Use undo snmp-agent trap enable bfd to disable SNMP notifications for BFD.

Syntax

snmp-agent trap enable bfd

undo snmp-agent trap enable bfd

Default

All SNMP notifications are enabled for BFD.

Views

System view

Predefined user roles

network-admin

Usage guidelines

To report critical BFD events to an NMS, enable SNMP notifications for BFD. For BFD event notifications to be sent correctly, you must also configure SNMP as described in the network management and monitoring configuration guide for the device.

Examples

# Disable SNMP notifications for BFD.

<Sysname> system-view

[Sysname] undo snmp-agent trap enable bfd


Track commands

delay

Use delay to set the period of time that the Track module must wait before notifying the application module of track entry state changes.

Use undo delay to remove the notification delay configuration.

Syntax

delay { negative negative-time | positive positive-time } *

undo delay

Default

The Track module notifies the application module immediately when the track entry state changes.

Views

Track view

Predefined user roles

network-admin

Parameters

negative negative-time: Specifies the delay for notifying the application module that the track entry state has changed to Negative. The negative-time argument represents the negative state notification delay in the range of 1 to 300 seconds.

positive positive-time: Specifies the delay for notifying the application module that the track entry state has changed to Positive. The positive-time argument represents the positive state notification delay in the range of 1 to 300 seconds.

Usage guidelines

If the Track module immediately notifies the application module of a track entry state change but the route convergence is not complete, a communication failure might occur. In such cases, you can set a notification delay to avoid immediate notification of track entry status changes.

The notification delay settings do not take effect if the track entry is not associated with an application module.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the negative state notification delay to 50 seconds and the positive state notification delay to 30 seconds for Boolean OR tracked list 101.

<Sysname> system-view

[Sysname] track 101 list boolean or

[Sysname-track-101] delay negative 50 positive 120

Related commands

track bfd

track interface

track ip route reachability

track list boolean

track list threshold percentage

track list threshold weight

track nqa

display track

Use display track to display track entry information.

Syntax

display track { track-entry-number | all [ negative | positive ] } [ brief ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

all: Specifies all track entries.

negative: Displays track entries in Negative state.

positive: Displays track entries in Positive state.

brief: Displays brief information about track entries.

Examples

# Display information about all track entries.

<Sysname> display track all

Track ID: 1

  State: Positive

  Duration: 0 days 0 hours 0 minutes 7 seconds

  Tracked object type: NQA

  Notification delay: Positive 20, Negative 30 (in seconds)

  Tracked object:

    NQA entry: admin test

    Reaction: 10

    Remote IP/URL: 2.2.2.2

    Local IP: 1.1.1.1

    Interface: GigabitEthernet1/0/1

  Tracked by:

    Track-list 6

    Track-list 7

Track ID: 2

  State: NotReady

  Duration: 0 days 0 hours 0 minutes 32 seconds

  Tracked object type: BFD

  Notification delay: Positive 20, Negative 30 (in seconds)

  Tracked object:

    BFD session mode: Echo

    Outgoing interface: GigabitEthernet1/0/1

    VPN instance name: --

    Remote IP: 192.168.40.1

    Local IP: 192.168.40.2

Track ID: 3

  State: Negative

  Duration: 0 days 0 hours 0 minutes 32 seconds

  Tracked object type: Interface

  Notification delay: Positive 20, Negative 30 (in seconds)

  Tracked object:

    Interface: GigabitEthernet1/0/2

    Protocol: IPv4

  Tracked by:

    Track-list 6

    Track-list 7

Track ID: 4

  State: Positive

  Duration: 0 days 0 hours 0 minutes 32 seconds

  Tracked object type: Route

  Notification delay: Positive 20, Negative 30 (in seconds)

  Tracked object:

    IP route: 0.0.0.0/0 reachability

    VPN instance name: --

    Protocol: BGP

    Nexthop interface : GigabitEthernet1/0/3

Track ID: 5

  State: Positive

  Duration: 0 days 0 hours 0 minutes 32 seconds

  Tracked object type: Percentage threshold list

  Notification delay: Positive 20, Negative 30 (in seconds)

  Threshold: Positive 40, Negative 30

  Percentage of positive objects: 50%

  Tracked objects:

    Object 1: Positive

    Object 3: Negative

Track ID: 6

  State: Positive

  Duration: 0 days 0 hours 0 minutes 32 seconds

  Tracked object type: Weight threshold list

  Notification delay: Positive 20, Negative 30 (in seconds)

  Threshold: Positive 50, Negative 30

  Positive weight/total weight: 50/80

  Tracked objects:

    Object 1: Positive, Weight: 50

Object 3: Negative, Weight: 30

Track ID: 7

  State: Positive

  Duration: 0 days 0 hours 0 minutes 32 seconds

  Tracked object type: Boolean and list

  Notification delay: Positive 20, Negative 30 (in seconds)

  Tracked objects:

    Object 1: Positive

    Object 3: Negative(not)

    Object 10: NotReady(not)

# Display brief information about track entries in Negative state.

<Sysname> display track all negative brief

ID   Status   Type      Remote IP/URL   Local IP        Interface

1    Negative Interface --              --              GE1/0/1

10   Negative Interface --              --              GE1/0/2

12   Negative List      --              --              --

Table 24 Command output

Field

Description

Track ID

ID of a track entry.

State

States of a track entry:

·     Positive—The tracked object operates correctly.

·     NotReady—The tracked object is invalid.

·     Negative—The tracked object is abnormal.

Duration

Time period during which the track entry stays in the state.

Type

Tracked object type:

·     BFD.

·     Interface.

·     Route.

·     NQA.

·     List—Tracked list.

This field is displayed only when the display track brief command is executed.

Tracked object type

Tracked object type:

·     BFD.

·     Interface.

·     Route.

·     NQA.

·     Boolean and list—Boolean AND list.

·     Boolean or list—Boolean OR list.

·     Percentage threshold list.

·     Weight threshold list.

Notification delay: Positive 20, Negative 30 (in seconds)

·     The Track module notifies the application modules that the status of the track entry changes to Positive after a delay time of 20 seconds.

·     The Track module notifies the application modules that the status of the track entry changes to Negative after a delay time of 30 seconds.

Threshold: Positive 40, Negative 30

Positive and negative state thresholds.

This field is displayed only when the tracked object type is Percentage threshold list or Weight threshold list.

Percentage of positive objects

Percentage of Positive objects in the tracked list.

This field is displayed only when the tracked object type is Percentage threshold list.

Positive weight/total weight: 50/80

Weight of Positive objects to the total weight of all objects in the tracked list.

This field is displayed only when the tracked object type is Weight threshold list.

Notification delay: Positive 20, Negative 30 (in seconds)

·     The Track module notifies the application modules that the status of the track entry changes to Positive after a delay time of 20 seconds.

·     The Track module notifies the application modules that the status of the track entry changes to Negative after a delay time of 30 seconds.

Tracked object

Tracked object associated with the track entry.

NQA entry

NQA operation associated with the track entry.

Reaction

Reaction entry associated with the track entry.

BFD session mode

BFD session mode. Only echo mode is supported.

Outgoing interface

Outgoing interface of the packets.

VPN instance name

Name of the VPN instance to which the packets belong. If the packets belong to the public network, two consecutive hyphens (--) are displayed.

Remote IP/URL

Remote IP address or URL. If no remote IP address or URL exists, two consecutive hyphens (--) are displayed.

Local IP

Local IP address. If no local IP address exists, two consecutive hyphens (--) are displayed..

Interface

Interface to be monitored. If no interface is to be monitored, two consecutive hyphens (--) are displayed.

Protocol

Link states or Layer 3 protocol states of the monitored interface:

·     None—Link status of the monitored interface.

·     IPv4—IPv4 protocol status of the monitored Layer 3 interface.

·     IPv6—IPv6 protocol status of the monitored Layer 3 interface.

IP route

Route associated with the track entry.

VPN instance name

Name of the VPN instance to which the route belongs. If the route belongs to the public network, two consecutive hyphens (--) are displayed.

Protocol

Protocol type of the route. If the route does not exist, N/A is displayed.

Nexthop interface

Next hop of the route. If the route does not exist, N/A is displayed.

Object 10 : Positive

State of a tracked object: Positive, NotReady, or Negative.

If the tracked object type is Weight threshold list, the weight of the object is also displayed.

If the (not) attribute is displayed, the tracked list will negate the state of the object.

Tracked by

Other track entries that are tracking the object.

Track-list 6

Tracked list that is tracking the object.

 

Related commands

track bfd

track interface

track interface protocol

track ip route reachability

track nqa

object

Use object to add a track entry as an object to a tracked list.

Use undo object remove the object from a tracked list

Syntax

object track-entry-number [ not ] [ weight weight ]

undo object track-entry-number

Default

A tracked list does not contain any objects.

Views

Track view

Predefined user roles

network-admin

Parameters

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

not: Negates the state of the object. For example, the tracked list regards the object as Negative when the object is in Positive state. This keyword is supported only by a Boolean list.

weight weight: Assigns a weight to the object, in the range of 1 to 255. This keyword is supported only by a weight threshold list. The default weight is 10.

Usage guidelines

The track entry ID of the object cannot be the same as the ID of the tracked list to which the object is added.

You can add a maximum of 16 objects to a tracked list.

Loops between track entries are not allowed. For example, after you add track entry 1 (object 1) to tracked list 2 and track entry 2 (object 2) to tracked list 3, you cannot add track entry 3 (object 3) to tracked list 1 because a loop will be created.

Examples

# Create Boolean AND list 100 and add track entries 1 and 2 as tracked objects to the list.

<Sysname> system-view

[Sysname] track 100 list boolean and

[Sysname-track-101] object 1

[Sysname-track-101] object 2 not

Related commands

track list boolean

track list threshold percentage

track list threshold weight

threshold percentage

Use threshold percentage to set the threshold values used to determine the state of a percentage threshold list.

Use undo threshold percentage to restore the default.

Syntax

threshold percentage { negative negative-threshold | positive positive-threshold } *

undo threshold percentage

Default

The negative state threshold is 0% and the positive state threshold is 1%.

Views

Track view

Predefined user roles

network-admin

Parameters

negative negative-threshold: Specifies the negative state threshold, in the range of 1 to 100. The percentage of Positive objects must be equal to or smaller than the configured negative state threshold for the tracked list to be set to the Negative state.

positive positive-threshold: Specifies the positive state threshold in the range of 1 to 100. The percentage of Positive objects must be equal to or greater than the configured positive state threshold for the tracked list to be set to the Positive state. The positive-threshold must be greater than the negative-threshold.

Usage guidelines

The state of a percentage threshold list remains unchanged if the percentage of Positive objects is below the positive state threshold and above the negative state threshold.

This command is supported only by a percentage threshold list.

Examples

# Set the negative state threshold to 30% and the positive state threshold to 50% for percentage threshold list 1.

<Sysname> system-view

[Sysname] track 1 list threshold percentage

[Sysname-track-1] threshold percentage negative 30 positive 50

Related commands

track list threshold percentage

threshold weight

Use threshold weight to set the threshold values used to determine the state of a weight threshold list.

Use undo threshold weight to restore the default.

Syntax

threshold weight { negative negative-threshold | positive positive-threshold } *

undo threshold weight

Default

The negative state threshold is 0 and the positive state threshold is 1.

Views

Track view

Predefined user roles

network-admin

Parameters

negative negative-threshold: Specifies the negative state threshold in the range of 0 to 255. The total weight of Positive objects must be equal to or smaller than the configured negative state threshold for the tracked list to be set to the Negative state.

positive positive-threshold: Specifies the positive state threshold in the range of 0 to 255. The total weight of Positive objects must be equal to or greater than the configured positive state threshold for the tracked list to be set to the Positive state. The positive-threshold must be greater than the negative-threshold.

Usage guidelines

The state of a weight threshold list remains unchanged if the total weight of Positive objects is below the positive state threshold and above the negative state threshold.

This command is supported only by a weight threshold list.

Examples

# Set the negative state threshold to 30 and the positive state threshold to 50 for weight threshold list 1.

<Sysname> system-view

[Sysname] track 1 list threshold weight

[Sysname-track-1] threshold weight negative 30 positive 50

Related commands

track list threshold weight

track bfd

Use track bfd to create a track entry associated with a BFD session and enter track entry view, or enter the view of an existing track entry.

Use undo track to remove the track entry and all configurations from its view.

Syntax

track track-entry-number bfd echo interface interface-type interface-number remote ip remote-ip-address local ip local-ip-address

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

interface interface-type interface-number: Specifies the outgoing interface by its type and number of the BFD echo packets.

remote ip remote-ip-address: Specifies the destination IP address of the BFD echo packets.

local ip local-ip-address: Specifies the source IP address of the BFD echo packets.

Usage guidelines

To create a track entry, you must specify the tracked object type, which is bfd in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track bfd command again.

When you associate Track with BFD, the virtual IP address of a VRRP group cannot be the local or remote address of a BFD session.

Examples

# Associate track entry 1 with BFD to monitor the link between local IP address 192.168.40.2 and remote IP address 192.168.40.1 by sending BFD echo packets through GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] track 1 bfd echo interface gigabitethernet 1/0/1 remote ip 192.168.40.1 local ip 192.168.40.2

[Sysname-track-1]

Related commands

delay

display track

track interface

Use track interface to create a track entry associated with the link state of an interface and enter track entry view, or enter the view of an existing track entry.

Use undo track to remove the track entry and all configurations from its view.

Syntax

track track-entry-number interface interface-type interface-number

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

interface-type interface-number: Specifies an interface by its type and number.

Usage guidelines

To create a track entry, you must specify the tracked object type, which is interface in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify the settings for a track entry, execute the undo track command to remove the track entry, and then execute the track interface command again.

When you associate Track with interface management to monitor the link status of an interface, the track entry state changes as follows:

·     The track entry state is Positive if the link state of the interface is up.

·     The track entry state is Negative if the link state of the interface is down.

To display the link state of an interface, use the display ip interface brief command.

Examples

# Create track entry 1 and associate it with the link state of GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] track 1 interface gigabitethernet 1/0/1

[Sysname-track-1]

Related commands

delay

display ip interface brief (Layer 3—IP Services Command Reference)

display track

 track interface physical

Use track interface physical to create a track entry associated with the physical state of an interface and enter track entry view, or enter the view of an existing track entry.

Use undo track to remove the track entry and all configurations from its view.

Syntax

track track-entry-number interface interface-type interface-number physical

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

interface-type interface-number: Specifies an interface by its type and number.

Usage guidelines

To create a track entry, you must specify the tracked object type, which is interface physical in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track interface physical command again.

Examples

# Create track entry 1 and associate it with the physical state of GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] track 1 interface gigabitethernet 1/0/1 physical

[Sysname-track-1]

Related commands

delay

track interface protocol

Use track interface protocol to create a track entry associated with the protocol state of an interface and enter track entry view, or enter the view of an existing track entry.

Use undo track to remove the track entry and all configurations from its view.

Syntax

track track-entry-number interface interface-type interface-number protocol { ipv4 | ipv6 }

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

interface-type interface-number: Specifies an interface by its type and number.

ipv4: Monitors the IPv4 protocol state. When the IPv4 protocol state of an interface is up, the state of the track object is Positive. When the IPv4 protocol state of an interface is down, the state of the track object is Negative. To display the IPv4 protocol state of an interface, use the display ip interface brief command.

ipv6: Monitors the IPv6 protocol state. When the IPv6 protocol state of an interface is up, the state of the track object is Positive. When the IPv6 protocol state of an interface is down, the state of the track object is Negative. To display the IPv6 protocol state of an interface, use the display ipv6 interface brief command.

Usage guidelines

To create a track entry, you must specify the tracked object type, which is interface protocol in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track interface protocol command again.

Examples

# Create track entry 1 and associate it with the IPv4 protocol state of GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] track 1 interface gigabitethernet 1/0/1 protocol ipv4

[Sysname-track-1]

Related commands

delay

display ip interface brief (Layer 3—IP Services Command Reference)

display ipv6 interface brief (Layer 3—IP Services Command Reference)

display track

track ip route reachability

Use track ip route reachability to create a track entry associated with a route entry and enter track entry view, or enter the view of an existing track entry.

Use undo track to remove the track entry and all configurations from its view.

Syntax

track track-entry-number ip route [ vpn-instance vpn-instance-name ] ip-address { mask-length | mask } reachability

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, this command creates the track entry for routes on the public network.

ip-address: Specifies the IP address of the route entry associated with the track entry in dotted decimal notation.

mask-length: Specifies the mask length in the range of 0 to 32.

mask: Specifies the mask of the IP address, in dotted decimal notation.

Usage guidelines

To create a track entry, you must specify the tracked object type, which is ip route reachability in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track ip route reachability command again.

Route management does not immediately notify the Track module of the route status changes when the following conditions are met:

·     An active/standby device switchover or a RIB process switchover has occurred.

·     The status of the monitored route entry is changed before the routing protocol completes the graceful restart.

You can resolve the problem by configuring the nonstop routing feature.

Examples

# Create track entry 1 to monitor the status of the route entry 10.1.1.0/24.

<Sysname> system-view

[Sysname] track 1 ip route 10.1.1.0 24 reachability

[Sysname-track-1]

Related commands

delay

display ip route (Layer 3—IP Routing Command Reference)

display track

track list boolean

Use track list boolean to create a Boolean tracked list and enter its view, or enter the view of an existing tracked list.

Use undo track to remove the tracked list and all configurations from its view.

Syntax

track track-entry-number list boolean { and | or }

undo track track-entry-number

Default

No tracked lists exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies an ID for the tracked list in the range of 1 to 1024.

and: Calculates the tracked list state by using the Boolean AND operation.

or: Calculates the tracked list state by using the Boolean OR operation.

Usage guidelines

The state of a Boolean list is determined by the tracked object states based on the Boolean AND or Boolean OR operation.

·     Boolean AND list—The tracked list is set to the Positive state only when all objects are in Positive state. If one or more objects are in Negative state, the tracked list is set to the Negative state.

·     Boolean OR list—The tracked list is set to the Positive state if any object is in Positive state. If all objects are in Negative state, the tracked list is set to the Negative state.

To create a track entry, you must specify the tracked object type, which is list boolean in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify the settings for a track entry, execute the undo track command to remove the track entry, and then execute the track list boolean command again.

Examples

# Create Boolean OR list 101 and enter its view.

<Sysname> system-view

[Sysname] track 101 list boolean or

[Sysname-track-101]

Related commands

delay

object

track list threshold percentage

Use track list threshold percentage to create a percentage threshold tracked list and enter its view, or enter the view of an existing tracked list.

Use undo track to remove the tracked list and all configurations from its view.

Syntax

track track-entry-number list threshold percentage

undo track track-entry-number

Default

No tracked lists exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies an ID for the tracked list in the range of 1 to 1024.

Usage guidelines

The state of a percentage threshold list is determined by comparing the percentage of Positive objects in the list with the percentage thresholds configured for the list.

To configure the threshold values used to determine the state of a percentage threshold list, use the threshold percentage command.

To create a track entry, you must specify the tracked object type, which is list threshold percentage in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify the settings for a track entry, execute the undo track command to remove the track entry, and then execute the track list threshold percentage command again.

Examples

# Create percentage threshold list 101 and enter its view.

<Sysname> system-view

[Sysname] track 101 list threshold percentage

[Sysname-track-101]

Related commands

delay

object

threshold percentage

track list threshold weight

Use track list threshold weight to create a weight threshold tracked list and enter its view, or enter the view of an existing tracked list.

Use undo track to remove the tracked list and all configurations from its view.

Syntax

track track-entry-number list threshold weight

undo track track-entry-number

Default

No tracked lists exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies an ID for the tracked list in the range of 1 to 1024.

Usage guidelines

The state of a weight threshold list is determined by comparing the weight of Positive objects in the list with the weight thresholds configured for the list.

To configure the threshold values used to determine the state of a weight threshold list, use the threshold weight command.

To create a track entry, you must specify the tracked object type, which is list threshold weight in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify the settings for a track entry, execute the undo track command to remove the track entry, and then execute the track list threshold weight command again.

Examples

# Create weight threshold tracked list 101 and enter its view.

<Sysname> system-view

[Sysname] track 101 list threshold weight

[Sysname-track-101]

Related commands

delay

object

threshold weight

track nqa

Use track nqa to create a track entry associated with the reaction entry of an NQA operation and enter track entry view, or enter the view of an existing track entry.

Use undo track to remove the track entry and all configurations from its view.

Syntax

track track-entry-number nqa entry admin-name operation-tag reaction item-number

undo track track-entry-number

Default

No track entries exist.

Views

System view

Predefined user roles

network-admin

Parameters

track-entry-number: Specifies the track entry ID in the range of 1 to 1024.

entry admin-name operation-tag: Specifies the NQA operation to be associated with the track entry. The admin-name argument specifies the name of the NQA operation administrator who creates the NQA operation, and is a case-insensitive string of 1 to 32 characters. The operation-tag argument specifies the NQA operation tag, and is a case-insensitive string of 1 to 32 characters.

reaction item-number: Specifies the reaction entry to be associated with the track entry. The item-number argument is the reaction entry ID in the range of 1 to 10.

Usage guidelines

To create a track entry, you must specify the tracked object type, which is nqa in this command.

To enter the view of an existing track entry, use the track track-entry-number command. The tracked object type is not required.

To modify other settings for the track entry, execute the undo track command to remove the track entry, and then execute the track nqa command again.

Examples

# Create track entry 1 and associate it with reaction entry 3 of NQA operation admin-test.

<Sysname> system-view

[Sysname] track 1 nqa entry admin test reaction 3

[Sysname-track-1]

Related commands

delay

display track


VRRP commands

VRRP cannot be configured on member ports of aggregation groups.

IPv4 VRRP commands

display vrrp

Use display vrrp to display the states of IPv4 VRRP groups.

Syntax

display vrrp [ interface interface-type interface-number [ vrid virtual-router-id ] ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its type and number.

vrid virtual-router-id: Specifies an IPv4 VRRP group by its virtual router ID in the range of 1 to 255.

verbose: Displays detailed IPv4 VRRP group information. If you do not specify the verbose keyword, the command displays brief IPv4 VRRP group information.

Usage guidelines

If no interface or VRRP group is specified, this command displays the states of all IPv4 VRRP groups.

If only an interface is specified, this command displays the states of all IPv4 VRRP groups on the specified interface.

If both an interface and an IPv4 VRRP group are specified, this command displays the states of the specified IPv4 VRRP group on the specified interface.

Examples

# Display brief information about all IPv4 VRRP groups on the device when VRRP operates in standard mode.

<Sysname> display vrrp

IPv4 Virtual Router Information:

 Running Mode      : Standard

 Total number of virtual routers : 1

 Interface          VRID  State        Running Adver   Auth     Virtual

                                       Pri     Timer   Type        IP

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

 GE1/0/1            1     Master       150     100     Simple   1.1.1.1

Table 25 Command output (in standard mode)

Field

Description

Running Mode

VRRP operating mode (standard mode).

Total number of virtual routers

Total number of VRRP groups.

Interface

Interface where the VRRP group is configured.

VRID

Virtual router ID (VRRP group number).

State

Status of the router in the VRRP group:

·     Master.

·     Backup.

·     Initialize.

·     Inactive.

Running Pri

Current priority of the router.

When a track entry is associated with a VRRP group on the router, the router's priority changes when the track entry's status changes.

Adver Timer

VRRP advertisement sending interval in centiseconds.

Auth Type

Authentication type:

·     None—No authentication.

·     Simple—Simple text authentication.

·     MD5—MD5 authentication.

Virtual IP

Virtual IP address of the VRRP group.

 

# Display detailed information about all IPv4 VRRP groups on the device when VRRP operates in standard mode.

<Sysname> display vrrp verbose

IPv4 Virtual Router Information:

 Running Mode      : Standard

 Total number of virtual routers : 2

   Interface GigabitEthernet1/0/1

     VRID           : 1                    Adver Timer  : 100

     Admin Status   : Up                   State        : Master

     Config Pri     : 150                  Running Pri  : 150

     Preempt Mode   : Yes                  Delay Time   : 5

     Auth Type      : Simple               Key          : ******

     Virtual IP     : 1.1.1.1

     Virtual MAC    : 0000-5e00-0101

     Master IP      : 1.1.1.2

   VRRP Track Information:

     Track Object   : 1                    State : Positive   Pri Reduced : 50

   Interface GigabitEthernet1/0/1

     VRID           : 11                   Adver Timer  : 100

     Admin Status   : Up                   State        : Backup

     Config Pri     : 80                   Running Pri  : 80

     Preempt Mode   : Yes                  Delay Time   : 0

     Become Master  : 2370ms left

     Auth Type      : None

     Virtual IP     : 1.1.1.11

     Virtual MAC    : 0000-5e00-010b

     Master IP      : 1.1.1.12

Table 26 Command output (in standard mode)

Field

Description

Running Mode

VRRP operating mode (standard mode).

Total number of virtual routers

Total number of VRRP groups.

Interface

Interface where the VRRP group is configured.

VRID

Virtual router ID (VRRP group number).

Adver Timer

VRRP advertisement sending interval in centiseconds.

Admin Status

Administrative status: Up or Down.

State

Status of the router in the VRRP group:

·     Master.

·     Backup.

·     Initialize.

·     Inactive.

Config Pri

Configured priority of the router, which is configured by using the vrrp vrid priority command.

Running Pri

Current priority of the router.

When a track entry is associated with a VRRP group on the router, the router's priority changes when the track entry's status changes.

Preempt Mode

Preemptive mode:

·     Yes.

·     No.

Delay Time

Preemption delay in centiseconds.

Become Master

Time (in milliseconds) that a backup router has to wait before it becomes the master. This field is displayed only when the router is a backup.

Auth Type

Authentication type:

·     None—No authentication.

·     Simple—Simple text authentication.

·     MD5MD5 authentication.

Key

Authentication key, which is not displayed if no authentication is required.

Virtual IP

Virtual IP address of the VRRP group.

Virtual MAC

Virtual MAC address of the VRRP group's virtual IP address, which is displayed when the router is the master.

Master IP

Primary IP address of the interface where the master resides.

VRRP Track Information

Track entry information. This field is displayed only after you configure the vrrp vrid track command.

Track Object

Track entry which is associated with the VRRP group.

State

Track entry state:

·     Negative.

·     Positive.

·     NotReady.

Pri Reduced

Value by which the priority decreases when the status of the associated track entry changes to the Negative state.

Switchover

Switchover mode. When the status of the associated track entry changes to the Negative state, the backup immediately becomes the master.

 

# Display brief information about all IPv4 VRRP groups on the device when VRRP operates in load balancing mode.

<Sysname> display vrrp

IPv4 Virtual Router Information:

 Running Mode      : Load Balance

 Total number of virtual routers : 1

 Interface          VRID  State        Running Address             Active

                                       Pri

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

 GE1/0/1            1     Master       150     1.1.1.1             Local

 -----              VF 1  Active       255     000f-e2ff-0011      Local

Table 27 Command output (in load balancing mode)

Field

Description

Running Mode

VRRP operating mode (load balancing mode).

Total number of virtual routers

Total number of VRRP groups.

Interface

Interface where the VRRP group is configured.

VRID

Virtual router ID (VRRP group number) or virtual forwarder (VF) ID.

State

·     For a VRRP group, this field indicates the state of the router in the VRRP group, which is Master, Backup, Initialize, or Inactive.

·     For a VF, this field indicates the state of the VF in the VRRP group, which is Active, Listening, or Initialize.

Running Pri

·     For a VRRP group, this field indicates the running priority of the router. When a track entry is associated with a VRRP group on the router, the router's priority changes when the track entry's status changes.

·     For a VF, this field indicates the running priority of the VF. When a track entry is associated with a VF, the priority of the VF changes if the track entry's status changes.

Address

·     For a VRRP group, this field indicates the virtual IP address of the VRRP group.

·     For a VF, this field indicates the virtual MAC address of the VF.

Active

·     For a VRRP group, this field indicates the IP address of the interface where the master resides. If the current router is the master, this field displays local.

·     For a VF, this field indicates the IP address of the interface where the active virtual forwarder (AVF) resides. If the current VF is the AVF, this field displays local.

 

# Display detailed information about all IPv4 VRRP groups on the device when VRRP operates in load balancing mode.

<Sysname> display vrrp verbose

IPv4 Virtual Router Information:

 Running Mode      : Load Balance

 Total number of virtual routers : 2

   Interface GigabitEthernet1/0/1

     VRID           : 1                    Adver Timer  : 100

     Admin Status   : Up                   State        : Master

     Config Pri     : 150                  Running Pri  : 150

     Preempt Mode   : Yes                  Delay Time   : 5

     Auth Type      : None

     Virtual IP     : 10.1.1.1

                      10.1.1.2

                      10.1.1.3

     Member IP List : 10.1.1.10 (Local, Master)

                      10.1.1.20 (Backup)

   VRRP Track Information:

     Track Object   : 1                    State : Positive   Pri Reduced : 50

   Forwarder Information: 2 Forwarders 1 Active

     Config Weight  : 255

     Running Weight : 255

    Forwarder 01

     State          : Active

     Virtual MAC    : 000f-e2ff-0011 (Owner)

     Owner ID       : 0000-5e01-1101

     Priority       : 255

     Active         : local

    Forwarder 02

     State          : Listening

     Virtual MAC    : 000f-e2ff-0012 (Learnt)

     Owner ID       : 0000-5e01-1103

     Priority       : 127

     Active         : 10.1.1.20

   Forwarder Weight Track Information:

     Track Object   : 1          State : Positive   Weight Reduced : 250

   Interface GigabitEthernet1/0/1

     VRID           : 11                   Adver Timer  : 100

     Admin Status   : Up                   State        : Backup

     Config Pri     : 80                   Running Pri  : 80

     Preempt Mode   : Yes                  Delay Time   : 0

     Become Master  : 2370ms left

     Auth Type      : None

     Virtual IP     : 10.1.1.11

                    : 10.1.1.12

                    : 10.1.1.13

     Member IP List : 10.1.1.10 (Local, Backup)

                      10.1.1.15 (Master)

   Forwarder Information: 2 Forwarders 1 Active

     Config Weight  : 255

     Running Weight : 255

    Forwarder 01

     State          : Active

     Virtual MAC    : 000f-e2ff-40b1 (Learnt)

     Owner ID       : 0000-5e01-1103

     Priority       : 127

     Active         : 10.1.1.15

    Forwarder 02

     State          : Listening

     Virtual MAC    : 000f-e2ff-40b2 (Owner)

     Owner ID       : 0000-5e01-1101

     Priority       : 255

     Active         : local

Table 28 Command output (in load balancing mode)

Field

Description

Running Mode

VRRP operating mode (load balancing mode).

Total number of virtual routers

Total number of VRRP groups.

Interface

Interface where the VRRP group is configured.

VRID

Virtual router ID (VRRP group number).

Adver Timer

VRRP advertisement sending interval in centiseconds.

Admin Status

Administrative status: Up or Down.

State

Status of the router in the VRRP group:

·     Master.

·     Backup.

·     Initialize.

·     Inactive.

Config Pri

Configured priority of the router, which is configured by using the vrrp vrid priority command.

Running Pri

Current priority of the router.

When a track entry is associated with a VRRP group on the router, the router's priority changes when the track entry's status changes.

Preempt Mode

Preemptive mode:

·     Yes.

·     No.

Delay Time

Preemption delay in centiseconds.

Become Master

Time (in milliseconds) that a backup router has to wait before it becomes the master. This field is displayed only when the router is a backup.

Auth Type

Authentication type:

·     None—No authentication.

·     Simple—Simple text authentication.

·     MD5—MD5 authentication.

Key

Authentication key, which is not displayed if no authentication is required.

Virtual IP

Virtual IP address list of the VRRP group.

Member IP List

IP addresses of the member devices in the VRRP group:

·     Local—IP address of the local router.

·     Master—IP address of the master.

·     BackupIP address of the backup.

VRRP Track Information

Track entry which is associated with the VRRP group. This field is displayed only after you configure the vrrp vrid track command.

Track Object

Track entry to be monitored.

State

Track entry state:

·     Negative.

·     Positive.

·     NotReady.

Pri Reduced

Value by which the priority decreases when the status of the associated track entry changes to the Negative state. This field is displayed only after you configure the vrrp vrid track command.

Switchover

Switchover mode. When the status of the associated track entry changes to the Negative state, the backup immediately becomes the master.

Forwarder Information: 2 Forwarders 1 Active

VF information: Two VFs exist, and one is the AVF.

Config Weight

Configured weight of the VF: 255.

Running Weight

Current weight of the VF.

When a track entry is associated with the VFs of a VRRP group, the VFs' weights change when the track entry's status changes.

Forwarder 01

Information about VF 01.

State

VF state:

·     Active.

·     Listening.

·     Initialize.

Virtual MAC

Virtual MAC address of the VF.

Owner ID

Real MAC address of the VF owner.

Priority

VF priority in the range of 1 to 255.

Active

IP address of the interface where the AVF resides. If the current VF is the AVF, this field displays local.

Forwarder Weight Track Configuration

VF weight Track configuration.

The field is displayed only after you configure the vrrp vrid track command.

Track Object

Track entry that is associated with the VFs.

The field is displayed only after you configure the vrrp vrid track command.

State

Track entry state:

·     Negative.

·     Positive.

·     NotReady.

Weight Reduced

Value by which the weights of the VFs decrease when the state of the associated track entry changes to Negative.

The field is displayed only after you configure the vrrp vrid track command.

Forwarder Switchover Track Information:

VF switchover Track configuration.

The field is displayed only after you configure the vrrp vrid track command.

Member IP

IP address of a member device.

The field is displayed only after you configure the vrrp vrid track command.

 

display vrrp statistics

Use display vrrp statistics to display statistics for IPv4 VRRP groups.

Syntax

display vrrp statistics [ interface interface-type interface-number [ vrid virtual-router-id ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its type and number.

vrid virtual-router-id: Specifies an IPv4 VRRP group by its virtual router ID in the range of 1 to 255.

Usage guidelines

If no interface or VRRP group is specified, this command displays statistics for all IPv4 VRRP groups.

If only an interface is specified, this command displays statistics for all IPv4 VRRP groups on the specified interface.

If both an interface and an IPv4 VRRP group are specified, this command displays statistics for the specified IPv4 VRRP group on the specified interface.

Examples

# Display statistics for all IPv4 VRRP groups when VRRP operates in standard mode.

<Sysname> display vrrp statistics

 Interface               : GigabitEthernet1/0/1

 VRID                    : 1

 CheckSum Errors         : 0          Version Errors                : 0

 Invalid Pkts Rcvd  :      0          Unexpected Pkts Rcvd          : 0

 IP TTL Errors           : 0          Advertisement Interval Errors : 0

 Invalid Auth Type       : 0          Auth Failures                 : 0

 Packet Length Errors    : 0          Auth Type Mismatch            : 0

 Become Master           : 1          Address List Errors           : 0

 Adver Rcvd              : 0          Priority Zero Pkts Rcvd       : 0

 Adver Sent              : 807        Priority Zero Pkts Sent       : 0

 

 Global statistics

 CheckSum Errors         : 0

 Version Errors          : 0

 VRID Errors             : 0

# Display statistics for all IPv4 VRRP groups when VRRP operates in load balancing mode.

<Sysname> display vrrp statistics

 Interface               : GigabitEthernet1/0/1

 VRID                    : 1

 CheckSum Errors         : 0          Version Errors                : 0

 Invalid Pkts Rcvd       : 0          Unexpected Pkts Rcvd          : 0

 IP TTL Errors           : 0          Advertisement Interval Errors : 0

 Invalid Auth Type       : 0          Auth Failures                 : 0

 Packet Length Errors    : 0          Auth Type Mismatch            : 0

 Become Master           : 39         Address List Errors           : 0

 Become AVF              : 13         Packet Option Errors          : 0

 Adver Rcvd              : 2562       Priority Zero Pkts Rcvd       : 1

 Adver Sent              : 16373      Priority Zero Pkts Sent       : 49

 Request Rcvd            : 2          Reply Rcvd                    : 10

 Request Sent            : 12         Reply Sent                    : 2

 Release Rcvd            : 0          VF Priority Zero Pkts Rcvd    : 1

 Release Sent            : 0          VF Priority Zero Pkts Sent    : 11

 Redirect Timer Expires  : 1          Time-out Timer Expires        : 0

 

 Global statistics

 CheckSum Errors         : 0

 Version Errors          : 0

 VRID Errors             : 0

Table 29 Command output (in standard mode)

Field

Description

Interface

Interface where the VRRP group is configured.

VRID

VRRP group number.

CheckSum Errors

Number of packets with checksum errors.

Version Errors

Number of packets with version errors.

Invalid Pkts Rcvd

Number of received packets of invalid packet types.

Unexpected Pkts Rcvd

Number of received unexpected packets.

Advertisement Interval Errors

Number of packets with advertisement interval errors.

IP TTL Errors

Number of packets with TTL errors.

Auth Failures

Number of packets with authentication failures.

Invalid Auth Type

Number of packets with authentication failures because of invalid authentication types.

Auth Type Mismatch

Number of packets with authentication failures because of mismatching authentication types.

Packet Length Errors

Number of packets with VRRP packet length errors.

Address List Errors

Number of packets with virtual IP address list errors.

Become Master

Number of times that the router has been elected as the master.

Priority Zero Pkts Rcvd

Number of received advertisements with the router priority of 0.

Adver Rcvd

Number of received advertisements.

Priority Zero Pkts Sent

Number of sent advertisements with the router priority of 0.

Adver Sent

Number of sent advertisements.

Global statistics

Global statistics for all VRRP groups.

CheckSum Errors

Total number of packets with checksum errors.

Version Errors

Total number of packets with version errors.

VRID Errors

Total number of packets with VRID errors.

 

Table 30 Command output (in load balancing mode)

Field

Description

Interface

Interface where the VRRP group is configured.

VRID

VRRP group number.

CheckSum Errors

Number of packets with checksum errors.

Version Errors

Number of packets with version errors.

Invalid Pkts Rcvd

Number of received packets of invalid packet types.

Unexpected Pkts Rcvd

Number of received unexpected packets.

Advertisement Interval Errors

Number of packets with advertisement interval errors.

IP TTL Errors

Number of packets with TTL errors.

Auth Failures

Number of packets with authentication failures.

Invalid Auth Type

Number of packets with authentication failures because of invalid authentication types.

Auth Type Mismatch

Number of packets with authentication failures because of mismatching authentication types.

Packet Length Errors

Number of packets with VRRP packet length errors.

Address List Errors

Number of packets with virtual IP address list errors.

Become Master

Number of times that the router has been elected as the master.

Redirect Timer Expires

Number of times that the redirect timer expired.

Become AVF

Number of times that the VF has been elected as the AVF.

Time-out Timer Expires

Number of times that the time-out timer expired.

Adver Rcvd

Number of received advertisements.

Request Rcvd

Number of received requests.

Adver Sent

Number of sent advertisements.

Request Sent

Number of sent requests.

Reply Rcvd

Number of received replies.

Release Rcvd

Number of received release packets.

Reply Sent

Number of sent replies.

Release Sent

Number of sent release packets.

Priority Zero Pkts Rcvd

Number of received advertisements with the router priority of 0.

VF Priority Zero Pkts Rcvd

Number of received advertisements with the VF priority of 0.

Priority Zero Pkts Sent

Number of sent advertisements with the router priority of 0.

VF Priority Zero Pkts Sent

Number of sent advertisements with the VF priority of 0.

Packet Option Errors

Number of packet option errors.

Global statistics

Global statistics for all IPv4 VRRP groups.

CheckSum Errors

Total number of packets with checksum errors.

Version Errors

Total number of packets with version errors.

VRID Errors

Total number of packets with VRID errors.

 

Related commands

reset vrrp statistics

reset vrrp statistics

Use reset vrrp statistics to clear statistics for IPv4 VRRP groups.

Syntax

reset vrrp statistics [ interface interface-type interface-number [ vrid virtual-router-id ] ]

Views

User view

Predefined user roles

network-admin

Parameters

interface interface-type interface-number: Specifies an interface by its type and number.

vrid virtual-router-id: Specifies an IPv4 VRRP group by its virtual router ID in the range of 1 to 255.

Usage guidelines

If no interface or VRRP group is specified, this command clears statistics for all IPv4 VRRP groups.

If only an interface is specified, this command clears statistics for all IPv4 VRRP groups on the specified interface.

If both an interface and an IPv4 VRRP group are specified, this command clears statistics for the specified IPv4 VRRP group on the specified interface.

Examples

# Clear statistics for all IPv4 VRRP groups on all interfaces.

<Sysname> reset vrrp statistics

Related commands

display vrrp statistics

snmp-agent trap enable vrrp

Use snmp-agent trap enable vrrp to enable SNMP notifications for VRRP.

Use undo snmp-agent trap enable vrrp to disable SNMP notifications for VRRP.

Syntax

snmp-agent trap enable vrrp [ auth-failure | new-master ]

undo snmp-agent trap enable vrrp [ auth-failure | new-master ]

Default

SNMP notifications for VRRP are enabled.

Views

System view

Predefined user roles

network-admin

Parameters

auth-failure: Generates notifications as defined in RFC 2787 when the device in a VRRP group receives a VRRP advertisement with the authentication type or key not matching the local configuration.

new-master: Generates notifications as defined in RFC 2787 when the state of a device in a VRRP group changes from Initialize or Backup to Master.

Usage guidelines

To report critical VRRP events to an NMS, enable SNMP notifications for VRRP. For VRRP event notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see the network management and monitoring configuration guide for the device.

Examples

# Generate notifications as defined in RFC 2787 when the device in a VRRP group receives a VRRP advertisement with the authentication type or key not matching the local configuration.

<Sysname> system-view

[Sysname] snmp-agent trap enable vrrp auth-failure

vrrp check-ttl enable

Use vrrp check-ttl enable to enable TTL check for IPv4 VRRP packets.

Use undo vrrp check-ttl enable to disable TTL check for IPv4 VRRP packets.

Syntax

vrrp check-ttl enable

undo vrrp check-ttl enable

Default

TTL check for IPv4 VRRP packets is enabled.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

The master in an IPv4 VRRP group periodically sends VRRP advertisements to declare its presence. The VRRP advertisements are multicast in the local subnet and cannot be forwarded by routers, so the TTL value is not changed. When the master sends VRRP advertisements, it sets the TTL value to 255. If you enable TTL check, the backups drop the VRRP advertisements with TTL other than 255, preventing attacks from other subnets.

Devices from different vendors might implement VRRP differently. When the device is interoperating with devices of other vendors, TTL check on VRRP packets might result in unexpected dropping of packets. In this scenario, use the undo vrrp check-ttl enable command to disable TTL check on VRRP packets.

Examples

# Disable TTL check for IPv4 VRRP packets.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] undo vrrp check-ttl enable

vrrp dscp

Use vrrp dscp to set a DSCP value for VRRP packets.

Use undo vrrp dscp to restore the default.

Syntax

vrrp dscp dscp-value

undo vrrp dscp

Default

The DSCP value for VRRP packets is 48.

Views

System view

Predefined user roles

network-admin

Parameters

dscp-value: Specifies a DSCP value for VRRP packets, in the range of 0 to 63.

Usage guidelines

The DSCP value identifies the packet priority during transmission. A greater DSCP value means a higher packet priority.

Examples

# Set the DSCP value to 30 for VRRP packets.

<Sysname> system-view

[Sysname] vrrp dscp 30

vrrp mode

Use vrrp mode to specify the operating mode for IPv4 VRRP.

Use undo vrrp mode to restore the default.

Syntax

vrrp mode load-balance [ version-8 ]

undo vrrp mode

Default

IPv4 VRRP operates in standard mode.

Views

System view

Predefined user roles

network-admin

Parameters

load-balance: Specifies the load balancing mode.

version-8: Specifies the version carried in VRRP packets as 8.

Usage guidelines

After you create IPv4 VRRP groups on the router, you can use this command to modify their operating mode. All IPv4 VRRP groups on the router operate in the specified mode.

The version-8 keyword takes effect only when the version of IPv4 VRRP configured on the interface is VRRPv2. The version-8 keyword is required in the following conditions:

·     A router running Comware 5 software exists in the VRRP group.

To display the software version, use the display version command.

·     All routers in the IPv4 VRRP group are operating in load balancing mode.

·     All routers in the IPv4 VRRP group are configured with the version of VRRPv2.

Examples

# Specify the load balancing mode for IPv4 VRRP.

<Sysname> system-view

[Sysname] vrrp mode load-balance

Related commands

display vrrp

vrrp version

Use vrrp version to specify the version of IPv4 VRRP on an interface.

Use undo vrrp version to restore the default.

Syntax

vrrp version version-number

undo vrrp version

Default

VRRPv3 is used.

Views

Interface view

Predefined user roles

network-admin

Parameters

version-number: Specifies a VRRP version. The version number is 2 or 3, where 2 indicates VRRPv2 (described in RFC 3768), and 3 indicates VRRPv3 (described in RFC 5798).

Usage guidelines

The version of VRRP on all routers in an IPv4 VRRP group must be the same.

Examples

# Specify VRRPv2 to run on interface GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp version 2

vrrp vrid

Use vrrp vrid to create an IPv4 VRRP group and assign a virtual IP address to it, or to assign a virtual IP address to an existing IPv4 VRRP group.

Use undo vrrp vrid to remove all configurations of an IPv4 VRRP group, or to remove a virtual IP address from an IPv4 VRRP group.

Syntax

vrrp vrid virtual-router-id virtual-ip virtual-address

undo vrrp vrid virtual-router-id [ virtual-ip [ virtual-address ] ]

Default

No IPv4 VRRP groups exist.

Views

Interface view

Predefined user roles

network-admin

Parameters

virtual-router-id: Specifies an IPv4 VRRP group by its virtual router ID in the range of 1 to 255.

virtual-ip virtual-address: Specifies a virtual IP address. You cannot specify the virtual IP address as any of the following IP addresses:

·     All-zero address (0.0.0.0).

·     Broadcast address (255.255.255.255).

·     Loopback address.

·     IP address of other than Class A, Class B, and Class C.

·     Invalid IP address (for example, 0.0.0.1).

If you do not specify the virtual-address argument, the undo vrrp vrid command removes all virtual IP addresses from the specified IPv4 VRRP group.

Usage guidelines

You can assign a maximum of 16 virtual IP addresses to an IPv4 VRRP group.

If you create an IPv4 VRRP group without assigning virtual IP address to it, the VRRP group stays in inactive state and does not function.

The virtual IP address of an IPv4 VRRP group and the downlink interface IP addresses of the VRRP group members must be in the same subnet. Otherwise, the hosts in the subnet might fail to access external networks.

For VRRP to operate correctly in load balancing mode, make sure the virtual IP address of an IPv4 VRRP group is not the IP address of any interface in the VRRP group.

Examples

# Create IPv4 VRRP group 1 and assign virtual IP address 10.10.10.10 to the VRRP group. Then assign virtual IP address 10.10.10.11 to the VRRP group.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp vrid 1 virtual-ip 10.10.10.10

[Sysname-GigabitEthernet1/0/1] vrrp vrid 1 virtual-ip 10.10.10.11

Related commands

display vrrp

vrrp vrid authentication-mode

Use vrrp vrid authentication-mode to configure the authentication mode and the authentication key for an IPv4 VRRP group to send and receive VRRP packets.

Use undo vrrp vrid authentication-mode to restore the default.

Syntax

vrrp vrid virtual-router-id authentication-mode { md5 | simple } { cipher | plain } string

undo vrrp vrid virtual-router-id authentication-mode

Default

Authentication is disabled when a VRRP group sends and receives VRRP packets.

Views

Interface view

Predefined user roles

network-admin

Parameters

virtual-router-id: Specifies an IPv4 VRRP group by its virtual router ID in the range of 1 to 255.

md5: Specifies the MD5 authentication mode.

simple: Specifies the simple authentication mode.

cipher: Specifies a key in encrypted form.

plain: Specifies a key in plaintext form. For security purposes, the key specified in plaintext form will be stored in encrypted form.

string: Specifies the key. Its plaintext form is a case-sensitive string of 1 to 8 characters. Its encrypted form is a case-sensitive string of 1 to 41 characters.

Usage guidelines

To avoid attacks from unauthorized users, VRRP member routers add authentication keys in VRRP packets to authenticate one another. VRRP provides the following authentication modes:

·     simple—Simple text authentication.

The sender fills an authentication key into the VRRP packet, and the receiver compares the received authentication key with its local authentication key. If the two authentication keys are the same, the received VRRP packet is legitimate. Otherwise, the received packet is illegitimate.

·     md5—MD5 authentication.

The sender computes a digest for the VRRP packet by using the authentication key and MD5 algorithm, and saves the result to the authentication header. The receiver performs the same operation by using the authentication key and MD5 algorithm, and it compares the result with the content in the authentication header. If the results are the same, the received VRRP packet is legitimate. Otherwise, the received packet is illegitimate.

The MD5 authentication is more secure than the simple text authentication, but it costs more resources.

 

IMPORTANT

IMPORTANT:

·     You can configure different authentication modes and authentication keys for the VRRP groups on an interface. However, members of the same VRRP group must use the same authentication mode and authentication key.

·     For VRRPv3, this command does not take effect because VRRPv3 does not support authentication.

 

Examples

# Set the authentication mode to simple and the authentication key to Sysname for VRRP group 1 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp vrid 1 authentication-mode simple plain Sysname

Related commands

display vrrp

vrrp version

vrrp vrid preempt-mode

Use vrrp vrid preempt-mode to enable the preemptive mode for the device in an IPv4 VRRP group and set the preemption delay.

Use undo vrrp vrid preempt-mode to disable the preemptive mode for the device in an IPv4 VRRP group.

Use undo vrrp vrid preempt-mode delay to restore the default preemption delay.

Syntax

vrrp vrid virtual-router-id preempt-mode [ delay delay-value ]

undo vrrp vrid virtual-router-id preempt-mode [ delay ]

Default

The device operates in preemptive mode and the preemption delay is 0 centiseconds.

Views

Interface view

Predefined user roles

network-admin

Parameters

virtual-router-id: Specifies an IPv4 VRRP group by its virtual router ID in the range of 1 to 255.

delay delay-value: Specifies the preemption delay in the range of 0 to 180000 in centiseconds.

Usage guidelines

In non-preemptive mode, the master router acts as the master as long as it operates correctly, even if a backup is assigned a higher priority later. The non-preemptive mode helps avoid frequent switchover between the master and backups.

In preemptive mode, a backup sends VRRP advertisements when it detects that it has a higher priority than the master. Then the backup takes over as the master and the previous master becomes a backup. This mechanism ensures that the master is always the device with the highest priority.

You can configure the VRRP preemption delay for the following purposes:

·     Avoid frequent state changes among members in a VRRP group.

·     Provide the backups with enough time to collect information (such as routing information).

A backup does not immediately become the master after it receives an advertisement with a lower priority than the local priority. Instead, it waits for a period of time before taking over as the master.

Examples

# Enable the preemptive mode for the device in VRRP group 1, and set the preemption delay to 5000 centiseconds.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp vrid 1 preempt-mode delay 5000

Related commands

display vrrp

vrrp vrid priority

Use vrrp vrid priority to set the priority of the device in an IPv4 VRRP group.

Use undo vrrp vrid priority to restore the default.

Syntax

vrrp vrid virtual-router-id priority priority-value

undo vrrp vrid virtual-router-id priority

Default

The priority of a device in an IPv4 VRRP group is 100.

Views

Interface view

Predefined user roles

network-admin

Parameters

virtual-router-id: Specifies an IPv4 VRRP group by its virtual router ID in the range of 1 to 255.

priority-value: Specifies a priority value in the range of 1 to 254. A higher value indicates a higher priority.

Usage guidelines

VRRP determines the role (master or backup) of each device in a VRRP group by priority. A device with a higher priority is more likely to become the master.

Priorities 1 to 254 are configurable. Priority 0 is reserved for special uses, and priority 255 is for the IP address owner. The IP address owner in a VRRP group always has a running priority of 255 and acts as the master as long as it operates correctly.

Examples

# Set the priority of the router to 150 in VRRP group 1 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp vrid 1 priority 150

Related commands

display vrrp

vrrp vrid track

vrrp vrid shutdown

Use vrrp vrid shutdown to disable an IPv4 VRRP group.

Use undo vrrp vrid shutdown to enable an IPv4 VRRP group.

Syntax

vrrp vrid virtual-router-id shutdown

undo vrrp vrid virtual-router-id shutdown

Default

An IPv4 VRRP group is enabled.

Views

Interface view

Predefined user roles

network-admin

Parameters

virtual-router-id: Specifies an IPv4 VRRP group by its virtual router ID in the range of 1 to 255.

Usage guidelines

You can use this command to temporarily disable an IPv4 VRRP group. After this command is configured, the VRRP group stays in Initialize state, and its configurations remain unchanged. You can change the configuration of the VRRP group, and your changes take effect when you enable the VRRP group again.

Examples

# Disable IPv4 VRRP group 1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp vrid 1 shutdown

vrrp vrid source-interface

Use vrrp vrid source-interface to specify the source interface for an IPv4 VRRP group, instead of the interface where the VRRP group resides, to send and receive VRRP packets.

Use undo vrrp source-interface to cancel the specified source interface.

Syntax

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

undo vrrp vrid virtual-router-id source-interface

Default

No source interface is specified for a VRRP group. The interface where the VRRP group resides sends and receives VRRP packets.

Views

Interface view

Predefined user roles

network-admin

Parameters

virtual-router-id: Specifies an IPv4 VRRP group by its virtual router ID in the range of 1 to 255.

interface-type interface-number: Specifies an interface by its type and number.

Usage guidelines

If VRRP group members cannot exchange VRRP packets through the interfaces where the VRRP group resides, use this command to specify interfaces for VRRP packet exchange.

Examples

# Specify GigabitEthernet 1/0/2 as the source interface for VRRP packet exchange in IPv4 VRRP group 10.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp vrid 10 source-interface gigabitethernet 1/0/2

vrrp vrid timer advertise

Use vrrp vrid timer advertise to set the interval at which the master in an IPv4 VRRP group sends VRRP advertisements.

Use undo vrrp vrid timer advertise to restore the default.

Syntax

vrrp vrid virtual-router-id timer advertise adver-interval

undo vrrp vrid virtual-router-id timer advertise

Default

The master in an IPv4 VRRP group sends VRRP advertisements at an interval of 100 centiseconds.

Views

Interface view

Predefined user roles

network-admin

Parameters

virtual-router-id: Specifies an IPv4 VRRP group by its virtual router ID in the range of 1 to 255.

adver-interval: Specifies an interval for the master in the specified IPv4 VRRP group to send VRRP advertisements. The value range for this argument is 10 to 4095 centiseconds. For VRRPv2, the value of the adver-interval argument can only be a multiple of 100. For example, if you configure values in the range of 10 to 100, 101 to 200, and 4001 to 4095, the actual values are 100, 200, and 4100, respectively. For VRRPv3, the configured value for the adver-interval argument takes effect.

Usage guidelines

The master in an IPv4 VRRP group periodically sends VRRP advertisements to declare its presence. You can use this command to configure the interval at which the master sends VRRP advertisements.

As a best practice to maintain system stability, set the VRRP advertisement interval to be greater than 100 centiseconds.

In VRRPv2, all routers in an IPv4 VRRP group must have the same interval for sending VRRP advertisements.

In VRRPv3, the routers in an IPv4 VRRP group can have different intervals for sending VRRP advertisements. The master in the VRRP group sends VRRP advertisements at the specified interval and carries the interval attribute in the advertisements. After a backup receives the advertisement, it records the interval in the advertisement. If the backup does not receive any VRRP advertisement when the timer (3 × recorded interval + Skew_Time) expires, it regards the master as failed and takes over.

Large network traffic might disable a backup from receiving VRRP advertisements from the master within the specified timer and trigger an unexpected master switchover. To solve this problem, you can use this command to set a larger interval.

Examples

# Configure the master in IPv4 VRRP group 1 to send VRRP advertisements at an interval of 500 centiseconds.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp vrid 1 timer advertise 500

Related commands

display vrrp

vrrp vrid track

Use vrrp vrid track to associate a VRRP group or the VFs in a VRRP group with a track entry.

Use undo vrrp vrid track to remove the association between a VRRP group or the VFs in a VRRP group and a track entry.

Syntax

vrrp vrid virtual-router-id track track-entry-number { forwarder-switchover member-ip ip-address | priority reduced [ priority-reduced ] | switchover | weight reduced [ weight-reduced ] }

undo vrrp vrid virtual-router-id track [ track-entry-number ] [ forwarder-switchover | priority reduced | switchover | weight reduced ]

Default

A VRRP group and the VFs in a VRRP group are not associated with any track entry.

Views

Interface view

Predefined user roles

network-admin

Parameters

virtual-router-id: Specifies an IPv4 VRRP group number in the range of 1 to 255.

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

forwarder-switchover member-ip ip-address: Enables the LVF on the router to take over the role of the AVF at the specified IP address immediately after the specified track entry changes to the Negative state. The ip-address argument specifies the IP address of a member router. You can use the display vrrp verbose command to view the IP addresses of the members.

priority reduced priority-reduced: Reduces the priority of the router in the VRRP group by the specified value when the state of the specified track entry changes to Negative. The value range for the priority-reduced argument is 1 to 255, and the default value is 10.

switchover: Enables the router in backup state to take over as the master immediately after the specified track entry changes to the Negative state.

weight reduced weight-reduced: Reduces the weight of all VFs on the router in the VRRP group by the specified value when the state of the specified track entry changes to Negative. The value range for the weight-reduced argument is 1 to 255, and the default value is 30.

Usage guidelines

When the associated track entry changes to the Negative state, one of the following events occurs depending on your configuration:

·     The priority of the router in the VRRP group decreases by a specified value.

·     The weight of VFs decreases by a specified value.

·     The router immediately takes over as the master if it is a backup.

·     The LVF on the router immediately takes over the role of the AVF at the specified IP address.

When the track entry changes from Negative to Positive or NotReady, one of the following events occurs:

·     The router automatically restores its priority or VF weight.

·     The failed master router becomes the master again.

·     The failed AVF becomes active again.

Before executing this command, create a VRRP group on the interface and assign a virtual IP address to the VRRP group.

The following parameters take effect only when the IPv4 VRRP group is operating in load balancing mode:

·     The forwarder-switchover member-ip ip-address option.

·     The weight reduced weight-reduced option.

·     The weight reduced keyword.

The weight of a VF is 255, and its lower limit of failure is 10.

When the weight of a VF owner is higher than or equal to the lower limit of failure, its priority is always 255. The priority does not change with the weight. When the upstream link of the VF owner fails, an LVF must take over as the AVF. The switchover occurs when the weight of the VF owner drops below the lower limit of failure. This requires that the reduced weight for the VF owner be higher than 245.

 

IMPORTANT

IMPORTANT:

·     The vrrp vrid track priority command and the vrrp vrid track switchover command do not take effect on an IP address owner. If you configure the command on an IP address owner, the configuration takes effect after the router changes to be a non-IP address owner.

·     You can create a track entry by using the track command before or after you associate it with a VRRP group or the VFs in a VRRP group. For more information about configuring track entries, see High Availability Configuration Guide.

·     If no track entry is specified, the undo vrrp vrid track command removes all associations between track entries and the VRRP group or VFs in the VRRP group.

 

Examples

# Associate VRRP group 1 on GigabitEthernet 1/0/1 with track entry 1 and decrease the router priority by 50 when the state of track entry 1 changes to Negative.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp vrid 1 track 1 priority reduced 50

# Associate the VFs of IPv4 VRRP group 1 on GigabitEthernet 1/0/1 with track entry 1. Enable the LVF to take over the role of the AVF at the IP address of 10.1.1.3 immediately after the specified track entry changes to the Negative state.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp vrid 1 track 1 forwarder-switchover member-ip 10.1.1.3

# Associate the VFs of IPv4 VRRP group 1 on GigabitEthernet 1/0/1 with track entry 1. Decrease the weight of all VFs on the router in the VRRP group by 50 when the state of track entry 1 changes to Negative.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp vrid 1 track 1 weight reduced 50

Related commands

display vrrp

IPv6 VRRP commands

display vrrp ipv6

Use display vrrp ipv6 to display the states of IPv6 VRRP groups.

Syntax

display vrrp ipv6 [ interface interface-type interface-number [ vrid virtual-router-id ] ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its type and number.

vrid virtual-router-id: Specifies an IPv6 VRRP group by its virtual router ID in the range of 1 to 255.

verbose: Displays detailed IPv6 VRRP group information. If you do not specify the verbose keyword, the command displays brief IPv6 VRRP group information.

Usage guidelines

If no interface or VRRP group is specified, this command displays the states of all IPv6 VRRP groups.

If only an interface is specified, this command displays the states of all IPv6 VRRP groups on the specified interface.

If both an interface and an IPv6 VRRP group are specified, this command displays the states of the specified IPv6 VRRP group on the specified interface.

Examples

# Display brief information about all IPv6 VRRP groups on the device when VRRP operates in standard mode.

<Sysname> display vrrp ipv6

IPv6 Virtual Router Information:

 Running Mode      : Standard

 Total number of virtual routers : 1

 Interface          VRID  State        Running Adver   Auth     Virtual

                                       Pri     Timer   Type        IP

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

 GE1/0/1            1     Master       150     100     None     FE80::1

Table 31 Command output (in standard mode)

Field

Description

Running Mode

VRRP operating mode (standard mode).

Total number of virtual routers

Total number of VRRP groups.

Interface

Interface where the VRRP group is configured.

VRID

Virtual router ID (VRRP group number).

State

Status of the router in the VRRP group:

·     Master.

·     Backup.

·     Initialize.

·     Inactive.

Running Pri

Current priority of the router.

When a track entry is associated with a VRRP group on the router, the router's priority changes when the track entry's status changes.

Adver Timer

VRRP advertisement sending interval in centiseconds.

Auth Type

Authentication type. Only none is available, which means no authentication is required.

Virtual IP

Virtual IP address of the VRRP group.

 

# Display detailed information about all IPv6 VRRP groups on the device when VRRP operates in standard mode.

<Sysname> display vrrp ipv6 verbose

IPv6 Virtual Router Information:

 Running Mode      : Standard

 Total number of virtual routers : 2

   Interface GigabitEthernet1/0/1

     VRID           : 1                    Adver Timer  : 100

     Admin Status   : Up                   State        : Master

     Config Pri     : 150                  Running Pri  : 150

     Preempt Mode   : Yes                  Delay Time   : 10

     Auth Type      : None

     Virtual IP     : FE80::1

     Virtual MAC    : 0000-5e00-0201

     Master IP      : FE80::2

   VRRP Track Information:

     Track Object   : 1                    State : Positive   Pri Reduced : 50

   Interface GigabitEthernet1/0/1

     VRID           : 11                   Adver Timer  : 100

     Admin Status   : Up                   State        : Backup

     Config Pri     : 80                   Running Pri  : 80

     Preempt Mode   : Yes                  Delay Time   : 0

     Become Master  : 2450ms left

     Auth Type      : None

     Virtual IP     : FE80::11

     Virtual MAC    : 0000-5e00-020b

     Master IP      : FE80::12

Table 32 Command output (in standard mode)

Field

Description

Running Mode

VRRP operating mode (standard mode).

Total number of virtual routers

Total number of VRRP groups.

Interface

Interface where the VRRP group is configured.

VRID

Virtual router ID (VRRP group number).

Adver Timer

VRRP advertisement sending interval in centiseconds.

Admin Status

Administrative status: Up or Down.

State

Status of the router in the VRRP group:

·     Master.

·     Backup.

·     Initialize.

·     Inactive.

Config Pri

Configured priority of the router, which is configured by using the vrrp ipv6 vrid priority command.

Running Pri

Current priority of the router.

When a track entry is associated with a VRRP group on the router, the router's priority changes when the track entry's status changes.

Preempt Mode

Preemptive mode:

·     Yes.

·     No.

Delay Time

Preemption delay in centiseconds.

Become Master

Time (in milliseconds) that a backup router has to wait before it becomes the master. This field is displayed only when the router is a backup.

Auth Type

Authentication type. Only none is available, which means no authentication is required.

Virtual IP

Virtual IP address of the VRRP group.

Virtual MAC

Virtual MAC address of the VRRP group's virtual IP address, which is displayed when the router is the master.

Master IP

Link-local address of the interface where the master resides.

VRRP Track Information

Track entry information. This field is displayed only after you configure the vrrp ipv6 vrid track command.

Track Object

Track entry which is associated with the VRRP group.

State

Track entry state:

·     Negative.

·     Positive.

·     NotReady.

Pri Reduced

Value by which the priority decreases when the state of the associated track entry becomes Negative.

Switchover

Switchover mode. When the state of the associated track entry becomes Negative, the backup immediately becomes the master.

 

# Display brief information about all IPv6 VRRP groups on the device when VRRP operates in load balancing mode.

<Sysname> display vrrp ipv6

IPv6 Virtual Router Information:

 Running Mode      : Load Balance

 Total number of virtual routers : 1

 Interface          VRID  State        Running Address             Active

                                       Pri

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

 GE1/0/1            1     Master       150     FE80::1             Local

 -----              VF 1  Active       255     000f-e2ff-4011      Local

Table 33 Command output (in load balancing mode)

Field

Description

Running Mode

VRRP operating mode (load balancing mode).

Total number of virtual routers

Total number of VRRP groups.

Interface

Interface where the VRRP group is configured.

VRID

Virtual router ID (VRRP group number) or VF ID.

State

·     For a VRRP group, this field indicates the state of the router in the VRRP group. The state can be Master, Backup, Initialize, or Inactive.

·     For a VF, this field indicates the state of the VF in the VRRP group. The state can be Active, Listening, or Initialize.

Running Pri

·     For a VRRP group, this field indicates the running priority of the router. When a track entry is associated with a VRRP group on the router, the router's priority changes when the track entry's status changes.

·     For a VF, this field indicates the running priority of the VF. When a track entry is associated with a VF, the priority of the VF changes if the state of the track entry changes.

Address

·     For a VRRP group, this field indicates the virtual IP address of the VRRP group.

·     For a VF, this field indicates the virtual MAC address of the VF.

Active

·     For a VRRP group, this field indicates the link-local address of the interface where the master resides. If the current router is the master, this field displays local.

·     For a VF, this field indicates the link-local address of the interface where the AVF resides. If the current VF is the AVF, this field displays local.

 

# Display detailed information about all IPv6 VRRP groups on the device when VRRP operates in load balancing mode.

<Sysname> display vrrp ipv6 verbose

IPv6 Virtual Router Information:

 Running Mode      : Load Balance

 Total number of virtual routers : 2

   Interface GigabitEthernet1/0/1

     VRID           : 1                    Adver Timer  : 100

     Admin Status   : Up                   State        : Master

     Config Pri     : 150                  Running Pri  : 150

     Preempt Mode   : Yes                  Delay Time   : 5

     Auth Type      : None

     Virtual IP     : FE80::10

     Member IP List : FE80::3 (Local, Master)

                      FE80::2 (Backup)

     Master IP      : FE80::3

   VRRP Track Information:

     Track Object   : 1                    State : Positive   Pri Reduced : 50

   Forwarder Information: 2 Forwarders 1 Active

     Config Weight  : 255

     Running Weight : 255

    Forwarder 01

     State          : Active

     Virtual MAC    : 000f-e2ff-4011 (Owner)

     Owner ID       : 0000-5e01-1101

     Priority       : 255

     Active         : local

    Forwarder 02

     State          : Listening

     Virtual MAC    : 000f-e2ff-4012 (Learnt)

     Owner ID       : 0000-5e01-1103

     Priority       : 127

     Active         : FE80::2

   Forwarder Weight Track Information:

     Track Object   : 1          State : Positive   Weight Reduced : 250

   Interface GigabitEthernet1/0/1

     VRID           : 11                   Adver Timer  : 100

     Admin Status   : Up                   State        : Backup

     Config Pri     : 80                   Running Pri  : 80

     Preempt Mode   : Yes                  Delay Time   : 0

     Become Master  : 2450ms left

     Auth Type      : None

     Virtual IP     : FE80::11

     Member IP List : FE80::3 (Local, Backup)

                      FE80::2 (Master)

     Master IP      : FE80::2

   Forwarder Information: 2 Forwarders 1 Active

     Config Weight  : 255

     Running Weight : 255

    Forwarder 01

     State          : Active

     Virtual MAC    : 000f-e2ff-40b1 (Learnt)

     Owner ID       : 0000-5e01-1103

     Priority       : 127

     Active         : FE80::2

    Forwarder 02

     State          : Listening

     Virtual MAC    : 000f-e2ff-40b2 (Owner)

     Owner ID       : 0000-5e01-1101

     Priority       : 255

     Active         : local

Table 34 Command output (in load balancing mode)

Field

Description

Running Mode

VRRP operating mode (load balancing mode).

Total number of virtual routers

Total number of VRRP groups.

Interface

Interface where the VRRP group is configured.

VRID

Virtual router ID (VRRP group number).

Adver Timer

VRRP advertisement sending interval in centiseconds.

Admin Status

Administrative status: Up or Down.

State

Status of the router in the VRRP group:

·     Master.

·     Backup.

·     Initialize.

·     Inactive.

Config Pri

Configured priority of the router, which is configured by using the vrrp ipv6 vrid priority command.

Running Pri

Current priority of the router.

When a track entry is associated with a VRRP group on the router, the router's priority changes when the track entry's status changes.

Preempt Mode

Preemptive mode:

·     Yes.

·     No.

Delay Time

Preemption delay in centiseconds.

Become Master

Time (in milliseconds) that a backup router has to wait before it becomes the master. This field is displayed only when the router is a backup.

Auth Type

Authentication type. Only none is available, which means no authentication is required.

Virtual IP

Virtual IP address list of the VRRP group.

Member IP List

IP addresses of the member devices in the VRRP group:

·     Local—IP address of the local router.

·     Master—IP address of the master.

·     BackupIP address of the backup.

VRRP Track Information

Track entry that is associated with the VRRP group. This field is displayed only you configure the vrrp ipv6 vrid track command.

Track Object

Track entry to be monitored. This field is displayed only after you configure the vrrp ipv6 vrid track command.

State

Track entry state:

·     Negative.

·     Positive.

·     NotReady.

Pri Reduced

Value by which the priority decreases when the status of the associated track entry becomes Negative. This field is displayed only after you configure the vrrp ipv6 vrid track command.

Switchover

Switchover mode. When the status of the associated track entry becomes Negative, the backup immediately becomes the master.

Forwarder Information: 2 Forwarders 1 Active

VF information: Two VFs exist and one is the AVF.

Config Weight

Configured weight of the VF: 255.

Running Weight

Current weight of the VF.

When a track entry is associated with the VFs of a VRRP group, the VFs' weights change when the track entry's status changes.

Forwarder 01

Information about VF 01.

State

VF state:

·     Active.

·     Listening.

·     Initialize.

Virtual MAC

Virtual MAC address of the VF.

Owner ID

Real MAC address of the VF owner.

Priority

VF priority in the range of 1 to 255.

Active

Link-local address of the interface where the AVF resides. If the current VF is the AVF, this field displays local.

Forwarder Weight Track Configuration

VF weight Track configuration.

The field is displayed only after you configure the vrrp ipv6 vrid track command.

Track Object

Track entry which is associated with the VFs.

The field is displayed only after you configure the vrrp ipv6 vrid track command.

State

Track entry state:

·     Negative.

·     Positive.

·     NotReady.

Weight Reduced

Value by which the weights of the VFs decrease when the state of the associated track entry changes to Negative.

The field is displayed only after you configure the vrrp ipv6 vrid track command.

 

display vrrp ipv6 statistics

Use display vrrp ipv6 statistics to display statistics for IPv6 VRRP groups.

Syntax

display vrrp ipv6 statistics [ interface interface-type interface-number [ vrid virtual-router-id ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its type and number.

vrid virtual-router-id: Specifies an IPv6 VRRP group by its virtual router ID in the range of 1 to 255.

Usage guidelines

If no interface or VRRP group is specified, this command displays statistics for all IPv6 VRRP groups.

If only an interface is specified, this command displays statistics for all IPv6 VRRP groups on the specified interface.

If both an interface and an IPv6 VRRP group are specified, this command displays statistics for the specified IPv6 VRRP group on the specified interface.

Examples

# Display statistics for all IPv6 VRRP groups when VRRP operates in standard mode.

<Sysname> display vrrp ipv6 statistics

 Interface               : GigabitEthernet1/0/1

 VRID                    : 1

 CheckSum Errors         : 0          Version Errors                : 0

 Invalid Pkts Rcvd       : 0          Unexpected Pkts Rcvd          : 0

 Hop Limit Errors        : 0          Advertisement Interval Errors : 0

 Invalid Auth Type       : 0          Auth Failures                 : 0

 Packet Length Errors    : 0          Auth Type Mismatch            : 0

 Become Master           : 1          Address List Errors           : 0

 Adver Rcvd              : 0          Priority Zero Pkts Rcvd       : 0

 Adver Sent              : 425        Priority Zero Pkts Sent       : 0

 

 Global statistics

 CheckSum Errors         : 0

 Version Errors          : 0

 VRID Errors             : 0

# Display statistics for all IPv6 VRRP groups when VRRP operates in load balancing mode.

<Sysname> display vrrp ipv6 statistics

 Interface               : GigabitEthernet1/0/1

 VRID                    : 1

 CheckSum Errors         : 0          Version Errors                : 0

 Invalid Pkts Rcvd       : 0          Unexpected Pkts Rcvd          : 0

 Hop Limit Errors        : 0          Advertisement Interval Errors : 0

 Invalid Auth Type       : 0          Auth Failures                 : 0

 Packet Length Errors    : 0          Auth Type Mismatch            : 0

 Become Master           : 39         Address List Errors           : 0

 Become AVF              : 13         Packet Option Errors          : 0

 Adver Rcvd              : 2562       Priority Zero Pkts Rcvd       : 1

 Adver Sent              : 16373      Priority Zero Pkts Sent       : 49

 Request Rcvd            : 2          Reply Rcvd                    : 10

 Request Sent            : 12         Reply Sent                    : 2

 Release Rcvd            : 0          VF Priority Zero Pkts Rcvd    : 1

 Release Sent            : 0          VF Priority Zero Pkts Sent    : 11

 Redirect Timer Expires  : 1          Time-out Timer Expires        : 0

 

 Global statistics

 CheckSum Errors         : 0

 Version Errors          : 0

 VRID Errors             : 0

Table 35 Command output (in standard mode)

Field

Description

Interface

Interface where the VRRP group is configured.

VRID

VRRP group number.

CheckSum Errors

Number of packets with checksum errors.

Version Errors

Number of packets with version errors.

Invalid Pkts Rcvd

Number of received packets of invalid packet types.

Unexpected Pkts Rcvd

Number of received unexpected packets.

Advertisement Interval Errors

Number of packets with advertisement interval errors.

Hop Limit Errors

Number of packets with hop limit errors.

Auth Failures

Number of packets with authentication failures.

Invalid Auth Type

Number of packets with authentication failures because of invalid authentication types.

Auth Type Mismatch

Number of packets with authentication failures because of mismatching authentication types.

Packet Length Errors

Number of packets with VRRP packet length errors.

Address List Errors

Number of packets with virtual IP address list errors.

Become Master

Number of times that the router has been elected as the master.

Priority Zero Pkts Rcvd

Number of received advertisements with the router priority of 0.

Adver Rcvd

Number of received advertisements.

Priority Zero Pkts Sent

Number of sent advertisements with the router priority of 0.

Adver Sent

Number of sent advertisements.

Global statistics

Global statistics for all IPv6 VRRP groups.

CheckSum Errors

Total number of packets with checksum errors.

Version Errors

Total number of packets with version errors.

VRID Errors

Total number of packets with VRID errors.

 

Table 36 Command output (in load balancing mode)

Field

Description

Interface

Interface where the VRRP group is configured.

VRID

VRRP group number.

CheckSum Errors

Number of packets with checksum errors.

Version Errors

Number of packets with version errors.

Invalid Pkts Rcvd

Number of received packets of invalid packet types.

Unexpected Pkts Rcvd

Number of received unexpected packets.

Advertisement Interval Errors

Number of packets with advertisement interval errors.

Hop Limit Errors

Number of packets with hop limit errors.

Auth Failures

Number of packets with authentication failures.

Invalid Auth Type

Number of packets with authentication failures because of invalid authentication types.

Auth Type Mismatch

Number of packets with authentication failures because of mismatching authentication types.

Packet Length Errors

Number of packets with VRRP packet length errors.

Address List Errors

Number of packets with virtual IP address list errors.

Become Master

Number of times that the router has been elected as the master.

Redirect Timer Expires

Number of times that the redirect timer expired.

Become AVF

Number of times that the VF has been elected as the AVF.

Time-out Timer Expires

Number of times that the time-out timer expired.

Adver Rcvd

Number of received advertisements.

Request Rcvd

Number of received requests.

Adver Sent

Number of sent advertisements.

Request Sent

Number of sent requests.

Reply Rcvd

Number of received replies.

Release Rcvd

Number of received release packets.

Reply Sent

Number of sent replies.

Release Sent

Number of sent release packets.

Priority Zero Pkts Rcvd

Number of received advertisements with the router priority of 0.

VF Priority Zero Pkts Rcvd

Number of received advertisements with the VF priority of 0.

Priority Zero Pkts Sent

Number of sent advertisements with the router priority of 0.

VF Priority Zero Pkts Sent

Number of sent advertisements with the VF priority of 0.

Packet Option Errors

Number of packet option errors.

Global statistics

Global statistics for all IPv6 VRRP groups.

CheckSum Errors

Total number of packets with checksum errors.

Version Errors

Total number of packets with version errors.

VRID Errors

Total number of packets with VRID errors.

 

Related commands

reset vrrp ipv6 statistics

reset vrrp ipv6 statistics

Use reset vrrp ipv6 statistics to clear statistics for IPv6 VRRP groups.

Syntax

reset vrrp ipv6 statistics [ interface interface-type interface-number [ vrid virtual-router-id ] ]

Views

User view

Predefined user roles

network-admin

Parameters

interface interface-type interface-number: Specifies an interface by its type and number.

vrid virtual-router-id: Specifies an IPv6 VRRP group by its virtual router ID in the range of 1 to 255.

Usage guidelines

If no interface or VRRP group is specified, this command clears statistics for all IPv6 VRRP groups.

If only an interface is specified, this command clears statistics for all IPv6 VRRP groups on the specified interface.

If both an interface and an IPv6 VRRP group are specified, this command clears statistics for the specified IPv6 VRRP group on the specified interface.

Examples

# Clear statistics for all IPv6 VRRP groups on all interfaces.

<Sysname> reset vrrp ipv6 statistics

Related commands

display vrrp ipv6 statistics

vrrp ipv6 dscp

Use vrrp ipv6 dscp to set a DSCP value for IPv6 VRRP packets.

Use undo vrrp ipv6 dscp to restore the default.

Syntax

vrrp ipv6 dscp dscp-value

undo vrrp ipv6 dscp

Default

The DSCP value for IPv6 VRRP packets is 56.

Views

System view

Predefined user roles

network-admin

Parameters

dscp-value: Specifies a DSCP value for IPv6 VRRP packets, in the range of 0 to 63.

Usage guidelines

The DSCP value identifies the packet priority during transmission. A greater DSCP value means a higher packet priority.

Examples

# Set the DSCP value to 30 for IPv6 VRRP packets.

<Sysname> system-view

[Sysname] vrrp ipv6 dscp 30

vrrp ipv6 mode

Use vrrp ipv6 mode to specify the operating mode for IPv6 VRRP.

Use undo vrrp ipv6 mode to restore the default.

Syntax

vrrp ipv6 mode load-balance

undo vrrp ipv6 mode

Default

IPv6 VRRP operates in standard mode.

Views

System view

Predefined user roles

network-admin

Parameters

load-balance: Specifies the load balancing mode.

Usage guidelines

For IPv6 VRRP to operate correctly in load balancing mode, make sure the virtual IPv6 address of an IPv6 VRRP group is not the IPv6 address of the interface where the VRRP group is configured.

After you create IPv6 VRRP groups on the router, you can use this command to modify their operating mode. All IPv6 VRRP groups on the router operate in the specified mode.

Examples

# Specify the load balancing mode for IPv6 VRRP.

<Sysname> system-view

[Sysname] vrrp ipv6 mode load-balance

Related commands

display vrrp ipv6

vrrp ipv6 vrid

Use vrrp ipv6 vrid to create an IPv6 VRRP group and assign a virtual IPv6 address to it, or to assign a virtual IPv6 address to an existing IPv6 VRRP group.

Use undo vrrp ipv6 vrid to remove all configurations of an IPv6 VRRP group, or to remove a virtual IPv6 address from an IPv6 VRRP group.

Syntax

vrrp ipv6 vrid virtual-router-id virtual-ip virtual-address [ link-local ]

undo vrrp ipv6 vrid virtual-router-id [ virtual-ip [ virtual-address [ link-local ] ] ]

Default

No IPv6 VRRP groups exist.

Views

Interface view

Predefined user roles

network-admin

Parameters

virtual-router-id: Specifies an IPv6 VRRP group by its virtual router ID in the range of 1 to 255.

virtual-ip virtual-address: Specifies a virtual IPv6 address. If you do not specify this option, the undo vrrp ipv6 vrid command removes all virtual IPv6 addresses from the specified IPv6 VRRP group.

link-local: Specifies a link-local address as the virtual IPv6 address.

Usage guidelines

You can assign a maximum of 16 virtual IPv6 addresses to an IPv6 VRRP group.

The first virtual IPv6 address that you assign to an IPv6 VRRP group must be a link-local address, and it must be removed last.

An IPv6 VRRP group can have only one link-local address as its virtual IPv6 address.

If you create an IPv6 VRRP group without assigning virtual IPv6 address to it, the VRRP group stays in inactive state and does not function.

The virtual IPv6 address of an IPv6 VRRP group and the downlink interface IPv6 address of the VRRP group members must be in the same subnet. Otherwise, the hosts in the subnet might fail to access external networks.

Examples

# Create IPv6 VRRP group 1 and assign virtual IPv6 address fe80::10 to the VRRP group. Then assign virtual IPv6 address 1::10 to the VRRP group.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp ipv6 vrid 1 virtual-ip fe80::10 link-local

[Sysname-GigabitEthernet1/0/1] vrrp ipv6 vrid 1 virtual-ip 1::10

Related commands

display vrrp ipv6

vrrp ipv6 vrid preempt-mode

Use vrrp ipv6 vrid preempt-mode to enable the preemptive mode for the router in an IPv6 VRRP group and set the preemption delay.

Use undo vrrp ipv6 vrid preempt-mode to disable the preemptive mode for the router in an IPv6 VRRP group.

Use undo vrrp ipv6 vrid preempt-mode delay to restore the default preemption delay.

Syntax

vrrp ipv6 vrid virtual-router-id preempt-mode [ delay delay-value ]

undo vrrp ipv6 vrid virtual-router-id preempt-mode [ delay ]

Default

The router operates in preemptive mode and the preemption delay is 0 centiseconds.

Views

Interface view

Predefined user roles

network-admin

Parameters

virtual-router-id: Specifies an IPv6 VRRP group by its virtual router ID in the range of 1 to 255.

delay delay-value: Specifies the preemption delay in the range of 0 to 180000 in centiseconds.

Usage guidelines

In non-preemptive mode, the master router acts as the master as long as it operates correctly, even if a backup is assigned a higher priority later. The non-preemptive mode helps avoid frequent switchover between the master and backups.

In preemptive mode, a backup sends VRRP advertisements when it detects that it has a higher priority than the master. Then the backup takes over as the master and the previous master becomes a backup. This mechanism ensures that the master is always the router with the highest priority.

You can configure the VRRP preemption delay for the following purposes:

·     Avoid frequent state changes among members in a VRRP group.

·     Provide the backups with enough time to collect information (such as routing information).

A backup does not immediately become the master after it receives an advertisement with a lower priority than the local priority. Instead, it waits for a period of time before taking over.

Examples

# Enable the preemptive mode for VRRP group 1, and set the preemption delay to 5000 centiseconds.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp ipv6 vrid 10 preempt-mode delay 5000

Related commands

display vrrp ipv6

vrrp ipv6 vrid priority

Use vrrp ipv6 vrid priority to set the priority of the router in an IPv6 VRRP group.

Use undo vrrp ipv6 vrid priority to restore the default.

Syntax

vrrp ipv6 vrid virtual-router-id priority priority-value

undo vrrp ipv6 vrid virtual-router-id priority

Default

The priority of a router in an IPv6 VRRP group is 100.

Views

Interface view

Predefined user roles

network-admin

Parameters

virtual-router-id: Specifies an IPv6 VRRP group by its virtual router ID in the range of 1 to 255.

priority-value: Specifies a priority value in the range of 1 to 254. A higher value indicates a higher priority.

Usage guidelines

VRRP determines the role (master or backup) of each router in a VRRP group by priority. A router with a higher priority is more likely to become the master.

Priorities 1 to 254 are configurable. Priority 0 is reserved for special uses, and priority 255 is for the IP address owner. The IP address owner in a VRRP group always has a running priority of 255 and acts as the master as long as it operates correctly.

Examples

# Set the priority of the router to 150 in VRRP group 1 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp ipv6 vrid 1 priority 150

Related commands

display vrrp ipv6

vrrp ipv6 vrid shutdown

Use vrrp ipv6 vrid shutdown to disable an IPv6 VRRP group.

Use undo vrrp ipv6 vrid shutdown to enable an IPv6 VRRP group.

Syntax

vrrp ipv6 vrid virtual-router-id shutdown

undo vrrp ipv6 vrid virtual-router-id shutdown

Default

An IPv6 VRRP group is enabled.

Views

Interface view

Predefined user roles

network-admin

Parameters

virtual-router-id: Specifies an IPv6 VRRP group by its virtual router ID in the range of 1 to 255.

Usage guidelines

You can use this command to temporarily disable an IPv6 VRRP group. After this command is configured, the VRRP group stays in Initialize state, and its configurations remain unchanged. You can change the configuration of the VRRP group, and your changes take effect when you enable the VRRP group again.

Examples

# Disable IPv6 VRRP group 1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp ipv6 vrid 1 shutdown

vrrp ipv6 vrid timer advertise

Use vrrp ipv6 vrid timer advertise to set the interval at which the master in an IPv6 VRRP group sends VRRP advertisements.

Use undo vrrp ipv6 vrid timer advertise to restore the default.

Syntax

vrrp ipv6 vrid virtual-router-id timer advertise adver-interval

undo vrrp ipv6 vrid virtual-router-id timer advertise

Default

The master in an IPv6 VRRP group sends VRRP advertisements at an interval of 100 centiseconds.

Views

Interface view

Predefined user roles

network-admin

Parameters

virtual-router-id: Specifies an IPv6 VRRP group by its virtual router ID in the range of 1 to 255.

adver-interval: Specifies an interval for the master in the specified IPv6 VRRP group to send VRRP advertisements, in the range of 100 to 4095 centiseconds.

Usage guidelines

The master in an IPv6 VRRP group periodically sends VRRP advertisements to declare its presence. You can use this command to set the interval at which the master sends VRRP advertisements.

As a best practice to maintain system stability, set the VRRP advertisement interval to be greater than 100 centiseconds.

The routers in an IPv6 VRRP group can have different intervals for sending VRRP advertisements. The master in the VRRP group sends VRRP advertisements at the specified interval and carries the interval attribute in the advertisements. After a backup receives the advertisement, it records the interval in the advertisement. If the backup does not receive any VRRP advertisement when the timer (3 × VRRP advertisement sending interval + Skew_Time) expires, it regards the master as failed and takes over.

Large network traffic might disable a backup from receiving VRRP advertisements from the master within the specified timer and trigger an unexpected master switchover. To solve this problem, you can use this command to configure a larger interval.

Examples

# Configure the master in IPv6 VRRP group 1 to send VRRP advertisements at an interval of 500 centiseconds.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp ipv6 vrid 1 timer advertise 500

Related commands

display vrrp ipv6

vrrp ipv6 vrid track

Use vrrp ipv6 vrid track to associate an IPv6 VRRP group or the VFs in an IPv6 VRRP group with a track entry.

Use undo vrrp ipv6 vrid track to remove the association between an IPv6 VRRP group or the VFs in an IPv6 VRRP group and a track entry.

Syntax

vrrp ipv6 vrid virtual-router-id track track-entry-number { forwarder-switchover member-ip ipv6-address | priority reduced [ priority-reduced ] | switchover | weight reduced [ weight-reduced ] }

undo vrrp ipv6 vrid virtual-router-id track [ track-entry-number ] [ forwarder-switchover | priority reduced | switchover | weight reduced ] ]

Default

An IPv6 VRRP group is not associated with any track entry.

Views

Interface view

Predefined user roles

network-admin

Parameters

virtual-router-id: Specifies an IPv6 VRRP group number in the range of 1 to 255.

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

forwarder-switchover member-ip ipv6-address: Enables the LVF on the router to take over the role of the AVF at the specified IPv6 address immediately after the specified track entry changes to the Negative state. The ipv6-address argument specifies the IPv6 address of a member router. You can use the display vrrp ipv6 verbose command to view the IPv6 addresses of the members.

priority reduced priority-reduced: Reduces the priority of the router in the VRRP group by the specified value when the state of the specified track entry changes to Negative. The value range for the priority-reduced argument is 1 to 255, and the default value is 10.

switchover: Enables the router in backup state to take over as the master immediately after the specified track entry changes to the Negative state.

weight reduced weight-reduced: Reduces the weight of all VFs on the router in the VRRP group by the specified value when the state of the specified track entry changes to Negative. The value range for the weight-reduced argument is 1 to 255, and the default value is 30.

Usage guidelines

When the associated track entry changes to the Negative state, one of the following events occurs depending on your configuration:

·     The priority of the router in the VRRP group decreases by a specified value.

·     The weight of VFs decreases by a specified value.

·     The router immediately takes over as the master if it is a backup.

·     The LVF on the router immediately takes over the role of the AVF at the specified IPv6 address.

When the track entry changes from Negative to Positive or NotReady, one of the following events occurs:

·     The router automatically restores its priority or VF weight.

·     The failed master router becomes the master again.

·     The failed AVF becomes active again.

Before executing this command, create an IPv6 VRRP group on the interface and assign a virtual IPv6 address to the IPv6 VRRP group.

The following parameters take effect only when the IPv6 VRRP group is operating in load balancing mode:

·     The forwarder-switchover member-ip ip-address option.

·     The weight reduced weight-reduced option.

·     The weight reduced keyword.

The weight of a VF is 255, and its lower limit of failure is 10.

When the weight of a VF owner is higher than or equal to the lower limit of failure, its priority is always 255. The priority does not change with the weight. When the upstream link of the VF owner fails, an LVF must take over as the AVF. The switchover happens when the weight of the VF owner drops below the lower limit of failure. This requires that the reduced weight for the VF owner be higher than 245.

 

IMPORTANT

IMPORTANT:

·     The vrrp ipv6 vrid track priority command and the vrrp ipv6 vrid track switchover command do not take effect on an IP address owner. If you configure the command on an IP address owner, the configuration takes effect after the router changes to be a non-IP address owner.

·     You can create a track entry by using the track command before or after you associate it with an IPv6 VRRP group or the VFs in an IPv6 VRRP group. For more information about configuring track entries, see High Availability Configuration Guide.

·     If no track entry is specified, the undo vrrp ipv6 vrid track command removes all associations between track entries and the IPv6 VRRP group or VFs in the IPv6 VRRP group.

 

Examples

# Associate IPv6 VRRP group 1 on GigabitEthernet 1/0/1 with track entry 1 and decrease the router priority by 50 when the state of track entry 1 changes to negative.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp ipv6 vrid 1 track 1 priority reduced 50

# Associate the VFs of IPv6 VRRP group 1 on GigabitEthernet 1/0/1 with track entry 1. Enable the LVF to take over the role of the AVF at the IPv6 address of 1::3 immediately after the specified track entry changes to negative.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp ipv6 vrid 1 track 1 forwarder-switchover member-ip 1::3

# Associate the VFs of IPv6 VRRP group 1 on GigabitEthernet 1/0/1 with track entry 1. Decrease the weight of all VFs on the router in the VRRP group by 50 when the state of track entry 1 changes to negative.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] vrrp ipv6 vrid 1 track 1 weight reduced 50

Related commands

display vrrp ipv6

 


Process placement commands

The following matrix shows the feature and hardware compatibility:

 

Hardware

Process placement compatibility

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/810-LMS/810-LUS

No

MSR2600-6-X1/2600-10-X1

No

MSR 2630

Yes

MSR3600-28/3600-51

Yes

MSR3600-28-SI/3600-51-SI

No

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC

Yes

MSR 3610/3620/3620-DP/3640/3660

Yes

MSR5620/5660/5680

Yes

 

Hardware

Process placement compatibility

MSR810-LM-GL

No

MSR810-W-LM-GL

No

MSR830-6EI-GL

No

MSR830-10EI-GL

No

MSR830-6HI-GL

No

MSR830-10HI-GL

No

MSR2600-6-X1-GL

No

MSR3600-28-SI-GL

No

 

Commands and descriptions for centralized devices apply to the following routers:

·     MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/810-LMS/810-LUS.

·     MSR2600-6-X1/2600-10-X1.

·     MSR 2630.

·     MSR3600-28/3600-51.

·     MSR3600-28-SI/3600-51-SI.

·     MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC.

·     MSR 3610/3620/3620-DP/3640/3660.

Commands and descriptions for distributed devices apply to the following routers:

·     MSR5620.

·     MSR 5660.

·     MSR 5680.

affinity location-set

Use affinity location-set to set the affinity of a process to the specified locations.

Use undo affinity location-set to remove the affinity setting for the specified locations for a process.

Syntax

Distributed devices in standalone mode/centralized devices in IRF mode:

affinity location-set { slot slot-number }&<1-5> { attract strength | default | none | repulse strength }

undo affinity location-set { slot slot-number }&<1-5>

Distributed devices in IRF mode:

affinity location-set { chassis chassis-number slot slot-number }&<1-5> { attract strength | default | none | repulse strength }

undo affinity location-set { chassis chassis-number slot slot-number }&<1-5>

Default

No location affinity is configured for any process.

Views

Placement process view

Predefined user roles

network-admin

Parameters

{ chassis chassis-number slot slot-number }&<1-5>: Specifies the affinity.

·     chassis chassis-number: Specifies an IRF member device by its ID. (Distributed devices in IRF mode.)

·     slot slot-number: Specifies an MPU by its slot number. (Distributed devices in standalone mode/Distributed devices in IRF mode.)

·     slot slot-number: Specifies an IRF member device by its ID. (Centralized devices in IRF mode.)

·     &<1-5>: Indicates that you can specify a maximum of five locations.

attract strength: Sets a positive affinity in the range of 1 to 100000. The higher the value, the stronger the preference for the process to run in the specified location.

default: Sets the affinity to the default, a positive affinity of 200.

none: Sets the affinity to 0, which means the active process has no preference for any location and the system determines its location.

repulse strength: Sets a negative affinity in the range of 1 to 100000. The higher the value, the weaker the preference for the process to run in the specified location.

Examples

# (Distributed device in standalone mode.) Set a positive affinity of 500 to the MPU in slot 0 for BGP.

<Sysname> system-view

[Sysname] placement program bgp

[Sysname-program-bgp] affinity location-set slot 0 attract 500

# (Centralized devices in IRF mode.) Set a positive affinity of 500 to IRF member device 1 for BGP.

<Sysname> system-view

[Sysname] placement program bgp

[Sysname-program-bgp] affinity location-set slot 1 attract 500

# (Distributed devices in IRF mode.) Set a positive affinity of 500 to the MPU in slot 0 on IRF member device 1 for BGP.

<Sysname> system-view

[Sysname] placement program bgp

[Sysname-program-bgp] affinity location-set chassis 1 slot 0 attract 500

affinity location-type

Use affinity location-type to set the affinity of a process to a location type.

Use undo affinity location-type to remove the affinity setting for the specified location type for a process.

Syntax

affinity location-type { current | paired | primary } { attract strength | default | none | repulse strength }

undo affinity location-type { current | paired | primary }

Default

No location type affinity is configured for any process.

Views

Placement process view

Predefined user roles

network-admin

Parameters

current: Specifies the affinity to the current location. You can use the display placement program command to view the current location of a process.

paired: Specifies the affinity to the location of a standby process.

primary: Specifies the affinity to the active MPU. (Distributed devices in standalone mode.)

primary: Specifies the affinity to the master device. (Centralized devices in IRF mode.)

primary: Specifies the affinity to the global active MPU. (Distributed devices in IRF mode.)

attract strength: Sets a positive affinity in the range of 1 to 100000. The higher the value, the stronger the preference of the process to run on the specified location type.

default: Sets the affinity to the default, a positive affinity of 200.

none: Sets the affinity to 0.

repulse strength: Sets a negative affinity in the range of 1 to 100000. The higher the value, the weaker the preference for the process to run on the specified location type.

Examples

# Set a positive affinity of 500 to the current location for BGP.

<Sysname> system-view

[Sysname] placement program bgp

[Sysname-program-bgp] affinity location-type current attract 500

Related commands

affinity location-set

affinity program

affinity program

Use affinity program to set the affinity for one process to run on the same location as another process.

Use undo affinity program to remove the affinity setting for one process to run on the same location as the specified process.

Syntax

affinity program program-name { attract strength | default | none | repulse strength }

undo affinity program program-name

Default

No process affinity is set for any process.

Views

Placement process view

Predefined user roles

network-admin

Parameters

program-name: Specifies the name of a process, a case-insensitive string of 1 to 15 characters. You can use the display placement program all command to view information about placeable processes.

attract strength: Sets a positive affinity in the range of 1 to 100000. The higher the value, the stronger the preference for the current process to run on the same location as the specified process.

default: Sets the affinity to the default, a positive affinity of 200.

none: Sets the affinity to 0, which means the active process has no preference for any other process and the system determines its location.

repulse strength: Sets a negative affinity in the range of 1 to 100000. The higher the value, the weaker the preference for the current process to run on the same location as the specified process.

Usage guidelines

Use this command to have processes run on the same location or different locations.

Examples

# Set a negative affinity of 200 for OSPF to run on the same location as BGP.

<Sysname> system-view

[Sysname] placement program ospf

[Sysname-program-ospf] affinity program bgp repulse 200

Related commands

affinity location-set

affinity location-type

affinity self

Use affinity self to set the affinity of one instance of a process to any other instance of the same process.

Use undo affinity self to restore the default.

Syntax

affinity self { attract strength | default | none | repulse strength }

undo affinity self

Default

No self affinity is set for any process.

Views

Placement process view

Predefined user roles

network-admin

Parameters

attract strength: Specifies a positive affinity in the range of 1 to 100000. The higher the value, the stronger the preference for all the instances of the current process to run on the same location.

default: Sets the affinity to the default, a positive affinity of 200.

none: Sets the affinity to 0, which means the instances of the process have no preference to run on the same location and the system determines their locations.

repulse strength: Sets a negative affinity in the range of 1 to 100000. The higher the value, the weaker the preference for all the instances of the current process to run on the same location.

Usage guidelines

This command sets the preference for a process to run all its instances on the same location or different locations. If the process has only one instance, the command does not take effect.

The self affinity in the placement process view of a process and any of its instances overwrite each other, and whichever is configured the last takes effect on all the instances of the process.

To view the instances of a process, use the display placement program all command.

Examples

# Set a negative self affinity of 200 for BGP.

<Sysname> system-view

[Sysname] placement program bgp

[Sysname-program-bgp] affinity self repulse 200

Related commands

affinity location-set

affinity location-type

display ha service-group

Use display ha service-group to display service group information.

Syntax

display ha service-group { program-name [ instance instance-name ] | all }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

program-name: Specifies a service group by its name, a case-insensitive string of 1 to 15 characters.

all: Specifies all service groups running on the device.

instance instance-name: Specifies an instance by its name, a case-insensitive string of 1 to 31 characters. Whether a service group has multiple instances depends on the system software.

Examples

# (Distributed devices in standalone mode.) Display information about all service groups.

<Sysname> display ha service-group all

Service Group                     Current Location      State

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

ospf                              0/0                   Realtime Backup

bgp                               0/0                   Batch Backup

isis                              0/0                   Stopping

rip                               0/0                   Realtime Backup

ripng                             0/0                   Upgrading

staticroute                       0/0                   Batch Backup

# (Centralized devices in IRF mode.) Display information about all service groups.

<Sysname> display ha service-group all

Service Group                     Current Location      State

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

ospf                              1/0                   Realtime Backup

bgp                               1/0                   Batch Backup

isis                              1/0                   Stopping

rip                               1/0                   Realtime Backup

ripng                             1/0                   Upgrading

staticroute                       1/0                   Batch Backup

# (Distributed devices in standalone mode.) Display information about the staticroute service group.

<Sysname> display ha service-group staticroute

Service Group                     Current Location      State

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

staticroute                       0/0 (Active)          Batch Backup

 

  Detailed information about services of the program:

  Service           PID    Type      Location   State

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

  ifm               200    Standby   0/0        Realtime Backup

  staticroute       200    Standby   0/0        Batch Backup

  ifm               200    Active    0/0        Realtime Backup

  staticroute       200    Active    0/0        Batch Backup

# (Centralized devices in IRF mode.) Display information about the staticroute service group.

<Sysname> display ha service-group staticroute

Service Group                     Current Location      State

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

staticroute                       1/0 (Active)          Batch Backup

 

  Detailed information about services of the program:

  Service           PID    Type      Location   State

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

  ifm               200    Standby   1/0        Realtime Backup

  staticroute       200    Standby   1/0        Batch Backup

  ifm               200    Active    1/0        Realtime Backup

  staticroute       200    Active    1/0        Batch Backup

# (Distributed devices in IRF mode.) Display information about all service groups.

<Sysname> display ha service-group all

Service Group                     Current Location      State

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

ospf                              1/0/0                 Realtime Backup

bgp                               1/0/0                 Batch Backup

isis                              1/0/0                 Stopping

rip                               1/0/0                 Realtime Backup

ripng                             1/0/0                 Upgrading

staticroute                       1/0/0                 Batch Backup

# (Distributed devices in IRF mode.) Display information about the staticroute service group.

<Sysname>display ha service-group staticroute

Service Group                     Current Location      State

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

staticroute                       1/0/0 (Active)        Batch Backup

 

  Detailed information about services of the program:

  Service           PID    Type      Location   State

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

  ifm               200    Active    1/0/0      Realtime Backup

  staticroute       200    Active    1/0/0      Batch Backup

  ifm               200    Standby   1/0/0      Realtime Backup

  staticroute       200    Standby   1/0/0      Batch Backup

  ifm               200    Standby   1/0/0      Realtime Backup

  staticroute       200    Standby   1/0/0      Batch Backup

Table 37 Command output

Field

Description

Service Group

Service group name.

Current Location

Current location of the active processes for a service group.

State

Backup state of the active and standby processes for a service group.

Detailed information about services of the program

Detailed information about all active and standby processes in a service group.

Service

Service name.

PID

Process ID.

Type

Process type: active or standby.

Location

Location of the active process of a service.

State

Process status:

·     Realtime Backup

·     Batch Backup

·     Stopping

·     Degrading

·     Upgrading

 

display placement location

Use display placement location to display the processes running on a specific location.

Syntax

Distributed devices in standalone mode/centralized devices in IRF mode:

display placement location { all | slot slot-number }

Distributed devices in IRF mode:

display placement location { all |chassis chassis-number slot slot-number }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Displays all processes running on the device.

slot slot-number: Displays the processes running on an MPU. (Distributed devices in standalone mode.)

slot slot-number: Displays the processes running on an IRF member device. The slot-number argument specifies the ID of the IRF member device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Displays the processes running on an MPU of an IRF member device. The chassis-number argument specifies the ID of the IRF member device, and the slot-number argument specifies the slot that holds the MPU. (Distributed devices in IRF mode.)

Examples

# (Distributed devices in standalone mode.) Display the processes running on the MPU in slot 0.

<Sysname> display placement location slot 0

Program(s) placed at location: 0/0

  l3vpn

  lsm

  aaa

  lauth

  track

  bfd

  rm6

  rm

  rpm

  usr6

  ipaddr

  ip6addr

  slsp

  usr

  ethbase

  ip6base

  ipbase

  eth

# (Centralized devices in IRF mode.) Display the processes running on IRF member device 1.

<Sysname> display placement location slot 1

Program(s) placed at location: 1/0

  l3vpn

  lsm

  aaa

  lauth

  track

  bfd

  rm6

  rm

  rpm

  usr6

  ipaddr

  ip6addr

  slsp

  usr

  ethbase

  ip6base

  ipbase

  eth

# (Distributed devices in IRF mode.) Display the processes running on the MPU in slot 0 of IRF member device 1.

<Sysname> display placement location chassis 1 slot 0

Program(s) placed at location: 1/0/0

  l3vpn

  lsm

  aaa

  lauth

  track

  bfd

  rm6

  rm

  rpm

  usr6

  ipaddr

  ip6addr

  slsp

  usr

  ethbase

  ip6base

  ipbase

  eth

display placement policy

Use display placement policy to display process placement policy information.

Syntax

display placement policy program { program-name | all | default }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

program-name: Displays the placement policy for a process. The process name is a case-insensitive string of 1 to 15 characters.

all: Displays all process placement policies.

default: Displays the default process placement policy. It is not displayed if no default process placement policy is configured with the placement program default command.

Usage guidelines

The information about a placement policy is displayed only when the placement policy is configured for the specified process.

Examples

# (Distributed devices in standalone mode.) Display the default process placement policy.

<Sysname> display placement policy program default

Program: [default]                                : source

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

  affinity location-set slot 0 attract 500        : system [default]

# (Centralized devices in IRF mode.) Display the default process placement policy.

<Sysname> display placement policy program default

Program: [default]                                : source

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

  affinity location-set slot 1 cpu 0 attract      : system [default]

   500

# (Distributed devices in IRF mode.) Display the default process placement policy.

<Sysname> display placement policy program default

Program: [default]                                : source

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

  affinity location-set chassis 1 slot 0 cpu 0    : system [default]

   attract 500

Table 38 Command output

Field

Description

Program

Process name.

source

Source of the setting. The text system [default] identifies a default placement setting configured in the view you enter with the placement program default command. The text system bgp identifies a placement setting for the process bgp configured in the view you enter with the placement program program-name command.

 

display placement program

Use display placement program to display the location of an active process.

Syntax

display placement program { program-name | all }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

program-name: Specifies a process by its name, a case-insensitive string of 1 to 15 characters.

all: Specifies all processes.

Examples

# (Distributed devices in standalone mode.) Display the location of BGP.

<Sysname> display placement program bgp

Program                           Placed at location

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

bgp                               0/0

# (Centralized devices in IRF mode.) Display the location of BGP.

<Sysname> display placement program bgp

Program                           Placed at location

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

bgp                               1/0

# (Distributed devices in IRF mode.) Display the location of BGP.

<Sysname> display placement program bgp

Program                          Placed at Location

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

bgp                              1/0/0

Table 39 Command output

Field

Description

Program

Process name.

Placed at location

Location of the process.

If NA is displayed, the process is not available because the service is abnormal or the process is starting up or shut down.

 

display placement reoptimize

Use display placement reoptimize to display the predicted changes that will occur when you run the placement reoptimize command.

Syntax

display placement reoptimize program { program-name [ instance instance-name ] | all }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

program-name: Displays changes for a process (that supports process optimization) specified by its name, a case-insensitive string of 1 to 15 characters.

instance instance-name: Specifies an instance of the specified process by name, a case-insensitive string of 1 to 31 characters. Whether a process has multiple instances depends on the system software.

all: Displays changes for all processes that support process optimization.

Examples

# (Distributed devices in standalone mode.) Display the predicted changes for all processes.

<Sysname> display placement reoptimize program all

Predicted changes to the placement

Program                           Current location       New location

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

rm6                               0/0                    0/0

rm                                0/0                    0/0

rpm                               0/0                    0/0

usr                               0/0                    0/0

usr6                              0/0                    0/0

bgp                               0/0                    0/0

pim                               0/0                    0/0

igmp                              0/0                    0/0 

# (Centralized devices in IRF mode.) Display the predicted changes for all processes.

<Sysname> display placement reoptimize program all

Predicted changes to the placement

Program                           Current location       New location

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

rm6                               1/0                    1/0

rm                                1/0                    1/0

rpm                               1/0                    1/0

usr                               1/0                    1/0

usr6                              1/0                    1/0

bgp                               1/0                    1/0

pim                               1/0                    1/0

igmp                              1/0                    1/0

The output shows the process name, current location of the active process, and new location of the active process after optimization.

# (Distributed devices in IRF mode.) Display the predicted changes for all processes.

<Sysname> display placement reoptimize program all

Predicted changes to the placement

Program                           Current location       New location

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

rm6                               1/0/0                  1/0/0

rm                                1/0/0                  1/0/0

rpm                               1/0/0                  1/0/0

usr                               1/0/0                  1/0/0

usr6                              1/0/0                  1/0/0

bgp                               1/0/0                  1/0/0

pim                               1/0/0                  1/0/0

igmp                              1/0/0                  1/0/0

The output shows the process name, current location of the active process, and new location of the active process after optimization.

placement program

Use placement program to enter placement process view.

Use undo placement program to delete the placement policy for a process.

Syntax

placement program { program-name [ instance instance-name ] | default }

undo placement program { program-name [ instance instance-name ] | default }

Default

No placement process view is created, and all active processes run on the active MPU. (Distributed devices in standalone mode.)

Views

System view

Predefined user roles

network-admin

Parameters

program-name: Specifies a process name, a case-insensitive string of 1 to 15 characters.

instance instance-name: Specifies the name of an instance of the specified process. The instance name is a case-insensitive string of 1 to 31 characters. If a process has only one instance, the system displays a prompt when you specify this option.

default: Configures the default placement policy for all processes.

Usage guidelines

You configure a process placement policy to optimize the distribution of processes in your system for optimal distribution of CPU and memory resources.

An active process running only on the active MPU does not support placement optimization. If you configure a process placement policy for the process, the system displays a configuration failure prompt. When such an active process fails, the system automatically restarts the process. The standby processes are used for active/standby switchover and ISSU.

Some active processes can run on either the active or standby MPU. When such an active process fails, the system uses a placement policy to select a new active process among standby processes.

A process placement policy contains the affinity location-type, affinity location-set, affinity program, and affinity self commands. The commands describe the preferences of the process for a specific location.

You can configure all the affinity commands in the placement policy for a process. Based on the placement policy and hardware resources, the system automatically determines the location for running the process. Before you apply the policy, you can use the display placement reoptimize command to view the predicted location for the process.

Examples

# Enter the placement process view of BGP.

<Sysname> system-view

[Sysname] placement program bgp

[Sysname-program-bgp]

# Enter the placement process view of BGP instance 100.

<Sysname> system-view

[Sysname] placement program bgp instance 100

[Sysname-program-bgp-100]

# Enter default placement process view.

<Sysname> system-view

[Sysname] placement program default

[Sysname-program-default]

placement reoptimize

Use placement reoptimize to apply configured process placement policies for optimizing process placement.

Syntax

placement reoptimize

Views

System view

Predefined user roles

network-admin

Usage guidelines

After you execute this command, the system bases its placement decisions on the new process placement policies, hardware resources, and locations and states of active processes. If the new location for an active process is different from its current location, the system changes its state to standby and the state of the standby process on the new location to active.

To keep the system stable, do not perform any tasks that require process restart when you execute this command.

Examples

# (Distributed devices in standalone mode.) Reoptimize process placement.

<Sysname> system-view

[Sysname] placement reoptimize

Predicted changes to the placement

Program                           Current location       New location

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

rib                               0/0                    0/0                   

staticroute                       0/0                    0/0                   

ospf                              0/0                    0/0                    

rip                               0/0                    0/0                   

rib6                              0/0                    0/0                   

staticroute6                      0/0                    0/0                   

bgpmgr                            0/0                    0/0                   

bgp-default                       0/0                    0/0                   

objp                              0/0                    0/0                   

atk                               0/0                    0/0

Continue? [y/n]:y

Re-optimization of the placement start. You will be notified on completion

Re-optimization of the placement complete. Use 'display placement' to view the new placement

# (Centralized devices in IRF mode.) Reoptimize process placement.

<Sysname> system-view

[Sysname] placement reoptimize

Predicted changes to the placement

Program                           Current location       New location

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

lsm                               1/0                    1/0                   

rib                               1/0                    1/0                   

rib6                              1/0                    1/0                   

routepolicy                       1/0                    1/0                   

slsp                              1/0                    1/0                   

staticroute                       1/0                    1/0                   

staticroute6                      1/0                    1/0                   

ospf                              1/0                    1/0                   

ospfv3                            1/0                    1/0                   

stp                               1/0                    1/0                   

spbm                              1/0                    1/0                   

l2vpn                             1/0                    1/0                    

pim                               1/0                    1/0                   

igmp                              1/0                    1/0                   

bgp                               1/0                    1/0

Continue? [y/n]:y

Re-optimization of the placement start. You will be notified on completion

Re-optimization of the placement complete. Use 'display placement' to view the new placement

# (Distributed devices in IRF mode.) Reoptimize process placement.

<Sysname> system-view

[Sysname] placement reoptimize

Predicted changes to the placement

Program                           Current location       New location

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

rib                               1/0/0                  1/0/0                

staticroute                       1/0/0                  1/0/0                

rib6                              1/0/0                  1/0/0                

staticroute6                      1/0/0                  1/0/0                

isis                              1/0/0                  1/0/0                

ospf                              1/0/0                  1/0/0                

rip                               1/0/0                  1/0/0                 

trill                             1/0/0                  1/0/0                

l2vpn                             1/0/0                  1/0/0                

igmp                              1/0/0                  1/0/0                

pim                               1/0/0                  1/0/0                

bgp-default                       1/0/0                  1/0/0                

routepolicy                       1/0/0                  1/0/0                

msdp                              1/0/0                  1/0/0                

ldp                               1/0/0                  1/0/0                

lsm                               1/0/0                  1/0/0

Continue? [y/n]:y

Re-optimization of the placement start. You will be notified on completion

Re-optimization of the placement complete. Use 'display placement' to view the new placement


DLDP commands

display dldp

Use display dldp to display DLDP configuration.

Syntax

display dldp [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify this option, the command displays global and port-specific DLDP configuration.

Examples

# Display global and port-specific DLDP configuration.

<Sysname> display dldp

 DLDP global status: Enabled

 DLDP advertisement interval: 5s

 DLDP authentication-mode: Simple

 DLDP authentication-password: ******

 DLDP unidirectional-shutdown mode: Auto

 DLDP delaydown-timer value: 1s

 Number of enabled ports: 2

 

Interface GigabitEthernet1/0/1

 DLDP port state: Bidirectional

 Number of the port’s neighbors: 1

  Neighbor MAC address: 0023-8956-3600

  Neighbor port index: 79

  Neighbor state: Confirmed

  Neighbor aged time: 13s

 

Interface GigabitEthernet1/0/2

 DLDP port state: Inactive

 Number of the port’s neighbors: 0 (Maximum number ever detected: 1)

# Display the DLDP configuration of GigabitEthernet 1/0/1.

<Sysname> display dldp interface gigabitethernet 1/0/1

Interface GigabitEthernet1/0/1

 DLDP port state: Bidirectional

 Number of the port’s neighbors: 1

  Neighbor MAC address: 0023-8956-3600

  Neighbor port index: 79

  Neighbor state: Confirmed

  Neighbor aged time: 13s

Table 40 Command output

Field

Description

DLDP global status

Global DLDP state (Enabled or Disabled).

DLDP advertisement interval

Interval for sending Advertisement packets (in seconds) to maintain neighbor relations.

DLDP authentication-mode

DLDP authentication mode (None, Simple, or MD5).

DLDP authentication-password

Password for DLDP authentication:

·     ******—The password has been configured.

·     Not configured—The authentication mode has been configured but no password is configured.

DLDP unidirectional-shutdown mode

Port shutdown mode (Auto or Manual) after unidirectional links are detected.

DLDP delaydown-timer value

Setting of the DelayDown timer, in seconds.

Number of enabled ports

Number of the DLDP-enabled ports.

Interface

Index of a DLDP-enabled port.

DLDP port state

DLDP state on a port:

·     Bidirectional.

·     Inactive.

·     Initial.

·     Unidirectional.

Number of the port’s neighbors

Current number of neighbors.

Maximum number ever detected

Maximum number of neighbors once detected on the port. This field appears only when the current number of neighbors is different from the maximum number of neighbors once detected.

Neighbor MAC address

MAC address of the neighbor.

Neighbor port index

Neighbor port index.

Neighbor state

Neighbor state (Confirmed or Unconfirmed).

Neighbor aged time

Neighbor aging time.

 

display dldp statistics

Use display dldp statistics to display DLDP packet statistics.

Syntax

display dldp statistics [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify this option, the command displays DLDP packet statistics for all interfaces.

Examples

# Display DLDP packet statistics for all interfaces.

<Sysname> display dldp statistics

Interface GigabitEthernet1/0/1

 Packets sent: 6

 Packets received: 5

 Invalid packets received: 2

 Loopback packets received: 0

 Authentication-failed packets received: 0

 Valid packets received: 3

 

Interface GigabitEthernet1/0/2

 Packets sent: 7

 Packets received: 7

 Invalid packets received: 3

 Loopback packets received: 0

 Authentication-failed packets received: 0

 Valid packets received: 4

Table 41 Command output

Field

Description

Interface

Port index.

Packets sent

Total number of DLDP packets sent.

Packets received

Total number of DLDP packets received.

Invalid packets received

Number of the invalid packets received.

Loop packets received

Number of the loopback packets received.

Authentication failed packets received

Number of the received packets that failed to pass the authentication.

Valid packets received

Number of the valid packets received.

 

Related commands

reset dldp statistics

dldp authentication-mode

Use dldp authentication-mode to configure DLDP authentication.

Use undo dldp authentication-mode to restore the default.

Syntax

dldp authentication-mode { md5 | none | simple }

undo dldp authentication-mode

Default

DLDP authentication mode is none.

Views

System view

Predefined user roles

network-admin

Parameters

md5: Specifies the MD5 authentication mode.

none: Specifies not to perform authentication.

simple: Specifies the plaintext authentication mode.

Usage guidelines

To enable DLDP to operate correctly, make sure the DLDP authentication modes and the passwords configured on the two ends of a link are the same.

If you do not configure the authentication password after you configure the authentication mode, the authentication mode is none no matter which authentication mode you configure.

Examples

# Configure to perform plaintext authentication and set the password to abc (assuming that Device A and Device B are connected by a DLDP link).

·     Configure Device A:

<DeviceA> system-view

[DeviceA] dldp authentication-mode simple

[DeviceA] dldp authentication-password simple abc

·     Configure Device B:

<DeviceB> system-view

[DeviceB] dldp authentication-mode simple

[DeviceB] dldp authentication-password simple abc

Related commands

display dldp

dldp authentication-password

dldp authentication-password

Use dldp authentication-password to configure the password for DLDP authentication.

Use undo dldp authentication-password to restore the default.

Syntax

dldp authentication-password { cipher | simple } string

undo dldp authentication-password

Default

No DLDP authentication password is configured.

Views

System view

Predefined user roles

network-admin

Parameters

cipher: Specifies a password in encrypted form.

simple: Specifies a password in plaintext form. For security purposes, the password specified in plaintext form will be stored in encrypted form.

string: Specifies the password. Its plaintext form is a case-sensitive string of 1 to 16 characters. Its encrypted form is a case-sensitive string of 1 to 53 characters.

Usage guidelines

To enable DLDP to operate correctly, make sure the DLDP authentication modes and the passwords configured on the two ends of a link are the same.

If you do not configure the authentication password after you configure the authentication mode, the authentication mode is none no matter which authentication mode you configure.

Examples

# Configure to perform plaintext authentication and set the password to abc (assuming that Device A and Device B are connected by a DLDP link).

·     Configure Device A:

<DeviceA> system-view

[DeviceA] dldp authentication-mode simple

[DeviceA] dldp authentication-password simple abc

·     Configure Device B:

<DeviceB> system-view

[DeviceB] dldp authentication-mode simple

[DeviceB] dldp authentication-password simple abc

Related commands

display dldp

dldp authentication-mode

dldp delaydown-timer

Use dldp delaydown-timer to set the DelayDown timer.

Use undo dldp delaydown-timer to restore the default.

Syntax

dldp delaydown-timer time

undo dldp delaydown-timer

Default

The setting of the DelayDown timer is 1 second.

Views

System view

Predefined user roles

network-admin

Parameters

time: Specifies the DelayDown timer in the range of 1 to 5 seconds.

Usage guidelines

The DelayDown timer configured by using this command applies to all DLDP-enabled ports.

Examples

# Set the DelayDown timer to 2 seconds.

<Sysname> system-view

[Sysname] dldp delaydown-timer 2

Related commands

display dldp

dldp enable

Use dldp enable to enable DLDP on a port.

Use undo dldp enable to disable DLDP on a port.

Syntax

dldp enable

undo dldp enable

Default

DLDP is disabled on a port.

Views

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

DLDP can take effect only after you enable it globally and on a port.

Examples

# Enable DLDP globally, and then enable DLDP on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] dldp global enable

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] dldp enable

Related commands

display dldp

dldp global enable

dldp global enable

Use dldp global enable to enable DLDP globally.

Use undo dldp global enable to disable DLDP globally.

Syntax

dldp global enable

undo dldp global enable

Default

DLDP is disabled globally.

Views

System view

Predefined user roles

network-admin

Usage guidelines

DLDP can take effect only after you enable it globally and on a port.

Examples

# Enable DLDP globally.

<Sysname> system-view

[Sysname] dldp global enable

Related commands

display dldp

dldp enable

dldp interval

Use dldp interval to set the interval for sending Advertisement packets.

Use undo dldp interval to restore the default.

Syntax

dldp interval interval

undo dldp interval

Default

The interval for sending Advertisement packets is 5 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies Advertisement packets sending interval in the range of 1 to 100 seconds.

Usage guidelines

This command applies to all DLDP-enabled ports.

To enable DLDP to operate correctly, make sure the intervals for sending Advertisement packets configured on the two ends of a link are the same.

Examples

# Set the interval for sending Advertisement packets to 20 seconds.

<Sysname> system-view

[Sysname] dldp interval 20

Related commands

display dldp

dldp unidirectional-shutdown

Use dldp unidirectional-shutdown to set the port shutdown mode.

Use undo dldp unidirectional-shutdown to restore the default.

Syntax

dldp unidirectional-shutdown { auto | manual }

undo dldp unidirectional-shutdown

Default

The port shutdown mode is auto mode.

Views

System view

Predefined user roles

network-admin

Parameters

auto: Configures the port shutdown mode as auto mode. In this mode, when DLDP detects a unidirectional link, it shuts down the unidirectional port.

manual: Configures the port shutdown mode as manual mode. In this mode, when DLDP detects a unidirectional link, DLDP does not shut down the involved port but you must manually shut it down. When the link state is restored to bidirectional, you must manually bring up the port.

Examples

# Set the port shutdown mode to manual mode.

<Sysname> system-view

[Sysname] dldp unidirectional-shutdown manual

Related commands

display dldp

reset dldp statistics

Use reset dldp statistics to clear DLDP packet statistics.

Syntax

reset dldp statistics [ interface interface-type interface-number ]

Views

User view

Predefined user roles

network-admin

Parameters

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify this option, the command clears DLDP packet statistics for all interfaces.

Examples

# Clear DLDP packet statistics for all interfaces.

<Sysname> reset dldp statistics

Related commands

display dldp statistics


Index

A B C D O P R S T V


A

affinity location-set,132

affinity location-type,133

affinity program,134

affinity self,135

B

backup interface,1

backup threshold,2

backup timer delay,3

backup timer flow-check,4

backup track,5

bfd authentication-mode,57

bfd demand enable,58

bfd detect-interface,58

bfd detect-multiplier,59

bfd echo enable,60

bfd echo-source-ip,61

bfd echo-source-ipv6,61

bfd init-fail timer,62

bfd min-echo-receive-interval,63

bfd min-receive-interval,64

bfd min-transmit-interval,65

bfd multi-hop authentication-mode,66

bfd multi-hop destination-port,67

bfd multi-hop detect-multiplier,67

bfd multi-hop min-receive-interval,68

bfd multi-hop min-transmit-interval,69

bfd session init-mode,70

bfd template,70

C

cfd ais enable,10

cfd ais level,10

cfd ais period,11

cfd cc enable,12

cfd cc interval,13

cfd dm one-way,13

cfd dm two-way,14

cfd dm two-way continual,15

cfd dm two-way threshold,17

cfd enable,18

cfd hardware-cc,18

cfd linktrace,19

cfd linktrace auto-detection,20

cfd loopback,20

cfd md,22

cfd mep,23

cfd meplist,24

cfd mip-rule,26

cfd port-trigger,25

cfd service-instance,27

cfd slm,28

cfd slm continual,30

cfd slm port-trigger up-delay,31

cfd slm threshold,32

cfd tst,33

cfd tst continual,34

cfd tst threshold,35

D

delay,75

display bfd session,71

display cfd ais,36

display cfd dm one-way history,38

display cfd dm two-way history,39

display cfd linktrace-reply,41

display cfd linktrace-reply auto-detection,42

display cfd md,43

display cfd mep,44

display cfd meplist,48

display cfd mp,48

display cfd remote-mep,49

display cfd service-instance,50

display cfd slm history,51

display cfd status,53

display cfd tst history,53

display dldp,148

display dldp statistics,149

display ha service-group,136

display interface-backup state,6

display interface-backup statistics,7

display placement location,138

display placement policy,140

display placement program,141

display placement reoptimize,142

display track,76

display vrrp,91

display vrrp ipv6,113

display vrrp ipv6 statistics,120

display vrrp statistics,98

dldp authentication-mode,150

dldp authentication-password,151

dldp delaydown-timer,152

dldp enable,153

dldp global enable,153

dldp interval,154

dldp unidirectional-shutdown,155

O

object,80

P

placement program,144

placement reoptimize,145

R

reset bfd session statistics,73

reset cfd dm one-way history,55

reset cfd tst,55

reset dldp statistics,155

reset vrrp ipv6 statistics,123

reset vrrp statistics,101

S

snmp-agent trap enable bfd,74

snmp-agent trap enable vrrp,101

T

threshold percentage,81

threshold weight,81

track bfd,82

track interface,83

track interface physical,84

track interface protocol,85

track ip route reachability,86

track list boolean,87

track list threshold percentage,88

track list threshold weight,89

track nqa,90

V

vrrp check-ttl enable,102

vrrp dscp,103

vrrp ipv6 dscp,123

vrrp ipv6 mode,124

vrrp ipv6 vrid,125

vrrp ipv6 vrid preempt-mode,126

vrrp ipv6 vrid priority,127

vrrp ipv6 vrid shutdown,127

vrrp ipv6 vrid timer advertise,128

vrrp ipv6 vrid track,129

vrrp mode,103

vrrp version,104

vrrp vrid,105

vrrp vrid authentication-mode,106

vrrp vrid preempt-mode,107

vrrp vrid priority,108

vrrp vrid shutdown,109

vrrp vrid source-interface,109

vrrp vrid timer advertise,110

vrrp vrid track,111


 

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网