Ipv4 Multicast Protocol

Table of Contents

10.1 IPv4 Multicast Protocol

10.1.1 Public Commands for Multicast

10.1.1.1 show ip mroute

Command: show ip mroute [<GroupAddr> [<SourceAddr>]] Function: Show the IPv4 software multicast route table.
Parameters:

  • <GroupAddr>: show the multicast entries relative to this Group address.
  • <SourceAddr>: show the multicast route entries relative to this source address.

Command mode: Admin mode and Global Mode
Default: None.
Usage guide: Show the IPv4 software multicast route table.
Example: Show all entries of the multicast route table.

active500EM(config)#show ip mroute
Name: Loopback, Index: 2002, State:49
Name: null0, Index: 2003, State:49
Name: sit0, Index: 2004, State:80
Name: Vlan1, Index: 2005, State:1043
Name: Vlan2, Index: 2006, State:1002
Name: PIMreg, Index: 2007, State:c1
The total matched ipmr active mfc entries is 1, unresolved ipmr entries is 0
Group           Origin          Iif              Wrong     Oif:TTL
225.1.1.1       192.168.1.136   vlan1              0       2006:1
Displayed information Explanation
Name Interface name
Index Interface index number
State Interface state
The total matched ipmr active mfc entries The total matched active IP multicast route mfc?multicast forwarding cache? entries
unresolved ipmr entries Unresolved ip multicast route entries
Group Destination address of the entries
Origin Source address of the entries
Iif Ingress interface of the entries
Wrong Packets received from the wrong interface
Oif Egress interface of the entries
TTL Total value

 

10.1.2 Commands for PIM-DM

10.1.2.1 debug PIM timer sat

Command: debug PIM timer sat
no debug PIM timer sat
Function: Enable PIM-DM source activity timer debug. The no command disables the debug.
Parameters: None.
Command mode: Admin Mode
Default: Disabled.
Usage guide: Enable PIM-DM source activity timer debug.
Note: Other debug switches in PIM-DM are common in PIM-SM, including debug PIM event, debug PIM packet, debug PIM nexthop, debug PIM nsm, debug PIM mfc, debug PIM timer, and debug PIM state.
Example: Enable PIM-DM source activity timer debug.

active500EM#debug ip PIM timer sat

 

10.1.2.2 debug PIM timer srt

Command: debug PIM timer srt
no debug PIM timer srt
Function: Enable PIM-DM state-refresh timer debug. The no command disables the debug.
Parameters: None.
Command mode: Admin Mode
Default: Disabled.
Usage guide: Enable PIM-DM state-refresh timer debug. Other debug switches in PIM-DM are common in PIM-SM, including debug PIM event, debug PIM packet, debug PIM nexthop, debug PIM nsm, debug PIM mfc, debug PIM timer, and debug PIM state.
Example: Enable PIM-DM state-refresh timer debug.

active500EM#debug ip PIM timer srt

 

10.1.2.3 ip mroute

Command: ip mroute <A.B.C.D> <A.B.C.D> <ifname> <.ifname>
no ip mroute <A.B.C.D> <A.B.C.D> [<ifname> <.ifname>]
Function: Configure static multicast entry. The no command will delete some static multicast entries or some egress interfaces.
Parameters:

  • <A.B.C.D> <A.B.C.D>: multicast source address and group address.
  • <ifname> <.ifname>: ingress interface/egress interface.

Command mode: Global Mode
Default: None.
Usage guide: The <ifname> should be valid VLAN interfaces. The multicast data flow will not be forwarded unless PIM is configured on the egress interface and the interface is up. If the state of the interface is not up, PIM is not configured, or RPF is not valid, the multicast data flow will not be fordwarded. If all the egress interfaces are specified or no interfaces are specified, the specified multicast routing entry will be removed. Otherwise, the multicast routing entry for the specified interface will be removed.
Example: Configure static multicast entry.

active500EM(config)#ip mroute 10.1.1.1 225.1.1.1 v10 v20 v30

 

10.1.2.4 ip PIM bsr-border

Command: ip PIM bsr-border
no ip PIM bsr-border
Function: Configure or delete the PIM BSR-BORDER interface.
Parameters: None.
Command mode: Interface Configuration Mode
Default: Non-BSR-BORDER.
Usage guide: Configure the interface as the BSR-BORDER. If configured, BSR related messages will not be received from or sent to the specified interface. All the networks connected to the interface will be considered to be directly connected.
Example: Configure the PIM BSR-BORDER interface.

active500EM(config-if-vlan1)#ip PIM bsr-border

 

10.1.2.5 ip PIM dense-mode

Command: ip PIM dense-mode
no ip PIM dense-mode
Function: Enable PIM-DM protocol on the interface. The no command disables PIM-DM protocol on the interface.
Parameters: None.
Command mode: Interface Configure Mode
Default: Disable PIM-DM protocol.
Usage guide: The command will take effect when executing?IP multicast-routing in Global Mode. The command doesn?t support multicast protocol mutual operation. It can?t simultaneously enable dense mode and sparse mode in one switch.
Example: Enable PIM-DM protocol on interface vlan1.

active500EM(config)#ip PIM multicast-routing
active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip PIM dense-mode

 

10.1.2.6 ip PIM dr-priority

Command: ip PIM dr-priority <priority>
no ip PIM dr-priority
Function: Configure, disable, or change the interface?s DR priority. The neighboring nodes in the same net segment select the DR in their net segment according to hello packets. The no command restores the default value.
Parameters:

  • <priority>: priority. The valid range is from 0 to 4294967294. The higher the value, the greater the priority.

Command mode: Interface Configuration Mode
Default: 1.
Usage guide: Configure, disable, or change the interface?s DR priority.
Example: Configure VLAN?s DR priority to 100.

active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip PIM dr-priority 100

 

10.1.2.7 ip PIM exclude-genid

Command: ip PIM exclude-genid
no ip PIM exclude-genid
Function: Configure the hello packets sent by PIM SM to not include the GenId option. The no command restores the default value.
Parameters: None.
Command mode: Interface Configuration Mode
Default: The hello packets include the GenId option.
Usage guide: This command is used to in association with older Cisco IOS versions.
Example: Configure the hello packets sent by the switch to not include the GenId option.

active500EM(config-if-vlan1)#ip PIM exclude-genid

 

10.1.2.8 ip PIM hello-holdtime

Command: ip PIM hello-holdtime <value>
no ip PIM hello-holdtime
Function: Configure or disable the holdtime option in the hello packets. This value describes neighbor holdtime. If the switch hasn?t received the neighbor hello packets when the holdtime is over, this neighbor is deleted. The no command cancels configured holdtime value and restores the default value.
Parameters:

  • <value>: holdtime value.

Command mode: Interface Configuration Mode
Default: The default value of holdtime is 3.5 multiplied by the hello-interval. Hello-interval?s default value is 30s, so holdtime?s default value is 105s.
Usage guide: If this value is not configured, hellotime?s default value is 3.5 multiplied by the Hello-interval. If the configured holdtime is less than the current hello-interval, the configuration is denied. Every time hello-interval is updated, the hello-holdtime will update according to the following rules: If hello-holdtime is not configured or hello-holdtime is configured but less than the current hello-interval, hello-holdtime is modified to 3.5*hello-interval. Otherwise, the configured value is maintained.
Example: Configure vlan1?s hello holdtime.

active500EM(config)#interface vlan1
active500EM(config-if-vlan1)#ip PIM hello-holdtime 10

 

10.1.2.9 ip PIM hello-interval

Command: ip PIM hello-interval < interval>
no ip PIM hello-interval
Function: Configure the interface PIM-DM hello message interval. The no command restores the default value.
Parameters:

  • < interval>: interval of periodically transmitted PIM-DM hello messages. The valid range is from 1s to 18724s.

Command mode: Interface Configuration Mode
Default: 30 seconds.
Usage guide: Hello messages set the PIM-DM switch as a mutual location and ensure neighborship. The PIM-DM switch announces its existence by periodically transmitting hello messages to neighbors. If it doesn?t receive hello messages from neighbors within the set interval, it confirms that the neighbors were lost.
Example: Configure the PIM-DM hello interval on interface vlan1.

active500EM(config)#interface vlan1
active500EM(config-if-vlan1)#ip PIM hello-interval 20

 

10.1.2.10 ip PIM multicast-routing

Command: ip PIM multicast-routing
no ip PIM multicast-routing
Function: Enable PIM-SM globally. The no command disables PIM-SM globally.
Parameters: None.
Command mode: Global Mode
Default: Disabled.
Usage guide: Enable PIM-SM globally. The interface must enable PIM-SM in order for PIM-SM to function.
Example: Enable PIM-SM globally.

active500EM(config)#ip PIM multicast-routing

 

10.1.2.11 ip PIM neighbor-filter

Command: ip PIM neighbor-filter <list-number>
no ip PIM neighbor-filter <list-number>
Function: Configure the neighbor access-list. Previously created connections will be deleted if they do not pass the filter.
Parameters:

  • <list-number>: simple access-list number. The valid range is from 1 to 99.

Command mode: Interface Configuration Mode
Default: No neighbor filter configuration.
Usage guide: ACL?s default is deny. If configuring access-list 1, access-list 1?s default is set to deny. In the following example, if ?permit any-source? is not configured, deny 10.1.4.10 0.0.0.255 is the same as deny any-source.
Example: Configure VLAN?s filtering rules of PIM neighbors.

active500EM#show ip PIM neighbor
Neighbor          Interface          Uptime/Expires    Ver   DR
Address                                                      Priority/Mode
10.1.4.10         Vlan1              02:30:30/00:01:41 v2    4294967294 / DR
active500EM(config-if-vlan1)#ip PIM neighbor-filter 2
active500EM(config)#access-list 2 deny 10.1.4.10 0.0.0.255
active500EM(config)#access-list 2 permit any-source
active500EM(config)#show ip PIM neighbor
active500EM(config)#

 

10.1.2.12 ip PIM scope-border

Command: ip PIM scope-border [<1-99 >|<acl-name>] no ip PIM scope-border
Function: Configure or delete the PIM management border.
Parameters:

  • <1-99 >: ACL number for the management border.
  • <acl-name>: ACL name for the management border.

Command mode: Interface Configuration Mode
Default: No management border. If no ACL is specified, the default management border will be used.
Usage guide: Configure the management border and the ACL for the PIM protocol. The multicast data flow will not be forwarded to the SCOPE-BORDER.
Example: Configure or delete the PIM management border.

active500EM(config-if-vlan2)#ip PIM scope-border 3

 

10.1.2.13 ip PIM state-refresh origination-interval

Command: ip PIM state-refresh origination-interval <interval>
no ip PIM state-refresh origination-interval
Function: Configure the state-refresh message transmission interval. The no command restores the default value.
Parameters:

  • <interval>: packet transmission interval. The valid value is from 4s to 100s.

Command mode: Global Mode
Default: 60s.
Usage guide: The first-hop router periodically transmits stat-refresh messages to maintain PIM-DM list items for all the downstream routers. This command can modify state-refresh messages origination interval. The relevant timer interval is usually not modified.
Example: Configure the state-refresh message transmission interval to 90s.

active500EM(config)#ip PIM state-refresh origination-interval 90

 

10.1.2.14 show ip PIM interface

Command: show ip PIM interface
Function: Display PIM interface information.
Parameters: None.
Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: Display PIM interface information.
Example: Display PIM interface information.

active500EM(config)#show ip PIM interface
Address          Interface VIFindex Ver/   Nbr    DR    DR
                                    Mode   Count  Prior
10.1.4.3         Vlan1     0        v2/S   1      1     10.1.4.3
10.1.7.1         Vlan2     2        v2/S   0      1     10.1.7.1
Displayed Information Explanation
Address Interface address
Interface Interface name
VIF index Interface index
Ver/Mode PIM version and mode, usually v2, sparse mode displays S, dense mode displays D
Nbr Count The interface?s neighbor count
DR Prior Dr priority
DR The interface?s DR address

 

10.1.2.15 show ip PIM mroute dense-mode

Command: show ip PIM mroute dense-mode [group <A.B.C.D>] [source <A.B.C.D>] Function: Display PIM-DM message forwarding items.
Parameters:

  • group <A.B.C.D>: displays forwarding items relevant to this multicast address.
  • source <A.B.C.D>: displays forwarding items relevant to this source.

Command mode: Admin Mode
Default: Do not display (Off).
Usage guide: The command shows PIM-DM multicast forwarding items. Namely, it displays forwarding items of forward multicast packets in the system FIB table.
Example: Display all of PIM-DM message forwarding items.

active500EM(config)#show ip PIM mroute dense-mode
IP Multicast Routing Table
(*,G) Entries: 1
(S,G) Entries: 1
(*, 226.0.0.1)
 Local     ..l.............................
(192.168.1.12, 226.0.0.1)
RPF nbr: 0.0.0.0
RPF idx: Vlan2
Upstream State: FORWARDING
Origin State: ORIGINATOR
 Local     ................................
 Pruned    ................................
 Asserted  ................................
 Outgoing  ..o.............................
Displayed Information Explanation
(*,226.0.0.1) (*,G) Forwarding item
(192.168.1.12, 226.0.0.1) (S,G) Forwarding item
RPF nbr Backward path neighbor, upstream neighbor of source direction in DM, 0.0.0.0 expresses the switch is the first hop.
RPF idx Interface located in the RPF neighbor
Upstream State Upstream direction, including FORWARDING(forwarding upstream data), PRUNED(Upstream stops forwarding data), ACKPENDING(waiting for upstream response, forwarding upstream data)
Origin State The two states: ORIGINATOR(on transmit state-refresh state), NON-ORIGINATOR(on non-transmit state-refresh state)
Local Local position joins the interface, the interface receives IGMP Join
Pruned PIM prunes the interface, the interface receives Prune messages
Asserted Asserted state
Outgoing Multicast data exported from the interface is an index number (the index is 2 in this case). Interface information can be shown in detail by using the command show ip PIM interface

 

10.1.2.16 show ip PIM neighbor

Command: show ip PIM neighbor
Function: Display router neighbors.
Parameters: None.
Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: Display multicast router neighbors maintained by the PIM.
Example: Display multicast router neighbors maintained by the PIM.

active500EM(config)#show ip PIM neighbor
Neighbor          Interface          Uptime/Expires    Ver   DR
Address                                                      Priority/Mode
10.1.6.1          Vlan1              00:00:10/00:01:35 v2    1 /
10.1.6.2          Vlan1              00:00:13/00:01:32 v2    1 /
10.1.4.2          Vlan3              00:00:18/00:01:30 v2    1 /
10.1.4.3          Vlan3              00:00:17/00:01:29 v2    1 /
Displayed Information Explanation
Neighbor Address Neighbor address
Interface Neighbor interface
Uptime/Expires Running time /overtime
Ver PIM version (usually v2)
DR Priority/Mode DR priority in the hello messages from the neighbor. Also shows whether the neighbor is the interface?s DP.

 

10.1.2.17 show ip PIM nexthop

Command: show ip PIM nexthop
Function: Display the PIM buffered nexthop router in the unicast route table.
Parameters: None.
Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: Display the PIM buffered nexthop router information.
Example: Display the PIM buffered nexthop router information.

active500EM(config)#show ip PIM nexthop
Flags: N = New, R = RP, S = Source, U = Unreachable
Destination     Type  Nexthop  Nexthop      Nexthop  Nexthop Metric Pref   Refcnt
                       Num      Addr        Ifindex   Name
192.168.1.1     N...   1       0.0.0.0       2006              0      0      1
192.168.1.9     ..S.   1       0.0.0.0       2006              0      0      1
Displayed Information Explanation
Destination Destination of next item.
Type N: created nexthop, RP direction and S direction are not determined. R: RP derection. S: source direction. U: can?t be reached.
Nexthop Num Nexthop number.
Nexthop Addr Nexthop address.
Nexthop Ifindex Nexthop interface index.
Nexthop Name Nexthop name.
Metric Metric to nexthop.
Pref Preference Route preference.
Refcnt Reference count.

 

10.1.3 Commands for PIM-SM

10.1.3.1 clear ip PIM bsr rp-set

Command: clear ip PIM bsr rp-set
Function: Clear all RP.
Parameters: None.
Command mode: Admin Configuration Mode
Default: None.
Usage guide: Clear all RP.
Example: Clear all RP.

active500EM#clear ip PIM bsr rp-set

Related Command: show ip PIM bsr-router
 

10.1.3.2 debug PIM event

Command: debug PIM event
no debug PIM event
Function: Enable or disable the PIM event debug switch.
Parameters: None.
Command mode: Admin Mode
Default: Disabled.
Usage guide: Enable the PIM event debug switch and display event information regarding PIM.
Example: Enable the PIM event debug switch and display event information regarding PIM.

active500EM#debug PIM event

 

10.1.3.3 debug PIM mfc

Command: debug PIM mfc
no debug PIM mfc
Function: Enable or disable the PIM mfc debug switch.
Parameters: None.
Command mode: Admin Mode
Default: Disabled.
Usage guide: Enable the PIM mfc debug switch and display generated and transmitted multicast ID information.
Example: Enable the PIM mfc debug switch and display generated and transmitted multicast ID information.

active500EM#debug PIM mfc

 

10.1.3.4 debug PIM mib

Command: debug PIM mib
no debug PIM mib
Function: Enable or disable the PIM MIB debug switch.
Parameters: None.
Command mode: Admin Mode
Default: Disabled.
Usage guide: Display the PIM MIB information using the PIM MIB debug switch.
Example: Display the PIM MIB information using the PIM MIB debug switch.

active500EM#debug PIM mib

 

10.1.3.5 debug PIM nexthop

Command: debug PIM nexthop
no debug PIM nexthop
Function: Enable or disable the PIM nexthop debug switch.
Parameters: None.
Command mode: Admin Mode
Default: Disabled.
Usage guide: Display the PIM NEXTHOP information that was changed by the PIM nexthop switch.
Example: Enable the PIM nexthop debug switch.

active500EM#debug PIM nexthop

 

10.1.3.6 debug PIM nsm

Command: debug PIM nsm
no debug PIM nsm
Function: Enable or disable the PIM debug switch communicating with Network Services.
Parameters: None.
Command mode: Admin Mode
Default: Disabled.
Usage guide: Display the information communicated between PIM and Network Services by this switch.
Example: Enable or disable the PIM debug switch communicating with Network Services.

active500EM#debug PIM nsm

 

10.1.3.7 debug PIM packet

Command: debug PIM packet [in | out] no debug PIM packet [in | out]
Function: Enable or disable the PIM debug switch.
Parameters:

  • in: display only received PIM packets.
  • out: display only transmitted PIM packets.
  • none: display both.

Command mode: Admin Mode
Default: Disabled.
Usage guide: Inspect the received and transmitted PIM packets.
Example: Enable the PIM debug switch to display only received PIM packets.

active500EM#debug PIM packet in

 

10.1.3.8 debug PIM state

Command: debug PIM state
no debug PIM state
Function: Enable or disable the PIM debug switch.
Parameters: None
Command mode: Admin Mode
Default: Disabled.
Usage guide: Display the updated information regarding the PIM state.
Example: Enable the PIM debug switch.

active500EM#debug PIM state

 

10.1.3.9 debug PIM timer

Command: debug PIM timer
debug PIM timer assert [at] debug PIM timer bsr [bst|crp] debug PIM timer hello [ht|nlt|tht] debug PIM timer joinprune [et|grt|jt|kat|ot|plt|ppt|pt] debug PIM timer register [rst] no debug PIM timer
no debug PIM timer assert [at] no debug PIM timer bsr [bst|crp] no debug PIM timer hello [ht|nlt|tht] no debug PIM timer joinprune [et|grt|jt|kat|ot|plt|ppt|pt] no debug PIM timer register [rst] Function: Enable or disable each PIM timer.
Parameters:

  • assert: Assert Timers.
    • at: assert timer.
  • bsr: BSR Timers.
    • bst: Bootstrap timer.
    • crp: Candidate-RP timer.
  • hello: Hello Timers.
    • ht: Hello timer.
    • nlt: Neighbor Liveliness timer.
    • tht: Triggered Hello timer.
  • joinprune: JoinPrune Timers.
    • et: Expiration timer.
    • grt: Graft Retry timer.
    • jt: JoinPrune timer.
    • kat: Keep Alive timer.
    • ot: Override timer.
    • plt: Prune Limit timer.
    • ppt: Prune Pending timer.
    • pt: Prune timer.
  • register: Register Timers.
    • rst: Register Stop timer.

Command mode: Admin Mode
Default: Disabled.
Usage guide: Enable the specified timer?s debug information.
Example: Enable the Assert Timers? debug information.

active500EM#debug PIM timer assert

 

10.1.3.10 ip mroute

Command: ip mroute <A.B.C.D> <A.B.C.D> <ifname> <.ifname>
no ip mroute <A.B.C.D> <A.B.C.D> [<ifname> <.ifname>]
Function: Configure static multicast entry. The no command deletes identified static multicast entries or egress interfaces.
Parameters:

  • <A.B.C.D> <A.B.C.D>: multicast source address and group address.
  • <ifname> <.ifname>: ingress interface/egress interface.

Command mode: Global Mode
Default: None.
Usage guide: The <ifname> should be valid VLAN interfaces. The multicast data flow will not be forwarded unless PIM is configured on the egress interface and the interface is up. If the state of the interface is not up, PIM is not configured, or RPF is not valid, the multicast data flow will not be fordwarded. If all the egress interfaces are specified, or no interfaces are specified, the specified multicast routing entry will be removed. Otherwise the multicast routing entry for the specified interface will be removed.
Example: Configure the static multicast entry.

active500EM(config)#ip mroute 10.1.1.1 225.1.1.1 v10 v20 v30

 

10.1.3.11 ip multicast unresolved-cache aging-time

Command: ip multicast unresolved-cache aging-time <value>
no ip multicast unresolved-cache aging-time
Function: Configure the cache time of the kernel multicast route. The no command restores the default value.
Parameters:

  • < value>: configured cache time. The valid range is between 1 and 20s.

Command mode: Global Configuration Mode
Default: 10s.
Usage guide: Configure the cache time of the multicast route entry in the kernel.
Example: Configure the cache time of the kernel multicast route.

active500EM(config)#ip multicast unresolved-cache aging-time 18

 

10.1.3.12 ip PIM accept-register

Command: ip PIM accept-register list <list-number>
no ip PIM accept-register
Function: Filter the specified multicast group and multicast address.
Parameters:

  • <list-number>: access-list number. The valid range is from 100 to 199.

Command mode: Global Mode
Default: Permit the multicast registers from any sources to any groups.
Usage guide: This command is used to configure the access-list filtering the PIM?register packets. The addresses of the access-list respectively indicate the filtered multicast sources and multicast groups? information. For the source-group combinations that match deny, PIM sends REGISTER-STOP immediately and does not create group records when receiving?register packets. Unlike other access-lists, when the access-list is configured, the default value is permit.
Example: Configure the filtered register message?s rule to myfilter.

active500EM(config)#ip PIM accept-register list 120
active500EM(config)#access-list 120 deny ip 10.1.0.2 0.0.0.255 239.192.1.10  0.0.0.255

 

10.1.3.13 ip PIM bsr-border

Command: ip PIM bsr-border
no ip PIM bsr-border
Function: Configure or delete the PIM BSR-BORDER interface.
Parameters: None.
Command mode: Interface Configuration Mode
Default: Non-BSR-BORDER.
Usage guide: Configure the interface as the BSR-BORDER. If configured, BSR related messages will not be received from or be sent to the specified interface. All the networks connected to the interface will be considered to be directly connected.
Example: Configure the PIM BSR-BORDER interface.

active500EM(config-if-vlan1)#ip PIM bsr-border

 

10.1.3.14 ip PIM bsr-candidate

Command: ip PIM bsr-candidate {vlan <vlan-id>| <IFNAME>} [hash-mask-length] [priority] no ip PIM bsr-candidate
Function: This command is the candidate BSR configure command in Global Mode and is used to configure PIM-SM information about candidate BSR in order to compete with other candidate BSRs for the BSR router. The no command disables the candidate BSR.
Parameters:

  • <vlan-id>: VLAN number; valid range is 1-4094.
  • <IFNAME>: specified interface name.
  • [hash-mask-length]: specified hash-mask length for RP enable selection and the valid range is from 0 to 32.
  • [priority]: candidate BSR priority. The valid range is from 0 to 255. If this parameter is not configured, the default priority value is 0.

Command mode: Global Mode
Default: This switch is not a candidate BSR router.
Usage guide: This command is the candidate BSR configure command in Global Mode. It is used to configure PIM-SM information about candidate BSR in order to compete with other candidate BSRs for the BSR router. Once this command is configured, this switch is the BSR candidate router.
Example: Globally configure the interface vlan1 as the candidate BSR-message transmitting interface.

active500EM(config)#ip PIM bsr-candidate vlan1 30 10

 

10.1.3.15 ip PIM cisco-register-checksum

Command: ip PIM cisco-register-checksum [group-list <simple-acl>] no ip PIM cisco-register-checksum [group-list <simple-acl>]
Function: Configure the register packet?s checksum of the group specified by myfilter to use the whole packet?s length. Compute the checksum according to the register packet?s head length, default: 8
Parameters:

  • <simple-acl>: simple access-list; valid range <1-99>.

Default: None.
Usage guide: This command is used to communicate with the older Cisco IOS version.
Example: Configure the register packet?s checksum of the group specified by myfilter to use the whole packet?s length.

active500EM(config)#ip PIM cisco-register-checksum group-list 23

 

10.1.3.16 ip PIM dr-priority

Command: ip PIM dr-priority <priority>
no ip PIM dr-priority
Function: Configure, disable, or change the interface?s DR priority. The no command restores the default value.
Parameters:

  • <priority>: priority. The valid range is from 0 to 4294967294. The higher the value, the greater the priority.

Command mode: Interface Configuration Mode
Default: 1.
Usage guide: Configure, disable, or change the interface?s DR priority. The neighboring nodes in the same net segment select the DR in their net segment according to the hello packets.
Example: Configure the DR priority for VLAN 1 to 100

active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip PIM dr-priority 100

 

10.1.3.17 ip PIM exclude-genid

Command: ip PIM exclude-genid
no ip PIM exclude-genid
Function: This command makes the Hello packets sent by PIM SM to not include the GenId option. The no command restores the default value.
Parameters: None.
Command mode: Interface Configuration Mode
Default: The hello packets include the GenId option.
Usage guide: This command is used in order to communicate with older Cisco IOS versions.
Example: Configure the hello packets sent by the switch so they do not include the GenId option.

active500EM(config-if-vlan1)#ip PIM exclude-genid

 

10.1.3.18 ip PIM hello-holdtime

Command: ip PIM hello-holdtime <value>
no ip PIM hello-holdtime
Function: Configure or disable the Holdtime option in the hello packets. This value describes neighbor holdtime. If the switch hasn?t received the neighbor hello packets when the holdtime is over, this neighbor is deleted. The no command cancels configured holdtime value and restores the default value.
Parameters:

  • <value>: holdtime value.

Command mode: Interface Configuration Mode
Default: The default value of Holdtime is 3.5*Hello-interval, Hello-interval?s default value is 30s, so Holdtime?s default value is 105s.
Usage guide: If this value is not configured, hellotime?s default value is 3.5*hello-interval. If the configured holdtime is less than the current hello-interval, this configuration is denied. Every time hello-interval is updated, the hello-holdtime will update according to the following rules: If hello-holdtime is not configured or hello-holdtime is configured but less than current hello-interval, hello-holdtime is modified to 3.5*hello-interval, otherwise the configured value is maintained.
Example: Configure hello holdtime for vlan1 to 10.

active500EM(config)#interface vlan1
active500EM(config-if-vlan1)#ip PIM hello-holdtime 10

 

10.1.3.19 ip PIM hello-interval

Command: ip PIM hello-interval <interval>
no ip PIM hello-interval
Function: Configure the interface?s hello-interval of PIM hello packets. The no command restores the default value.
Parameters:

  • <interval>: hello-interval of periodically transmitted PIM hello packets. The valid range is from 1 to 18724s.

Command mode: Interface Configuration Mode
Default: The default periodically transmitted PIM hello packet’s hello-interval is 30s.
Usage guide: Hello messages allow PIM switches to set neighbor relationships. The PIM switch announces itself by periodically transmitting hello messages to neighbors. If no hello messages from neighbors are received within a certain time, the neighbor is considered lost. This value can?t be greater than neighbor overtime.
Example: Configure the VLAN?s PIM-sm hello interval.

active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip PIM hello-interval 20

 

10.1.3.20 ip PIM ignore-rp-set-priority

Command: ip PIM ignore-rp-set-priority
no ip PIM ignore-rp-set-priority
Function: When RP selection is carried out, this command configures the switch to enable Hashing regulation and ignore RP priority. This command is used in the communication with older Cisco IOS versions.
Parameters: None.
Command mode: Global Mode
Default: Disabled.
Usage guide: When selecting RP, PIM usually will select according to the RP priority. When this command is configured, PIM will not select according to the RP priority. Unless there are older routers in the network, this command is not recommended.
Example: When RP selection is carried out, this command configures the switch to enable Hashing regulation and ignore RP priority.

active500EM(config)#ip PIM ignore-rp-set-priority

 

10.1.3.21 ip PIM jp-timer

Command: ip PIM jp-timer <value>
no ip PIM jp-timer
Function: Configure to add a JP timer. The no command restores the default value.
Parameters:

  • <value>: value. The valid range is from 10 to 65535s.

Command mode: Global Mode
Default: 60s.
Usage guide: Configure the interval of JOIN-PRUNE packets sent by PIM periodically.
Example: Configure the timer interval.

active500EM(config)#ip PIM jp-timer 59

 

10.1.3.22 ip PIM multicast-routing

Command: ip PIM multicast-routing
no ip PIM multicast-routing
Function: Enable PIM-SM globally. The no command disables PIM-SM globally.
Parameters: None.
Command mode: Global Mode
Default: Disabled.
Usage guide: Enable PIM-SM globally. The interface must enable PIM-SM for PIM-SM to function.
Example: Enable PIM-SM globally.

active500EM(config)#ip PIM multicast-routing

 

10.1.3.23 ip PIM neighbor-filter

Command: ip PIM neighbor-filter <list-number>
no ip PIM neighbor-filter <list-number>
Function: Configure the neighbor access-list. Previous filters and connections with neighbors are cut off if they do not fall within the neighbor access-list.
Parameters:

  • <list-number>: simple access-list number. The valid range is 1 to 99.

Command mode: Interface Configuration Mode
Default: No neighbor filter configuration.
Usage guide: The ACL?s default is DENY. If configuring access-list 1, the default is deny. In the following example, if ?permit any? is not configured, deny 10.1.4.10 0.0.0.255 is the same as deny any.
Example: Configure VLAN?s filtering rules for PIM neighbors.

active500EM#show ip PIM neighbor
Neighbor          Interface          Uptime/Expires    Ver   DR
Address                                                      Priority/Mode
10.1.4.10         Vlan1              02:30:30/00:01:41 v2    4294967294 / DR
active500EM(config-if-vlan1)#ip PIM neighbor-filter 2
active500EM(config)#access-list 2 deny 10.1.4.10 0.0.0.255
active500EM(config)#access-list 2 permit any
active500EM(config)#show ip PIM neighbor

 

10.1.3.24 ip PIM register-rate-limit

Command: ip PIM register-rate-limit <limit>
no ip PIM register-rate-limit
Function: This command is used to configure the DR rate limit for sending register packets. The unit is packet/second. The no command restores the default value. This configured rate of speed is each?S, G?state, not the whole system?s.
Parameters:

  • <limit>: limit. The valid range is from 1 to 65535.

Command mode: Global Mode
Default: No limit for the sending speed.
Usage guide: This configuration is to prevent the attack to DR, limiting sending REGISTER packets.
Example: Configure the DR rate limit for sending register packets to 59p/s.

active500EM(config)#ip PIM register-rate-limit 59

 

10.1.3.25 ip PIM register-rp-reachability

Command: ip PIM register-rp-reachability
no ip PIM register-rp-reachability
Function: With this command, DR checks the RP reachability during registration.
Parameters: None.
Command mode: Global Mode
Default: Do not check.
Usage guide: With this command, DR checks the RP reachability during registration.
Example: Configure DR to check RP reachability.

active500EM(config)#ip PIM register-rp-reachability

 

10.1.3.26 Ip PIM register-source

Command: ip PIM register-source {<A.B.C.D> | <IFNAME>| vlan <vlan-id>}
no ip PIM register-source
Function: This command configures the register packets source address sent by DR to overwrite default source addresses. This default source address is usually the RPF neighbor of the source host direction. The no command restores the default value, no more parameter is needed.
Parameters:

  • <A.B.C.D>: configured source IP addresses.
  • <IFNAME>: interface name.
  • <vlan-id>: VLAN ID.

Command mode: Global Mode
Default: Do not check.
Usage guide: Configured address must be reachable to Register-Stop messages sent by RP. It is usually a circle address but it can also be another physical addresses. This address must be announcable through DR unicast router protocols.
Example: Configure the source address sent by DR.

active500EM(config)#ip PIM register-source 10.1.1.1

 

10.1.3.27 ip PIM register-suppression

Command: ip PIM register-suppression <value>
no ip PIM register-suppression
Function: This command configures the value of the register suppression timer. The unit is seconds. The no command restores the default value.
Parameters:

  • <value>: timer?s value. The valid range is from 10 to 65535s.

Command mode: Global Mode
Default: 60s.
Usage guide: If this value is configured at DR, it?s the value of the register suppression timer. If this command configures this value on RP without the command ?ip PIM rp-register-kat?, the command may modify the RP register keep-alive time.
Example: Configure the register suppression timer value to 10s.

active500EM(config)#ip PIM register- suppression 10

 

10.1.3.28 ip PIM rp-address

Command: ip PIM rp-address <A.B.C.D> [<A.B.C.D/M>] no ip PIM rp-address <A.B.C.D> [<A.B.C.D/M> | all]
Function: This command configures the static RP globally or in a multicast address range. The no command cancels static RP.
Parameters:

  • <A.B.C.D>: IP address of Rendezvous-point.
  • <A.B.C.D/M>: specified RP address scope.
  • all: all group ranges.

Command mode: Global Mode
Default: This switch is not a RP static router.
Usage guide: This command configures the static RP globally or in a multicast address range and configures PIM-SM static RP information. Note, when computing RP, BSR RP is selected first. If it is not successful, static RP is selected.
Example: Configure vlan1 as candidate RP announcing the sending interface globally.

active500EM(config)#ip PIM rp-address 10.1.1.1 238.0.0.0/8

 

10.1.3.29 ip PIM rp-candidate

Command: ip PIM rp-candidate {vlan <vlan-id> | <ifname>} [<A.B.C.D/M>] [<priority>] no ip PIM rp-candiate
Function: This command is the candidate RP global configuration command. It is used to configure the PIM-SM candidate RP information in order for the RP router to compete with other candidate RPs. The no command cancels the candidate RP.
Parameters:

  • <vlan-id>: Vlan ID.
  • <Ifname>: specified interface name.
  • <A.B.C.D/M>:?IP prefix and mask.
  • <priority>: RP selection priority. The valid range is from 0 to 255. The default value is 192. The lower value has higher priority.

Command mode: Global Mode
Default: This switch is not a RP static router.
Usage guide: This command is the candidate RP global configuration command. It is used to configure the PIM-SM candidate RP information in order for the RP router to compete with other candidate RPs. Once this command is configured, this switch is the RP candidate router.
Example: Configure vlan1 as the sending interface of the candidate RP for announcing sending messages.

active500EM(config)#ip PIM rp-candidate vlan1 100

 

10.1.3.30 Ip PIM rp-register-kat

Command: ip PIM rp-register-kat <value>
no ip PIM rp-register-kat
Function: This command configures the KAT (KeepAlive Timer) value of the RP (S, G). The unit is seconds. The no command restores the default value.
Parameters:

  • <value>: timer value. The valid range is from 1 to 65535s.

Command mode: Global Mode
Default: 185s.
Usage guide: This command configures the RP?s keep alive time. During the keep alive time RP?s (S, G) item will not be deleted because it hasn?t received?register packets. If no new?register packets are received when the keep alive time is over, this item will be obsolete.
Example: Configure the RP?s KAT value (S, G) to 180s.

active500EM(config)#ip PIM rp-register-kat 180

 

10.1.3.31 ip PIM scope-border

Command: ip PIM scope-border [<1-99 >|<acl-name>] no ip PIM scope-border
Function: Configure or delete the PIM management border.
Parameters:

  • <1-99 >: ACL number for the management border.
  • <acl-name>: ACL name for the management border.

Command mode: Interface Configuration Mode
Default: No management border. If no ACL is specified, the default management border will be used.
Usage guide: Configure the management border and the ACL for the PIM protocol. The multicast data flow will not be forwarded to the SCOPE-BORDER.
Example: Configure the PIM management border.

active500EM(config-if-vlan2)#ip PIM scope-border 3

 

10.1.3.32 ip PIM sparse-mode

Command: ip PIM sparse-mode [passive] no ip PIM sparse-mode [passive]
Function: Enable PIM-SM on the interface. The no command disables PIM-SM.
Parameters:

  • passive : disable PIM-SM (PIM-SM doesn?t receive any packets) and only enable IGMP (receive and transmit IGMP packets).

Command mode: Interface Configuration Mode
Default: Disabled.
Usage guide: Enable PIM-SM on the interface.
Example: Enable PIM-SM on the interface vlan1.

active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip PIM sparse-mode

 

10.1.3.33 show ip PIM bsr-router

Command: show ip PIM bsr-router
Function: Display the BSR address.
Parameters: None.
Command mode: Admin Mode
Default: None.
Usage guide: Display the BSR information maintained by the PIM.
Example: Display the BSR address.

active500EM#show ip PIM bsr-router
PIMv2 Bootstrap information
This system is the Bootstrap Router (BSR)
  BSR address: 10.1.4.3 (?)
  Uptime: 00:06:07, BSR Priority: 0, Hash mask length: 10
  Next bootstrap message in 00:00:00
  Role: Candidate BSR
  State: Elected BSR
Next Cand-RP-advertisement in 00:00:58
  RP: 10.1.4.3(Vlan1)
Displayed Information Explanation
BSR address BSR-router Address
Priority BSR-router Priority
Hash mask length BSR-router hash mask length
State The current state of this candidate BSR, Elected BSR is the selected BSR

 

10.1.3.34 show ip PIM interface

Command: show ip PIM interface
Function: Display PIM interface information.
Parameters: None.
Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: Display PIM interface information.
Example: Display PIM interface information.

active500EM(config)#show ip PIM interface
Address          Interface VIFindex Ver/   Nbr    DR    DR
                                    Mode   Count  Prior
10.1.4.3         Vlan1     0        v2/S   1      1     10.1.4.3
10.1.7.1         Vlan2     2        v2/S   0      1     10.1.7.1
Displayed Information Explanation
Address Interface address
Interface Interface name
VIF index Interface index
Ver/Mode PIM version and mode, usually v2, sparse mode displays S, dense mode displays D
Nbr Count The interface?s neighbor count
DR Prior Dr priority
DR The interface?s DR address

 

10.1.3.35 show ip PIM mroute sparse-mode

Command: show ip PIM mroute sparse-mode [group <A.B.C.D>] [source <A.B.C.D>] Function: Display the PIM-SM multicast route table.
Parameters:

  • group <A.B.C.D>: display redistributed items that relate to this multicast address.
  • source <A.B.C.D>: display redistributed items that relate to this source.

Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: Display the BSP routers in the network maintained by PIM-SM.
Example: Display the PIM-SM multicast route table.

active500EM#show ip PIM mroute sparse-mode
IP Multicast Routing Table
(*,*,RP) Entries: 0
(*,G) Entries: 1
(S,G) Entries: 0
(S,G,rpt) Entries: 0
(*, 239.192.1.10)
RP: 10.1.6.1
RPF nbr: 10.1.4.10
RPF idx: Vlan1
Upstream State: JOINED
 Local     ..l.............................
 Joined    ................................
 Asserted  ................................
 Outgoing  ..o.............................
Displayed Information Explanation
Entries The counts of each item.
RP Share tree?s RP address.
RPF nbr RP direction or up neighbor of the source direction.
RPF idx RPF nbr interface.
Upstream State Upstream State: there are two Joined states (join the tree, expect to receive data from upstream) and Not Joined(quit the tree, do not expect to receive data from upstream). Options include RPT Not Joined, Pruned, and Not Pruned. These options are available for?S,G,rpt).
Local Local join interface. This interface receives IGMPJoin.
Joined PIM join interface. This interface receives J/P messages.
Asserted Asserted state.
Outgoing Outgoing multicast data. In this example, the index of the outgoing interface is 2. Command ?show ip PIM interface? can query interface information.

 

10.1.3.36 show ip PIM neighbor

Command: show ip PIM neighbor
Function: Display router neighbors.
Parameters: None.
Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: Display multicast router neighbors maintained by the PIM.
Example: Display router neighbors.

active500EM(config)#show ip PIM neighbor
Neighbor          Interface          Uptime/Expires    Ver   DR
Address                                                      Priority/Mode
10.1.6.1          Vlan1              00:00:10/00:01:35 v2    1 /
10.1.6.2          Vlan1              00:00:13/00:01:32 v2    1 /
10.1.4.2          Vlan3              00:00:18/00:01:30 v2    1 /
10.1.4.3          Vlan3              00:00:17/00:01:29 v2    1 /
Displayed Information Explanation
Neighbor Address Neighbor address.
Interface Neighbor interface.
Uptime/Expires Running time / overtime.
Ver PIM version (usually v2).
DR Priority/Mode DR priority in the hello messages from the neighbor and identifies if the neighbor is the interface?s DP.

 

10.1.3.37 show ip PIM nexthop

Command: show ip PIM nexthop
Function: Display the PIM buffered nexthop router in the unicast route table.
Parameters: None.
Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: Display the PIM buffered nexthop router information.
Example: Display the PIM buffered nexthop router in the unicast route table.

active500EM(config)#show ip PIM nexthop
Flags: N = New, R = RP, S = Source, U = Unreachable
Destination     Type  Nexthop  Nexthop      Nexthop  Nexthop Metric Pref   Refcnt
                       Num      Addr        Ifindex   Name
192.168.1.1     N...   1       0.0.0.0       2006              0      0      1
192.168.1.9     ..S.   1       0.0.0.0       2006              0      0      1
Displayed Information Explanation
Destination Destination of next item.
Type N: created nexthop, RP direction and S direction are not determined. R: RP direction. S: source direction. U: can?t reach.
Nexthop Num Nexthop number.
Nexthop Addr Nexthop address.
Nexthop Ifindex Nexthop interface index.
Nexthop Name Nexthop name.
Metric Metric to nexthop.
Pref Preference Route preference.
Refcnt Reference count.

 

10.1.3.38 show ip PIM rp-hash

Command: show ip PIM rp-hash <A.B.C.D>
Function: Display the RP address of A.B.C.D?s merge point.
Parameters:

  • <A.B.C.D>: group address.

Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: Display the RP address corresponding to the specified group address.
Example: Display the RP address of A.B.C.D?s merge point.

active500EM(config-if-vlan1)#show ip PIM rp-hash 239.192.1.10
    RP: 10.1.6.1
Info source: 10.1.6.1, via bootstrap
Displayed Information Explanation
RP Queried group?s RP
Info source The source of information

 

10.1.3.39 show ip PIM rp mapping

Command: show ip PIM rp mapping
Function: Display Group-to-RP mapping and RP.
Parameters: None.
Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: Display the current RP and mapping relationship.
Example: Display Group-to-RP Mapping and RP.

active500EM(config-if-vlan1)#show ip PIM rp mapping
PIM Group-to-RP Mappings
Group(s): 224.0.0.0/4
  RP: 10.1.6.1
    Info source: 10.1.6.1, via bootstrap, priority 6
         Uptime: 00:11:04
Displayed Information Explanation
Group(s) Group address range of RP
Info source Source of messages
Priority Priority of messages

 

10.1.4 Commands for MSDP Configuration

10.1.4.1 cache-sa-holdtime

Command: cache-sa-holdtime <seconds>
no cache-sa-holdtime
Function: Configure the longest holdtime of the SA table within MSDP Cache.
Parameters:

  • <seconds>: units are seconds. The valid range is between 150 to 3600.

Command mode: MSDP Configuration Mode
Default: 150 seconds.
Usage guide: Configure the aging time of the (S, G) table for MSDP cache.
Example: Configure the longest holdtime of the SA table within MSDP Cache.

active500EM(config)#router msdp
active500EM(router-msdp)#cache-sa-holdtime 350

 

10.1.4.2 cache-sa-maximum

Command: cache-sa-maximum <sa-limit>
no cache-sa-maximum
Function: Configure the maximum sa-limit of the specified MSDP Peer cache.
Parameters:

  • <sa-limit>: The maximum cache SA number. The valid range is between 1 and 75000.

Command mode: MSDP Configuration Mode and MSDP Peer Configuration Mode
Default: 20000.
Usage guide: This command can be used to configure the maximum number of cached SA messages on the router in order to prevent DoS ? Denial of Service attack. The maximum number of cached SA messages can be configured in Global Configuration mode or in MSDP Peer configuration mode. If the configured value is less than the current number of cached SA messages, or the number configured in Global Mode is less than that configured in peer mode, the configuration will not function.
Example: Configure the maximum sa-limit of the specified MSDP Peer cache.

active500EM(config)#router msdp
active500EM(router-msdp)#cache-sa-maximum 50000
active500EM(router-msdp)#peer 20.1.1.1
active500EM(router-msdp-peer)# cache-sa-maximum 22000

 

10.1.4.3 cache-sa-state

Command: cache-sa-state
no cache-sa-state
Function: Configure the SA cache state. The no command removes the configuration of SA cache.
Parameters: None.
Command mode: MSDP Configuration Mode and MSDP Peer Configuration Mode
Default: Enabled.
Usage guide: Configure the SA cache state. If configured, the new groups will be able to get information about all the active sources from the SA cache and join the related source tree without having to wait for new SA messages. SA cache should be enabled on all the MSDP speakers. This command should be issued exclusively with the sa-request command.
Example: Configure the SA cache state.

active500EM(config)#router msdp
active500EM(router-msdp)#no cache-sa-state

 

10.1.4.4 clear msdp peer

Command: clear msdp peer {<peer-address>| * }
Function: Disconnect the specified MSDP Peer and TCP and clear the statistics of the Peer.
Parameters:

  • <peer-address>: IP address of the Peer in A.B.C.D. format
  • *: disconnected with all the Peers.

Command mode: Admin Mode
Default: None.
Usage guide: If this command is issued with peer-address, the TCP connection to the specified MSDP Peer will be removed. All the statistics about the peer will be cleared. If no peer-address is appended, all the MSDP connections as well as relative statistics about peers will be removed.
Example: Disconnect the specified MSDP Peer and TCP and clear the statistics of the Peer.

active500EM#clear msdp peer *

 

10.1.4.5 clear msdp sa-cache

Command: clear msdp sa-cache {group <A.B.C.D>| * }
Function: Clear the Source Active information in the MSDP cache. Clear the corresponding data with all the sources from the specified group or the corresponding data with one specified (S, G) item.
Parameters:

  • <A.B.C.D>: multicast group IP Address ; clears group (S, G) in the cache.
  • *: clear all the items in the cache.

Command mode: Admin Mode
Default: None.
Usage guide: If group is specified, clear the non-local SA entries of the MSDP cache of the specified group. If no parameters are entered, all the non-local SA entries in the MSDP cache will be removed.
Example: Clear the Source Active information in the MSDP cache.

active500EM#clear msdp sa-cache group 224.1.1.1

 

10.1.4.6 clear msdp statistics

Command: clear msdp statistics {<peer-address>| * }
Function: Clear MSDP statistic information and do not reset the MSDP Peer session.
Parameters:

  • <peer-address>: Peer IP address.
  • *: disconnect with all Peers.

Command mode: Admin Mode
Usage guide: Clear MSDP statistic information and do not reset the MSDP Peer session.
Example: Clear MSDP statistic information and do not reset the MSDP Peer session.

active500EM#clear msdp statistics *

 

10.1.4.7 connect-source

Command: connect-source <interface-type> <interface-number>
no connect-source <interface-type> <interface-number>
Function: Configure the interface address which is used for all the MSDP Peers to set up a corresponding connection between MSDP Peer and MSDP. The no command will cancel the configuration and reset the MSDP connection of this port.
Parameters:

  • <interface-type>: interface type.
  • <interface-number>: interface number.

Command mode: MSDP Configuration Mode and MSDP Peer Configuration Mode
Default: No specified interface.
Usage guide: The switch uses the IP address of this port to set up a MSDP Peer connection with MSDP Peer. The specified connect-source address must match the Peer address configuration otherwise the TCP connection will fail. The configuration under MSDP Peer mode will cover MSDP Mode.
Example: Configure the interface address.

active500EM(config)#router msdp
active500EM(router-msdp)#connect-source interface vlan 2
active500EM(router-msdp)#peer 20.1.1.1
active500EM(router-msdp-peer)#connect-source interface loopback 10

 

10.1.4.8 debug msdp all

Command: debug msdp all
no debug msdp all
Function: Enable MSDP degug. The no command disables the debugging information.
Parameters: None.
Command mode: Admin Configuration Mode
Default: Disabled.
Usage guide: Enable the debugging switch of MSDP. Display the MSDP Peer protocol packet send/receive information (packet); keepalive packet send/receive information (keepalive); event information (event); NSM mutual information (nsm); timer information (timer); protocol state information (fsm); filter policy information (filter).
Exampe: Enable MSDP degug.

active500EM#debug msdp all

 

10.1.4.9 debug msdp events

Command: debug msdp events
no debug msdp events
Function: Enable /disable?MSDP events debugging.
Parameters: None.
Command mode: Admin Mode
Default: Close the switch.
Usage guide: After enabling this command, the MSDP protocol events can be monitored.
Example: Enable /disable?MSDP events debugging.

active500EM#debug msdp events

 

10.1.4.10 debug msdp filter

Command: debug msdp filter
no debug msdp filter
Function: Enable/disable MSDP filter policy information debugging.
Parameters: None.
Command mode: Admin Mode
Default: Close the switch.
Usage guide: After enabling this command, MSDP receiving/sending message filter information can be monitored.
Example: Enable/disable MSDP filter policy information debugging.

active500EM#debug msdp filter

 

10.1.4.11 debug msdp fsm

Command: debug msdp fsm
no debug msdp fsm
Function: Enable/disable MSDP fsm debugging.
Parameters: None.
Command mode: Admin Mode
Default: Close the switch.
Usage guide: After enabling this command, MSDP Peer sm information will be displayed.
Example: Enable/disable MSDP fsm debugging.

active500EM#debug msdp fsm

 

10.1.4.12 debug msdp keepalive

Command: debug msdp keepalive
no debug msdp keepalive
Function: Enable/disable keepalive message information for MSDP protocol debugging.
Parameters: None.
Command mode: Admin Mode
Default: Close the switch.
Usage guide: After enabling this command, receiving/sending keepalive message information for MSDP protocol can be monitored.
Example: Enable/disable keepalive message information for MSDP protocol debugging.

active500EM#debug msdp keepalive

 

10.1.4.13 debug msdp nsm

Command: debug msdp nsm
no debug msdp nsm
Function: Enable/disable msdp nsm debug.
Parameters: None.
Command mode: Admin Mode
Default: Close the switch.
Usage guide: The information related to running MSDP protocol and the NSM module can be monitored after enabling this command.
Example: Enable/disable msdp nsm debug.

active500EM#debug msdp nsm

 

10.1.4.14 debug msdp packet

Command: debug msdp packet [recv | send] no debug msdp packet
Function: Enable/disable sending/receiving messages for the MSDP protocol debugging.
Parameters:

  • recv: incoming packet.
  • send: outgoing packet.

Command mode: Admin Mode
Default: Close the switch.
Usage guide: MSDP protocol receiving/sending messages can be monitored after enabling this command.
Example: Enable/disable sending/receiving messages for the MSDP protocol debugging.

active500EM#debug msdp packet send

 

10.1.4.15 debug msdp peer

Command: debug msdp peer <A.B.C.D>
no debug msdp peer
Function: Enable/disable specified MSDP Peer debugging.
Parameters:

  • <A.B.C.D>: MSDP peer address.

Command mode: Admin Mode
Default: Close the switch.
Usage guide: Enable the specified MSDP Peer debugging information. The debug information of other MSDP Peers will not be displayed. This command takes effect only for the last MSDP peer.
Example: Enable MSDP Peer debugging.

active500EM#debug msdp peer 10.1.1.1

 

10.1.4.16 debug msdp timer

Command: debug msdp timer
no debug msdp timer
Function: Enable/disable MSDP timer debugging.
Parameters: None.
Command mode: Admin Mode
Default: Close the switch.
Usage guide: Enable/disable MSDP timer debugging.
Example: Enable/disable MSDP timer debugging.

active500EM#debug msdp timer

 

10.1.4.17 default-rpf-peer

Command: default-rpf-peer <peer-address> [rp-policy <acl-list-number>|<word>] no default-rpf-peer
Function: Configure static RPF peer.
Parameters:

  • <peer-address>: IP address of the MSDP peer.
  • <acl-list-number>: ACL number. Standard ACL from 1 to 99 is supported.
  • <word>: standard ACL name.

Command mode: MSDP Configuration Mode
Default: There is no static RPF peer by default. If the peer command only configures one MSDP peer, this peer will be treated as the default peer.
Usage guide: To configure more than one static RPF peers, use the following two configuration methods:

  • Both use the rp-policy parameters: multiple RPFs take effect at the same time. Filter RP in SA messages according to the configured prefix list. Only accepted SA messages are allowed to pass.
  • Neither uses the rp-policy parameters: according to the configuration sequence, only the first static RPF peer in the?up state is active. All SA messages from this peer can be received while those from other peers will be dropped. If the active peer fails to take effect (such as the configuration is canceled or the connection is disconnected), choose the first static RPF peer in the?up state in the configuration sequence to be the active static RPF peer.

Example: Configure static RPF peer.

active500EM(config)#router msdp
active500EM(router-msdp)#default-rpf-peer 10.0.0.1 rp-policy 10

 

10.1.4.18 description

Command: description <text>
no description
Function: Add the specified MSDP Peer description information. The no command removes the description.
Parameters:

  • <text>: description text. The valid range is between 1 and 80 bytes.

Command mode: MSDP Peer Configuration Mode
Default: Not specified.
Usage guide: Add descriptions for the specified MSDP Peer in order to identify the MSDP configuration.
Example: Add the specified MSDP Peer description information.

active500EM(config)#router msdp
active500EM(router-msdp)#peer 20.1.1.1
active500EM(router-msdp-peer)#description test-20

 

10.1.4.19 exit-peer-mode

Command: exit-peer-mode
Function: Quit MSDP Peer configuration mode and enter MSDP configuration mode.
Parameters: None.
Command mode: MSDP Peer Configuration Mode
Default: None.
Usage guide: When configuration to an MSDP Peer is completed, MSDP Configuration Mode can be returned?to by using the “exit-peer-mode” command.
Example: Quit MSDP Peer Configuration Mode and enter MSDP Configuration Mode.

active500EM(config-msdp-peer)#exit-peer-mode

 

10.1.4.20 mesh-group

Command: mesh-group <name>
no mesh-group <name>
Function: Configure the MSDP Peer as a specified mesh group number. If setting the same MSDP Peer to many mesh groups, then the last mesh group is used.
Parameters:

  • <name>: mesh-group name.

Command mode: MSDP Peer Configuration Mode
Default: The MSDP Peer doesn?t belong to any mesh group.
Usage guide: Mesh group can reduce SA message flooding and check Peer-RPF verification.
Example: Configure the MSDP Peer as a specified mesh group number.

active500EM(config)#router msdp
active500EM(router-msdp)#peer 20.1.1.1
active500EM(router-msdp-peer)#mesh-group test-1

 

10.1.4.21 originating-rp

Command: originating-rp <interface-type> <interface-number>
no originating-rp
Function: Configure the IP address of the specified interface as the IP address of the RP in the SA messages.
Parameters:

  • <interface-type>: port type.
  • < interface-number>: port number.

Command mode: MSDP Configuration Mode and MSDP Peer Configuration Mode
Default: The default SA message RP address is the PIM configured RP address.
Usage guide: To configure the IP address of the specified interface as the IP address of the RP in the SA messages. If no IP address is configured for the specified interface, or the interface is down, no SA messages will be advertised. In this situation, if multiple RP are configured for the device, other SA messages for other RP will not be advertised either. Therefore, the interface should be working when being configured.
Example: Configure the IP address of the specified interface as the IP address of the RP in the SA messages.

active500EM(config)#router msdp
active500EM(router-msdp)#originating-rp vlan 20

 

10.1.4.22 peer

Command: peer <A.B.C.D>
no peer <A.B.C.D>
Function: Configure the MSDP Peer and?enter MSDP Peer mode. The no command deletes the configured MSDP Peer.
Parameters:

  • <A.B.C.D>: peer address.

Command mode: MSDP Configuration Mode
Default: No MSDP peer configured.
Usage guide: Configure the IP address of the MSDP peer and enter the peer configuration mode. When the command is issued, the router will setup the TCP session to the specified peer. The no form of this command will remove the configured MSDP Peer and destroy all the sessions and related statistics with the specified peer. Note: a specified peer address must correspond with the interface address. If configuring the Connect-source, the peer address must be the Connect-source interface address. If the address is not the specified Connect-source, the peer address is the egress address, and the TCP connection will not be setup.
Example: Configure the MSDP peer in MSDP configuration mode.

active500EM(config-msdp)#peer 10.1.1.1
active500EM(config-msdp-peer)#

 

10.1.4.23 redistribute

Command: redistribute [list {<acl-number> | <acl-name>}] no redistribute
Function: Configure SA message redistribution.
Parameters:

  • <acl-number>: specified advanced ACL number (100-199).
  • <acl-name>: specified ACL name.

Command mode: MSDP Configuration Mode
Default: When setting up the SA message, announce all the sources but the the (S, G) item is not confined.
Usage guide: If the ACL list number is specified, only the (S, G) entries which have passed the ACL check will be advertised in the SA messages. If no ACL is specified, no (S, G) entry will be advertised in the SA messages.
Example: Configure SA message redistribution.

active500EM(config)#router msdp
active500EM(router-msdp)#redistribute list 130

 

10.1.4.24 remote-as

Command: remote-as <as-num>
no remote-as <as-num>
Function: Configure the specified MSDP peer AS number. The no command restores the AS number of specified MSDP peer.
Parameters:

  • <as?num>: AS number. The valid range is from 1 to 65535.

Command mode: MSDP Peer Configuration Mode
Default: The AS number isn?t initialized to 0.
Usage guide: This command sets the AS number for a specified peer.
Example: Configure the specified MSDP peer AS number.

active500EM(config)#router msdp
active500EM(router-msdp)#peer 20.1.1.1
active500EM(router-msdp-peer)#remote-as 20

 

10.1.4.25 router msdp

Command: router msdp
no router msdp
Function: Enable the MSDP protocol of the switch and enter MSDP mode. The no command disables MSDP protocol.
Parameters: None.
Command mode: Global Mode
Default: Disabled.
Usage guide: Enable MSDP in Global Mode. If configuring PIM SM at the same time MSDP will still function.
Example: Enable MSDP in Global Mode.

active500EM(config)#router msdp

 

10.1.4.26 sa-filter

Command: sa-filter {in | out} [ list {<acl-number> | <acl-name>} | rp-list {<rp-acl-number> | <rp-acl-name>} ] no sa-filter {in | out} [ list {<acl-number>| <acl-name>} | rp-list {<rp-acl-number> | <rp-acl-name>} ] Function: Configure the receiving/transmitting messages filter policy which can be used to control the receiving/transmitting source message.
Parameters:

  • in: filter the SA messages from the specified MSDP Peer.
  • out: filter the SA messages transmitted from the specified MSDP Peer.
  • <acl-number>: specified advanced ACL number. The valid values are from 100 to 199.
  • <acl-name>: specified advanced ACL name.
  • <rp-acl-number>: specified standard ACL number (1-99).
  • <rp-acl-name>: specified standard ACL name.
  • no parameter: if the parameter isn?t specified, the entire SA messages which include (S, G) item will be filtered.

Command mode: MSDP Configuration Mode and MSDP Peer Configuration Mode
Default: All receiving/ transmitting SA messages will not be filtered.
Usage guide: Configuration in the peer mode will MSDP configuration mode. The distribution of SA messages can be controlled through this command or the redistribute command.
Example: Configure the filter policy for receiving/transmitting messages.

active500EM(config)#router msdp
active500EM(router-msdp)#sa-filter in
active500EM(router-msdp)#peer 20.1.1.1
active500EM(router-msdp-peer)#sa-filter in list 120

 

10.1.4.27 sa-request

Command: sa-request
no sa-request
Function: Configure the route that sends the SA request message to a specified MSDP Peer when the joined message from a new group is received.
Parameters: None.
Command mode: MSDP Peer Configuration Mode
Default: Do not send a SA Request message by default.
Usage guide: This command makes the switch (RP) send SA request messages to the specified MSDP. When there is a new group or member, the switch (RP) will send SA request messages to the specified MSDP and wait for the latter?s response from its cached local SA messages. After sending a SA message to the specified MSDP, RP will receive a SA-response message from the peer, and know all active sources of the peer (not including the source information learned via MSDP SA). If RP is configured with SA cache state, this configuration won?t take effect. This command is mutually exclusive to sa-cache-sate. If the MSDP is configured with SA cache state, it won?t configure the sa-request. The switch will show a prompt to alert the user. This command only applies to RP.
Example: Configure the route that sends the SA request message to a specified MSDP Peer when the joined message from a new group is received.

active500EM(config)#router msdp
active500EM(router-msdp)#peer 20.1.1.1
active500EM(router-msdp-peer)#sa-request

 

10.1.4.28 sa-request-filter

Command: sa-request-filter [list {<access-list-number> | <access-list-name>} ] no sa-request-filter [list {<access-list-number> | <access-list-name>} ]
Function: Filter the SA request messages from MSDP peer.
Parameters:

  • <access-list-number>: ACL number. Standard ACL from with values 1 to 99 are supported.
  • <access-list-name>: ACL name.

Command mode: MSDP Configuration Mode
Default: The route receives all the SA request messages from MSDP peer.
Usage guide: If no list parameter is specified, all the SA request messages from MSDP peers will be filtered. If the parameter is specified, SA request messages will be filtered with the specified ACL list.
Example: Filter the SA request messages from MSDP peer.

active500EM(config)#router msdp
active500EM(router-msdp)#sa-request-filter list 1

 

10.1.4.29 show msdp global

Command: show msdp global
Function: Show the configuration information in MSDP Mode.
Parameters: None.
Command mode: Admin and Configuration Mode
Default: None.
Usage guide: Show the configuration information in MSDP Mode. Include the MSDP protocol state, cache, etc.
Example: Show the configuration information in MSDP Mode.

active500EM#show msdp global
Multicast Source Discovery Protocol (MSDP):
SA-Cached,  Originator: Vlan2,  Connect-Source: Vlan2
MAX External SA Entry: 200000
MAX Peer External SA Entry: 20000
TTL Threshold: 0
SA Entry Hold Time: 350
Filters:
     Redistribute-filter: Not set
     SA-filter:
     	 [IN]:  RP-list: None,  SG-list: None
     	 [OUT]: Not Configured
     SA-Request-Filter: Not Configured
Default Peer:
     Not Configured
Mesh Group:
     test-1
Displayed Information Explanation
SA-Cached MSDP SA-Cached state.
Originator The MSDP originated RP interface.
MAX External SA Entry The max entries configured in MSDP Configuration Mode.
MAX Peer External SA Entry The max entries of each Peer.
TTL Threshold TTL Threshold.
SA Entry Hold Time The MSDP cache multicast source hold time.
Redistribute-filter Establishes the SA message filter policy.
SA-filter [IN | OUT] The receiving/sending SA message filter policy.
Default Peer Static RPF Peer.
Mesh Group The name and members of the mesh group.

 

10.1.4.30 show msdp local-sa-cache

Command: show msdp local-sa-cache
Function: Display the local-sa-cache information.
Parameters: None.
Command mode: Admin Mode and Configuration Mode
Default: None.
Usage guide: Display the local-sa-cache information.
Example: Display the local-sa-cache information.

active500EM#show msdp local-sa-cache
MSDP Flags:
E - set MRIB E flag, L - domain local source is active,
EA - externally active source, PI - PIM is interested in the group,
DE - SAs have been denied.
Cache SA Entry:
Source Address          Group Address       RP Address          TTL
5.5.5.9                 225.0.0.1           11.1.1.1            64
5.5.5.9                 225.0.0.2           11.1.1.1            64
5.5.5.9                 225.0.0.3           11.1.1.1            64
5.5.5.9                 225.0.0.4           11.1.1.1            64

 

10.1.4.31 show msdp peer

Command: show msdp peer <A.B.C.D>
Function: Show the configuration information in MSDP Mode.
Parameters:

  • <A.B.C.D>: MSDP Peer Address.

Command mode: Admin and Configuration Mode
Default: None.
Usage guide: Show the configuration information in MSDP configuration mode.
Example: Show the configuration information in MSDP Mode.

active500EM#show msdp peer 31.1.1.3
MSDP Peer 31.1.1.3, AS 0,  Description:
Connection status:
    State: Established, Resets: 0,
Connection Source: Not set, Connect address: 31.1.1.1
    Uptime (Downtime): 00h:07m:53s, SA messages received: 16
    TLV messages sent/received:     8/24
    SA messages incoming Rejected:   0
    SA messages outgoing Rejected:   0
SA Filtering:
    Input filter Not Configured
    Output filter Not Configured
SA-Requests:
    Input filter Not Configured
    Sending SA-Requests to peer: Disabled
Peer ttl threshold:  0
Displayed Information Explanation
MSDP Peer MSDP Peer IP address.
AS Autonomous system number belonging to the MSDP Peer.
State MSDP Peer state.
Connection source The interface used in the local TCP connection.
Uptime (Downtime) The MSDP peer uptime/downtime.
Messages sent/received The message statistics sent/ received from the Peer.
SA Filtering The filtering policy configured with Peers.
SA-Requests The configured filtering policy of SA requests.
SAs learned from this peer The SA numbers learned from MSDP Peers in the cache.
SAs limit The configured SA limit numbers with this MSDP Peer.

 

10.1.4.32 show msdp sa-cache

Command: show msdp sa-cache {<source-address> [<group-address>] | as-num <as-number> | peer <peer-address>| rpaddr <rp-address>}
Function: Display the configuration information for the cache-exterior source under MSDP.
Parameters:

  • <source-address>: source address.
  • <group-address>: group address.
  • <as-number>: autonomous system number.
  • <peer-address>: peer address.
  • <rp-address>: RP address.

Command mode: Admin and Configuration Mode
Default: None.
Usage guide: Display the configuration information for the cache-exterior source under MSDP.
Example: Display the configuration information for the cache-exterior source under MSDP.

active500EM#show msdp sa-cache 30.30.30.1
MSDP Flags:
E - set MRIB E flag, L - domain local source is active,
EA - externally active source, PI - PIM is interested in the group,
DE - SAs have been denied.
Cache SA Entry:
(S:30.30.30.1, G: 224.1.1.1, RP: 10.1.1.2),  AS: 0,  00h:00m:11s/00h:02m:19s
Learn From Peer:20.1.1.1,  RPF Peer: 10.1.1.10
SA Received: 10    Encapsulated data received: 0
grp flags: None    source flags:  EA, DE
Displayed Information Explanation
(S, G, RP) Running source message information(S, G, RP).
AS Num Autonomous system number.
update time SA message cache time.
expire time SA message expire time.
Learn From Peer The table is learned from the Peer.
RPF Peer RPF Peer of the entry.
SA Received SA message which includes the entry.
Encapsulated data received The multicast message included in the SA message.
grp flags The multicast group flag in the entry.
source flags The multicast source flag in the entry.

 

10.1.4.33 show msdp sa-cache summary

Command: show msdp sa-cache summary
Function: Display the MSDP Cache summary.
Parameters: None.
Command mode: Admin and Configuration Mode
Default: None.
Usage guide: Displays the MSDP cache summary.
Example: Display the MSDP cache summary.

active500EM#show msdp sa-cache summary
MSDP Flags:
E - set MRIB E flag, L - domain local source is active,
EA - externally active source, PI - PIM is interested in the group,
DE - SAs have been denied.
Cache SA Entry:
Total number of SA Entries = 1
Total number of Sources = 1
Total number of Groups = 1
Total number of RPs = 1
Originator-RP     SA total    RPF peer
10.1.1.2           1          10.1.1.10
AS-num   SA total
 0        1
Displayed Information Explanation
Total number of SA Entries Total number of SA entries in the cache.
Total number of Sources Total number of different multicast sources in the cache.
Total number of Groups Total number of different multicast groups in the cache.
Total number of RPs Total number of different RP in the cache.
Originator-RP Origination RP address.
SA total Total number of received SA messages from RP.
RPF peer The RPF Peer address of the corresponding RP.
AS-num Autonomous system number.

 

10.1.4.34 show msdp statistics

Command: show msdp statistics peer [<A.B.C.D>] Function: Display the specified Peer or receiving/sending message statistics from all the peers.
Parameters:

  • <A.B.C.D>: MSDP peer address.

Command mode: Admin and Configuration Mode
Default: None.
Usage guide: Display the specified peer or receiving/sending message statistics from all the peers.
Example: Display the specified peer 2.2.2.4.

active500EM#show msdp sta peer 2.2.2.4
MSDP Peer Statistics :
Peer  2.2.2.4 ,   AS is  0,  State is  Inactive
    TLV Rcvd :    76 total
                  39 keepalives,      37 SAs
                   0 SA Requests,      0 SA responses
    TLV Send :    80 total
                  41 keepalives,      39 SAs
                   0 SA Requests,      0 SA responses
    SA  msgs :    37 received,        39 sent
Displayed Information Explanation
Peer MSDP peer address.
AS Autonomous system number.
State MSDP peer state.
TLV Rcvd The TLV type and peer received statistics.
TLV Send The TLV type and peer sent statistics.
SA msgs The SA message statistics of the peer received and sent.

 

10.1.4.35 show msdp summary

Command: show msdp summary
Function: Display the MSDP summary.
Parameters: None.
Command mode: Admin and Configuration Mode
Default: None.
Usage guide: Display the MSDP summary.
Example: Display the MSDP summary.

active500EM#show msdp summary
Maximum External SA's Global : 20000
MSDP Peer Status Summary
Peer Address  AS  State        Uptime/    Reset   Peer   Active   Cfg.Max          TLV
                               Downtime   Count   Name     SA     Cnt Ext.SAs    recv/sent
2.2.2.4       0   Established  THU JAN 01 00:00:00         10         0          121/100
Displayed Information Explanation
Peer Address MSDP peer IP address.
AS Autonomous system number belonging to the MSDP peer.
State MSDP peer state.
Uptime/Downtime The uptime or downtime of MSDP peer.
Reset Count The reset count of MSDP peer.
Peer Name The description of MSDP peer.
Active SA The numbers of active SA.
TLV sent/received The TLV messages sent/ received statistics from the peer.

 

10.1.4.36 shutdown

Command: shutdown
no shutdown
Function: Disable a specified MSDP peer.
Parameters: None.
Command mode: MSDP Peer Configuration Mode
Default: Enabled.
Usage guide: When configuring a MSDP peer with multiple commands, it is sometimes required for these commands to be effective together rather than one by one. The shutdown command can be used to disable the peer before configuration and the no shutdown command can be used after configuration in order to make the peer configuration effective. The shutdown command will remove all the TCP sessions with the specified MSDP peer as well as the statistics.
Example: Disable MSDP peer 20.1.1.1.

active500EM(config)#router msdp
active500EM(router-msdp)#peer 20.1.1.1
active500EM(router-msdp-peer)#shutdown

 

10.1.4.37 ttl-threshold

Command: ttl-threshold <ttl>
no ttl-threshold
Function: Configure the minimum multicast source TTL value encapsulated in the SA message.
Parameters:

  • <ttl>: minimum TTL value. The valid range is from 1 to 255.

Command mode: MSDP Configuration Mode
Default: TTL value will not be filtered when the TTL value is 0.
Usage guide: The redistribution of multicast datagrams can be controlled through the TTL value. SA messages will be advertised only if the TTL value in the packet is less than the TTL threshold.
Example: Configure the minimum multicast source TTL value encapsulated in the SA message.

active500EM(config)#router msdp
active500EM(router-msdp)#ttl-threshold 10

 

10.1.5 Commands for ANYCAST RP v4

10.1.5.1 debug PIM anycast-rp

Command: debug PIM anycast-rp
no debug PIM anycast-rp
Function: Enable the ANYCAST RP function debug. The no command disables this debug.
Parameters: None.
Command mode: Admin Mode
Default: Disabled.
Usage guide: This command is used to enable the ANYCAST RP debug of the router. It can display the handling PIM register packet information of the switch (packet) and the event information (event).
Example: Enable the ANYCAST RP function debug.

active500EM#debug PIM anycast-rp

 

10.1.5.2 ip PIM anycast-rp

Command: ip PIM anycast-rp
no ip PIM anycast-rp
Function: Enable the ANYCAST RP of the switch. The no command disables the ANYCAST RP function.
Parameters: None.
Command mode: Global Configuration Mode
Default: Not enabled.
Usage guide: This command will globally enable the ANYCAST RP protocol. In order to make ANYCAST RP work, it is necessary to configure self-rp-address and other-rp-address set.
Example: Enable ANYCAST RP in Global Configuration Mode.

active500EM(config)#ip PIM anycast-rp

 

10.1.5.3 ip PIM anycast-rp

Command: ip PIM anycast-rp <anycast-rp-addr> <other-rp-addr>
no ip PIM anycast-rp <anycast-rp-addr> <other-rp-addr>
Function: Configure ANYCAST RP address (ARA) and the unicast addresses of other RP communicating with this router (as a RP). The no command cancels the unicast address of another RP in accordance with the configured RP address.
Parameters:

  • <anycast-rp-addr>: RP address; the absence of the candidate interface is allowed.
  • <other-rp-addr>: unicast address of other RP communicating with this router (as a RP).

Command mode: Global Configuration Mode
Default: Not configured.
Usage guide:
1. The anycast-rp-addr configured on this router (as a RP) is the RP address configured on multiple RP in the network, in accordance with the address of RP candidate interface (or Loopback interface). The absence of the candidate interface in associated with the address is allowed when configuring.
2. Configure the other-rp-address of other RP communicating with this router (as a RP). The unicast address identifies other RP and is used to communicate with the local router.
3. Once this router (as a RP) receives the registered message from a DR unicast, it will forward it to other RP in the network to notify all the RP in the network of the source (S.G) state. While forwarding, the router will change the destination address of the register message into other-rp-address.
4. Multiple other-rp-addresses can be configured according to one anycast-rp-addr. Once the register message from a DR is received; it should be forwarded to all of these other RP one by one.
Example: Configure other-rp-address in Global Configuration Mode.

active500EM(config)#ip PIM anycast-rp 1.1.1.1 192.168.3.2

 

10.1.5.4 ip PIM anycast-rp self-rp-address

Command: ip PIM anycast-rp self-rp-address <self-rp-addr>
no ip PIM anycast-rp self-rp-address
Function: Configure the self-rp-address of this router (as a RP). This address will be used to exclusively identify this router from other RP and to communicate with other RP. The no command cancels the configured unicast address used by this router (as a RP) to communicate with other RP.
Parameters:

  • <self-rp-addr>? unicast address used by this router (as a RP) to communicate with other RP.

Command mode: Global Configuration Mode
Default: Not configured.
Usage guide:
1. Once this router (as a RP) receives the register message from DR unicast, it needs to forward the register message to all the other RP in the network notifying them of the source state (S.G). While forwarding the register message, this router will change the source address into self-rp-address.
2. Once this router(as a RP) receives a register message from other RP unicast, such as a register message whose destination is the self-rp-address of this router, it will create a (S,G) state and send back a register-stop message whose destination address is the source address of the register message.
3. self-rp-address has to be the address of a three-layer interface on this router. The configuration is allowed with the absence of the interface.
Example: Configure the self-rp-address of this router in global configuration mode.

active500EM(config)#ip PIM anycast-rp self-rp-address 1.1.1.1

 

10.1.5.5 ip PIM rp-candidate

Command: ip PIM rp-candidate {vlan<vlan-id> |loopback<index> |<ifname>} [<A.B.C.D/M>] [<priority>] no ip PIM rp-candidate
Function: Add a Loopback interface as a RP candidate interface based on the original PIM-SM command. The no command cancels the Loopback interface as a RP candidate interface.
Parameters:

  • <vlan-id>: VLAN ID.
  • <index>: loopback interface index. The valid range is 1 to 1024.
  • <ifname>: interface name.
  • <A.B.C.D/M>:?IP prefix and length.
  • <priority>: priority of RP election. The valid range is from 0 to 255. The default value is 192. The smaller the value set, the higher the priority.

Command mode: Global Configuration Mode
Default Setting: Not configured.
Usage guide: In order to support the ANYCAST RP function, a new rule allows the configuration of a Loopback interface to be the RP candidate interface. The RP candidate interface should be unique and the address should be added to the router to make sure that the PIM router can find the nearest RP. The no command can be used to cancel the RP candidate.
Example: Configure Loopback1 interface as the RP candidate interface in Global Configuration Mode.

active500EM(config)#ip PIM rp-candidate loopback1

 

10.1.5.6 show debugging PIM

Command: show debugging PIM
Function: Display the current state of the ANYCAST RP debug switch.
Parameters: None.
Command mode: Admin Mode
Default: None.
Usage guide: Displays current state of the ANYCAST RP debug switch.
Example: Display the current state of the ANYCAST RP debug switch.

active500EM(config)#show debugging PIM
Debugging status:
  PIM anycast-rp debugging is on

 

10.1.5.7 show ip PIM anycast-rp first-hop

Command: show ip PIM anycast-rp first-hop
Function: Display the ANYCAST RP state information of and display the mrt node information generated in the first hop RP which is currently maintained by the protocol.
Parameters: None.
Command mode: Admin and Configuration Mode
Default: None.
Usage guide: Display the ANYCAST RP state information and display the mrt node information generated in the first hop RP which is currently maintained by the protocol.
Example: Display the state ANYCAST RP state information and display the mrt node information generated in the first hop RP which is currently maintained by the protocol.

active500EM(config)#show ip PIM anycast-rp first-hop
IP Multicast Routing Table
(*,G) Entries: 0
(S,G) Entries: 1
(E,G) Entries: 0
INCLUDE (192.168.1.136, 224.1.1.1)
 Local     .l..............................
Displayed Information Explanation
Entries The number of entries.
INCLUDE The MRT information generated in the first hop RP.

 

10.1.5.8 show ip PIM anycast-rp non-first-hop

Command: show ip PIM anycast-rp non-first-hop
Function: Display the ANYCAST RP state information and display the mrt node information generated in the non first hop RP which is currently maintained by the protocol.
Parameters: None.
Command mode: Admin and Configuration Mode
Default: None.
Usage guide: Display the ANYCAST RP state information and display the mrt node information generated in the non first hop RP which is currently maintained by the protocol; the mrt node information which is created after the first hop RP transfers the register message it received to this RP.
Example: Display the ANYCAST RP state information and display the mrt node information generated in the non first hop RP which is currently maintained by the protocol.

active500EM(config)#show ip PIM anycast-rp non-first-hop
IP Multicast Routing Table
(*,G) Entries: 0
(S,G) Entries: 1
(E,G) Entries: 0
INCLUDE (192.168.10.120, 225.1.1.1)
 Local     .l..............................
Displayed Information Explanation
Entries The number of entries.
INCLUDE The MRT information created in the first hop RP.

 

10.1.5.9 show ip PIM anycast-rp status

Command: show ip PIM anycast-rp status
Function: Display the ANYCAST RP configuration information.
Parameters: None.
Command mode: Admin and Configuration Mode
Default: None.
Usage guide: Display the ANYCAST RP configuration information. Display whether ANYCAST RP is globally enabled, whether the self-rp-address is configured, and the list of the currently configured ANYCAST RP set.
Example: Display the ANYCAST RP configuration information.

active500EM(config)#show ip PIM anycast-rp status
Anycast RP status:
anycast-rp:Enabled!
self-rp-address:192.168.3.2
anycast-rp address: 1.1.1.1
    other rp unicast rp address: 192.168.2.1
    other rp unicast rp address: 192.168.5.1
anycast-rp address: 192.168.1.4
    other rp unicast rp address: 192.168.2.1
Displayed Information Explanation
anycast-rp Identifies if the ANYCAST RP switch is globally enabled.
self-rp-address The configured self-rp-address.
anycast-rp address The configured anycast-rp-address.
other rp unicast rp address The configured other RP communication addresses in relation to the above anycast-rp-address.
other rp unicast rp address The configured other RP communication addresses in relation to the above anycast-rp-address.
anycast-rp address The configured anycast-rp-address*.
other rp unicast rp address The configured other RP communication addresses in relation to the above anycast-rp-address.

 

10.1.6 Commands for PIM-SSM

10.1.6.1 ip multicast ssm

Command: ip multicast ssm {default|range <access-list-number >}
no ip multicast ssm
Function: Configure the range of the PIM ssm multicast address. The no command deletes thhe configured PIM ssm multicast group.
Parameters:

  • default: indicates the default range of PIM ssm multicast group is 232/8.
  • <access-list-number >: applying access-list number. The valid range is from 1 to 99.

Command mode: Global Mode
Default: Not configured.
Usage guide:
1. Once this command is configured, PIM ssm is available.
2. Before configuring this command, make sure?IP PIM multicasting is successful. This command will not work with DVMRP.
3. Access-list can?t use the lists created by ip access-list. The lists created by access-list must be used.
4. Users can execute this command first and then configure the corresponding acl; or delete the corresponding bond acl. After binding, the command “no ip PIM ssm” can release the bind.
5. If ssm is needed, this command should be configured at the related edge route. For example, the local switch with IGMP (must) and multicast source DR or RP (at least one of the two) can be configured with this command. The middle switch only needs PIM-SM enabled.
Example: Configure the switch to enable PIM-SSM. The group?s range is specified by access-list 23.

active500EM(config)#ip multicast ssm range 23

 

10.1.7 Commands for DVMRP

10.1.7.1 debug dvmrp

Command: debug dvmrp [events [neighbor|packet|igmp|kernel|prune[detail]|route] |nsm|mfc|mib| timer [probe[probe-timer|neighbor-expiry-timer]| prune[prune-expiry-timer|prune-retx-timer|graft-retx-timer]|route[report-timer|flash-upd-timer|route-expiry-timer|route-holdown-timer|route-burst-timer]] | packet [ [probe [in|out] | report [in|out] | prune [in|out] | graft [in|out] | graft-ack [in|out] | in|out] ] | all] no debug dvmrp [events[neighbor|packet|igmp|kernel|prune [detail] |route]|nsm|mfc|mib|timer[probe[probe-timer|neighbor-expiry-timer]|prune[prune-expiry-timer|prune-retx-timer|graft-retx-timer]|route[report-timer|flash-upd-timer|route-expiry-timer|route-holdown-timer|route-burst-timer]] | packet[ [probe[in|out] | report[in|out] | prune [in|out] | graft [in|out] | graft-ack [in|out] |in|out] ] | all] Function: Display the DVMRP protocol debug message. The no command disables this debugging switch.
Parameters: None.
Command mode: Admin Mode
Default: Disabled.
Usage guide: Enable this switch and display DVMRP protocol messages.
Example: Display the DVMRP protocol debugging message.

active500EM#debug dvmrp all

 

10.1.7.2 ip dvmrp enable

Command: ip dvmrp enable
no ip dvmrp
Function: Enable DVMRP protocol on the interface. The no command disables DVMRP protocol.
Parameters: None.
Command mode: Interface Configuration Mode
Default: Disabled.
Usage guide: The interface processes DVMRP protocol messages and only executes DVMRP protocol on the interface.
Example: Enable DVMRP Protocol on interface vlan1.

active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip dvmrp enable

 

10.1.7.3 ip dvmrp metric

Command: ip dvmrp metric <metric-val>
no ip dvmrp metric
Function: Configure the interface DVMRP report message metric value. The no command restores the default value.
Parameters:

  • <metric-val>: metric value. The valid value is from 1 to 31.

Command mode: Interface Configuration Mode
Default: 1.
Usage guide: The routing information in DVMRP report messages includes a groupsource network and metric list. After configuring the interface DVMRP report message metric value, all received routing entries from the interface are added as new metric values of the routing. The metric value calculates posion reverse to ensure up-downstream relations. If the metric value of a route on the switch is not less than 32 the route can be reached. If it is downstream of the route, it will transmit report messages included in the route upstream. The route metric increases to 32 based on the original value in order to indicate downstream.
Example: Configure the interface DVMRP report message metric value to be 2.

active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip dvmrp metric 2

 

10.1.7.4 ip dvmrp multicast-routing

Command: ip dvmrp multicast-routing
no ip dvmrp multicast-routing
Function: Globally enable DVMRP protocol. The no command globally disables DVMRP protocol.
Parameters: None.
Command mode: Global Mode
Default: Default.
Usage guide: DVMRP multicast-protocol can enabled after globally executing this command.
Example: Globally enable DVMRP protocol.

active500EM(config)#ip dvmrp multicast-routing

 

10.1.7.5 ip dvmrp output-report-delay

Command: ip dvmrp output-report-delay <delay-val> [<burst-size>] no ip dvmrp output-report-delay
Function: Configure the DVMRP report message delay and quantity transmitted on the interface. The no command restores the default value.
Parameters:

  • <delay-val>: periodically transmitted DVMRP report message delay. The valid value is from 1s to 5s.
  • <burst-size>: size of transmitted message. The valid value is from 1 to 65535.

Command mode: Interface Configuration Mode
Default: Transmitted DVMRP report message delay is defaulted to 1s. Two messages are transmitted at a time.
Usage guide: Message burst can be avoided if an appropriate delay is set.
Example: Configure the DVMRP report message delay and quantity transmitted on the interface.

active500EM(config-if-vlan1)#ip dvmrp output-report-delay 1 1024

 

10.1.7.6 ip dvmrp reject-non-pruners

Command: ip dvmrp reject-non-pruners
no ip dvmrp reject-non-pruners
Function: Configure to reject neighborship with the non pruning/grafting DVMRP router on the interface. The no command restores neighborship.
Parameters: None.
Command mode: Interface Configuration Mode
Default: Not configured.
Usage guide: This command determines if neighboringship will be established with the non pruning/grafting DVMRP router.
Example: Configure to reject neighborship with the non pruning/grafting DVMRP router on the interface.

active500EM(config-if-vlan1)#ip dvmrp reject-non-pruners

 

10.1.7.7 ip dvmrp tunnel

Command: ip dvmrp tunnel <index> <src-ip> <dst-ip>
no ip dvmrp tunnel {<index> |<src-ip> <dst-ip>}
Function: Configure a DVMRP tunnel. The no command deletes a DVMRP tunnel.
Parameters:

  • <src-ip>: source IP address.
  • <dst-ip>: remote neighbor IP address.
  • <index>: tunnel index number. The valid value is from 1 to 65535.

Command mode: Global Mode
Default: Not configured.
Usage guide: Because not all of switches support multicast, DVMRP supports tunnel multicast communication. The tunnel is a way of transmitting multicast data packets among partitioned DVMRP switches without supporting multicast routing. It acts as a virtual network between two DVMRP switches. Multicast data packets in unicast data packets are transmitted to the next supporting multicast switch. DVMRP protocol handles the tunnel interface and the general physical interface. After configuring “no ip dv multicast-routing”, all of the tunnel configurations are deleted.
Example: Configure a DVMRP tunnel.

active500EM(config)#ip dvmrp tunnel 1 12.1.1.1 24.1.1.1

 

10.1.7.8 show ip dvmrp

Command: show ip dvmrp
Function: Display DVMRP protocol information.
Parameters: None.
Command mode: Any Configuration Mode
Default: Not displayed.
Usage guide: The command displays DVMRP protocol statistic information.
Example: Display DVMRP protocol information.

active500EM#show ip dvmrp
DVMRP Daemon Start Time: MON JAN 01 00:00:09 2001
DVMRP Daemon Uptime: 17:37:03
DVMRP Number of Route Entries: 2
DVMRP Number of Reachable Route Entries: 2
DVMRP Number of Prune Entries: 1
DVMRP Route Report Timer: Running
DVMRP Route Report Timer Last Update: 00:00:56
DVMRP Route Report Timer Next Update: 00:00:04
DVMRP Flash Route Update Timer: Not Running

 

10.1.7.9 show ip dvmrp interface

Command: show ip dvmrp interface [<ifname>] Function: Display the DVMRP interface. This command displays the configured interface information for a specified interface.
Parameters:

  • <ifname>: interface name.

Command mode: Any Configuration Mode
Default: Not displayed.
Usage guide: Display the DVMRP interface.
Example: Display the DVMRP interface.

active500EM#show ip dvmrp in vlan4
Address           Interface  Vif    Ver.   Nbr  Type    Remote
                             Index         Cnt          Address
13.1.1.3          Vlan1       1     v3.ff  0    BCAST   N/A
10.1.35.3         Vlan2       0     v3.ff  0    BCAST   N/A
Displayed Information Explanation
Address Address
Interface Interface corresponding to the physical interface name
Vif Index Virtual interface index
Ver Interface supporting version
Nbr Cnt Neighbor count
Type Interface type
Remote Address Remote address

 

10.1.7.10 show ip dvmrp neighbor

Command: show ip dvmrp neighbor [{<ifname> <A.B.C.D> [detail]}|{ <ifname>[detail]}|detail] Function: Display the DVMRP neighbor.
Parameters:

  • <ifname>: interface name (display the specified interface neighbor information).
  • <A.B.C.D>: IP address of neighbor.

Command mode: Any Configuration Mode
Default: Not displayed.
Example: Display interface vlan1 neighbor on Ethernet.

active500EM#show ip dvmrp neighbor
Neighbor          Interface   Uptime/Expires          Maj  Min  Cap
Address                                               Ver  Ver  Flg
10.1.35.5         Vlan2       00:00:16/00:00:29       3    255  2e
Displayed Information Explanation
Neighbor Address Neighbor address
Interface Detect the neighbor?s interface
Uptime/Expires The neighbor uptime/expire time
Maj Ver Major version
Min Ver Mini version
Cap Flg Capacity flag

 

10.1.7.11 show ip dvmrp prune

Command: show ip dvmrp prune [{group <A.B.C.D> [detail]}|{source <A.B.C.D/M> group <A.B.C.D> [detail]}|{source <A.B.C.D/M> [detail] }|detail] Function: Display the DVMRP message forwarding item.
Parameters:

  • group <A.B.C.D>: group address.
  • source <A.B.C.D/M>: source network address/mask.

Command mode: Any Configuration Mode
Default: Not displayed.
Usage guide: This command displays the DVMRP multicast forwarding item; the multicast forwarding table calculated by the?DVMRP protocol.
Example: Display the DVMRP message forwarding item.

active500EM#show ip dvmrp prune
Flags: P=Pruned,H=Host,D=Holddown,N=NegMFC,I=Init
Source            Mask  Group           State    FCR Exptime   Prune/Graft
Address           Len   Address                  Cnt           ReXmit-Time
13.1.1.0          24    239.0.0.1       ..... 1  01:59:56      Off
Displayed Information Explanation
Source Address Source address
Mask Len Mask length
Group Address Group address
State Table item state
FCR Exptime FCR expire time
Prune/Graft ReXmit-Time Prune expire time/ Graft retransmit time

 

10.1.7.12 show ip dvmrp route

Command: show ip dvmrp route [{<A.B.C.D/M>[detail]}|{nexthop <A.B.C.D>[detail]}|{best-match <A.B.C.D> [detail]}|detail] Function: The command displays the DVMRP routing table item.
Parameters:

  • <A.B.C.D/M>: source network address/mask.
  • nexthop <A.B.C.D>: DVMRP nexthop address (upstream neighbor).
  • best-match <A.B.C.D>: Best match destination address.

Command mode: Any Configuration Mode
Default: Not displayed.
Usage guide: The command displays the DVMRP routing table item; DVMRP maintains an individual unicast routing table to check RPF.
Example: Display DVMRP routing.

active500EM#show ip dvmrp route
Flags: N = New, D = DirectlyConnected, H = Holddown
Network           Flags  Nexthop   Nexthop             Metric  Uptime    Exptime
                         Xface     Neighbor
10.1.35.0/24       .D.   Vlan2     Directly Connected    1     00:11:16  00:00:00
13.1.1.0/24        .D.   Vlan1     Directly Connected    1     00:10:22  00:00:00
Displayed Information Explanation
Network Target net segment or address and mask
Flags Routing state flag
Nexthop Xface Next hop interface address
Nexthop Neighbor Next hop neighbor
Metric Routing metric value
Uptime Routing uptime
Exptime Routing expire time

 

10.1.8 Commands for DCSCM

10.1.8.1 access-list (Multicast Destination Control)

Command: access-list <6000-7999> {deny|permit} ip {{<source> <source-wildcard>}|{host-source <source-host-ip>{range<2-65535>|}}|any-source} {{<destination> <destination-wildcard>}|{host-destination <destination-host-ip>{range<2-255>|}}|any-destination}
no access-list <6000-7999> {deny|permit} ip {{<source> <source-wildcard>}|{host-source <source-host-ip>{range<2-65535>|}}|any-source} {{<destination> <destination-wildcard>}|{host-destination <destination-host-ip>{range<2-255>|}}|any-destination}
Function: Configure the destination control multicast access-list. The no command deletes the access-list.
Parameters:

  • <6000-7999>: destination control access-list number.
  • {deny|permit}: deny or permit.
  • <source>: multicast source address.
  • <source-wildcard>: multicast source address wildcard character.
  • <source-host-ip>: multicast source host address.
  • range<2-65535>: source host IP address range.
  • <destination>: multicast destination address.
  • <destination-wildcard>: multicast destination address wildcard character.
  • <destination-host-ip>: multicast destination host address
  • range<2-255>? destination host IP address range.

Command mode: Global Mode
Default: None.
Usage guide: Multicast destination control list ACL is controlled by a specified ACL number from 6000 to 7999. This command configures this ACL. Multicast destination control ACL configures the source IP address and controlled destination IP address (group IP address). The configuration mode is the same as other ACLs and uses the wildcard character to configure the address range and specify a host address or all addresses. ?all address? is 224.0.0.0/4 according to the group IP address, not 0.0.0.0/0 as in other access-lists.
Example: Configure the destination control multicast access-list.

active500EM(config)#access-list 6000 permit ip 10.1.1.0 0.0.0.255 232.0.0.0 0.0.0.255

 

10.1.8.2 access-list (Multicast Source Control)

Command: access-list <5000-5099> {deny|permit} ip {{<source> <source-wildcard>}|{host <source-host-ip>}|any-source} {{<destination> <destination-wildcard>}|{host-destination <destination-host-ip>}|any-destination}
no access-list <5000-5099> {deny|permit} ip {{<source> <source-wildcard>}|{host <source-host-ip>}|any} {{<destination> <destination-wildcard>}|{host-destination <destination-host-ip>}|any-destination}
Function: Configure the source control multicast access-list. The no command deletes the access-list.
Parameters:

  • <5000-5099>: source control access-list number.
  • {deny|permit}: deny or permit.
  • <source>: multicast source address.
  • <source-wildcard>: multicast source address wildcard character.
  • <source-host-ip>: multicast source host address.
  • <destination>: multicast destination address.
  • <destination-wildcard>: multicast destination address wildcard character.
  • <destination-host-ip>: multicast destination host address.

Command mode: Global Mode
Default: None.
Usage guide: Multicast source control list ACL is controlled by a specified ACL number from 5000 to 5099. The command configures this ACL. Multicast source control ACL configures the source and controlled destination IP addresses (group IP address). The configuration mode is the same as other ACLs and uses the wildcard character to configure the address range and specify a host address or all address. ?all address? is 224.0.0.0/4 according to the group IP address and not 0.0.0.0/0 as in other access-lists.
Example: Configure the source control multicast access-list.

active500EM(config)#access-list 5000 permit ip 10.1.1.0 0.0.0.255 232.0.0.0 0.0.0.255

 

10.1.8.3 ip multicast destination-control

Command: ip multicast destination-control <1-4094> <MAC Addr> access-group <6000-7900>
no ip multicast destination-control <1-4094> <MAC Addr> access-group <6000-7900>
Function: To globally enable multicast destination control. The no command disables the multicast destination control globally.
Parameters:

  • <1-4094>: Vlan ID <1-4094>.
  • <MAC Addr>: MAC Address in Hex <A-B-C-D-E-F> with each byte separated by a ?-?.
  • Access-group <6000-7999>.

Command mode: Global mode
Default: None.
Usage Guide: Only after globally enabling the multicast destination control, the other destination control configuration can take effect; the destination access list can be applied to ports, VLAN-MAC and SIP. After configuring this command, IGMP-SNOOPING and IGMP will match according to the rules mentioned above when they try to add ports after receiving IGMP-REPORT.
Example:

active500EM(config)#ip multicast destination-control 1 00-ac-00-00-32-10 access-group 6000

 

10.1.8.4 ip multicast destination-control access-group

Command: ip multicast destination-control access-group <6000-7999>
no ip multicast destination-control access-group <6000-7999>
Function: Configure the multicast destination-control access-list used on the interface. The no command deletes the configuration.
Parameters:

  • <6000-7999>: destination-control access-list number.

Command mode: Interface Configuration Mode
Default: None.
Usage guide: The command functions when global multicast destination-control is enabled. If IGMP-SPOOPING is enabled, it can be used to add the interface to the multicast group and match the configured access-list.
Example: Configure the multicast destination-control access-list used on the interface.

active500EM(config)#interface ethernet1/0/4
active500EM(config-if-ethernet 1/0/4)#ip multicast destination-control access-group 6000

 

10.1.8.5 ip multicast destination-control access-group (sip)

Command: ip multicast destination-control <IPADDRESS/M> access-group <6000-7999>
no ip multicast destination-control <IPADDRESS/M> access-group <6000-7999>
Function: Configure the multicast destination-control access-list used on a specified net segment. The no command deletes this configuration.
Parameters:

  • <IPADDRESS/M>: IP address and mask length.
  • <6000-7999>: destination control access-list number.

Command mode: Global Mode
Default: None.
Usage guide: The command functions when “global multicast destination-control” is enabled. If igmp-snooping or IGMP is enabled, members to the multicast group can be added. If configuring multicast destination-control on a specified net segment of the transmitted igmp-report and there is a match on the configured access-list (such as matching permit), the interface can be added, otherwise it will not be added. If group or source in “show ip igmp group detail” has been established before executing the command, the?”clear ip igmp groups” command must be used to clear relevant groups in Admin Mode.
Example: Configure the multicast destination-control access-list used on specified net segment.

active500EM(config)#ip multicast destination-control 10.1.1.0/24 access-group 6000

 

10.1.8.6 ip multicast destination-control access-group (vmac)

Command: ip multicast destination-control <1-4094> <macaddr >access-group <6000-7999>
no ip multicast destination-control <1-4094> <macaddr >access-group <6000-7999>
Function: Configure the multicast destination-control access-list used on a specified vlan-mac. The no command deletes this configuration.
Parameters:

  • <1-4094>: VLAN-ID.
  • <macaddr>: transmitting source MAC address of IGMP-REPORT. The valid format is ?xx-xx-xx-xx-xx-xx?.
  • <6000-7999>: destination-control access-list number.

Command mode: Global Mode
Default: None.
Usage guide: This command functions when global multicast destination-control is enabled. If IGMP-snooping is enabled, it can be used to add the members to a multicast group. If configuring multicast destination-control to the source MAC address of transmitted igmp-report and there is a match on the configured access-list (such as matching: permit), the interface can be added, otherwise it will not be added.
Example: Configure the multicast destination-control access-list used on a specified vlan-mac.

active500EM(config)#ip multicast destination-control 1 00-01-03-05-07-09 access-group 6000

 

10.1.8.7 ip multicast policy

Command: ip multicast policy <IPADDRESS/M> <IPADDRESS/M> cos <priority>
no ip multicast policy <IPADDRESS/M> <IPADDRESS/M> cos
Function: Configure multicast policy. The no command deletes it.
Parameters:

  • <IPADDRESS/M>: multicast source address and mask length, destination address and mask length.
  • <priority>: specified priority. The valid range is from 0 to 7.

Command mode: Global Mode
Default: None.
Usage guide: The command uses a specified value through the switch matching priority of the specified range multicast data packets and modifies the TOS to the specified same value simultaneously. The packet transmitted in UNTAG mode does not modify its priority.
Example: Configure multicast policy.

active500EM(config)#ip multicast policy 10.1.1.0/24 225.1.1.0/24 cos 7

 

10.1.8.8 ip multicast source-control

Command: ip multicast source-control
no ip multicast source-control
Function: Globally enable multicast source control. The no command restores global multicast source control to disabled.
Parameters: None.
Command mode: Global Mode
Default: Disabled.
Usage guide: The source control access-list applies to the interface and enables global multicast source control. Global multicast source control can be disabled without configuring the source control access-list on every interface. After configuring the command, multicast data received from every interface will not have a matching multicast source control list item. The data will be removed by the switches. Only multicast data matching to?”permit” can be received and forwarded.
Example: Globally enable multicast source control.

active500EM(config)#ip multicast source-control

 

10.1.8.9 ip multicast source-control access-group

Command: ip multicast source-control access-group <5000-5099>
no ip multicast source-control access-group <5000-5099>
Function: Configure multicast source control access-list used on the interface. The no command deletes the configuration.
Parameters:

  • <5000-5099>: source control access-list number.

Command mode: Interface Configuration Mode
Default: None.
Usage guide: The command can be configured only by enabling global multicast source control. Once enabled, it will match multicast data messages imported from the interface according to the configured access-list, such as matching: permit. The message will be received and forwarded, otherwise, the message will be removed.
Example: Configure the multicast source control access-list used on interface.

active500EM(config)#interface ethernet1/0/4
active500EM(config-if-ethernet1/0/4)#ip multicast source-control access-group 5000
active500EM(config-if-ethernet1/0/4)#
active500EM(router-msdp)#default-rpf-peer 10.0.0.1 rp-policy 10

 

10.1.8.10 multicast destination-control

Command: multicast destination-control
no multicast destination-control
Function: Configure to globally enable IPv4 and IPv6 multicast destination control. After configuring this command, IPv4 and IPv6 multicast destination control will take effect at the same time. The no command recovers and disables the IPv4 and IPv6 multicast destination control globally.
Parameters: None.
Command mode: Global Configuration Mode
Default: Disabled.
Usage guide: After globally enabling the multicast destination control, the other destination control configuration takes effect. The destination access list can be applied to ports, VLAN-MAC, and SIP. After configuring this command, IGMP-SNOOPING and IGMP will match according to the rules mentioned above when they try to add ports after receiving IGMP-REPORT.
Example: Configure to globally enable IPv4 and IPv6 multicast destination control.

active500EM(config)#multicast destination-control

 

10.1.8.11 show ip multicast destination-control

Command: show ip multicast destination-control [detail] show ip multicast destination-control interface <Interfacename> [detail] show ip multicast destination-control host-address <ipaddress> [detail] show ip multicast destination-control <vlan-id> <mac-address> [detail] Function: Display multicast destination control.
Parameters:

  • detail: identifies whether the display information is shown in detail.
  • <Interfacename>: interface name or interface aggregation name, such as Ethernet1/0/1, port-channel 1 or Ethernet1/0/1.
  • <ipaddress>: Host IP address, format A.B.C.D.
  • <vlan-id>: Vlan ID; Range <1-4094>.
  • <mac-address>: host destination mac.

Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: The command displays configuration multicast destination control rules, including detail option, and access-list information.
Example: Display multicast destination control.

active500EM(config)#show ip multicast destination-control
ip multicast destination-control is enabled
ip multicast destination-control 11.0.0.0/8 access-group 6003
ip multicast destination-control 1 00-03-05-07-09-11 access-group 6001
multicast destination-control access-group 6000 used on interface Ethernet1/0/13

 

10.1.8.12 show ip multicast destination-control access-list

Command: show ip multicast destination-control access-list [<6000-7999>] Function: Display the configuration destination control multicast access-list.
Parameters:

  • <6000-7999>: access-list number.

Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: The command displays the configuration destination control multicast access-list.
Example: Display the configuration destination control multicast access-list.

active500EM#show ip multicast destination-control acc
access-list 6000 deny ip any any-destination
access-list 6000 deny ip any host-destination 224.1.1.1
access-list 6000 deny ip host 2.1.1.1 any-destination
access-list 6001 deny ip host 2.1.1.1 225.0.0.0 0.255.255.255
access-list 6002 permit ip host 2.1.1.1 225.0.0.0 0.255.255.255
access-list 6003 permit ip 2.1.1.0 0.0.0.255 225.0.0.0 0.255.255.255

 

10.1.8.13 show ip multicast policy

Command: show ip multicast policy
Function: Display the configuration multicast policy.
Parameters: None.
Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: Displays the configuration multicast policy.
Example: Display the configuration multicast policy.

active500EM#show ip multicast policy
ip multicast-policy 10.1.1.0/24 225.0.0.0/8 cos 5

 

10.1.8.14 show ip multicast source-control

Command: show ip multicast source-control [detail] show ip multicast source-control interface <Interfacename> [detail]
Function: Display multicast source control configuration.
Parameters:

  • detail: identifies if information is displayed in detail.
  • <Interfacename>: interface name, such as Ethernet 1/0/1 or Ethernet1/0/1.

Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: The command displays configuration multicast source control rules including detail option and access-list information.
Example: Display multicast source control configuration.

active500EM#show ip multicast source-control detail
ip multicast source-control is enabled
Interface Ethernet1/0/13 use multicast source control access-list 5000
access-list 5000 permit ip 10.1.1.0 0.0.0.255 232.0.0.0 0.0.0.255
access-list 5000 deny ip 10.1.1.0 0.0.0.255 233.0.0.0 0.255.255.255

 

10.1.8.15 show ip multicast source-control access-list

Command: show ip multicast source-control access-list [<5000-5099>] Function: Display the configuration source control multicast access-list.
Parameters:

  • <5000-5099>: access-list number.

Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: Displays the configuration source control multicast access-list.
Example: Display the configuration source control multicast access-list.

active500EM#show ip multicast source-control access-list
access-list 5000 permit ip 10.1.1.0 0.0.0.255 232.0.0.0 0.0.0.255
access-list 5000 deny ip 10.1.1.0 0.0.0.255 233.0.0.0 0.255.255.255

 

10.1.9 Commands for IGMP

10.1.9.1 clear ip igmp group

Command: clear ip igmp group [<A.B.C.D> | <IFNAME>] Function: Delete the group record of the specific group or interface.
Parameters:

  • <A.B.C.D>: the specific group address.
  • <IFNAME>: the specific interface.

Command mode: Admin Configuration Mode
Default: None.
Usage guide: Use the show command to check the deleted group record.
Example: Delete all groups.

active500EM#clear ip igmp group

Related command: show ip igmp group
 

10.1.9.2 debug igmp event

Command: debug igmp event
no debug igmp event
Function: Enable debugging of the IGMP event. The no command disables the debugging.
Parameters: None.
Command mode: Admin Mode
Default: Disabled.
Usage guide: Enable debugging of the switch if querying IGMP event information.
Example: Enable debugging of the IGMP event.

active500EM#debug igmp event
igmp event debug is on
01:04:30:56: IGMP: Group 224.1.1.1 on interface vlan1 timed out

 

10.1.9.3 debug igmp packet

Command: debug igmp packet
no debug igmp packet
Function: Enable switch debugging for IGMP message information. The no command disables the debugging.
Parameters: None.
Command mode: Admin Mode
Default: Disabled.
Usage guide: Enable the debugging when querying IGMP message information.
Example:? Enable the debugging when querying IGMP message information.

active500EM#debug igmp packet
igmp packet debug is on
Switch #02:17:38:58: IGMP: Send membership query on dvmrp2 for 0.0.0.0
02:17:38:58: IGMP: Received membership query on dvmrp2 from 192.168.1.11 for 0.0 .0.0
02:17:39:26: IGMP: Send membership query on vlan1 for 0.0.0.0
02:17:39:26: IGMP: Received membership query on dvmrp2 from 192.168.1.11 for 0.0 .0.0

 

10.1.9.4 ip igmp access-group

Command: ip igmp access-group {<acl-num> | <acl-name>}
no ip igmp access-group
Function: Configure the interface to filter the IGMP group. The no command cancels the filter condition.
Parameters:

  • <acl-num>: access list number. The valid range is from 1 to 99.
  • <acl-name>: access list name.

Command mode: Interface Configuration Mode
Default: No filter condition.
Usage guide: Configure the interface to filter groups, permit, or deny groups from joining.
Example: Configure the interface vlan1 to permit group 224.1.1.1, deny group 224.1.1.2.

active500EM(config)#access-list 1 permit 224.1.1.1 0.0.0.0
active500EM(config)#access-list 1 deny 224.1.1.2 0.0.0.0
active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip igmp access-group 1

 

10.1.9.5 ip igmp immediate-leave

Command: ip igmp immediate-leave group-list {<number>|<name>}
no ip igmp immediate-leave
Function: Configure IGMP to function in immediate-leave mode. When the host transmits to a member to leave a group, the router does not transmit the query, it confirms there is no member of this group in the subnet. The no command cancels immediate-leave mode.
Parameters:

  • <number>: access-list SN. The valid value is from 1 to 99.
  • <name>: access-list name.

Command mode: Interface Configuration Mode
Default: No immediate-leave group configured.
Usage guide: The command applies in only one host condition in the subnet.
Example: Configure immediate-leave mode on access-group list 1.

active500EM(config-if-vlan1)#ip igmp immediate-leave group-list 1

 

10.1.9.6 ip igmp join-group

Command: ip igmp join-group <A.B.C.D >
no ip igmp join-group <A.B.C.D >
Function: Configure the interface to join IGMP groups. The no command cancels the joining.
Parameters:

  • <A.B.C.D>: the group address.

Command mode: Interface Configuration Mode
Default: Do not join.
Usage guide: When the switch is the host, the command configures the?host to join some groups. For example, if configuring the interface join-group 224.1.1.1, it will transmit IGMP member reports (including group 224.1.1.1) when the switch receives IGMP group queries transmitted by other switches.
Example: Configure join-group 224.1.1.1 on interface vlan1.

active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip igmp join-group 224.1.1.1

 

10.1.9.7 ip igmp last-member-query-interval

Command: ip igmp last-member-query-interval <interval>
no ip igmp last-member-query-interval
Function: Configure the interval of a specified group query transmitting on the interface. The no command cancels configuration and restores the default value.
Parameters:

  • <interval>: specified group query interval. The valid range is from 1000ms to 25500ms. The value is an integer multiplied by 1000ms. If the input value is not an integer multiple of 1000ms, the system automatically changes the value to an integer multiple of 1000ms.

Command mode: Interface Configuration Mode
Default: 1000ms.
Usage guide: Configure the specified group query transmitting interval on the interface.
Example: Configure interface vlan1 IGMP last-member-query-interval to 2000.

active500EM(config)#int vlan 1
active500EM(config-if-vlan1)#ip igmp last-member-query-interval 2000

 

10.1.9.8 ip igmp limit

Command: ip igmp limit <state-count>
no ip igmp limit
Function: Configure the limit IGMP state-count on the interface. The no command cancels the value and restores the default value.
Parameters:

  • <state-count>: maximum IGMP state reserved by the interface. The valid range is from 1 to 65000.

Command mode: Interface Configuration Mode
Default: 0, no limit.
Usage guide: After configuring the maximum state state-count, the interface saves states which are not more than state-count groups and sources. If it reaches the upper limit of state-count, it does not handle any member identity report received from a related new group. If IGMP group states are saved before configuring the command, it deletes all of the states, and then immediately transmits the IGMP general query to collect the member identity report that is not more than the state-count group. Static state and static source are not in the limit.
Example: Configure the interface vlan1 IGMP limit to 4000.

active500EM(config)#int vlan 1
active500EM(config-if-vlan1)#ip igmp limit 4000

 

10.1.9.9 ip igmp query-interval

Command: ip igmp query-interval <time-val>
no ip igmp query-interval
Function: Configure transmitted IGMP query information periodical interval. The no command restores the default value.
Parameters:

  • <time-val>: transmitted IGMP query information periodic interval. The valid value is from 1s to 65535s.

Command mode: Interface Configuration Mode
Default: 125s.
Usage guide: Periodically transmitting IGMP query information on the interface when the interface enables group multicast protocol. The command configures this query period time.
Example: Configure the periodically transmitted IGMP query message interval to 10s.

active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip igmp query-interval 10

 

10.1.9.10 ip igmp query-max-response-time

Command: ip igmp query-max-response-time <time-val>
no ip igmp query- max-response-time
Function: Configure the interface IGMP query-max-response-time. The no command restores the default value.
Parameters:

  • <time-val>: interface IGMP query-max-response-time. The valid value is from 1s to 25s.

Command mode: Interface Configuration Mode
Default: 10s.
Usage guide: After the switch receives a query message, the host will configure a timer for its affiliated multicast group. The timer value is selected randomly from 0 to the maximum response time. The host will transmit the multicast group member report message. Based on the configured maximum response time, the host can quickly respond to the query message. The router can also quickly grasp the multicast group member status.
Example: Configure the interface IGMP query-max-response-time to 20s.

active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip igmp query- max-response-time 20

 

10.1.9.11 ip igmp query-timeout

Command: ip igmp query-timeout <time-val>
no ip igmp query-timeout
Function: Configure the interface IGMP query timeout period. The no command restores the default value.
Parameters:

  • <time-val>: IGMP query-timeout. The valid value is from 60s to 300s.

Command mode: Interface Configuration Mode
Default: 255s.
Usage guide: When multiple IGMP switches exist on the shared network, a switch will be voted as the query processor on the sharing network and the other switches will be monitoring the query processor state. If it does not receive query messages transmited by the query processor over the query time-out period, it will identfy another switch as the new query processor.
Example: Configure the IGMP query message timeout on the interface to 100s.

active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip igmp query-timeout 100

 

10.1.9.12 ip igmp robust-variable

Command: ip igmp robust-variable <value>
no ip igmp robust-variable
Function: Configure the robust variable value. The no command restores the default value.
Parameters:

  • value: value. The valid range is from 2 to 7.

Command mode: Interface Configuration Mode
Default: 2.
Usage guide: The default value is recommended for use. Robustness Variable: The Robustness Variable allows tuning for the expected packet loss on a subnet. If a subnet is expected to lose packets, the Robustness Variable may be increased. IGMP is robust to (Robustness Variable -1) packet losses. The Robustness Variable?must not?be 0 and?should not?be 1. The default is 2.
Example: Configure the robust variable value.

active500EM(config-if-vlan1)#ip igmp robust-variable 3

 

10.1.9.13 ip igmp static-group

Command: ip igmp static-group <A.B.C.D > [source <A.B.C.D >] no ip igmp static -group <A.B.C.D > [source <A.B.C.D >]
Function Configure the interface to join specific IGMP static groups. The no command cancels this joining.
Parameters:

  • static-group <A.B.C.D>: static group address.
  • source <A.B.C.D>: SSM source address of configuration.

Command mode: Interface Configuration Mode
Default: Do not join the static group.
Usage guide: When configuring the interface to join a static group, the interface will receive multicast packets of the static group whether the interface has a real receiver or not. For example, if configuring the interface to join the static group 224.1.1.1, the interface will always receive multicast packets for group 224.1.1.1 whether the interface has a receiver or not.
Example: Configure static-group 224.1.1.1 on interface vlan1.

active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip igmp static-group 224.1.1.1

 

10.1.9.14 ip igmp version

Command: ip igmp version <version>
no ip igmp version
Function: Configure the IGMP version on the interface. The no command restores the default value.
Parameters:

  • <version>: IGMP configuration version (currently supports version 1, 2 and 3).

Command mode: Interface Configuration Mode
Default: Version 2.
Usage guide: The command supports upward compatibility of versions. IGMPv1 & v2 cannot communicate by default. Therefore, the versions must be configured to the same version of IGMP in the same network. The interface is configured to the corresponding version when other routers on connected interfaces (which are not upgraded to IGMPv3) need to join the IGMP subnet.
Example: Configure IGMP on the interface to version 3.

active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip igmp version 3

 

10.1.9.15 show ip igmp groups

Command: show ip igmp groups [<A.B.C.D>] [detail] Function: Display IGMP group information.
Parameters:

  • <A.B.C.D>: group address (querying specified group information).
  • Detail: displays group information in detail.

Command mode: Admin Mode
Default: Do not display.
Usage guide: Display IGMP group information
Example: Display IGMP group information.

active500EM(config)#show ip igmp groups
IGMP Connected Group Membership (2 group(s) joined)
Group Address    Interface            Uptime    Expires   Last Reporter
226.0.0.1        Vlan1                00:00:01  00:04:19  1.1.1.1
239.255.255.250  Vlan1                00:00:10  00:04:10  10.1.1.1
Displayed Information Explanation
Group Address Multicast group IP address
Interface Interface affiliated with multicast group
Uptime Multicast group uptime
Expires Multicast group expire time
Last Reporter Last reporter to the host of the multicast group
active500EM(config)#show ip igmp groups 234.1.1.1 detail
IGMP Connect Group Membership (2 group(s) joined)
Flags: SG - Static Group, SS - Static Source, SSM - SSM Group, V1 - V1 Host Pres
ent, V2 - V2 Host Present
Interface: 	Vlan1
Group: 		234.1.1.1
Flags:
Uptime: 	00:00:19
Group Mode: 	INCLUDE
Last Reporter: 	10.1.1.1
Exptime: 	stopped
Source list: (2 members  S - Static)
Source Address   Uptime    v3 Exp    Fwd  Flags
 1.1.1.1         00:00:19  00:04:01  Yes
 2.2.2.2         00:00:19  00:04:01  Yes
Displayed Information Explanation
Group Multicast group IP address
Interface Interface affiliated with Multicast group
Flags Group property flag
Uptime Multicast group uptime
Group Mode Group mode, including INCLUDE and EXCLUDE. Group V3 will be available, group V1 and group V2 are regards as EXCLUDE mode.
Exptime Multicast group expire time
Last Reporter Last reporter to the host of the Multicast group
Source Address Source address of this group
V3 Exp Source expire time
Fwd If the data of the source is forwarded or not.
Flags Source property flag

 

10.1.9.16 show ip igmp interface

Command: show ip igmp interface {vlan <vlan-id>|<ifname>}
Function: Display related IGMP information on the interface.
Parameters:

  • <vlan-id>: VLAN ID, range <1-4094>
  • <ifname>: interface name (displaying IGMP information of the specified interface).

Command mode: Admin Mode
Default: Do not display.
Usage guide: Display related IGMP information on the interface.
Example: Display interface vlan1 IGMP message on the Ethernet interface.

active500EM(config)#show ip igmp interface Vlan1
Interface Vlan1(2005)
 Index 2005
 Internet address is 10.1.1.2
 IGMP querier
 IGMP current version is V3, 2 group(s) joined
 IGMP query interval is 125 seconds
 IGMP querier timeout is 255 seconds
 IGMP max query response time is 10 seconds
 Last member query response interval is 1000 ms
 Group Membership interval is 260 seconds
 IGMP is enabled on interface

 

10.1.10 Commands for IGMP Snooping

10.1.10.1 clear ip igmp snooping vlan

Command: clear ip igmp snooping vlan <1-4094> groups [<A.B.C.D>] Function: Delete the group record of the specific VLAN.
Parameters:

  • <1-4094>: specific VLAN ID.
  • <A.B.C.D>: specific group address.

Command mode: Admin Configuration Mode
Default: None.
Usage guide: Use show command to check the deleted group record.
Example: Delete all groups.

active500EM#clear ip igmp snooping vlan 1 groups

Related command: show ip igmp snooping vlan <1-4094>
 

10.1.10.2 clear ip igmp snooping vlan <1-4094> mrouter-port

Command: clear ip igmp snooping vlan <1-4094> mrouter-port [ [ethernet] <IFNAME> ] Function: Delete the mrouter port of the specific VLAN.
Parameters:

  • <1-4094>: specific VLAN ID.
  • ethernet: Ethernet interface.
  • <IFNAME>: port name.

Command mode: Admin Configuration Mode
Usage guide: Use show command to check the deleted mrouter port of the specific VLAN.
Example: Delete mrouter port in vlan 1.

active500EM#clear ip igmp snooping vlan 1 mrouter-port

Related command: show ip igmp snooping mrouter-port
 

10.1.10.3 debug igmp snooping all/packet/event/timer/mfc

Command: debug igmp snooping {all|event|mfc|packet|timer}
no debug igmp snooping {all|event|mfc|packet|timer}
Function: Enable the IGMP Snooping on the switch. The no command disables the debugging.
Parameters: None.
Command mode: Admin Mode
Default: IGMP snooping debugging switch is disabled on the switch.
Usage guide: This command is used to enable the IGMP Snooping debugging function on the switch. IGMP data Packet messages can be shown with ?packet? parameter. Event messages are shown with ?event?. Hardware entry messages are shown with ?mfc?. Timer messages are shown with ?timer?. All debugging messages are shown with ?all?.
Example: Enable IGMP snooping ?all? on the switch.

active500EM#debug igmp snooping all

 

10.1.10.4 ip igmp snooping

Command: ip igmp snooping
no ip igmp snooping
Function: Enable the IGMP snooping function. The no command disables this function.
Parameters: None.
Command mode: Global Mode
Default: IGMP snooping is disable.
Usage guide: Use this command to enable IGMP Snooping. The no command disables this function.
Example: Enable IGMP snooping.

active500EM(config)#ip igmp snooping

 

10.1.10.5 ip igmp snooping proxy

Command: ip igmp snooping proxy
no ip igmp snooping proxy
Function: Enable the IGMP snooping proxy function. The no command disables the function.
Parameters: None.
Command mode: Global Mode
Default: Enabled.
Usage guide: Enables the IGMP snooping proxy function.
Example: Enable the IGMP snooping proxy function on the active500EM.

active500EM(config)#no ip igmp snooping proxy

 

10.1.10.6 ip igmp snooping vlan

Command: ip igmp snooping vlan <vlan-id>
no ip igmp snooping vlan <vlan-id>
Function: Enable the IGMP snooping function for the specified VLAN. The no command disables the IGMP snooping function for the specified VLAN.
Parameters:

  • <vlan-id>: VLAN number.

Command mode: Global Mode
Default: IGMP snooping is disabled.
Usage guide: Configure IGMP snooping on specified VLAN, the Global IGMP Snooping should be enabled. Disable IGMP snooping on a specified VLAN with the no command.
Example: Enable IGMP Snooping for VLAN 100 in Global Mode.

active500EM(config)#ip igmp snooping vlan 100

 

10.1.10.7 ip igmp snooping vlan immediate-leave

Command: ip igmp snooping vlan <vlan-id> immediate-leave
no ip igmp snooping vlan <vlan-id> immediate-leave
Function: Enable the IGMP snooping fast leave function for the specified VLAN. The no command disables the IGMP snooping fast leave function.
Parameters:

  • <vlan-id>: VLAN number.

Command mode: Global Mode
Default: Disabled.
Usage guide: Enable the IGMP snooping immediate-leave function in the specified VLAN. The no command disables the immediate-leave function of IGMP Snooping.
Example: Enable the IGMP snooping fast leave function for VLAN 100.

active500EM(config)#ip igmp snooping vlan 100 immediate-leave

 

10.1.10.8 ip igmp snooping vlan l2-general-querier

Command: ip igmp snooping vlan < vlan-id > l2-general-querier
no ip igmp snooping vlan < vlan-id > l2-general-querier
Function: Set this VLAN to layer 2 general querier.
Parameters:

  • <vlan-id>: VLAN ID number. The valid range is from 1 to 4094.

Command mode: Global Mode
Default: VLAN is set to IGMP snooping layer 2 general querier.
Usage guide: Configure a layer 2 general querier on a segment. IGMP snooping function will be enabled by this command. If it is not enabled on this VLAN before configuring, the IGMP snooping function will not be disabled when disabling the layer 2 general querier function. This command sends general queries periodically to help switches within this segment learn mrouter ports.
There are three IGMP snooping learn mrouter paths:
1. Port receives the IGMP query messages.
2. Port receives multicast protocol packets, supports DVMRP, and PIM.
3. Static configured port.
Example: Set this VLAN to layer 2 general querier.

active500EM(config)#ip igmp snooping vlan 1 l2-general-querier

 

10.1.10.9 ip igmp snooping vlan l2-general-querier-source

Command: ip igmp snooping vlan <vlanid> L2-general-query-source <A.B.C.D>
no ip igmp snooping vlan <vlanid> L2-general-query-source
Function: Configure the query source address of?IGMP snooping.
Parameters:

  • <vlanid>: VLAN id. The valid value should be 1 to 4094.
  • <A.B.C.D>: source address of the query operation.

Command mode: Global Mode
Default: 0.0.0.0.
Usage guide: This command is not supported on Windows 2000/XP to query with the source address of 0.0.0.0. The layer 2 query source address configuration will not function. The client will stop sending requesting datagrams after one is sent. After a period of time it cannot receive multicast datagrams.
Example: Configure the query source address of?IGMP snooping.

active500EM(config)#ip igmp snooping vlan 2 L2-general-query-source 192.168.1.2

 

10.1.10.10 ip igmp snooping vlan l2-general-querier-version

Command: ip igmp snooping vlan <vlanid> L2-general-query-version <version>
Function: Configure?IGMP snooping.
Parameters:

  • <vlan-id>: VLAN id. The valid values are between 1 and 4094.
  • <version>: version number. The valid values are between 1 and 3.

Command mode: Global Mode
Default: Version 3.
Usage guide: When the switch is connected to a V1 and V2 capable environment, and the VLAN has a layer 2 query configuration, the VLAN can be queried only if the version number has been specified. This command is used to query the layer 2 version number.
Example: Configure?IGMP snooping.

active500EM(config)#ip igmp snooping vlan 2 L2-general-query-version 2

 

10.1.10.11 ip igmp snooping vlan limit

Command: ip igmp snooping vlan <vlan-id> limit {group <g-limit> | source <s-limit>}
no ip igmp snooping vlan <vlan-id> limit
Function: Configure the VLAN max group count and the max source count of every group. The no command cancels this configuration.
Parameters:

  • <vlan-id>: VLAN number.
  • <g-limit>?<1-65535>, max number of groups joined.
  • <s-limit>?<1-65535>, max number of source entries in each group, consisting of included and excluded sources.

Command mode: Global Mode
Default: Maximum 50 groups, with each group capable of 40 source entries.
Usage guide: When the number of joined groups reaches the limit, a new group requesting to join will be rejected to prevent hostile attacks. To use this command, IGMP snooping must be enabled on the VLAN. The no command restores the default. This command will not be configured to ?no limit?. The default value should be used. If layer 3 IGMP is in operation, the configuration must be in accordance with the IGMP configuration.
Example: Configure the VLAN max group count and the max source count of every group.

active500EM(config)#ip igmp snooping vlan 2 limit group 300

 

10.1.10.12 ip igmp snooping vlan interface IFNAME limit

Command? ip igmp snooping vlan <vlan-id> interface (ethernet|port-channel| ) <IFNAME> limit {group <1-65535>| source <1-65535>} strategy (replace|drop)
no ip igmp snooping vlan <1-4094> interface (ethernet|port-channel| ) IFNAME limit group source strategy
Function Configure the number of groups which are allowed to join and the source maximum for each group in the IGMP Snooping port. Configure the upper limit, including ?replace? and ?drop?. The no command configures to ?no limitation?.
Parameters?

  • <vlan-id>: VLAN ID. The valid range is between 1 and 4094.
  • ethernet? Ethernet port name.
  • port-channel: port aggregation.
  • <IFNAME>? interface name.
  • group <1-65535>?maximum number of groups allowed to join.
  • source <1-65535>?maximum number of source table entries in each group, consisting of include and exclude source.
  • replace? replace the group and source information.
  • drop? drop the new group and source information.

Command mode: Global Mode
Default: No limitation.
Usage guide: When the number of groups joined under the port, or the number of sources in this group exceeds the limit, the switch will act based on the configuration. If the configuration is drop, the new group and source information will be dropped. If the configuration is replace, it will find a dynamic group and source from the port to delete and replace and add the new group and source information. The premise of using this command is that this VLAN is enabled using the IGMP Snooping function. The no command configures to ?no limitation?.
Example? Configure the number of groups that are allowed to join and the source maximum in each group under the IGMP Snooping port.

active500EM(config)#ip igmp snooping vlan 2 interface ethernet 1/0/11 limit group 300 source 200 strategy replace

 

10.1.10.13 ip igmp snooping vlan mrouter-port interface

Command: ip igmp snooping vlan <vlan-id> mrouter-port interface [ethernet|port-channel] <ifname>
no ip igmp snooping vlan <vlan-id> mrouter-port interface [ethernet>|port-channel] <ifname>
Function: Configure the VLAN static mrouter port. The no command cancels this configuration.
Parameters:

  • <vlan-id>: vlan ID. The valid range is between 1 and 4094.
  • ethernet: Ethernet port name.
  • port-channel: port aggregation.
  • <ifname>: interface name.

Command mode: Global Mode
Default: No static mrouter port on the VLAN.
Usage guide: When a port is a static mrouter port while also a dynamic mrouter port, it will be recognized as a static mrouter port. Use the no command to delete the static mrouter port.
Example: Configure the VLAN static mrouter port.

active500EM(config)#ip igmp snooping vlan 2 mrouter-port interface ethernet1/0/13

 

10.1.10.14 ip igmp snooping vlan mrouter-port learnPIM

Command: ip igmp snooping vlan <vlan-id> mrouter-port learnPIM
no ip igmp snooping vlan <vlan-id> mrouter-port learnPIM
Function: Enable the specified VLAN to learn the mrouter-port (according to PIM packets). The no command will disable the function.
Parameters:

  • <vlan-id>: specified VLAN ID. The valid range is from 1 to 4094.

Command mode: Global Mode
Default: Enabled.
Usage guide: Enable the specified VLAN to learn the mrouter-port (according to PIM packets). After a port receives PIM packets, it will be set to the?mrouter port to implement automatic learning.
Example: Disable the vlan 100 from learning mrouter-port (according to PIM packets).

active500EM(config)#no ip igmp snooping vlan 100 mrouter-port learnPIM

 

10.1.10.15 ip igmp snooping vlan mrpt

Command: ip igmp snooping vlan <vlan-id> mrpt <value>
no ip igmp snooping vlan <vlan-id> mrpt
Function: Configure survive time of the mrouter port.
Parameters:

  • <vlan-id>: VLAN ID. The valid range is from 1 to 4094.
  • <value>: mrouter port survive period. The valid range is between 1 and 65535 seconds.

Command mode: Global Mode
Default: 255s.
Usage guide: This command is valid on dynamic mrouter ports but not on mrouter ports. To use this command, IGMP Snooping on this VLAN should be enabled.
Example: Configure survive time of the mrouter port.

active500EM(config)#ip igmp snooping vlan 2 mrpt 100

 

10.1.10.16 ip igmp snooping vlan query-interval

Command: ip igmp snooping vlan <vlan-id> query-interval <value>
no ip igmp snooping vlan <vlan-id> query-interval
Function: Configure the query interval.
Parameters:

  • <vlan-id>: VLAN ID. The valid range is from 1 to 4094.
  • <value>: query interval. The valid range is between 1 and 65535 seconds.

Command mode: Global Mode
Default: 125s.
Usage guide: The default settings should be used. If layer 3 IGMP is running, the configuration should be in accordance with IGMP configuration.
Example: Configure the query interval.

active500EM(config)#ip igmp snooping vlan 2 query-interval 130

 

10.1.10.17 ip igmp snooping vlan query-mrsp

Command: ip igmp snooping vlan <vlan-id> query-mrsp <value>
no ip igmp snooping vlan <vlan-id> query-mrsp
Function: Configure the maximum query response period. The no command restores to the default value.
Parameters:

  • <vlan-id>: VLAN ID. The valid range is from 1 to 4094.
  • <value>: value. The valid range is between 1 and 25 seconds.

Command mode: Global Mode
Default: 10s.
Usage guide: The default settings should be used. If layer 3 IGMP is running, the configuration should be in accordance with IGMP configuration.
Example: Configure the maximum query response period.

active500EM(config)#ip igmp snooping vlan 2 query-mrsp 18

 

10.1.10.18 ip igmp snooping vlan query-robustness

Command: ip igmp snooping vlan <vlan-id> query-robustness <value>
no ip igmp snooping vlan <vlan-id> query-robustness
Function: Configure the query robustness. The no command restores to the default value.
Parameters:

  • <vlan-id>: VLAN ID. The valid range is from 1 to 4094.
  • <value>: value. the valid range is between 2 and 10.

Command mode: Global Mode
Default: 2.
Usage guide: The default settings should be used. If layer 3 IGMP is running, the configuration should be in accordance with IGMP configuration.
Example: Configure the query robustness.

active500EM(config)#ip igmp snooping vlan 2 query- robustness 3

 

10.1.10.19 ip igmp snooping vlan report source-address

Command: ip igmp snooping vlan <vlan-id> report source-address <A.B.C.D>
no ip igmp snooping vlan <vlan-id> report source-address
Function: Configure the forward report source-address for IGMP. The no command restores the default setting.
Parameters:

  • <vlan-id>: VLAN ID. The valid range is from 1 to 4094.
  • <A.B.C.D>: IP address which can be 0.0.0.0.

Command mode: Global Mode
Default: Disabled.
Usage guide: The default configuration is recommended. If IGMP snooping needs to be configured, the source address for forwarded IGMP messages can be 0.0.0.0. If the upstream requires that IGMP messages should use the same network address, the IGMP messages source address should be configured to be the same as the upstream.
Example: Configure IGMP forward report source-address.

active500EM(config)#ip igmp snooping vlan 2 report source-address 10.1.1.1

 

10.1.10.20 ip igmp snooping vlan specific-query-mrsp

Command: ip igmp snooping vlan <vlan-id> specific-query-mrsp <value>
no ip igmp snooping vlan <vlan-id> specific-query-mrspt
Function: Configure the maximum query response time of the specific group or source. The no command restores the default value.
Parameters:

  • <vlan-id>: the specific VLAN ID. The valid range is from 1 to 4094.
  • <value>: the maximum query response time. The valid unit is seconds and the range is from 1 to 25. The default value is 1.

Command mode: Global Mode
Default: Enabled.
Usage guide: After enabling vlan snooping in Global Mode, input this command to configure the maximum query response time of the specific group.
Example: Configure/cancel the specific-query-mrsp of vlan3 as 2s.

active500EM(config)#ip igmp snooping vlan 3 specific-query-mrsp 2
active500EM(config)#no ip igmp snooping vlan 3 specific-query-mrsp

 

10.1.10.21 ip igmp snooping vlan static-group

Command: ip igmp snooping vlan <vlan-id> static-group <A.B.C.D> [source <A.B.C.D>] interface [ethernet | port-channel] <IFNAME>
no ip igmp snooping vlan <vlan-id> static-group <A.B.C.D> [source <A.B.C.D>]interface [ethernet | port-channel] <IFNAME>
Function: Configure static-group on the specified port of the VLAN. The no command cancels this configuration.
Parameters:

  • <vlan-id>: vlan id. The valid range is from 1 to 4094.
  • <A.B.C.D>: address of group or source.
  • ethernet: Ethernet port name.
  • port-channel: port aggregation.
  • <ifname>: interface name.

Command mode: Global Mode
Default: No configuration.
Usage guide: When a group is a static, while also a dynamic group, it should be recognized as a static group. The no form of the command will delete the static group.
Example: Configure static-group on a specified port of the VLAN.

active500EM(config)#ip igmp snooping vlan 1 static-group 224.1.1.1 source 192.168.1.1 interface ethernet 1/0/1

 

10.1.10.22 ip igmp snooping vlan suppression-query-time

Command: ip igmp snooping vlan <vlan-id> suppression-query-time <value>
no ip igmp snooping vlan <vlan-id> suppression-query-time
Function: Configure the suppression query time. The no command restores to the default value.
Parameters:

  • <vlan-id>: VLAN ID. The valid range is from 1 to 4094.
  • <value>: value. The valid range is from 1 to 65535 seconds.

Command mode: Global Mode
Default: 255s.
Usage guide: This command can only be configured on L2 general querier. The Suppression-query-time refers to the suppression state period which the querier enters when it receives a query from the layer 3 IGMP in the segments.
Example: Configure the suppression query time.

active500EM(config)#ip igmp snooping vlan 2 suppression-query-time 270

 

10.1.10.23 show ip igmp snooping

Command: show ip igmp snooping [vlan <vlan-id>] Function: Shows status of global IGMP snooping.
Parameters:

  • <vlan-id>: the VLAN number specified for displaying IGMP Snooping messages.

Command mode: Admin Mode
Default: None.
Usage guide: If no VLAN number is specified, this command will show whether global IGMP Snooping is on, which VLAN is configured with l2-general-querier function, and if a VLAN number is specified. Detailed IGMP messages for this VLAN will also be shown.
Examples: Show IGMP Snooping summary messages of the switch.

active500EM(config)#show ip igmp snooping
Global igmp snooping status:  Enabled
L3 multicasting:              running
Igmp snooping is turned on for vlan 1(querier)
Igmp snooping is turned on for vlan 2
Displayed Information Explanation
Global igmp snooping status Whether the global igmp snooping switch on the switch is on
L3 multicasting whether the layer 3 multicast protocol of the switch is running
Igmp snooping is turned on for vlan 1(querier) which VLANs on the switch is enabled with igmp snooping function, whether they are l2-general-querier

Display the IGMP Snooping summary messages of vlan1.

active500EM#show ip igmp snooping vlan 1
Igmp snooping information for vlan 1
Igmp snooping L2 general querier                  :Yes(COULD-QUERY)
Igmp snooping query-interval                      :125(s)
Igmp snooping max reponse time                    :10(s)
Igmp snooping robustness                          :2
Igmp snooping mrouter port keep-alive time        :255(s)
Igmp snooping query-suppression time              :255(s)
IGMP Snooping Connect Group Membership
Note:*-All Source, (S)- Include Source, [S]-Exclude Source
Groups          Sources             Ports               Exptime  System Level
238.1.1.1     (192.168.0.1)       Ethernet1/0/8         00:04:14     V2
              (192.168.0.2)       Ethernet1/0/8         00:04:14     V2
Igmp snooping vlan 1 mrouter port
Note:"!"-static mrouter port
!Ethernet1/0/2
Displayed Information Explanation
Igmp snooping L2 general querier Shows the VLAN enables l2-general-querier function and whether the querier state is query or suppressed
Igmp snooping query-interval Query interval of the VLAN
Igmp snooping max reponse time Max response time of the VLAN
Igmp snooping robustness IGMP Snooping robustness configured on the VLAN
Igmp snooping mrouter port keep-alive time keep-alive time of dynamic mrouter of the VLAN
Igmp snooping query-suppression time Suppression timeout of VLAN when as l2-general-querier
IGMP Snooping Connect Group Membership Group membership of this VLAN, namely the correspondence between ports and (S,G)
Igmp snooping vlan 1 mrouter port mrouter port of the VLAN, including both static and dynamic

 

10.1.11 Commands for IGMP Proxy

10.1.11.1 clear ip igmp proxy agggroup

Command: clear ip igmp proxy agggroup
Function: Delete all group records.
Parameters: None.
Command mode: Admin Configuration Mode
Default: None.
Usage guide: Use the show command to check the deleted group record.
Example: Delete all groups.

active500EM#clear ip igmp proxy agggroup

Related Command: show ip igmp proxy upstream group
 

10.1.11.2 debug igmp proxy all

Command: debug igmp proxy all
no debug igmp proxy all
Function: Enable all the debugging switches of IGMP Proxy. The no command disables all the debugging switches.
Parameters: None.
Command mode: Admin Mode
Default: Disabled.
Usage guide: This command is used to enable the debugging switches of the IGMP Proxy. It can display the IGMP packet, event, timer, and mfc of the switch.
Example: Enable all the debugging switches of IGMP Proxy.

active500EM#debug igmp proxy all

 

10.1.11.3 debug igmp proxy event

Command: debug igmp proxy event
no debug igmp proxy event
Function: Enable/disable IGMP Proxy event debug.
Parameters: None.
Default: Disabled.
Command mode: Admin Mode and Global Mode
Default: None.
Usage guide: Enable the debug if querying IGMP Proxy event information.
Example: Enable IGMP Proxy event debug.

active500EM#debug igmp proxy event

 

10.1.11.4 debug igmp proxy mfc

Command: debug igmp proxy mfc
no debug igmp proxy mfc
Function: Enable/disable IGMP Proxy multicast forwarding cache debug.
Parameters: None.
Command mode: Admin Mode and Global Mode
Default: Disabled.
Usage guide: Enable the IGMP Proxy mfc debug and display multicast information created and distributed.
Example: Enable IGMP Proxy multicast forwarding cache debug.

active500EM#debug igmp proxy mfc

 

10.1.11.5 debug igmp proxy packet

Command: debug igmp proxy packet
no debug igmp proxy packet
Function: Enable/disable IGMP Proxy debug.
Parameters: None.
Command mode: Admin Mode and Global Mode
Default: Disabled.
Usage guide: Enable the debugging switch and monitor the IGMP Proxy packets that are received/sent.
Example: Enable IGMP Proxy debug.

active500EM#debug igmp proxy packet

 

10.1.11.6 debug igmp proxy timer

Command: debug igmp proxy timer
no debug igmp proxy timer
Function: Enable/disable each IGMP Proxy timer.
Parameters: None.
Command mode: Admin Mode and Global Mode
Default: Disabled.
Usage guide: The command is used to enable the appointed IGMP Proxy timer debug switch.
Example: Enable each IGMP Proxy timer.

active500EM#debug ip igmp proxy timer

 

10.1.11.7 ip igmp proxy

Command: ip igmp proxy
no ip igmp proxy
Function: Enable the IGMP Proxy function. The no command disables this function.
Parameters: None.
Command mode: Global Mode
Default: Disabled.
Usage guide: Use this command to enable IGMP Proxy and configure one upstream port and at least one downstream port under interface configuration mode to operate IGMP Proxy.
Example: Enable IGMP Proxy under Global Mode.

active500EM(config)#ip igmp proxy

 

10.1.11.8 ip igmp proxy aggregate

Command: ip igmp proxy aggregate
no ip igmp proxy aggregate
Function: Configure non-query downstream ports to be able to aggregate the IGMP operations.
Parameters: None.
Command mode: Global Mode.
Default: Non-query downstream ports are not able to aggregate the IGMP operations.
Usage guide: By default, non-query downstream ports cannot aggregate and redistribute multicast messages. This command is used to enable all the downstream ports to be able to aggregate and redistribute the multicast dataflow.
Example: Configure non-query downstream ports to be able to aggregate the IGMP operations.

active500EM(config)#ip igmp proxy aggregate

 

10.1.11.9 ip igmp proxy downstream

Command: ip igmp proxy downstream
no ip igmp proxy downstream
Function: Enable the appointed IGMP Proxy downstream port function. The no command disables this function.
Parameters: None.
Command mode: Interface Configuration Mode
Default: Disabled.
Usage guide: This command configures the interface to function as the IGMP Proxy downstream port. In order to make IGMP Proxy work, at least one upstream interface should be configured. The no command will disable the configuration.
Example: Enable the IGMP Proxy downstream port function in interface VLAN2 under interface configuration mode.

active500EM(config)#interface vlan 2
active500EM(config-if-vlan2)#ip igmp proxy downstream

 

10.1.11.10 ip igmp proxy limit

Command: ip igmp proxy limit {group <g-limit> | source <s-limit>}
no ip igmp proxy limit
Function: Configure the maximum number of groups that upstream ports can join and the maximum number of sources in a single group.
Parameters:

  • <g-limit>: the group number limitation. Range is <1-500>.
  • <s-limit>: the source number limitation. Range is <1-500>.

Command mode: Global Mode
Default: At most 50 groups and at most 40 sources in one group.
Usage guide: If the group number limitation is exceeded, new group membership requests will be rejected. This command is used to prevent malicious group membership requests.
Example: Configure the maximum number of groups that upstream ports can join and the maximum number of sources in a single group.

active500EM(config)#ip igmp proxy limit group 30 source 20

 

10.1.11.11 ip igmp proxy multicast-source

Command: ip igmp proxy multicast-source
no ip igmp proxy multicast-source
Function: Configure the port as a downstream port for the multicast datagram source. The no command disables the configuration.
Parameters: None.
Command mode: Interface Configuration Mode
Default: The downstream port is not the multicast datagram source.
Usage guide: When a downstream port is configured as the multicast source port, the switch will be able to receive multicast data flow from that port and forward it to the upstream port. The multicast router which is connected to the upstream port of the switch should be configured to view the multicast source from the upstream port and be directly connected to the router.
Example: Enable igmp proxy multicast-source in downstream port VLAN1.

active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip igmp proxy multicast-source

 

10.1.11.12 ip igmp proxy unsolicited-report interval

Command: ip igmp proxy unsolicited-report interval <value>
no ip igmp proxy unsolicited-report interval
Function: Configure how often the upstream ports send out unsolicited reports.
Parameters:

  • <value>: interval. The interval is between 1 to 5 seconds for the upstream ports to send out unsolicited reports.

Command mode: Global Mode
Default: 1 second.
Usage guide: The upstream ports re-transmit the unsolicited reports in order that the router will not miss the report packet due to a link being down or packet loss. This command configures the interval for re-transmition.
Example: Configure how often the upstream ports send out unsolicited reports.

active500EM(config)#ip igmp proxy unsolicited-report interval 3

 

10.1.11.13 ip igmp proxy unsolicited-report robustness

Command: ip igmp proxy unsolicited-report robustness <value>
no ip igmp proxy unsolicited-report robustness
Function: Configure the retry times of upstream ports sending unsolicited reports.
Parameters:

  • <value>: The retry time for upstream ports sending unsolicited report is limited between 2 and 10.

Command mode: Global Mode
Default: Retry time is 2.
Usage guide: The upstream ports re-transmit the unsolicited reports so that the router will not miss the report packet due to a link being down or packet loss.
Example: Configure the retry times of upstream ports sending unsolicited reports.

active500EM(config)#ip igmp proxy unsolicited-report robustness 3

 

10.1.11.14 ip igmp proxy upstream

Command: ip igmp proxy upstream
no ip igmp proxy upstream
Function: Enable the appointed IGMP Proxy upstream port function. The no command disables this function.
Parameters: None.
Command mode: Interface Configuration Mode
Default: Disabled.
Usage guide: This command configures the interface to function as the IGMP Proxy upstream port. In order for IGMP Proxy to work, at least one downstream interface should be configured. The no command will disable the configuration.
Example: Enable IGMP Proxy upstream port function in interface VLAN1 under interface configuration mode.

active500EM(config)#interface vlan 1
active500EM(config-if-vlan1)#ip igmp proxy upstream

 

10.1.11.15 ip multicast ssm

Command: ip multicast ssm {range <access-list-number> | default}
no ip multicast ssm
Function: Configure the address range for IGMP Proxy ssm multicast groups. The no command deletes the ssm multicast groups.
Parameters:

  • default: show the address range 232/8 for ssm multicast groups.
  • <access-list-number>: applied access list number. The valid range is from 1 to 99.

Command mode: Global Mode
Default: The default address range is 232/8 for ssm multicast groups.
Usage guide: The command configures the address filter for multicast group membership requests. The request for the specified address ranges will be dropped. This command is also available for both the IGMP PROXY and PIM configurations. This command cannot be applied with DVMRP configuration.
Example: Enable SSM configuration on the switch and specify the address in access-list 23 as the filter address for SSM.

active500EM(config)#access-list 23 permit host-source 224.1.1.1
active500EM(config)#ip multicast ssm range 23

 

10.1.11.16 ip PIM bsr-border

Command: ip PIM bsr-border
no ip PIM bsr-border
Function: Configure the PIM enabled port to consider all multicast sources that are directly connected. The no command removes the configuration.
Parameters: None.
Command mode: Interface Configuration Mode
Default: Disabled.
Usage guide: Configure the multicast source that will be directly connected for the PIM enabled port to determine the identity of DR and ORIGINATOR.
Example: Configure PIM enabled VLAN 2 as the port for BSR BORDER. For all the multicast flow from the external network through VLAN 2, the switch will consider the multicast source as directly connected to the switch.

active500EM(config)#interface vlan 2
active500EM(config-if-vlan2)#ip PIM bsr-border

 

10.1.11.17 show debugging igmp proxy

Command: show debugging igmp proxy
Function: Display the status of the IGMP Proxy debug.
Parameters: None.
Command mode: Admin Mode
Default: None.
Usage guide: Displays the status of the IGMP Proxy debug.
Example: Display the status of the IGMP Proxy debug.

active500EM(config)#show debugging igmp proxy
IGMP PROXY debugging status:
  IGMP PROXY event debugging is on
  IGMP PROXY packet debugging is on
  IGMP PROXY timer debugging is on
  IGMP PROXY mfc debugging is on

 

10.1.11.18 show ip igmp proxy

Command: show ip igmp Proxy
Function: Display the IGMP Proxy configuration information.
Parameters: None.
Command mode: Admin Mode.
Default: None.
Usage guide: This command shows the configuration for igmp proxy, whether the igmp proxy is enabled globally, and whether upstream ports and downstream ports have been configured.
Example: Display the IGMP Proxy configuration information.

active500EM(config)#show ip igmp Proxy
IGMP PROXY MRT running: Enabled
 Total active interface number: 2
Global igmp proxy configured: YES
Total configured interface number: 2
Upstream Interface configured: YES
  Upstream Interface Vlan1(2005)
Upstream Interface configured: YES
  Downstream Interface Vlan2(2006)
Displayed Information Explanation
IGMP PROXY MRT running Displays whether the protocol is running
Total active interface number Number of active upstream and downstream ports
Global igmp proxy configured Displays whether global igmp proxy is enabled
Upstream Interface configured Displays whether the upstream port is configured
Upstream Interface Vlan The VLAN which the upstream port belongs to
Upstream Interface configured Displays whether the downstream port is configured
Downstream Interface Vlan The VLAN which the downstream port belongs to

 

10.1.11.19 show ip igmp proxy mroute

Command: show ip igmp Proxy mroute
Function: Display the status information for igmp proxy mroute.
Parameters: None.
Command mode: Admin Mode.
Default: None.
Usage guide: Display the status information for igmp proxy mroute and information about the mrt node.
Example: Display the status information for igmp proxy mroute.

active500EM(config)#show ip igmp proxy mroute
IP Multicast Routing Table
(*,G) Entries: 0
(S,G) Entries: 2
(1.1.1.2, 225.0.0.1)
 Local-include-olist    ..l.............................
 Local-exclude-olist    ................................
 Outgoing               ..o.............................
(1.1.1.3, 225.0.0.1)
 Local-include-olist    ..l.............................
 Local-exclude-olist    ................................
 Outgoing               ..o.............................
Displayed Information Explanation
Entries The counts of each item
Local-include-olist Index for local include olist
Local-exclude-olist Index for local exclude olist
Outgoing Final outgoing index of multicast data(S, G)

 

10.1.11.20 show ip igmp proxy upstream groups

Command: show ip igmp proxy upstream groups [<A.B.C.D>] Function: Display the group membership information of the upstream port.
Parameters:

  • <A.B.C.D>: Specified group address

Command mode: Admin Mode
Default: None.
Usage guide: This command shows the group membership information of the upstream port. If the group is not specified, information of all groups will be displayed, otherwise, only the specified group will be displayed.
Example: Display the group membership information of the upstream port.

active500EM(config)#show ip igmp proxy upstream groups
IGMP PROXY Connect Group Membership
Groups          Filter-mode         source
224.1.1.1       INCLUDE             192.168.1.136
226.1.1.1       *
Displayed Information Explanation
Groups IP addresses of multicast groups
Filter-mode Filter-mode of the multicast group
Source Source hold by the multicast group

 


Return to Controller Wired CLI Table of Contents