group (BGP multi-instance VPN instance IPv4 address family view)

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 [ internal | external ]

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.
internal	Creates an IBGP peer group.	-
external	Creates an EBGP peer group.	-

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.

internal

Creates an IBGP peer group.

external

Creates an EBGP peer group.

Views

BGP multi-instance VPN instance IPv4 address family view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
bgp	write

Usage Guidelines

Usage Scenario

A peer group consists of peers with the same routing policies. After a peer is added to a peer group, it inherits the configurations of this 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, many of which require the same policy. In such a case, you can run the group command to create a peer group, configure the policy for the peer group, and then add peers to the group, which simplifies configurations.

Configuration Impact

If the group command is run more than once, all configurations take effect.

After the group command is run, the system creates a BGP peer group of the specified type.

Precautions

After a peer group is deleted, all the peers in the peer group are deleted.

If no type (IBGP or EBGP) is specified for a peer group, an IBGP peer group is created by default.

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 using an undo command; then the peer inherits the attribute configuration of the peer group.

If you run the undo group command, all configurations related to the peer group are deleted. Therefore, exercise caution when running this command.

Note:

Deleting a peer group will disconnect the peers without AS numbers configured in the peer group. Therefore, before deleting a peer group, delete these peers or configure AS numbers for these peers.

The functions configured on a peer using the following commands take precedence over those configured on the peer group of the peer:

peer bfd
peer bfd block
peer bfd enable
peer listen-only
peer valid-ttl-hops
For other BGP commands, the latest configuration preferentially takes effect.

Example

# Create an IBGP peer group named in.

<HUAWEI> system-view
[~HUAWEI] ip vpn-instance vpna
[*HUAWEI-vpn-instance-vpna] ipv4-family
[*HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[*HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[*HUAWEI-vpn-instance-vpna-af-ipv4] quit
[*HUAWEI-instance-vpna] quit
[*HUAWEI] bgp 100 instance a
[*HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[*HUAWEI-bgp-instance-a-vpna] group in internal

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

<HUAWEI> system-view
[~HUAWEI] ip vpn-instance vpna
[*HUAWEI-vpn-instance-vpna] ipv4-family
[*HUAWEI-vpn-instance-vpna-af-ipv4] route-distinguisher 100:1
[*HUAWEI-vpn-instance-vpna-af-ipv4] vpn-target 111:1 both
[*HUAWEI-vpn-instance-vpna-af-ipv4] quit
[*HUAWEI-instance-vpna] quit
[*HUAWEI] bgp 100 instance a
[*HUAWEI-bgp-instance-a] ipv4-family vpn-instance vpna
[*HUAWEI-bgp-instance-a-vpna] group ex external
[*HUAWEI-bgp-instance-a-vpna] peer ex as-number 500.1