Router IGMP commands

igmp

Syntax

[no] igmp

Context

config>router

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command enables the Internet Group Management Protocol (IGMP) context. When the context is created, the IGMP protocol is enabled.

IGMP is used by IPv4 systems (hosts and routers) to report their IP multicast group memberships to neighboring multicast routers. An IP multicast router can be a member of one or more multicast groups, in which case it performs both the ‟multicast router part” of the protocol, which collects the membership information needed by its multicast routing protocol, and the ‟group member part” of the protocol, which informs itself and other neighboring multicast routers of its memberships.

The no form of this command disables the IGMP instance. To start or suspend execution of IGMP without affecting the configuration, use the no shutdown command.

interface

Syntax

[no] interface ip-int-name

Context

config>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command configures an IGMP interface. The interface is a local identifier of the network interface on which reception of the specified multicast address is enabled or disabled.

The no form of this command deletes the IGMP interface. The shutdown command in the config>router>igmp>interface context can be used to disable an interface without removing the configuration for the interface.

Default

no interface

Parameters

ip-int-name

Specifies the IP interface name. Interface names must be unique within the group of defined IP interfaces for config router interface and config service ies interface commands. An interface name cannot be in the form of an IP address. Interface names can be any string up to 32 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.

If the IP interface name does not exist or does not have an IP address configured, an error message is returned.

If the IP interface exists in a different area, it is moved to this area.

disable-router-alert-check

Syntax

[no] disable-router-alert-check

Context

config>router>igmp>if

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command enables the router alert checking for IGMP messages received on this interface.

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

import

Syntax

import policy-name

no import

Context

configure>router>igmp>interface

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command applies the referenced IGMP policy (filter) to an interface subscriber or a group interface. An IGMP filter is also known as an allowlist/denylist and is defined under the configure>router>policy-options context.

The no form of this command removes the policy association from the IGMP instance.

Default

no import

Parameters

policy-name

Specifies the route 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, and so on), the entire string must be enclosed within double quotes. Route policies are configured in the config>router>policy-options context.

max-groups

Syntax

max-groups [value]

no max-groups

Context

config>router>igmp>if

config>router>pim>if

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command configures the maximum number of groups for which IGMP can have local receiver information based on received IGMP reports on this interface. When this configuration is changed dynamically to a value lower than the currently accepted number of groups, the groups that are already accepted are not deleted. Only new groups are not allowed. This command is applicable for IPv4 and IPv6.

Default

max-group 0

Parameters

value

Specifies the maximum number of groups for this interface.

Values

1 to 1024

max-sources

Syntax

max-sources [value]

no max-sources

Context

config>router>igmp>group-interface

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command configures the maximum number of group sources for this interface.

Parameters

value

Specifies the maximum number of group sources for this interface.

Values

1 to 1000

static

Syntax

static

Context

config>router>igmp>if

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command tests multicast forwarding on an interface without a receiver host. When enabled, data is forwarded to an interface without receiving membership reports from host members.

group

Syntax

[no] group grp-ip-address

Context

config>router>igmp>if>static

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 one or more (S,G) records. Use IGMP static group memberships to test multicast forwarding without a receiver host. When IGMP static groups are enabled, data is forwarded to an interface without receiving membership reports from host members.

When static IGMP group entries on point-to-point links that connect routers to a rendezvous point (RP) are configured, the static IGMP group entries do not generate join messages toward the RP.

Parameters

grp-ip-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>router>igmp>if>static>group

config>router>igmp>ssm-translate>grp-range

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command specifies the source IPv4 address (S) for the static IGMP group being configured. Multicast traffic to the group (G) is forwarded out the interface on which this static group is configured if the source address in the IPv4 header of the multicast packets matches S.

The source command is mutually exclusive with the specification of individual sources for the same group.

The source command, in combination with the group command, is used to create a specific (S,G) static group entry.

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>router>igmp>if>static>group

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command adds a static (*,G) entry. This command can be enabled only if no existing source addresses for this group are specified.

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

subnet-check

Syntax

[no] subnet-check

Context

config>router>igmp>interface

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command enables subnet checking for IGMP messages received on this interface. All IGMP packets with a source address that is not in the local subnet are dropped.

Default

subnet-check

version

Syntax

version version

no version

Context

config>router>igmp>if

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command specifies the IGMP version. Routers that run different versions of IGMP negotiate the lowest common version of IGMP that is supported by hosts on their subnet and operate in that version. For IGMP to function correctly, all routers on a LAN should be configured to run the same version of IGMP on that LAN.

For IGMPv3, a multicast router that is also a group member performs both parts of IGMPv3, receiving and responding to its own IGMP message transmissions as well as those of its neighbors.

Default

version 3

Parameters

version

Specifies the IGMP version number.

Values

1, 2, 3

Values

>= 1000

query-interval

Syntax

query-interval seconds

no query-interval

Context

config>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command specifies the frequency that the querier router transmits general host-query messages. The host-query messages solicit group membership information and are sent to the all-systems multicast group address, 224.0.0.1.

Default

query-interval 125

Parameters

seconds

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

Values

2 to 1024

query-last-member-interval

Syntax

query-last-member-interval seconds

Context

config>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command configures the frequency at which the querier sends group-specific query messages, including messages sent in response to leave-group messages. The lower the interval, the faster the detection of the loss of the last member of a group.

Default

query-last-member-interval 1

Parameters

seconds

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

Values

1 to 1024

query-response-interval

Syntax

query-response-interval seconds

Context

config>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command specifies how long the querier router waits to receive a response to a host-query message from a host.

Default

query-response-interval 10

Parameters

seconds

Specifies the number of seconds 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>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command configures the robust count. The robust-count variable allows tuning for the expected packet loss on a subnet. If a subnet anticipates losses, the robust-count variable can be increased.

Default

robust-count 2

Parameters

robust-count

Specifies the robust count value.

Values

2 to 10

ssm-translate

Syntax

ssm-translate

Context

config>router>igmp

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

Commands in this context configure group ranges that are translated to SSM (S,G) entries. If the static entry needs to be created, it must be translated from an IGMPv1 IGMPv2 request to a Source Specific Multicast (SSM) join. An SSM translate source can only be added if the starg command is not enabled. An error message is generated if you try to configure the source command with the starg command enabled.

grp-range

Syntax

[no] grp-range start end

Context

config>router>igmp>ssm-translate

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command configures group ranges that are translated to SSM (S,G) entries.

Parameters

start

Specifies an IP address for the start of the group range.

end

Specifies an IP address for the end of the group range. This value should always be greater than or equal to the value of the start value.

source

Syntax

[no] source ip-address

Context

config>router>igmp>ssm-translate>grp-range

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command configures the source IP address for the group range. Whenever a (*,G) report is received in the range specified by grp-range start and end parameters, it is translated to an (S,G) report with the value of this object as the source address.

Parameters

ip-address

Specifies the IP address that will be sending data.