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.
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 Cisco IOS XR Multicast Configuration Guide for the Cisco CRS Router.
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
relay address |
Interface address. |
None
AMT relay configuration
Release | Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
Task ID | Operation |
---|---|
multicast |
read, write |
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
Command | Description |
Enables Automatic Multicast Tunneling (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
location |
AMT location. |
None
EXEC
Release | Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
Task ID | Operation |
---|---|
amt |
read, write |
RP/0/RP0/CPU0:router # clear mfib counter amt gig 0/1/2/0
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
acl-name |
Displays the defined ACL name. |
None
AMT relay configuration
Release | Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
IPv6 ACLs are not supported.
Task ID | Operation |
---|---|
multicast |
read, write |
This example shows how to run the gateway-filter command:
RP/0/RP0/CPU0:router (config-amt-v4-relay) # gateway-filter a1
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
value |
Maximum number of gateways. Range is from 0 to 4294967295. |
Default value is 10000.
AMT relay configuration
Release | Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
Task ID | Operation |
---|---|
multicast |
read, write |
This example shows how to configure the maximum gateway to 5000:
RP/0/RP0/CPU0:router (config-amt-relay-v4) # maximum gateway 5000
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
IPv4 | IPv6 |
Defines the maximum route for the selected address-family. |
value |
Maximum route value. Range is from 0 to 4294967295. |
Default value is 1000.
AMT relay configuration
Release | Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
Task ID | Operation |
---|---|
multicast |
read, write |
This example shows how to define the maximum route to 500:
RP/0/RP0/CPU0:router (config-amt-relay-ipv4) # maximum route ipv4 500
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
ipv4 | ipv6 |
Defines the maximum route-gateways for the selected address-family. |
value |
Maximum route-gateway value. The rRange is from 0 to 4294967295. |
Default value is 10000.
AMT relay configuration
Release | Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
Task ID | Operation |
---|---|
multicast |
read, write |
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
Command | Description |
Restricts the total number of Automatic Multicast Tunneling (AMT) gateways, in the IGMP/ MLD process. | |
Enables the configured Access Lists (ACLs) to allow or drop specific gateways. | |
Restricts the number of routes per Automatic Multicast Tunneling (AMT) gateway. |
To set the Maximum Transmission Units for Automatic Multicast Tunneling (AMT), use the mtuin the AMT configuration mode. To delete the set value, use the no form of the command.
mtu value
no mtu
value |
Specifies the MTU value. |
9000
AMT configuration mode.
Release | Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
Task ID | Operation |
---|---|
multicast |
read, write |
This example shows how to use the mtu command:
RP/0/RP0/CPU0:router (config-amt-relay-v4) # mtu 1000
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
This command has no keywords or arguments.
No AMT sessions are created.
Global configuration
Release | Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
Task ID | Operation |
---|---|
multicast |
read, write |
This example shows how to enable the router amt command:
RP/0/RP0/CPU0:router (config) # router amt relay ipv4
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
qqic-value |
QQIC value. Range is from 0 to 4294967295. |
Default value is 1000.
AMT configuration mode
Release | Modification |
---|---|
Release 4.3.1 |
Task ID | Operation |
---|---|
multicast |
read, write |
This example shows how to define the qqic value to 500:
RP/0/RP0/CPU0:router (config-amt-relay-v4) # qqic 500
Command | Description |
Enables Automatic Multicast Tunneling (AMT). |
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
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. |
None
EXEC
Release | Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
Task ID | Operation |
---|---|
multicast |
read |
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
Command | Description |
Displays Automatic Multicast Tunneling information in brief. |
To display the configured Automatic Multicast Tunneling details in brief, use the show amt summary command in EXEC mode.
show amt summary { ipv4 | ipv6}
ipv4 | ipv6 |
Displays IPv4 / IPv6 AMT information. |
None
EXEC
Release | Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
Task ID | Operation |
---|---|
multicast |
read |
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
Command | Description |
Enables Automatic Multicast Tunneling (AMT). |
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 ]
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. |
None
EXEC
Release | Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
Task ID | Operation |
---|---|
multicast |
read |
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
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 ]
summary |
Displays the AMT route summary. |
expired |
Displays the expired AMT routes. |
source-address |
Route details for the specified source address. |
None
EXEC
Release | Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
Task ID | Operation |
---|---|
multicast |
read |
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
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 noform of the command.
tos value
no tos
value |
TOS value. Range is from 1 to 255. |
1
AMT configuration mode.
Release | Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
Task ID | Operation |
---|---|
multicast |
read, write |
This example shows how to use the tos command:
RP/0/RP0/CPU0:router (config-amt-relay-v4) # tos 5
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 noform of the command.
ttl value
nottl
value |
Specifies the TTL value. |
255 ms
AMT configuration mode.
Release | Modification |
---|---|
Release 4.3.1 |
This command was introduced. |
Task ID | Operation |
---|---|
multicast |
read, write |
This example shows how to use the ttl command:
RP/0/RP0/CPU0:router (config-amt-relay-v4) # ttl 500