pn_vrouterbgp – CLI command to add/remove/modify vrouter-bgp
New in version 2.2.
DEPRECATED
| Removed in Ansible: | |
|---|---|
| version: 2.12 | |
| Why: | Doesn’t support latest Pluribus Networks netvisor |
| Alternative: | Latest modules will be pushed in Ansible future versions. |
Synopsis
- Execute vrouter-bgp-add, vrouter-bgp-remove, vrouter-bgp-modify command.
- Each fabric, cluster, standalone switch, or virtual network (VNET) can provide its tenants with a vRouter service that forwards traffic between networks and implements Layer 4 protocols.
Parameters
| Parameter | Choices/Defaults | Comments |
|---|---|---|
| pn_bfd
boolean
|
|
Specify if you want BFD protocol support for fault detection.
|
| pn_clipassword
-
|
Provide login password if user is not root.
|
|
| pn_cliswitch
-
|
Default:
"local"
|
Target switch(es) to run the cli on.
|
| pn_cliusername
-
|
Provide login username if user is not root.
|
|
| pn_default_originate
boolean
|
|
Specify if you want announce default routes to the neighbor or not.
|
| pn_ebgp
-
|
Specify a value for external BGP to accept or attempt BGP connections to external peers, not directly connected, on the network. This is a value between 1 and 255.
|
|
| pn_holdtime
-
|
Specify BGP neighbor holdtime in seconds.
|
|
| pn_keepalive
-
|
Specify BGP neighbor keepalive interval in seconds.
|
|
| pn_max_prefix
-
|
Specify the maximum number of prefixes.
|
|
| pn_max_prefix_warn
boolean
|
|
Specify if you want a warning message when the maximum number of prefixes is exceeded.
|
| pn_multiprotocol
-
|
|
Specify a multi-protocol for BGP.
|
| pn_neighbor
-
|
Specify a neighbor IP address to use for BGP.
Required for vrouter-bgp-add.
|
|
| pn_next_hop_self
boolean
|
|
Specify if the next-hop is the same router or not.
|
| pn_override_capability
boolean
|
|
Specify if you want to override capability.
|
| pn_password
-
|
Specify a password, if desired.
|
|
| pn_prefix_listin
-
|
Specify the prefix list to filter traffic inbound.
|
|
| pn_prefix_listout
-
|
Specify the prefix list to filter traffic outbound.
|
|
| pn_remote_as
-
|
Specify the remote Autonomous System(AS) number. This value is between 1 and 4294967295.
Required for vrouter-bgp-add.
|
|
| pn_route_mapin
-
|
Specify inbound route map for neighbor.
|
|
| pn_route_mapout
-
|
Specify outbound route map for neighbor.
|
|
| pn_route_reflector
boolean
|
|
Specify if a route reflector client is used.
|
| pn_soft_reconfig
boolean
|
|
Specify if you want a soft reconfiguration of inbound traffic.
|
| pn_vrouter_name
- / required
|
Specify a name for the vRouter service.
|
|
| pn_weight
-
|
Specify a default weight value between 0 and 65535 for the neighbor routes.
|
|
| state
- / required
|
|
State the action to perform. Use 'present' to add bgp, 'absent' to remove bgp and 'update' to modify bgp.
|
Examples
- name: add vrouter-bgp
pn_vrouterbgp:
state: 'present'
pn_vrouter_name: 'ansible-vrouter'
pn_neighbor: 104.104.104.1
pn_remote_as: 1800
- name: remove vrouter-bgp
pn_vrouterbgp:
state: 'absent'
pn_name: 'ansible-vrouter'
Return Values
Common return values are documented here, the following are the fields unique to this module:
| Key | Returned | Description |
|---|---|---|
| changed
boolean
|
always |
Indicates whether the CLI caused changes on the target.
|
| command
string
|
always |
The CLI command run on the target node(s).
|
| stderr
list
|
on error |
The set of error responses from the vrouterbgp command.
|
| stdout
list
|
always |
The set of responses from the vrouterbpg command.
|
Status
- This module will be removed in version 2.12. [deprecated]
- For more information see DEPRECATED.
Authors
- Pluribus Networks (@amitsi)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/pn_vrouterbgp_module.html