12.6. SR P2MP Configuration Command Reference

12.6.1. Command Hierarchies

12.6.1.1. P2MP SR Tree Configuration Commands

config
— router
[no] p2mp-sr-tree
bfd-enable [ipv4] [ipv6]
— no bfd-enable
[no] p2mp-policy policy-name
[no] p2mp-candidate-path candidate-path-name
active-instance instance-id
instance instance-id instance-value instance-value
— no instance instance-id
preference preference
— no preference
[no] shutdown
root-address ip-address
— no root-address
root-tree-id tree-sid
[no] shutdown
[no] replication-segment policy-name
incoming-sid static-label
instance-id instance-id
[no] next-hop-id next-hop-index
next-hop-address ip-address
next-hop-interface-name interface-name
protecting-nexthop-id next-hop-index
replication-sid label
[no] shutdown
root-address ip-address
root-tree-id tree-id
[no] shutdown
sid-action action
— no sid-action
reserved-lbl-block reserved-lbl-block
[no] shutdown

12.6.1.2. MVPN Configuration Commands

config
— service
— vprn
— mvpn
— provider-tunnel
— inclusive
[no] p2mp-sr
[no] p2mp-policy
[no] shutdown
static-policy policy-name
— selective
— multistream-spmsi
[no] p2mp-policy
[no] shutdown
static-policy policy-name
[no] p2mp-sr
[no] p2mp-policy
[no] shutdown
static-policy policy-name

12.6.2. Command Descriptions

12.6.2.1. P2MP SR Tree Commands

p2mp-sr-tree

Syntax 
[no] p2mp-sr-tree
Context 
config>router
Description 

The command enters the configuration context for a P2MP SR tree.

Default 

no p2mp-sr-tree

bfd-enable

Syntax 
bfd-enable [ipv4] [ipv6]
no bfd-enable
Context 
config>router>p2mp-sr-tree
 
Description 

This command enables BFD tracking at the P2MP SR tree level, which means that all next-hops of the replication segments that use a BFD-enabled L3 interface register with the BFD module.

The no form of this command disables BFD tracking of the P2MP SR tree.

Default 

no bfd-enable

p2mp-policy

Syntax 
[no] p2mp-policy policy-name
Context 
config>router>p2mp-sr-tree
Description 

This command creates a P2MP policy entry.

The no form of this command deletes the specified policy entry.

Parameters 
policy-name—
Specifies the policy name, up to 32 characters.

p2mp-candidate-path

Syntax 
[no] p2mp-candidate-path candidate-path-name
Context 
config>router>p2mp-sr-tree>p2mp-policy
Description 

This command configures a candidate path under the P2MP policy.

A P2MP policy can contain multiple candidate paths, which are redundant trees. Each candidate path represents a P2MP tree with its own traffic engineering constraints. Each candidate path has its own preference and the candidate path with the highest preference is the active P2MP tunnel.

The no form of this command removes the specified candidate path.

Parameters 
candidate-path-name—
Specifies the name of the candidate path, up to 32 characters.

active-instance

Syntax 
active-instance instance-id
no active-instance
Context 
config>router>p2mp-sr-tree>p2mp-policy>p2mp-candidate-path
Description 

This command configures the active instance as a primary or a secondary instance. Before configuring the active instance ID, the candidate path instance must be configured using the instance command.

The no form of this command removes the active instance.

Parameters 
instance-id—
Specifies the active instance as primary (1) or secondary (2).
Values—
1, 2

 

instances

Syntax 
instances
Context 
config>router>p2mp-sr-tree>p2mp-policy>p2mp-candidate-path
Description 

This command enters the context to configure the instance entries of the candidate path.

Multiple path instances can exist under a candidate path. Each path instance is a P2MP LSP and has an instance ID. Path instances can be used for global optimization of the active candidate path.

instance

Syntax 
instance instance-id instance-value instance-value
no instance instance-id
Context 
config>router>p2mp-sr-tree>p2mp-policy>p2mp-candidate-path>instances
Description 

This command configures the candidate path instance as primary or secondary, and the instance identifier.

The no form of this command removes the candidate path instance.

Parameters 
instance-id—
Specifies the instance as primary (1) or secondary (2).
Values—
1, 2

 

instance-value—
Specifies the instance identifier.
Values—
1 to 4294967295

 

preference

Syntax 
preference preference
no preference
Context 
config>router>p2mp-sr-tree>p2mp-policy>p2mp-candidate-path
Description 

This command sets the candidate path preference. The candidate path with the highest preference is the active candidate path.

The no form of this command removes the candidate path preference.

Default 

no preference

Parameters 
preference—
Specifies the preference of the candidate path.
Values—
0 to 1024

 

shutdown

Syntax 
[no] shutdown
Context 
config>router>p2mp-sr-tree
config>router>p2mp-sr-tree>p2mp-policy
config>router>p2mp-sr-tree>p2mp-policy>p2mp-candidate-path
config>router>p2mp-sr-tree>replication-segment
config>router>p2mp-sr-tree>replication-segment>next-hop-id
Description 

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

When the operational state of an entity is disabled, the operational state of any entities contained within are also disabled. 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 attempts to enter the operationally up state.

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

Default 

shutdown

root-address

Syntax 
root-address ip-address
no root-address
Context 
config>router>p2mp-sr-tree>p2mp-policy
Description 

This command configures the IP address of the P2MP tree root node of the P2MP policy. The root tree ID and the root address uniquely identify the P2MP policy on the root node.

The no form of this command removes the root address entry.

Parameters 
ip-address—
Specifies the IPv4 address of the root node.
Values—
a.b.c.d

 

root-tree-id

Syntax 
root-tree-id tree-id
no root-tree-id
Context 
config>router>p2mp-sr-tree>p2mp-policy
Description 

This command configures the tree ID on the root node. The root tree ID and the root address uniquely identify the P2MP policy on the root node.

The no form of this command removes the root tree ID entry.

Parameters 
tree-id—
Specifies the ID of the tree.
Values—
8193 to 16286

 

replication-segment

Syntax 
[no] replication-segment policy-name
Context 
config>router>p2mp-sr-tree
Description 

This command creates a replication segment entry for the P2MP LSP.

The no form of this command deletes the replication segment entry.

Parameters 
policy-name—
Specifies the name of the P2MP policy associated with the forwarding instructions contained in the replication segment, up to 32 characters.

incoming-sid

Syntax 
incoming-sid static label
no incoming-sid
Context 
config>router>p2mp-sr-tree>replication-segment
Description 

This command configures the incoming replication SID for this replication segment entry.

The no form of this command removes the incoming replication SID.

Parameters 
static label—
Specifies the incoming replication SID label.
Values—
0 to 4294967295

 

instance-id

Syntax 
instance-id instance-id
no instance-id
Context 
config>router>p2mp-sr-tree>replication-segment
Description 

This command configures the instance ID for the replication segment entry.

The ID is a unique identifier for the P2MP LSP on the root. The combination of root ID, tree ID, and instance ID uniquely identifies a P2MP LSP throughout the network.

The no form of this command removes the instance.

Parameters 
instance-id—
Specifies the ID of the instance.
Values—
1 to 4294967295

 

next-hop-id

Syntax 
[no] next-hop-id next-hop-id-index
Context 
config>router>p2mp-sr-tree>replication-segment
Description 

This command configures the next-hop ID for the replication segment.

A replication policy can have multiple next-hop IDs used at a replication node where there are multiple outgoing interfaces or protection next-hops.

The no form of this command removes the next-hop ID.

Parameters 
next-hop-id-index—
Specifies the index value of the next-hop.
Values—
1 to 4096

 

next-hop-address

Syntax 
next-hop-address ip-address
no next-hop-address
Context 
config>router>p2mp-sr-tree>replication-segment>next-hop-id
Description 

This command configures the IP address of the next-hop for the replication segment.

The no form of this command removes the next-hop address.

Parameters 
ip-address—
Specifies the IPv4 or IPv6 address.
Values—

ipv4-address

a.b.c.d (host bits must be 0)

ipv6-address

x:x:x:x:x:x:x:x[-interface]

x:x:x:x:x:x:d.d.d.d[-interface]

where:

x: [0 to FFFF]H

d: [0 to 255]D

interface: up to 32 characters, mandatory for link local addresses

 

next-hop-interface-name

Syntax 
next-hop-interface-name interface-name
no next-hop-interface-name
Context 
config>router>p2mp-sr-tree>replication-segment>next-hop-id
Description 

This command provides the outgoing interface name.

The no form of this command removes the outgoing interface name.

Parameters 
interface-name—
Specifies the name of the outgoing interface name, up to 32 characters.

protecting-nexthop-id

Syntax 
protecting-nexthop-id next-hop-index
no protecting-nexthop-id
Context 
config>router>p2mp-sr-tree>replication-segment>next-hop-id
Description 

This command provides the ID of the protection next-hop used for FRR.

The protection next-hop outgoing SID is pushed on top of the next-hop SID list.

The no form of this command removes the protection next-hop.

Parameters 
next-hop-index—
Specifies the ID of the protection next-hop.
Values—
1 to 4096

 

replication-sid

Syntax 
replication-sid label
no replication-sid
Context 
config>router>p2mp-sr-tree>replication-segment>next-hop-id
Description 

This command configures the replication SID for this next-hop.

The no form of this command removes the replication SID.

Parameters 
label—
Specifies the label of the replication SID.
Values—
3, 16 to 1048576, 4294967295

 

root-address

Syntax 
root-address ip-address
no root address
Context 
config>router>p2mp-sr-tree>replication-segment
Description 

This command configures the replication segment with the IP address of the root node.

The no form of this command removes the root node address.

Parameters 
ip-address—
Specifies the IPv4 address.
Values—
a.b.c.d

 

root-tree-id

Syntax 
root-tree-id tree-id
no root-tree-id
Context 
config>router>p2mp-sr-tree>replication-segment
Description 

This command configures the root-tree ID for this replication segment.

The no form of this command removes the root-tree ID.

Parameters 
tree-id—
Specifies the root-tree ID.
Values—
8193 to 16286

 

sid-action

Syntax 
sid-action action
no sid-action
Context 
config>router>p2mp-sr-tree>replication-segment
Description 

This command configures the action to take for this replication segment.

The no form of this command removes the SID action.

Default 

no sid-action

Parameters 
action—
Specifies the name of the SID action.
Values—
push — Specifies to push an outgoing SID list and forward on to the corresponding programmed outgoing interfaces.
pop — Specifies that on the leaf node the incoming SID is popped on the underlay packet forwarded to the host.
swap — Specifies, in case an incoming SID is configured, that the SID is swapped with an outgoing SID or SID list and forwarded to the corresponding OIF.

 

reserved-lbl-block

Syntax 
reserved-lbl-block reserved-lbl-block
no reserved-lbl-block
Context 
config>router>p2mp-sr-tree
Description 

This command configures the reserved label block name for this P2MP SR tree. Before configuring for the P2MP SR tree, the reserved label block name must be configured on the root node of the P2MP policy in the config>router>mpls-labels context.

The no form of this command removes the reserved label block name for this P2MP SR tree.

Default 

no reserved-lbl-block

Parameters 
reserved-lbl-block—
Specifies the value of the reserved label block name, up to 64 characters.

12.6.2.2. MVPN Commands

p2mp-sr

Syntax 
[no] p2mp-sr
Context 
config>service>vprn>mvpn>pt>inclusive
config>service>vprn>mvpn>pt>selective
Description 

This command enables P2MP SR for the MVPN provider tunnel.

The no form of this command disables P2MP SR.

Default 

no p2mp-sr

p2mp-policy

Syntax 
[no] p2mp-policy
Context 
config>service>vprn>mvpn>pt>inclusive>p2mp-sr
config>service>vprn>mvpn>pt>selective>multistream-spmsi
config>service>vprn>mvpn>pt>selective>p2mp-sr
Description 

This command enables a P2MP policy for the MVPN provider tunnel.

The no form of this command disables the P2MP policy.

shutdown

Syntax 
[no] shutdown
Context 
config>service>vprn>mvpn>pt>inclusive>p2mp-sr
config>service>vprn>mvpn>pt>selective>multistream-spmsi
config>service>vprn>mvpn>pt>selective>p2mp-sr
Description 

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

When the operational state of an entity is disabled, the operational state of any entities contained within are also disabled. 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 attempts to enter the operationally up state.

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

Default 

shutdown

static-policy

Syntax 
[no] static-policy policy-name
Context 
config>service>vprn>mvpn>pt>inclusive>p2mp-sr
config>service>vprn>mvpn>pt>selective>multistream-spmsi
config>service>vprn>mvpn>pt>selective>p2mp-sr
Description 

This command assigns the specified static policy to the MVPN tunnel.

The no form of this command removes the static policy from the MVPN tunnel.

Default 

no static-policy

Parameters 
policy-name—
Specifies the policy name, up to 32 characters.