igmp-show

To show the Internet Group Management Protocol (IGMP) group membership information for a switch, use this command.

Syntax   igmp-show

group-ip ip-address

Specifies the multicast group IP address.

node-ip ip-address

Specifies the node IP address

vnet vnet-nam

Specifies the name of the VNET.

vlan vlan-id

Specifies the VLAN identifier.

port port-number

Specifies the port number.

source ip-address

Specifies the multicast source traffic.

node-type host|router|switch

Specifies if the router is a host, router, or switch.

expires expires-number(s)

Specifies the ageout time on the IGMP router.

Defaults   All IGMP group membership information for the local switch is displayed unless a single switch is specified.

Access   CLI

History   

Version 1.2

Commmand introduced.

Version 2.4

The parameters, node-type, and expires, added.

Version 2.4.1

The parameter, host-ip, changed to node-ip. The parameter, vnet, added.

Usage   Use this command to display information about IGMP on the network.

Examples  To display all IGMP group membership information for the local switch, use the following command:

CLI network-admin@switch > igmp-show

switch   group-ip  host-ip       vlan port source  

-------- --------- ------------- ---- ---- -------

pubdev03 239.4.9.3 192.168.42.20 1    128  0.0.0.0

pubdev03 239.4.9.3 192.168.42.10 1    128  0.0.0.0

pubdev03 239.4.9.3 192.168.42.30 1    0    0.0.0.0

pubdev03 239.4.9.4 192.168.42.20 3    128  0.0.0.0

pubdev03 239.4.9.4 192.168.42.10 3    128  0.0.0.0

pubdev03 239.4.9.4 192.168.42.30 3    65   0.0.0.0

pubdev03 239.4.9.7 192.168.42.20 3    128  0.0.0.0

pubdev03 239.4.9.7 192.168.42.10 3    128  0.0.0.0

pubdev03 239.4.9.7 192.168.42.30 3    65   0.0.0.0

pubdev03 239.4.9.3 192.168.42.20 3    128  0.0.0.0

pubdev03 239.4.9.3 192.168.42.10 3    128  0.0.0.0

pubdev03 239.4.9.3 192.168.42.30 3    65   0.0.0.0

igmp-querier-ip-modify

You can configure an IGMP querier IP address for a VLAN or as a global IGMP querier. The IGMP querier sends IGMP General Query messages. on the network.

If you do not specify a querier IP address, then Netvisor uses 0.0.0.0 as the default value. There can be an unique querier IP for each VLAN, or you can configure the same Querier IP address for all the VLANs participating in IGMP snooping. The Querier IP address should have a local scope and every switch should have a unique Querier IP address.

With a valid source IP address on IGMP Query packets, the VLAN, where Query is received, is added to an IGMP Snoop switch list, and is now reflected in the igmp-switches-show output and the IGMP queries are sent to the peer Switch as well. This is to solicit a report from the hosts listening on the peer switch.

Syntax   igmp-querier-ip-modify

querier-ip ip-address

Specify the Snooping Querier IP address.

vlans-on-querier-ip vlan-list

Specify the VLAN map for the querier IP address.

Defaults   None

Access   network-admin

History   Command introduced in Version 2.5.

Usage   Configure an IGMP querier IP address for a VLAN or as a global IGMP querier.

Examples  To configure an IGMP querier IP address with a VLAN list of 12-15, use the following syntax:

CLI network-admin@switch > igmp-querier-ip-modify querier-ip 1.1.1.1 vlans-on-querier-ip 12-15

igmp-querier-ip-show

You can configure an IGMP querier IP address for a VLAN or as a global IGMP querier. The IGMP querier sends IGMP General Query messages. on the network.

If you do not specify a querier IP address, then Netvisor uses 0.0.0.0 as the default value. There can be an unique querier IP for each VLAN, or you can configure the same Querier IP address for all the VLANs participating in IGMP snooping. The Querier IP address should have a local scope and every switch should have a unique Querier IP address.

With a valid source IP address on IGMP Query packets, the VLAN, where Query is received, is added to an IGMP Snoop switch list, and is now reflected in the igmp-switches-show output and the IGMP queries are sent to the peer Switch as well. This is to solicit a report from the hosts listening on the peer switch.

Syntax   igmp-querier-ip-show

querier-ip ip-address

Specify the Snooping Querier IP address.

vlans-on-querier-ip vlan-list

Specify the VLAN map for the querier IP address.


Defaults   None

Access   network-admin

History   Command introduced in Version 2.5.

Usage   Display an IGMP querier IP address for a VLAN or as a global IGMP querier.

Examples  To display an IGMP querier IP address with a VLAN list of 12-15, use the following syntax:

CLI network-admin@switch > igmp-querier-ip-show querier-ip 1.1.1.1 vlans-on-querier-ip 12-15

igmp-router-show

This command is used to display IGMP routers on the network.

Syntax   igmp-router-show

node-ip ip-address

Specifies the IP address of the host.

vnet vnet name

Specifies the host vNET.

bd bridge-domain name

Specifies the host bridge domain.

vlan vlan-id

Specifies the ID of the VLAN.

port port-number

Specifies the number of the port.

Defaults   None

Access   CLI

History   

Version 2.2.2

Command introduced.

Version 5.1.1

The parameters, group-ip, source, node-type, and expires, deprecated. The parameters, vnet, and bd, added. 

Usage   Use this command to display information about IGMP routers on the network.

Examples  To display information about IGMP routers on the network, use the following command:

CLI network-admin@switch > igmp-router-show

igmp-snooping-modify

This command enables or disables Internet Group Management Protocol (IGMP) snooping on the network.

Informational Note:  Netvisor does not support IGMPv1. If you use IGMPv1, you must disable IGMP snooping on the Pluribus Networks switch


Syntax   igmp-snooping-modify

Specify one or more of the following options:

scope local|fabric

Specify if the scope is local or fabric.

enable|disable

Specify if IGMP snooping is enabled or disabled.

vxlan|no-vxlan

Specify to enable or disable IGMP snooping on VXLANs.

enable-vlans vlan-list

Specify a list of VLANs to enable for IGMP.

snoop-linklocal-vlans vlan-list

Specify if you allow snooping of link-local groups(224.0.0.0/24) on these VLANs.

no-snoop-linklocal-vlans vlan-list

 

Specify if you do not allow snooping of link-local groups(224.0.0.0/24) on these VLANs.

igmpv3-vlans vlan-list

Specify IGMP Version 3 VLAN list for sending queries.

igmpv2-vlans vlan-list

Specify IGMP Version 2 VLAN list for sending queries.

query-interval seconds

Specify the interval between queries in seconds.

query-max-response-time seconds

Specify the maximum response time for a query.

Defaults   None

Access   CLI

History   

Version 1.2

Command introduced.

Version 2.1

The parameter, scope, added.

Version 2.4

The parameter, version, added.

Version 2.4.1

The parameter, version, changed to igmpv2-vlans and igmpv3-vlans. The parameter, enable-vlans, added.

Version 3.1.0

The parameters, query-interval and query-max-response-time, added.

Version 5.1.1

The parameters, VXLAN and snoop-linklocal, added.

Usage   IGMP snooping allows the switch to listen in on IGMP traffic between hosts and routers, thus maintaining a map of the links that need IP multicast streams. Use this command to modify IGMP snooping on the switch.

Examples  To enable IGMP snooping, use the following command:

CLI network-admin@switch > igmp-snooping-modify enable

igmp-snooping-show

This command displays information about Internet Group Management Protocol (IGMP) snooping on the network.

Informational Note:  Netvisor does not support IGMPv1. If you use IGMPv1, you must disable IGMP snooping on the Pluribus Networks switch

Syntax   igmp-snooping-show

Defaults   None

Access   CLI

History   Command introduced in nvOS Version 1.2.1.

Usage   IGMP snooping allows the switch to listen in on IGMP traffic between hosts and routers, thus maintaining a map of the links that need IP multicast streams. Use this command to display IGMP snooping information on the switch.

Examples  To display information about IGMP snooping, use the following command:

CLI network-admin@switch > igmp-snooping-show

switch: pubdev03

enable: yes

switch: pubdev02

enable: yes

switch: pubdev01

enable: yes

igmp-switches-show

This command is used to display switches with IGMP protocol enabled.

Syntax   igmp-switches-show

node-ip ip-address

Displays the node IP address.

vnet vnet-name

Displays the name of the VNET assigned to the IGMP static source.

bd bridge-domain name

Displays the bridge domain name.

vlan vlan-id

Displays the VLAN identifier.

port port-number

Displays the port number.

Defaults   None

Access   CLI

History   

Version 2.3.3

Command introduced.

Version 2.4.1

The parameters, group-ip, node-type, expires, and source, deprecated. The parameters, vnet and vlan, added.

Version 5.1.1

The parameter, bd, added.

Usage   Displays information about IGMP switches.

Examples  To display IGMP switches, use the following syntax:

CLI network-admin@switch > igmp-switches-show

switch         node-ip vlan port

-------------- ------- ---- ----

spine-1        0.0.0.0 1    3    

spine-1        0.0.0.0 1    57   

spine-1        0.0.0.0 2    3    

spine-1        0.0.0.0 3    3