10.3. GTM Configuration Command Reference

10.3.1. Command Hierarchies

10.3.1.1. Configuration Commands

config
— router
gtm
[no] mvpn
[no] rsvp
lsp-template lsp-template
— no lsp-template
[no] shutdown
data-threshold {c-grp-ip-addr/mask | c-grp-ip-addr netmask} s-pmsi-threshold [pe-threshold-add pe-threshold-add] [pe-threshold-delete pe-threshold-delete]
data-threshold c-grp-ipv6-addr/prefix-length s-pmsi-threshold [pe-threshold-add pe-threshold-add] [pe-threshold-delete pe-threshold-delete]
— no data-threshold {c-grp-ip-addr/mask | c-grp-ip-addr netmask}
— no data-threshold {c-grp-ip-addr/prefix-length}
[no] rsvp
lsp-template lsp-template
— no lsp-template
[no] shutdown
pim
gtm
auto-discovery [default]

10.3.2. Command Descriptions

10.3.2.1. GTM Commands

gtm

Syntax 
gtm
Context 
config>router
Description 

This command enters the context to configure GTM parameters.

mvpn

Syntax 
[no] mvpn
Context 
config>router>gtm
Description 

This command enables and disables the context to configure MVPN-related parameters.

provider-tunnel

Syntax 
provider-tunnel
Context 
config>router>gtm
Description 

This command enables context to configure tunnel parameters for the GTM.

inclusive

Syntax 
inclusive
Context 
config>router>gtm>provider-tunnel
Description 

This command enables the context for specifying inclusive provider tunnels parameters.

rsvp

Syntax 
[no] rsvp
Context 
config>router>gtm>provider-tunnel>inclusive
config>router>gtm>provider-tunnel>selective
Description 

This command enables the use of P2MP RSVP as the inclusive or selective provider tunnel.

The no form of the command removes the RSVP context including all the statements in the context.

Default 

no rsvp

lsp-template

Syntax 
lsp-template lsp-template
no lsp-template
Context 
Context config>router>gtm>provider-tunnel>inclusive>rsvp
Context config>router>gtm>provider-tunnel>selective>rsvp
Description 

This command specifies the use of automatically created P2MP LSP as the provider tunnel. The P2MP LSP will be signaled using the parameters specified in the template, such as bandwidth constraints.

Default 

no lsp-template

Parameters 
lsp-template —
Specifies the name of the LSP template, up to 32 characters.

shutdown

Syntax 
shutdown
no shutdown
Context 
config>router>gtm>provider-tunnel>inclusive>rsvp
config>router>gtm>provider-tunnel>selective>rsvp
Description 

This command administratively disables an entity. When disabled, an entity does not change, reset, or remove any configuration settings or statistics.

The operational state of the entity is disabled as well as the operational state of any entities contained within. Many objects must be shut down before they may be deleted.

Services are created in the administratively down (shutdown) state. When a no shutdown command is entered, the service becomes administratively up and then tries to enter the operationally up state.

The no form of this command places the entity into an administratively enabled state.

Default 

no shutdown

selective

Syntax 
selective
Context 
config>router>gtm>provider-tunnel
Description 

This command enables the context for specifying selective provider tunnel parameters.

data-delay-interval

Syntax 
data-delay-interval value
no data-delay-interval
Context 
config>router>>gtm>provider-tunnel>selective
Description 

This command specifies the interval, in seconds, before a PBR connected to the source switches traffic from the inclusive provider tunnel to the selective provider tunnel.

This command is not applicable to multi-stream S-PMSIs.

The no form of this command reverts the value to the default.

Default 

data-delay-interval 3

Parameters 
value —
Specifies the data delay interval, in seconds.
Values—
3 to 180

 

Default—
3

data-threshold

Syntax 
data-threshold {c-grp-ip-addr/mask | c-grp-ip-addr netmask} s-pmsi-threshold [pe-threshold-add pe-threshold-add] [pe-threshold-delete pe-threshold-delete]
data-threshold c-grp-ipv6-addr/prefix-length s-pmsi-threshold [pe-threshold-add pe-threshold-add] [pe-threshold-delete pe-threshold-delete]
no data-threshold {c-grp-ip-addr/mask | c-grp-ip-addr netmask}
no data-threshold c-grp-ipv6-addr/prefix-length
Context 
config>router>gtm>provider-tunnel>selective
Description 

This command specifies the data rate threshold that triggers the switch from the inclusive provider tunnel to the selective provider tunnel for (C-S, C-G) within the group range. Optionally, PBR thresholds for creating or deleting NG-MVPN S-PMSI may also be specified. Omitting the PBR thresholds preserves currently set values (or defaults if never set). Multiple statements (one per a unique group) are allowed in the configuration.

This command is not applicable to multi-stream S-PMSIs.

The no form of the command removes the values from the configuration.

Default 

no data-threshold

Parameters 
c-grp-ip-addr/mask | c-grp-ip-addr netmask—
Specifies an IPv4 multicast group address and netmask length or network mask.
c-grp-ipv6-addr/prefix-length—
Specifies an IPv6 multicast group address and prefix length.
s-pmsi-threshold —
Specifies the rate, in kb/s. If the rate for a (C-S, C-G)) within the specified group range exceeds the threshold, traffic for the (C-S, C-G) will be switched to the selective provider tunnel.
s-pmsi-threshold-add —
Specifies the number of receiver PBRs for creating S-PMSI. When the number of receiver PBRs for a given multicast group configuration is non-zero and below the threshold and BW threshold is satisfied, S-PMSI is created.
s-pmsi-threshold-delete—
Specifies the number of receiver PBRs for deleting S-PMSI. When the number of receiver PBRs for a given multicast group configuration is above the threshold, S-PMSI is deleted and the multicast group is moved to I-PMSI or a wildcard S-PMSI. It is recommended that the delete threshold be significantly larger than the add threshold to avoid re-signaling of S-PMSI as the receiver PBR count fluctuates.
Values—

c-grp-ip-addr

multicast group address a.b.c.d

mask

4 to 32

netmask

a.b.c.d (network bits all 1 and host bits all 0)

s-pmsi-threshold

1 to 4294967294 (threshold in kb/s)

c-grp-ipv6-addr

multicast ipv6-address x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x [0 to FFFF]H

d [0 to 255]D

prefix-length [1 to 128]

pe-threshold-add

1 to 65535 Default: 65535 (delete threshold always met)

pe-threshold-delete

2 to 65535 Default: 65535:(delete threshold always met)

 

maximum-p2mp-spmsi

Syntax 
maximum-p2mp-spmsi range
no maximum-p2mp-spmsi
Context 
config>router>gtm>provider-tunnel>selective
Description 

This command specifies the maximum number of RSVP P2MP or LDP P2MP S-PMSI tunnels for the GTM. When the limit is reached, no more RSVP P2MP S-PMSI or LDP P2MP S-P MSI tunnels are created and traffic over the data-threshold will stay on I-PMSI.

Default 

maximum-p2mp-spmsi 10

Parameters 
range—
Specifies the maximum number of RSVP P2MP or LDP P2MP S-PMSI tunnels for the GTM.
Values—
1 to 4000

 

Default—
10

pim

Syntax 
[no] pim
Context 
config>router
Description 

This command configures a Protocol Independent Multicast (PIM) instance.

PIM is used for multicast routing within the network. Devices in the network can receive the multicast feed requested and non-participating routers can be pruned. The router OS supports PIM sparse mode (PIM-SM).

Default 

no pim

gtm

Syntax 
gtm
Context 
config>router>pim
Description 

This command enables the context to configure GTM parameters.

auto-discovery

Syntax 
auto-discovery [default]
no auto-discovery
Context 
config>router>pim>gtm
Description 

This command enables or disables multicast auto-discovery via BGP for GTM.

The no form of the command disables auto-discovery.

Default 

no auto-discovery

Parameters 
default—
Enables the default auto-discovery mode.

10.4. Show, Clear, and Debug Command Reference

10.4.1. Command Hierarchies

10.4.1.1. Show Commands

show
— router
gtm

10.4.2. Command Descriptions

10.4.2.1. Show Commands

gtm

Syntax 
gtm
Context 
show>router
Description 

This command multicast GTM related information.

Output 

GTM Output

Sample Output
*A:Dut-A# show router gtm 
 
===============================================================================
GTM (MVPN Base) configuration data
===============================================================================
signaling          : Bgp                  auto-discovery     : Default
UMH Selection      : Highest-Ip           SA withdrawn       : Disabled
intersite-shared   : Enabled              Persist SA         : Disabled
vrf-import         : N/A
vrf-export         : N/A
vrf-target         : unicast
C-Mcast Import RT  : target:10.20.1.2:0
           
ipmsi              : rsvp IpmsiTmpl
i-pmsi P2MP AdmSt  : Up
i-pmsi Tunnel Name : IpmsiTmpl-gtm-73780
enable-bfd-root    : false                enable-bfd-leaf    : false
Mdt-type           : sender-receiver
           
BSR signalling     : none
Wildcard s-pmsi    : Disabled
Multistream-SPMSI  : Disabled
s-pmsi             : none
data-delay-interval: 3 seconds
enable-asm-mdt     : N/A
===============================================================================