Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 08-BFD commands | 105.31 KB |
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
BFD commands
The term "interface" in this chapter refers to Layer 2 aggregate interfaces and Layer 3 interfaces, including VLAN interfaces and Layer 3 Ethernet interfaces. You can set an Ethernet port as a Layer 3 interface by using the port link-mode route command (see Layer 2—LAN Switching Configuration Guide).
The following commands can be configured in Layer 2 aggregate interface view:
· bfd authentication-mode
· bfd detect-multiplier
· bfd min-receive-interval
· bfd min-transmit-interval
For more information about configuring BFD on Layer 2 aggregate interfaces, see Layer 2—LAN Switching Configuration Guide.
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
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: Sets a ciphertext password.
cipher-string: Ciphertext password, which is a case-sensitive string of 33 to 53 characters.
plain: Sets a ciphertext password.
plain-string: Plaintext password, which is a case-sensitive string of 1 to 16 characters.
Usage guidelines
Use this command to enhance BFD session security.
For security purposes, all authentication passwords, including passwords configured in plain text, are saved in cipher text.
Examples
# Configure VLAN-interface 11 to perform simple authentication for single-hop BFD control packets, setting the authentication key ID to 1 and password to 123456.
<Sysname> system-view
[Sysname] interface vlan-interface 11
[Sysname-Vlan-interface11] 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 that have 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.
Examples
# Enable the Demand BFD session mode on VLAN-interface 11.
<Sysname> system-view
[Sysname] interface vlan-interface 11
[Sysname-Vlan-interface11] bfd demand enable
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 1 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 VLAN-interface 11.
<Sysname> system-view
[Sysname] interface vlan-interface 11
[Sysname-Vlan-interface11] bfd detect-multiplier 6
bfd echo enable
Use bfd echo enable to enable the echo packet mode.
Use undo bfd echo enable to restore the default.
Syntax
bfd echo enable
undo bfd echo enable
Default
The echo packet mode is disabled.
Views
Interface view
Predefined user roles
network-admin
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 does the following:
· Periodically sends echo packets to detect link connectivity.
· Decreases the control packet receiving rate at the same time.
Examples
# Enable the echo packet mode on VLAN-interface 11.
<Sysname> system-view
[Sysname] interface vlan-interface 11
[Sysname-Vlan-interface11] 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 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 value
undo bfd min-echo-receive-interval
Default
The minimum interval for receiving BFD echo packets is 400 milliseconds.
Views
Interface view
Predefined user roles
network-admin
Parameters
value: Specifies a minimum interval for receiving BFD echo packets, in milliseconds. The value takes 0 or is in the range of 100 to 1000.
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 VLAN-interface 11.
<Sysname> system-view
[Sysname] interface vlan-interface 11
[Sysname-Vlan-interface11] 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 value
undo bfd min-receive-interval
Default
The minimum interval for receiving single-hop BFD control packets is 400 milliseconds.
Views
Interface view, BFD template view
Predefined user roles
network-admin
Parameters
value: Specifies the minimum interval for receiving single-hop BFD control packets, in the range of 100 to 1000 milliseconds.
Usage guidelines
Configure 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 minimum interval for transmitting BFD control packets on the peer end and the 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 VLAN-interface 11.
<Sysname> system-view
[Sysname] interface vlan-interface 11
[Sysname-Vlan-interface11] 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 value
undo bfd min-transmit-interval
Default
The minimum interval for transmitting single-hop BFD control packets is 400 milliseconds.
Views
Interface view, BFD template view
Predefined user roles
network-admin
Parameters
value: Specifies the minimum interval for transmitting single-hop BFD control packets, in the range of 100 to 1000 milliseconds.
Usage guidelines
Use this command to make sure that the BFD packet sending rate does not exceed the device capability. The actual BFD control packet transmitting interval on the local end is the greater value between the minimum interval for transmitting BFD control packets on the local end and the 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 VLAN-interface 11.
<Sysname> system-view
[Sysname] interface vlan-interface 11
[Sysname-Vlan-interface11] 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
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: Sets a ciphertext password.
cipher-string: Sets the ciphertext password, which is a case-sensitive string of 33 to 53 characters.
plain: Sets a plaintext password.
plain-string: Sets the plaintext password, which is a case-sensitive string of 1 to 16 characters.
Usage guidelines
Use this command to enhance BFD session security.
For security purposes, all authentication passwords, including passwords configured in plain text, are saved in cipher text.
Examples
# Configure the simple authentication mode for multihop BFD control packets, setting the authentication key ID to 1 and password 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 2 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 value
undo bfd multi-hop min-receive-interval
Default
The minimum interval for receiving multihop BFD control packets is 400 milliseconds.
Views
System view
Predefined user roles
network-admin
Parameters
value: Specifies the minimum interval for receiving multihop BFD control packets, in the range of 100 to 1000 milliseconds.
Usage guidelines
When the packet sending rate of the peer end exceeds the packet receiving capability (minimum control packet receiving interval) of the local end, 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 value
undo bfd multi-hop min-transmit-interval
Default
The minimum interval for transmitting multihop BFD control packets is 400 milliseconds.
Views
System view
Predefined user roles
network-admin
Parameters
value: Specifies the minimum interval for transmitting multihop BFD control packets, in the range of 100 to 1000 milliseconds.
Usage guidelines
Use this command to make sure that the BFD packet sending rate does not exceed the device capability. The actual BFD control packet transmitting interval on the local end is the greater value between the minimum interval for transmitting BFD control packets on the local end and the 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: Uses 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: Uses 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
At least one end must operate in active mode for a BFD session to be established.
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 BFD template view.
Use undo bfd template to delete the BFD template.
Syntax
bfd template template-name
undo bfd template template-name
Default
No BFD template is created.
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: GigabitEthernet 1/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: 1
Protocol: OSPF
Diag Info: No Diagnostic
Template name: abc
# 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: GigabitEthernet 1/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: 1
Protocol: OSPFv3
Diag Info: No Diagnostic
Template name: abc
Table 3 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: up or down. |
|
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. |
|
Auth mode |
Session authentication mode (only simple is supported). |
|
Connect Type |
Connection type of the interface, direct or indirect. |
|
Running up for |
Time interval for which the session has been up. |
|
Detect Mode |
Detection mode: · Async—Asynchronous mode. · Demand—Demand mode. |
|
Slot |
IRF member ID. |
|
Diag Info |
Diagnostic information about the session. |
|
BFD template name. |
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
