[no] igmp
config>router
Supported on all 7210 SAS platforms as described in this document
This command enables the Internet Group Management Protocol (IGMP) context. When the context is created, IGMP 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 it 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.
[no] interface ip-int-name
config>router>igmp
Supported on all 7210 SAS platforms as described in this document
Commands in this context configure an IGMP interface. The interface is a local identifier of the network interface on which reception of the specified multicast address is to be 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.
no interface
Specifies the IP interface name. Interface names must be unique within the group of defined IP interfaces for the 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 will be moved to this area.
[no] disable-router-alert-check
config>router>igmp>if
Supported on all 7210 SAS platforms as described in this document
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 policy-name
no import
configure>router>igmp>interface
Supported on all 7210 SAS platforms as described in this document
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 it is defined under the configure>router>policy-options context.
The no form of this command removes the policy association from the IGMP instance.
no import
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>policyoptions context.
max-groups [value]
no max-groups
config>router>igmp>if
config>router>pim>if
Supported on all 7210 SAS platforms as described in this document
This command specifies 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 will not be allowed. When the value is 0, there is no limit to the number of groups. This command is applicable for IPv4 only.
max-groups 0
Specifies the maximum number of groups for this interface.
max-sources [value]
no max-sources
config>router>igmp>if
Supported on all 7210 SAS platforms as described in this document
This command configures the maximum number of group sources for this interface
Specifies the maximum number of group sources that can be configured.
query-last-listener-interval seconds
no query-last-listener-interval
config>router>igmp>if
Supported on all 7210 SAS platforms as described in this document
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.
no query-last-listener-interval
Specifies the frequency, in seconds, at which the router transmits group-specific host-query messages.
static
config>router>igmp>if
Supported on all 7210 SAS platforms as described in this document
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.
[no] group grp-ip-address
config>router>igmp>if>static
Supported on all 7210 SAS platforms as described in this document
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.
Specifies an IGMP multicast group address that receives data on an interface. The IP address must be unique for each static group.
[no] source ip-address
config>router>igmp>if>static>group
config>router>igmp>ssm-translate>grp-range
Supported on all 7210 SAS platforms as described in this document
This command specifies an IPv4 unicast address that sends data on an interface. This enables a multicast receiver host to signal to a router the group from which to receive multicast traffic, and the sources from which the traffic is expected.
The source command is mutually exclusive with the specification of individual sources for the same group.
The source command in combination with the group is used to create a specific (S,G) static group entry.
The no form of this command removes the source from the configuration.
Specifies the IPv4 unicast address.
[no] starg
config>router>igmp>if>static>group
Supported on all 7210 SAS platforms as described in this document
This command adds a static (*,G) entry. This command can only be enabled if no existing source addresses for this group are specified.
The no form of this command is used to remove the starg entry from the configuration.
[no] subnet-check
config>router>igmp>interface
Supported on all 7210 SAS platforms as described in this document
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.
The no form of this command disables subnet checking.
subnet-check
version version
no version
config>router>igmp>if
Supported on all 7210 SAS platforms as described in this document
This command specifies the IGMP version. If routers run different versions of IGMP, they will 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.
version 3
Specifies the IGMP version number.
query-interval seconds
no query-interval
config>router>igmp
config>router>igmp>if
Supported on all 7210 SAS platforms as described in this document
This command specifies the frequency at which 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.
query-interval 125
Specifies the time frequency, in seconds, that the router transmits general host-query messages.
query-last-member-interval seconds
config>router>igmp
config>router>igmp>if
Supported on all 7210 SAS platforms as described in this document
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.
query-last-member-interval 1
Specifies the frequency, in seconds, at which query messages are sent.
query-response-interval seconds
config>router>igmp
Supported on all 7210 SAS platforms as described in this document
This command specifies how long the querier router waits to receive a response to a host-query message from a host.
query-response-interval 10
Specifies the length of time to wait to receive a response to the host-query message from the host.
robust-count robust-count
no robust-count
config>router>igmp
Supported on all 7210 SAS platforms as described in this document
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.
robust-count 2
Specifies the robust count value.
ssm-translate
config>router>igmp
Supported on all 7210 SAS platforms as described in this document
Commands in this context configure group ranges, which are translated to source-specific multicast (SSM) (S,G) entries. If the static entry needs to be created, it has to be translated from an IGMPv1 or IGMPv2 request to an 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.
[no] grp-range start end
config>router>igmp>ssm-translate
Supported on all 7210 SAS platforms as described in this document
This command is used to configure group ranges, which are translated to SSM (S,G) entries.
Specifies an IP address that indicates the start of the group range.
Specifies an IP address that indicates the end of the group range. This value should always be greater than or equal to the value of the start value.
[no] source ip-address
config>router>igmp>ssm-translate>grp-range
Supported on all 7210 SAS platforms as described in this document
This command specifies 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.
Specifies the IP address that will be sending data.