- Table of Contents
-
- 08-IP Multicast Command Reference
- 00-Preface
- 01-IGMP Snooping Commands
- 02-PIM Snooping Commands
- 03-Multicast VLAN Commands
- 04-Multicast Routing and Forwarding Commands
- 05-IGMP Commands
- 06-PIM Commands
- 07-MSDP Commands
- 08-MBGP Commands
- 09-Multicast VPN Commands
- 10-MLD Snooping Commands
- 11-IPv6 PIM Snooping Commands
- 12-IPv6 Multicast VLAN Commands
- 13-IPv6 Multicast Routing and Forwarding Commands
- 14-MLD Commands
- 15-IPv6 PIM Commands
- 16-IPv6 MBGP Commands
- Related Documents
-
Title | Size | Download |
---|---|---|
09-Multicast VPN Commands | 155.82 KB |
Multicast VPN configuration commands······································································································································· 1
display bgp mdt group·················································································································································· 1
display bgp mdt peer····················································································································································· 3
display bgp mdt routing-table······································································································································ 6
display multicast-domain vpn-instance share-group······························································································· 8
display multicast-domain vpn-instance switch-group receive················································································ 9
display multicast-domain vpn-instance switch-group send················································································· 11
ipv4-family mdt······························································································································································· 13
multicast-domain holddown-time································································································································ 13
multicast-domain log switch-group-reuse················································································································· 14
multicast-domain share-group····································································································································· 14
multicast-domain switch-delay···································································································································· 15
multicast-domain switch-group-pool·························································································································· 16
peer enable (BGP-MDT sub-address family view)······························································································· 17
peer group (BGP-MDT sub-address family view)································································································· 18
peer reflect-client (BGP-MDT sub-address family view)······················································································· 18
reflect between-clients (BGP-MDT sub-address family view)············································································· 19
reflector cluster-id (BGP-MDT sub-address family view)······················································································ 20
reset bgp mdt·································································································································································· 20
|
NOTE: The term router in this document refers to both routers and Layer 3 switches. |
display bgp mdt group
Syntax
display bgp mdt group [ group-name ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
group-name: Displays the information of the specified BGP MDT peer group. A group name is a case-sensitive string of 1 to 47 characters and must not contain any space.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display bgp mdt group command to display the information of a BGP MDT peer group.
Examples
# Display the information of the BGP MDT peer group test.
<Sysname> display bgp mdt group test
BGP peer-group is test
Remote AS 2004
Type : external
Maximum allowed prefix number: 4294967295
Threshold: 75%
Configured hold timer value: 180
Keepalive timer value: 60
Minimum time between advertisement runs is 30 seconds
Connect-interface has been configured
Multi-hop ebgp been enabled
Peer Preferred Value: 0
No routing policy is configured
Members:
Peer AS MsgRcvd MsgSent OutQ PrefRcv Up/Down State
2.2.2.1 2004 0 0 0 0 00:01:21 Active
Table 1 Output description
Field |
Description |
BGP peer-group |
BGP peer group name. |
Remote AS |
AS number of the peer group. |
Type |
Type of the peer group: · external: EBGP peer group · internal: IBGP peer group |
Maximum allowed prefix number |
Maximum number of allowed prefixes. |
Threshold |
Percentage of received prefixes from the peer group to maximum prefixes allowed to receive from the peer group. |
Configured hold timer value |
Holdtime interval. |
Keepalive timer value |
Keepalive interval. |
Minimum time between advertisement runs |
Minimum route advertisement interval. |
Connect-interface has been configured |
The source interface for TCP connection is configured. |
Multi-hop ebgp been enabled |
The hop count of the peer’s TCP connection can exceed 1 but cannot exceed the configured limit. |
Peer Preferred Value |
Preferred value specified for the routes from the peer. |
Members |
Detailed information of the members in the peer group. |
Peer |
IP address of the peer. |
AS |
AS number of the peer. |
MsgRcvd |
Number of received messages. |
MsgSent |
Number of sent messages. |
OutQ |
Number of messages to be sent. |
PrefRcv |
Number of received prefixes. |
Up/Down |
Length of time since the session was established/time elapsed in the current state (before the session is established). |
State |
State of the peer: · Active: Waiting for reestablishing a TCP connection after a establishment failure · Connect: A TCP connection is required but not established yet · Established: A TCP connection is established · Idle: No TCP connections are required after the peer relationship is configured · Idle(Admin): The peer is configured at the CLI not to require any TCP connection · Openconfirm: Waiting for the keepalive message after receiving an open message · Opensent: An open message is successfully sent to the peer |
display bgp mdt peer
Syntax
display bgp mdt peer [ [ ip-address ] verbose ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
ip-address: Displays the information of the specified BGP MDT peer.
verbose: Displays detailed information.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display bgp mdt peer command to display BGP MDT peer information.
Examples
# Display the detailed information of the BGP MDT peer 2.2.2.1.
<Sysname> display bgp mdt peer 2.2.2.1 verbose
Peer: 2.2.2.1 Local: 2.2.2.2
Type: IBGP link
BGP version 4, remote router ID 1.1.1.1
BGP current state: Established, Up for 00h01m51s
BGP current event: RecvKeepalive
BGP last state: OpenConfirm
Port: Local - 1029 Remote - 179
Configured: Active Hold Time: 180 sec Keepalive Time: 60 sec
Received : Active Hold Time: 180 sec
Negotiated: Active Hold Time: 180 sec Keepalive Time:60 sec
Peer optional capabilities:
Peer support bgp multi-protocol extended
Peer support bgp route refresh capability
Address family IPv4 Unicast: advertised and received
Address family IPv4 MDT: advertised and received
Received: Total 5 messages, Update messages 1
Sent: Total 4 messages, Update messages 0
Maximum allowed prefix number: 4294967295
Threshold: 75%
Minimum time between advertisement runs is 30 seconds
Optional capabilities:
Route refresh capability has been enabled
Connect-interface has been configured
Multi-hop ebgp been enabled
Peer Preferred Value: 0
Routing policy configured:
No routing policy is configured
Table 2 Output description
Field |
Description |
Peer |
IP address of the peer. |
Local |
Local router ID. |
Type |
Peer types: · IBGP link, indicating IBGP peers. · EBGP link, indicating EBGP peers. |
remote router ID |
Router ID of the peer. |
BGP current state |
Current state of the BGP peer: · Active: Waiting for reestablishing a TCP connection after a establishment failure. · Connect: A TCP connection is required but not established yet. · Established: A TCP connection is established between peers. · Idle: No TCP connections are required after the peer relationship is configured. · Idle(Admin): The peer is configured at the CLI not to require any TCP connection. · Openconfirm: Waiting for the keepalive message after receiving an open message. · Opensent: An open message is successfully sent to the peer. |
BGP current event |
Current event of the peer: · AdvTimerExpired: The route advertisement timer expires. · ConnCloesed: The TCP connection is closed. · ConnOpen: A TCP connection is required. · ConnOpenFailed: Fail to establish a TCP connection. · CRTTimerExpired: The connect timer expires. · HOLDTimerExpired: The holdtime timer expires. · KATTimerExpired: The keepalive timer expires. · RecvKeepalive: A keepalive message is received from the peer. · RecvNotification: A notification message is received from the peer. · RecvOpen: An open message is received from the peer. · RecvRouteRefresh: A route-refresh message is received from the peer. · RecvUpdate: An update message is received from the peer. · Start: No TCP connections are required after the peer relationship is configured. · Stop: The peer is configured not to require any TCP connection at the CLI. · TransFatalError: A fatal mistake occurs during the establishment of the TCP connection. |
BGP last state |
Previous state of the peer: · Active: Waiting for reestablishing a TCP connection after an establishment failure. · Connect: A TCP connection is required but not established yet. · Established: A TCP connection is established between peers. · Idle: No TCP connections are required after the peer relationship is configured. · Idle(Admin): The peer is configured at the CLI not to require any TCP connection. · Openconfirm: Waiting for the keepalive message after receiving an open message. · Opensent: An open message is successfully sent to the peer. |
Port |
Local and remote TCP port numbers for establishing a TCP connection. |
Configured |
Locally configured timer value: · Active Hold Time: The holdtime interval for the connection to the peer. · Keepalive Time: The keepalive interval for the connection to the peer. |
Received |
Received timer settings on the peer: Active Hold Time: The holdtime interval for the connection to the peer. |
Negotiated |
Negotiated timer settings: · Active Hold Time: The holdtime interval for the connection to the peer. · Keepalive Time: The keepalive interval for the connection to the peer. |
Peer optional capabilities |
Optional capabilities supported by the peer. |
Peer support bgp multi-protocol extended |
The peer supports multiprotocol BGP extensions. |
Peer support bgp route refresh capability |
The peer supports the BGP route refresh function. |
Address family IPv4 Unicast: advertised and received |
Routes are advertised and received in IPv4 unicasts. |
Address family IPv4 MDT: advertised and received |
Routes are advertised and received in IPv4 multicasts. |
Received |
Total numbers of received packets and updates. |
Sent |
Total numbers of sent packets and updates. |
Maximum allowed prefix number |
Maximum number of allowed prefixes. |
Threshold |
Percentage of received prefixes from the peer group to maximum prefixes allowed to receive from the peer group. |
Minimum time between advertisement runs |
Minimum route advertisement interval. |
Optional capabilities |
Optional capabilities enabled by the peer. |
Connect-interface has been configured |
The source interface for TCP connection is configured. |
Multi-hop ebgp been enabled |
The hop count of the peer’s TCP connection can exceed 1 but cannot exceed the configured limit. |
Peer Preferred Value |
Preferred value specified for the routes from the peer. |
Routing policy configured |
Local routing policy. |
display bgp mdt routing-table
Syntax
display bgp mdt { all | route-distinguisher route-distinguisher } routing-table [ ip-address [ mask | mask-length ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
all: Displays the information of all the BGP MDT routes.
route-distinguisher route-distinguisher: Displays the BGP MDT routing information of the specified route distinguisher. route-distinguisher identifies the route distinguisher name, a string of 3 to 21 characters in the form of nn:nn or IP-address:nn.
ip-address: Destination IP address.
mask: Network mask, 225.225.225.225 by default.
mask-length: Mask length, in the range 0 to 32. The default is 32.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display bgp mdt all routing-table command to display the BGP MDT routing information.
Examples
# Display all the BGP MDT routing information.
<Sysname> display bgp mdt all routing-table
BGP Local router ID is 2.2.2.2
Status codes: * - valid, ^ - VPNv4 best, > - best, d - damped,
h - history, i - internal, s - suppressed, S - Stale
Origin : i - IGP, e - EGP, ? - incomplete
Total number of MDT routes: 1
Route Distinguisher: 100:1
Network NextHop MED LocPrf PrefVal Path/Ogn
*> 1.1.1.1/32 3.3.3.3 0 100 10 ?
Table 3 Output description
Field |
Description |
Status codes |
Status codes: · * – valid · ^ - VPNv4 best · > – best · d – damped · h – history · i – internal · s – suppressed · S – Stale |
Origin |
· i – IGP (originated in the AS) · e – EGP (learned through EGP) · ? – incomplete (learned by some other means) |
Total number of MDT routes |
Total number of MDT routes |
Network |
MD source address displayed in the BGP routing table |
NextHop |
Next hop |
MED |
Metric associated with the destination network |
LocPrf |
Local preference value |
PrefVal |
Preferred value of the route |
Path |
AS_PATH attribute, recording the ASs the packet has passed to avoid routing loops |
Ogn |
Origin attribute of the route, which can be one of the following values: · i: Indicates that the route is interior to the AS. Aggregate routes and the routes injected with the network command are considered IGP routes. · e: Indicates that the route is learned from the Exterior Gateway Protocol (EGP). · ?: Indicates that the origin of the route is unknown, such as the MDT routes redistributed from other routing protocols. |
display multicast-domain vpn-instance share-group
Syntax
display multicast-domain vpn-instance vpn-instance-name share-group { local | remote } [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
vpn-instance-name: Name of an MPLS L3VPN instance, a case-sensitive string of 1 to 31 characters.
local: Displays the local share-group information.
remote: Displays the remote share-group information.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display multicast-domain vpn-instance share-group command to display the share-group information of the specified VPN instance in the MD.
Examples
# Display the local share-group information of VPN instance mvpn in the MD.
<Sysname> display multicast-domain vpn-instance mvpn share-group local
MD local share-group information for VPN-Instance: mvpn
Share-group: 225.2.2.2
MTunnel address: 1.1.1.1
# Display the remote share-group information of VPN instance mvpn in the MD.
<Sysname> display multicast-domain vpn-instance mvpn share-group remote
MD remote share-group information for VPN-Instance: mvpn
Route-Distinguisher Router-ID Share-Group Next-Hop
1:1 2.2.2.2 225.2.2.2 10.1.1.1
Table 4 Output description
Field |
Description |
MD local share-group information for VPN-Instance: mvpn |
Local share-group information of VPN instance mvpn |
MD remote share-group information for VPN-Instance: mvpn |
Remote share-group information of VPN instance mvpn |
Share-group |
Share-group address |
MTunnel address |
MTI address associated with the share-group address |
Router-ID |
Router ID of the peer that sends the route information |
Next-Hop |
IP address of the next hop |
display multicast-domain vpn-instance switch-group receive
Syntax
display multicast-domain vpn-instance vpn-instance-name switch-group receive [ brief | [ active | group group-address | sender source-address | vpn-source-address [ mask { mask-length | mask } ] | vpn-group-address [ mask { mask-length | mask } ] ] * ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
vpn-instance-name: Name of an MPLS L3VPN instance, a case-sensitive string of 1 to 31 characters.
brief: Displays the brief switch-group information received by the specified VPN instance.
active: Displays the received switch-group information about active multicast domains.
group-address: Public network multicast group address, in the range of 224.0.1.0 to 239.255.255.255.
source-address: Public network multicast source address.
vpn-source-address: VPN multicast source address.
mask: Subnet mask of the specified VPN multicast source/group address, 255.255.255.255 by default.
mask-length: Mask length of the specified multicast source/group address, in the range of 0 to 32. The system default is 32.
vpn-group-address: VPN multicast group address, in the range of 224.0.0.0 to 239.255.255.255.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display multicast-domain vpn-instance switch-group receive command to display the switch-group information received by the specified VPN instance in the MD.
Related commands: display multicast-domain vpn-instance switch-group send.
Examples
# Display the switch-group information received by VPN instance mvpn in the MD.
<Sysname> display multicast-domain vpn-instance mvpn switch-group receive
MD switch-group information received by VPN-Instance: mvpn
Total 2 switch-groups for 8 entries
Total 2 switch-groups for 8 entries matched
switch group: 226.1.1.0 ref count: 4, active count: 2
sender: 172.100.1.1 active count: 1
(192.6.1.5, 239.1.1.1) expire time: 00:03:10 active
(192.6.1.5, 239.1.1.158) expire time: 00:03:10
sender: 181.100.1.1 active count: 1
(195.6.1.2, 239.1.2.12) expire time: 00:03:10 active
(195.6.1.2, 239.1.2.197) expire time: 00:03:10
switch group: 229.1.1.0 ref count: 4, active count: 2
sender: 185.100.1.1 active count: 1
(198.6.1.5, 239.1.3.62) expire time: 00:03:10 active
(198.6.1.5, 225.1.1.109) expire time: 00:03:10
sender: 190.100.1.1 active count: 1
(200.6.1.2, 225.1.4.80) expire time: 00:03:10 active
(200.6.1.2, 225.1.4.173) expire time: 00:03:10
# Display the brief switch-group information received by VPN instance mvpn in the MD.
<Sysname> display multicast-domain vpn-instance mvpn switch-group receive brief
MD switch-group information received by VPN-Instance: mvpn
Total 2 switch-groups for 8 entries
Total 2 switch-groups for 8 entries matched
switch group: 226.1.1.0 ref count: 4, active count: 2
switch group: 229.1.1.0 ref count: 4, active count: 2
Table 5 Output description
Field |
Description |
MD switch-group information received by VPN-Instance: mvpn |
Switch-group information received by VPN instance mvpn |
Total 2 switch-groups for 8 entries |
Totally two switch-groups, corresponding to eight (S, G) entries |
Total 2 switch-groups for 8 entries matched |
Totally two switch-groups are matched, corresponding to eight (S, G) entries |
switch group |
Switch-group address received |
sender |
BGP peer address of the PE device that sent the switch-group information |
ref count |
Number of VPN multicast groups referenced by the switch-group |
active count |
Number of active VPN multicast groups (multicast groups with active receivers) referenced by the switch-group |
expire time |
Remaining time of the VPN (S, G) entry referenced by the switch-group |
display multicast-domain vpn-instance switch-group send
Syntax
display multicast-domain vpn-instance vpn-instance-name switch-group send [ group group-address | reuse interval | vpn-source-address [ mask { mask-length | mask } ] | vpn-group-address [ mask { mask-length | mask } ] ] * [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
vpn-instance-name: Name of an MPLS L3VPN instance, a case-sensitive string of 1 to 31 characters.
group-address: Multicast group address, in the range of 224.0.1.0 to 239.255.255.255.
reuse interval: Displays the information about switch-group reuses that took place during the specified length of time in seconds. The value range of interval is 1 to 2147483647.
vpn-source-address: VPN multicast source address.
mask: Subnet mask of the specified VPN multicast source/group address, 255.255.255.255 by default.
mask-length: Mask length of the specified multicast source/group address, in the range of 0 to 32. The system default is 32.
vpn-group-address: VPN multicast group address, in the range of 224.0.0.0 to 239.255.255.255.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display multicast-domain vpn-instance switch-group send command to display the switch-group information sent by the specified VPN instance in the MD.
Related commands: display multicast-domain vpn-instance switch-group receive.
Examples
# Display the switch-group information sent by VPN instance mvpn in the MD.
<Sysname> display multicast-domain vpn-instance mvpn switch-group send
MD switch-group information sent by VPN-Instance: mvpn
Total 2 switch-groups for 6 entries
Total 2 switch-groups for 6 entries matched
226.1.1.0 reference_count: 3
(192.6.1.5, 239.1.1.1) switch time: 00:00:21
(192.6.1.5, 239.1.1.158) switch time: 00:00:21
(192.6.1.5, 239.1.2.50) switch time: 00:00:05
226.1.1.1 reference_count: 3
(192.6.1.2, 225.1.1.1) switch time: 00:00:21
(192.6.1.2, 225.1.2.50) switch time: 00:00:05
(192.6.1.5, 239.1.1.159) switch time: 00:00:21
# Display the switch-group reuse information sent by VPN instance mvpn during 30 seconds in the MD.
<Sysname> display multicast-domain vpn-instance mvpn switch-group send reuse 30
MD switch-group information sent by VPN-Instance: mvpn
Total 2 switch-groups for 3 entries
Total 2 switch-groups for 3 entries matched
226.1.1.0 reuse_count: 1
226.1.1.1 reuse_count: 1
226.1.1.2 reuse_count: 1
Table 6 Output description
Field |
Description |
MD switch-group information sent by VPN-Instance: mvpn |
Switch-group information sent by VPN instance mvpn |
Total 2 switch-groups for 6 entries |
Totally two switch-groups, corresponding to six (S, G) entries |
Total 2 switch-groups for 6 entries matched |
Totally two switch-groups are matched, corresponding to six (S, G) entries |
reference_count |
Number of VPN multicast groups referenced by the sent switch-group |
switch time |
Switching time of the VPN (S, G) entry referenced by the switch-group |
reuse_count |
Number of switch-group reuses during the specified length of time |
ipv4-family mdt
Syntax
ipv4-family mdt
undo ipv4-family mdt
View
BGP view
Default level
2: System level
Parameters
None
Description
Use the ipv4-family mdt command to enter BGP-MDT sub-address family view.
Use the undo ipv4-family mdt command to remove all the settings made in BGP-MDT sub-address family view.
Examples
# Enter BGP-MDT sub-address family view.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv4-family mdt
[Sysname-bgp-af-mdt]
multicast-domain holddown-time
Syntax
multicast-domain holddown-time interval
undo multicast-domain holddown-time
View
VPN instance view
Default level
2: System level
Parameters
interval: Switch-holddown period in seconds, namely, the delay time before multicast traffic to be switched from the switch-MDT back to the share-MDT, in the range of 0 to 180.
Description
Use the multicast-domain holddown-time command to configure the switch-holddown period.
Use the undo multicast-domain holddown-time command to restore the default.
By default, the switch-holddown period is 60 seconds.
This command cannot be configured without previous share-MDT configuration in the VPN instance.
Examples
# Set the switch-holddown period to 80 seconds in VPN instance mvpn.
<Sysname> system-view
[Sysname] ip vpn-instance mvpn
[Sysname-vpn-instance-mvpn] multicast-domain holddown-time 80
multicast-domain log switch-group-reuse
Syntax
multicast-domain log switch-group-reuse
undo multicast-domain log
View
VPN instance view
Default level
2: System level
Parameters
None
Description
Use the multicast-domain log switch-group-reuse command to enable switch-group reuse logging.
Use the undo multicast-domain log command to disable switch-group reuse logging.
By default, the switch-group reuse logging function is disabled.
This command cannot be configured without the previous share-MDT configuration in the VPN instance.
Examples
# Enable switch-group reuse logging in VPN instance mvpn.
<Sysname> system-view
[Sysname] ip vpn-instance mvpn
[Sysname-vpn-instance-mvpn] multicast-domain log switch-group-reuse
multicast-domain share-group
Syntax
multicast-domain share-group group-address binding mtunnel mtunnel-number
undo multicast-domain share-group
View
VPN instance view
Default level
2: System level
Parameters
group-address: Multicast group address, in the range of 224.0.1.0 to 239.255.255.255.
mtunnel-number: Number of the MTI interface to be created. The value range varies with the system working modes. For more information, see Fundamentals Configuration Guide.
Description
Use the multicast-domain share-group command to configure a share-group address and associate an MTI with the current VPN instance.
Use the undo multicast-domain share-group command to restore the default.
By default, no share-group address is configured and no MTI is associated with a VPN instance.
To specify a multicast group address in the public network SSM group range as a share-group address, you must first configure BGP MDT peers or peer groups.
On the same PE device, different VPN instances must not have the same group address, and group-address must not coincide with the switch-group address of any VPN instance; in addition, mtunnel-number must not coincide with the number of any MTI already created.
This command must not be used repeatedly in the same VPN instance view. To configure a new group address and MTI for a VPN instance, you must remove the existing configuration.
The undo multicast-domain share-group command removes the configured MTI and the configurations of the multicast-domain switch-group-pool, multicast-domain log switch-group-reuse and multicast-domain switch-delay commands.
IP multicast routing must be enabled in the VPN instance before this command can take effect.
Related commands: multicast routing-enable, multicast-domain log switch-group-reuse, multicast-domain switch-delay, and multicast-domain switch-group-pool.
Examples
# Specify 224.1.1.1 as the share-group address in VPN instance mvpn and associate MTI 0 with the VPN instance.
<Sysname> system-view
[Sysname] ip vpn-instance mvpn
[Sysname-vpn-instance-mvpn] multicast-domain share-group 224.1.1.1 binding mtunnel 0
multicast-domain switch-delay
Syntax
multicast-domain switch-delay switch-delay
undo multicast-domain switch-delay
View
VPN instance view
Default level
2: System level
Parameters
switch-delay: Switch-delay period in seconds, namely, the delay time for multicast traffic to be switched from the share-MDT to the switch-MDT, in the range of 3 to 60.
Description
Use the multicast-domain switch-delay command to configure the switch-delay period.
Use the undo multicast-domain switch-delay command to restore the default.
By default, the switch-delay period is 5 seconds.
Examples
# Set the switch-delay period to 20 seconds in VPN instance mvpn.
<Sysname> system-view
[Sysname] ip vpn-instance mvpn
[Sysname-vpn-instance-mvpn] multicast-domain switch-delay 20
multicast-domain switch-group-pool
Syntax
multicast-domain switch-group-pool switch-group-pool { mask | mask-length } [ acl acl-number ]
undo multicast-domain switch-group-pool
View
VPN instance view
Default level
2: System level
Parameters
switch-group-pool: The start address of the switch-group-pool, in the range of 224.0.1.0 to 239.255.255.255.
mask: Mask for addresses in the switch-group-pool, the range of which varies with the system working modes. For more information, see Fundamentals Configuration Guide.
mask-length: Mask length for addresses in the switch-group-pool, the range of which varies with the system’s working mode. For more information, see Fundamentals Configuration Guide.
acl-number: Advanced ACL number, in the range of 3000 to 3999. An advanced ACL defines the (S, G) entry or entries to which the configured MDT switching condition will apply. If you do not specify an ACL, the configured MDT switching condition will apply to all (S, G) entries. When you configure this ACL, specify the protocol type as IP and use the source and destination parameters to specify a multicast source address range and a multicast group address range respectively.
Description
Use the multicast-domain switch-group-pool command to configure the address range of the switch-group-pool and the switching condition.
Use the undo multicast-domain switch-group-pool command to restore the default.
By default, no switch-group-pool is configured and multicast traffic is never switched to a switch-MDT.
This command cannot be configured without the previous share-MDT configuration in the VPN instance.
On a given PE device, the switch-group address range for a VPN must not contain the share-group of any VPN.
On a given PE device, the switch-group address range for a VPN instance must not overlap with that for any other VPN instance. A new configuration with this command in the same VPN instance supersedes the existing configuration.
If you use the multicast-domain switch-group-pool command on a switch, share-MDT to switch-MDT switching will take place after the switch receives multicast traffic for this VPN instance and has maintained it for the switch-delay period.
Related commands: multicast-domain switch-delay.
Examples
# Configure the address range of the switch-group-pool in VPN instance mvpn as 225.2.2.0 to 225.2.2.15.
<Sysname> system-view
[Sysname] ip vpn-instance mvpn
[Sysname-vpn-instance-mvpn] multicast-domain switch-group-pool 225.2.2.0 28
peer enable (BGP-MDT sub-address family view)
Syntax
peer { group-name | ip-address } enable
undo peer { group-name | ip-address } enable
View
BGP-MDT sub-address family view
Default level
2: System level
Parameters
group-name: Name of a BGP MDT peer group, a case-sensitive string of 1 to 47 characters. A peer group name must not contain any space.
ip-address: IP address of a BGP MDT peer.
Description
Use the peer enable command to enable the specified peer or peer group.
Use the undo peer enable command to disable the specified peer or peer group.
By default, no BGP MDT peer or peer group is enabled.
The BGP peer or peer group must be configured before this command can take effect.
Related commands: group, peer as-number, and peer group (Layer 3—IP Routing Command Reference).
Examples
# Configure and enable the BGP MDT peer 18.10.0.9.
[Sysname] bgp 100
[Sysname-bgp] peer 18.10.0.9 as-number 100
[Sysname-bgp] ipv4-family mdt
[Sysname-bgp-af-mdt] peer 18.10.0.9 enable
peer group (BGP-MDT sub-address family view)
Syntax
peer ip-address group group-name
undo peer ip-address group group-name
View
BGP-MDT sub-address family view
Default level
2: System level
Parameters
ip-address: IP address of a BGP MDT peer.
group-name: Name of a BGP MDT peer group, a case-sensitive string of 1 to 47 characters. A peer group name must not contain any space.
Description
Use the peer group command to add a peer to the BGP MDT peer group.
Use the undo peer group command to delete a specified peer from the peer group.
By default, a peer belongs to no peer groups.
The BGP MDT peer and peer group must be configured and enabled before this command can take effect.
Related commands: peer enable.
Examples
# Configure and enable the BGP MDT peer 10.1.1.1 and the peer group test, and then add the peer to the peer group.
[Sysname] bgp 100
[Sysname-bgp] group test
[Sysname-bgp] peer test as-number 2004
[Sysname-bgp] peer 10.1.1.1 group test
[Sysname-bgp] ipv4-family mdt
[Sysname-bgp-af-mdt] peer test enable
[Sysname-bgp-af-mdt] peer 10.1.1.1 enable
[Sysname-bgp-af-mdt] peer 10.1.1.1 group test
peer reflect-client (BGP-MDT sub-address family view)
Syntax
peer { group-name | ip-address } reflect-client
undo peer { group-name | ip-address } reflect-client
View
BGP-MDT sub-address family view
Default level
2: System level
Parameters
group-name: Name of a BGP MDT peer group, a case-sensitive string of 1 to 47 characters. A peer name must not contain any space.
ip-address: IP address of a BGP MDT peer.
Description
Use the peer reflect-client command to configure the router as a route reflector and specify a peer or peer group as its client.
Use the undo peer reflect-client command to remove the configuration.
By default, neither route reflectors nor clients are configured.
Before you configure this command, BGP MDT peers or peer groups should be configured.
Your configuration will overwrite the old configuration (if any).
Related commands: peer enable, reflect between-clients, and reflect cluster-id.
Examples
# Configure and activate BGP MDT peer group test, and then configure the local device as a route reflector and specify the BGP MDT peer group test as a client.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] group test
[Sysname-bgp] ipv4-family mdt
[Sysname-bgp-af-mdt] peer test enable
[Sysname-bgp-af-mdt] peer test reflect-client
reflect between-clients (BGP-MDT sub-address family view)
Syntax
reflect between-clients
undo reflect between-clients
View
BGP-MDT sub-address family view
Default level
2: System level
Parameters
None
Description
Use the reflect between-clients command to enable route reflection between clients.
Use the undo reflect between-clients command to disable this function.
By default, route reflection between clients is enabled.
Related commands: peer reflect-client and reflector cluster-id.
Examples
# Disable route reflection between clients.
[Sysname] bgp 100
[Sysname-bgp] ipv4-family mdt
[Sysname-bgp-af-mdt] undo reflect between-clients
reflector cluster-id (BGP-MDT sub-address family view)
Syntax
reflector cluster-id { cluster-id | ip-address }
undo reflector cluster-id
View
BGP-MDT sub-address family view
Default level
2: System level
Parameters
cluster-id: Cluster ID of the route reflector, in the range 1 to 4294967295.
ip-address: Cluster ID of the route reflector, which is the IP address of the specified BGP MDT peer.
Description
Use the reflector cluster-id command to configure the cluster ID of the route reflector.
Use the undo reflector cluster-id command to remove the configured cluster ID.
By default, a route reflector uses its router ID as the cluster ID.
In general, a cluster has only one route reflector whose router ID identifies the cluster. However, you can configure several route reflectors in a cluster to improve network reliability, and they must have the same cluster ID configured to avoid routing loops.
Related commands: reflect between-clients and peer reflect-client.
Examples
# Specify 80 as the cluster ID for the route reflector.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp] ipv4-family mdt
[Sysname-bgp-af-mdt] reflector cluster-id 80
reset bgp mdt
Syntax
reset bgp mdt { as-number | ip-address | all | external | group group-name | internal }
View
User view
Default level
2: System level
Parameters
as-number: Resets BGP MDT connections to peers in the specified AS, in the range of 1 to 4294967295.
ip-address: Resets the connection with the specified BGP MDT peer.
all: Resets all the BGP MDT connections.
external: Resets all the EBGP MDT connections.
group group-name: Resets connections with the specified BGP peer group. A peer group name is a case-sensitive string of 1 to 47 characters and must not contain any space.
internal: Resets all the IBGP MDT connections.
Description
Use the reset bgp mdt command to reset BGP MDT connections.
Examples
# Reset all the BGP MDT connections.
<Sysname> reset bgp mdt all