[Contents] [Prev] [Next] [Index] [Report an Error]

show bgp group

Syntax

show bgp group
<brief | detail | summary>
<group-name>
<instance instance-name>
<logical-system (all | logical-system-name)>
<rtf>

Release Information

Command introduced before JUNOS Release 7.4.

Description

Display information about the configured Border Gateway Protocol (BGP) groups.

Options

none — Display group information about all BGP groups.

brief | detail | summary — (Optional) Display the specified level of output.

group-name(Optional) Display group information for the specified group.

instance instance-name(Optional) Display information about a particular BGP peer in the specified instance. The instance name can be master for the main instance, or any valid configured instance name or its prefix.

logical-system (all | logical-system-name) — (Optional) Perform this operation on all logical systems or on a particular logical system.

rtf — (Optional) Display BGP group route targeting information.

Required Privilege Level

view

List of Sample Output

show bgp group
show bgp group
show bgp group brief
show bgp group detail
show bgp group rtf detail
show bgp group summary
show bgp group summary

Output Fields

Table 14 describes the output fields for the show bgp group command. Output fields are listed in the approximate order in which they appear.

Table 14: show bgp group Output Fields

Field Name

Field Description

Level of Output

Group type or Group

Type of BGP group: Internal or External.

All levels

AS

AS number of the peer. For internal BGP (IBGP), this number is the same as Local AS.

brief detail none

Local AS

AS number of the local router.

brief detail none

Name

Name of a specific BGP group.

brief detail none

Flags

Flags associated with the BGP group. This field is used by Juniper Networks Customer Support.

brief detail none

Export

Export policies configured for the BGP group with the export statement.

brief detail none

MED tracks IGP metric update delay

Time interval, in seconds, that updates to multiple exit discriminator (MED) are delayed. Also displays the time remaining before the interval is set to expire

All

Total peers

Total number of peers in the group.

brief detail none

Established

Number of peers in the group that are in the established state.

All levels

Active/Received/Accepted/Damped

Multipurpose field that displays information about BGP peer sessions. The field's contents depend upon whether a session is established and whether an established session was established in the main router or in a routing instance.

  • If a peer is not established, the field shows the state of the peer session: Active, Connect, or Idle.
  • If a BGP session is established in the main router, the field shows the number of active, received, accepted, and damped routes that are received from a neighbor and appear in the inet.0 (main) and inet.2 (multicast) routing tables. For example, 8/10/10/2 2/4/4/0 indicates the following:
    • 8 active routes, 10 received routes, 10 accepted routes, and 2 damped routes from a BGP peer appear in the inet.0 routing table.
    • 2 active routes, 4 received routes, 4 accepted routes, and no damped routes from a BGP peer appear in the inet.2 routing table.

summary

ip-addresses

List of peers who are members of the group. The address is followed by the peer's port number.

All levels

Route Queue Timer

Number of seconds until queued routes are sent. If this time has already elapsed, this field displays the number of seconds by which the updates are delayed.

detail

Route Queue

Number of prefixes that are queued up for sending to the peers in the group.

detail

inet.number

Number of active, received, accepted, and damped routes in the routing table. For example, inet.0: 7/10/9/0 indicates the following:

  • 7 active routes, 10 received routes, 9 accepted routes, and no damped routes from a BGP peer appear in the inet.0 routing table.

none

Table inet.number

Information about the routing table.

  • Received prefixes—Total number of prefixes from the peer, both active and inactive, that are in the routing table.
  • Active prefixes—Number of prefixes received from the peer that are active in the routing table.
  • Suppressed due to damping—Number of routes currently inactive because of damping or other reasons. These routes do not appear in the forwarding table and are not exported by routing protocols.
  • Received external prefixes—Total number of prefixes from the external BGP (EBGP) peers, both active and inactive, that are in the routing table.
  • Active external prefixes—Number of prefixes received from the EBGP peers that are active in the routing table.
  • Externals suppressed—Number of routes received from EBGP peers currently inactive because of damping or other reasons.
  • Received internal prefixes—Total number of prefixes from the IBGP peers, both active and inactive, that are in the routing table.
  • Active internal prefixes—Number of prefixes received from the IBGP peers that are active in the routing table.
  • Internals suppressed—Number of routes received from IBGP peers currently inactive because of damping or other reasons.
  • RIB State—Status of the graceful restart process for this routing table: BGP restart is complete, BGP restart in progress, VPN restart in progress, or VPN restart is complete.

detail

Groups

Total number of groups.

to be provided

Peers

Total number of peers.

to be provided

External

Total number of external peers.

to be provided

Internal

Total number of internal peers.

to be provided

Down peers

Total number of unavailable peers.

to be provided

Flaps

Total number of flaps that occurred.

to be provided

Table

Name of a routing table.

to be provided

Tot Paths

Total number of paths.

to be provided

Act Paths

Number of active routes.

to be provided

Suppressed

Number of routes currently inactive because of damping or other reasons. These routes do not appear in the forwarding table and are not exported by routing protocols.

to be provided

History

Number of withdrawn routes stored locally to keep track of damping history.

to be provided

Damp State

Number of active routes with a figure of merit greater than zero, but lower than the threshold at which suppression occurs.

to be provided

Pending

Routes being processed by BGP import policy.

to be provided

Group

Group the peer belongs to in the BGP configuration.

to be provided

Receive mask

Mask of the received target included in the advertised route.

to be provided

Entries

Number of route entries received.

to be provided

Target

Route target that is to be passed by route-target filtering. If a route advertised from the provider edge (PE) router matches an entry in the route-target filter, the route is passed to the peer.

to be provided

Mask

Mask that specifies the peer to receive routes with the given route target.

to be provided

Sample Output

show bgp group

user@host> show bgp group
Group Type: Internal    AS: 21                     Local AS: 21
  Name: from_vpn04_to_other Index: 0               Flags: <>
  Holdtime: 0
  Total peers: 3        Established: 3
  10.255.14.178+179
  10.255.71.24+179
  10.255.14.182+179
  inet.0: 2/7/0

Group Type: External                               Local AS: 21
  Name: from_vpn04_to_vpn06 Index: 1               Flags: <Export Eval>
Export: [ internal-and-bgp ]
  Holdtime: 0
  Traffic Statistics Interval: 300
  Total peers: 1        Established: 1
  100.1.3.2+2910
  inet.0: 5/10/0

Groups: 2  Peers: 4    External: 1    Internal: 3    Down peers: 0   Flaps: 2
Table          Tot Paths  Act Paths Suppressed    History Damp State    Pending
inet.0                17          7          0          0          0          0

show bgp group

user@host> show bgp group
Group Type: External                               Local AS: 65500
  Name: as65501peers    Index: 0                   Flags:  Export <Eval>
  Export: [ export-policy ] 
  Holdtime: 0
  Total peers: 1        Established: 1
  192.168.4.222+179
  Trace options:  all
  Trace file: /var/log/bgp size 10485760 files 10
  inet.0: 7/10/9/0
  inet.2: 0/0/0/0

Groups: 1  Peers: 1    External: 1    Internal: 0    Down peers: 0   Flaps: 0
Table          Tot Paths  Act Paths Suppressed    History Damp State    Pending
inet.0                10          7          0          0          0          0
inet.2                0           0          0          0          0          0

show bgp group brief

The output for the show bgp group brief command is identical to that for the show bgp group command. For sample output, see show bgp group.

show bgp group detail

user@host> show bgp group detail
Group Type: Internal    AS: 21                     Local AS: 21
  Name: from_vpn04_to_other Index: 0               Flags: <>
  Holdtime: 0
  Total peers: 3        Established: 3
  10.255.14.178+179
  10.255.71.24+179
  10.255.14.182+179
  Route Queue Timer: unset Route Queue: empty
  Table inet.0
    Active prefixes:              2
    Received prefixes:            7
    Suppressed due to damping:    0
    Advertised prefixes:          5

Group Type: External                               Local AS: 21
  Name: from_vpn04_to_vpn06 Index: 1               Flags:<Export Eval>
  Export: [ internal-and-bgp ]
  Holdtime: 0
  Traffic Statistics Interval: 300
  Total peers: 1        Established: 1
  100.1.3.2+2910
  Route Queue Timer: unset Route Queue: empty
  Table inet.0
    Active prefixes:              5
    Received prefixes:            10
    Suppressed due to damping:    0
    Advertised prefixes:          6

Groups: 2  Peers: 4    External: 1    Internal: 3    Down peers: 0   Flaps: 2
  Table inet.0
    Received prefixes:            17
    Active prefixes:              7
    Suppressed due to damping:    0
    Received external prefixes:   10
    Active external prefixes:     5
    Externals suppressed:         0
    Received internal prefixes:   7
    Active internal prefixes:     2
    Internals suppressed:         0
    RIB State: BGP restart is complete

show bgp group rtf detail

user@host> show bgp group rtf detail
Group: asbr
    Receive mask: 00000001
    Table: bgp.rtarget.0                    Flags: Filter   Entries: 4
        Target                           Mask
        109:1/64                         00000001
        109:2/64                         00000001
        701:1/64                         00000001
        10458:2/64                       00000001

Group: mesh_0
    Receive mask: 0000000e
    Table: bgp.rtarget.0                    Flags: Filter   Entries: 12
        Target                           Mask
        109:1/64                         00000002
        701:1/64                         00000002
        701:2/64                         00000002
        10458:1/64                       0000000e
        10458:2/64                       00000006
        10458:3/64                       00000006
        10458:5/64                       00000006
        10458:6/64                       00000004
        10458:7/64                       00000008
        10458:8/64                       00000008
        10458:10/64                      00000002

show bgp group summary

user@host> show bgp group summary
Group        Type       Peers     Established    Active/Received/Damped
from_vpn04_to_other Internal 3    3
  inet.0           : 2/7/0
from_vpn04_to_vpn06 External 1    1
  inet.0           : 5/10/0

Groups: 2  Peers: 4    External: 1    Internal: 3    Down peers: 0   Flaps: 2
  inet.0           : 7/17/0 External: 5/10/0 Internal: 2/7/0

show bgp group summary

user@host> show bgp group summary
Group        Type       Peers     Established    Active/Received/Accepted/Damped
as65501peers External   1         1          
  Trace options:  all
  Trace file: /var/log/bgp size 10485760 files 10
  inet.0           : 7/10/9/0
  inet.2           : 0/0/0/0

Groups: 1  Peers: 1    External: 1    Internal: 0    Down peers: 0   Flaps: 0
  inet.0           : 7/10/9/0 External: 7/10/9/0 Internal: 0/0/0/0
  inet.2           : 0/0/0/0 External: 0/0/0/0 Internal: 0/0/0/0

[Contents] [Prev] [Next] [Index] [Report an Error]