Skip to main content
API Version:

Anapaya appliance configuration (bgp only)

bgp object

Top-level configuration and state for the BGP router.

global object

Global configuration for the BGP router

asuint32

Local BGP autonomous system number of the router. Uses the 32-bit as-number type from the model in RFC 6991.

networksip-prefix[]

The list of network prefixes this BGP instance advertises.

router_iddotted-quad

Router id of the router - an unsigned 32-bit integer expressed in dotted quad notation.

src_addressip-address

Set the preferred source address when installing routes in the kernel.

neighbors object[]

Configuration for BGP neighbors

  • Array [
  • auth_passwordrouting-password

    An MD5 authentication password for use with the neighboring device.

    bfd object

    BFD configuration parameters relating to the BGP neighbor

    desired_minimum_tx_intervaluint32

    Minimum desired control packet transmission interval in milliseconds

    Possible values: >= 10 and <= 60000

    Default value: 300
    detection_multiplieruint8

    Local session detection multiplier

    Possible values: >= 2

    Default value: 3
    enabledboolean

    Enable BFD for the BGP neighbor

    Default value: false
    local_addressip-address

    Local address to use for BFD

    minimum_ttluint8

    For multihop sessions only: configure the minimum expected TTL for an incoming BFD control packet.

    Possible values: >= 1 and <= 254

    Default value: 254
    multihopboolean

    Enable BFD multihop

    Default value: false
    required_minimum_receiveuint32

    Minimum required control packet receive interval in milliseconds

    Possible values: >= 10 and <= 60000

    Default value: 300
    descriptionstring

    An optional textual description of the neighbor.

    ebgp_multihopuint8

    Specifying ebgp-multihop allows sessions with eBGP neighbors to establish when they are multiple hops away. When the neighbor is not directly connected and this setting is not enabled, the session will not establish.

    enabledboolean

    Whether the BGP peer is enabled. In cases where the enabled leaf is set to false, the local system will not initiate connections to the neighbor, and will not respond to TCP connections attempts from the neighbor. If the BGP session is established at the time that this property is set to false, the session will be ceased.

    Default value: true
    local_asuint32

    The local BGP autonomous system number that is to be used when establishing sessions with the remote peer or peer group, if this differs from the global BGP router autonomous system number.

    neighbor_addressip-address

    Address of the BGP peer, either IPv4 or IPv6.

    peer_asuint32

    BGP autonomous system number of the peer.

    timers object

    Timers related to a BGP neighbor

    connect_retryint32

    Time interval in seconds between attempts to establish a session with the peer.

    Default value: 30
    hold_timeint32

    Time interval in seconds that a BGP session will be considered active in the absence of keepalive or other messages from the peer. The hold-time is typically set to 3x the keepalive-interval.

    Default value: 30
    keepalive_intervalint32

    Time interval in seconds between transmission of keepalive messages to the neighbor. Typically set to 1/3 the hold-time.

    Default value: 10
    minimum_advertisement_intervalint32

    Minimum time in seconds which must elapse between subsequent UPDATE messages relating to a common set of NLRI being transmitted to a peer. This timer is referred to as MinRouteAdvertisementIntervalTimer by RFC 4721 and serves to reduce the number of UPDATE messages transmitted when a particular set of NLRI exhibit instability.

    Default value: 30
    transport object

    Transport session parameters for the BGP neighbor

    local_addressunion

    Set the local IPv4 address to be used for the session when sending BGP update messages. This may be expressed as either an IP address or the name of an interface.

    ttl_securityint32

    BGP Time To Live (TTL) security check. Reference: RFC 5082: The Generalized TTL Security Mechanism (GTSM), RFC 7454: BGP Operations and Security.

  • ]
  • Config_Bgp_Wrapped
    {
    "bgp": {
    "global": {
    "as": 0,
    "networks": [
    "string"
    ],
    "router_id": "string",
    "src_address": "string"
    },
    "neighbors": [
    {
    "auth_password": "string",
    "bfd": {
    "desired_minimum_tx_interval": 300,
    "detection_multiplier": 3,
    "enabled": false,
    "local_address": "string",
    "minimum_ttl": 254,
    "multihop": false,
    "required_minimum_receive": 300
    },
    "description": "string",
    "ebgp_multihop": 0,
    "enabled": true,
    "local_as": 0,
    "neighbor_address": "string",
    "peer_as": 0,
    "timers": {
    "connect_retry": 30,
    "hold_time": 30,
    "keepalive_interval": 10,
    "minimum_advertisement_interval": 30
    },
    "transport": {
    "local_address": "string"
    },
    "ttl_security": 0
    }
    ]
    }
    }