SAP IGMP-snooping commands

igmp-snooping

Syntax

igmp-snooping

Context

config>service>vpls

config>service>vpls>sap

config>service>vpls>spoke-sdp (not supported in access-uplink operating mode)

config>service>vpls>mesh-sdp (not supported in access-uplink operating mode)

config>service>pw-template (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

Commands in this context configure Internet Group Management Protocol (IGMP) snooping.

disable-router-alert-check

Syntax

[no] disable-router-alert-check

Context

config>service>vpls>sap>igmp-snooping

Platforms

Supported on 7210 SAS platforms operating in access-uplink mode, or in an R-VPLS on 7210 SAS platforms operating in network mode.

Description

This command enables the IGMP router alert check option.

Note:

The disable-router-alert-check command is not supported in a VPLS on 7210 SAS platforms operating in network mode.

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, including those operating in access-uplink mode

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.

Default

no description

Parameters

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, including those operating in access-uplink mode

Description

This command enables fast leave. When IGMP fast leave processing is enabled, the 7210 SAS immediately removes a SAP or SDP from the multicast group when it detects an IGMP ‟leave” on that SAP or SDP. Fast leave processing allows the switch to remove a SAP or SDP that sends a 'leave' from the forwarding table without first sending out group-specific queries to the SAP or SDP, 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 or SDP. 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, including those operating in access-uplink mode

Description

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

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

config>service>vpls>spoke-sdp>igmp-snooping>static (not supported in access-uplink operating mode)

config>service>vpls>mesh-sdp>igmp-snooping>static (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

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

Note:

Only SAPs are supported in an R-VPLS. SDPs are not supported in an R-VPLS.

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, including those operating in access-uplink mode

Description

This command identifies a 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.

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

Default

no group policy

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.

import

Syntax

import policy-name

no import

Context

config>service>vpls>sap>igmp-snooping

config>service>vpls>spoke-sdp>igmp-snooping (not supported in access-uplink operating mode)

config> service>vpls>mesh-sdp>igmp-snooping (not supported in access-uplink operating mode)

config>service>pw-template>igmp-snooping (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

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 (not supported in access-uplink operating mode)

config>service>vpls>mesh-sdp>igmp-snooping (not supported in access-uplink operating mode)

config>service>pw-template>igmp-snooping (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

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 or SDP.

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 max-num-groups

no max-num-groups

Context

config>service>vpls>sap>igmp-snooping

config>service>vpls>spoke-sdp>igmp-snooping (not supported in access-uplink operating mode)

config>service>vpls>mesh-sdp>igmp-snooping (not supported in access-uplink operating mode)

config>service>pw-template>igmp-snooping (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command defines 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

max-num-groups

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

Values

For VPLS (SAP, mesh SDP, and spoke-SDP):

1 to 2043

For R-VPLS:

1 to 1000

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, including those operating in access-uplink mode

Description

This command defines the maximum number of multicast sources allowed per group that can be joined on this SAP. If the node receives an IGMP join message that would exceed the configured number of sources, the request is ignored.

Note:

The max-num-sources command is applicable only in the context of R-VPLS service. It cannot be used in the context of VPLS service.

The no form of this command disables checking the number of sources.

Default

no max-num-sources

Parameters

max-num-sources

Specifies the maximum number of multicast sources per group that can be joined on this SAP.

Values

1 to 2043

mrouter-port

Syntax

[no] mrouter-port

Context

config>service>vpls>sap>igmp-snooping

config>service>vpls>spoke-sdp>igmp-snooping (not supported in access-uplink operating mode)

config>service>vpls>mesh-sdp>igmp-snooping (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command specifies whether a multicast router is attached behind this SAP or SDP.

Configuring a SAP or SDP as an mrouter-port has a double effect. First, all multicast traffic received on another SAP or SDP is copied to this SAP or SDP. Second, 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. Even though the other multicast router (non-querier) stops sending IGMP queries, it still receives 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.

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

If the send-queries command is enabled on this SAP, the mrouter-port parameter cannot be set.

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, including those operating in access-uplink mode

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 (not supported in access-uplink operating mode)

config>service>vpls>mesh-sdp>igmp-snooping (not supported in access-uplink operating mode)

config>service>pw-template>igmp-snooping (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command configures the IGMP query interval. If the send-queries command is enabled, this parameter 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

125

Parameters

seconds

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

Values

2 to 1024

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, including those operating in access-uplink mode

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 (not supported in access-uplink operating mode)

config>service>vpls>mesh-sdp>igmp-snooping (not supported in access-uplink operating mode)

config>service>pw-template>igmp-snooping (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

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

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

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

Default

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

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 (not supported in access-uplink operating mode)

config>service>vpls>mesh-sdp>igmp-snooping (not supported in access-uplink operating mode)

config>service>pw-template>igmp-snooping (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

If the send-queries command is enabled, this parameter allows tuning for the expected packet loss on a SAP or SDP. The robust-count variable 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 parameter is ignored.

Default

2

Parameters

robust-count

Specifies the robust count for the SAP or SDP.

Values

config>service>vpls>sap>igmp-snooping: 2 to 7

config>service>vpls>igmp-snooping: 1 to 255

config>service>vpls>spoke->sdp>igmp-snooping: 2 to 7

config>service>vpls>mesh-sdp>igmp-snooping: 2 to 7

report-src-ip

Syntax

report-src-ip-address

no report-src-ip

Context

config>service>vpls>igmp-snooping

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This parameter specifies 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

0.0.0.0

Parameters

ip-address

Specifies the source IP source address in transmitted IGMP reports.

precedence

Syntax

precedence precedence-value | primary

no precedence

Context

config>service>vpls>spoke-sdp

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode

Description

This command configures the spoke-SDP precedence.

Default

4

Parameters

precedence-value

Specifies the spoke-SDP precedence.

Values

0 to 4

primary

Specifies that the precedence is primary.

propagate-mac-flush

Syntax

[no] propagate-mac-flush

Context

config>service>vpls

Platforms

Supported on all 7210 SAS platforms as described in this document, except those operating in access-uplink mode

Description

This command specifies 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 (not supported in access-uplink operating mode)

config>service>vpls>mesh-sdp>igmp-snooping (not supported in access-uplink operating mode)

config>service>pw-template>igmp-snooping (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

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

When send-queries is configured, all type of queries generate ourselves are of the configured version. If a report of a version higher than the configured version is received, the report gets dropped and a new wrong version counter gets incremented. If send-queries is not configured, the version command has no effect. The version used is the version of the querier.

Default

no send-queries

static

Syntax

static

Context

config>service>vpls>sap>igmp-snooping

config>service>vpls>spoke-sdp>igmp-snooping (not supported in access-uplink operating mode)

config>service>vpls>mesh-sdp>igmp-snooping (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command enables access to the context to 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 is forwarded even if no join message was registered for the specific group.

source

Syntax

source ip-address

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, including those operating in access-uplink mode

Description

This command adds a static (s,g) entry to allow multicast traffic for the corresponding multicast group from the specified source.

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

Note:

The source command is supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode. For 7210 SAS platforms operating in the network mode, the source command must be executed within the context of an R-VPLS.

The source command cannot be used within the context of a VPLS.

Default

no source

starg

Syntax

[no] starg

Context

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

config>service>vpls>spoke-sdp>igmp-snooping>static>group (not supported in access-uplink operating mode)

config>service>vpls>mesh-sdp>igmp-snooping>static>group (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

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

version

Syntax

version version

no version

Context

config>service>vpls>sap>igmp-snooping

config>service>vpls>mesh-sdp>igmp-snooping (not supported in access-uplink operating mode)

config>service>vpls>spoke-sdp>igmp-snooping (not supported in access-uplink operating mode)

config>service>vpls>mesh-sdp>snooping>static (not supported in access-uplink operating mode)

config>service>pw-template>igmp-snooping (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command specifies the version of IGMP which is running on this SAP or SDP. 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-query command is configured, all query types generated locally are of the configured version. If a report of a version higher than the configured version is received, the report gets dropped and the ‟wrong version” counter is incremented.

If the send-query command is not configured, the version command has no effect. The version used on that SAP is the version of the querier.

Note:

IGMPv3 is only supported on 7210 SAS platforms operating in access-uplink mode, or in an R-VPLS on 7210 SAS platforms operating in network mode.

Parameters

version

Specifies the IGMP version.

Values

1 or 2 (in network mode for VPLS services)

1, 2, or 3 (access-uplink mode)

1, 2, 3 (for R-VPLS, only in network mode)

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, including those operating in access-uplink mode

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 or MVR R-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.