-
Cisco IOS IP Multicast Command Reference
-
beacon (multicast routing monitor) through ip dvmrp summary-address
-
ip dvmrp unicast-routing through ip igmp ssm-map query dns
-
ip igmp ssm-map static through ip multicast rate-limit
-
ip multicast route-limit through ip pim state-refresh origination-interval
-
ip pim vc-count through show ip igmp snooping statistics
-
show ip igmp ssm-mapping through udp-port
-
Table Of Contents
mls ip multicast (global configuration)
mls ip multicast (interface configuration)
mls ip multicast bidir gm-scan-interval
mls ip multicast consistency-check
mls ip multicast flow-stat-timer
mls ip multicast non-rpf aging
mls ip multicast replication-mode
router-guard ip multicast switchports
show ip igmp snooping explicit-tracking
show ip igmp snooping rate-limit
show ip igmp snooping statistics
show ip igmp snooping subscriber-rate
ip pim vc-count
To change the maximum number of virtual circuits (VCs) that Protocol Independent Multicast (PIM) can open, use the ip pim vc-count command in interface configuration mode. To restore the default value, use the no form of this command.
ip pim vc-count number
no ip pim vc-count
Syntax Description
number
Maximum number of VCs that PIM can open. The default is 200 VCs. The range is from 1 to 65535.
Defaults
200 VCs per ATM interface or subinterface
Command Modes
Interface configuration
Command History
Examples
The following example allows PIM to open a maximum of 250 VCs:
ip pim vc-count 250Related Commands
ip pim version
To configure the Protocol Independent Multicast (PIM) version of the interface, use the ip pim version command in interface configuration mode. To restore the default value, use the no form of this command.
ip pim version [1 | 2]
no ip pim version
Syntax Description
Defaults
Version 2
Command Modes
Interface configuration
Command History
Usage Guidelines
An interface in Version 2 mode automatically downgrades to Version 1 mode if that interface has a PIM Version 1 neighbor. The interface returns to Version 2 mode after all Version 1 neighbors disappear (that is, they are shut down or upgraded).
Examples
The following example configures the interface to operate in PIM Version 1 mode:
interface ethernet 0 ip address 10.0.0.0 255.0.0.0 ip pim sparse-dense-mode ip pim version 1ip rgmp
To enable the Router-Port Group Management Protocol (RGMP) on Ethernet, Fast Ethernet, and Gigabit Ethernet interfaces, use the ip rgmp command in interface configuration mode. To disable RGMP on the interfaces, use the no form of this command.
ip rgmp
no ip rgmp
Syntax Description
This command has no arguments or keywords.
Defaults
RGMP is not enabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
RGMP is supported only on Ethernet, Fast Ethernet, and Gigabit Ethernet interfaces.
Before you enable RGMP, the following features must be enabled on your router:
•
IP routing
•
•
If your router is in a bidirectional group, make sure to enable RGMP only on interfaces that do not function as a designated forwarder (DF). If you enable RGMP on an interface that functions as a DF, the interface will not forward multicast packets up the bidirectional shared tree to the rendezvous point (RP).
The following features must be enabled on your switch:
•
•
Examples
The following example enables RGMP on Ethernet interface 1/0:
interface ethernet 1/0ip rgmpRelated Commands
debug ip rgmp
Logs debug messages sent by an RGMP-enabled router.
show ip igmp interface
Displays multicast-related information about an interface.
ip sap cache-timeout
To limit how long a Session Announcement Protocol (SAP) cache entry stays active in the cache, use the ip sap cache-timeout command in global configuration mode. To restore the default value, use the no form of this command.
ip sap cache-timeout minutes
no ip sap cache-timeout
Syntax Description
Defaults
By default, session announcements remain for 1440 minutes (24 hours) in the cache.
Command Modes
Global configuration
Command History
Usage Guidelines
This command defines how long session announcements are cached by the router. Active session announcements are periodically re-sent by the originating site, refreshing the cached state in the router. The minimum interval between announcements for a single group is 5 minutes. Setting the cache timeout to a value less than 30 minutes is not recommended. Set the cache timeout to 0 to keep entries in the cache indefinitely.
Examples
The following example causes SAP cache entries to remain in the cache for 30 minutes:
ip sap cache-timeout 30Related Commands
clear ip sap
Deletes a SAP cache entry or the entire SAP cache.
show ip sap
Displays the SAP cache.
ip sap listen
To enable the Cisco IOS software to listen to session directory announcements, use the ip sap listen command in interface configuration mode. To disable the function, use the no form of this command.
ip sap listen
no ip sap listen
Syntax Description
This command has no arguments or keywords.
Defaults
The command is disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
Cisco IOS software can receive and store Session Description Protocol (SDP) and Session Announcement Protocol (SAP) session announcements. When the ip sap listen command is configured on an interface, the well-known session directory groups on that interface can receive and store session announcements. The announcements can be displayed with the show ip sap command. The ip multicast rate-limit command uses stored session announcements. To configure the period of time after which received announcements will expire, use the ip sap cache-timeout command.
When the no ip multicast routing command is configured, announcements are only stored if they are received on an interface configured with the ip sap listen command. When a system is configured as a multicast router, it is sufficient to configure the ip sap listen command on only a single multicast-enabled interface. The well-known session directory groups are handled as local joined groups after the ip sap listen command is first configured (see the L flag of the show ip mroute command). This configuration causes announcements received from all multicast-enabled interfaces to be routed and stored within the system.
Examples
The following example shows how to enable a router to listen to session directory announcements:
ip routinginterface loopback 0ip address 10.0.0.51 255.255.255.0ip pim sparse-dense modeip sap listenRelated Commands
ip sdr cache-timeout
The ip sdr cache-timeout command is replaced by the ip sap cache-timeout command. See the description of the ip sap cache-timeout command for more information.
ip sdr listen
The ip sdr listen command is replaced by the ip sap listen command. See the description of the ip sap listen command for more information.
ip urd
To enable interception of TCP packets sent to the reserved URL Rendezvous Directory (URD) port 465 on an interface and processing of URD channel subscription reports, use the ip urd command in interface configuration mode. To disable URD on an interface, use the no form of this command.
ip urd [proxy]
no ip urd [proxy]
Syntax Description
Defaults
The command is disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
To use this command, you must first define a Source Specific Multicast (SSM) range of IP addresses using the ip pim ssm global configuration command. When URD is enabled, it is supported in the SSM range of addresses only. We recommend that you not enable URD on backbone interfaces, but only on interfaces connecting to hosts.
URD functionality is available for multicast process switching, fast switching, and distributed fast-switching paths.
Examples
The following example shows how to configure URD on Ethernet interface 3/3:
interface ethernet 3/3ip urdRelated Commands
manager
To specify the interface that is to act as the Manager for Multicast Routing Monitor (MRM), and to specify the multicast group address the Test Receiver will listen to, use the manager command in MRM manager configuration mode. To remove the Manager or group address, use the no form of this command.
manager interface-type interface-number group ip-address
no manager interface-type interface-number group ip-address
Syntax Description
Command Default
There is no MRM Manager configured.
Command Modes
MRM manager configuration (config-mrm-manager)
Command History
Usage Guidelines
This command identifies the interface that acts as the Manager, and therefore is required in order to run MRM.
Examples
The following example shows how to configure Ethernet interface 0 as the Manager and the Test Receiver to listen to multicast group 239.1.1.1:
ip mrm manager test1manager ethernet 0 group 239.1.1.1Related Commands
mdt data
To configure the multicast group address range for data multicast distribution tree (MDT) groups, use the mdt data command in VRF configuration mode. To disable this function, use the no form of this command.
mdt data group-address-range wildcard-bits [threshold threshold-value] [list access-list]
no mdt data group-address-range wildcard-bits [threshold threshold-value] [list access-list]
Syntax Description
Defaults
The command is disabled.
Command Modes
VRF configuration
Command History
Usage Guidelines
A data MDT group can include a maximum of 256 multicast groups per Virtual Private Network (VPN). Multicast groups used to create the data MDT group are dynamically chosen from a pool of configured IP addresses.
This command configures a range of alternative multicast destination addresses for the tunnel header. The destination address chosen depends on the traffic profile (that is, the source and destination match the specified access list and the rate of the traffic has exceeded the bandwidth threshhold value).
Examples
In the following example, Protocol Independent Multicast (PIM) Source Specific Multicast (SSM) is configured in the backbone. Therefore, the default and data MDT groups are configured within the SSM range of IP addresses. Inside the VPN, PIM sparse mode (PIM-SM) is configured and only Auto-RP announcements are accepted.
!ip vrf vrf1rd 1:1route-target export 1:1route-target import 1:1mdt default 232.0.0.1mdt data 232.0.1.0 0.0.0.255 threshold 500 list 101!...!ip pim ssm defaultip pim vrf vrf1 accept-rp auto-rp!Related Commands
mdt default
To configure a default multicast distribution tree (MDT) group for a Virtual Private Network (VPN) routing and forwarding (VRF) instance, use the mdt default command in VRF configuration mode. To disable this function, use the no form of this command.
mdt default group-address
no mdt default group-address
Syntax Description
Defaults
The command is disabled.
Command Modes
VRF configuration
Command History
Usage Guidelines
The default MDT group must be the same group configured on all PE routers that belong to the same VPN.
If Source Specific Multicast (SSM) is used as the protocol for the default MDT, the source IP address will be the address used to source the Border Gateway Protocol (BGP) sessions.
A tunnel interface is created as a result of this command. By default, the destination address of the tunnel header is the group-address argument.
Examples
In the following example, Protocol Independent Multicast (PIM) SSM is configured in the backbone. Therefore, the default and data MDT groups are configured within the SSM range of IP addresses. Inside the VPN, PIM sparse mode (PIM-SM) is configured and only Auto-RP announcements are accepted.
!ip vrf vrf1rd 1:1route-target export 1:1route-target import 1:1mdt default 232.0.0.1mdt data 232.0.1.0 0.0.0.255 threshold 500 list 101!...!ip pim ssm defaultip pim vrf vrf1 accept-rp auto-rp!Related Commands
mdt log-reuse
To enable the recording of data multicast distribution tree (MDT) reuse, use the mdt log-reuse command in VRF configuration mode. To disable this function, use the no form of this command.
mdt log-reuse
no mdt log-reuse
Syntax Description
This command has no arguments or keywords.
Defaults
The command is disabled.
Command Modes
VRF configuration
Command History
Usage Guidelines
The mdt log-reuse command generates a syslog message whenever a data MDT is reused.
Examples
The following example shows how to enable MDT log reuse:
mdt log-reuseRelated Commands
mdt data
Configures the multicast group address range for data MDT groups.
mdt default
Configures a default MDT group for a VPN VRF.
mls ip multicast (global configuration)
To enable MLS IP and configure the hardware switching globally, use the mls ip multicast command in global configuration mode. To disable MLS IP, use the no form of this command.
mls ip multicast [capability]
mls ip multicast [vrf name] [connected | egress local | mfd | refresh-state | shared-tree-mfd | syslog | threshold ppsec]
no mls ip multicast [vrf]
Syntax Description
Defaults
The defaults are as follows:
•
•
•
•
•
•
•
•
Command Modes
Global configuration
Command History
Usage Guidelines
Note
Egress multicast replication is not supported on sysems that are configured with a Supervisor Engine 32.
When entering the mls ip multicast egress local command, ensure that IPv6 multicast is not enabled. Since the egress multicast replication performance enhancement feature cannot separately turn on or turn off IPv4 and IPv6, you cannot have IPv4 and IPv6 multicast enabled when this feature is turned on.
These optional keywords are supported only on systems that are configured with a Supervisor Engine 720 with a PFC3:
•
•
•
•
•
The threshold ppsec optional keyword and argument do not impact flows that are already populated in the hardware cache.
The expiration time refresh is updated when flow statistics are received (indicating that the traffic is received from the RPF interface).
Examples
This example shows how to enable the MLS IP shortcuts:
Router(config)# mls ip multicastThis example shows how to enable the hardware switching on a specific multicast route:
Router(config)# mls ip multicast vrf test1This example shows how to export the information about egress capability from the switch processor to the route processor:
Router(config)# mls ip multicast capabilityThis example shows how to populate the multicast expansion table with local Layer 3-routed interfaces:
Router(config)# mls ip multicast egress localRelated Commands
mls rp ip (global configuration mode)
Enables external systems to establish IP shortcuts to the MSFC.
show mls ip multicast
Displays the MLS IP information.
mls ip multicast (interface configuration)
To enable MLS IP shortcuts on the interface, use the mls ip multicast command in interface configuration mode. To disable MLS IP shortcuts on the interface, use the no form of this command.
mls ip multicast
no mls ip multicast
Syntax Description
This command has no arguments or keywords.
Defaults
Multicast is disabled.
Command Modes
Interface configuration
Command History
Examples
This example shows how to enable the MLS IP shortcuts:
Router(config-if)# mls ip multicastRelated Commands
mls ip multicast bidir gm-scan-interval
To set the RPF scan interval for the Bidir rendevous point, use the mls ip multicast bidir gm-scan-interval command in global configuration mode. To disable the RPF scan interval for the Bidir rendevous point, use the no form of this command.
mls ip multicast bidir gm-scan-interval interval
no mls ip multicast bidir gm-scan-interval
Syntax Description
Defaults
10 seconds
Command Modes
Global configuration
Command History
12.2(14)SX
Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
When you set the RPF scan interval for the Bidir rendevous point, you set the time that the periodic scan timer updates the RPF in the DF table for all Bidir rendevous points in the hardware.
Examples
This example shows how to set the RPF scan interval for the Bidir rendevous point:
Router(config)# mls ip multicast bidir gm-scan-interval 30Related Commands
mls ip multicast connected
To enable the downloading of directly connected subnets globally, use the mls ip multicast connected command in global configuration mode. To disable the downloading of directly connected subnets globally, use the no form of this command.
mls ip multicast connected
no mls ip multicast connected
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Global configuration
Command History
Usage Guidelines
Do not create directly connected subnets for the following cases:
•
•
•
In these cases, if you enable the downloading of directly connected subnets, the directly connected source hits the MMLS (*,G) entry and is switched using the MMLS (*,G) entry. The registers are not sent to the route processor (in the case of PIM-SM), and the (S,G) state is not created on the first hop (in the case of PIM-DM).
The subnet entry is installed in the TCAM entries with a shorter mask to catch directly connected sources before they hit such entries. You can punt traffic from directly connected sources to the MSFC. Once the MSFC sees this traffic, it can install an MMLS (S,G) entry for this source, which gets installed before the subnet entry in the TCAM. New packets from this source are now switched with the (S,G) entry.
Examples
This example shows how to enable the downloading of directly connected subnets:
Router(config)# mls ip multicast connectedRelated Commands
mls ip multicast (global configuration)
Enables MLS IP and configures the hardware switching globally.
show mls ip multicast
Displays the MLS IP information.
mls ip multicast consistency-check
To enable and configure the hardware-shortcut consistency checker, use the mls ip multicast consistency-check command in global configuration mode. To disable the consistency checkers, use the no form of this command.
mls ip multicast consistency-check [auto-repair | error-message | settle-time seconds | type [rp-sp [table | vrf] | scan-mroute [count count-number] | settle-time seconds | period seconds]
no mls ip multicast consistency-check
Syntax Description
Defaults
The defaults are as follows:
•
•
•
•
Command Modes
Global configuration
Command History
Usage Guidelines
The consistency checker scans the mroute table and assures that the multicast-hardware entries are consistent with the mroute table. Whenever an inconsistency is detected, the inconsistency is automatically corrected.
To display the inconsistency error, use the show mls ip multicast consistency-check command.
Examples
This example shows how to enable the hardware-shortcut consistency checker:
Router(config)# mls ip multicast consistency-checkThis example shows how to enable the hardware-shortcut consistency checker and configure the scan check of the mroute table:
Router(config)# mls ip multicast consistency-check type scan-mroute count 20 period 35This example shows how to enable the hardware-shortcut consistency checker and specify the period between scans:
Router(config)# mls ip multicast consistency-check type scan-mroute period 35Related Commands
mls ip multicast flow-stat-timer
To set the time interval between two consecutive batches of flow-statistics messages from the switch processor to the route processor, use the mls ip multicast flow-stat-timer command in global configuration mode. To return to the default settings, use the no form of this command.
mls ip multicast flow-stat-timer num
no mls ip multicast flow-stat-timer
Syntax Description
num
Time interval between two consecutive batches of flow-statistics messages from the switch processor to the route processor.
Defaults
25 seconds
Command Modes
Global configuration
Command History
12.2(14)SX
Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
Examples
This example shows how to configure the time interval between two consecutive batches of flow-statistics messages from the switch processor to the route processor:
Router(config)# mls ip multicast flow-stat-timer 10Related Commands
mls ip multicast non-rpf aging
To enable rate-limiting of non-RPF traffic, use the mls ip multicast non-rpf aging command in global configuration mode. To return to the default settings, use the no form of this command.
mls ip multicast non-rpf aging {global | fast} time
no mls ip multicast non-rpf aging {global | fast}
Syntax Description
Defaults
The fast aging time default is 2 seconds and the global aging time default is 20 seconds.
Command Modes
Global configuration
Command History
12.2(18)SXE
Support for this command was introduced for the Supervisor Engine 720.
Usage Guidelines
You should not configure ACL-based filtering of RPF failures.
Examples
This example shows how to enable rate-limiting of non-RPF traffic:
Router(config)# mls ip multicast non-rpf aging global 90This example shows how to display the multicast configuration of the router:
Router# show running | incl mls ip multicastmls ip multicast non-rpf aging global 90mls ip multicast non-rpf aging fast 4Router#Related Commands
mls ip multicast replication-mode
To enable and specify the replication mode, use the mls ip multicast replication-mode command in global configuration mode. To restore the system to automatic detection mode, use the no form of this command.
mls ip multicast replication-mode {egress | ingress}
no mls ip multicast replication-mode {egress | ingress}
Syntax Description
egress
Forces the system to the egress mode of replication.
ingress
Forces the system to the ingress mode of replication.
Defaults
The Supervisor Engine 720 automatically detects the replication mode based on the module types that are installed in the system. If all modules are capable of egress replication, the system uses egress-replication mode. If the supervisor engine detects the modules that are not capable of egress replication, the replication mode automatically switches to ingress replication.
If the system is functioning in the automatic-detection egress mode, and you install a module that cannot perform egress replication, the following occurs:
•
•
•
Command Modes
Global configuration
Command History
Usage Guidelines
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 32.
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
Note
If you enter the no mls ip multicast replication-mode egress command, only the forced-egress mode resets and not the forced-ingress mode.
If you enter the no mls ip multicast replication-mode ingress command, only the forced-ingress mode resets and not the forced-egress mode.
Examples
This example shows how to enable the ingress-replication mode:
Router(config)# mls ip multicast replication-mode ingressThis example shows how to enable the egress-replication mode:
Router(config)# mls ip multicast replication-mode egressThis example shows how to disable the current egress-replication mode and return to automatic detection mode:
Router(config)# no mls ip multicast replication-mode egressRelated Commands
mls ip multicast sso
To configure the stateful switchover (SSO) parameters, use the mls ip multicast sso command in global configuration mode. To return to the default settings, use the no form of this command.
mls ip multicast sso {convergence-time time | leak {interval seconds | percent percentage}}
no mls ip multicast sso {convergence-time time | leak {interval seconds | percent percentage}}
Syntax Description
Command Default
The defaults are as follows:
•
•
•
Command Modes
Global configuration
Command History
12.2(18)SXD
Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
Examples
This example shows how to set the maximum time to wait for protocol convergence to 300 seconds:
Router(config)# mls ip multicast sso convergence-time 300Router(config)#This example shows how to set the packet-leak interval to 200 seconds:
Router(config)# mls ip multicast sso leak interval 200Router(config)#This example shows how to set the packet-leak percentage to 55 percent:
Router(config)# mls ip multicast sso leak percent 55Router(config)#Related Commands
show mls ip multicast sso
Displays information about multicast high-availability SSO.
mls ip multicast stub
To enable the support for non-RPF traffic drops for PIM sparse-mode stub networks, use the mls ip multicast stub command in interface configuration mode. To disable support for non-RPF traffic drops for PIM sparse-mode stub networks, use the no form of this command.
mls ip multicast stub
no mls ip multicast stub
Syntax Description
This command has no arguments or keywords.
Defaults
Multicast is disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
When you enable the ACL-based method of filtering RPF failures by entering the mls ip multicast stub command on the redundant router, the following ACLs automatically download to the PFC and are applied to the interface that you specify:
•
•
•
•
•
The ACLs filter the RPF failures and drop them in the hardware so that they are not forwarded to the router.
Use the ACL-based method of filtering the RPF failures only in sparse-mode stub networks where there are no downstream routers. For dense-mode groups, the RPF failure packets have to be seen on the router for the PIM-assert mechanism to function properly. Use CEF-or NetFlow-based rate limiting to rate limit the RPF failures in dense-mode networks and sparse-mode transit networks.
Examples
This example shows how to enable the support for the non-RPF traffic drops for the PIM sparse-mode stub networks:
Router(config-if)# mls ip multicast stubRelated Commands
mls ip multicast threshold
To configure a threshold rate for installing hardware shortcuts, use the mls ip multicast threshold command in global configuration mode. To deconfigure the threshold rate, use the no form of this command.
mls ip multicast threshold pps
no mls ip multicast threshold
Syntax Description
Defaults
This command has no default settings.
Command Modes
Global configuration
Command History
Usage Guidelines
Use this command to prevent creation of MLS entries for short-lived multicast flows such as join requests.
If multicast traffic drops below the configured multicast rate threshold, all multicast traffic is routed by the MSFC.
This command does not affect already installed routes. For example, if you enter this command and the shortcuts are already installed, the shortcuts are not removed if they are disqualified. To apply the threshold to existing routes, clear the route and let it reestablish.
Examples
This example shows how to configure the IP MLS threshold to 10 packets per second:
Router(config)# mls ip multicast threshold 10Related Commands
mls rp ip (global configuration)
Enables external systems to establish IP shortcuts to the MSFC.
show mls ip multicast
Displays the MLS IP information.
mode bypass
To enable Virtual Multipoint Interfaces (VMI) to support multicast traffic, use the mode bypass command in interface configuration mode. To return the interface to the default mode of aggregate, use the no form of this command.
mode [aggregate | bypass]
no mode bypass
Syntax Description
aggregate
Sets the mode to aggregate. All virtual-access interfaces created by PPPoE sessions are logically aggregated under the VMI.
bypass
Sets the mode to bypass.
Command Default
No mode
Command Modes
Interface configuration
Command History
Usage Guidelines
Use the mode bypass command when you need to support multicast traffic in router-to-radio configurations.
Aggregate Mode
The default mode for operation of the VMI is aggregate mode. In aggregate mode, all of the virtual-access interfaces created by PPPoE sessions are logically aggregated under the VMI. As such, applications above Layer 2, such as, EIGRP and OSPFv3, should be defined on the VMI interface only. Packets sent to the VMI will be correctly forwarded to the correct virtual-access interface.
Bypass Mode
Using bypass mode is recommended for multicast applications.
In bypass mode, the virtual-access interfaces are directly exposed to applications running above Layer2. In bypass mode, definition of a VMI is still required because the VMI will continue to manage presentation of cross-layer signals, such as, neighbor up, neighbor down, and metrics. However, applications will still be aware on the actual underlying virtual-access interfaces and send packets to them directly.
Using bypass mode can cause databases in the applications to be larger because knowledge of more interfaces are required for normal operation.
After you enter the mode bypass command, Cisco recommends that you copy the running configuration to NVRAM. because the default mode of operation for VMI is to logically aggregate the virtual-access interfaces.
Examples
Bypass Mode on VMI Interfaces
Enabling Multicast on VMI interfaces includes changing the VMI interface to bypass mode and enabling Protocol Independent Multicast (PIM) sparse mode on the virtual-template interface.
Router# enableRouter# configure terminal!Router(config)#interface Virtual-Template1Router(config-if)#ip address 10.3.3.1 255.255.255.0Router(config-if)# load-interval 30Router(config-if)# no keepaliveRouter(config-if)# ip pim sparse-dense-modeRouter(config-if)#service-policy output FQ!!Router(config)#interface vmi1Router(config-if)#ip address 10.3.9.1 255.255.255.0Router(config-if)# load-interval 30Router(config-if)# physical-interface FastEthernet0/0Router(config-if)# mode bypass!Router(config)#endOSPF v3 Using Bypass Mode for IPv6 Multicast Traffic Example
The ipv6 ospf network point-to-multipoint command in this OSPF example is needed to allow OSPFv3 to learn dynamic metrics from the link.
version 12.4!hostname host1!enableconfigure terminal!no aaa new-modelclock timezone EST -5!!!ip cefno ip domain lookupipv6 unicast-routingipv6 cefsubscriber authorization enable!subscriber profile host1pppoe service manet_radio!multilink bundle-name authenticatedno virtual-template subinterface!!archivelog config!policy-map FQclass class-defaultfair-queue!bba-group pppoe VMI1virtual-template 1service profile host1!interface Loopback1no ip addressload-interval 30ipv6 address 2001:0DB1::1/64ipv6 enablepv6 ospf 1 area 0!interface FastEthernet0/0no ip addressno ip mroute-cacheload-interval 30speed 100full-duplexipv6 enablepppoe enable group VMI1!interface Serial1/0no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface Serial1/1no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface Serial1/2no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface Serial1/3no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface FastEthernet2/0switchport access vlan 2duplex fullspeed 100!interface FastEthernet2/1switchport access vlan 503load-interval 30duplex fullspeed 100!interface FastEthernet2/2shutdown!interface FastEthernet2/3shutdown!interface Virtual-Template1no ip addressload-interval 30ipv6 address 2001:0DB2::1/64ipv6 enable!ipv6 ospf network point-to-multipointipv6 ospf cost dynamicipv6 ospf 1 area 0no keepaliveservice-policy output FQ!interface Vlan1no ip addressno ip mroute-cacheshutdown!interface Vlan2no ip addressno ip mroute-cacheload-interval 30ipv6 address 2001:0DB5::1/64ipv6 enableipv6 ospf 1 area 0!interface Vlan503load-interval 30ipv6 address 2001:0DB8::1/64ipv6 enableipv6 ospf 1 area 0!interface vmi1no ip addressload-interval 30ipv6 enablephysical-interface FastEthernet0/0mode bypass!!no ip http serverno ip http secure-server!ipv6 router ospf 1log-adjacency-changesredistribute connected metric-type 1!!!control-plane!!line con 0exec-timeout 0 0stopbits 1line aux 0line vty 0 4login!endEIGRP IPv4 with Bypass Mode Example
In this example, the IP address of the VMI1 interface needs to be defined, but it will not be routable because the vmi interface will be configured as down/down.
version 12.4ostname host1!no aaa new-modelclock timezone EST -5ip cef!no ip domain lookupsubscriber authorization enable!subscriber profile host1pppoe service manet_radio!!multilink bundle-name authenticatedno virtual-template subinterface!archivelog config!policy-map FQclass class-defaultfair-queue!!!bba-group pppoe VMI1virtual-template 1service profile host1!!interface Loopback1ip address 10.9.1.1 255.255.255.0load-interval 30!interface FastEthernet0/0no ip addressno ip mroute-cacheload-interval 30speed 100full-duplexpppoe enable group VMI1!interface Serial1/0no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface Serial1/1no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface Serial1/2no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface Serial1/3no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface FastEthernet2/0switchport access vlan 2duplex fullspeed 100!interface FastEthernet2/1switchport access vlan 503load-interval 30duplex fullspeed 100!interface FastEthernet2/2shutdown!interface FastEthernet2/3shutdown!interface Virtual-Template1ip address 10.3.3.1 255.255.255.0load-interval 30no keepaliveservice-policy output FQ!interface Vlan1no ip addressno ip mroute-cacheshutdown!interface Vlan2ip address 10.15.60.144 255.255.255.0no ip mroute-cacheload-interval 30!interface Vlan503ip address 10.2.2.2 255.255.255.0load-interval 30ipv6 address 3514:8::1/64ipv6 enable!interface vmi1ip address 10.3.9.1 255.255.255.0load-interval 30physical-interface FastEthernet0/0mode bypass!router eigrp 1redistribute connectednetwork 10.2.0.0 0.0.255.255network 10.3.0.0 0.0.255.255EIGRP for IPv6 Example
version 12.4enableconfigure terminalip cef!!!no ip domain lookupipv6 unicast-routingipv6 cefsubscriber authorization enable!subscriber profile host1pppoe service manet_radio!multilink bundle-name authenticatedno virtual-template subinterface!!!archivelog config!!policy-map FQclass class-defaultfair-queue!!!bba-group pppoe VMI1virtual-template 1service profile host1!!interface Loopback1load-interval 30ipv6 address 2001:)DB1::1/64ipv6 enableipv6 eigrp 1!interface FastEthernet0/0no ip addressno ip mroute-cacheload-interval 30speed 100full-duplexpppoe enable group VMI1!interface Serial1/0no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface Serial1/1no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface Serial1/2no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface Serial1/3no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface FastEthernet2/0switchport access vlan 2duplex fullspeed 100!interface FastEthernet2/1switchport access vlan 503load-interval 30duplex fullspeed 100!interface FastEthernet2/2shutdown!interface FastEthernet2/3shutdown!interface Virtual-Template1no ip addressload-interval 30ipv6 address 2001:0DB2::1/64ipv6 enableipv6 eigrp 1no keepaliveservice-policy output FQ!interface Vlan1no ip addressno ip mroute-cacheshutdown!interface Vlan2no ip addressno ip mroute-cacheload-interval 30ipv6 address 2001:0DB5::1/64ipv6 enableipv6 eigrp 1!interface Vlan503no ip addressload-interval 30ipv6 address 2001:0DB8::1/64ipv6 enableipv6 eigrp 1!interface vmi1no ip addressload-interval 30ipv6 enablephysical-interface FastEthernet0/0mode bypass!!no ip http serverno ip http secure-server!ipv6 router eigrp 1no shutdownredistribute connected!!!EIGRP with IPv4 and IPv6 Traffic Using Bypass Mode Example
version 12.4T!hostname host1!enableconfigure terminalip cefno ip domain lookupipv6 unicast-routingipv6 cefsubscriber authorization enable!subscriber profile host1pppoe service manet_radio!multilink bundle-name authenticatedno virtual-template subinterface!archivelog config!!policy-map FQclass class-defaultfair-queue!bba-group pppoe VMI1virtual-template 1service profile host1!!interface Loopback1ip address 10.9.1.1 255.255.255.0load-interval 30ipv6 address 2001:0DB1::1/64ipv6 enableipv6 eigrp 1!interface FastEthernet0/0no ip addressno ip mroute-cacheload-interval 30speed 100full-duplexpppoe enable group VMI1!interface Serial1/0no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface Serial1/1no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface Serial1/2no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface Serial1/3no ip addressno ip mroute-cacheshutdownclock rate 2000000!interface FastEthernet2/0switchport access vlan 2duplex fullspeed 100!interface FastEthernet2/1switchport access vlan 503load-interval 30duplex fullspeed 100!interface FastEthernet2/2shutdown!interface FastEthernet2/3shutdown!interface Virtual-Template1ip address 10.3.3.1 255.255.255.0load-interval 30ipv6 address 2001:0DB8:0000:0000::/64ipv6 enableipv6 eigrp 1no keepaliveservice-policy output FQ!interface Vlan1no ip addressno ip mroute-cacheshutdown!interface Vlan2ip address 10.15.60.144 255.255.255.0no ip mroute-cacheload-interval 30!interface Vlan503ip address 10.2.2.2 255.255.255.0load-interval 30ipv6 address 2001:0DB8::1/64ipv6 enableipv6 eigrp 1!interface vmi1ip address 10.3.9.1 255.255.255.0load-interval 30ipv6 enablephysical-interface FastEthernet0/0mode bypass!router eigrp 1redistribute connectednetwork 10.2.0.0 0.0.255.255network 10.3.0.0 0.0.255.255auto-summary!!no ip http serverno ip http secure-server!ipv6 router eigrp 1eigrp router-id 10.9.1.1no shutdownredistribute connected!!!endRelated Commands
mrinfo
To query which neighboring multicast routers are "peering" with the local router, use the mrinfo command in user EXEC or privileged EXEC mode.
mrinfo [host-name | host-address] [source-address | interface]
Syntax Description
Defaults
The command is disabled.
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
The mrinfo command is the original tool of the multicast backbone (MBONE) to determine which neighboring multicast routers are peering with a multicast router. Cisco routers have supported responding to mrinfo requests since Cisco IOS Release 10.2.
Now you can query a multicast router using this command. The output format is identical to the multicast routed version of Distance Vector Multicast Routing Protocol (DVMRP). (The mrouted software is the UNIX software that implements DVMRP.)
Examples
The following is sample output from the mrinfo command:
Router# mrinfo192.31.7.37 (barrnet-gw.cisco.com) [version cisco 11.1] [flags: PMSA]:192.31.7.37 -> 192.31.7.34 (sj-wall-2.cisco.com) [1/0/pim]192.31.7.37 -> 192.31.7.47 (dirtylab-gw-2.cisco.com) [1/0/pim]192.31.7.37 -> 192.31.7.44 (dirtylab-gw-1.cisco.com) [1/0/pim]131.119.26.10 -> 131.119.26.9 (su-pr2.bbnplanet.net) [1/32/pim]The flags indicate the following:
•
•
•
•
mrm
To start or stop a Multicast Routing Monitor (MRM) test, use the mrm command in privileged EXEC mode.
mrm test-name {start | stop}
Syntax Description
test-name
Name of the MRM test to start or stop.
start
Starts the MRM test specified for the test-name argument.
stop
Stops the MRM test specified for the test-name argument.
Command Modes
Privileged EXEC (#)
Command History
Usage Guidelines
You must use this command to run an MRM test. When the test runs, the Test Sender sends User Datagram Protocol (UDP) or UDP/Real-Time Transport Protocol (RTP) packets (depending on the senders command) to the Test Receiver.
Examples
The following example shows how to start an MRM test. In this example, the MRM test named test1 is started.
Router# mrm test1 startRelated Commands
mstat
To display IP multicast packet rate and loss information, use the mstat command in user EXEC or privileged EXEC mode.
mstat {source-name | source-address} [destination-name | destination-address] [group-name | group-address]
Syntax Description
Defaults
The command is disabled.
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
If no arguments are entered, the router will interactively prompt you for them.
This command is a form of UNIX mtrace that reports packet rate and loss information.
Examples
The following is sample output from the mstat command in user EXEC mode:
Router> mstat lwei-home-ss2 172.16.0.1 224.0.255.255Type escape sequence to abort.Mtrace from 172.16.0.0 to 172.16.0.10 via group 224.0.255.255>From source (lwei-home-ss2.cisco.com) to destination (lwei-ss20.cisco.com)Waiting to accumulate statistics......Results after 10 seconds:Source Response Dest Packet Statistics For Only For Traffic172.16.0.0 172.16.0.10 All Multicast Traffic From 172.16.0.0| __/ rtt 48 ms Lost/Sent = Pct Rate To 224.0.255.255v / hop 48 ms --------------------- --------------------172.16.0.1 lwei-cisco-isdn.cisco.com| ^ ttl 1v | hop 31 ms 0/12 = 0% 1 pps 0/1 = --% 0 pps172.16.0.2172.16.0.3 eng-frmt12-pri.cisco.com| ^ ttl 2v | hop -17 ms -735/12 = --% 1 pps 0/1 = --% 0 pps172.16.0.4172.16.0.5 eng-cc-4.cisco.com| ^ ttl 3v | hop -21 ms -678/23 = --% 2 pps 0/1 = --% 0 pps172.16.0.6172.16.0.7 eng-ios-2.cisco.com| ^ ttl 4v | hop 5 ms 605/639 = 95% 63 pps 1/1 = --% 0 pps172.16.0.8172.16.0.9 eng-ios-f-5.cisco.com| \__ ttl 5v \ hop 0 ms 4 0 pps 0 0 pps172.16.0.0 172.16.0.10Receiver Query SourceTable 9 describes the significant fields shown in the display.
Related Commands
mtrace
Traces the path from a source to a destination branch for a multicast distribution tree.
mtrace
To trace the path from a source to a destination branch for a multicast distribution tree, use the mtrace user command in user EXEC or privileged EXEC mode.
mtrace {source-name | source-address} [destination-name | destination-address] [group-name | group-address]
Syntax Description
Defaults
The command is disabled.
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
The trace request generated by the mtrace command is multicast to the multicast group to find the last hop router to the specified destination. The trace then follows the multicast path from destination to source by passing the mtrace request packet via unicast to each hop. Responses are unicast to the querying router by the first hop router to the source. This command allows you to isolate multicast routing failures.
If no arguments are entered, the router will interactively prompt you for them.
This command is identical in function to the UNIX version of mtrace.
Examples
The following is sample output from the mtrace command in user EXEC mode:
Router> mtrace 172.16.0.0 172.16.0.10 239.254.254.254Type escape sequence to abort.Mtrace from 172.16.0.0 to 172.16.0.10 via group 239.254.254.254From source (?) to destination (?)Querying full reverse path...0 172.16.0.10-1 172.16.0.8 PIM thresh^ 0 0 ms-2 172.16.0.6 PIM thresh^ 0 2 ms-3 172.16.0.5 PIM thresh^ 0 894 ms-4 172.16.0.3 PIM thresh^ 0 893 ms-5 172.16.0.2 PIM thresh^ 0 894 ms-6 172.16.0.1 PIM thresh^ 0 893 msTable 10 describes the significant fields shown in the display.
Related Commands
receivers
To establish Test Receivers for Multicast Routing Monitor (MRM) tests or modify the parameters of Test Receivers, use the receivers command in MRM manager configuration mode. To restore the default values, use the no form of this command.
Form of the Command to Establish Test Receivers
receivers access-list sender-list access-list [packet-delay]
no receivers access-list
Form of the Command to Modify the Parameters of Test Receivers
receivers access-list [window seconds] [report-delay seconds] [loss percentage] [no-join] [monitor | poll]
no receivers access-list
Syntax Description
Command Default
No Test Receivers are configured for MRM tests.
Command Modes
MRM manager configuration (config-mrm-manager)
Command History
Usage Guidelines
This command is required for MRM to work; the receivers access-list and sender-list access-list keyword-argument pairs must be specified.
Note
Optionally, you can use the receivers command to modify the parameters for Test Receivers.
Loss percentage is calculated based on the packet-delay value of the senders command, which defaults to 200 milliseconds, or 5 packets per second. If the window keyword defaults to 5 seconds, then the Test Receiver expects 5 packets per second for 5 seconds = 25 packets. If the Test Receiver receives only 15 packets, then 25 - 15 = 10 lost packets. Lost packets divided by packets expected equals loss percentage; 10/25 equals a loss percentage of 40 percent.
Examples
The following example shows how to establish a Test Receiver for an MRM test:
ip mrm manager test1manager Ethernet0/0 group 239.1.1.1senders 1receivers 2 sender-list 1!access-list 1 permit 10.1.1.2access-list 2 permit 10.1.4.2!Related Commands
router-guard ip multicast
To enable the router guard for switch ports that are connected to multicast routers, use the router-guard ip multicast command in interface configuration mode. To disable the router guard on switch ports that are connected to multicast routers, use the no form of this command.
router-guard ip multicast [vlan vlan-id]
no router-guard ip multicast [vlan vlan-id]
Syntax Description
Command Default
The router guard for switch ports that are connected to multicast routers is disabled by default.
Command Modes
Interface configuration (config-if)
Command History
Usage Guidelines
You can enter the vlan vlan-id keyword and argument if the port is a trunk port.
You cannot enter a range or multiple VLANs in a single command.
For the router guard to work on switch ports, you must enter the router-guard ip multicast switchports global configuration command before entering the router-guard ip multicast interface configuration command.
Examples
This example shows how to enable the router guard on an interface:
Router(config-if)# router-guard ip multicastThis example shows how to disable router guard on an interface:
Router(config-if)# no router-guard ip multicast vlan 100Related Commands
router-guard ip multicast switchports
To enable the router guard on all switch ports, use the router-guard ip multicast switchports command in global configuration mode. To disable the router guard on all switch ports, use the no form of this command.
router-guard ip multicast switchports
no router-guard ip multicast switchports
Syntax Description
This command has no arguments or keywords.
Command Default
The router guard is disabled on all switch ports.
Command Modes
Global configuration (config)
Command History
Usage Guidelines
If received on a port that has router guard enabled, the following packet types are discarded and the statistics are updated indicating that packets are being dropped by the router guard:
•
•
•
•
•
•
Examples
This example shows how to enable the router guard on all switch ports:
Router(config)# router-guard ip multicast switchportsThis example shows how to disable the router guard on all switch ports:
Router(config)# no router-guard ip multicast switchportsRelated Commands
senders
To configure Test Sender parameters used for a Multicast Routing Monitor (MRM) test, use the senders command in MRM manager configuration mode. To restore the default settings, use the no form of this command.
senders access-list [packet-delay milliseconds] [rtp | udp] [target-only | all-multicasts | all-test-senders] [proxy-src]
no senders access-list
Syntax Description
Command Default
No test senders are configured to be involved in MRM tests.
Command Modes
MRM manager configuration (config-mrm-manager)
Command History
Usage Guidelines
Use this command to specify which Test Senders are involved in the test and are affected by these parameters.
Examples
The following example shows how to configure a Test Sender for an MRM test:
ip mrm manager test1manager Ethernet0/0 group 239.1.1.1senders 1receivers 2 sender-list 1!access-list 1 permit 10.1.1.2access-list 2 permit 10.1.4.2Related Commands
show ip dvmrp route
Note
To display the contents of the Distance Vector Multicast Routing Protocol (DVMRP) routing table, use the show ip dvmrp route command in user EXEC or privileged EXEC mode.
show ip dvmrp route [name | ip-address | interface-type interface-number]
Syntax Description
Command Modes
User EXEC
Privileged EXECCommand History
Examples
The following is sample output from the show ip dvmrp route command:
Router# show ip dvmrp routeDVMRP Routing Table - 1 entry172.16.0.0/16 [100/11] uptime 07:55:50, expires 00:02:52via 192.168.0.0, Tunnel3Table 11 describes the significant fields shown in the display.
Related Commands
ip dvmrp accept-filter
Configures an acceptance filter for incoming DVMRP reports.
show ip igmp groups
To display the multicast groups with receivers that are directly connected to the router and that were learned through Internet Group Management Protocol (IGMP), use the show ip igmp groups command in user EXEC or privileged EXEC mode.
show ip igmp [vrf vrf-name] groups [group-name | group-address | interface-type interface-number] [detail]
Syntax Description
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
If you omit all optional arguments and keywords, the show ip igmp groups command displays by group address, interface type, and interface number all directly connected multicast groups.
Examples
The following is sample output from the show ip igmp groups command:
Router# show ip igmp groupsIGMP Connected Group MembershipGroup Address Interface Uptime Expires Last Reporter239.255.255.254 Ethernet3/1 1w0d 00:02:19 172.21.200.159224.0.1.40 Ethernet3/1 1w0d 00:02:15 172.21.200.1224.0.1.40 Ethernet3/3 1w0d never 172.16.214.251224.0.1.1 Ethernet3/1 1w0d 00:02:11 172.21.200.11224.9.9.2 Ethernet3/1 1w0d 00:02:10 172.21.200.155232.1.1.1 Ethernet3/1 5d21h stopped 172.21.200.206The following is sample output from the show ip igmp groups command with the group-address argument and detail keyword:
Router# show ip igmp groups 192.168.1.1 detailInterface: Ethernet3/2Group: 192.168.1.1Uptime: 01:58:28Group mode: INCLUDELast reporter: 10.0.119.133CSR Grp Exp: 00:02:38Group source list: (C - Cisco Src Report, U - URD, R - RemoteS- Static, M - SSM Mapping)Source Address Uptime v3 Exp CSR Exp Fwd Flags172.16.214.1 01:58:28 stopped 00:02:31 Yes CTable 12 describes the significant fields shown in the displays.
Related Commands
show ip igmp interface
To display multicast-related information about an interface, use the show ip igmp interface command in user EXEC or privileged EXEC mode.
show ip igmp [vrf vrf-name] interface [interface-type interface-number]
Syntax Description
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
If you omit the optional arguments, the show ip igmp interface command displays information about all interfaces.
This command also displays information about dynamically learned Distance Vector Multicast Routing Protocol (DVMRP) routers on the interface.
Examples
The following is sample output from the show ip igmp interface command:
Router# show ip igmp interfaceEthernet0 is up, line protocol is upInternet address is 192.168.37.6, subnet mask is 255.255.255.0IGMP is enabled on interfaceIGMP query interval is 60 secondsInbound IGMP access group is not setMulticast routing is enabled on interfaceMulticast TTL threshold is 0Multicast designated router (DR) is 192.168.37.33No multicast groups joinedEthernet1 is up, line protocol is upInternet address is 192.168.36.129, subnet mask is 255.255.255.0IGMP is enabled on interfaceIGMP query interval is 60 secondsInbound IGMP access group is not setMulticast routing is enabled on interfaceMulticast TTL threshold is 0Multicast designated router (DR) is 192.168.36.131Multicast groups joined: 225.2.2.2 226.2.2.2Tunnel0 is up, line protocol is upInternet address is 10.1.37.2, subnet mask is 255.255.0.0IGMP is enabled on interfaceIGMP query interval is 60 secondsInbound IGMP access group is not setMulticast routing is enabled on interfaceMulticast TTL threshold is 0No multicast groups joinedTable 13 describes the significant fields shown in the display.
Related Commands
show ip igmp membership
To display Internet Group Management Protocol (IGMP) membership information for multicast groups and (S, G) channels, use the show ip igmp membership command in user EXEC or privileged EXEC mode.
show ip igmp membership [group-address | group-name] [tracked] [all]
Syntax Description
Command Modes
User EXEC (>)
Privileged EXEC (#)Command History
Usage Guidelines
Use this command to display IGMP membership information for multicast groups and (S, G) channels. This command allows you to display detailed information about multicast group and channel membership and explicit tracking.
Examples
The following is sample output from the show ip igmp membership user EXEC command. Each entry in the output shows the aggregate membership information (indicated by the A flag) for a particular multicast group or channel from the IGMP cache. If the entry is prepended with a forward slash ("/") flag, the entry is a filtering entry that is blocking the data forwarding of the multicast group or channel.
Router> show ip igmp membershipFlags:A - aggregate, T - trackedL - Local, S - static, V - virtual, R - Reported through v3I - v3lite, D - Urd, M - SSM (S,G) channel1,2,3 - The version of IGMP, the group is inChannel/Group-Flags:/ - Filtering entry (Exclude mode (S,G), Include mode (*,G))Reporter:<ip-address> - last reporter if group is not explicitly tracked<n>/<m> - <n> reporter in include mode,<m> reporter in excludeChannel/Group Reporter Uptime Exp. Flags Interface*,224.0.1.40 10.10.0.1 00:01:34 02:41 2LA Et2/0*,239.1.1.1 2/0 00:00:10 stop 3AT Et2/0The following is sample output from the show ip igmp membership user EXEC command with the multicast group address 239.1.1.1 and the tracked keyword specified:
Router> show ip igmp membership 239.1.1.1 trackedFlags:A - aggregate, T - trackedL - Local, S - static, V - virtual, R - Reported through v3I - v3lite, D - Urd, M - SSM (S,G) channel1,2,3 - The version of IGMP, the group is inChannel/Group-Flags:/ - Filtering entry (Exclude mode (S,G), Include mode (*,G))Reporter:<ip-address> - last reporter if group is not explicitly tracked<n>/<m> - <n> reporter in include mode,<m> reporter in excludeChannel/Group Reporter Uptime Exp. Flags Interface*,239.1.1.1 2/0 00:00:11 stop 3AT Et2/010.30.0.100,239.1.1.1 10.10.0.10 00:00:11 02:48 RT Et2/010.30.0.101,239.1.1.1 10.10.0.20 00:00:03 02:56 RT Et2/010.30.0.101,239.1.1.1 10.10.0.10 00:00:11 02:48 RT Et2/010.30.0.102,239.1.1.1 10.10.0.20 00:00:03 02:56 RT Et2/0Table 14 describes the significant fields shown in the displays.
Related Commands
show ip igmp snooping
To display the Internet Group Management Protocol (IGMP) snooping configuration of a device, use the show ip igmp snooping command in privileged EXEC mode.
show ip igmp snooping [groups [count] | mrouter | querier] [vlan vlan-id]
Syntax Description
Command Modes
Privileged EXEC (#)
Command History
Usage Guidelines
You can also use the show mac-address-table multicast command to display entries in the MAC address table for a VLAN that has IGMP snooping enabled.
Examples
The following is sample output from the show ip igmp snooping command:
Router# show ip igmp snoopingGlobal IGMP Snooping configuration:-----------------------------------IGMP snooping : EnabledIGMPv3 snooping (minimal) : EnabledReport suppression : EnabledTCN solicit query : DisabledTCN flood query count : 2Last Member Query Interval : 1000Vlan 1:--------IGMP snooping : EnabledIGMPv2 immediate leave : EnabledExplicit host tracking : EnabledMulticast router learning mode : pim-dvmrpLast Member Query Interval : 1000CGMP interoperability mode : IGMP_ONLYVlan 11:--------IGMP snooping : EnabledIGMPv2 immediate leave : DisabledExplicit host tracking : EnabledMulticast router learning mode : pim-dvmrpLast Member Query Interval : 1000CGMP interoperability mode : IGMP_ONLYThe information in the output display is self-explanatory.
The following is sample output from the show ip igmp snooping command using the vlan keyword:
Router# show ip igmp snooping vlan 1vlan 1----------IGMP snooping is globally enabledIGMP snooping is enabled on this VlanIGMP snooping immediate-leave is enabled on this VlanIGMP snooping mrouter learn mode is pim-dvmrp on this VlanThe information in the output display is self-explanatory.
The following is sample output from the show ip igmp snooping command using the mrouter keyword:
Note
Router# show ip igmp snooping mrouter vlan 1Vlan ports---- -----1 Fa0/2(static), Fa0/3(dynamic)The information in the output display is self-explanatory.
The following is sample output from the show ip igmp snooping command using the groups keyword:
Router #show ip igmp snooping groupsVlan Group Version Port List---------------------------------------------------------1 192.168.1.2 v2 Fa0/1/011 192.168.1.2 v2 Fa0/1/1The information in the output display is self-explanatory.
The following is sample output from the show ip igmp snooping groups command with the count keyword specified:
Router# show ip igmp snooping groups countTotal number of groups: 2The information in the output is self-explanatory.
Related Commands
show ip igmp snooping explicit-tracking
To display the information about the explicit host-tracking status for IGMPv3 hosts, use the show ip igmp snooping explicit-tracking command in user EXEC or privileged EXEC mode.
show ip igmp snooping explicit-tracking vlan vlan-id
Syntax Description
Defaults
If you do not specify a VLAN, information for VLAN 1 is displayed.
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
Examples
:This example shows how to display the information about the explicit host-tracking status for all IGMPv2 and IGMPv3 hosts:
Router# show ip igmp snooping explicit-trackingCurrent number of entries: 3 Configured DB size limit: 32000VLAN 1Source/Group Interface Reporter Filter_mode ---------------------------------------------------------------------------VLAN 2Source/Group Interface Reporter Filter_mode ---------------------------------------------------------------------------VLAN 6Source/Group Interface Reporter Filter_mode ---------------------------------------------------------------------------VLAN 7Source/Group Interface Reporter Filter_mode ---------------------------------------------------------------------------VLAN 10Source/Group Interface Reporter Filter_mode --------------------------------------------------------------------------- 0.0.0.0/224.0.1.40 Vl10: 11.10.0.2 EXCLUDE:Router#:This example shows how to display the information about the explicit host-tracking status for IGMPv2 and IGMPv3 hosts:
Router# show ip igmp snooping explicit-tracking vlan 25Source/Group Interface Reporter Filter_mode------------------------------------------------------------------------10.1.1.1/226.2.2.2 Vl25:1/2 10.27.2.3 INCLUDE10.2.2.2/226.2.2.2 Vl25:1/2 10.27.2.3 INCLUDERouter#Related Commands
show ip igmp snooping filter
To display the Internet Group Management Protocol (IGMP) filtering rules, use the show ip igmp snooping filter command in privileged EXEC mode.
show ip igmp snooping filter interface type mod/port [statistics]
Syntax Description
Command Default
This command has no default settings.
Command Modes
Privileged EXEC (#)
Command History
Usage Guidelines
IGMP filtering allows you to configure filters on a per-port basis, a per-switch virtual interface (SVI) basis, or both.
The mod/port is not supported when you enter the vlan vlan-id keyword and argument.
IGMP filtering is supported for IPv4 only.
IGMP filters is not supported on routed ports.
If the port is in the shutdown state, the system cannot determine if the port is in trunk mode or access mode, and you will not be able to display the filter status by entering the show ip igmp snooping filter command. In this case, you can enter the show running-config interface command to display the configuration.
IGMP filtering statistics are maintained for the following only:
•
•
Examples
The following example displays the default filters configured on the SVI:
Router# show ip igmp snooping filter interface vlan 20Access-Group: Channel1-AclGroups/Channels Limit: 100 (Exception List: Channel6-Acl)IGMP Minimum-Version: Not ConfiguredRouter#The following example displays the output on a switch port that is in access mode:
Router# show ip igmp snooping filter interface gigabitethernet3/48Access-Group: Channel4-AclGroups/Channels Limit: 10 (Exception List: Channel3-Acl)Router#The following example displays the filters configured for all switch ports in access mode under this SVI:
Router# show ip igmp snooping filter interface vlan 20 detailVLAN20 :Access-Group: Not ConfiguredGroups/Channels Limit: Not ConfiguredVLAN20 :Access-Group: Channel4-ACLGroups/Channels Limit: 10 (Exception-list: Channel3-Acl)Router#The following example displays the default trunk port filters:
Router# show ip igmp snooping filter interface gigabitethernet3/46Access-Group: Channel1-AclGroups/Channels Limit: 10 (Exception List: Channel3-Acl)Router#The following example displays the per-VLAN filters for all VLANs on this trunk:
Router# show ip igmp snooping filter interface gigabitethernet3/46 detailVlan 10 :Access-Group: Not ConfiguredGroups/Channels Limit: Not ConfiguredVlan 20 :Access-Group: Not ConfiguredGroups/Channels Limit: 8 (Exception List: Channel4-Acl)Router#The following example displays the output on a trunk port for a specific VLAN:
Router# show ip igmp snooping filter interface gigabitethernet3/46 vlan 20Access-Group: Not ConfiguredGroups/Channels Limit: 8 (Exception List: Channel4-Acl)Router#The following example displays the statistics for each switch port in access mode under the SVI:
Router# show ip igmp snooping filter interface vlan 20 statisticsGigabitEthernet3/47 :IGMP Filters are not configuredGigabitEthernet3/48 :Access-group denied : 0Limit denied : 2Limit status : 0 active out of 2 maxMinimum-version denied : 0Table 15 describes the significant fields shown in the displays.
Related Commands
show ip igmp snooping mrouter
Note
To display information on dynamically learned and manually configured multicast router ports, use the show ip igmp snooping mrouter command in privileged EXEC mode.
show ip igmp snooping mrouter [vlan vlan-id]
Syntax Description
Command Modes
Privileged EXEC
Command History
Usage Guidelines
You can also use the show mac-address-table multicast command to display entries in the MAC address table for a VLAN that has Internet Group Management Protocol (IGMP) snooping enabled.
Examples
The following is sample output from the show ip igmp snooping mrouter vlan 1 command:
Note
Router# show ip igmp snooping mrouter vlan 1Vlan ports---- -----1 Fa0/2(static), Fa0/3(dynamic)Related Commands
show ip igmp snooping rate-limit
To display the information about the IGMP-snooping rate limit, use the show ip igmp snooping rate-limit command in user EXEC or privileged EXEC mode.
show ip igmp snooping rate-limit [statistics | vlan vlan-id]
Syntax Description
statistics
(Optional) Displays IGMP-snooping statistics.
vlan vlan-id
(Optional) Specifies a VLAN; valid values are from 1 to 4094.
Defaults
This command has no default settings.
Command Modes
User EXEC
Privileged EXECCommand History
12.2(17a)SX
Support for this command was introduced on the Supervisor Engine 720.
Usage Guidelines
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
Examples
This example shows how to display the statistics for IGMP-snooping rate limiting:
Router# show ip igmp snooping rate-limit statisticsMax IGMP messages incoming rate : Not configuredVlan Incoming rate Rate-limiting ON Disable count Time to Enable-----+---------------+----------------+---------------+---------------+222 1000 No 0111 5999 Yes 3 185This example shows how to display IGMP-snooping rate-limit information for a specific VLAN:
Router# show ip igmp snooping rate-limit vlan 19Max IGMP messages incoming rate : 200 ppsVlan Incoming IGMP rate (in pps)--------+---------------------------------19 200Related Commands
show ip igmp snooping statistics
To display IGMPv3 statistics, use the show ip igmp snooping statistics command in user EXEC or privileged EXEC mode.
show ip igmp snooping statistics [interface type [number]} | port-channel number | vlan vlan-id]
Syntax Description
Defaults
This command has no default settings.
Command Modes
User EXEC
Privileged EXECCommand History
12.2(14)SX
Support for this command was introduced on the Supervisor Engine 720.
Usage Guidelines
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
The show ip igmp snooping statistics command displays the following statistics:
•
•
•
•
The number argument designates the module and port number. Valid values for number depend on the specified interface type and the chassis and module that are used. For example, if you specify a Gigabit Ethernet interface and have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot chassis, valid values for the module number are from 1 to 13 and valid values for the port number are from 1 to 48.
The port-channel number values from 257 to 282 are supported on the CSM and the FWSM only.
The #hosts behind the VLAN is displayed only if you define the max-hosts policy on the specified VLAN and enable the log policy for the specified VLAN.
Examples
This example shows how to display IGMPv3 statistics:
Router# show ip igmp snooping statistics interface FastEthernet5/1IGMP Snooping statisticsService-policy: Policy1policy tied with this interface#Channels: 3#hosts : 3Query Rx: 2901 GS Query Rx: 0 V3 Query Tot Rx: 0Join Rx: 8686 Leave Rx: 0 V3 Report Rx: 2300Join Rx from router ports: 8684 Leave Rx from router ports: 0Total Rx: 11587Channel/Group Interface Reporter Uptime Last-Join Last-Leave10.7.20.1,239.1.1.1 F5/1 10.5.20.1 00:12:00 1:10:00 -10.7.30.1,239.1.1.1 F5/1 10.5.30.1 00:50:10 1:10:02 0:30:0210.7.40.1,239.1.1.1 F5/1 10.5.40.1 00:10:10 1:10:03 -Table 16 describes the fields that are shown in the example.
Related Commands
show ip igmp snooping subscriber-rate
To display the total rate subscribed by the host, use the show ip igmp snooping subscriber-rate command in user EXEC or privileged EXEC mode.
show ip igmp snooping subscriber-rate ip-address
Syntax Description
Defaults
This command has no default settings.
Command Modes
User EXEC
Privileged EXECCommand History
12.2(33)SXI
Support for this command was introduced on the Supervisor Engine 720.
Examples
This example shows how to display the total rate subscribed for IP address 10.10.10.10:
Router# show ip igmp snooping subscriber-rate 10.10.10.10200.0.0.15/232.1.1.1 Vl15:Gi2/13 10.10.10.10 248 pps/91 kbps (1 sec)200.0.0.16/232.1.1.1 Vl15:Gi2/13 10.10.10.10 248 pps/91 kbps (1 sec)200.0.0.17/232.1.1.1 Vl15:Gi2/13 10.10.10.10 247 pps/91 kbps (1 sec)200.0.0.18/232.1.1.1 Vl15:Gi2/13 10.10.10.10 248 pps/91 kbps (1 sec)200.0.0.19/232.1.1.1 Vl15:Gi2/13 10.10.10.10 248 pps/91 kbps (1 sec)200.0.0.20/232.1.1.1 Vl15:Gi2/13 10.10.10.10 248 pps/91 kbps (1 sec)--------------------------Total = 1487 pps/546 kbps (1 sec)Router#Related Commands
