Specifies the name for the BFD profile custom resource.
As a cluster administrator, you can add, modify, and delete Bidirectional Forwarding Detection (BFD) profiles. The MetalLB Operator uses the BFD profile custom resources to identify which BGP sessions use BFD to provide faster path failure detection than BGP alone provides.
The fields for the BFD profile custom resource are described in the following table.
Field | Type | Description |
---|---|---|
|
|
Specifies the name for the BFD profile custom resource. |
|
|
Specifies the namespace for the BFD profile custom resource. |
|
|
Specifies the detection multiplier to determine packet loss. The remote transmission interval is multiplied by this value to determine the connection loss detection timer. For example, when the local system has the detect multiplier set to The range is |
|
|
Specifies the echo transmission mode.
If you are not using distributed BFD, echo transmission mode works only when the peer is also FRR.
The default value is When echo transmission mode is enabled, consider increasing the transmission interval of control packets to reduce bandwidth usage.
For example, consider increasing the transmit interval to |
|
|
Specifies the minimum transmission interval, less jitter, that this system uses to send and receive echo packets.
The range is |
|
|
Specifies the minimum expected TTL for an incoming control packet. This field applies to multi-hop sessions only. The purpose of setting a minimum TTL is to make the packet validation requirements more stringent and avoid receiving control packets from other sessions. The default value is |
|
|
Specifies whether a session is marked as active or passive. A passive session does not attempt to start the connection. Instead, a passive session waits for control packets from a peer before it begins to reply. Marking a session as passive is useful when you have a router that acts as the central node of a star network and you want to avoid sending control packets that you do not need the system to send. The default value is |
|
|
Specifies the minimum interval that this system is capable of receiving control packets.
The range is |
|
|
Specifies the minimum transmission interval, less jitter, that this system uses to send control packets.
The range is |
As a cluster administrator, you can add a BFD profile and configure a BGP peer to use the profile. BFD provides faster path failure detection than BGP alone.
Install the OpenShift CLI (oc
).
Log in as a user with cluster-admin
privileges.
Create a file, such as bfdprofile.yaml
, with content like the following example:
apiVersion: metallb.io/v1beta1
kind: BFDProfile
metadata:
name: doc-example-bfd-profile-full
namespace: metallb-system
spec:
receiveInterval: 300
transmitInterval: 300
detectMultiplier: 3
echoMode: false
passiveMode: true
minimumTtl: 254
Apply the configuration for the BFD profile:
$ oc apply -f bfdprofile.yaml
Configure a BGP peer to use the BFD profile.