H3C S3600 Command Manual-Release 1602(V1.02)

HomeSupportSwitchesH3C S3600 Switch SeriesReference GuidesCommand ReferencesH3C S3600 Command Manual-Release 1602(V1.02)
17-Multicast Command
Title Size Download
17-Multicast Command 386.95 KB

Table of Contents

1 Common Multicast Configuration Commands· 1-1

Common Multicast Configuration Commands· 1-1

display mac-address multicast static· 1-1

display mpm forwarding-table· 1-2

display mpm group· 1-3

display multicast forwarding-table· 1-4

display multicast routing-table· 1-6

display multicast-source-deny· 1-7

mac-address multicast interface· 1-8

mac-address multicast vlan· 1-9

mtracert 1-9

multicast route-limit 1-11

multicast routing-enable· 1-12

multicast storing-enable· 1-12

multicast storing-packet 1-13

multicast-source-deny· 1-13

reset multicast forwarding-table· 1-14

reset multicast routing-table· 1-15

unknown-multicast drop enable· 1-16

2 IGMP Configuration Commands· 2-1

IGMP Configuration Commands· 2-1

display igmp group· 2-1

display igmp interface· 2-2

igmp enable· 2-3

igmp group-limit 2-4

igmp group-policy· 2-5

igmp group-policy vlan· 2-6

igmp host-join port 2-7

igmp host-join vlan· 2-8

igmp lastmember-queryinterval 2-8

igmp max-response-time· 2-9

igmp proxy· 2-9

igmp robust-count 2-10

igmp timer other-querier-present 2-11

igmp timer query· 2-12

igmp version· 2-12

reset igmp group· 2-13

3 PIM Configuration Commands· 3-1

PIM Configuration Commands· 3-1

bsr-policy· 3-1

c-bsr 3-1

c-rp· 3-2

crp-policy· 3-3

display pim bsr-info· 3-4

display pim interface· 3-4

display pim neighbor 3-5

display pim routing-table· 3-6

display pim rp-info· 3-8

pim·· 3-9

pim bsr-boundary· 3-9

pim dm·· 3-10

pim neighbor-limit 3-11

pim neighbor-policy· 3-11

pim sm·· 3-12

pim timer hello· 3-13

register-policy· 3-13

reset pim neighbor 3-14

reset pim routing-table· 3-15

spt-switch-threshold· 3-15

source-lifetime· 3-17

source-policy· 3-17

static-rp· 3-18

4 MSDP Configuration Commands· 4-1

MSDP Configuration Commands· 4-1

cache-sa-enable· 4-1

display msdp brief 4-1

display msdp peer-status· 4-2

display msdp sa-cache· 4-4

display msdp sa-count 4-6

import-source· 4-7

msdp· 4-7

msdp-tracert 4-8

originating-rp· 4-10

peer connect-interface· 4-10

peer description· 4-11

peer mesh-group· 4-12

peer minimum-ttl 4-12

peer request-sa-enable· 4-13

peer sa-cache-maximum·· 4-13

peer sa-policy· 4-14

peer sa-request-policy· 4-15

reset msdp peer 4-16

reset msdp sa-cache· 4-16

reset msdp statistics· 4-17

shutdown· 4-17

static-rpf-peer 4-18

timer retry· 4-19

5 IGMP Snooping Configuration Commands· 5-1

IGMP Snooping Configuration Commands· 5-1

display igmp-snooping configuration· 5-1

display igmp-snooping group· 5-2

display igmp-snooping statistics· 5-3

igmp-snooping· 5-4

igmp-snooping fast-leave· 5-5

igmp-snooping general-query source-ip· 5-6

igmp-snooping group-limit 5-7

igmp-snooping group-policy· 5-8

igmp-snooping host-aging-time· 5-10

igmp-snooping max-response-time· 5-10

igmp-snooping nonflooding-enable· 5-11

igmp-snooping querier 5-12

igmp-snooping query-interval 5-13

igmp-snooping router-aging-time· 5-13

igmp-snooping version· 5-14

igmp-snooping vlan-mapping· 5-15

igmp host-join port 5-15

igmp host-join· 5-16

multicast static-group interface· 5-17

multicast static-group vlan· 5-18

multicast static-router-port 5-19

multicast static-router-port vlan· 5-20

reset igmp-snooping statistics· 5-20

service-type multicast 5-21

 


Common Multicast Configuration Commands

 

The following are new features in this set of manuals:

l          Enabling multicast packet buffering. The related commands are multicast storing-enable and multicast storing-packet.

l          Configuring multicast source lifetime. The related command is source-lifetime.

l          Configuring IGMPv3 Snooping functions. The related commands are igmp-snooping version and igmp host-join.

l          Configuring IGMP Snooping nonflooding. The related command is igmp-snooping nonflooding-enable.

l          Configuring static member ports. The related commands are multicast static-group interface and multicast static-group vlan.

l          Configuring static router ports. The related commands are multicast static-router-port and multicast static-router-port vlan.

l          Configuring VLAN tags of query messages. The related command is igmp-snooping vlan-mapping.

 

Common Multicast Configuration Commands

display mac-address multicast static

Syntax

display mac-address multicast static [ [mac-address ] vlan vlan-id ] [ count ]

View

Any view

Parameters

mac-address: Displays the static multicast MAC entry information for the specified MAC address. Without this argument provided, this command displays the information of all static multicast MAC entries in the specified VLAN.

vlan vlan-id: Displays the static multicast MAC entry information in the specified VLAN. Without a VLAN specified, this command displays the static multicast MAC entry information in all VLANs.

count: Displays the number of static multicast MAC entries.

Description

Use the display mac-address multicast static command to display the information about the multicast MAC address entry or entries manually configured on the switch.

Related commands: mac-address multicast interface, mac-address multicast vlan.

Examples

# Display the information of all static multicast MAC entries in VLAN 1.

<Sysname> display mac-address multicast static vlan 1

MAC ADDR          VLAN ID  STATE           PORT INDEX       AGING TIME(s)

0100-0001-0001    1        Config static   Ethernet1/0/1    NOAGED

                                           Ethernet1/0/2

                                           Ethernet1/0/3

                                           Ethernet1/0/4

---  1 static mac address(es) found  ---

Table 1-1 display mac-address multicast static command output description

Field

Description

MAC ADDR

MAC address

VLAN ID

The VLAN in which the MAC address is manually added

STATE

State of the MAC address, which includes only Config static, indicating that the table entry is manually added.

PORT INDEX

Ports out which the multicast packets destined for the multicast MAC address are forwarded

AGING TIME(s)

Remaining lifetime of the entry. NOAGED indicates that the entry never expires.

 

display mpm forwarding-table

Syntax

display mpm forwarding-table [ group-address ]

View

Any view

Parameters

group-address: IP address of a multicast group, in the range 224.0.0.0 to 239.255.255.255. With this argument configured, this command displays only those forwarding entries that match the specified multicast address; otherwise, the command displays all the forwarding entries.

Description

Use the display mpm forwarding-table command to display the information of multicast forwarding entries containing port information.

This command displays the incoming interface, outgoing interface and outgoing port information for specific multicast streams.

Related commands: display multicast forwarding-table.

Examples

# Display the information about all the multicast forwarding entries containing port information.

<Sysname> display mpm forwarding-table

Total 1 entry(entries)

 

00001. (120.0.0.2, 225.0.0.2)

 iif Vlan-interface1200

 1 oif(s):

  Vlan-interface32

   Ethernet1/0/19

Total 1 entry(entries) Listed

Table 1-2 display mpm forwarding-table command output description

Field

Description

Total 1 entry(entries)

Total number of the entries

00001

Entry number

(120.0.0.2, 225.0.0.2)

Source address-group address pair

iif Vlan-interface1200

The incoming VLAN interface is VLAN-interface 1200.

1 oif(s):

One outgoing VLAN interface is listed.

Vlan-interface32

Ethernet1/0/19 

The first outgoing VLAN-interface is VLAN-interface 32, with one outgoing port under it, Ethernet 1/0/19

Total 1 entry(entries) Listed

The multicast forward table contains one (S,G) entry.

 

display mpm group

Syntax

display mpm group [ vlan vlan-id ]

View

Any view

Parameters

vlan vlan-id: Specifies a VLAN. With a VLAN specified, this command displays the IGMP group information in the specified VLAN; otherwise, the command displays the information of all IGMP group entries.

Description

Use the display mpm group command to display the IGMP group entries containing port information on the switch.

Related commands: display igmp group.

Examples

# Display IGMP group entries containing port information in VLAN 1200.

<Sysname> display mpm group vlan 1200

  Total 1 IP Group(s).

  Total 1 MAC Group(s).

 

  Vlan(id):1200.

    Total 1 IP Group(s).

    Total 1 MAC Group(s).

    Static Router port(s):

 

    Dynamic Router port(s):

                     Ethernet1/0/24

    IP group(s):the following ip group(s) match to one mac group.

        IP group address:224.1.1.1

        Static host port(s):

        Dynamic host port(s):

                     Ethernet1/0/22

    MAC group(s):

        MAC group address:0100-5e01-0101

        Host port(s):Ethernet1/0/22

Table 1-3 display mpm group command output description

Field

Description

Total 1 IP Group(s)

Total number of IP multicast groups

Total 1 MAC Group(s)

Total number of MAC multicast groups

Vlan(id):1200.

The displayed information is for VLAN 1200.

Static Router Port(s):

Static router ports

Dynamic router port(s):

Dynamic router ports

IP group(s):the following ip group(s) match to one mac group

IP multicast groups corresponding to the same MAC multicast group

IP group address

Address of the IP multicast group

Static host port(s):

Static host ports

Dynamic host port(s):

Dynamic host ports

MAC group(s):

MAC multicast groups

Host port(s)

Member ports of the IP multicast group

MAC group address

Address of the MAC multicast group

Host port(s)

Member ports of the MAC multicast group

 

display multicast forwarding-table

Syntax

display multicast forwarding-table [ group-address [ mask { mask | mask-length } ] | source-address [ mask { mask | mask-length } ] | incoming-interface { interface-type interface-number | register } ]*

View

Any view

Parameters

group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255. With this argument provided, the command displays the forwarding entries for the specified multicast group.

source-address: Multicast source address. With this argument provided, the command displays the forwarding entries for the specified multicast source.

mask: Mask of the specified multicast group address or multicast source address, 255.255.255.255 by default.

mask-length: Mask length of the specified multicast group address or multicast source address. For a multicast group address, this argument is in the range of 4 to 32; for a multicast source address, this argument is in the range of 0 to 32. The system default is 32 in both cases.

incoming-interface: Displays the multicast forwarding entries that contain the specified incoming interface.

interface-type interface-number: Specifies an interface by its type and number..

register: Displays the forwarding entries in which the incoming interface is the PIM-SM register interface.

Description

Use the display multicast forwarding-table command to display the information of multicast forwarding tables.

As the multicast forwarding table directly guides the forwarding of multicast traffic, you can view the information of the forwarding entries to determine whether a multicast stream is correctly forwarded.

Related commands: display multicast routing-table, display mpm forwarding-table, reset multicast forwarding-table.

Examples

# Display the information about the multicast forwarding table.

<Sysname> display multicast forwarding-table

Multicast Forwarding Cache Table

Total 1 entry: 0 entry created by IP, 1 entry created by protocol

 

00001. (10.0.0.4, 225.1.1.1), iif Vlan-interface2, 0 oifs,

     Protocol Create

     Matched 122 pkts(183000 bytes), Wrong If 0 pkts

     Forwarded 122 pkts(183000 bytes)

 

Total 1 entry Listed

The following table describes the fields in the displayed information above:

Table 1-4 display multicast forwarding-table command output description

Field

Description

Multicast Forwarding Cache Table

Multicast forwarding table

Total 1 entries

Total number of matched forwarding entries

00001

Serial number of the entry

(10.0.0.4, 225.1.1.1)

Multicast source and group addresses of the entry

iif Vlan-interface2, 0 oifs

The incoming interface of the multicast forwarding table is VLAN-interface 2, and the multicast forwarding table does not have an outgoing interface.

Matched 122 pkts(183000 bytes), Wrong If 0 pkts

     Forwarded 122 pkts(183000 bytes)

122 packets of totally 183,000 bytes match the (S, G) entry, and 0 error packets match the (S, G) entry.

122 packets of totally 183,000 bytes have been forwarded.

 

display multicast routing-table

Syntax

display multicast routing-table [ group-address [ mask { mask | mask-length } ] | source-address [ mask { mask | mask-length } ] | incoming-interface { interface-type interface-number | register } ]*

View

Any view

Parameters

group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255. With this argument provided, the command displays the multicast routing entries for the specified multicast group.

source-address: Multicast source address. With this argument provided, the command displays the multicast routing entries for the specified multicast source.

mask: Mask of the multicast group address or multicast source address, 255.255.255.255 by default.

mask-length: Mask length of the multicast group address or multicast source address. For a multicast group address, this argument is in the range of 4 to 32; for a multicast source address, this argument is in the range of 0 to 32. The system default is 32 in both cases.

incoming-interface: Displays multicast routing entries that contain the specified incoming interface.

interface-type interface-number: Specifies an interface by its type and number.

register: Displays the routing entries in which the incoming interface is the PIM-SM register interface.

Description

Use the display multicast routing-table command to display the multicast routing table information.

The multicast routing table is the basis of multicast data delivery. You can view the multicast routing table entries to determine whether (S, G) entries have been created with correct outgoing and incoming interfaces.

Related commands: reset multicast routing-table, display multicast forwarding-table.

Examples

# Display the multicast routing table information.

<Sysname> display multicast routing-table

Multicast Routing Table

Total 3 entries

 

(4.4.4.4, 224.2.149.17)

    Uptime: 00:15:16, Timeout in 272 sec

    Upstream interface: Vlan-interface1(4.4.4.6)

    Downstream interface list:

      Vlan-interface2(2.2.2.4), Protocol 0x1: IGMP

 

(4.4.4.4, 224.2.254.84)

    Uptime: 00:15:16, Timeout in 272 sec

    Upstream interface: Vlan-interface1(4.4.4.6)

    Downstream interface list: NULL

 

(4.4.4.4, 239.255.2.2)

    Uptime: 00:02:57, Timeout in 123 sec

    Upstream interface: Vlan-interface1(4.4.4.6)

    Downstream interface list: NULL

 

Matched 3 entries

The following table describes the fields in the displayed information.

Table 1-5 display multicast routing-table command output description

Field

Description

Multicast Routing Table

Multicast routing table

Total 3 entries

There are three entries in all in the multicast routing table.

(4.4.4.4, 224.2.149.17)

An (S, G) entry

Uptime: 00:15:16, Timeout in 272 sec

    Upstream interface: Vlan-interface1(4.4.4.6)

    Downstream interface list:

      Vlan-interface2(2.2.2.4), Protocol 0x1: IGMP

The entry has been there for 15 minutes and 16 seconds, and it will expire in 272 seconds.

Upstream interface: VLAN-interface 1 (The IP address of the upstream interface is 4.4.4.6).

Downstream interface list:

Downstream interface: VLAN-interface 2. (The IP address of the downstream interface is 2.2.2.4).

The downstream interface was added by the IGMP protocol.

Matched 3 entries

Three entries match the command.

 

display multicast-source-deny

Syntax

display multicast-source-deny [ interface interface-type [ interface-number ] ]

View

Any view

Parameters

interface-type: Port type.

interface-number: Port number.

Description

Use the display multicast-source-deny command to display the multicast source port suppression status.

l          With neither a port type nor a port number specified, the command displays the multicast source port suppression status of all the ports on the switch.

l          With only a port type specified, the command displays the multicast source port suppression status of all ports of that type.

l          With both a port type and a port number specified, the command displays the multicast source port suppression status of the specified port.

Related commands: multicast-source-deny.

Examples

# Display the multicast source port suppression status of Ethernet 1/0/1.

<Sysname> display multicast-source-deny interface Ethernet 1/0/1

Ethernet1/0/1     Multicast-source-deny disabled.

The information above shows that multicast source port suppression is disabled on Ethernet 1/0/1.

mac-address multicast interface

Syntax

mac-address multicast mac-address interface interface-list vlan vlan-id

undo mac-address multicast [ mac-address [ interface interface-list ] vlan vlan-id ]

View

System view

Parameters

mac-address: Multicast MAC address, in the form of H-H-H.

interface interface-list: Specifies forwarding ports for the specified multicast MAC group address. With the interface-list argument, you can define one or more individual ports (in the form of interface-type interface-number) and/or one or more port ranges (in the form of interface-type interface-number1 to interface-type interface-number2, where interface-number2 must be greater than interface-number1). The total number of individual ports plus port ranges cannot exceed 10. For port types and port numbers, refer to the parameter description in the “Port Basic Configuration” part in this manual.

vlan vlan-id: Specifies the VLAN to which the forwarding ports belong. The effective range for vlan-id is 1 to 4094.

Description

Use the mac-address multicast interface command to create a multicast MAC address entry.

Use the undo mac-address multicast interface command to remove the specified multicast MAC address entry or all multicast MAC address entries.

Each multicast MAC address entry contains multicast address, forward port, VLAN ID, and so on.

Related commands: display mac-address multicast static.

Examples

# Create a multicast MAC address entry, with the multicast MAC address of 0100-5e0a-0805 and a forwarding port of Ethernet 1/0/1 in VLAN 1.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] mac-address multicast 0100-5e0a-0805 interface Ethernet 1/0/1 vlan 1

mac-address multicast vlan

Syntax

mac-address multicast mac-address vlan vlan-id

undo mac-address multicast [ [ mac-address ] vlan vlan-id ]

View

Ethernet port view

Parameters

mac-address: Multicast MAC address in the form of H-H-H.

vlan vlan-id: Specifies the VLAN the current port belongs to. The effective range for vlan-id is 1 to 4094.

Description

Use the mac-address multicast vlan command to create a multicast MAC address entry on the current port.

Use the undo mac-address multicast vlan command to remove the specified multicast MAC address entry or all multicast MAC address entries on the current port.

Each multicast MAC address entry contains the multicast address, forwarding port, and VLAN ID information.

Related commands: display mac-address multicast static.

Examples

# Create a multicast MAC address entry on Ethernet 1/0/1 in VLAN 1, with the multicast address of 0100-1000-1000.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Ethernet1/0/1

[Sysname-Ethernet1/0/1] mac-address multicast 0100-1000-1000 vlan 1

mtracert

Syntax

mtracert source-address [ group-address | last-hop-router-address group-address ]

View

Any view

Parameters

source-address: Specifies a multicast source.

group-address: Specifies a multicast group.

last-hop-router-address: Specifies the last-hop router, which is the local device by default.

Description

Use the mtracert command to trace the path down which the multicast traffic flows to the receiver hosts.

Examples

# Trace the path down which the multicast traffic for (192.168.4.1, G) flows to the receivers.

<Sysname> mtracert 192.168.4.1

 Type Ctrl+C to quit multicast traceroute facility

 From last-hop router(192.168.2.2), trace reverse path to source 192.168.4.1 via RPF rules

 

 -1 192.168.2.2

   Incoming Interface Address: 192.168.2.2

   Previous-Hop Router Address: 192.168.2.1

   Input packet count on incoming interface: 0

   Output packet count on outgoing interface: 0

   Total number of packets for this source-group pair: 0

   Protocol: PIM

   Forwarding TTL: 0

   Forwarding Code: No error

 

 -2 192.168.2.1

   Incoming Interface Address: 192.168.3.2

   Previous-Hop Router Address: 192.168.3.1

   Input packet count on incoming interface: 0

   Output packet count on outgoing interface: 0

   Total number of packets for this source-group pair: 0

   Protocol: PIM

   Forwarding TTL: 0

   Forwarding Code: No error

 

 -3 192.168.3.1

   Incoming Interface Address: 192.168.4.2

   Previous-Hop Router Address: 0.0.0.0

   Input packet count on incoming interface: 0

   Output packet count on outgoing interface: 0

   Total number of packets for this source-group pair: 0

   Protocol: PIM

   Forwarding TTL: 0

   Forwarding Code: No error

Table 1-6 mtracert command output description

Field

Description

From last-hop router(192.168.2.2), trace reverse path to source 192.168.4.1 via RPF rules

Reverse path from the last-hop router (192.168.2.2) to the multicast source (192.168.4.1)

-1 5.5.5.8

Outgoing interface address of each hop, starting from the last-hop router

Incoming interface address

Address of the interface on which (S, G) packets arrive

Previous-hop router address

IP address of the router from which this local device receives multicast packets sent by the source

Input packet count on incoming interface

Total number of multicast packets received on the incoming interface

Output packet count on outgoing interface

Total number of multicast packets transmitted on the outgoing interface

Total number of packets for this source-group pair

Total number of packets from the specified source forwarded by this device to the specified group

Protocol

The multicast routing protocol in use

Forwarding TTL

The minimum TTL that a packet is required to have before it can be forwarded over the outgoing interface

 

multicast route-limit

Syntax

multicast route-limit limit

undo multicast route-limit

View

System view

Parameters

limit: Maximum number of multicast routing table entries, in the range of 0 to 256.

Description

Use the multicast route-limit command to configure the maximum number of entries the multicast routing table can hold. The switch will drop the protocol and data packets for new (S, G) entries after the limit is reached.

Use the undo multicast route-limit command to restore the default.

The maximum number of entries the multicast routing table can hold is 256 by default.

If the number of existing entries in the multicast routing table exceeds the value configured with this command, the existing entries in the multicast routing table will not be immediately removed. Instead, you will see a message indicating that the multicast routing table currently contains more entries than configured.

If you execute this command again, the new configuration will overwrite the existing configuration.

Examples

# Set the maximum number of entries the multicast routing table can hold to 100.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast route-limit 100

multicast routing-enable

Syntax

multicast routing-enable

undo multicast routing-enable

View

System view

Parameters

None

Description

Use the multicast routing-enable command to enable the IP multicast routing feature.

Use the undo multicast routing-enable command to disable the IP multicast routing feature.

IP multicast routing is disabled by default.

Examples

# Enable the IP multicast routing feature.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast routing-enable

multicast storing-enable

Syntax

multicast storing-enable

undo multicast storing-enable

View

System view

Parameters

None

Description

Use the multicast storing-enable command to enable the multicast packet buffering feature.

Use the undo multicast storing-enable command to disable the multicast packet buffering feature.

With the multicast packet buffering feature enabled, multicast packets delivered to the CPU are buffered while the corresponding multicast forwarding entries are being created and forwarded out according to the multicast forwarding entries after entry creation.

By default, this function is not enabled.

Examples

# Enable the multicast packet buffering feature.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast storing-enable

multicast storing-packet

Syntax

multicast storing-packet packet-number

View

System view

Parameters

packet-number: Maximum number of packets that can be buffered per multicast forwarding entry, ranging from 10 to 100.

Description

Use the multicast storing-packet command to specify the maximum number of packets that can be buffered per multicast forwarding entry.

By default, up to 100 packets can be buffered per multicast forwarding entry.

Examples

# Configure to allow a maximum of 50 packets to be buffered per multicast group.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast storing-packet 50

multicast-source-deny

Syntax

multicast-source-deny [ interface interface-list ]

undo multicast-source-deny [ interface interface-list ]

View

System view, Ethernet port view

Parameters

interface interface-list: Enables the multicast source port suppression feature on the specified port or ports. With the interface-list argument, you can define one or more individual ports (in the form of interface-type interface-number) and/or one or more port ranges (in the form of interface-type interface-number1 to interface-type interface-number2, where interface-number2 must be greater than interface-number1). The total number of individual ports plus port ranges cannot exceed 10. For port types and port numbers, refer to the parameter description in the “Port Basic Configuration” part in this manual.

Description

Use the multicast-source-deny command to enable the multicast source port suppression feature.

Use the undo multicast-source-deny command to restore the default setting.

By default, the multicast source port suppression feature is disabled on all the ports.

With the multicast source port suppression feature enabled on a port, the port drops all multicast data packets while it permits multicast protocol packets to pass. This feature is useful for rejecting multicast traffic from unauthorized multicast source servers connected to the switch.

l          In system view, if no port or port list is specified, the multicast source port suppression feature is enabled on all the ports of the switch; if one or more ports or port lists are specified, the multicast source port suppression feature is enabled on the specified ports.

l          In Ethernet port view, you can use the command to enable the multicast source port suppression feature on the current port only.

Examples

# Enable the multicast source port suppression feature on all the ports of the switch.

<Sysname>system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast-source-deny

# Enable the multicast source port suppression feature on Ethernet 1/0/1 through Ethernet 1/0/10 and on Ethernet 1/0/12.

[Sysname] multicast-source-deny interface Ethernet 1/0/1 to Ethernet 1/0/10 Ethernet 1/0/12

# Enable the multicast source port suppression feature on Ethernet 1/0/13.

[Sysname] interface Ethernet 1/0/13

[Sysname-Ethernet1/0/13] multicast-source-deny

reset multicast forwarding-table

Syntax

reset multicast forwarding-table [ statistics ] { all | { group-address [ mask { mask | mask-length } ] | source-address [ mask { mask | mask-length  } ] | incoming-interface interface-type interface-number } * }

View

User view

Parameters

statistics: Clears the statistics information of the specified multicast forwarding entries. Without this keyword, the command clears the specified forwarding entries.

all: Clears all the forwarding entries or the statistics information of all the forwarding entries. Without this keyword, the command clears the forwarding entries or the statistics information of the forwarding entries defined by the following parameters.

group-address: Multicast group address in the range of 224.0.0.0 to 239.255.255.255.

source-address: Multicast source address.

mask: Mask of the multicast group address or multicast source address, 255.255.255.255 by default.

mask-length: Mask length of the multicast group address or multicast source address. For a multicast group address, this argument is in the range of 4 to 32; for a multicast source address, this argument is in the range of 0 to 32. The system default is 32 in both cases.

incoming-interface interface-type interface-number: Clears the forwarding entries or corresponding statistics information of the forwarding entries that match the specified incoming interface.

Description

Use the reset multicast forwarding-table command to clear forwarding entries or the statistics about forwarding entries.

The positions of the group-address and source-address arguments are interchangeable. However, they must be valid addresses; otherwise, the system prompts an error message.

Related commands: display multicast forwarding-table.

Examples

# Clear the forwarding entries whose group address is 225.5.4.3 from the multicast forwarding table.

<Sysname> reset multicast forwarding-table 225.5.4.3

# Clear the statistics about the forwarding entries whose group address is 225.5.4.3 from the multicast forwarding table.

<Sysname> reset multicast forwarding-table statistics 225.5.4.3

reset multicast routing-table

Syntax

reset multicast routing-table { all | { group-address [ mask { maskmask-length  } ] | source-address [ mask { mask |  mask-length } ] | incoming-interface interface-type interface-number } * }

View

User view

Parameters

all: Clears all routing entries from the multicast routing table. Without this keyword, the command clears the multicast routing entries defined by the following parameters.

group-address: Multicast group address in the range of 224.0.0.0 to 239.255.255.255.

source-address: Multicast source address.

mask: Mask of the multicast group address or multicast source address, 255.255.255.255 by default.

mask-length: Mask length of the multicast group address or multicast source address. For a multicast group address, this argument is in the range of 4 to 32; for a multicast source address, this argument is in the range of 0 to 32. The system default is 32 in both cases.

incoming-interface interface-type interface-number: Clears the routing entries that match the specified incoming interface.

Description

Use the reset multicast routing-table command to clear the routing entries in the multicast core routing table and remove the corresponding forwarding entries in the MFC forwarding table.

The position of the group-address and source-address arguments are interchangeable. However, they must be valid addresses; otherwise, the system prompts an error message.

Related commands: reset pim routing-table, reset multicast forwarding-table, display multicast forwarding-table.

Examples

# Clear the routing entries whose group address is 225.5.4.3 from the multicast core routing table.

<Sysname> reset multicast routing-table 225.5.4.3

unknown-multicast drop enable

Syntax

unknown-multicast drop enable

undo unknown-multicast drop enable

View

System view

Parameters

None

Description

Use the unknown-multicast drop enable command to enable the function of dropping unknown multicast packets.

Use the undo unknown-multicast drop enable command to disable the function of dropping unknown multicast packets.

By default, the function of dropping unknown multicast packets is disabled.

Examples

Enable the unknown multicast drop feature.

<Sysname> system-view

System view: return to user view with Ctrl+Z.

[Sysname] unknown-multicast drop enable

 


IGMP Configuration Commands

IGMP Configuration Commands

display igmp group

Syntax

display igmp group [ group-address | interface interface-type interface-number ]

View

Any view

Parameters

group-address: Multicast group address. With this argument provided, this command displays the information of the specified IGMP multicast group.

Interface interface-type interface-number: Specifies an interface by its type and number. With this argument provided, this command displays the IGMP multicast group information about the specified interface.

Description

Use the display igmp group command to display the IGMP multicast group information.

Without any parameters provided, the command displays the information of all IGMP multicast groups.

Related commands: igmp host-join.

Examples

# Display the information of all IGMP multicast groups on the switch.

<Sysname> display igmp group

Total 3 IGMP groups reported on this router

LoopBack0 (20.20.20.20): Total 3 IGMP Groups reported:

  Group Address      Last Reporter   Uptime      Expires

  225.1.1.1           20.20.20.20     00:02:04    00:01:15

  225.1.1.3           20.20.20.20     00:02:04    00:01:15

  225.1.1.2           20.20.20.20     00:02:04    00:01:17

Table 2-1 display igmp group command output description

Field

Description

Group address

Multicast group address

Last Reporter

The last host that reported a membership for this group

Uptime

Time elapsed since multicast group was first reported (hh: mm: ss).

Expires

Remaining lifetime of the multicast group (hh: mm: ss).

 

display igmp interface

Syntax

display igmp interface [ interface-type interface-number ]

View

Any view

Parameters

interface-type interface-number: Specifies an interface by its type and number. With this argument provided, the command displays the IGMP configuration and running information on the specified interface; otherwise, the command displays the IGMP information on all interfaces running IGMP.

Description

Use the display igmp interface command to display the IGMP configuration and running information on the specified interface or all interfaces.

Examples

# Display the IGMP configuration and running information on Vlan-interface 1.

<Sysname> display igmp interface Vlan-interface 1

Vlan-interface1 (10.153.17.99):

  IGMP is enabled

  Current IGMP version is 2

  Value of query interval for IGMP(in seconds): 60

  Value of other querier time out for IGMP(in seconds): 120

  Value of maximum query response time for IGMP(in seconds): 10

  Value of robust count for IGMP: 2

  Value of startup query interval for IGMP(in seconds): 15

  Value of last member query interval for IGMP(in seconds): 1

  Value of query timeout for IGMP version 1(in seconds): 400

  Policy to accept IGMP reports: none

  Querier for IGMP: 10.153.17.99 (this router)

  IGMP group limit is 256

  Total 1 IGMP group reported

Table 2-2 display igmp interface command output description

Field

Description

Vlan-interface1 (10.153.17.99):

Interface name (IP address)

IGMP is enabled

IGMP is currently enabled on the interface.

If IGMP is not enabled, no output information is displayed.

Current IGMP version is 2

IGMP version 2 (default) is running on the current interface.

Value of query interval for IGMP(in seconds): 60

The IGMP query interval is 60 seconds (default).

Value of other querier time out for IGMP(in seconds): 120

The other querier present interval is 120 seconds (default).

Value of maximum query response time for IGMP(in seconds): 10

The maximum response time for IGMP general queries is 10 seconds (default).

Value of robust count for IGMP: 2

The IGMP robustness variable is 2 (default).

Value of startup query interval for IGMP(in seconds): 15

The IGMP startup query interval is 15 seconds (default).

Value of last member query interval for IGMP(in seconds): 1

The IGMP last member query interval is 1 second (default).

Value of query timeout for IGMP version 1(in seconds): 400

The query timeout time for IGMPv1 is 400 seconds (default).

Policy to accept IGMP reports: none

IGMP multicast group filtering policy for controlling the access to multicast groups. “None” means no filtering policy is applied; otherwise, the applied policy is displayed. For example, “acl 2000, only for IGMP version 1” means ACL 2000 is applied only on IGMPv1 reports.

Querier for IGMP: 10.1.0.5 (this router)

The IGMP querier address is 10.1.0.5 (this device).

IGMP group limit: 256

The maximum number of IGMP multicast groups that can be joined on the VLAN interface is 256.

Total 1 IGMP group reported

Total number of IGMP multicast groups on the interface is 1.

 

igmp enable

Syntax

igmp enable

undo igmp enable

View

Interface view

Parameters

None

Description

Use the igmp enable command to enable IGMP on an interface.

Use the undo igmp enable command to disable IGMP on an interface.

By default, IGMP is disabled on an interface. .

These commands do not take effect until the multicast routing feature is enabled. You need to use this command before you can configure other IGMP features.

Related commands: multicast routing-enable.

Examples

# Enable IGMP on VLAN-interface 10.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast routing-enable

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] igmp enable

igmp group-limit

Syntax

igmp group-limit limit

undo igmp group-limit

View

Interface view

Parameters

limit: The maximum number of multicast groups that can be joined on the interface, in the range of 0 to 256.

Description

Use the igmp group-limit command to configure the maximum number of multicast groups allowed on the interface. The switch does not process any new IGMP report messages if the number of multicast groups on the interface reaches the limit.

Use the undo igmp group-limit command to restore the default.

By default, up to 256 multicast groups can be joined to an interface.

If you use the command for a second time, the new configuration overwrites the existing one.

 

l          After the maximum number of multicast groups is reached, the interface will not join any new multicast group.

l          If you configure the maximum number of multicast groups allowed on the interface to 1, a new group registered on the interface supersedes the existing one automatically.

l          If the number of existing multicast groups is larger than the configured limit on the number of joined multicast groups on the interface, the system will remove the oldest entries automatically until the number of multicast groups on the interface comes down to the configured limit.

 

Examples

# Configure to allow a maximum of 100 multicast groups to be joined on VLAN-interface 10.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] igmp group-limit 100

igmp group-policy

Syntax

igmp group-policy acl-number [ 1 | 2 | port interface-list ]

undo igmp group-policy [ port interface-list ]

View

Interface view

Parameters

acl-number: Basic ACL number, defining a multicast group range. The value ranges from 2,000 to 2,999.

1: Configures the interface to accept only IGMPv1 report messages.

2: Configures the interface to accept only IGMPv2 report messages (default).

port interface-list: Configures a multicast group filter on the specified port or ports. With the interface-list argument, you can define one or more individual ports (in the form of interface-type interface-number) and/or one or more port ranges (in the form of interface-type interface-number1 to interface-type interface-number2, where interface-number2 must be greater than interface-number1). The total number of individual ports plus port ranges cannot exceed 10. For port types and port numbers, refer to the parameter description in the “Port Basic Configuration” part in this manual.

 

In LoopBack interface view, this command does not support the port interface-list option.

 

Description

Use the igmp group-policy command to configure a multicast group filter on the current interface to control the access to the multicast groups in the defined group range.

Use undo igmp group-policy command to remove the multicast group filter configured.

By default, no filter is configured; that is, a host can join any multicast group.

If you do not want the hosts on the network attached to the interface to join some multicast groups, use this command to limit the range of the multicast groups served by the interface.

Related commands: igmp host-join.

 

Be sure that the Ethernet ports specified in the command belong to the VLAN interfaces on which the command is configured, but not other VLAN interfaces.

 

Examples

# Configure a multicast group filter on VLAN-interface 10 so that the hosts on the subnet attached to the interface can join only multicast group 225.1.1.1 and the interface accepts only IGMPv2 reports.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 225.1.1.1 0

[Sysname-acl-basic-2000] quit

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] igmp group-policy 2000 2

igmp group-policy vlan

Syntax

igmp group-policy acl-number vlan vlan-id

undo igmp group-policy vlan vlan-id

View

Ethernet port view

Parameters

acl-number: Basic ACL number, defining a multicast group range. The value ranges from 2,000 to 2,999.

vlan vlan-id: Specifies the VLAN to which the current port belongs. The effective range for vlan-id is 1 to 4094.

Description

Use the igmp group-policy vlan command to configure a multicast group filter on the current port to control the access to the multicast groups in the defined group range.

Use the undo igmp group-policy vlan command to remove the configured multicast group filter.

By default, no filter is configured; that is, a host can join any multicast group.

To restrict the hosts attached to a port from joining certain multicast groups, you can use this command to limit the range of multicast groups that the port serves. This command delivers the same result as the igmp group-policy command.

Note that the port on which the command is configured must belong to the specified VLAN and be IGMP enabled; otherwise, the configuration does not take effect.

Related commands: igmp group-policy.

Examples

# Allow hosts attached to Ethernet 1/0/1 in VLAN 10 to join only multicast group 225.1.1.1.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 225.1.1.1 0

[Sysname-acl-basic-2000] quit

[Sysname] interface Ethernet 1/0/1

[Sysname-Ethernet1/0/1] port access vlan 10

[Sysname-Ethernet1/0/1] igmp group-policy 2000 vlan 10

igmp host-join port

Syntax

igmp host-join group-address port interface-list

undo igmp host-join group-address port interface-list

View

Interface view

Parameters

group-address: Address of the multicast group to join.

port interface-list: Configures the specified port or ports under the current VLAN interface as simulated member host(s) for the specified multicast group. With the interface-list argument, you can define one or more individual ports (in the form of interface-type interface-number) and/or one or more port ranges (in the form of interface-type interface-number1 to interface-type interface-number2, where interface-number2 must be greater than interface-number1). The total number of individual ports plus port ranges cannot exceed 10. For port types and port numbers, refer to the parameter description in the “Port Basic Configuration” part in this manual.

 

In LoopBack interface view, this command does not support the port interface-list option.

 

Description

Use the igmp host-join port command to configure one or more ports under the current VLAN interface as simulated member hosts to join the specified multicast group.

Use undo igmp host-join port command to restore the default.

By default, simulated joining is disabled.

Examples

# Configure Ethernet 1/0/1 under VLAN-interface 10 as a simulated member host to join multicast group 225.0.0.1.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] igmp host-join 225.0.0.1 port Ethernet 1/0/1

igmp host-join vlan

Syntax

igmp host-join group-address vlan vlan-id

undo igmp host-join group-address vlan vlan-id

View

Ethernet port view

Parameters

group-address: Address of the multicast group to join.

vlan vlan-id: Specifies the VLAN to which the port belongs. The effective range for vlan-id is 1 to 4094.

Description

Use the igmp host-join vlan command to configure the current Ethernet port as a simulated member host to join the specified multicast group.

Use the undo igmp host-join vlan command to restore the default.

By default, simulated joining is disabled.

Related commands: igmp group-policy.

Examples

# Configure Ethernet 1/0/1 under VLAN-interface 10 as a simulated member host to join multicast group 225.0.0.1.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Ethernet 1/0/1

[Sysname-Ethernet1/0/1] port access vlan 10

[Sysname-Ethernet1/0/1] igmp host-join 225.0.0.1 vlan 10

igmp lastmember-queryinterval

Syntax

igmp lastmember-queryinterval seconds

undo igmp lastmember-queryinterval

View

Interface view

Parameters

seconds: Interval in seconds for the IGMP querier to send IGMP group-specific query messages upon receiving an IGMP leave message, in the range of 1 to 5.

Description

Use the igmp lastmember-queryinterval command to configure the IGMP last-member query interval, namely the interval between IGMP group-specific queries the IGMP querier sends upon receiving an IGMP leave message.

Use the undo igmp lastmember-queryinterval command to restore the default.

The IGMP last-member query interval is 1 second by default.

Related commands: igmp robust-count, display igmp interface.

Examples

# Set the IGMP last-member query interval to 3 seconds on VLAN-interface 10.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] igmp lastmember-queryinterval 3

igmp max-response-time

Syntax

igmp max-response-time seconds

undo igmp max-response-time

View

Interface view

Parameters

seconds: Maximum response time in seconds in the IGMP general query messages, ranging from 1 to 25.

Description

Use the igmp max-response-time command to configure the maximum response time carried in the IGMP general query messages.

Use the undo igmp max-response-time command to restore the default.

The maximum response time is 10 seconds by default.

Related commands: display igmp interface.

Examples

# On VLAN-interface 10, configure the maximum response time carried in IGMP general query messages to 8 seconds.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] igmp max-response-time 8

igmp proxy

Syntax

igmp proxy interface-type interface-number

undo igmp proxy

View

Interface view

Parameters

interface-type interface-number: Specifies the interface for which the current interface will act as the IGMP proxy interface.

Description

Use the igmp proxy command to configure the current interface as the IGMP proxy interface for another interface on the Layer 3 switch.

Use the undo igmp proxy command to restore the default.

No interface is configured as the IGMP proxy interface for another.

Before configuring the igmp proxy command on an interface, you must enable PIM on it. One interface cannot serve as the IGMP proxy interface for two or more interfaces.

If the IGMP proxy feature is configured repeatedly on the same interface, the last configuration takes effect.

Related commands: pim neighbor-policy.

Examples

# Configure VLAN-interface 1 as the IGMP proxy interface for VLAN-interface 2 on the Layer 3 switch.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast routing-enable

[Sysname] interface vlan-interface 1

[Sysname-Vlan-interface1] pim dm

[Sysname-Vlan-interface1] igmp enable

[Sysname- Vlan-interface1] igmp proxy vlan-interface 2

igmp robust-count

Syntax

igmp robust-count robust-value

undo igmp robust-count

View

Interface view

Parameters

robust-value: IGMP robustness variable, namely the number of IGMP group-specific query messages the switch sends upon receiving an IGMP Leave message. The effective range is 2 to 5.

Description

Use the igmp robust-count command to configure the IGMP robustness variable.

Use the undo igmp robust-count command to restore the default.

By default, an IGMP querier sends two IGMP group-specific query messages after receiving an IGMP Leave message.

Related commands: igmp lastmember-queryinterval, display igmp interface.

Examples

# Set the IGMP robustness variable to 3 on VLAN-interface 10.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] igmp robust-count 3

igmp timer other-querier-present

Syntax

igmp timer other-querier-present seconds

undo igmp timer other-querier-present

View

Interface view

Parameters

seconds: Other querier present interval in seconds, in the range of 1 to 131,070.

Description

Use the igmp timer other-querier-present command to configure the other querier present interval, namely the length of time a non-querier waits before it assumes that the current IGMP querier is down.

Use the undo igmp timer other-querier-present command to restore the default value.

By default, the other querier present interval is twice the value of IGMP query interval, that is, 120 seconds if the IGMP query interval has not been manually configured.

On a multi-access network, that is, the same network segment including multiple multicast routers, the query router (known as querier) is responsible for sending general query messages periodically through the VLAN interface. If a non-queriers receive no query messages within the other querier present interval, it assumes that the current querier is down and a new querier election process takes place.

In IGMP version 1, the selection of a querier is determined by the multicast routing protocol. In IGMP version 2, the router with the lowest IP address on the shared network segment acts as the querier.

Related commands: igmp timer query, display igmp interface.

Examples

# Configure the querier to expire in 300 seconds.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] igmp timer other-querier-present 300

igmp timer query

Syntax

igmp timer query seconds

undo igmp timer query

View

Interface view

Parameters

seconds: IGMP query interval, namely the interval between IGMP general query messages, in the range of 1 to 65,535 seconds.

Description

Use the igmp timer query command to configure the interval between IGMP general query messages.

Use the undo igmp timer query command to restore the default.

By default, the IGMP query interval is 60 seconds.

A multicast router periodically sends IGMP general query messages onto the attached subnets to determine whether multicast group members are present on the subnets. The IGMP query interval can be tuned according to the practical conditions of the network.

Related commands: igmp timer other-querier-present.

Examples

# Set the IGMP query interval to 150 seconds on VLAN-interface 2.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Vlan-interface 2

[Sysname-Vlan-interface2] igmp timer query 150

igmp version

Syntax

igmp version { 1 | 2 }

undo igmp version

View

Interface view

Parameters

1: Specifies IGMP version 1.

2: Specifies IGMP version 2.

Description

Use the igmp version command to specify the version of IGMP to run on the interface.

Use the undo igmp version command to restore the default.

The default IGMP version is IGMP version 2.

The device cannot automatically switch between different IGMP versions, so all the devices on a subnet must run the same version of IGMP.

Examples

# Run IGMPv1 on VLAN-interface 10.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] igmp version 1

reset igmp group

Syntax

reset igmp group { all | interface interface-type interface-number { all | group-address [ group-mask ] } }

View

User view

Parameters

all: The first all refers to all interfaces, while the second all refers to all IGMP multicast groups.

interface interface-type interface-number: Specifies an interface by its type and number. With an interface specified, the command clears the IGMP multicast group information on the specified interface.

group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255.  With this argument provided, the command clears the specified multicast group or group range.

group-mask: Mask of the multicast group address, 255.255.255.255 by default.

Description

Use the reset igmp group command to clear IGMP multicast group information on the interface. The groups removed with this command can be joined again.

Examples

# Remove all multicast groups on all the interfaces.

<Sysname> reset igmp group all

# Remove all multicast groups on VLAN-interface 10.

<Sysname> reset igmp group interface Vlan-interface10 all

# Remove group 225.0.0.1 on VLAN-interface 10.

<Sysname> reset igmp group interface Vlan-interface10 225.0.0.1

# Remove the multicast groups ranging from 225.1.1.0 to 225.1.1.255 on VLAN-interface 10.

<Sysname> reset igmp group interface Vlan-interface10 225.1.1.0 255.255.255.0

 


PIM Configuration Commands

bsr-policy

Syntax

bsr-policy acl-number

undo bsr-policy

View

PIM view

Parameters

acl-number: ACL number to be used in the BSR filtering policy, in the range of 2000 to 2999.

Description

Use the bsr-policy command to limit the range of legal BSRs to prevent BSR spoofing.

Use the undo bsr-policy command to restore the default.

By default, no range limit is configured, namely all received messages are considered legal.

The source keyword in the rule command is translated into BSR address in the bsr-policy command.

Examples

# Configure a BSR filtering policy on devices to allow only the multicast devices on subnet 101.1.1.1/32 to become BSR.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast routing-enable

[Sysname] pim

[Sysname-pim] bsr-policy 2000

[Sysname-pim] quit

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule 0 permit source 101.1.1.1 0

c-bsr

Syntax

c-bsr interface-type interface-number hash-mask-len [ priority ]

undo c-bsr

View

PIM view

Parameters

interface-type interface-number: Specifies an interface that will be configured as a C-BSR. This configuration takes effect only after PIM-SM is enabled on the interface.

hash-mask-len: Length of the hash mask used for RP calculation. The effective range is 0 to 32.

priority: C-BSR priority. The effective range is 0 to 255, 0 by default.

Description

Use the c-bsr command to configure the specified interface as a C-BSR.

Use the undo c-bsr command to remove the C-BSR configuration.

By default, no C-BSR is configured.

For the configuration of the candidate BSR, the larger bandwidth should be guaranteed because a large amount of information will be exchanged between the BSR and other devices in the PIM domain.

Related commands: pim sm.

Examples

# Configure VLAN-interface 10 on the switch as a C-BSR with a priority of 2 and the hash mask length of 24.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast routing-enable

[Sysname] pim

[Sysname-pim] c-bsr vlan-interface 10 24 2

c-rp

Syntax

c-rp interface-type interface-number [ group-policy acl-number | priority priority-value ]*

undo c-rp { interface-type interface-number | all }

View

PIM view

Parameters

interface-type interface-number: Specifies an interface of which the IP address will be advertised as a C-RP address.

group-policy: Defines a group range to be served by the specified interface after it becomes the RP.

acl-number: Basic ACL number, in the range of 2,000 to 2,999. Used together with the group-policy keyword, this argument defines the group range mentioned above.

priority priority-value: C-RP priority, in the range of 0 to 255, 0 by default. A greater value means a lower priority.

all: Removes all C-RPs configured.

Description

Use the c-rp command to configure an interface as a C-RP.

Use the undo c-rp command to remove the configuration.

By default, no C-RP is configured.

For the configuration of a C-RP, a relatively large bandwidth should be reserved for the switch and other devices in the PIM domain.

Related commands: c-bsr.

Examples

# Configure VLAN-interface 10 of the switch as a C-RP, which will serve multicast groups 225.0.0.0 to 225.255.255.255 after it wins RP election.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast routing-enable

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 225.0.0.0 0.255.255.255

[Sysname] pim

[Sysname-pim] c-rp vlan-interface 10 group-policy 2000

crp-policy

Syntax

crp-policy acl-number

undo crp-policy

View

PIM view

Parameters

acl-number: Advanced ACL number, ranging from 3000 to 3999. When defining the ACL, use the source keyword in the rule command to specify a C-RP address and use the destination keyword to specify a multicast address range that the C-RP will serve.

Description

Use the crp-policy command to configure a valid C-RP address range and a multicast group range that the C-RPs will serve to prevent C-RP spoofing.

Use the undo crp-policy command to restore the default.

By default, there is no limit on the C-RP address range or the multicast address range that a C-RP serves, that is, all the C-RP-Adv messages are considered to valid.

Examples

# Configure a C-RP policy on the BSR so that only multicast devices on subnet 1.1.1.1/32 to become C-RPs to serve only the multicast groups in the range of 225.1.0.0/16.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast routing-enable

[Sysname] pim

[Sysname-pim] crp-policy 3000

[Sysname-pim] quit

[Sysname] acl number 3000

[Sysname-acl-adv-3000] rule 0 permit source 1.1.1.1 0 destination 225.1.0.0 0.0.255.255

display pim bsr-info

Syntax

display pim bsr-info

View

Any view

Parameters

None

Description

Use the display pim bsr-info command to display the BSR information.

Related commands: c-bsr, c-rp.

Examples

# Display the BSR information.

<Sysname> display pim bsr-info

  Current BSR Address: 20.20.20.30

             Priority: 0

          Mask Length: 30

              Expires: 00:01:55

  Local host is BSR

Table 3-1 display pim bsr-info command output description

Field

Description

Current BSR Address

BSR address

Priority

BSR priority

Mask Length: 30

Hash mask length

Expires: 00:01:55

Remaining lifetime of the BSR

Local host is BSR

The local device serves as the BSR.

 

display pim interface

Syntax

display pim interface [ interface-type interface-number ]

View

Any view

Parameters

interface-type interface-number: Specifies an interface by its type and number.

Description

Use the display pim interface command to display the PIM configuration information.

With an interface specified, the command displays the PIM configuration information on the specified interface; otherwise, the command displays the PIM configuration information on all interfaces.

Examples

# Display the PIM configuration information on all interfaces.

<Sysname> display pim interface

PIM information of VLAN-interface 2:

  IP address of the interface is 10.10.1.20

  PIM is enabled

  PIM version is 2

  PIM mode is Sparse

  PIM query interval is 30 seconds

  PIM neighbor limit is 128

  PIM neighbor policy is none

  Total 1 PIM neighbor on interface

  PIM DR(designated router) is 10.10.1.20

Table 3-2 display pim interface command output description

Field

Description

IP address of the interface

IP address of the VLAN interface

PIM version

PIM version running on the interface

PIM mode

PIM mode enabled on the VLAN interface (DM or SM)

PIM query interval

Hello interval

PIM neighbor limit

Limit on the number of PIM neighbors on the VLAN interface. No neighbor can be added when the limit is reached

PIM neighbor policy

Filtering policy of the PIM neighbors on the current interface

Total 1 PIM neighbor on interface

Totally, one PIM neighbor is present on this VLAN interface.

PIM DR

Designated router

 

display pim neighbor

Syntax

display pim neighbor [ interface interface-type interface-number ]

View

Any view

Parameters

interface interface-type interface-number: Specifies an interface by its type and number.

Description

Use the display pim neighbor command to display the PIM neighbor information.

With an interface specified, the command displays the PIM neighbor information on the specified interface; otherwise, the command displays the PIM neighbor information on all interfaces.

Examples

# Display the PIM neighbor information on all interfaces.

<Sysname> display pim neighbor

Neighbor Address      Interface Name        Uptime          Expires

8.8.8.6               VLAN-interface10      1637            89

8.8.7.6               VLAN-interface11      1636            88

Table 3-3 display pim neighbor command output description

Field

Description

Neighbor Address

Neighbor address

Interface Name

VLAN interface on which the neighbor has been discovered

Uptime

Time elapsed since the multicast group was discovered

Expires

Remaining lifetime of the PIM neighbor

 

display pim routing-table

Syntax

display pim routing-table [ { { *g [ group-address [ mask { mask-length | mask } ] ] | **rp [ rp-address [ mask { mask-length | mask } ] ] } | { group-address [ mask { mask-length | mask } ] | source-address [ mask { mask-length | mask } ] } * } | incoming-interface interface-type interface-number | { dense-mode | sparse-mode } ] *

View

Any view

Parameters

*g: Specifies a (*, G) entry.

**rp: Specifies a (*, *, RP) route entry.

rp-address: RP address.

group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255.

source-address: Multicast source address.

mask: Mask of the multicast group address, multicast source address, or RP address, 255.255.255.255 by default.

mask-length: Mask length of the multicast group address, multicast source address, or RP address, in the range of 0 to 32. The system default is 32.

incoming-interface: Displays multicast routing entries containing the specified incoming interface.

interface-type interface-number: Specifies an interface by its type and number. If you specify null, the command displays the multicast routing entries without an incoming interface.

dense-mode: Displays PIM-DM multicast routing information.

sparse-mode: Displays PIM-SM multicast routing information.

Description

Use the display pim routing-table command to display information about the PIM multicast routing table.

The displayed information includes the SPT information and RPF information.

Examples

# Display the information about the PIM multicast routing table.

<Sysname> display pim routing-table

PIM-SM Routing Table

Total 1 (S,G) entry, 1 (*,G) entry, 0 (*,*,RP) entry

 

(*, 228.0.0.0), RP 23.12.0.1

    Protocol 0x20: PIMSM, Flag 0x3: RPT WC

    Uptime: 00:00:13, Timeout in 197 sec

    Upstream interface: Vlan-interface1, RPF neighbor: 200.1.0.1

    Downstream interface list:

      Vlan-interface401, Protocol 0x100: RPT, timeout in 197 sec

 

(196.0.0.3, 228.0.0.0)

    Protocol 0x20: PIMSM, Flag 0x4: SPT

    Uptime: 00:10:49, Timeout in 196 sec

    Upstream interface: Vlan-interface196, RPF neighbor: NULL

    Downstream interface list:

      Vlan-interface401, Protocol 0x100: SPT, timeout in 197 sec

 

Matched 1 (S,G) entry, 1 (*,G) entry, 0 (*,*,RP) entry

Table 3-4 display pim routing-table command output description

Field

Description

Total 1 (*, G) entry; 1 (S, G) entry,0 (*,*,RP) entry

Total number of (S, G), (*, G) and (*, *, RP) entries in the PIM routing table

(*, 228.0.0.0)

A (*, G) entry in the PIM routing table

RP

Rendezvous point

Protocol

PIM mode (PIM-SM or PIM-DM)

Flag

Flag of (S, G) or (*, G) entry in the PIM routing table:

l      SPT: The (S, G) entry is on the SPT.

l      RPT: The (S, G) or (*, G) entry is on the RPT.

l      WC: Indicates the (*, G) entry.

l      LOC: The switch is connected with the multicast source directly.

Uptime

Time when the entry exists

Timeout in 197 sec

The table entry will expire in 197 seconds.

Upstream interface

Incoming interface

Upstream neighbor

Upstream neighbor

RPT neighbor

l      For the (*, G) entry, when this switch is an RP, RPF neighbor field of the (*, G) entry is Null.

l      For the (S, G) entry, when this switch is directly connected with the source, is an RP, RPF neighbor field of the (S, G) entry is Null.

Downstream interface list

List of downstream interfaces

 

display pim rp-info

Syntax

display pim rp-info [ group-address ]

View

Any view

Parameters

group-address: Multicast group address. With this argument provided, the command displays the RP information about the specified multicast group; otherwise, the command displays the RP information about all multicast groups.

Description

Use the display pim rp-info command to display the RP information of the multicast group.

The output of this command also includes BSR and static RP information.

Examples

# Display the RP information about all multicast groups.

<Sysname> display pim rp-info

 PIM-SM RP-SET information:

    BSR is: 4.4.4.6

 

    Group/MaskLen: 224.0.0.0/4

      RP 4.4.4.6

        Version: 2

        Priority: 0

        Uptime: 00:39:50

        Expires: 00:01:40

Table 3-5 display pim rp-info command output description

Field

Description

PIM-SM RP-SET information:

RP-Set

BSR is:

IP address of the BSR

Group/MaskLen

Multicast group range served by the RP

RP

IP address of the RP

Version

PIM version

Priority

RP priority

Uptime

Length of time for which the RP has existed

Expires

Remaining lifetime of the RP

 

pim

Syntax

pim

undo pim

View

System view

Parameters

None

Description

Use the pim command to enter PIM view so that you can configure PIM parameters globally. Note that this command is not used to enable PIM.

Use the undo pim command to clear PIM configurations made in PIM view.

Examples

# Enter PIM view.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast routing-enable

[Sysname] pim

[Sysname-pim]

pim bsr-boundary

Syntax

pim bsr-boundary

undo pim bsr-boundary

View

Interface view

Parameters

None

Description

Use the pim bsr-boundary command to configure the current interface as the BSR service boundary, namely, the PIM-SM domain border.

Use the undo pim bsr-boundary command to remove the configured PIM-SM domain border.

By default, no PIM-SM domain border is configured on the switch.

After you use this command to set a PIM-SM domain border on an interface, no bootstrap message can cross this border in either direction. However, the other PIM protocol packets can pass the border. With this configuration, you can divide a PIM-SM network into regions with different BSRs.

Note that this command is not used to set up a multicast boundary.

Related commands: c-bsr.

Examples

# Configure a PIM domain border on VLAN-interface 10.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast routing-enable

[Sysname] pim

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] pim bsr-boundary

pim dm

Syntax

pim dm

undo pim dm

View

Interface view

Parameters

None

Description

Use the pim dm command to enable PIM-DM.

Use the undo pim dm command to disable PIM-DM.

By default, PIM-DM is disabled.

Typically, PIM-DM should be enabled on all interfaces.

Before enabling PIM-DM, you must enable multicast routing first.

Related commands: multicast routing-enable.

Examples

# Enable PIM-DM on VLAN-interface 10.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast routing-enable

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] pim dm

pim neighbor-limit

Syntax

pim neighbor-limit limit

undo pim neighbor-limit

View

Interface view

Parameters

limit: Maximum number of PIM neighbors on the interface, in the range of 0 to 128.

Description

Use the pim neighbor-limit command to configure the upper threshold of the number of PIM neighbors on the current interface. The switch will add no more neighbors for the interface when the limit is reached.

Use the undo pim neighbor-limit command to restore the default.

By default, a switch can have a maximum of 128 PIM neighbors on an interface.

If you figure a threshold smaller than the current number of PIM neighbors, the existing PIM neighbors will not be deleted immediately.

Examples

# Limit the number of PIM neighbors to 50 on VLAN-interface 10.

<Sysname>system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast routing-enable

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] pim neighbor-limit 50

pim neighbor-policy

Syntax

pim neighbor-policy acl-number

undo pim neighbor-policy

View

Interface view

Parameters

acl-number: Basic ACL number, in the range of 2,000 to 2,999.

Description

Use the pim neighbor-policy command to configure a PIM neighbor filter on the current interface.

Use the undo pim neighbor-policy command to disable PIM neighbor filtering on the current interface.

With a PIM neighbor filter configured, only the switches that pass the filtering rule in the ACL can become PIM neighbors of the current VLAN interface.

The new configuration overwrites the old one if you run the command for a second time.

By default, no rule is configured to filter PIM neighbors on the current interface.

Examples

# Configure a PIM neighbor filter on VLAN-interface 10 so that only 10.10.1.2 can become its PIM neighbor.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 10.10.1.2 0

[Sysname-acl-basic-2000] rule deny source any

[Sysname-acl-basic-2000] quit

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] pim neighbor-policy 2000

pim sm

Syntax

pim sm

undo pim sm

View

Interface view

Parameters

None

Description

Use the pim sm command to enable PIM-SM on the current interface.

Use the undo pim sm command to disable PIM-SM on the current interface.

By default, PIM-SM is disabled.

Typically, PIM-SM should be enabled on all interfaces.

Before enabling PIM-SM, you must enable multicast routing first.

Related commands: multicast routing-enable.

Examples

# Enable the PIM-SM protocol on VLAN-interface 10.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast routing-enable

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] pim sm

pim timer hello

Syntax

pim timer hello seconds

undo pim timer hello

View

Interface view

Parameters

seconds: PIM Hello interval in seconds, namely the interval between PIM Hello messages, in the range of 1 to 18,000.

Description

Use the pim timer hello command to configure the PIM Hello interval on the current interface.

Use the undo pim timer hello command to restore the default.

By default, an interface sends Hello messages at the interval of 30 seconds.

After PIM-SM is enabled on an interface, the switch periodically sends Hello messages to all the PIM-capable devices to discover PIM neighbors. If the interface receives Hello messages, it means that the interface is connected to neighboring network devices that support PIM, and the interface will add the neighbors to its own neighbor list. If the interface receives no Hello messages from a neighbor in its neighbor list within the specified time, the neighbor is considered to have expired or failed.

Examples

# Configure VLAN-interface 10 of the switch to send Hello messages at the interval of 40 seconds.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast routing-enable

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] pim timer hello 40

register-policy

Syntax

register-policy acl-number

undo register-policy

View

PIM view

Parameters

acl-number: Number of IP advanced ACL that defines the rule for filtering the source and group addresses. The value ranges from 3000 to 3999. Only register messages that match the permit statement can be accepted by the RP.

Description

Use the register-policy command to configure a rule for filtering register messages.

Use the undo register-policy command to remove a rule for filtering register messages.

By default, no rule for filtering register messages is configured.

Examples

# Configure a rule for filtering register messages on the RP to allow multicast sources in the range of 10.10.0.0/16 to send multicast data to multicast groups in the range of 225.1.0.0/16.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] acl number 3010

[Sysname-acl-adv-3010] rule permit ip source 10.10.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255

[Sysname-acl-adv-3010] quit

[Sysname] pim

[Sysname-pim] register-policy 3010

reset pim neighbor

Syntax

reset pim neighbor { all | { neighbor-address | interface interface-type interface-number } * }

View

User view

Parameters

all: Clears all PIM neighbors.

neighbor-address: Neighbor address.

interface interface-type interface-number: Specifies an interface by its type and number. With an interface specified, the command clears PIM neighbors of the specified interface only.

Description

Use the reset pim neighbor command to clear the specified PIM neighbor, PIM neighbors on the specified VLAN interface, or all PIM neighbors.

Related commands: display pim neighbor.

Examples

# Clear the PIM neighbor 25.5.4.3.

<Sysname> reset pim neighbor 25.5.4.3

reset pim routing-table

Syntax

reset pim routing-table { all | { group-address [ mask { mask-length | mask } ] | source-address [ mask { mask-length | mask } ] | incoming-interface interface-type interface-number } * }

View

User view

Parameters

all: Clears all PIM routing entries.

group-address: Multicast group address in the range of 224.0.0.0 to 239.255.255.255.

source-address: Multicast source address.

mask: Mask of the multicast group address or multicast source address, 255.255.255.255 by default.

mask-length: Mask length of the multicast group address or multicast source address, in the range of 0 to 32. The system default is 32.

incoming-interface: Specifies the incoming interface. With this keyword provided, the command clears the PIM routing entries of which the incoming interface is the specified one.

interface-type interface-number: Specifies an interface by its type and number. If you specify null, the command clears the multicast routing entries without an incoming interface.

Description

Use the reset pim routing-table command to clear PIM route entries.

You can provide a source address before or after a group address in the command, as long as they are valid. An error message will be given if you type an invalid address.

In this command, if the group-address is 224.0.0.0/24 and source-address is the RP address (where group address can have a mask, but the resulted IP address must be 224.0.0.0, and source address has no mask), then it means only the (*, *, RP) entry will be cleared.

In this command, if the group-address is a group address, and source-address is 0 (where group address can have a mask and source address has no mask), then only the (*, G) entry will be cleared.

This command shall clear not only multicast route entries from PIM routing table, but also the corresponding route entries and forward entries in the multicast core routing table and MFC.

Related commands: reset multicast routing-table, reset multicast forwarding-table, display pim routing-table.

Examples

# Clear the route entries with the group address of 225.5.4.3 from the PIM routing table.

<Sysname> reset pim routing-table 225.5.4.3

spt-switch-threshold

Syntax

spt-switch-threshold infinity [ group-policy acl-number [ order order-value ] ]

undo spt-switch-threshold [ group-policy acl-number ]

View

PIM view

Parameters

infinity: Specifies to disable RPT-to-SPT switchover.

group-policy acl-number: Applies the configuration to multicast groups that match the specified group policy, where acl-number indicates a basic ACL number, ranging from 2000 to 2999. If no group policy is specified, the configuration applies to all multicast groups.

order order-value: Specifies the order number of the ACL in the group-policy list, where order-value has an effective range of 1 to (the largest order value in the existing group-policy list + 1), but the value range should not include the original order value of the ACL in the group-policy list. If you have assigned an order-value to a certain ACL, do not specify the same order-value for another ACL; otherwise the system gives error information. If you do not specify an order-value, the order value of the ACL will remain the same in the group-policy list.

Description

Use the spt-switch-threshold command to configure the conditions for disabling RPT-to-SPT switchover.

Use the undo spt-switch-threshold command to restore the default setting.

By default, a RPT-to-SPT switchover occurs once the device receives the first multicast packet.

Note that:

l          To adjust the order of an ACL that already exists in the group-policy list, you can use the acl-number argument to specify this ACL and set its order-value. This will insert the ACL to the position of order-value in the group-policy list. The order of the other existing ACLs in the group-policy list will remain unchanged.

l          To use an ACL in the group-policy list, you can use the acl-number argument to specify this ACL and set its order-value. This will insert the ACL to the position of order-value in the group-policy list. If you do not include the order order-value option in your command, the ACL will be appended to the end of the group-policy list.

l          If you use this command multiple times on the same multicast group, the first matched traffic rate configuration in sequence will take effect.

l          Once a multicast forwarding entry is created, subsequent multicast data will not be encapsulated in register messages before being forwarded even if a register outgoing interface exists. Therefore, to avoid forwarding failure, do not include the infinity keyword in the spt-switch-threshold command on a switch that may become an RP (namely, a static RP or a C-RP).

Examples

# Disable RPT-to-SPT switchover on a switch that will never become an RP.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] pim

[Sysname-pim] spt-switch-threshold infinity

source-lifetime

Syntax

source-lifetime interval

undo source-lifetime

View

PIM view

Parameters

interval: Multicast source lifetime in seconds, with an effective range of 210 to 31536000.

Description

Use the source-lifetime command to configure the multicast source lifetime, also known as (S, G) aging time.

Use the undo source-lifetime command to restore the default.

By default, the lifetime of a multicast source is 210 seconds.

 

 

The configured multicast source lifetime applies to all (S, G) entries in the PIM routing table and the multicast routing table rather than on a specific (S, G) entry, and the configuration changes the aging time of all the existing (S, G) entries.

 

Examples

# Set the multicast source lifetime to 3000 seconds.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] pim

[Sysname-pim] source-lifetime 3000

source-policy

Syntax

source-policy acl-number

undo source-policy

View

PIM view

Parameters

acl-number: Basic or advanced ACL, in the range of 2000 to 3999.

Description

Use the source-policy command to configure the switch to filter the received multicast data packets as per the source address(es) or source and group addresses defined in the ACL rule.

Use the undo source-policy command to remove the configuration.

If a basic ACL is employed in the command, the switch filters all the received multicast data packets as per the defined resource address(es). Those fail to pass the filtering will be discarded.

If an advanced ACL is employed in the command, the switch filters all the received multicast data packets as per the defined resource and group addresses. Those fail to pass the filtering will be discarded.

This feature filters not only multicast data packets, but also the multicast data encapsulated in registration messages.

The new configuration overwrites the old one if you run the command for a second time.

Examples

# Configure the switch to accept the multicast data packets from any multicast source but 10.10.1.1.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] multicast routing-enable

[Sysname] pim

[Sysname-pim] source-policy 2000

[Sysname-pim] quit

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule deny source 10.10.1.1 0

[Sysname-acl-basic-2000] rule permit source any

static-rp

Syntax

static-rp rp-address [ acl-number ]

undo static-rp

View

PIM view

Parameters

rp-address: Static RP address. It must be a legal unicast IP address.

acl-number: Specifies a basic ACL, used to control the range of multicast groups to be served by the static RP. The effective range is 2000 to 2999. If no ACL is specified in the command, the static RP will serve all multicast groups; otherwise, the static RP will serve only the multicast groups passing the ACL filtering.

Description

Use the static-rp command to configure a static RP.

Use the undo static-rp command to remove the static RP configuration.

A static RP functions as a backup for the dynamically elected RP to improve network robustness. When the RP elected through the BSR mechanism functions, the static RP does not take effect. The same RP address must be configured on all the devices in the PIM domain.

The new configuration overwrites the existing one if you execute the command for a second time.

Related commands: display pim rp-info.

Examples

# Configure the device that has an interface address of 10.110.0.6 as a static RP that will serve only the multicast groups in the range of 225.0.0.0 to 225.255.255.255.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 225.0.0.0 0.255.255.255

[Sysname] multicast routing-enable

[Sysname] pim

[Sysname-pim] static-rp 10.110.0.6 2000

 


MSDP Configuration Commands

cache-sa-enable

Syntax

cache-sa-enable

undo cache-sa-enable

View

MSDP view

Parameters

None

Description

Use the cache-sa-enable command to enable the SA message caching mechanism.

Use the undo cache-sa-enable command to disable the SA message caching mechanism.

By default, the SA message caching mechanism is enabled.

With the SA message caching mechanism enabled, the switch sends no SA request message to the specified MSDP peer upon receiving a Join message.

Related commands: display msdp sa-cache, reset msdp sa-cache, display msdp sa-count

Examples

# Disable the SA message caching mechanism.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] msdp

[Sysname-msdp] undo cache-sa-enable

display msdp brief

Syntax

display msdp brief

View

Any view

Parameters

None

Description

Use the display msdp brief command to display the brief information of the MSDP peer state.

Examples

# Display the brief information of the MSDP peer state.

<Sysname> display msdp brief

MSDP Peer Brief Information

  Peer's Address     State   Up/Down time   AS     SA Count  Reset Count

  20.20.20.20        Up       00:00:13      100     0         0

Table 4-1 display msdp brief command output description

Field

Description

Peer's Address

Address of the MSDP peer

State

MSDP peer status:

l      Up: Session set up; MSDP peer in session

l      Listen: Session set up; local device as server, in listening state

l      Connect: Session not set up; local device as client, in connecting state

l      Shutdown: Deactivated

l      Down: Connection failed

Up/Down time

Time passed since MSDP peer connection establishment/failure

AS

Number of the AS where the MSDP peer is located. “?” indicates that the system was unable to obtain the AS number

SA Count

The number of (S, G) entries cached in the SA

Reset Count

Number of MSDP peer connection reset times

 

display msdp peer-status

Syntax

display msdp peer-status [ peer-address ]

View

Any view

Parameters

peer-address: Specified the IP address of an MSDP peer of which the detailed information is to be displayed. Without this argument, the command displays the detailed information of all MSDP peers.

Description

Use the display msdp peer-status command to display the detailed MSDP peer state information.

Related commands: peer.

Examples

# Display the detailed information of MSDP peer 10.110.11.11.

<Sysname> display msdp peer-status 10.110.11.11

MSDP Peer 20.20.20.20, AS 100

  Description:

  Information about connection status:

    State: Up

    Up/down time: 14:41:08

    Resets: 0

    Connection interface: LoopBack0 (20.20.20.30)

    Number of sent/received messages: 867/947

    Number of discarded output messages: 0

    Elapsed time since last connection or counters clear: 14:42:40

  Information about (Source, Group)-based SA filtering policy:

    Import policy: none

    Export policy: none

  Information about SA-Requests:

    Policy to accept SA-Request messages: none

    Sending SA-Requests status: disable

  Minimum TTL to forward SA with encapsulated data: 0

  SAs learned from this peer: 0, SA-cache maximum for the peer: none

  Input queue size: 0, Output queue size: 0

  Counters for MSDP message:

    Count of RPF check failure: 0

    Incoming/outgoing SA messages: 0/0

    Incoming/outgoing SA requests: 0/0

    Incoming/outgoing SA responses: 0/0

    Incoming/outgoing data packets: 0/0

Table 4-2 display msdp peer-status command output description

Field

Description

MSDP Peer

MSDP peer address

AS

Number of the AS where the MSDP peer is located. “?” indicates that the system was unable to obtain the AS number

State

MSDP peer status:

l      Up: Session set up; MSDP peer in session

l      Listen: Session set up; local device as server, in listening state

l      Connect: Session not set up; local device as client, in connecting state

l      Shutdown: Deactivated

l      Down: Connection failed

Resets

Number of times the MSDP peer connection is reset

Up/Down time

Time passed since MSDP peer connection establishment/failure

Connection interface

Interface and its IP address used for setting up a TCP connection with the remote MSDP peer

Number of sent/received messages

Number of SA messages sent and received through this connection

Number of discarded output messages

Number of discarded outgoing messages

Elapsed time since last connection or counters clear

Time passed since the information of the MSDP peer was last cleared

Information about (Source, Group)-based SA filtering policy

SA message filtering list information

l      Import policy: Filter list for receiving SA messages from the specified MSDP peer

l      Export policy: Filter list for forwarding SA messages from the specified MSDP peer

Information about SA-Requests

SA requests information

l      Policy to accept SA-Request messages: Filtering rule for receiving or forwarding SA messages from the specified MSDP peer

l      Sending SA-Requests status: Whether enabled to send an SA request message to the designated MSDP peer upon receiving a new Join message

Minimum TTL to forward SA with encapsulated data

Minimum TTL of multicast packet encapsulated in SA messages

SAs learned from this peer

Number of cached SA messages

SA-cache maximum for the peer

Maximum number of SA messages from the specified MSDP peer that can be cached

Input queue size

Data size cached in the input queue

Output queue size

Data size cached in the output queue

Counters for MSDP message

MSDP peer statistics:

l      Count of RPF check failure: Number of SA messages discarded due to RPF check failure

l      Incoming/outgoing SA messages: Number of SA messages received and sent

l      Incoming/outgoing SA requests: Number of SA request received and sent

l      Incoming/outgoing SA responses: Number of SA responses received and sent

l      Incoming/outgoing data packets: Number of received and sent SA messages encapsulated with multicast data

 

display msdp sa-cache

Syntax

display msdp sa-cache [ group-address | source-address | as-number ] *

View

Any view

Parameters

group-address: Multicast group address. With this argument provided, the command displays the (S, G) entries for the specified multicast group.

source-address: Multicast source address. With this argument provided, the command displays the (S, G) entries for the specified multicast source.

as-number: AS number, in the range of 1 to 65535.

Description

Use the display msdp sa-cache command to display (S, G) entries in the SA cache.

Note that:

l          This command gives the corresponding output only after the cache-sa-enable command is executed.

l          If no group address is specified, this command displays the (S, G) entries for all multicast groups.

l          If no source address is specified, this command displays the (S, G) entries corresponding to all multicast sources.

l          If neither a group address nor a source address is specified, this command displays all the (S, G) entries.

l          If no AS number is specified, this command displays the (S, G) entries related to all ASs.

Examples

# Display all (S, G) entries in the SA cache.

<Sysname> display msdp sa-cache

MSDP Total Source-Active Cache - 5 entries

 

(Source, Group)                  Origin RP       Pro   AS   Uptime   Expires

(10.10.1.2, 225.1.1.1)          10.10.10.10      ?    ?   00:00:10 00:05:50

(10.10.1.3, 225.1.1.1)          10.10.10.10      ?    ?   00:00:11 00:05:49

(10.10.1.2, 225.1.1.2)          10.10.10.10      ?    ?   00:00:11 00:05:49

(10.10.2.1, 225.1.1.2)          10.10.10.10      ?    ?   00:00:11 00:05:49

(10.10.1.2, 225.1.2.2)           10.10.10.10       ?     ?   00:00:11 00:05:49

 

 MSDP matched 5 entries

Table 4-3 display msdp sa-cache command output description

Field

Description

MSDP Total Source-Active Cache - 5 entries

Total number of (S, G) entries in the SA cache

(Source, Group)

(S, G) entry: (source address, group address)

Origin RP

Address of the RP that generated the (S, G) entry

Pro

Type of protocol from which the AS number of the origin RP is originated. “?” indicates that the system was unable to obtain the protocol type

AS

AS number of the origin RP. “?” indicates that the system was unable to obtain the AS number

Uptime

Length of time for which the cached (S, G) entry has been existing

Expires

Length of time in which the cached (S, G) entry will expire

 

display msdp sa-count

Syntax

display msdp sa-count [ as-number ]

View

Any view

Parameters

as-number: AS number, in the range of 1 to 65535.

Description

Use the display msdp sa-count command to display the number of (S, G) entries in the SA cache.

The debugging output of this command is available only after the cache-sa-enable command is configured.

Examples

# Display the number of (S, G) entries in the SA cache.

<Sysname> display msdp sa-count

Number of cached Source-Active entries, counted by Peer

  Peer's Address     Number of SA

  10.10.10.10        5

 

  Number of source and group, counted by AS

  AS     Number of source    Number of group

  100    3                    3

 

  Total Source-Active entries: 5

Table 4-4 display msdp sa-count command output description

Field

Description

Number of cached Source-Active entries, counted by Peer

Number of cached (S, G) entries per peer

Peer's Address

Address of the MSDP peer that sends SA messages

Number of SA

Number of (S, G) entries from this peer

Number of source and group, counted by AS

Number of cached (S, G) entries per AS containing the original RP

AS

AS number. “?” indicates that the system was unable to obtain the AS number.

Number of source

Number of multicast sources from this AS

Number of group

Number of multicast groups from this AS

 

import-source

Syntax

import-source [ acl acl-number ]

undo import-source

View

MSDP view

Parameters

acl-number: Basic or advanced IP ACL number, ranging from 2000 to 3999. An ACL controls SA message advertisement by filtering sources (with a basic ACL) and filtering sources or groups (with an advanced ACL). If you do not specify this argument, no multicast source is advertised.

Description

Use the import-source command to specify the (S, G) entries in this domain that need to be advertised when an MSDP peer creates an SA message.

Use the undo import-source command to cancel the configuration.

By default, an SA message advertise any (S, G) entries in the domain.

In addition, you can use the peer sa-policy import command or the peer sa-policy export command to filter forwarded SA messages.

Examples

# Configure the MSDP peer to advertise only the (S, G) entries for multicast sources in the range of 10.10.0.0/16 and multicast groups in the range of 225.1.0.0/16 when creating an SA message.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] acl number 3101

[Sysname-acl-adv-3101] rule permit ip source 10.10.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255

[Sysname-acl-adv-3101] quit

[Sysname] msdp

[Sysname-msdp] import-source acl 3101

msdp

Syntax

msdp

undo msdp

View

System view

Parameters

None

Description

Use the msdp command to enable MSDP and enter MSDP view.

Use the undo msdp command to clear all configurations in MSDP view, release resources occupied by MSDP, and restore the initial state.

Related commands: peer.

Examples

# Enable MSDP and enter MSDP view.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] msdp

# Clear all configurations made in MSDP view.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] undo msdp

msdp-tracert

Syntax

msdp-tracert source-address group-address rp-address [ max-hops max-hops ] [ next-hop-info | sa-info | peer-info ]* [ skip-hops skip-hops ]

View

Any view

Parameters

source-address: Specifies a multicast source address for the tracert operation.

group-address: Specifies a multicast group address for the tracert operation.

rp-address: IP address of the origin RP.

max-hops: Maximum number of hops to be traced, ranging from 1 to 255. The default value is 16.

next-hop-info: Collects the next hop information.

sa-info: Collects the SA entity information.

peer-info: Collects the MSDP peer information.

skip-hops: Number of hops to be skipped before the detailed information is collected, in the range of 0 to 255. The system default is 0.

Description

Use the msdp-tracert command to trace the path along which an SA message travels, so as to locate message loss and minimize configuration errors. After determining the path of the SA message, you can prevent SA flooding through correct configuration.

Examples

# Specify the maximum number of hops to be traced and collect the detailed SA and MSDP peer information.

<Sysname> msdp-tracert 10.10.1.1 225.2.2.2 20.20.20.20 max-hops 10 sa-info peer-info

MSDP tracert: press CTRL_C to break

 D-bit:  set if have this (S,G) in cache but with a different RP

 RP-bit: set if this router is an RP

 NC-bit: set if this router is not caching SA's

 C-bit:  set if this (S,G,RP) tuple is in the cache

 MSDP trace route path information:

   Router Address:  20.20.1.1

     Fixed-length response info:

       Peer Uptime: 10 minutes,  Cache Entry Uptime: 30 minutes

       D-bit: 0,  RP-bit: 1,  NC-bit: 0,  C-bit: 1

       Return Code: Reached-max-hops

     Next Hop info:

       Next-Hop Router Address: 0.0.0.0

     SA info:

       Count of SA messages received for this (S,G,RP): 0

       Count of encapsulated data packets received for this (S,G,RP):0

       SA cache entry uptime: 00:30:00 ,  SA cache entry expiry time: 00:03:32

     Peering info:

       Peering Uptime: 10 minutes,  Count of Peering Resets: 3

Table 4-5 msdp-tracert command output description

Field

Description

Router Address

The address used by the local switch to establish a peering session with the Peer-RPF neighbor

Peer Uptime

The time of the peering session between the local switch and a Peer-RPF neighbor, in minutes. The maximum value is 255.

Cache Entry Uptime

Up time of the (S, G, RP) entry in SA cache of the local switch, in minutes. The maximum value is 255.

D-bit: 1

An (S, G, RP) entry exists in the SA cache of the local switch, but the RP is different from the RP specified in the request message.

RP-bit: 1

The local switch is an RP, but it may be another RP than the source RP in the (S, G, RP) entry.

NC-bit: 0

SA cache is enabled on the local switch.

C-bit: 1

An (S, G, RP) entry exists in SA cache of the local switch.

Return Code: Reached-max-hops

Maximum number of hops is reached. Another possible value is:

Hit-src-RP: The switch of this hop is the source RP in the (S, G, RP) entry.

Next-Hop Router Address: 0.0.0.0

If you use the next-hop-info keyword, the address of Peer-RPF neighbor is displayed.

Count of SA messages received for this (S,G,RP)

The number of SA messages received to trace the (S, G, RP) entry.

Count of encapsulated data packets received for this (S,G,RP)

The number of packets received to trace the (S, G, RP) entry.

SA cache entry uptime

Length of time for which the cached (S, G) entry has been existing, in hours:minutes:seconds

SA cache entry expiry time

Length of time in which the cached (S, G) entry will expire, in hours:minutes:seconds

Peering Uptime: 10 minutes

The time of the peering session between the local switch and a Peer-RPF neighbor

Count of Peering Resets

Count of session resets

 

originating-rp

Syntax

originating-rp interface-type interface-number

undo originating-rp

View

MSDP view

Parameters

interface-type interface-number: Specifies an interface by its type and number.

Description

Use the originating-rp command to configure the address of the specified interface as the RP address in SA messages.

Use the undo originating-rp command to cancel configuration.

By default, the RP address in an SA message is the RP address of the PIM domain.

Examples

# Configure the IP address of VLAN-interface 100 as the RP address in SA messages that will be created by the switch.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] msdp

[Sysname-msdp] originating-rp Vlan-interface 100

peer connect-interface

Syntax

peer peer-address connect-interface interface-type interface-number

undo peer peer-address

View

MSDP view

Parameters

peer-address: Specifies an MSDP peer by its IP address.

interface-type interface-number: Specifies an interface by its type and number. The switch will use the primary address of this interface as the source IP to establish a TCP connection with the remote MSDP peer.

Description

Use the peer connect-interface command to specify an MSDP peer and connect the switch with the MSDP peer through the specified interface.

Use the undo peer connect-interface command to remove an MSDP peering connection.

If an MSDP peer of the switch is a BGP peer to this switch at the same time, the same IP address must be used for both the MSDP peering connection and the BGP peering connection.

Related commands: static-rpf-peer.

Examples

# Configure the switch whose IP address is 125.10 .7.6 as the MSDP peer of the switch and establish a peering connection with the MSDP peer through VLAN-interface 100.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] msdp

[Sysname-msdp] peer 125.10.7.6 connect-interface Vlan-interface 100

peer description

Syntax

peer peer-address description text

undo peer peer-address description

View

MSDP view

Parameters

peer-address: Specifies an MSDP peer by its IP address.

text: Descriptive text, case-sensitive. The maximum length is 80 characters.

Description

Use the peer description command to configure the descriptive text for an MSDP peer so that the administrator can easily distinguish MSDP peers.

Use the undo peer description command to remove the configured descriptive text.

By default, no descriptive text is configured for any MSDP peer.

Related commands: display msdp peer-status.

Examples

# Add the description text Router CstmrA for the MSDP peer 125.10.7.6, meaning that peer is customer A.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] msdp

[Sysname-msdp] peer 125.10.7.6 description router CstmrA

peer mesh-group

Syntax

peer peer-address mesh-group name

undo peer peer-address mesh-group

View

MSDP view

Parameters

peer-address: IP address of the MSDP peer to be added into the mesh group.

name: Name of the mesh group, case-sensitive and containing 1 to 32 characters.

Description

Use the peer mesh-group command to add an MSDP peer to a mesh group.

Use the undo peer mesh-group command to cancel the configuration.

By default, an MSDP peer does not belong to any mesh group.

Examples

# Configure the MSDP peer with the address of 125.10.7.6 as a member of mesh group Grp1.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] msdp

[Sysname-msdp] peer 125.10.7.6 mesh-group Grp1

peer minimum-ttl

Syntax

peer peer-address minimum-ttl ttl-value

undo peer peer-address minimum-ttl

View

MSDP view

Parameters

peer-address: IP address of the MSDP peer to which the minimum TTL setting will apply.

ttl-value: Minimum required TTL value, ranging from 0 to 255.

Description

Use the peer minimum-ttl command to configure the minimum required TTL value for a multicast packet encapsulated in an SA message to be forwarded to the specified MSDP peer.

Use the undo peerminimum-ttl command to restore the system default.

By default, the minimum required TTL value is 0.

Related commands: peer.

Examples

# Set the minimum required TTL value of encapsulated multicast packet to 10 so that only those multicast data packets with a TTL value greater than or equal to 10 can be forwarded to the MSDP peer 110.10.10.1.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] msdp

[Sysname-msdp] peer 110.10.10.1 minimum-ttl 10

peer request-sa-enable

Syntax

peer peer-address request-sa-enable

undo peer peer-address request-sa-enable

View

MSDP view

Parameters

peer-address: Specifies an MSDP peer by its IP address.

Description

Use the peer request-sa-enable command to enable the switch to send an SA request message to the specified MSDP peer upon receipt of a Join message.

Use the undo peer request-sa-enable command to remove the configuration.

By default, upon receipt of a Join message, the switch sends no SA request message to the MSDP peer but waits for the next SA message.

Related commands: cache-sa-enable.

Examples

# Configure to send an SA request message to the MSDP peer 125.10.7.6.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] msdp

[Sysname-msdp] peer 125.10.7.6 request-sa-enable

peer sa-cache-maximum

Syntax

peer peer-address sa-cache-maximum sa-limit

undo peer peer-address sa-cache-maximum

View

MSDP view

Parameters

peer-address: Specifies an MSDP peer by its IP address.

sa-limit: Maximum number of (S, G) entries that can be cached, ranging from 1 to 2,048.

Description

Use the peer sa-cache-maximum command to configure the maximum number of (S, G) entries learned from the specified MSDP peer that the device can cache.

Use the undo peer sa-cache-maximum command to restore the default configuration.

By default, the device can cache a maximum of 2,048 (S, G) entries learned from an MSDP peer..

You are recommended to perform this configuration on all MSDP peers on a network that is vulnerable to DoS attacks.

Related commands: display msdp sa-count, display msdp peer-status, display msdp brief.

Examples

# Allow the device to cache a maximum of 100 (S, G) entries learned from the MSDP peer with the address of 125.10.7.6.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] msdp

[Sysname-msdp] peer 125.10.7.6 sa-cache-maximum 100

peer sa-policy

Syntax

peer peer-address sa-policy { import | export } [ acl acl-number ]

undo peer peer-address sa-policy { import | export }

View

MSDP view

Parameters

peer-address: Specifies an MSDP peer by its IP address.

import: Filters the SA messages from the specified MSDP peer.

export: Filters the SA messages to be forwarded to the specified MSDP peer.

acl acl-number: Specifies an advanced ACL number, ranging from 3000 to 3999. If no ACL is specified, all SA messages carrying (S, G) entries will be filtered out.

Description

Use the peer sa-policy command to configure a filtering rule for receiving or forwarding SA messages.

Use the undo peer sa-policy command to remove the configuration.

By default, no SA message filter is configured; namely, all SA messages are received or forwarded.

Related commands: peer.

Examples

# Configure a filtering rule so that only those SA messages permitted by the ACL 3100 are forwarded to the MSDP peer 125.10.7.6.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] acl number 3100

[Sysname-acl-adv-3100] rule permit ip source 170.15.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255

[Sysname-acl-adv-3100] quit

[Sysname] msdp

[Sysname-msdp] peer 125.10.7.6 connect-interface Vlan-interface 100

[Sysname-msdp] peer 125.10.7.6 sa-policy export acl 3100

peer sa-request-policy

Syntax

peer peer-address sa-request-policy [ acl acl-number ]

undo peer peer-address sa-request-policy

View

MSDP view

Parameters

peer-address: IP address of an MSDP peer, the SA request messages from which will be filtered

acl-number: Basic ACL number, in the range of 2000 to 2999. If no ACL is specified, all SA request messages will be ignored.

Description

Use the peer sa-request-policy command to filter the SA request messages from the specified MSDP peer.

Use the undo peer sa-request-policy command to restore the default.

By default, the switch accepts all SA request messages from any MSDP peer.

If no ACL is specified, all SA requests will be ignored. If an ACL is specified, only those SA request messages from the multicast groups that match the ACL rule will be processed and others will be ignored.

Related commands: peer.

Examples

# Configure the device to accept SA request messages from MSDP peer 175.58.6.5 for multicast groups in the range of 225.1.1.0/24 and ignore all other SA request messages.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] acl number 2001

[Sysname-acl-basic-2001] rule permit source 225.1.1.0 0.0.0.255

[Sysname-acl-basic-2001] quit

[Sysname] msdp

[Sysname-msdp] peer 175.58.6.5 sa-request-policy acl 2001

reset msdp peer

Syntax

reset msdp peer peer-address

View

User view

Parameters

peer-address: Specifies an MSDP peer by its IP address.

Description

Use the reset msdp peer command to reset the TCP connection with the specified MSDP peer and clear all statistics information about that MSDP peer.

Related commands: reset msdp statistics.

Examples

# Reset the TCP connection with the MSDP peer 125.10.7.6 and clear the statistics about the MSDP peer.

<Sysname> reset msdp peer 125.10.7.6

reset msdp sa-cache

Syntax

reset msdp sa-cache [ group-address ]

View

User view

Parameters

group-address: Multicast group address; the cached (S, G) entries matching this address are to be deleted from the SA cache. If no multicast group address is specified, all cached SA entries will be cleared.

Description

Use the reset msdp sa-cache command to clear (S, G) entries from the SA cache.

Related commands: cache-sa-enable, display msdp sa-cache.

Examples

# Clear the (S, G) entries for multicast group 225.5.4.3 from the SA cache.

<Sysname> reset msdp sa-cache 225.5.4.3

reset msdp statistics

Syntax

reset msdp statistics [ peer-address ]

View

User view

Parameters

peer-address: Address of the MSDP peer whose statistics information will be cleared. If no MSDP peer address is specified, the statistics information of all MSDP peers will be cleared.

Description

Use the reset msdp statistics command to clear the statistics information of one or all MSDP peers without resetting the MSDP peer(s).

Related commands: reset msdp peer.

Examples

# Clear the statistics information about MSDP peer 125.10.7.6.

<Sysname> reset msdp statistics 125.10.7.6

shutdown

Syntax

shutdown peer-address

undo shutdown peer-address

View

MSDP view

Parameters

peer-address: Specifies an MSDP peer by its IP address.

Description

Use the shutdown command to shut down the connection with the specified MSDP peer.

Use the undo shutdown command to reactivate an MSDP peering connection.

By default, the connections with all MSDP peers are active.

Related commands: display msdp peer-status.

Examples

# Shut down the MSDP peer 125.10.7.6.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] msdp

[Sysname-msdp] shutdown 125.10.7.6

static-rpf-peer

Syntax

static-rpf-peer peer-address [ rp-policy ip-prefix-name ]

undo static-rpf-peer peer-address

View

MSDP view

Parameters

peer-address: Address of the static RPF peer to receive SA messages.

rp-policy ip-prefix-name: Specifies a filtering policy based on RP addresses to filter RPs in SA messages, where ip-prefix-name is the IP address prefix list containing 1 to 19 characters.

Description

Use the static-rpf-peer command to configure a static RPF peer.

Use the undo static-rpf-peer command to remove a static RPF peer.

By default, no static RPF peer is configured.

If only one MSDP peer is configured with the peer command, the MSDP peer will be regarded as a static RPF peer. When configuring multiple static RPF peers for the same switch, make sure you follow the following two configuration methods:

l          Use the rp-policy keyword for all the MSDP peers. In the case, multiple static RPF peers take effect at the same time. RPs in SA messages are filtered according to the prefix list configured; only SA messages whose RP addresses pass the filtering are received. If multiple static RPF peers using the same rp-policy keyword are configured, when any of the peers receives an SA message, it will forward the SA message to the other peers.

l          Use the rp-policy keyword for none of the MSDP peers. In this case, based on the configuration sequence, only the first static RPF peer whose connection state is UP is active. All the SA messages from this peer will be accepted and those from other static RPF peers will be discarded. Once the active static RPF peer fails (because the configuration is removed or the connection is terminated), based on the configuration sequence, the subsequent first static RPF peer whose connection is in the UP state will be selected as the active static RPF peer.

Related commands: peer, ip ip-prefix.

Examples

# Configure a static RPF peer.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] ip ip-prefix list1 permit 130.10.0.0 16 greater-equal 16 less-equal 32

[Sysname] msdp

[Sysname-msdp] peer 130.10.7.6 connect-interface Vlan-interface 100

[Sysname-msdp] static-rpf-peer 130.10.7.6 rp-policy list1

timer retry

Syntax

timer retry seconds

undo timer retry

View

MSDP view

Parameters

seconds: Connection request retry interval in seconds, ranging from 1 to 60.

Description

Use the timer retry command to configure the connection request retry interval.

Use the undo timer retry command to restore the default.

By default, the connection request retry interval is 30 seconds.

Related commands: peer connect-interface.

Examples

# Set the connection request retry interval to 60 seconds.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] msdp

[Sysname-msdp] timer retry 60

 


IGMP Snooping Configuration Commands

display igmp-snooping configuration

Syntax

display igmp-snooping configuration

View

Any view

Parameters

None

Description

Use the display igmp-snooping configuration command to display IGMP Snooping configuration information.

If IGMP Snooping is disabled on this switch, this command displays a message showing that IGMP Snooping is not enabled.

With IGMP Snooping enabled, this command displays the following information:

l          IGMP Snooping status

l          aging time of the router port

l          maximum response time in IGMP queries

l          aging time of multicast member ports

l          non-flooding feature status

Related commands: igmp-snooping, igmp-snooping router-aging-time, igmp-snooping max-response-time, igmp-snooping host-aging-time, igmp-snooping nonflooding-enable.

Examples

# Display IGMP Snooping configuration information on the switch.

<Sysname> display igmp-snooping configuration

  Enable IGMP-Snooping.

  The router port timeout is 105 second(s).

  The max response timeout is 10 second(s).

  The host port timeout is 260 second(s).

  Enable IGMP-Snooping Non-Flooding.

The above-mentioned information shows: IGMP Snooping is enabled, the aging time of the router port is 105 seconds, the maximum response time in IGMP queries is 10 seconds, the aging time of multicast member ports is 260 seconds, and the IGMP Snooping non-flooding feature is enabled.

display igmp-snooping group

Syntax

display igmp-snooping group [ vlan vlan-id ]

View

Any view

Parameters

vlan vlan-id: Specifies the VLAN in which the multicast group information is to be displayed, where vlan-id ranges from 1 to 4094.. If you do not specify a VLAN, this command displays the multicast group information of all VLANs.

Description

Use the display igmp-snooping group command to display the IGMP Snooping multicast group information.

Related commands: igmp-snooping, igmp host-join, multicast static-group vlan, multicast static-group interface, multicast static-group vlan, multicast static-router-port, multicast static-router-port vlan

Examples

# Display the information about the multicast groups in VLAN 100.

<Sysname> display igmp-snooping group vlan 100

  Total 1 IP Group(s).

  Total 1 MAC Group(s).

  Vlan(id):100.

    Total 1 IP Group(s).

    Total 1 MAC Group(s).

    Static Router port(s):

                     Ethernet1/0/11

    Dynamic Router port(s):

                     Ethernet1/0/22       

IP group(s):the following ip group(s) match to one mac group.

        IP group address:228.0.0.1

        Static host port(s):

                     Ethernet1/0/23

        Dynamic host port(s):

                     Ethernet1/0/10

MAC group(s):

        MAC group address:0100-5e00-0001

        Host port(s):Ethernet1/0/10       Ethernet1/0/23

Table 5-1 display igmp-snooping group command output description

Field

Description

Total 1 IP Group(s).

Total number of IP multicast groups in all VLANs

Total 1 MAC Group(s).

Total number of MAC multicast groups in all VLANs

Vlan(id):

ID of the VLAN whose multicast group information is displayed

Total 1 IP Group(s).

Total number of IP multicast groups in VLAN 100

Total 1 MAC Group(s).

Total number of MAC multicast groups in VLAN 100

Static Router port(s):

Static router port

Dynamic Router port(s):

Dynamic router port

Static host port(s):

Static member port

Dynamic host port(s):

Dynamic member port

IP group address:

IP address of a multicast group

MAC group(s):

MAC multicast group

MAC group address:

Address of a MAC multicast group

Host port(s)

Member ports

 

display igmp-snooping statistics

Syntax

display igmp-snooping statistics

View

Any view

Parameters

None

Description

Use the display igmp-snooping statistics command to display IGMP Snooping statistics.

This command displays the following information: the numbers of the IGMP general query messages, IGMP group-specific query messages, IGMPv1 report messages, IGMPv2 report messages, IGMP leave messages and error IGMP packets received, and the number of the IGMP group-specific query messages sent.

 

When IGMPv3 Snooping is enabled, the device makes statistics of IGMPv3 messages as IGMPv2 messages.

 

Related commands: igmp-snooping.

Examples

# Display IGMP Snooping statistics.

<Sysname> display igmp-snooping statistics

Received IGMP general query packet(s) number:1.

Received IGMP specific query packet(s) number:0.

Received IGMP V1 report packet(s) number:0.

Received IGMP V2 report packet(s) number:3.

Received IGMP leave packet(s) number:0.

Received error IGMP packet(s) number:0.

Sent IGMP specific query packet(s) number:0.

The information above shows that IGMP receives:

l          one IGMP general query messages

l          zero IGMP specific query messages

l          zero IGMPv1 report messages

l          three IGMPv2 report messages

l          zero IGMP leave messages

l          zero IGMP error packets

IGMP Snooping sends:

l          zero IGMP specific query messages

igmp-snooping

Syntax

igmp-snooping { enable | disable }

View

System view, VLAN view

Parameters

enable: Enables the IGMP Snooping feature.

disable: Disables the IGMP Snooping feature.

Description

Use the igmp-snooping enable command to enable the IGMP Snooping feature.

Use the igmp-snooping disable command to disable the IGMP Snooping feature.

By default, the IGMP Snooping feature is disabled.

 

 

l          Although both Layer 2 and Layer 3 multicast protocols can run on the same switch simultaneously, they cannot run simultaneously in the same VLAN and on the corresponding VLAN interface.

l          Before enabling IGMP Snooping in a VLAN, be sure to enable IGMP Snooping globally in system view; otherwise the IGMP Snooping setting will not take effect.

l          If IGMP Snooping and VLAN VPN are enabled on a VLAN at the same time, IGMP queries are likely to fail to pass the VLAN. You can solve this problem by configuring VLAN tags for the IGMP queries. For details, see igmp-snooping vlan-mapping.

 

Examples

# Enable the IGMP Snooping feature on the switch.

<Sysname>system-view

System View: return to User View with Ctrl+Z.

[Sysname] igmp-snooping enable

Enable IGMP-Snooping ok.

igmp-snooping fast-leave

Syntax

igmp-snooping fast-leave [ vlan vlan-list ]

undo igmp-snooping fast-leave [ vlan vlan-list ]

View

System view, Ethernet port view

Parameters

vlan vlan-list: Specifies a VLAN list. With the vlan-list argument, you can provide one or more individual VLAN IDs (in the form of vlan-id) and/or one or more VLAN ID ranges (in the form of vlan-id1 to vlan-id2, where vlan-id2 must be greater than vlan-id1). The effective range for a VLAN ID is 1 to 4094 and the total number of individual VLANs plus VLAN ranges cannot exceed 10.

Description

Use the igmp-snooping fast-leave command to enable IGMP fast leave processing.

Use the undo igmp-snooping fast-leave command to disable IGMP fast leave processing.

By default, IGMP fast leave processing is disabled.

 

l          The fast leave processing function works for a port only if the host attached to the port runs IGMPv2 or IGMPv3.

l          The configuration performed in system view takes effect on all ports of the switch if no VLAN is specified; if one or more VLANs are specified, the configuration takes effect on all ports in the specified VLAN(s).

l          The configuration performed in Ethernet port view takes effect on the port no matter which VLAN it belongs to if no VLAN is specified; if one or more VLANs are specified, the configuration takes effect on the port only if the port belongs to the specified VLAN(s).

l          If fast leave processing and unknown multicast packet dropping or non-flooding are enabled on a port to which more than one host is connected, when one host leaves a multicast group, the other hosts connected to port and interested in the same multicast group will fail to receive multicast data for that group.

 

Examples

# Enable IGMP fast leave processing on Ethernet 1/0/1 in VLAN 2.

<Sysname>system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Ethernet 1/0/1

[Sysname-Ethernet1/0/1] igmp-snooping fast-leave vlan 2

igmp-snooping general-query source-ip

Syntax

igmp-snooping general-query source-ip { current-interface | ip-address }

undo igmp-snooping general-query source-ip

View

VLAN view

Parameters

current-interface: Specifies the IP address of the current VLAN interface as the source address of IGMP general queries. If the current VLAN interface does not have an IP address, the default IP address 0.0.0.0 will be used as the source IP address of IGMP general queries.

ip-address: Specifies the source address of IGMP general queries, which can be any legal IP address.

Description

Use the igmp-snooping general-query source-ip command to configure the source address of IGMP general queries.

Use the undo igmp-snooping general-query source-ip command to restore the default.

This command can take effect only if the IGMP Snooping querier function is enabled on the switch.

By default, the Layer 2 multicast switch sends general query messages with the source IP address of 0.0.0.0.

Related commands: igmp-snooping querier, igmp-snooping query-interval.

Examples

# Configure the switch to send general query messages with the source IP address 2.2.2.2 in VLAN 3.

<Sysname> system-view

System view, return to user view with Ctrl+Z.

[Sysname] igmp-snooping enable

[Sysname] vlan 3

[Sysname-vlan3] igmp-snooping enable

[Sysname-vlan3] igmp-snooping querier

[Sysname-vlan3] igmp-snooping general-query source-ip 2.2.2.2

igmp-snooping group-limit

Syntax

igmp-snooping group-limit limit [ vlan vlan-list ] [ overflow-replace ]

undo igmp-snooping group-limit [ vlan vlan-list ]

View

Ethernet port view

Parameters

limit: Maximum number of multicast groups the port can join, in the range of 1 to 256.

overflow-replace: Allows a new multicast group to replace an existing multicast group with the lowest IP address.

vlan vlan-list: Specifies a VLAN list. With the vlan-list argument, you can provide one or more individual VLAN IDs (in the form of vlan-id) and/or one or more VLAN ID ranges (in the form of vlan-id1 to vlan-id2, where vlan-id2 must be greater than vlan-id1). The effective range for a VLAN ID is 1 to 4094 and the total number of individual VLANs plus VLAN ranges cannot exceed 10.

Description

Use the igmp-snooping group-limit command to define the maximum number of multicast groups the port can join.

Use the undo igmp-snooping group-limit command to restore the default setting.

If you do not specify any VLAN, the command will take effect for all the VLANs to which the current port belongs; if you specify a VLAN or multiple VLANs, the command will take effect for the port only if the port belongs to the specified VLAN(s). It is recommended to specify a VLAN or multiple VLANs to save memory.

By default, the maximum number of multicast groups the port can join is 256.

 

l          To prevent bursting traffic in the network or performance deterioration of the device caused by excessive multicast groups, you can set the maximum number of multicast groups that the switch should process.

l          When the number of multicast groups exceeds the configured limit, the switch removes its multicast forwarding entries starting from the oldest one. In this case, the multicast packets for the removed multicast group(s) will be flooded in the VLAN as unknown multicast packets. As a result, non-member ports can receive multicast packets within a period of time.

l          To avoid this from happening, enable the function of dropping unknown multicast packets.

l          The keyword overflow-replace does not apply to IGMPv3 Snooping, that is, with IGMPv3 Snooping enabled, even if the keyword overflow-replace is configured, a new multicast group will not replace an existing multicast group when the number of multicast groups reaches the maximum value.

 

Examples

# Configure to allow Ethernet 1/0/1 in VLAN 2 to join a maximum of 200 multicast groups.

<Sysname>system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Ethernet 1/0/1

[Sysname-Ethernet1/0/1] igmp-snooping group-limit 200 vlan 2

igmp-snooping group-policy

Syntax

igmp-snooping group-policy acl-number  [ vlan vlan-list ]

undo igmp-snooping group-policy [ vlan vlan-list ]

View

System view, Ethernet port view

Parameters

acl-number: Basic ACL number, in the range of 2000 to 2999.

vlan vlan-list: Specifies a VLAN list. With the vlan-list argument, you can provide one or more individual VLAN IDs (in the form of vlan-id) and/or one or more VLAN ID ranges (in the form of vlan-id1 to vlan-id2, where vlan-id2 must be greater than vlan-id1). The effective range for a VLAN ID is 1 to 4094 and the total number of individual VLANs plus VLAN ranges cannot exceed 10.

Description

Use the igmp-snooping group-policy command to configure a multicast group filter.

Use the undo igmp-snooping group-policy command to remove the configured multicast group filter.

By default, no multicast group filter is configured.

The ACL rule defines a multicast address or a multicast address range (for example 224.0.0.1 to 239.255.255.255) and is used to:

l          Allow the port(s) to join only the multicast group(s) defined in the rule by a permit statement.

l          Inhibit the port(s) from joining the multicast group(s) defined in the rule by a deny statement.

 

l          A port can belong to multiple VLANs, you can configure only one ACL rule per VLAN on a port.

l          If no ACL rule is configured, all the multicast groups will be filtered.

l          Since most devices broadcast unknown multicast packets by default, this function is often used together with the function of dropping unknown multicast packets to prevent multicast streams from being broadcast as unknown multicast packets to a port blocked by this function.

l          The configuration performed in system view takes effect on all ports of the switch if no VLAN is specified; if one or more VLANs are specified, the configuration takes effect on all ports in the specified VLAN(s).

l          The configuration performed in Ethernet port view takes effect on the port no matter which VLAN it belongs to if no VLAN is specified; if one or more VLANs are specified, the configuration takes effect on the port only if the port belongs to the specified VLAN(s).

 

Examples

# Configure a multicast group filter to allow receivers attached to Ethernet 1/0/1 to access the multicast streams for groups 225.0.0.0 to 225.255.255.255.

l          Configure ACL 2000.

<Sysname>system-view

System View: return to User View with Ctrl+Z.

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 225.0.0.0 0.255.255.255

[Sysname-acl-basic-2000] quit

l          Create VLAN 2 and add Ethernet1/0/1 to VLAN 2.

[Sysname] vlan 2

[Sysname-vlan2] port Ethernet 1/0/1

[Sysname-vlan2] quit

l          Apply ACL 2000 on Ethernet1/0/1 to allow it to join only the IGMP multicast groups defined in the rule of ACL 2000.

[Sysname] interface Ethernet 1/0/1

[Sysname-Ethernet1/0/1] igmp-snooping group-policy 2000 vlan 2

[Sysname-Ethernet1/0/1] quit

# Configure a multicast group filter to allow receivers attached to Ethernet 1/0/2 to access the multicast streams for any groups except groups 225.0.0.0 to 225.0.0.255.

l          Configure ACL 2001.

[Sysname] acl number 2001

[Sysname-acl-basic-2001] rule deny source 225.0.0.0 0.0.0.255

[Sysname-acl-basic-2001] rule permit source any

[Sysname-acl-basic-2001] quit

l          Create VLAN 2 and add Ethernet1/0/2 to VLAN 2.

[Sysname] vlan 2

[Sysname-vlan2] port Ethernet 1/0/2

[Sysname-vlan2] quit

l          Configure ACL 2001 on Ethernet1/0/2 to it to join any IGMP multicast groups except those defined in the deny rule of ACL 2001.

[Sysname] interface Ethernet 1/0/2

[Sysname-Ethernet1/0/2] igmp-snooping group-policy 2001 vlan 2

igmp-snooping host-aging-time

Syntax

igmp-snooping host-aging-time seconds

undo igmp-snooping host-aging-time

View

System view

Parameters

seconds: Aging time (in seconds) of multicast member ports, in the range of 200 to 1,000.

Description

Use the igmp-snooping host-aging-time command to configure the aging time of multicast member ports.

Use the undo igmp-snooping host-aging-time command to restore the default aging time.

By default, the aging time of multicast member ports is 260 seconds.

The aging time of multicast member ports determines the refresh frequency of multicast group members. In an environment where multicast group members change frequently, a relatively shorter aging time is required.

Related commands: display igmp-snooping configuration.

Examples

# Set the aging time of multicast member ports to 300 seconds.

<Sysname>system-view

System View: return to User View with Ctrl+Z.

[Sysname] igmp-snooping host-aging-time 300

igmp-snooping max-response-time

Syntax

igmp-snooping max-response-time seconds

undo igmp-snooping max-response-time

View

System view

Parameters

seconds: Maximum response time in IGMP general queries, in the range of 1 to 25.

Description

Use the igmp-snooping max-response-time command to configure the maximum response time in IGMP general queries.

Use the undo igmp-snooping max-response-time command to restore the default.

By default, the maximum response time in IGMP general queries is 10 seconds.

An appropriate setting of the maximum response time in IGMP queries allows hosts to respond to queries quickly and thus the querier can learn the existence of multicast members quickly.

Related commands: display igmp-snooping configuration.

Examples

# Set the maximum response time in IGMP queries to 15 seconds.

<Sysname>system-view

System View: return to User View with Ctrl+Z.

[Sysname] igmp-snooping max-response-time 15

igmp-snooping nonflooding-enable

Syntax

igmp-snooping nonflooding-enable

undo igmp-snooping nonflooding-enable

View

System view

Parameters

None

Description

Use the igmp-snooping nonflooding-enable command to enable the IGMP Snooping non-flooding function. With this function enabled, unknown multicast packets are passed to the router ports of the switch rather than being flooded in the VLAN.

Use the undo igmp-snooping nonflooding-enable command to disable the IGMP Snooping non-flooding function.

By default, the IGMP Snooping non-flooding function is disabled, namely unknown multicast packets are flooded in the VLAN.

The difference between the IGMP Snooping non-flooding function and the function of dropping unknown multicast packets is in that the former passes unknown multicast packets to the router ports while the latter directly discards unknown multicast packets.

You can configure this command only after IGMP Snooping is enabled globally. When IGMP Snooping is disabled globally, the configuration of the igmp-snooping nonflooding-enable command is also removed.

 

l          If the function of dropping unknown multicast packets or the IRF fabric function is enabled, you cannot enable the IGMP Snooping non-flooding function.

l          The IGMP Snooping non-flooding function and the multicast source port suppression function cannot take effect at the same time. If both are configured, only the multicast source port suppression function takes effect.

 

Related commands: unknown-multicast drop enable, multicast-source-deny, display multicast-source-deny

Examples

# Enable IGMP Snooping non-flooding after you enable IGMP Snooping globally and disable both port stacking and unknown-multicast dropping.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] igmp-snooping enable

[Sysname] igmp-snooping nonflooding-enable

igmp-snooping querier

Syntax

igmp-snooping querier

undo igmp-snooping querier

View

VLAN view

Parameters

None

Description

Use the igmp-snooping querier command to enable the IGMP Snooping querier feature on the current VLAN.

Use the undo igmp-snooping querier command to restore the default.

By default, the IGMP Snooping querier feature is disabled.

This command takes effect only if IGMP Snooping is enabled globally and also enabled in the current VLAN.

Related commands: igmp-snooping enable, igmp-snooping query-interval, igmp-snooping general-query source-ip

Examples

# Enable the IGMP Snooping querier in VLAN 3.

<Sysname> system-view

System view, return to user view with Ctrl+Z.

[Sysname] igmp-snooping enable

[Sysname] vlan 3

[Sysname-vlan3] igmp-snooping enable

[Sysname-vlan3] igmp-snooping querier

igmp-snooping query-interval

Syntax

igmp-snooping query-interval seconds

undo igmp-snooping query-interval

View

VLAN view

Parameters

seconds: IGMP query interval, ranging from 1 to 300, in seconds.

Description

Use the igmp-snooping query-interval command to configure the IGMP query interval, namely the interval at which the switch sends IGMP general queries.

Use the undo igmp-snooping query-interval command to restore the default.

By default, the IGMP query interval is 60 seconds.

These commands are effective only after the IGMP Snooping querier feature is enabled. Otherwise, the switch will not send general queries. The configured query interval must be longer than the maximum response time in general queries.

Related commands: igmp-snooping enable, igmp-snooping querier, igmp-snooping max-response-time, igmp-snooping general-query source-ip

Examples

# Configure the IGMP query interval to 100 seconds in VLAN 3.

<Sysname> system-view

System view, return to user view with Ctrl+Z.

[Sysname] igmp-snooping enable

[Sysname] vlan 3

[Sysname-vlan3] igmp-snooping enable

[Sysname-vlan3] igmp-snooping querier

[Sysname-vlan3] igmp-snooping query-interval 100

igmp-snooping router-aging-time

Syntax

igmp-snooping router-aging-time seconds

undo igmp-snooping router-aging-time

View

System view

Parameters

seconds: Aging time of router ports, in the range of 1 to 1,000, in seconds.

Description

Use the igmp-snooping router-aging-time command to configure the aging time of router ports.

Use the undo igmp-snooping router-aging-time command to restore the default aging time.

By default, the aging time of router ports is 105 seconds.

The aging time of router ports should be about 2.5 times the IGMP query interval.

Related commands: igmp-snooping max-response-time, igmp-snooping.

Examples

# Set the aging time of the router port to 500 seconds.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] igmp-snooping router-aging-time 500

igmp-snooping version

Syntax

igmp-snooping version version-number

undo igmp-snooping version

View

VLAN view

Parameters

version-number: IGMP Snooping version, in the range of 2 to 3 and defaulting to 2.

Description

Use the igmp-snooping version command to configure the IGMP Snooping version in the current VLAN.

Use the undo igmp-snooping version command to restore the default IGMP Snooping version.

This command can take effect only if IGMP Snooping is enabled in the VLAN.

Related commands: igmp-snooping enable.

Examples

# Set IGMP Snooping version to version 3 in VLAN 100.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] igmp-snooping enable

Enable IGMP-Snooping ok.

[Sysname] vlan 100

[Sysname -vlan100] igmp-snooping enable

[Sysname -vlan100] igmp-snooping version 3

igmp-snooping vlan-mapping

Syntax

igmp-snooping vlan-mapping vlan vlan-id

undo igmp-snooping vlan-mapping

View

System view

Parameters

vlan vlan-id: VLAN ID, in the range of 1 to 4094.

Description

Use the igmp-snooping vlan-mapping vlan command to configure to transmit IGMP general and group-specific query messages in a specific VLAN.

Use the undo igmp-snooping vlan-mapping command to restore the default.

By default, the VLAN tag carried in IGMP general and group-specific query messages is not changed.

Examples

# Configure IGMP general and group-specific query messages to be transmitted in VLAN 2.

<Sysname>system-view

System View: return to User View with Ctrl+Z.

[Sysname] igmp-snooping enable

[Sysname] igmp-snooping vlan-mapping vlan 2

igmp host-join port

Syntax

igmp host-join group-address [ source-ip source-address ] port interface-list

undo igmp host-join group-address [ source-ip source-address ] port  interface-list

View

VLAN interface view

Parameters

group-address: Address of the multicast group to join.

source-address: Address of the multicast source to join. You can specify a multicast source address only when IGMPv3 Snooping is running in the VLAN.

port interface-list: Configures the specified port or ports under the current VLAN interface as simulated member host(s) for the specified multicast group. With the interface-list argument, you can define one or more individual ports (in the form of interface-type interface-number) and/or one or more port ranges (in the form of interface-type interface-number1 to interface-type interface-number2, where interface-number2 must be greater than interface-number1). The total number of individual ports plus port ranges cannot exceed 10. For port types and port numbers, refer to the parameter description in the “Port Basic Configuration” part in this manual.

Description

Use the igmp host-join port command to configure one or more ports under the current VLAN interface as simulated member hosts to join the specified multicast group or source and group.

Use the undo igmp host-join port command to remove the specified port(s) as simulated member hosts for the specified multicast group or source and group.

By default, simulated joining is disabled.

Unlike a static member port, a port configured as a simulated member host will age out like a dynamic member port.

Related commands: igmp-snooping enable, multicast static-group interface, multicast static-group vlan

 

Before configuring simulated joining, enable IGMP Snooping in the VLAN corresponding to the current VLAN interface.

 

Examples

# Configure Ethernet 1/0/1 under VLAN-interface 10 as a simulated host member host to join multicast group 225.0.0.1.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] igmp-snooping enable

  Enable IGMP-Snooping ok.

[Sysname] vlan 10

[Sysname-vlan10] igmp-snooping enable

[Sysname-vlan10] quit

[Sysname] interface Vlan-interface 10

[Sysname-Vlan-interface10] igmp host-join 225.0.0.1 port Ethernet 1/0/1

igmp host-join

Syntax

igmp host-join group-address [source-ip source-address] vlan vlan-id

undo igmp host-join group-address [source-ip source-address] vlan vlan-id

View

Ethernet port view

Parameters

group-address: Address of the multicast group to join.

source-address: Address of the multicast source to join. You can specify a multicast source address only when IGMPv3 Snooping is running in a VLAN.

vlan vlan-id: ID of the VLAN to which the port belongs, in the range of 1 to 4094.

Description

Use the igmp host-join command to configure the current port as a simulated multicast group member host to join the specified multicast group or source and group.

Use the undo igmp host-join command to remove the current port as a simulated member host for the specified multicast group or source-group.

Unlike a static member port, a port configured as a simulated member host will age out like a dynamic member port.

Related commands: igmp-snooping enable, multicast static-group interface, multicast static-group vlan

 

 

l          Before configuring a port as a simulated host, enable IGMP Snooping in VLAN view first.

l          The current port must belong to the specified VLAN; otherwise this configuration does not take effect.

 

Examples

# Configure Ethernet 1/0/1 in VLAN 1 as a simulated member host for multicast source 1.1.1.1 and multicast group 225.0.0.1.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname]igmp-snooping enable

  Enable IGMP-Snooping ok.

[Sysname]vlan 1

[Sysname-vlan1]igmp-snooping enable

[Sysname-vlan1]igmp-snooping version 3

[Sysname-vlan1]quit

[Sysname] interface Ethernet 1/0/1

[Sysname-Ethernet 1/0/1] igmp host-join 225.0.0.1 source-ip 1.1.1.1 vlan 10

multicast static-group interface

Syntax

multicast static-group group-address interface interface-list

undo multicast static-group group-address interface interface-list

View

VLAN interface view

Parameters

group-address: IP address of the multicast group to join, in the range of 224.0.0.0 to 239.255.255.255.

interface interface-list: Specifies a port list. With the interface-list argument, you can define one or more individual ports (in the form of interface-type interface-number) and/or one or more port ranges (in the form of interface-type interface-number1 to interface-type interface-number2, where interface-number2 must be greater than interface-number1). The total number of individual ports plus port ranges cannot exceed 10. For port types and port numbers, refer to the parameter description in the “Port Basic Configuration” part in this manual.

Description

Use the multicast static-group interface command to configure the specified port(s) under the current VLAN interface as static member port(s) for the specified multicast group.

Use the undo multicast static-group interface command to remove the specified port(s) in the current VLAN as static member port(s) for the specified multicast group.

By default, no port is configured as a static multicast group member port.

 

The ports configured with this command handle Layer 2 multicast traffic only, rather than Layer 3 multicast traffic.

 

Examples

# Configure ports Ethernet 1/0/1 to Ethernet 1/0/3 under VLAN-interface 1 as static members ports for multicast group 225.0.0.1.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Vlan-interface 1

[Sysname-Vlan-interface1] multicast static-group 225.0.0.1 interface Ethernet 1/0/1 to Ethernet 1/0/3

multicast static-group vlan

Syntax

multicast static-group group-address vlan vlan-id

undo multicast static-group group-address vlan vlan-id

View

Ethernet port view

Parameters

group-address: IP address of the multicast group to join, in the range of 224.0.0.0 to 239.255.255.255.

vlan vlan-id: Specifies the VLAN the Ethernet port belongs to, where vlan-id ranges from 1 to 4094.

Description

Use the multicast static-group vlan command to configure the current port in the specified VLAN as a static member port for the specified multicast group.

Use the undo multicast static-group vlan command to remove the current port in the specified VLAN as a static member port for the specified multicast group.

By default, no port is configured as a static multicast group member port.

 

The port configured with this command handles Layer 2 multicast traffic only, rather than Layer 3 multicast traffic.

 

Examples

# Configure port Ethernet1/0/1 in VLAN 2 as a static member port for multicast group 225.0.0.1.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname]interface Ethernet 1/0/1

[Sysname-Ethernet1/0/1] multicast static-group 225.0.0.1 vlan 2

multicast static-router-port

Syntax

multicast static-router-port interface-type interface-number

undo multicast static-router-port interface-type interface-number

View

VLAN view

Parameters

interface-type interface-number: Specifies a port by its type and number.

Description

Use the multicast static-router-port command to configure the specified port in the current VLAN as a static router port.

Use the undo multicast static-router-port command to remove the specified port in the current VLAN as a static router port.

By default, a port is not a static router port.

Examples

# Configure Ethernet 1/0/1 in VLAN 10 as a static router port.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] vlan 10

[Sysname-vlan10] multicast static-router-port Ethernet1/0/1

multicast static-router-port vlan

Syntax

multicast static-router-port vlan vlan-id

undo multicast static-router-port vlan vlan-id

View

Ethernet port view

Parameters

vlan-id: VLAN ID the port belongs to, in the range of 1 to 4094.

Description

Use the multicast static-router-port vlan command to configure the current port in the specified VLAN as a static router port.

Use the undo multicast static-router-port vlan command to remove the current port in the specified VLAN as a static router port.

By default, the static router port function is disabled.

Examples

# Configure Ethernet 1/0/1 in VLAN 10 as a static router port.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Ethernet 1/0/1

[Sysname-Ethernet 1/0/1] multicast static-router-port vlan 10

reset igmp-snooping statistics

Syntax

reset igmp-snooping statistics

View

User view

Parameters

None

Description

Use the reset igmp-snooping statistics command to clear IGMP Snooping statistics.

Related commands: display igmp-snooping statistics.

Examples

# Clear IGMP Snooping statistics.

<Sysname> reset igmp-snooping statistics

service-type multicast

Syntax

service-type multicast

undo service-type multicast

View

VLAN view

Parameters

None

Description

Use the service-type multicast command to configure the current VLAN as a multicast VLAN.

Use the undo service-type multicast command to remove the current VLAN as a multicast VLAN.

By default, no VLAN is a multicast VLAN.

In an IGMP Snooping environment, by configuring a multicast VLAN and adding ports to the multicast VLAN, you can allow users in different VLANs to share the same multicast VLAN. This saves bandwidth because multicast streams are transmitted only within the multicast VLAN. In addition, because the multicast VLAN is isolated from user VLANs, this method also enhances the information security.

 

l          One port belongs to only one multicast VLAN.

l          The port connected to a user terminal must be a hybrid port.

l          The multicast member port must be in the same multicast VLAN with the router port. Otherwise, the port cannot receive multicast packets.

l          If a router port is in a multicast VLAN, the router port must be configured as a trunk port or a hybrid port that allows tagged packets to pass for the multicast VLAN. Otherwise, all the multicast member ports in this multicast VLAN cannot receive multicast packets.

l          If a multicast member port needs to receive multicast packets forwarded by a router port that does not belong to any multicast VLAN, the multicast member port must be removed from the multicast VLAN. Otherwise, the port cannot receive multicast packets.

 

Examples

# Configure VLAN 2 as a multicast VLAN.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] vlan 2

[Sysname-vlan2] service-type multicast

 

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网