- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
01-Text | 803.46 KB |
Contents
display interface-backup state
display interface-backup statistics
display cfd dm one-way history
display cfd dm two-way history
display cfd linktrace-reply auto-detection
bfd multi-hop authentication-mode
bfd multi-hop destination-port
bfd multi-hop detect-multiplier
bfd multi-hop min-receive-interval
bfd multi-hop min-transmit-interval
track list threshold percentage
vrrp ipv6 vrid timer advertise
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] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] backup interface gigabitethernet 1/0/2 50
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
Default
No traffic thresholds are configured.
Views
Interface view
Predefined user roles
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
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 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
Default
Both up and down delay timers are 5 seconds.
Views
Interface view
Predefined user roles
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
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.
backup timer flow-check interval
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] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] backup timer flow-check 60
backup interface
backup track
Use backup track to associate a backup interface with a track entry.
Use undo backup track to restore the default.
backup track track-entry-number
Default
An interface is not associated with a track entry.
Views
Interface view
Predefined user roles
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] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] backup track 1
display interface-backup state
Use display interface-backup state to display state information for primary and backup interfaces.
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
Description |
|
Name of the primary interface. |
|
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. |
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 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 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. |
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
Description |
|
Name of the primary interface. |
|
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. |
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. |
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. |
Number of incoming bytes on the load-shared primary and backup interfaces for the most recent polling interval. |
|
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
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
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
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
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.
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
<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. |
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
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
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
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.
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. |
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
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
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.
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. |
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 index:1
Maintenance association: ma_0
Maintenance association index:1
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 index:1
Maintenance association: ma_0
Maintenance association index:1
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 index:2
Maintenance association: ma_1
Maintenance association index: 2
MEP ID: 100 Level: 0 Service instance: 100 Direction: Outbound
Maintenance domain: md_0
Maintenance domain index:1
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.
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 number:0
Percentage of error messages:0.00%
MEP ID: 1004
Send status: Init
Sent TST total number: 5
Received TST total number: 0
Received bit error TST number:0
Percentage of error messages:0.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 number:0
Percentage of error messages:0.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. |
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
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
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] 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.
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. · MD5—MD5 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. · Backup—IP 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: · 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: · 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] 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] 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. · Backup—IP 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: · 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] 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] 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
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
affinity location-set,132
affinity location-type,133
affinity program,134
affinity self,135
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
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
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
object,80
placement program,144
placement reoptimize,145
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
snmp-agent trap enable bfd,74
snmp-agent trap enable vrrp,101
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
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