display bgp update-group

Use display bgp update-group to display information about BGP update groups.

Syntax

display bgp [ instance instance-name ] update-group ipv4 { multicast | [ unicast ] [ vpn-instance vpn-instance-name ] } [ ipv4-address ]

display bgp [ instance instance-name ] update-group ipv6 { multicast | [ unicast ] [ vpn-instance vpn-instance-name ] } [ ipv6-address ]

display bgp [ instance instance-name ] update-group link-state [ ipv4-address | ipv6-address ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP update group information for the default BGP instance.

ipv4: Displays BGP update group information for IPv4 address family.

ipv6: Displays BGP update group information for IPv6 address family.

link-state: Displays BGP update group information for LS address family.

multicast: Displays BGP update group information for multicast address family.

unicast: Displays BGP update group information for unicast address family.

vpn-instance vpn-instance-name: Displays BGP update group information for the MPLS L3VPN instance specified by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays update group information for the public network.

ipv4-address: Displays BGP update group information for the specified BGP peer.

ipv6-address: Displays BGP update group information for the specified IPv6 BGP peer.

Usage guidelines

The update group feature classifies BGP peers that have the same export policy into an update group. When BGP advertises routes to the peers in the update group, it uses the export policy to filter the routes and generates route updates for all the peers only once.

With this feature, BGP performs one-time policy filtering and encapsulation for a prefix before advertising the prefix to all the peers in the update group. For example, BGP advertises 1000 prefixes to 1000 peers that have the same export policy (in data centers for example). Without the update group feature, BGP matches the export policy 1000 × 1000 times. With the update group feature, BGP matches the export policy only 1000 × 1 times, improving encapsulation efficiency 1000 times.

If you do not specify any parameters, this command displays all update groups for the specified address family on the public network.

By default, the unicast keyword is used if the unicast and multicast keywords are not specified.

Examples

# Display information about all BGP update groups for the IPv4 unicast address family.

<Sysname> display bgp update-group ipv4

  Update-group ID: 0 
  Type: EBGP link
  4-byte AS number: Supported
  Site-of-Origin: Not specified
  Minimum time between advertisements: 30 seconds
  OutQ: 0
  Members: 1
    99.1.1.1

Table 118: Command output

Field	Description
Update-group ID	ID of the update group.
Type	BGP link type: IBGP link. EBGP link. Confed IBGP link—Confederation IBGP link. Confed EBGP link—Confederation EBGP link.
4-byte AS number: Supported	4-byte AS number suppression is disabled for the peers in the update group. The peers in the update group support 4-byte AS numbers.
4-byte AS number: Suppressed	4-byte AS number suppression is enabled for the peers in the update group.
Fake AS	A fake local AS number is configured for the peers in the update group.
Public-AS-Only: Yes	BGP route updates advertised to the peers in the update group only carry the public AS number without the private AS number. Yes—If a peer uses a private AS number, the AS number is used as an update group classification criterion. If a peer uses a public AS number, the AS number is not used as an update group classification criterion. No—The AS number is not used as an update group classification criterion.
Substitute-AS: Yes	AS number substitution is enabled.
Minimum time between advertisements: number seconds	Minimum time between advertisements.
Advertising community: Yes	Community advertisement to peers in the update group is enabled.
Route-reflect client: Yes	The peer is a client of the route reflector.
Advertising extended community: Yes	Extended community advertisement to peers in the update group is enabled.
Export AS-path-ACL	AS path ACL used to filter BGP routes advertised to peers in the update group.
Export prefix list	Prefix list used to filter BGP routes advertised to peers in the update group.
Export route policy	Routing policy used to filter BGP routes advertised to peers in the update group.
Export filter-policy	ACL used to filter BGP routes advertised to peers in the update group.
OutQ	Number of prefixes to be advertised to peers in the update group.
Members	Number and IP addresses of peers in the update group.
Nesting VPN	Peers in the update group support nesting VPN.
UPE: Yes	Peers in the update group are UPE devices.
UPE export route policy	An outgoing routing policy is applied to peers in the update group.

prev	up	next
display bgp routing-table ipv6 unicast	home	domain-distinguisher