junipernetworks.junos.junos_bgp_global module – Manages BGP Global configuration on devices running Juniper JUNOS.
Note
This module is part of the junipernetworks.junos collection (version 2.10.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install junipernetworks.junos
.
To use it in a playbook, specify: junipernetworks.junos.junos_bgp_global
.
New in version 1.3.0: of junipernetworks.junos
Synopsis
This module manages global bgp configuration on devices running Juniper JUNOS.
Note
This module has a corresponding action plugin.
Requirements
The below requirements are needed on the host that executes this module.
ncclient (>=v0.6.4)
xmltodict (>=0.12.0)
Parameters
Parameter |
Comments |
---|---|
A list of BGP process configuration. |
|
Allow import policy to specify a non-directly connected next-hop. Choices:
|
|
Display add-path path-id in IPv4 address format. Choices:
|
|
Advertise bgp-static routes. |
|
Specify static route advertisement policy. |
|
Set Advertise bgp-static routes. Choices:
|
|
Advertise best external routes. |
|
Route matches active route upto med-comparison rule. Choices:
|
|
Set Advertise best external routes. Choices:
|
|
Advertise VPN routes from bgp.Xvpn.0 tables in master instance. Choices:
|
|
Advertise inactive routes. Choices:
|
|
Advertise routes received from the same autonomous system. Choices:
|
|
Specify Autonomous system number. |
|
Enable AS-Dot notation to display true 4 byte AS numbers. Choices:
|
|
Specify authentication algorithm name. Choices:
|
|
Specify MD5 authentication key. |
|
Specify authentication key chain name. |
|
Bidirectional Forwarding Detection (BFD) options. |
|
Authentication options. |
|
Specify algorithm name. Choices:
|
|
Specify Key chain name. |
|
Verify authentication only if authentication is negotiated. Choices:
|
|
Specify Detection-time optionss. |
|
Specify high detection-time triggering a trap (milliseconds). |
|
Specify time to hold the session-UP notification to the client. |
|
Specify minimum transmit and receive interval. |
|
Specify minimum receive interval. |
|
Specify detection time multiplier. |
|
Disable adaptation. Choices:
|
|
BFD single-hop or multihop session-mode. Choices:
|
|
Transmit-interval options. |
|
Specify Minimum transmit interval. |
|
Specify high transmit interval triggering a trap. |
|
Specify BFD protocol version number. Choices:
|
|
Handle BGP malformed updates softly. |
|
Maximum number of malformed routes from a peer. |
|
Time used when logging malformed update. |
|
Specify no malformed route limit. Choices:
|
|
Set BGP malformed updates softly. Choices:
|
|
Specific settings to override the routing-options settings. |
|
Enable/Disable monitoring. Choices:
|
|
Control route monitoring settings. |
|
Do not send route montoring messages. Choices:
|
|
Send post policy route montoring messages. Choices:
|
|
Send post policy route montoring messages and exclude unresolved routes, etc. Choices:
|
|
Send pre policy route montoring messages and exclude looped routes, etc. Choices:
|
|
Send pre policy route montoring messages. Choices:
|
|
Specify cluster identifier. |
|
Enable route flap damping. Choices:
|
|
Specify text description. |
|
Disable BGP. Choices:
|
|
Use Egress Peering traffic engineering. |
|
The ‘egress-te-backup-paths template’ to use for this peer. |
|
Set the attribute. Choices:
|
|
Backup-path for Egress-TE peer interface failure. |
|
Specify Backup-path template. |
|
Use IP-forward backup path for Egress TE. |
|
Routing-instance to use as IP forward backup-path. |
|
Set use IP-forward backup path for Egress TE. Choices:
|
|
Name of Egress-TE backup path. |
|
Specify address of BGP peer to use as backup next-hop. |
|
Specify address of remote-nexthop to use as backup path. |
|
Configure BGP-Peer-Set segment. |
|
BGP-Peer-Set SID label value from static label pool. |
|
Backup segment label value from static label pool. |
|
The BGP-Peer-Set segment name. |
|
Create BGP-Peer-SID sensor. Choices:
|
|
Enforce neighbor AS is the first AS in AS-PATH attribute (EBGP). Choices:
|
|
Specify export policy. |
|
Specify routing-instance used for data-forwarding and transport-session. |
|
BGP graceful restart options. |
|
Disable graceful restart. Choices:
|
|
Honor BFD-Down(C=0) if GR-restart not in progress. Choices:
|
|
Control forwarding-state flag negotiation. |
|
As for a route reflector client. Choices:
|
|
Always use state of associated FIB(s). Choices:
|
|
Long-lived graceful restart options. |
|
Advertise stale routes to non-LLGR neighbors. |
|
Set Advertise stale routes to non-LLGR neighbors. Choices:
|
|
Set Advertise stale routes to non-LLGR neighbors. Choices:
|
|
Disable receiver (helper) functionality. Choices:
|
|
Restart time used when negotiating with a peer. |
|
Set BGP graceful restart options. Choices:
|
|
Maximum time for which stale routes are kept. |
|
Specify name of the group. |
|
Allow import policy to specify a non-directly connected next-hop. Choices:
|
|
Display add-path path-id in IPv4 address format. Choices:
|
|
Advertise bgp-static routes. |
|
Specify static route advertisement policy. |
|
Set Advertise bgp-static routes. Choices:
|
|
Advertise best external routes. |
|
Route matches active route upto med-comparison rule. Choices:
|
|
Set Advertise best external routes. Choices:
|
|
Advertise inactive routes. Choices:
|
|
Advertise routes received from the same autonomous system. Choices:
|
|
Configure peer connections for specific networks. |
|
Replace neighbor AS number with our AS number Choices:
|
|
Specify authentication algorithm name. Choices:
|
|
Specify MD5 authentication key. |
|
Specify authentication key chain name. |
|
Bidirectional Forwarding Detection (BFD) options. |
|
Authentication options. |
|
Specify algorithm name. Choices:
|
|
Specify Key chain name. |
|
Verify authentication only if authentication is negotiated. Choices:
|
|
Specify Detection-time optionss. |
|
Specify high detection-time triggering a trap (milliseconds). |
|
Specify time to hold the session-UP notification to the client. |
|
Specify minimum transmit and receive interval. |
|
Specify minimum receive interval. |
|
Specify detection time multiplier. |
|
Disable adaptation. Choices:
|
|
BFD single-hop or multihop session-mode. Choices:
|
|
Transmit-interval options. |
|
Specify Minimum transmit interval. |
|
Specify high transmit interval triggering a trap. |
|
Specify BFD protocol version number. Choices:
|
|
Handle BGP malformed updates softly. |
|
Maximum number of malformed routes from a peer. |
|
Time used when logging malformed update. |
|
Specify no malformed route limit. Choices:
|
|
Set BGP malformed updates softly. Choices:
|
|
Specific settings to override the routing-options settings. |
|
Enable/Disable monitoring. Choices:
|
|
Control route monitoring settings. |
|
Do not send route montoring messages. Choices:
|
|
Send post policy route montoring messages. Choices:
|
|
Send post policy route montoring messages and exclude unresolved routes, etc. Choices:
|
|
Send pre policy route montoring messages and exclude looped routes, etc. Choices:
|
|
Send pre policy route montoring messages. Choices:
|
|
Specify cluster identifier. |
|
Enable route flap damping. Choices:
|
|
Specify text description. |
|
Use Egress Peering traffic engineering. |
|
The ‘egress-te-backup-paths template’ to use for this peer. |
|
Set the attribute. Choices:
|
|
Enforce neighbor AS is the first AS in AS-PATH attribute (EBGP). Choices:
|
|
Specify export policy. |
|
Specify routing-instance used for data-forwarding and transport-session. |
|
BGP graceful restart options. |
|
Disable graceful restart. Choices:
|
|
Honor BFD-Down(C=0) if GR-restart not in progress. Choices:
|
|
Control forwarding-state flag negotiation. |
|
As for a route reflector client. Choices:
|
|
Always use state of associated FIB(s). Choices:
|
|
Long-lived graceful restart options. |
|
Advertise stale routes to non-LLGR neighbors. |
|
Set Advertise stale routes to non-LLGR neighbors. Choices:
|
|
Set Advertise stale routes to non-LLGR neighbors. Choices:
|
|
Disable receiver (helper) functionality. Choices:
|
|
Restart time used when negotiating with a peer. |
|
Set BGP graceful restart options. Choices:
|
|
Maximum time for which stale routes are kept. |
|
Specify hold time used when negotiating with a peer. |
|
Stop peer session from coming up after nonstop-routing switch-over. |
|
Idle the peer until the user intervenes. Choices:
|
|
Specify timeout value, in seconds, for starting peer after switch over. |
|
Specify import policy. |
|
Include NEXT-HOP attribute in multiprotocol updates. Choices:
|
|
Specify IPSec SA name. |
|
Specify how to retain routes in the routing table. Choices:
|
|
Specify Address of local end of BGP session. |
|
Local autonomous system number. |
|
Treat this AS as an alias to the system AS. Choices:
|
|
Autonomous system number in plain number or (asdot notation) format. |
|
Maximum number of times this AS can be in an AS path. |
|
Maximum number of times this AS can be in an AS path. Choices:
|
|
Hide this local AS in paths learned from this peering. Choices:
|
|
Specify Local interface for IPv6 link local EBGP peering. |
|
Specify value of LOCAL_PREF path attribute. |
|
Enable log a message for peer state transitions. Choices:
|
|
Specify route metric sent in MED. |
|
Track the IGP metric. |
|
Delay updating MED when IGP metric increases. Choices:
|
|
Specify metric offset for MED. |
|
Set track the IGP metric. Choices:
|
|
Specify metric value. |
|
Track the minimum IGP metric. |
|
Specify metric offset for MED. |
|
Set track the minimum IGP metric. Choices:
|
|
Enable TCP path MTU discovery. Choices:
|
|
Configure an EBGP multihop session. |
|
Do not change next hop to self in advertisements. Choices:
|
|
Set an EBGP multihop session. Choices:
|
|
TTL value for the session. |
|
Allow load sharing among multiple BGP paths. |
|
Disable Multipath. Choices:
|
|
Use paths received from different ASs. Choices:
|
|
Disable multipath. Choices:
|
|
Set allow load sharing among multiple BGP paths. Choices:
|
|
Specify the name of the group |
|
Specify list of neighbors. |
|
Allow import policy to specify a non-directly connected next-hop. Choices:
|
|
Display add-path path-id in IPv4 address format. Choices:
|
|
Advertise bgp-static routes. |
|
Specify static route advertisement policy. |
|
Set Advertise bgp-static routes. Choices:
|
|
Advertise best external routes. |
|
Route matches active route upto med-comparison rule. Choices:
|
|
Set Advertise best external routes. Choices:
|
|
Advertise inactive routes. Choices:
|
|
Advertise routes received from the same autonomous system. Choices:
|
|
Replace neighbor AS number with our AS number Choices:
|
|
Specify authentication algorithm name. Choices:
|
|
Specify MD5 authentication key. |
|
Specify authentication key chain name. |
|
Bidirectional Forwarding Detection (BFD) options. |
|
Authentication options. |
|
Specify algorithm name. Choices:
|
|
Specify Key chain name. |
|
Verify authentication only if authentication is negotiated. Choices:
|
|
Specify Detection-time optionss. |
|
Specify high detection-time triggering a trap (milliseconds). |
|
Specify time to hold the session-UP notification to the client. |
|
Specify minimum transmit and receive interval. |
|
Specify minimum receive interval. |
|
Specify detection time multiplier. |
|
Disable adaptation. Choices:
|
|
BFD single-hop or multihop session-mode. Choices:
|
|
Transmit-interval options. |
|
Specify Minimum transmit interval. |
|
Specify high transmit interval triggering a trap. |
|
Specify BFD protocol version number. Choices:
|
|
Handle BGP malformed updates softly. |
|
Maximum number of malformed routes from a peer. |
|
Time used when logging malformed update. |
|
Specify no malformed route limit. Choices:
|
|
Set BGP malformed updates softly. Choices:
|
|
Specific settings to override the routing-options settings. |
|
Enable/Disable monitoring. Choices:
|
|
Control route monitoring settings. |
|
Do not send route montoring messages. Choices:
|
|
Send post policy route montoring messages. Choices:
|
|
Send post policy route montoring messages and exclude unresolved routes, etc. Choices:
|
|
Send pre policy route montoring messages and exclude looped routes, etc. Choices:
|
|
Send pre policy route montoring messages. Choices:
|
|
Specify cluster identifier. |
|
Enable route flap damping. Choices:
|
|
Specify neighbor description. |
|
Use Egress Peering traffic engineering. |
|
The ‘egress-te-backup-paths template’ to use for this peer. |
|
Set the attribute. Choices:
|
|
Enforce neighbor AS is the first AS in AS-PATH attribute (EBGP). Choices:
|
|
Specify export policy. |
|
Specify routing-instance used for data-forwarding and transport-session. |
|
BGP graceful restart options. |
|
Disable graceful restart. Choices:
|
|
Honor BFD-Down(C=0) if GR-restart not in progress. Choices:
|
|
Control forwarding-state flag negotiation. |
|
As for a route reflector client. Choices:
|
|
Always use state of associated FIB(s). Choices:
|
|
Long-lived graceful restart options. |
|
Advertise stale routes to non-LLGR neighbors. |
|
Set Advertise stale routes to non-LLGR neighbors. Choices:
|
|
Set Advertise stale routes to non-LLGR neighbors. Choices:
|
|
Disable receiver (helper) functionality. Choices:
|
|
Restart time used when negotiating with a peer. |
|
Set BGP graceful restart options. Choices:
|
|
Maximum time for which stale routes are kept. |
|
Specify hold time used when negotiating with a peer. |
|
Stop peer session from coming up after nonstop-routing switch-over. |
|
Idle the peer until the user intervenes. Choices:
|
|
Specify timeout value, in seconds, for starting peer after switch over. |
|
Specify import policy. |
|
Include NEXT-HOP attribute in multiprotocol updates. Choices:
|
|
Specify IPSec SA name. |
|
Specify how to retain routes in the routing table. Choices:
|
|
Specify Address of local end of BGP session. |
|
Local autonomous system number. |
|
Treat this AS as an alias to the system AS. Choices:
|
|
Autonomous system number in plain number or (asdot notation) format. |
|
Maximum number of times this AS can be in an AS path. |
|
Maximum number of times this AS can be in an AS path. Choices:
|
|
Hide this local AS in paths learned from this peering. Choices:
|
|
Specify Local interface for IPv6 link local EBGP peering. |
|
Specify value of LOCAL_PREF path attribute. |
|
Enable log a message for peer state transitions. Choices:
|
|
Specify route metric sent in MED. |
|
Track the IGP metric. |
|
Delay updating MED when IGP metric increases. Choices:
|
|
Specify metric offset for MED. |
|
Set track the IGP metric. Choices:
|
|
Specify metric value. |
|
Track the minimum IGP metric. |
|
Specify metric offset for MED. |
|
Set track the minimum IGP metric. Choices:
|
|
Enable TCP path MTU discovery. Choices:
|
|
Configure an EBGP multihop session. |
|
Do not change next hop to self in advertisements. Choices:
|
|
Set an EBGP multihop session. Choices:
|
|
TTL value for the session. |
|
Allow load sharing among multiple BGP paths. |
|
Disable Multipath. Choices:
|
|
Use paths received from different ASs. Choices:
|
|
Disable multipath. Choices:
|
|
Set allow load sharing among multiple BGP paths. Choices:
|
|
Specify neighbor address. |
|
Allows to not advertise routes received from the same autonomous system. Choices:
|
|
Set router ID in aggregator path attribute to 0. Choices:
|
|
Disable intracluster route redistribution. Choices:
|
|
Specify how long before exporting routes from routing table. |
|
Dynamically negotiated cooperative route filtering. |
|
Using BGP ORF capability code 130 and Prefix ORF type 128. Choices:
|
|
Prefix-based outbound route filtering. |
|
Honor Prefix-based ORFs from remote peers. |
|
Honor IPv4 prefix filters. Choices:
|
|
Honor IPv6 prefix filters. Choices:
|
|
Set honor Prefix-based ORFs from remote peers. Choices:
|
|
Set prefix-based outbound route filtering. Choices:
|
|
Specify to not send open messages to a peer. Choices:
|
|
Specify Autonomous system number in plain number or ‘higher 16bits’.’Lower 16 bits’ format. |
|
Specify preference value. |
|
Remove well-known private AS numbers. |
|
Remove all private AS numbers and do not stop at the first public AS number. Choices:
|
|
Specify private AS replacement. Choices:
|
|
Use closest public AS number to replace a private AS number. Choices:
|
|
Remove peer loop-check. Choices:
|
|
Remove well-known private AS numbers. Choices:
|
|
Specify Compliance with RFC6514 SAFI129 format. Choices:
|
|
Enable route server client behavior. Choices:
|
|
Enable aggressive transmission of pure TCP ACKs and retransmissions. Choices:
|
|
Specify maximum TCP segment size. |
|
Configure trace options for BGP. |
|
Specify trace file options. |
|
Specify name of file in which to write trace information. |
|
Specify maximum number of trace files. |
|
Don’t allow any user to read the log file. Choices:
|
|
Specify maximum trace file size. |
|
Allow any user to read the log file. Choices:
|
|
Specify tracing parameters. |
|
Trace detailed information. Choices:
|
|
Disable this trace flag. Choices:
|
|
Filter to apply to this flag. |
|
Specify filter based on prefix. Choices:
|
|
Specify filter policy. |
|
Set filter to apply to this flag. Choices:
|
|
specify event name Choices:
|
|
Trace received packets. Choices:
|
|
Trace transmitted packets. Choices:
|
|
Specify TTL value for the single-hop peer. |
|
Specify BGP unconfigured peer graceful restart options. Choices:
|
|
Apply BGP export policy when exporting VPN routes. Choices:
|
|
Allows to not advertise routes received from the same autonomous system. Choices:
|
|
Set router ID in aggregator path attribute to 0. Choices:
|
|
Disable intracluster route redistribution. Choices:
|
|
Enable optimal route reflection for this client group. |
|
Backup node identifier for this client group. |
|
Primary node identifier for this client group. |
|
Specify how long before exporting routes from routing table. |
|
Dynamically negotiated cooperative route filtering. |
|
Using BGP ORF capability code 130 and Prefix ORF type 128. Choices:
|
|
Prefix-based outbound route filtering. |
|
Honor Prefix-based ORFs from remote peers. |
|
Honor IPv4 prefix filters. Choices:
|
|
Honor IPv6 prefix filters. Choices:
|
|
Set honor Prefix-based ORFs from remote peers. Choices:
|
|
Set prefix-based outbound route filtering. Choices:
|
|
Specify to not send open messages to a peer. Choices:
|
|
Specify Autonomous system number in plain number or ‘higher 16bits’.’Lower 16 bits’ format. |
|
Specify preference value. |
|
Remove well-known private AS numbers. |
|
Remove all private AS numbers and do not stop at the first public AS number. Choices:
|
|
Specify private AS replacement. Choices:
|
|
Use closest public AS number to replace a private AS number. Choices:
|
|
Remove peer loop-check. Choices:
|
|
Remove well-known private AS numbers. Choices:
|
|
Specify Compliance with RFC6514 SAFI129 format. Choices:
|
|
Enable route server client behavior. Choices:
|
|
Enable aggressive transmission of pure TCP ACKs and retransmissions. Choices:
|
|
Specify maximum TCP segment size. |
|
Configure trace options for BGP. |
|
Specify trace file options. |
|
Specify name of file in which to write trace information. |
|
Specify maximum number of trace files. |
|
Don’t allow any user to read the log file. Choices:
|
|
Specify maximum trace file size. |
|
Allow any user to read the log file. Choices:
|
|
Specify tracing parameters. |
|
Trace detailed information. Choices:
|
|
Disable this trace flag. Choices:
|
|
Filter to apply to this flag. |
|
Specify filter based on prefix. Choices:
|
|
Specify filter policy. |
|
Set filter to apply to this flag. Choices:
|
|
specify event name Choices:
|
|
Trace received packets. Choices:
|
|
Trace transmitted packets. Choices:
|
|
Specify TTL value for the single-hop peer. |
|
Specify BGP group type. Choices:
|
|
Specify BGP unconfigured peer graceful restart options. Choices:
|
|
Apply BGP export policy when exporting VPN routes. Choices:
|
|
Specify hold time used when negotiating with a peer. |
|
Hold all BGP stale-labels, facilating make-before-break for new label advertisements. Choices:
|
|
Stop peer session from coming up after nonstop-routing switch-over. |
|
Idle the peer until the user intervenes. Choices:
|
|
Specify timeout value, in seconds, for starting peer after switch over. |
|
Specify import policy. |
|
Include NEXT-HOP attribute in multiprotocol updates. Choices:
|
|
Specify IPSec SA name. |
|
Specify how to retain routes in the routing table. Choices:
|
|
Specify Address of local end of BGP session. |
|
Local autonomous system number. |
|
Treat this AS as an alias to the system AS. Choices:
|
|
Autonomous system number in plain number or (asdot notation) format. |
|
Maximum number of times this AS can be in an AS path. |
|
Maximum number of times this AS can be in an AS path. Choices:
|
|
Hide this local AS in paths learned from this peering. Choices:
|
|
Specify Local interface for IPv6 link local EBGP peering. |
|
Specify value of LOCAL_PREF path attribute. |
|
Enable log a message for peer state transitions. Choices:
|
|
Specify maximum number of times this AS can be in an AS path. |
|
Specify route metric sent in MED. |
|
Track the IGP metric. |
|
Delay updating MED when IGP metric increases. Choices:
|
|
Specify metric offset for MED. |
|
Set track the IGP metric. Choices:
|
|
Specify metric value. |
|
Track the minimum IGP metric. |
|
Specify metric offset for MED. |
|
Set track the minimum IGP metric. Choices:
|
|
Enable TCP path MTU discovery. Choices:
|
|
Configure an EBGP multihop session. |
|
Do not change next hop to self in advertisements. Choices:
|
|
Set an EBGP multihop session. Choices:
|
|
TTL value for the session. |
|
Allow load sharing among multiple BGP paths. |
|
Disable Multipath. Choices:
|
|
Use paths received from different ASs. Choices:
|
|
Disable multipath. Choices:
|
|
Set allow load sharing among multiple BGP paths. Choices:
|
|
Configure the multipath build priority. Choices:
|
|
Allows to not advertise routes received from the same autonomous system. Choices:
|
|
Set router ID in aggregator path attribute to 0. Choices:
|
|
Disable intracluster route redistribution. Choices:
|
|
Specify not to use precision timers for scheduling keepalives. Choices:
|
|
Specify how long before exporting routes from routing table. |
|
Dynamically negotiated cooperative route filtering. |
|
Using BGP ORF capability code 130 and Prefix ORF type 128. Choices:
|
|
Prefix-based outbound route filtering. |
|
Honor Prefix-based ORFs from remote peers. |
|
Honor IPv4 prefix filters. Choices:
|
|
Honor IPv6 prefix filters. Choices:
|
|
Set honor Prefix-based ORFs from remote peers. Choices:
|
|
Set prefix-based outbound route filtering. Choices:
|
|
BGP output queue priority scheduler for updates. |
|
Map policy’s priority class and BGP output-queue. |
|
Assign the ‘high’ priority class to this output-queue. |
|
Expedited queue; highest priority. Choices:
|
|
Specify output queue priorit. |
|
Assign the ‘low’ priority class to this output-queue. |
|
Expedited queue; highest priority. Choices:
|
|
Specify output queue priorit. |
|
Assign the ‘medium’ priority class to this output-queue. |
|
Expedited queue; highest priority. Choices:
|
|
Specify output queue priorit. |
|
Expedited queue; highest priority for number of tokens. |
|
Output queue priority; higher is better. |
|
Specify the priority. |
|
Specify update_tokens. |
|
Specify to not send open messages to a peer. Choices:
|
|
Configure path selection strategy. |
|
Compare MED on paths from different AS. Choices:
|
|
Ignore AS path comparison during path selection. Choices:
|
|
Use Cisco IOS nondeterministic path selection algorithm. Choices:
|
|
Compare router ID on BGP externals. Choices:
|
|
Use standard BGP rules during L2VPN path selection. Choices:
|
|
Add IGP cost to next-hop to MED before comparing MED values. |
|
Specify multiplier for IGP cost to next-hop. |
|
Specify Multiplier for MED. |
|
Set med-plus-igp attribute. Choices:
|
|
Specify Autonomous system number in plain number or ‘higher 16bits’.’Lower 16 bits’ format. |
|
Use precision timers for scheduling keepalives. Choices:
|
|
Specify preference value. |
|
Remove well-known private AS numbers. |
|
Remove all private AS numbers and do not stop at the first public AS number. Choices:
|
|
Specify private AS replacement. Choices:
|
|
Use closest public AS number to replace a private AS number. Choices:
|
|
Remove peer loop-check. Choices:
|
|
Remove well-known private AS numbers. Choices:
|
|
Specify Compliance with RFC6514 SAFI129 format. Choices:
|
|
Enable route server client behavior. Choices:
|
|
Enable BGP addpath advertisement optimization. Choices:
|
|
Customize SNMP behaviors specifically for BGP MIBs. |
|
Limit traps for backward transitions to only those moving from Established state. Choices:
|
|
Emit Length in OID for InetAddress MIB type. Choices:
|
|
Replace received segment routing traffic engineering preference value with override value. |
|
Specify duration (sec) MPLS labels allocated by BGP are kept after they go stale. |
|
Enable aggressive transmission of pure TCP ACKs and retransmissions. Choices:
|
|
Specify maximum TCP segment size. |
|
Configure trace options for BGP. |
|
Specify trace file options. |
|
Specify name of file in which to write trace information. |
|
Specify maximum number of trace files. |
|
Don’t allow any user to read the log file. Choices:
|
|
Specify maximum trace file size. |
|
Allow any user to read the log file. Choices:
|
|
Specify tracing parameters. |
|
Trace detailed information. Choices:
|
|
Disable this trace flag. Choices:
|
|
Filter to apply to this flag. |
|
Specify filter based on prefix. Choices:
|
|
Specify filter policy. |
|
Set filter to apply to this flag. Choices:
|
|
specify event name Choices:
|
|
Trace received packets. Choices:
|
|
Trace transmitted packets. Choices:
|
|
Collect periodic ingress labeled statistics for BGP label-switched paths. |
|
Specify statistics file options. |
|
Specify name of file in which to write trace information. |
|
Specify maximum number of trace files. |
|
Don’t allow any user to read the log file. Choices:
|
|
Specify maximum trace file size. |
|
Allow any user to read the log file. Choices:
|
|
Specify time interval to collect statistics. |
|
Specify TTL value for the single-hop peer. |
|
Specify BGP unconfigured peer graceful restart options. Choices:
|
|
Apply BGP export policy when exporting VPN routes. Choices:
|
|
This option is used only with state parsed. The value of this option should be the output received from the Junos device by executing the command show protocols bgp. The state parsed reads the configuration from |
|
The state the configuration should be left in. State purged removes all (routing-options autonomous-system, bgp global, bgp groups, bgp neighbors, bgp family and bgp group and neighbor family) the BGP configurations from the target device. Use caution with this state. State deleted only removes BGP attributes that this modules manages and does not negate the BGP process completely. Thereby, preserving address-family related configurations under BGP context. Running states deleted and replaced will result in an error if there are address-family configuration lines present under a neighbor.Please use the junipernetworks.junos.junos_bgp_address_family modules for prior cleanup. Refer to examples for more details. Choices:
|
Notes
Note
This module requires the netconf system service be enabled on the device being managed.
This module works with connection
netconf
. See the Junos OS Platform Options.Tested against JunOS v18.4R1
Examples
# Using merged
#
# Before state
# ------------
#
# admin# show protocols bgp
# [edit]
# admin# show routing-options autonomous-system
# [edit]
- name: Merge Junos BGP config
junipernetworks.junos.junos_bgp_global:
config:
as_number: "65534"
loops: 3
asdot_notation: true
accept_remote_nexthop: true
add_path_display_ipv4_address: true
advertise_bgp_static:
policy: "static-to-bgp"
advertise_from_main_vpn_tables: true
advertise_inactive: true
authentication_algorithm: "md5"
bgp_error_tolerance:
malformed_route_limit: 20000000
bmp:
monitor: true
damping: true
description: "This is configured with Junos_bgp resource module"
egress_te_sid_stats: true
hold_time: 5
holddown_all_stale_labels: true
include_mp_next_hop: true
log_updown: true
no_advertise_peer_as: true
no_aggregator_id: true
no_client_reflect: true
out_delay: 10
precision_timers: true
preference: 2
state: merged
# After state
# -----------
#
# admin# show routing-options autonomous-system
# 65534 loops 3 asdot-notation;
# admin# show protocols bgp
# precision-timers;
# advertise-from-main-vpn-tables;
# holddown-all-stale-labels;
# description "This is configured with Junos_bgp resource module";
# accept-remote-nexthop;
# preference 2;
# hold-time 5;
# advertise-inactive;
# no-advertise-peer-as;
# no-aggregator-id;
# out-delay 10;
# log-updown;
# damping;
# bgp-error-tolerance {
# malformed-route-limit 20000000;
# }
# authentication-algorithm md5;
# no-client-reflect;
# include-mp-next-hop;
# bmp {
# monitor enable;
# }
# advertise-bgp-static {
# policy static-to-bgp;
# }
# add-path-display-ipv4-address;
# egress-te-sid-stats;
# Using merged
#
# Before state
# ------------
#
# admin# show routing-options autonomous-system
# 65534 loops 3 asdot-notation;
# admin# show protocols bgp
# precision-timers;
# advertise-from-main-vpn-tables;
# holddown-all-stale-labels;
# description "This is configured with Junos_bgp resource module";
# accept-remote-nexthop;
# preference 2;
# hold-time 5;
# advertise-inactive;
# no-advertise-peer-as;
# no-aggregator-id;
# out-delay 10;
# log-updown;
# damping;
# bgp-error-tolerance {
# malformed-route-limit 20000000;
# }
# authentication-algorithm md5;
# no-client-reflect;
# include-mp-next-hop;
# bmp {
# monitor enable;
# }
# advertise-bgp-static {
# policy static-to-bgp;
# }
# add-path-display-ipv4-address;
# egress-te-sid-stats;
- name: Update running Junos BGP config
junipernetworks.junos.junos_bgp_global:
config:
egress_te_backup_paths:
templates:
- path_name: customer1
peers:
- '11.11.11.11'
- '11.11.11.12'
- '11.11.11.13'
remote_nexthop: '2.2.2.2'
groups:
- name: 'internal'
type: 'internal'
vpn_apply_export: true
out_delay: 30
accept_remote_nexthop: true
add_path_display_ipv4_address: true
peer_as: '65534'
allow:
- 'all'
- '1.1.1.0/24'
neighbors:
- neighbor_address: '11.11.11.11'
peer_as: '65534'
out_delay: 11
- neighbor_address: '11.11.11.12'
peer_as: '65534'
out_delay: 12
- name: 'external'
out_delay: 20
peer_as: '65534'
accept_remote_nexthop: true
add_path_display_ipv4_address: true
neighbors:
- neighbor_address: '12.12.12.12'
peer_as: '65534'
out_delay: 21
accept_remote_nexthop: true
add_path_display_ipv4_address: true
- neighbor_address: '11.11.11.13'
peer_as: '65534'
out_delay: 31
accept_remote_nexthop: true
add_path_display_ipv4_address: true
state: merged
# After state
# -----------
#
# admin# show routing-options autonomous-system
# 65534 loops 3 asdot-notation;
# admin# show protocols bgp
# precision-timers;
# advertise-from-main-vpn-tables;
# holddown-all-stale-labels;
# egress-te-backup-paths {
# template customer1 {
# peer 11.11.11.11;
# peer 11.11.11.12;
# peer 11.11.11.13;
# remote-nexthop {
# 2.2.2.2;
# }
# }
# }
# description "This is configured with Junos_bgp resource module";
# accept-remote-nexthop;
# preference 2;
# hold-time 5;
# advertise-inactive;
# no-advertise-peer-as;
# no-aggregator-id;
# out-delay 10;
# log-updown;
# damping;
# bgp-error-tolerance {
# malformed-route-limit 20000000;
# }
# authentication-algorithm md5;
# no-client-reflect;
# include-mp-next-hop;
# bmp {
# monitor enable;
# }
# add-path-display-ipv4-address;
# egress-te-sid-stats;
# group internal {
# type internal;
# accept-remote-nexthop;
# out-delay 30;
# vpn-apply-export;
# peer-as 65534;
# add-path-display-ipv4-address;
# allow [ 0.0.0.0/0 1.1.1.0/24 ];
# neighbor 11.11.11.11 {
# out-delay 11;
# peer-as 65534;
# }
# neighbor 11.11.11.12 {
# out-delay 12;
# peer-as 65534;
# }
# }
# group external {
# accept-remote-nexthop;
# out-delay 20;
# peer-as 65534;
# add-path-display-ipv4-address;
# neighbor 12.12.12.12 {
# accept-remote-nexthop;
# out-delay 21;
# peer-as 65534;
# add-path-display-ipv4-address;
# }
# neighbor 11.11.11.13 {
# accept-remote-nexthop;
# out-delay 31;
# peer-as 65534;
# add-path-display-ipv4-address;
# }
# }
# Using replaced
#
# Before state
# ------------
#
# admin# show routing-options autonomous-system
# [edit]
# admin# show protocols bgp
# precision-timers;
# advertise-from-main-vpn-tables;
# holddown-all-stale-labels;
# description "This is configured with Junos_bgp resource module";
# accept-remote-nexthop;
# preference 2;
# hold-time 5;
# advertise-inactive;
# no-advertise-peer-as;
# no-aggregator-id;
# out-delay 10;
# log-updown;
# damping;
# bgp-error-tolerance {
# malformed-route-limit 20000000;
# }
# authentication-algorithm md5;
# no-client-reflect;
# include-mp-next-hop;
# bmp {
# monitor enable;
# }
# advertise-bgp-static {
# policy static-to-bgp;
# }
# add-path-display-ipv4-address;
# egress-te-sid-stats;
- name: Replace Junos BGP global config
junipernetworks.junos.junos_bgp_global:
config:
advertise_bgp_static:
policy: "static-to-bgp"
advertise_inactive: true
authentication_algorithm: "md5"
bfd_liveness_detection:
minimum_receive_interval: 8
multiplier: 30
no_adaptation: true
transmit_interval:
minimum_interval: 4
version: "automatic"
bgp_error_tolerance:
malformed_route_limit: 40000000
description: "This is configured with Junos_bgp resource module replace"
egress_te_sid_stats: true
hold_time: 5
out_delay: 10
preference: "2"
state: replaced
# After state
# -----------
#
# admin# show protocols bgp
# description "This is configured with Junos_bgp resource module replace";
# preference 2;
# hold-time 5;
# advertise-inactive;
# out-delay 10;
# bgp-error-tolerance {
# malformed-route-limit 40000000;
# }
# authentication-algorithm md5;
# advertise-bgp-static {
# policy static-to-bgp;
# }
# bfd-liveness-detection {
# version automatic;
# minimum-receive-interval 8;
# multiplier 30;
# no-adaptation;
# transmit-interval {
# minimum-interval 4;
# }
# }
# egress-te-sid-stats;
# admin# show routing-options autonomous-system
# [edit]
#
# Using deleted
#
# Before state
# ------------
#
# admin# show protocols bgp
# precision-timers;
# advertise-from-main-vpn-tables;
# holddown-all-stale-labels;
# description "This is configured with Junos_bgp resource module";
# accept-remote-nexthop;
# preference 2;
# hold-time 5;
# advertise-inactive;
# no-advertise-peer-as;
# no-aggregator-id;
# out-delay 10;
# log-updown;
# damping;
# bgp-error-tolerance {
# malformed-route-limit 20000000;
# }
# authentication-algorithm md5;
# no-client-reflect;
# include-mp-next-hop;
# bmp {
# monitor enable;
# }
# add-path-display-ipv4-address;
# egress-te-sid-stats;
# group internal {
# out-delay 12;
# }
# admin# show routing-options autonomous-system
# 65534 loops 3 asdot-notation;
- name: Delete Junos BGP global config
junipernetworks.junos.junos_bgp_global:
config:
state: deleted
# After state
# -----------
# admin# show protocols bgp
# group internal {
# out-delay 12;
# }
# admin# show protocols bgp
# [edit]
# admin# show routing-options autonomous-system
# [edit]
# Using gathered
#
# Before state
# ------------
#
# admin# show protocols bgp
# description "This is configured with Junos_bgp resource module replace";
# preference 2;
# hold-time 5;
# advertise-inactive;
# out-delay 10;
# bgp-error-tolerance {
# malformed-route-limit 40000000;
# }
# authentication-algorithm md5;
# advertise-bgp-static {
# policy static-to-bgp;
# }
# bfd-liveness-detection {
# version automatic;
# minimum-receive-interval 8;
# multiplier 30;
# no-adaptation;
# transmit-interval {
# minimum-interval 4;
# }
# }
# egress-te-sid-stats;
- name: Gather Junos BGP global config
junipernetworks.junos.junos_bgp_global:
config:
state: gathered
#
#
# -------------------------
# Module Execution Result
# -------------------------
#
# "gathered": {
# "advertise_bgp_static": {
# "policy": "static-to-bgp"
# },
# "advertise_inactive": true,
# "authentication_algorithm": "md5",
# "bfd_liveness_detection": {
# "minimum_receive_interval": 8,
# "multiplier": 30,
# "no_adaptation": true,
# "transmit_interval": {
# "minimum_interval": 4
# },
# "version": "automatic"
# },
# "bgp_error_tolerance": {
# "malformed_route_limit": 40000000
# },
# "description": "This is configured with Junos_bgp resource module replace",
# "egress_te_sid_stats": true,
# "hold_time": 5,
# "out_delay": 10,
# "preference": "2"
# }
#
#
# Using purged
#
# Before state
# ------------
#
# admin# show protocols bgp
# precision-timers;
# advertise-from-main-vpn-tables;
# holddown-all-stale-labels;
# description "This is configured with Junos_bgp resource module";
# accept-remote-nexthop;
# preference 2;
# hold-time 5;
# advertise-inactive;
# no-advertise-peer-as;
# no-aggregator-id;
# out-delay 10;
# log-updown;
# damping;
# bgp-error-tolerance {
# malformed-route-limit 20000000;
# }
# authentication-algorithm md5;
# no-client-reflect;
# include-mp-next-hop;
# bmp {
# monitor enable;
# }
# add-path-display-ipv4-address;
# egress-te-sid-stats;
# group internal {
# out-delay 12;
# }
# admin# show routing-options autonomous-system
# 65534 loops 3 asdot-notation;
- name: Purge Junos BGP global config
junipernetworks.junos.junos_bgp_global:
config:
state: purged
# After state
# ----------
# admin# show protocols bgp
#
# [edit]
# admin# show routing-options autonomous-system
#
#[edit]
# Using rendered
#
#
- name: Render the commands for provided configuration
junipernetworks.junos.junos_bgp_global:
config:
authentication_algorithm: "md5"
bfd_liveness_detection:
minimum_receive_interval: 4
multiplier: 10
no_adaptation: true
transmit_interval:
minimum_interval: 2
version: "automatic"
bgp_error_tolerance:
malformed_route_limit: 20000000
bmp:
monitor: true
damping: true
description: "This is configured with Junos_bgp resource module"
egress_te_sid_stats: true
hold_time: 5
state: rendered
#
#
# -------------------------
# Module Execution Result
# -------------------------
#
#
# "rendered": "
# <nc:protocols
# xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0">
# <nc:bgp>
# <nc:damping/>
# <nc:egress-te-sid-stats/>
# <nc:authentication-algorithm>md5</nc:authentication-algorithm>
# <nc:description>This is configured with Junos_bgp resource module</nc:description>
# <nc:hold-time>5</nc:hold-time>
# <nc:bfd-liveness-detection>
# <nc:transmit-interval>
# <nc:minimum-interval>2</nc:minimum-interval>
# </nc:transmit-interval>
# <nc:minimum-receive-interval>4</nc:minimum-receive-interval>
# <nc:multiplier>10</nc:multiplier>
# <nc:no-adaptation/>
# <nc:version>automatic</nc:version>
# </nc:bfd-liveness-detection>
# <nc:bgp-error-tolerance>
# <nc:malformed-route-limit>20000000</nc:malformed-route-limit>
# </nc:bgp-error-tolerance>
# <nc:bmp>
# <nc:monitor>enable</nc:monitor>
# </nc:bmp>
# </nc:bgp>
# </nc:protocols>"
#
# Using parsed
# parsed.cfg
# ------------
# <?xml version="1.0" encoding="UTF-8"?>
# <rpc-reply message-id="urn:uuid:0cadb4e8-5bba-47f4-986e-72906227007f">
# <configuration changed-seconds="1590139550" changed-localtime="2020-05-22 09:25:50 UTC">
# <version>18.4R1-S2.4</version>
# <protocols>
# <bgp>
# <precision-timers />
# <advertise-from-main-vpn-tables />
# <holddown-all-stale-labels />
# <description>This is configured with Junos_bgp resource module</description>
# <accept-remote-nexthop />
# <preference>2</preference>
# <hold-time>5</hold-time>
# <advertise-inactive />
# <no-advertise-peer-as />
# <no-aggregator-id />
# <out-delay>10</out-delay>
# <log-updown />
# <damping />
# <bgp-error-tolerance>
# <malformed-route-limit>20000000</malformed-route-limit>
# </bgp-error-tolerance>
# <authentication-algorithm>md5</authentication-algorithm>
# <remove-private />
# <no-client-reflect />
# <include-mp-next-hop />
# <bmp>
# <monitor>disable</monitor>
# <route-monitoring>
# <none />
# </route-monitoring>
# </bmp>
# <advertise-bgp-static>
# <policy>static-to-bgp</policy>
# </advertise-bgp-static>
# <add-path-display-ipv4-address />
# <bfd-liveness-detection>
# <version>automatic</version>
# <minimum-receive-interval>4</minimum-receive-interval>
# <multiplier>10</multiplier>
# <no-adaptation />
# <transmit-interval>
# <minimum-interval>2</minimum-interval>
# </transmit-interval>
# <detection-time>
# <threshold>300000</threshold>
# </detection-time>
# </bfd-liveness-detection>
# <egress-te-sid-stats />
# <group>
# <name>internal</name>
# <out-delay>8</out-delay>
# </group>
# <group>
# <name>external</name>
# <out-delay>9</out-delay>
# </group>
# <group>
# <name>inboun</name>
# <type>internal</type>
# </group>
# <group>
# <name>ibgp</name>
# <type>internal</type>
# <local-address>10.2.2.2</local-address>
# <export>static-to-bgp</export>
# <neighbor>
# <name>10.1.1.1</name>
# </neighbor>
# </group>
# </bgp>
# <ospf3>
# <area>
# <name>0.0.0.100</name>
# <stub>
# <default-metric>200</default-metric>
# </stub>
# <interface>
# <name>so-0/0/0.0</name>
# <metric>5</metric>
# <priority>3</priority>
# </interface>
# </area>
# </ospf3>
# </protocols>
# <routing-options>
# <static>
# <route>
# <name>172.16.17.0/24</name>
# <discard />
# </route>
# </static>
# <router-id>10.200.16.75</router-id>
# <autonomous-system>
# <as-number>65432</as-number>
# </autonomous-system>
# </routing-options>
# </configuration>
# </rpc-reply>
- name: Parsed the device configuration to get output commands
junipernetworks.junos.junos_bgp_global:
running_config: "{{ lookup('file', './parsed.cfg') }}"
state: parsed
#
#
# -------------------------
# Module Execution Result
# -------------------------
#
#
# "parsed": {
# "accept_remote_nexthop": true,
# "add_path_display_ipv4_address": true,
# "advertise_bgp_static": {
# "policy": "static-to-bgp"
# },
# "advertise_from_main_vpn_tables": true,
# "advertise_inactive": true,
# "as_number": "65432",
# "authentication_algorithm": "md5",
# "bfd_liveness_detection": {
# "detection_time": {
# "threshold": 300000
# },
# "minimum_receive_interval": 4,
# "multiplier": 10,
# "no_adaptation": true,
# "transmit_interval": {
# "minimum_interval": 2
# },
# "version": "automatic"
# },
# "bgp_error_tolerance": {
# "malformed_route_limit": 20000000
# },
# "bmp": {
# "monitor": false,
# "route_monitoring": {
# "none": true
# }
# },
# "damping": true,
# "description": "This is configured with Junos_bgp resource module",
# "egress_te_sid_stats": true,
# "hold_time": 5,
# "holddown_all_stale_labels": true,
# "include_mp_next_hop": true,
# "log_updown": true,
# "no_advertise_peer_as": true,
# "no_aggregator_id": true,
# "no_client_reflect": true,
# "out_delay": 10,
# "precision_timers": true,
# "preference": "2"
# }
#
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
The resulting configuration model invocation. Returned: when changed Sample: “The configuration returned will always be in the same format\n of the parameters above.\n” |
|
The configuration prior to the model invocation. Returned: always Sample: “The configuration returned will always be in the same format\n of the parameters above.\n” |
|
The set of commands pushed to the remote device. Returned: always Sample: [” \u003cnc:protocols xmlns:nc=\”urn:ietf:params:xml:ns:netconf:base:1.0\”\u003e \u003cnc:bgp\u003e \u003cnc:damping/\u003e \u003cnc:egress-te-sid-stats/\u003e \u003cnc:authentication-algorithm\u003emd5\u003c/nc:authentication-algorithm\u003e \u003cnc:description\u003eThis is configured with Junos_bgp resource module\u003c/nc:description\u003e \u003cnc:hold-time\u003e5\u003c/nc:hold-time\u003e \u003cnc:bfd-liveness-detection\u003e \u003cnc:transmit-interval\u003e \u003cnc:minimum-interval\u003e2\u003c/nc:minimum-interval\u003e \u003c/nc:transmit-interval\u003e \u003cnc:minimum-receive-interval\u003e4\u003c/nc:minimum-receive-interval\u003e \u003cnc:multiplier\u003e10\u003c/nc:multiplier\u003e \u003cnc:no-adaptation/\u003e \u003cnc:version\u003eautomatic\u003c/nc:version\u003e \u003c/nc:bfd-liveness-detection\u003e \u003cnc:bgp-error-tolerance\u003e \u003cnc:malformed-route-limit\u003e20000000\u003c/nc:malformed-route-limit\u003e \u003c/nc:bgp-error-tolerance\u003e \u003cnc:bmp\u003e \u003cnc:monitor\u003eenable\u003c/nc:monitor\u003e \u003c/nc:bmp\u003e \u003c/nc:bgp\u003e \u003c/nc:protocols\u003e”, “xml 2”, “xml 3”] |
Authors
Rohit Thakur (@rohitthakur2590)