Cisco IOS XR Multicast Command Reference for the Cisco CRS Router, Release 5.3.x

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Book Contents
Find Matches in This Book
Available Languages
Download Options

Book Title

Cisco IOS XR Multicast Command Reference for the Cisco CRS Router, Release 5.3.x

Chapter Title

Automatic Multicast Tunneling Commands

Results

Updated:
January 23, 2015

Chapter: Automatic Multicast Tunneling Commands

Automatic Multicast Tunneling Commands

This module describes the commands used to configure Automatic Multicast Tunneling (AMT) on the Cisco IOS XR Software.

For detailed information regarding AMT, refer the Multicast Configuration Guide for Cisco CRS Routers.

advertisement-address

To specify the unique relay address for an Automatic Multicast Tunneling (AMT) process, use the advertisement-address command in the AMT relay configuration mode. To remove the specified address, use the no form of the command.

advertisement-address relay-address

no advertisement-address

Syntax Description

relay address

Interface address.

Command Default

None

Command Modes

AMT relay configuration

Command History

Release Modification
Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
multicast

read, write

Examples

The below example shows how to use the advertisement-address command: 

RP/0/RP0/CPU0:router (config-amt-relay-v4) # advertisement-address 1.1.1.1 pos 5/1/0/0

Related Commands

Command Description

router amt relay ipv4

 Enables Automatic Multicast Tunneling (AMT). 

clear mfib counter amt

To clear the Automatic Multicast tunneling (AMT) statistics, use the clear mfib counter amt command in the EXEC mode.

clear mfib counter amt location

Syntax Description

location

AMT location.

Command Default

None

Command Modes

EXEC

Command History

Release Modification
Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
amt

read, write

Examples

RP/0/RP0/CPU0:router # clear mfib counter amt gig 0/1/2/0

gateway-filter

To enable the configured Access Lists (ACLs) to allow/ drop specific gateways, use the gateway-filter command in the AMT relay configuration mode. To disable this feature, use the no form of the command.

gateway-filter acl-name

no gateway-filter

Syntax Description

acl-name

Displays the defined ACL name.

Command Default

None

Command Modes

AMT relay configuration

Command History

Release Modification
Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

IPv6 ACLs are not supported.

Task ID

Task ID Operation
multicast

read, write

Examples

This example shows how to run the gateway-filter command: 

RP/0/RP0/CPU0:router (config-amt-v4-relay) # gateway-filter a1

maximum gateway

To restrict the total number of Automatic Multicast Tunneling (AMT) gateways in the IGMP/ MLD process, use the maximum gateway command in the AMT relay configuration mode. To remove the defined limit, use the no form of the command.

maximum gateway value

no maximum gateway value

Syntax Description

value

Maximum number of gateways. Range is from 0 to 4294967295.

Command Default

Default value is 10000.

Command Modes

AMT relay configuration

Command History

Release Modification
Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
multicast

read, write

Examples

This example shows how to configure the maximum gateway to 5000:

RP/0/RP0/CPU0:router (config-amt-relay-v4) # maximum gateway 5000

maximum route

To restrict the number of routes per Automatic Multicast Tunneling (AMT) gateway, use the maximum route command in the AMT relay configuration mode. To remove the defined maximum route value, use the no form of the command.

maximum route ipv4 | ipv6 value

no maximum route

Syntax Description

IPv4 | IPv6

Defines the maximum route for the selected address-family.
value

Maximum route value. Range is from 0 to 4294967295.

Command Default

Default value is 1000.

Command Modes

AMT relay configuration

Command History

Release Modification
Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
multicast

read, write

Examples

This example shows how to define the maximum route to 500:

RP/0/RP0/CPU0:router (config-amt-relay-ipv4) # maximum route ipv4 500

maximum route-gateway

To restrict the number of route-gateways (tunnels), use the maximum route-gateway command in the AMT configuration mode. To remove the defined maximum route-gateways, use the no form of the command.

maximum route-gateway { ipv4 | ipv6 } value

no maximum route-gateway

Syntax Description

ipv4 | ipv6

Defines the maximum route-gateways for the selected address-family.
value

Maximum route-gateway value. The rRange is from 0 to 4294967295.

Command Default

Default value is 10000.

Command Modes

AMT relay configuration

Command History

Release Modification
Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
multicast

read, write

Examples

This example shows how to configure the maximum route-gateway to 500:

RP/0/RP0/CPU0:router (config-amt-relay-v4) # maximum route-gateway 500

Related Commands

Command Description

maximum gateway

 Restricts the total number of Automatic Multicast Tunneling (AMT) gateways, in the IGMP/ MLD process.  

gateway-filter

 Enables the configured Access Lists (ACLs) to allow or drop specific gateways. 

maximum route

 Restricts the number of routes per Automatic Multicast Tunneling (AMT) gateway.  

mtu (amt)

To set the Maximum Transmission Units for Automatic Multicast Tunneling (AMT), use the mtu in the AMT configuration mode. To delete the set value, use the no form of the command.

mtu value

no mtu

Syntax Description

value

Specifies the MTU value.

Command Default

9000

Command Modes

AMT configuration mode.

Command History

Release Modification
Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
multicast

read, write

Examples

This example shows how to use the mtu command: 

RP/0/RP0/CPU0:router (config-amt-relay-v4) # mtu 1000

router amt relay ipv4

To enable the Automatic Multicast Tunneling (AMT) process, use the router amt relay ipv4 command in the global configuration mode. To remove all the AMT configurations, use the no form of the command.

router amt relay ipv4

no router amt relay ipv4

Syntax Description

This command has no keywords or arguments.

Command Default

No AMT sessions are created.

Command Modes

Global configuration

Command History

Release Modification
Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

This command enables IPv4 AMT relay submode. IPv6 tunneling is currently not available.

Task ID

Task ID Operation
multicast

read, write

Examples

This example shows how to enable the router amt command: 

RP/0/RP0/CPU0:router (config) # router amt relay ipv4

qqic

To set the Querier's Query Interval Code (QQIC) value for the Automatic Multicast Tunneling ( AMT) membership query message, use the qqic command in the AMT configuration mode. To remove the set QQIC value, use the no form of the command.

qqic qqic-value

no qqic qqic-value

Syntax Description

qqic-value

QQIC value. Range is from 0 to 4294967295.

Command Default

Default value is 1000.

Command Modes

AMT configuration mode

Command History

Release Modification
Release 4.3.1

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
multicast

read, write

Examples

This example shows how to define the qqic value to 500:

RP/0/RP0/CPU0:router (config-amt-relay-v4) # qqic 500

Related Commands

Command Description

router amt relay ipv4

 Enables Automatic Multicast Tunneling (AMT). 

show amt gateway

To display the gateway details for Automatic Multicast Tunneling, use the show amt gateway command in the EXEC mode.

show amt gateway gateway-address port

Syntax Description

gateway-address

Specifies the gateway address in the R/S/I/P format.
port

Specifies the gateway port. The range is from 0 to 4294967295.

Command Default

None

Command Modes

EXEC

Command History

Release Modification
Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
multicast

read

Examples

This example shows how to run the show amt gateway command: 

show amt gateway 13.1.1.2 3000
13.1.1.2/3000
    Keylen: 48, nonce: 0xf44dfd23, nh: 192.11.11.2
    UPD    : 2340 / 0

Related Commands

Command Description

show amt summary

 Displays Automatic Multicast Tunneling information in brief. 

show amt summary

To display the configured Automatic Multicast Tunneling details in brief, use the show amt summary command in EXEC mode.

show amt summary { ipv4 | ipv6}

Syntax Description

ipv4 | ipv6

Displays IPv4 / IPv6 AMT information.

Command Default

None

Command Modes

EXEC

Command History

Release Modification
Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
multicast

read

Examples

The following example shows the IPv4 AMT details: 

show amt ipv4 summary
Anycast-prefix     : 50.1.0.0/16, GW-SIM: False
Relay Adv-Addr     : 1.1.1.1
  MTU/TOS/TTL/QQIC : 1500/2/20/60
  GW count: 64, Max: 64000
  Route Count: 0/1000, Tunnels: 64000/64000
  ACL: 0, OOR: 1

Related Commands

Command Description

router amt relay ipv4

 Enables Automatic Multicast Tunneling (AMT). 

show mrib amt gateway

To display the Multicast Routing Information Base (mrib) gateway details for the Automatic Multicast Tunneling process, use the show mrib amt gateway command in the EXEC mode.

show mrib amt gateway [ port-value | gateway-address] [ expired | summary ]

Syntax Description

summary

Displays the AMT gateway summary.

expired

Displays the expired AMT gateways.

port-value

Gateway details for the specified port. Range for the port value is from 1 to 1048575.

gateway-address

Gateway details for the specified address.

Command Default

None

Command Modes

EXEC

Command History

Release Modification
Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
multicast

read

Examples

This example shows how to use the show mrib amt gateway command: 

show mrib amt gateway
IP Multicast Routing Information Base
Entry flags: L - Domain-Local Source, E - External Source to the Domain,
    C - Directly-Connected Check, S - Signal, IA - Inherit Accept,
    IF - Inherit From, D - Drop, MA - MDT Address, ME - MDT Encap,
    MD - MDT Decap, MT - MDT Threshold Crossed, MH - MDT interface handle
    CD - Conditional Decap, MPLS - MPLS Decap, MF - MPLS Encap, EX - Extranet
    MoFE - MoFRR Enabled, MoFS - MoFRR State, MoFP - MoFRR Primary
    MoFB - MoFRR Backup
Interface flags: F - Forward, A - Accept, IC - Internal Copy,
    NS - Negate Signal, DP - Don't Preserve, SP - Signal Present,
    II - Internal Interest, ID - Internal Disinterest, LI - Local Interest,
    LD - Local Disinterest, DI - Decapsulation Interface
    EI - Encapsulation Interface, MI - MDT Interface, LVIF - MPLS Encap,
    EX - Extranet, A2 - Secondary Accept
(13.1.1.2,3000) 
  Source/Group:(195.1.1.2,232.1.4.232) 
    Joined at: 00:04:01
    Total Packets/Bytes Sent: 2092/3100344
  Source/Group:(195.1.1.2,232.1.4.231) 
    Joined at: 00:04:01
    Total Packets/Bytes Sent: 2092/3100344
  Source/Group:(195.1.1.2,232.1.4.230) 
    Joined at: 00:04:01
    Total Packets/Bytes Sent: 2092/3100344
  Source/Group:(195.1.1.2,232.1.4.229) 
    Joined at: 00:04:01
    Total Packets/Bytes Sent: 2092/3100344
  Source/Group:(195.1.1.2,232.1.4.228) 
    Joined at: 00:04:01
    Total Packets/Bytes Sent: 2092/3100344

This example shows how to use the show mrib amt gateway command with the summary keyword: 

show mrib amt gateway summary
IP Multicast Routing Information Base
Entry flags: L - Domain-Local Source, E - External Source to the Domain,
    C - Directly-Connected Check, S - Signal, IA - Inherit Accept,
    IF - Inherit From, D - Drop, MA - MDT Address, ME - MDT Encap,
    MD - MDT Decap, MT - MDT Threshold Crossed, MH - MDT interface handle
    CD - Conditional Decap, MPLS - MPLS Decap, MF - MPLS Encap, EX - Extranet
    MoFE - MoFRR Enabled, MoFS - MoFRR State, MoFP - MoFRR Primary
    MoFB - MoFRR Backup
Interface flags: F - Forward, A - Accept, IC - Internal Copy,
    NS - Negate Signal, DP - Don't Preserve, SP - Signal Present,
    II - Internal Interest, ID - Internal Disinterest, LI - Local Interest,
    LD - Local Disinterest, DI - Decapsulation Interface
    EI - Encapsulation Interface, MI - MDT Interface, LVIF - MPLS Encap,
    EX - Extranet, A2 - Secondary Accept
(13.1.1.2,3000) 
    Number of Multicast streams (S,G)joined: 1000
    Total Packets/Bytes Sent [Acitve route]: 1823891/2703006462
    Total Packets/Bytes Sent [Expired route]: 160775898/238268611218
(13.1.1.3,3000) 
    Number of Multicast streams (S,G)joined: 1000
    Total Packets/Bytes Sent [Acitve route]: 1784325/2644369650
    Total Packets/Bytes Sent [Expired route]: 160936848/238507137712

This example shows how to use the show mrib amt gateway command with the expired keyword: 

show mrib amt gateway expired
IP Multicast Routing Information Base
Entry flags: L - Domain-Local Source, E - External Source to the Domain,
    C - Directly-Connected Check, S - Signal, IA - Inherit Accept,
    IF - Inherit From, D - Drop, MA - MDT Address, ME - MDT Encap,
    MD - MDT Decap, MT - MDT Threshold Crossed, MH - MDT interface handle
    CD - Conditional Decap, MPLS - MPLS Decap, MF - MPLS Encap, EX - Extranet
    MoFE - MoFRR Enabled, MoFS - MoFRR State, MoFP - MoFRR Primary
    MoFB - MoFRR Backup
Interface flags: F - Forward, A - Accept, IC - Internal Copy,
    NS - Negate Signal, DP - Don't Preserve, SP - Signal Present,
    II - Internal Interest, ID - Internal Disinterest, LI - Local Interest,
    LD - Local Disinterest, DI - Decapsulation Interface
    EI - Encapsulation Interface, MI - MDT Interface, LVIF - MPLS Encap,
    EX - Extranet, A2 - Secondary Accept
(13.1.1.2,3000) 
  Source/Group:(195.1.1.2,232.1.4.232) 
    Joined at: 05:34:59
    Total Packets/Bytes Sent: 160948/238524936
  Source/Group:(195.1.1.2,232.1.4.231) 
    Joined at: 05:34:59
    Total Packets/Bytes Sent: 160948/238524936

This example shows how to use the show mrib amt gateway command with port value specified at 3000: 

show mrib amt gateway 3000
IP Multicast Routing Information Base
Entry flags: L - Domain-Local Source, E - External Source to the Domain,
    C - Directly-Connected Check, S - Signal, IA - Inherit Accept,
    IF - Inherit From, D - Drop, MA - MDT Address, ME - MDT Encap,
    MD - MDT Decap, MT - MDT Threshold Crossed, MH - MDT interface handle
    CD - Conditional Decap, MPLS - MPLS Decap, MF - MPLS Encap, EX - Extranet
    MoFE - MoFRR Enabled, MoFS - MoFRR State, MoFP - MoFRR Primary
    MoFB - MoFRR Backup
Interface flags: F - Forward, A - Accept, IC - Internal Copy,
    NS - Negate Signal, DP - Don't Preserve, SP - Signal Present,
    II - Internal Interest, ID - Internal Disinterest, LI - Local Interest,
    LD - Local Disinterest, DI - Decapsulation Interface
    EI - Encapsulation Interface, MI - MDT Interface, LVIF - MPLS Encap,
    EX - Extranet, A2 - Secondary Accept
(13.1.1.2,3000) 
  Source/Group:(195.1.1.2,232.1.4.232) 
    Joined at: 00:07:40
    Total Packets/Bytes Sent: 4121/6107322
  Source/Group:(195.1.1.2,232.1.4.231) 
    Joined at: 00:07:40
    Total Packets/Bytes Sent: 4121/6107322

show mrib amt route

To display the Multicast Routing Information Base (mrib) route details, use the show mrib amt route command in the EXEC mode.

show mrib amt route source-address [ expired | summary ]

Syntax Description

summary

Displays the AMT route summary.

expired

Displays the expired AMT routes.

source-address

Route details for the specified source address.

Command Default

None

Command Modes

EXEC

Command History

Release Modification
Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
multicast

read

Examples

This example shows how to use the show mrib amt route command: 

show mrib amt route
IP Multicast Routing Information Base
Entry flags: L - Domain-Local Source, E - External Source to the Domain,
    C - Directly-Connected Check, S - Signal, IA - Inherit Accept,
    IF - Inherit From, D - Drop, MA - MDT Address, ME - MDT Encap,
    MD - MDT Decap, MT - MDT Threshold Crossed, MH - MDT interface handle
    CD - Conditional Decap, MPLS - MPLS Decap, MF - MPLS Encap, EX - Extranet
    MoFE - MoFRR Enabled, MoFS - MoFRR State, MoFP - MoFRR Primary
    MoFB - MoFRR Backup
Interface flags: F - Forward, A - Accept, IC - Internal Copy,
    NS - Negate Signal, DP - Don't Preserve, SP - Signal Present,
    II - Internal Interest, ID - Internal Disinterest, LI - Local Interest,
    LD - Local Disinterest, DI - Decapsulation Interface
    EI - Encapsulation Interface, MI - MDT Interface, LVIF - MPLS Encap,
    EX - Extranet, A2 - Secondary Accept

(195.1.1.2,232.1.1.1)
  AMT Tunnel: GW: 13.1.1.2/3000, TenGigE0/0/0/2 Flags: AT, Up: 00:05:13
              Src:1.1.1.1, NH: 192.11.11.2, AMT-ID: 662986
              Total Packets/Bytes Sent: 2758/4087356
  AMT Tunnel: GW: 13.1.1.3/3000, TenGigE0/0/0/2 Flags: AT, Up: 00:05:10
              Src:1.1.1.1, NH: 192.11.11.2, AMT-ID: 681670
              Total Packets/Bytes Sent: 2727/4041414

This example shows how to use the show mrib amt route command with the summary keyword: 

show mrib amt route summary
(195.1.1.2,232.1.1.1)
  Number of AMT Gateways currently joined: 64
  Total Packets/Bytes out [Active]: 10253760 / 15195982336
  Total Packets/Bytes out [Expired]: 0 / 0

(195.1.1.2,232.1.1.2)
  Number of AMT Gateways currently joined: 64
  Total Packets/Bytes out [Active]: 10253760 / 15195982336
  Total Packets/Bytes out [Expired]: 0 / 0

This example shows how to use the show mrib amt route command with the expired keyword: 

show mrib amt route expired
IP Multicast Routing Information Base
Entry flags: L - Domain-Local Source, E - External Source to the Domain,
    C - Directly-Connected Check, S - Signal, IA - Inherit Accept,
    IF - Inherit From, D - Drop, MA - MDT Address, ME - MDT Encap,
    MD - MDT Decap, MT - MDT Threshold Crossed, MH - MDT interface handle
    CD - Conditional Decap, MPLS - MPLS Decap, MF - MPLS Encap, EX - Extranet
    MoFE - MoFRR Enabled, MoFS - MoFRR State, MoFP - MoFRR Primary
    MoFB - MoFRR Backup
Interface flags: F - Forward, A - Accept, IC - Internal Copy,
    NS - Negate Signal, DP - Don't Preserve, SP - Signal Present,
    II - Internal Interest, ID - Internal Disinterest, LI - Local Interest,
    LD - Local Disinterest, DI - Decapsulation Interface
    EI - Encapsulation Interface, MI - MDT Interface, LVIF - MPLS Encap,
    EX - Extranet, A2 - Secondary Accept
(195.1.1.2,232.1.1.1) 
  AMT Tunnel: ID: 586786 GW: 13.1.1.2/3000 
    Joined at: 05:28:08
    Expired at: 00:00:08
    Total Packets/Bytes Sent: 160870/238407934

tos(amt)

To set the Type of Service (TOS) value for Automatic Multicast Tunneling (AMT), use the tos command in the AMT configuration mode. To delete the set TOS value, use the no form of the command.

tos value

no tos

Syntax Description

value

TOS value. Range is from 1 to 255.

Command Default

1

Command Modes

AMT configuration mode.

Command History

Release Modification
Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
multicast

read, write

Examples

This example shows how to use the tos command: 

RP/0/RP0/CPU0:router (config-amt-relay-v4) # tos 5

ttl(amt)

To set the Time To Live (TTL) value for Automatic Multicast Tunneling (AMT), use the ttl command in the AMT configuration mode. To delete the set TTL value, use the no form of the command.

ttl value

no ttl

Syntax Description

value

Specifies the TTL value.

Command Default

255 ms

Command Modes

AMT configuration mode.

Command History

Release Modification
Release 4.3.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation
multicast

read, write

Examples

This example shows how to use the ttl command: 

RP/0/RP0/CPU0:router (config-amt-relay-v4) # ttl 500

Was this Document Helpful?

FeedbackFeedback

Contact Cisco