vrouter-bgp-add

This command adds Border Gateway Protocol (BGP) to a virtual router (vRouter) service on a fabric, cluster, or standalone switch.

Syntax   vrouter-bgp-add

vrouter-name name-string

Specify a name for the vRouter service.

Specify the following BGP arguments:

neighbor ip-address

Specify a neighbor IP address to use for BGP filtering.

remote-as remote-as-number

Specify the remote Autonomous System (AS) number. This is a value between 1 and 4294967295.

Specify any of the following BGP options:

next-hop-self|
no-next-hop-self

Specify if the next-hop is the same router or not.

password password-string

Specify a password, if desired.

ebgp-multihop number

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.

update-source vrouter loopback-interface ip

Specify the source IP address of BGP packets sent by the router. This parameter is required if you want BGP to perform peering over a loopback interface.

prefix-list-in vrouter prefix-list name

Specify the prefix list to filter traffic inbound.

prefix-list-out vrouter prefix-list name

Specify the prefix list to filter traffic outbound.

route-reflector-client|
no-route-reflector-client

Specify if a route reflector client is used.

override-capability|
no-override-capability

Specify if you want to override capability.

soft-reconfig-inbound|
no-soft-reconfig-inbound

Specify if you want a soft reconfiguration of inbound routes.

max-prefix max-prefix-number

Specify the maximum number of prefixes.

max-prefix-warn-only|
no-max-prefix-warn-only

Specify if you want a warning message when the maximum number of prefixes is exceeded.

bfd|no-bfd

Specify if you want BFD protocol support for fault detection.

bfd-multihop|no-bfd-multihop

Specify if you want to always use BFD multihop port for fault detection.

multi-protocol ipv4-unicast|ipv6-unicast|

Specify a multi-protocol for BGP.

weight none|weight

Specify a default weight value between 0 and 65535 for the neighbor routes.

default-originate|
no-default-originate

Specify if you want to announce default routes to the neighbor or not.

neighbor-keepalive-interval seconds

Specify the BGP keepalive interval in seconds. This is a value between 0 and 65535 seconds.

neighbor-holdtime seconds

Specify the BGP neighbor hold time in seconds. This is a value between 0 and 65535 seconds.

connect-retry-interval seconds

Specify the interval between retrying a connection. The interval can be from 0 to 65535 seconds.

route-map-in vrouter route-map name

Specify the name of the route map for incoming routes.

route-map-out vrouter route-map name

Specify the name of the route map for outgoing routes.

allowas-in|no-allowas-in

Specify if you want to reject routes with local AS in AS_PATH. Normally, when you do not set this option, nodes reject routes containing their own AS which helps prevent routing loops. However, in some cases nodes that belong to the same AS have no direct connectivity; for example when you form clusters and choose not to use the cluster link for iBGP communication. In this case the only way to direct routes through connected eBGP neighbors is to set this option so that routes are not rejected from the cluster peer.

interface vrouter interface nic

Specify the interface to reach the neighbor.

advertisement-interval seconds

Specify the minimal time between sending out BGP routing updates. This is a value between 0 and 600 seconds.

The default value is zero (0) seconds.

Defaults   None.

Access   CLI

History   

Version 1.2

Command introduced.

Version 2.2

Parameters next-hop-self and password added.

Version 2.2.2

The parameters, ebgp-multihop, and update-source vrouter, added.

Version 2.2.3

The parameters, prefix-list-in, and prefix-list-out added. The parameters, override-capability, soft-reconfig-inbound, max-prefix, and max-prefix-warn added.

Version 2.2.6

The parameter, bfd|no-bfd, added.

Version 2.3.1

The parameter, multi-protocol, added.

Version 2.4

The parameters, weight and default-originate added. The parameters, neighbor-keepalive-interval, neighbor-holdtime, route-map-in vrouter, and route-map-out vrouter, added. The options, ipv4-multicast|ipv6-multicast| vpnv4-unicast, are deprecated for multi-protocol. 

Version 2.4.1

The options, ipv4-multicast|ipv6-multicast| vpnv4-unicast, are deprecated for multi-protocol.

Version 2.5.2

The parameter, allowas-in|no-allowas-in, added.

Version 2.6.2

The parameters, bfd-multihop and interface, added.

Version 3.0.2

The parameter, connection-retry-interval added.

Version 3.1.0

The parameter, advertisement-interval, added.

Usage   Each fabric, cluster, standalone switch, or virtual network (VNET) can provide tenants with a vRouter service that forwards traffic between networks and implements Layer 4 protocols. Use this command to add BGP to the vRouter service.

Examples  To add BGP to the vRouter service, BGP-vService, the neighbor IP address of 209.75.183.3, remote AS 45, and network address of 172.26.21.7/32, use the following command:

CLI network-admin@switch > vrouter-bgp-add vrouter-name BGP-vService neighbor 209.75.183.3 remote-as 45 network 172.26.21.7/32

vrouter-bgp-modify

This command modifies Border Gateway Protocol (BGP) to a virtual router (vRouter) service on a fabric, cluster, or standalone switch.

Syntax   vrouter-bgp-modify

vrouter-name name-string

Specify a name for the vRouter service.

Specify the following BGP arguments:

neighbor ip-address

Specify a neighbor IP address to use for BGP filtering.

remote-as remote-as-number

Specify the remote Autonomous System (AS) number. This is a value between 1 and 4294967295.

Specify any of the following BGP options:

next-hop-self|
no-next-hop-self

Specify if the next-hop is the same router or not.

password password-string

Specify a password, if desired.

ebgp-multihop number

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.

update-source vrouter loopback-interface ip

Specify the source IP address of BGP packets sent by the router. This parameter is required if you want BGP to perform peering over a loopback interface.

prefix-list-in vrouter prefix-list name

Specify the prefix list to filter traffic inbound.

prefix-list-out vrouter prefix-list name

Specify the prefix list to filter traffic outbound.

route-reflector-client|
no-route-reflector-client

Specify if a route reflector client is used.

override-capability|
no-override-capability

Specify if you want to override capability.

soft-reconfig-inbound|
no-soft-reconfig-inbound

Specify if you want a soft reconfiguration of inbound routes.

max-prefix max-prefix-number

Specify the maximum number of prefixes.

max-prefix-warn-only|
no-max-prefix-warn-only

Specify if you want a warning message when the maximum number of prefixes is exceeded.

bfd|no-bfd

Specify if you want BFD protocol support for fault detection.

bfd-multihop|no-bfd-multihop

Specify if you want to always use BFD multihop port for fault detection.

multi-protocol ipv4-unicast|ipv6-unicast|

Specify a multi-protocol for BGP.

weight none

Specify a default weight value between 0 and 65535 for the neighbor routes.

default-originate|
no-default-originate

Specify if you want to announce default routes to the neighbor or not.

neighbor-keepalive-interval seconds

Specify the BGP keepalive interval in seconds. This is a value between 0 and 65535 seconds.

neighbor-holdtime seconds

Specify the BGP neighbor hold time in seconds. This is a value between 0 and 65535 seconds.

connect-retry-interval seconds

Specify the interval between retrying a connection. The interval can be from 0 to 65535 seconds.

route-map-in vrouter route-map name

Specify the name of the route map for incoming routes.

route-map-out vrouter route-map name

Specify the name of the route map for outgoing routes.

interface vrouter interface nic

Specify the interface to reach the neighbor.

no-route-map-in

Specify if you want to remove an ingress route-map from a BGP neighbor

no-route-map-out

Specify if you want to remove an egress route-map from a BGP neighbor

advertisement-interval seconds

Specify the minimal time between sending out BGP routing updates. This is a value between 0 and 600 seconds.

The default value is zero (0) seconds

Defaults   None.

Access   CLI

History   

Version 1.2

Command introduced.

Version 2.2

Parameters next-hop-self and password added.

Version 2.2.2

The parameters, ebgp-multihop, and update-source vrouter, added.

Version 2.2.3

The parameters, prefix-list-in, and prefix-list-out added. The parameters, override-capability, soft-reconfig-inbound, max-prefix, and max-prefix-warn added.

Version 2.2.6

The parameter, bfd|no-bfd, added.

Version 2.3.1

The parameter, multi-protocol, added.

Version 2.4

The parameters, weight and default-originate added. The parameters, neighbor-keepalive-interval, neighbor-holdtime, route-map-in vrouter, and route-map-out vrouter, added. The options, ipv4-multicast|ipv6-multicast| vpnv4-unicast, are deprecated for multi-protocol.

Version 2.4.1

The options, ipv4-multicast|ipv6-multicast| vpnv4-unicast, are deprecated for multi-protocol.

Version 2.6.2

The parameters, bfd-multihop and interface, added.

Version 3.0.2

The parameter, connection-retry-interval added.

Version 3.1.0

The parameters, advertisement-interval, no-route-map-in and no-route-map-out, added.

Usage   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. Use this command to modify BGP configurations on the vRouter service.

Examples  To modify BGP to the vRouter service, BGP-vService, the neighbor IP address of 209.75.183.3, remote AS 45, and network address of 172.26.21.7/32, password, st@rsh1p, use the following command:

CLI network-admin@switch > vrouter-bgp-modify vrouter-name BGP-vService neighbor 209.75.183.3 remote-as 45 password

password:********

 

vrouter-bgp-remove

This command removes Border Gateway Protocol (BGP) from a virtual router (vRouter) service on a fabric, cluster, or standalone switch.

Syntax   vrouter-bgp-remove vrouter-name name-string ip ip-address 

vrouter-name name-string

Specify the name of the vRouter service.

Specify the following BGP arguments:

ip ip-address

Specify the IP address of the route to remove from the vRouter. This is either the neighbor IP address or network IP address.

Defaults   None.

Access   CLI

History   Command introduced in nvOS Version 1.2.1.

Usage   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. Use this command to remove BGP to the vRouter service.

Examples  To remove the neighbor BGP route from the vRouter service, BGP-vService, use the following command:

CLI network-admin@switch > vrouter-bgp-remove vrouter-name BGP-vService name 209.75.183.3

vrouter-bgp-show

This command displays Border Gateway Protocol (BGP) information for a virtual router (vRouter) service on a fabric, cluster, or standalone switch.

Syntax   vrouter-bgp-show

vrouter-name name-string

Specifies a name for the vRouter service.

Displays the following BGP arguments:

neighbor ip-address

Specifies a neighbor IP address to use for BGP filtering.

remote-as remote-as-number

Specifies the remote Autonomous System (AS) number.

next-hop-self|
no-next-hop-self

Specifies if the next-hop is the same router or not.

password password-string

Specifies a password, if desired.

ebgp-multihop number

Specifies 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.

update-source vrouter loopback-interface ip

Specifies the source IP address of BGP packets sent by the router. This parameter is required if you want BGP to perform peering over a loopback interface.

prefix-list-in vrouter prefix-list name

Specifies the prefix list to filter traffic inbound.

prefix-list-out vrouter prefix-list name

Specifies the prefix list to filter traffic outbound.

route-reflector-client|
no-route-reflector-
client

Specifies if a route reflector client is used.

override-capability|
no-override-capability

Specifies if you want to override capability.

soft-reconfig-inbound|
no-soft-reconfig-
inbound

Specifies if you want a soft reconfiguration of inbound routes.

max-prefix max-prefix-number

Specifies the maximum number of prefixes.

max-prefix-warn-only|
no-max-prefix-warn-only

Specifies if you want a warning message when the maximum number of prefixes is exceeded.

bfd|no-bfd

Specifies if BFD is enabled.

bfd-multihop|no-bfd-multihop

Specify if you want to always use BFD multihop port for fault detection.

multi-protocol ipv4-unicast|ipv6-unicast

Specify a multi-protocol for BGP.

weight none

Specify a default weight value between 0 and 65535 for the neighbor routes.

default-originate|
no-default-originate

Specify if you want to announce default routes to the neighbor or not.

neighbor-keepalive-interval seconds

Specify the BGP keepalive interval in seconds. This is a value between 0 and 65535 seconds.

neighbor-holdtime seconds

Specify the BGP neighbor hold time in seconds. This is a value between 0 and 65535 seconds.

connect-retry-interval seconds

Specify the interval between retrying a connection. The interval can be from 0 to 65535 seconds.

route-map-in vrouter route-map name

Specify the name of the route map for incoming routes.

route-map-out vrouter route-map name

Specify the name of the route map for outgoing routes.

allowas-in|no-allowas-in

Specify if you want to reject routes with local AS in AS_PATH. Normally, when you do not set this option, nodes reject routes containing their own AS which helps prevent routing loops. However, in some cases nodes that belong to the same AS have no direct connectivity; for example when you form clusters and choose not to use the cluster link for iBGP communication. In this case the only way to direct routes through connected eBGP neighbors is to set this option so that routes are not rejected from the cluster peer.

interface vrouter interface nic

Specify the interface to reach the neighbor.

Defaults   None.

Access   CLI

History   .

Version 1.2

Command introduced.

Version 2.2

Parameters next-hop-self and password added.

Version 2.2.2

The parameters, ebgp-multihop, and update-source vrouter, added.

Version 2.2.3

The parameters, prefix-list-in and prefix-list-out added. The parameters, override-capability, soft-reconfig-inbound, max-prefix, and max-prefix-warn added.

Version 2.2.6

The parameters, bfd|no-bfd, added.

Version 2.3.1

The parameter, multi-protocol, added.

Version 2.4

The parameters, weight and default-originate added. The parameters, neighbor-keepalive-interval, neighbor-holdtime, route-map-in vrouter, and route-map-out vrouter, added.

Version 2.4.1

The options, ipv4-multicast|ipv6-multicast| vpnv4-unicast, are deprecated for multi-protocol.

Version 2.5.2

The parameter, allowas-in|no-allowas-in, added.

Version 2.6.2

The parameters, bfd-multihop and interface, added.

Version 3.0.2

The parameter, connection-retry-interval added.

Version 3.1.0

The parameter, advertisement-interval, added.

Usage   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. Use this command to display information about BGP on the vRouter service.

Examples  To display all BGP vRouter service information, use the following command:

CLI network-admin@switch > vrouter-bgp-show layout vertical