Table Of Contents

Multicast Routing and Forwarding Commands on Cisco IOS XR Software

accounting per-prefix

boundary

clear mfib counter

clear mfib database

clear mfib hardware resource-counters

clear mfib hardware route statistics

disable (multicast)

enable

interface (multicast)

interface all enable

interface-inheritance disable

log-traps

maximum disable

mdt data

mdt default

mdt mtu

mdt source

mhost default-interface

multicast-routing

multipath

nsf (multicast)

oom-handling

rate-per-route

show mfib connections

show mfib counter

show mfib encap-info

show mfib hardware interface

show mfib hardware resource-counters

show mfib hardware route accept-bitmap

show mfib hardware route olist

show mfib hardware route qos

show mfib hardware route statistics

show mfib hardware route summary

show mfib interface

show mfib mdt statistics

show mfib nsf

show mfib route

show mfib table-info

show mhost default-interface

show mhost groups

show mrib client

show mrib nsf

show mrib platform trace

show mrib route

show mrib route-collapse

show mrib table-info

show mrib tlc

static-rpf

ttl-threshold (multicast)

vrf (multicast)

Multicast Routing and Forwarding Commands on Cisco IOS XR Software

---

This chapter describes the commands used to configure and monitor multicast routing on Cisco IOS XR software.

For detailed information about multicast routing concepts, configuration tasks, and examples, refer to the Implementing Multicast Routing on Cisco IOS XR Software configuration module in Cisco IOS XR Multicast Configuration Guide.

accounting per-prefix

To enable accounting for multicast routing, use the accounting per-prefix command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

accounting per-prefix

no accounting per-prefix

Syntax Description

This command has no arguments or keywords.

Defaults

This feature is disabled.

Command Modes

Multicast routing configuration
Multicast VRF configuration

Command History

Release	Modification
Release 3.0	This command was introduced on the Cisco CRS-1.
Release 3.2	This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	This command was supported in multicast VRF configuration mode.
Release 3.6.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The accounting per-prefix command is used to enable per-prefix counters only in hardware. Cisco IOS XR software counters are always present. When enabled, every existing and new (S, G) route is assigned forward, punt, and drop counters on the ingress route and forward and punt counters on the egress route. The (*, G) routes are assigned a single counter.

There are a limited number of counters on all nodes. When a command is enabled, counters are assigned to routes only if they are available.

To display packet statistics, use the show route and the show mfib hardware route statistics commands. These commands display "N/A" for counters when no hardware statistics are available or when the accounting per-prefix command is disabled.

Task ID

Task ID	Operations
multicast	read, write

Examples

The following example shows how to enable accounting for multicast routing:

RP/0/RP0/CPU0:router(config)# multicast-routing

RP/0/RP0/CPU0:router(config-mcast)# accounting per-prefix

Related Commands

Command	Description
show mfib hardware route statistics	Displays platform-specific MFIB information for the packet and byte counters for each route.
show mfib route	Displays route entries in the MFIB table.

boundary

To configure the multicast boundary on an interface for administratively scoped multicast addresses, use the boundary command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

boundary access-list

no boundary access-list

Syntax Description

access-list

Access list specifying scoped multicast groups. The name cannot contain a space or quotation mark; it may contain numbers.

Defaults

A multicast boundary is not configured.

Command Modes

Multicast routing interface configuration
Multicast VRF interface configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	This command was supported in multicast VRF interface configuration mode.
Release 3.6.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The boundary command is used to set up a boundary to keep multicast packets from being forwarded.

Task ID

Task ID	Operations
multicast	read, write

Examples

The following example shows how to set up a boundary for all administratively scoped addresses:

RP/0/RP0/CPU0:router# access-list 1 deny 239.0.0.0 0.255.255.255

RP/0/RP0/CPU0:router# access-list 1 permit 224.0.0.0 15.255.255.255

RP/0/RP0/CPU0:router(config)# multicast-routing

RP/0/RP0/CPU0:router(config-mcast)# interface pos 0/2/0/2

RP/0/RP0/CPU0:router(config-mcast-default-ipv4-if)# boundary 1

clear mfib counter

To clear Multicast Forwarding Information Base (MFIB) route packet counters, use the clear mfib counter command in EXEC mode.

clear mfib [vrf vrf-name] [ipv4 | ipv6] counter [group-address | source-address | signal] [location {node-id | all}]

Syntax Description

vrf vrf-name	(Optional) Specifies a VPN routing and forwarding (VRF) instance.
ipv4	(Optional) Specifies IPv4 address prefixes.
ipv6	(Optional) Specifies IPv6 address prefixes.
group-address	(Optional) IP address of the multicast group.
source-address	(Optional) IP address of the source of the multicast route.
signal	(Optional) Clears signal table statistics.
location {node-id | all}	(Optional) Clears route packet counters from the designated node. The node-id argument is entered in the rack/slot/module notation. The all keyword clears route packet counters on all nodes.

Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was supported on the Cisco XR 12000 Series Router. The ipv4 and ipv6 keywords were added.
Release 3.3.0	No modification.
Release 3.4.0	No modification. The signal keyword was added.
Release 3.5.0	The vrf vrf-name keyword and argument were added.
Release 3.6.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
multicast	read, write

Examples

The following example shows how to clear MFIB route packet counters on all nodes:

RP/0/RP0/CPU0:router# clear mfib counter location all 

clear mfib database

To clear the Multicast Forwarding Information Base (MFIB) database, use the clear mfib database command in EXEC mode.

clear mfib [ipv4 | ipv6] database {[location {node-id | all}]}

Syntax Description

ipv4	(Optional) Specifies IPv4 address prefixes.
ipv6	(Optional) Specifies IPv6 address prefixes.
location {node-id | all}	(Optional) Clears route packet counters from the designated node. The node-id argument is entered in the rack/slot/module notation. The all keyword clears the MFIB database on all nodes.

Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was supported on the Cisco XR 12000 Series Router. The ipv4 and ipv6 keywords were added.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	The location keyword was changed from optional to required.
Release 3.6.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
multicast	read, write, execute

Examples

The following example shows how to clear the Multicast Forwarding Information Base (MFIB) database on all nodes:

RP/0/RP0/CPU0:router# clear mfib database location all 

clear mfib hardware resource-counters

To clear global resource counters, use the clear mfib hardware resource-counters command in EXEC mode.

clear mfib [vrf vrf-name] [ipv4 | ipv6] hardware resource-counters {location {node-id | all}}

Syntax Description

vrf vrf-name	(Optional) Specifies a VPN routing and forwarding (VRF) instance.
ipv4	(Optional) Specifies IPv4 address prefixes.
ipv6	(Optional) Specifies IPv6 address prefixes.
location {node-id | all}	(Optional) Clears global resource counters from the designated node. The node-id argument is entered in the rack/slot/module notation. The all keyword clears all global resource counters.

Defaults

IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	The ipv4 and ipv6 keywords were added.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	The vrf vrf-name keyword and argument were added. The location keyword was changed from optional to required.
Release 3.6.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Use the clear mfib hardware resource-counters to estimate resource usage for an operation.

Task ID

Task ID	Operations
multicast	read, write, execute

Examples

The following example shows how to clear all global resource counters:

RP/0/RP0/CPU0:router# clear mfib hardware resource-counters location all

Related Commands

Command	Description
show mfib hardware route statistics	Displays platform-specific MFIB information for the packets and bytes counters for each route.

clear mfib hardware route statistics

To clear Multicast Forwarding Information Base (MFIB) hardware statistics, use the clear mfib hardware route statistics command in EXEC mode.

clear mfib [vrf vrf-name] [ipv4 | ipv6] hardware route statistics {egress | ingress | ingress-and-egress} [* | source-address] [group-address [/prefix-length]] {location {node-id | all}}

Syntax Description

vrf vrf-name	(Optional) Specifies a VPN routing and forwarding (VRF) instance.
ipv4	(Optional) Specifies IPv4 address prefixes.
ipv6	(Optional) Specifies IPv6 address prefixes.
egress	(Optional) Clears hardware statistics only on the specified outgoing route.
ingress	(Optional) Clears hardware statistics only on the specified incoming route.
ingress-and-egress	(Optional) Clears hardware statistics on both the outgoing and incoming routes.
*	(Optional) Clears shared tree route statistics.
source-address	(Optional) IP address or hostname of the multicast route source.
group-address	(Optional) IP address or hostname of the multicast group.
/prefix-length	(Optional) Prefix length of the multicast group. A decimal value that indicates how many of the high-order contiguous bits of the address compose the prefix (the network portion of the address). A slash must precede the decimal value.
location {node-id | all}	Clears hardware statistics from the designated node. The node-id argument is entered in the rack/slot/module notation. The all keyword clears hardware statistics from all locations.

Defaults

If not specified, IPv4 addressing is the default.

Command Modes

EXEC

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	The ipv4 and ipv6 keywords were added.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	The vrf vrf-name keyword and argument were added. The location keyword was changed from optional to required.
Release 3.6.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The Multicast Forwarding (MFWD) process exists on each line card and assigns hardware counters to each (S, G) route. Additionally, one global counter is assigned for all (*, G) routes, depending on resource availability.

To clear the set of counters for (*, G) routes, the MFWD process assigns a single set of counters to count packets that match (*, G) routes. Consequently, the clear mfib hardware route statistics command must be used in a form that either clears counters on all routes or matches all (*, G) routes.

Task ID

Task ID	Operations
multicast	read, write, execute

Examples

The following command shows how to clear counters by route statistics for all multicast routes on both ingress and egress forwarding engines for the line card 0/1/CPU0:

RP/0/RP0/CPU0:router# clear mfib ipv4 hardware route statistics ingress-and-egress 
location 0/1/CPU0

The following example shows how to clear the counters only on the ingress forwarding engine for (S, G) routes with the group address 224.1.1.1:

RP/0/RP0/CPU0:router# clear mfib hardware route statistics ingress 224.1.1.1 location 
0/1/CPU0

---

Note This command does not clear global (*, G) counters.

---

Related Commands

Command	Description
show mfib hardware route statistics	Displays platform-specific MFIB information for the packet and byte counters for each route.

disable (multicast)

To disable multicast routing and forwarding on an interface, use the disable command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

disable

no disable

Syntax Description

This command has no arguments or keywords.

Defaults

Multicast routing and forwarding settings are inherited from the global interface enable all command. Otherwise, multicast routing and forwarding is disabled.

Command Modes

Multicast routing interface configuration
Multicast VRF interface configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	This command was supported in multicast VRF interface configuration mode.
Release 3.6.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The disable command modifies the behavior of a specific interface to disabled. This command is useful if you want to disable multicast routing on specific interfaces, but leave it enabled on all remaining interfaces.

The following guidelines apply when the enable and disable commands (and the no forms) are used in conjunction with the interface all enable command:

•If the interface all enable command is configured:

–The enable and no forms of the command have no additional effect on a specific interface.

–The disable command disables multicast routing on a specific interface.

–The no disable command returns a previously disabled interface to enabled.

•If the interface all enable command is not configured:

–The enable command enables multicast routing on a specific interface.

–The no enable command returns a previously enabled interface to disabled.

–The disable and no forms of the command have no additional effect on a specific interface.

Task ID

Task ID	Operations
multicast	read, write

Examples

The following example shows how to enable multicast routing on all interfaces and disable the feature only on Packet-over-SONET/SDH (POS) interface 0/1/0/0:

RP/0/RP0/CPU0:router(config)# multicast-routing

RP/0/RP0/CPU0:router(config-mcast)# interface all enable

RP/0/RP0/CPU0:router(config-mcast-default-ipv4)# interface pos 0/1/0/0

RP/0/RP0/CPU0:router(config-mcast-default-ipv4-if)# disable

Related Commands

Command	Description
enable	Enables multicast routing and forwarding on an interface.
interface all enable	Enables multicast routing and forwarding on all new and existing interfaces.

enable

To enable multicast routing and forwarding on an interface, use the enable command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

enable

no enable

Syntax Description

This command has no arguments or keywords.

Defaults

Multicast routing and forwarding settings are inherited from the global interface enable all command. Otherwise, multicast routing and forwarding is disabled.

Command Modes

Multicast routing interface configuration
Multicast VRF interface configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	This command was supported in multicast VRF interface configuration mode.
Release 3.6.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The enable command modifies the behavior of a specific interface to enabled. This command is useful if you want to enable multicast routing on specific interfaces, but leave it disabled on all remaining interfaces.

The following guidelines apply when the enable and disable commands (and the no forms) are used in conjunction with the interface all enable command:

•If the interface all enable command is configured:

–The enable and no forms of the command have no additional effect on a specific interface.

–The disable command disables multicast routing on a specific interface.

–The no disable command returns a previously disabled interface to enabled.

•If the interface all enable command is not configured:

–The enable command enables multicast routing on a specific interface.

–The no enable command returns a previously enabled interface to disabled.

–The disable and no forms of the command have no additional effect on a specific interface.

Task ID

Task ID	Operations
multicast	read, write

Examples

The following example shows how to enable multicast routing on a specific interface only:

RP/0/RP0/CPU0:router(config)# multicast-routing

RP/0/RP0/CPU0:router(config-mcast)# interface pos 0/1/0/0

RP/0/RP0/CPU0:router(config-mcast-default-ipv4-if)# enable

Related Commands

Command	Description
disable (multicast)	Disables multicast routing and forwarding on an interface.
interface all enable	Enables multicast routing and forwarding on all new and existing interfaces.

interface (multicast)

To configure multicast interface properties, use the interface command in the appropriate configuration mode. To disable multicast routing for interfaces, use the no form of this command.

interface type instance

no interface type instance

Syntax Description

type

Interface type. For more information, use the question mark (?) online help function.

instance

Either a physical interface instance or a virtual interface instance: •Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation. –rack: Chassis number of the rack. –slot: Physical slot number of the line card. –module: Module number. A physical layer interface module (PLIM) is always 0. –port: Physical port number of the interface. •Virtual interface instance. Number range varies depending on interface type. For more information about the syntax for the router, use the question mark (?) online help function.

Defaults

No default behavior or values

Command Modes

Multicast routing configuration
Multicast VRF configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	This command was supported in multicast VRF configuration mode.
Release 3.6.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Use the interface command to configure multicast routing properties for specific interfaces.

Task ID

Task ID	Operations
multicast	read, write

Examples

The following example shows how to enable multicast routing on all interfaces and disable the feature only on Packet-over-SONET/SDH (POS) interface 0/1/0/0:

RP/0/RP0/CPU0:router(config)# multicast-routing

RP/0/RP0/CPU0:router(config-mcast)# interface all enable

RP/0/RP0/CPU0:router(config-mcast)# interface pos 0/1/0/0

RP/0/RP0/CPU0:router(config-mcast-default-ipv4-if)# disable

interface all enable

To enable multicast routing and forwarding on all new and existing interfaces, use the interface all enable command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.

interface all enable

no interface all enable

Syntax Description

This command has no arguments or keywords.

Defaults

Multicast routing and forwarding is disabled by default.

Command Modes

Multicast routing configuration
Multicast VRF configuration

Command History

Release	Modification
Release 2.0	This command was introduced on the Cisco CRS-1.
Release 3.0	No modification.
Release 3.2	This command was supported on the Cisco XR 12000 Series Router.
Release 3.3.0	No modification.
Release 3.4.0	No modification.
Release 3.5.0	This command was supported in multicast VRF configuration mode.
Release 3.6.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

This command modifies the default behavior for all new and existing interfaces to enabled unless overridden by the enable or disable keywords available in interface configuration mode.

The following guidelines apply when the enable and disable commands (and the no forms) are used in conjunction with the interface all enable command:

•If the interface all enable command is configured:

–The enable and no forms of the command have no additional effect on a specific interface.

–The disable command disables multicast routing on a specific interface.

–The no disable command returns a previously disabled interface to enabled.

•If the interface all enable command is not configured:

–The enable command enables multicast routing on a specific interface.

–The no enable command returns a previously enabled interface to disabled.

–The disable and no forms of the command have no additional effect on a specific interface.

Task ID

Task ID	Operations
multicast	read, write

Examples

The following example shows how to enable multicast routing on all interfaces and disable the feature only on Packet-over-SONET/SDH (POS) interface 0/1/0/0:

RP/0/RP0/CPU0:router(config)# multicast-routing

RP/0/RP0/CPU0:router(config-mcast)# interface all enable

RP/0/RP0/CPU0:router(config-mcast)# interface pos 0/1/0/0

RP/0/RP0/CPU0:router(config-mcast-default-ipv4-if)# disable

Related Commands

Command	Description
disable (multicast)	Disables multicast routing and forwarding on an interface.
enable	Enables multicast routing and forwarding on an interface.

interface-inheritance disable

To separate PIM and IGMP routing from multicast forwarding on all interfaces, use the interface-inheritance disable command under multicast routing address-family IPv4 or IPv6 submode. To restore the default functionality, use the no form of the command.

interface-inheritance disable

no interface-inheritance disable

Syntax Description

This command hs no arguments or keywords.

Defaults

This feature is not enabled by default.

Command History

Release	Modification
Release 3.5.0	This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0	No modification.

Command Modes

Multicast routing configuration
Address-family IPv4 or IPv6 configuration

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Use of the interface-inheritance disable command together with the interface type interface-id or interface all enable command under multicast routing address-family IPv4 or IPv6 submode separates PIM and IGMP routing functionality from multicast forwarding on specified interfaces. You can nonetheless enable multicast routing functionality explicitly under PIM or IGMP routing configuration mode for individual interfaces.

---

Note Although you can explicitly configure multicast routing functionality on individual interfaces, you cannot explicitly disable the functionality. You can only disable the functionality on all interfaces.

---

Task ID

Task ID	Operations
multicast	read, write

Examples

The following configuration disables PIM and IGMP routing functionality on all the interfaces using the interface-inheritance disable command, but multicast forwarding is still enabled on all the interfaces in the example, based on use of the keywords interface all enable.

PIM is enabled on Loopback 0 based on its explicit configuration (interface Loopback0 enable) under router pim configuration mode.

IGMP protocol is enabled on GigabitEthernet0/6/0/3, because it too has been configured explicitly under router igmp configuration mode (interface GigabitEthernet0/6/0/3 router enable):

RP/0/RP0/CPU0:router(config)# multicast-routing

RP/0/RP0/CPU0:router(config-mcast)# address-family ipv4

RP/0/RP0/CPU0:router(config-mcast-default-ipv4)# interface-inheritance disable

RP/0/RP0/CPU0:router(config-mcast-default-ipv4)# interface loopback 1 enable

RP/0/RP0/CPU0:router(config-mcast-default-ipv4)# sh run router pim

router pim vrf default address-family ipv4

 interface Loopback0

  enable

 !

! 

RP/0/RP0/CPU0:router(config-mcast-default-ipv4)# sh run router igmp

router igmp

 vrf default

  interface GigabitEthernet0/6/0/3

   router enable

  !

 !

! 

log-traps

To enable logging of trap events, use the log-traps command in the appropriate configuration mode. To remove this functionality, use the no form of this command.

log-traps

no log-traps

Syntax Description

This command has no arguments or keywords.

Defaults

By default, this feature is disabled.

Command Modes

Multicast routing configuration
Multicast VRF configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.5.0	This command was supported in multicast VRF configuration mode.
Release 3.6.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Task ID

Task ID	Operations
multicast	read, write

Examples

The following example shows how to enable logging of trap events:

RP/0/RP0/CPU0:router# multicast-routing

RP/0/RP0/CPU0:router(config-mcast)# log-traps

maximum disable

To disable maximum state limits, use the maximum disable command in the appropriate configuration mode. To remove this functionality, use the no form of this command.

maximum disable

no maximum disable

Syntax Description

This command has no arguments or keywords.

Defaults

Maximum state limits are enabled.

Command Modes

Multicast routing configuration
Multicast VRF configuration

Command History

Release	Modification
Release 3.4.0	This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.5.0	This command was supported in multicast VRF configuration mode.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Use the maximum disable command to override the default software limit on the number of multicast routes.

Task ID

Task ID	Operations
multicast	read, write

Examples

The following example shows how to disable maximum state limits:

RP/0/RP0/CPU0:router# multicast-routing

RP/0/RP0/CPU0:router(config-mcast)# maximum disable

mdt data

To configure the multicast VPN (MVPN) data multicast distribution tree (MDT) group configuration, use the mdt data command in the appropriate configuration mode. To remove this functionality, use the no form of this command.

mdt data mdt-group-address/prefix-length threshold threshold acl-name

no mdt data mdt-group-address/prefix-length threshold threshold acl-name

Syntax Description

mdt-group-address	IP address of the MDT group.
/prefix-length	Prefix length of the MDT group. A decimal value that indicates how many of the high-order contiguous bits of the address compose the prefix (the network portion of the address). A slash must precede the decimal value.
threshold threshold	Specifies the traffic rate threshold to trigger data MDT. Range is 0 to 4294967295.
acl-name	Access list (ACL) for the customer VPN routing and forwarding (VRF) groups allowed to do data MDT.

Command Default

threshold: 1

Command Modes

Multicast routing configuration
Multicast VRF configuration

Command History

Release	Modification
Release 3.5.0	This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

When certain multicast streams exceed a configured bandwidth, the multicast data is moved to an MDT data group that is dynamically chosen from an available pool of multicast addresses. If the traffic bandwidth falls below the threshold, the source is switched back to the default MDT. To avoid transitions between the MDTs, traffic only reverts to the default MDT if traffic below the data MDT threshold is at least one minute old.

Task ID

Task ID	Operations
multicast	read, write

Examples

The following example shows how to configure the data MDT group:

RP/0/RP0/CPU0:router# multicast-routing

RP/0/RP0/CPU0:router(config-mcast)# mdt data 172.23.2.2/24 threshold 1200 acl_A 

Related Commands

Command	Description
mdt data	Configures the MDT data group address range.
mdt default	Configures the MDT default group address.
mdt mtu	Configures the MDT maximum transmission unit (MTU).
mdt source	Configures the interface used to set the MDT source address.

mdt default

To configure the default group address of the multicast VPN (MVPN) multicast distribution tree (MDT), use the mdt default command in the appropriate configuration mode. To remove this functionality, use the no form of this command.

mdt default mdt-group-address

no mdt default mdt-group-address

Syntax Description

mdt-group-address

IP address of the MDT default group.

Command Default

The MDT default group address must be unique.

Command Modes

Multicast routing configuration
Multicast VRF configuration

Command History

Release	Modification
Release 3.5.0	This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.6.0	No modification.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

The default MDT has a unique group address used to create MVPN multicast tunnel interfaces.

Task ID

Task ID	Operations
multicast	read, write