IGMP snooping commands

disable-router-alert-check

Syntax

[no] disable-router-alert-check

Context

config>service>vpls>sap>igmp-snooping

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables the Internet Group Management Protocol (IGMP) router alert check option.

The no form of this command disables the router alert check.

description

Syntax

description description-string

no description

Context

config>service>vpls>igmp-snooping>mvr

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command creates a text description stored in the configuration file for a configuration context. The description command associates a text string with a configuration context to help identify the content in the configuration file.

The no form of this command removes the string from the configuration.

Parameters

description-string

Specifies the description character string. Allowed values are any string up to 80 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

fast-leave

Syntax

[no] fast-leave

Context

config>service>vpls>sap>igmp-snooping

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables fast leave. When the IGMP fast leave processing is enabled, the 7210 SAS immediately removes a SAP from the multicast group when it detects an IGMP ‟leave” on that SAP.

Fast-leave processing allows the switch to remove a SAP that sends a ‟leave” from the forwarding table without first sending out group-specific queries to the SAP, and therefore speeds up the process of changing channels (‟zapping”).

Fast leave should only be enabled when there is a single receiver present on the SAP.

When fast-leave is enabled, the configured last-member-query-interval value is ignored.

Default

no fast-leave

from-vpls

Syntax

from-vpls service-id

no from-vpls

Context

config>service>vpls>sap>igmp-snooping>mvr

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the VPLS from which multicast traffic is copied upon receipt of an IGMP join request. IGMP snooping must be enabled on the MVR VPLS.

Default

no from-vpls

Parameters

service-id

Specifies the MVR VPLS from which multicast channels should be copied into this SAP.

Values

service-id: 1 to 2147483648

group

Syntax

[no] group grp-address

Context

config>service>vpls>sap>igmp-snooping>static

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command adds a static multicast group as a (*, g). When a static IGMP group is added, multicast data for that (*,g) or (s,g) is forwarded to the specific SAP without receiving any membership report from a host.

Parameters

grp-address

Specifies an IGMP multicast group address that receives data on an interface. The IP address must be unique for each static group.

group-policy

Syntax

group-policy policy-name

no group-policy

Context

config>service>vpls>igmp-snooping>mvr

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command identifies filter policy of multicast groups to be applied to this VPLS entity. The sources of the multicast traffic must be a member of the VPLS. By default, no group policy is identified.

The no form of this command removes the policy association from the VPLS configuration.

Parameters

policy-name

Specifies the group policy name. Allowed values are any string up to 32 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes. Routing policies are configured in the config>router>policy-options context. The router policy must be defined before it can be imported.

force-vlan-vc-forwarding

Syntax

[no] force-vlan-vc-forwarding

Context

config>service>epipe>spoke-sdp

config>service>vpls>mesh-sdp

config>service>vpls>spoke-sdp

config>service>pw-template

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

This command forces VC VLAN-type forwarding in the datapath for spoke-SDPs or mesh SDPs that have either VC type. This command is not allowed on VLAN VC type SDPs.

The no form of this command reverts to the default value.

Default

disabled

igmp-snooping

Syntax

igmp-snooping

Context

config>service>vpls

config>service>vpls>sap

config>service>vpls>spoke-sdp (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>vpls>mesh-sdp (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>pw-template (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables the IGMP snooping context.

max-num-sources

Syntax

max-num-sources max-num-sources

no max-num-sources

Context

config>service>vpls>sap>igmp-snooping

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the maximum number of multicast sources allowed per group.

The no form of this command removes the value from the configuration.

Parameters

max-num-sources

Specifies the maximum number of multicast sources allowed per group.

Values

1 to 2047 (7210 SAS-D)

1 to 900 (7210 SAS-Dxp, 7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, and 7210 SAS-K 3SFP+ 8C)

import

Syntax

import policy-name

no import

Context

config>service>vpls>sap>igmp-snooping

config>service>vpls>spoke-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>vpls>mesh-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>pw-template>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the import routing policy to be used for IGMP packets to be used on this SAP or SDP. Only a single policy can be imported on a single SAP or SDP at any time.

The no form of this command removes the policy association from the SAP or SDP.

Default

no import

Parameters

policy-name

Specifies the import policy name. Values can be string up to 32 characters of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes. These policies are configured in the config>router>policy-options context The router policy must be defined before it can be imported.

last-member-query-interval

Syntax

last-member-query-interval tenths-of-seconds

no last-member-query-interval

Context

config>service>vpls>sap>igmp-snooping

config>service>vpls>spoke-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>vpls>mesh-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>pw-template>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the maximum response time used in group-specific queries sent in response to ‟leave” messages and is also the amount of time between 2 consecutive group-specific queries. This value may be tuned to modify the leave latency of the network. A reduced value results in reduced time to detect the loss of the last member of a group.

The configured last-member-query-interval is ignored when fast-leave is enabled on the SAP.

Default

10

Parameters

seconds

Specifies the frequency, in tenths of seconds, at which query messages are sent.

Values

1 to 50

max-num-groups

Syntax

max-num-groups count

no max-num-groups

Context

config>service>vpls>sap>igmp-snooping

config>service>vpls>spoke-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>vpls>mesh-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>pw-template>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the maximum number of multicast groups that can be joined on this SAP or SDP. If the node receives an IGMP join message that would exceed the configured number of groups, the request is ignored.

Default

no max-num-groups

Parameters

count

Specifies the maximum number of groups that can be joined on this SAP.

Values

1 to 1024 (7210 SAS-D)

1 to 900 (7210 SAS-Dxp, 7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T, and 7210 SAS-K 3SFP+ 8C)

mrouter-port

Syntax

[no] mrouter-port

Context

config>service>vpls>sap>igmp-snooping

config>service>vpls>spoke-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>vpls>mesh-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configues whether a multicast router is attached behind this SAP.

Configuring a SAP or SDP as an mrouter-port has a double effect. Firstly, all multicast traffic received on another SAP or SDP is copied to this SAP or SDP. Secondly, IGMP reports generated by the system as a result of someone joining or leaving a multicast group, are sent to this SAP or SDP.

If two multicast routers exist in the network, one of them becomes the active querier. While the other multicast router (non-querier) stops sending IGMP queries, it should still receive reports to keep its multicast trees up to date. To support this, the mrouter-port command should be enabled on all SAPs or SDPs connecting to a multicast router.

The IGMP version to be used for the reports (v1or v2) can only be determined after an initial query has been received. Until that time, no reports are sent on the SAP, even if mrouter-port is enabled.

If the send-queries command is enabled on this SAP or SDP, the mrouter-port command cannot be configured.

Default

no mrouter-port

mvr

Syntax

mvr

Context

config>service>vpls>igmp-snooping

config>service>vpls>sap>igmp-snooping

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure Multicast VPLS Registration (MVR) parameters.

query-interval

Syntax

query-interval seconds

no query-interval

Context

config>service>vpls>igmp-snooping

config>service>vpls>sap>igmp-snooping

config>service>vpls>spoke-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>vpls>mesh-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>pw-template>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the IGMP query interval. If the send-queries command is enabled, this command specifies the interval between two consecutive general queries sent by the system on this SAP or SDP. The configured query-interval must be greater than the configured query-response-interval. If send-queries is not enabled on this SAP or SDP, the configured query-interval value is ignored.

Default

query-interval 125

Parameters

seconds

Specifies the time interval, in seconds, that the router transmits general host-query messages.

Values

1 to 65535

config service vpls igmp-snooping

config service vpls spoke-sdp igmp-snooping

config service vpls mesh-sdp igmp-snooping

2 to 1024

config service vpls sap igmp-snooping

config service pw-template igmp-snooping

query-src-ip

Syntax

query-src-ip ip-address

no query-src-ip

Context

config>service>vpls>igmp-snooping

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the IP source address used in IGMP queries.

query-response-interval

Syntax

query-response-interval seconds

Context

config>service>vpls>sap>igmp-snooping

config>service>vpls>spoke-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>vpls>mesh-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>pw-template>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the IGMP query response interval. If the send-queries command is enabled, this command specifies the maximum response time advertised in IGMP queries.

The query-response-interval must be smaller than the query-interval.

If send-queries is not enabled on this SAP or SDP, the query-response-interval value is ignored.

Default

query-response-interval 10

Parameters

seconds

Specifies the length of time to wait to receive a response to the host-query message from the host.

Values

1 to 1023

report-src-ip

Syntax

report-src-ip ip-address

no report-src-ip

Context

config>service>vpls>igmp-snooping

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the source IP address used when generating IGMP reports. According the IGMPv3 standard, a zero source address is allowed in sending IGMP reports. However, for interoperability with some multicast routers, the source IP address of IGMP group reports can be configured using this command.

Default

report-src-ip 0.0.0.0

Parameters

ip-address

Specifies the source IP source address in transmitted IGMP reports.

robust-count

Syntax

robust-count robust-count

no robust-count

Context

config>service>vpls>igmp-snooping

config>service>vpls>sap>igmp-snooping

config>service>vpls>spoke-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>vpls>mesh-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>pw-template>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

If the send-queries command is enabled, this command allows tuning for the expected packet loss on a SAP or SDP. The robust-count value allows tuning for the expected packet loss on a subnet and is comparable to a retry count. If this SAP or SDP is expected to be ‟lossy”, this parameter may be increased. IGMP snooping on this SAP or SDP is robust to (robust-count-1) packet losses.

If send-queries is not enabled, this command is ignored.

Default

robust-count 2

Parameters

robust-count

Specifies the robust count for the SAP.

Values

config service vpls sap igmp-snooping: 2 to 7

config service vpls igmp-snooping: 1 to 255

precedence

Syntax

precedence precedence-value| primary

no precedence

Context

config>service>vpls>spoke-sdp

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

This command configures the spoke-SDP precedence.

Default

precedence 4

Parameters

precedence-value

Specifies the spoke-SDP precedence.

Values

0 to 4

primary

Keyword to specify the precedence is primary.

propagate-mac-flush

Syntax

[no] propagate-mac-flush

Context

config>service>vpls

Platforms

7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C

Description

This command configures whether MAC flush messages received from the specific LDP are propagated to all spoke and mesh SDPs within the context of this VPLS service. The propagation follows the split-horizon principle and any datapath blocking to avoid the looping of these messages.

Default

no propagate-mac-flush

send-queries

Syntax

[no] send-queries

Context

config>service>vpls>sap>igmp-snooping

config>service>vpls>spoke-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>vpls>mesh-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>pw-template>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures whether to send IGMP general query messages on the SAP or SDP.

When the send-queries command is configured, all query reports generated locally are of the type belonging to the configured version. If a report of a version higher than the configured version is received, the report is dropped and a new counter to track the wrong version is incremented. If send-queries is not configured, the version command has no effect, and the version used is the version of the querier.

Default

no send-queries

group

Syntax

[no] group grp-address

Context

config>service>vpls>sap>igmp-snooping>static

config>service>vpls>spoke-sdp>snooping>static (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>vpls>mesh-sdp>snooping>static (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command adds a static multicast group either as a (*, g) or as one or more (s,g) records. When a static IGMP group is added, multicast data for that (*,g) or (s,g) is forwarded to the specific SAP or SDP without receiving a membership report from a host.

Parameters

grp-address

Specifies an IGMP multicast group address that receives data on an interface. The IP address must be unique for each static group.

source

Syntax

[no] source ip-address

Context

config>service>vpls>sap>igmp-snooping>static>group

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command adds a static (s,g) entry, to allow multicast traffic for a multicast group from a specified source. For a multicast group, more than one source address can be specified. Static (s,g) entries cannot be added, if a starg is previously created.

The no form of this command removes the source from the configuration.

Parameters

ip-address

Specifies the IPv4 unicast address.

starg

Syntax

[no] starg

Context

config>service>vpls>sap>igmp-snooping>static>group

config>service>vpls>spoke-sdp>igmp-snooping>static>group (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>vpls>mesh-sdp>igmp-snooping>static>group (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command adds a static (*,g) entry to allow multicast traffic for the corresponding multicast group from any source. This command can only be enabled if no existing source addresses for this group are specified.

The no form of this command removes the starg entry from the configuration.

Default

no starg

static

Syntax

static

Context

config>service>vpls>sap>igmp-snooping

config>service>vpls>spoke-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>vpls>mesh-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure static group addresses. Static group addresses can be configured on a SAP or SDP. When present either as a (*, g) entry, multicast packets matching the configuration are forwarded even if no join message was registered for the specific group.

version

Syntax

version version

no version

Context

config>service>vpls>sap>igmp-snooping

config>service>vpls>mesh-sdp>igmp-snooping

config>service>vpls>spoke-sdp>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>vpls>mesh-sdp>snooping>static (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

config>service>pw-template>igmp-snooping (only supported on 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C)

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the version of IGMP that is running on this SAP. This object can be used to configure a router capable of running either value. For IGMP to function correctly, all routers on a LAN must be configured to run the same version of IGMP on that LAN.

When the send-queries command is configured, all query reports generated locally are of the type belonging to the configured version. If a report of a version higher than the configured version is received, the report is dropped and a new counter to track the wrong version is incremented. If send-queries is not configured, the version command has no effect, and the version used is the version of the querier.

Parameters

version

Specifies the IGMP version.

Values

1, 2, or 3

to-sap

Syntax

to-sap sap-id

no to-sap

Context

config>service>vpls>sap>igmp-snooping>mvr

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the SAP to which the multicast data needs to be copied.

In some scenarios, the multicast traffic should not be copied from the MVR VPLS to the SAP on which the IGMP message was received (standard MVR behavior) but to another SAP.

Default

no to-sap

Parameters

sap-id

Specifies the SAP to which multicast channels should be copied.