< Home

group

Function

The group command creates a peer group.

The undo group command deletes a peer group.

By default, no peer group is created.

Format

group group-name [ external | internal ]

undo group group-name

Parameters

Parameter Description Value
group-name Specifies the name of a peer group. The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
external Creates an EBGP peer group. -
internal Creates an IBGP peer group. -

Views

BGP view, BGP-VPN instance IPv4 address family view, BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A peer group is a group of peers with the same configurations. After a peer is added to a peer group, it inherits the configurations of this peer group. Peers in a peer group inherit the configurations of the peer group. When the configurations of the peer group are changed, the configurations of these peers are changed accordingly.

On a large-scale BGP network, there are a large number of peers and many of them have the same configurations. To configure these peers, you have to repeatedly use some commands. In such a case, configuring peer groups can simplify configurations. If the configurations for several peers are the same, these peers can be added to a created and configured peer group. The peers in the peer group then inherit the configurations of the peer group.

Precautions

If the group command is run multiple times, the latest configuration does not override the previous one.

If the type (IBGP or EBGP) of a peer group is not specified, an IBGP peer group is created by default.

The configuration of a peer takes precedence over that of the peer group to which the peer belongs.

If an attribute configuration of a BGP peer in a peer group differs from that of the peer group, you can disable the attribute configuration of the peer by using an undo command; then the peer inherits the attribute configuration of the peer group.

Deleting a peer group closes the connections on the peers that have no AS numbers in the peer group. Before deleting a peer group, you are recommended to delete these peers or configure AS numbers for these peers.

Example

# Create an IBGP peer group named in.

<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group in internal

# Create an EBGP peer group named ex, and set its AS number to 500.1.

<HUAWEI> system-view
[HUAWEI] bgp 100
[HUAWEI-bgp] group ex external
[HUAWEI-bgp] peer ex as-number 500.1
Copyright © Huawei Technologies Co., Ltd.
Copyright © Huawei Technologies Co., Ltd.
< Previous topic Next topic >