configure bgp add aggregate-address

configure bgp add aggregate-address {address-family [ipv4-unicast | ipv4-multicast |ipv6-unicast | ipv6-multicast]} ipaddress/masklength {as-match | as-set} {summary-only} {advertise-policy policy} {attribute-policy policy}


Configures a BGP (Border Gateway Protocol) aggregate route.

Syntax Description

address-family Specifies an IPv4 or IPv6 unicast or multicast address family.
ipaddress/masklength Specifies an IP network address and mask length.
as-match Generates autonomous system sequence path information (order of AS numbers in AS_PATH is preserved).
as-set Generates autonomous system set path information (order of AS numbers in AS_PATH is not preserved).
summary-only Specifies to send only aggregated routes to the neighbors.
advertise-policy Specifies the policy used to select routes for this aggregated route.
attribute-policy Specifies the policy used to set the attributes of the aggregated route.


If no address family is specified, IPv4 unicast is the default.


Usage Guidelines

Route aggregation is the process of combining the characteristics of several routes so that they are advertised as a single route. Aggregation reduces the amount of information that a BGP speaker must store and exchange with other BGP speakers. Reducing the information that is stored and exchanged also reduces the size of the routing table.

Before you can create an aggregate route, you must enable BGP aggregation using the following command:

enable bgp aggregation

If you do not specify an address family, this command applies to the IPv4 unicast address family. To apply this command to an address family other than the IPv4 unicast address family, you must specify the address family.



If the specified address is an IPv4 address, an IPv4 address family must be specified with the command. If the specified address is an IPv6 address, an IPv6 address family must be specified with the command.
BGP supports overlapping routes. For example, you can configure both of the following aggregate addresses:

After you create an aggregate route, the aggregate route remains inactive until BGP receives a route with an IP address and mask that conforms to an aggregate route. When a conforming route is received, the aggregate route becomes active and is advertised to BGP neighbors. If the summary-only option is specified, only the aggregate route becomes active and is advertised. If the summary-only option is omitted, any conforming aggregate routes and the received route are advertised to BGP neighbors.


The following command configures a BGP aggregate route:

configure bgp add aggregate-address


This command was first available in ExtremeXOS 10.1.

This command required a specific license in ExtremeXOS 11.1.

Support for overlapping aggregate addresses was added in ExtremeXOS 12.1.3.

Support for IPv6 was added in ExtremeXOS 12.6-BGP.

Platform Availability

This command is available on platforms that support the appropriate license. For complete information about software licensing, including how to obtain and upgrade your license and which licenses support the BGP feature, see the ExtremeXOS 22.2 Feature License Requirements document.