Contents

WLAN multicast optimization commands· 1

display wlan ipv6 multicast-optimization entry· 1

display wlan multicast-optimization entry· 2

ipv6 multicast-optimization enable· 4

multicast-optimization enable· 5

reset wlan ipv6 multicast-optimization entry· 5

reset wlan ipv6 multicast-optimization entry group· 6

reset wlan multicast-optimization entry· 6

reset wlan multicast-optimization entry group· 7

wlan ipv6 multicast-optimization aging-time· 7

wlan ipv6 multicast-optimization client entry-limit 8

wlan ipv6 multicast-optimization entry client-limit 8

wlan ipv6 multicast-optimization global entry-limit 9

wlan ipv6 multicast-optimization packet-rate-limit 10

wlan multicast-optimization aging-time· 11

wlan multicast-optimization client entry-limit 11

wlan multicast-optimization entry client-limit 12

wlan multicast-optimization global entry-limit 13

wlan multicast-optimization packet-rate-limit 13

 

WLAN multicast optimization commands

For information about MSR routers that can function as ACs, see "Compatibility of hardware and AC functionality."

display wlan ipv6 multicast-optimization entry

Use display wlan ipv6 multicast-optimization entry to display IPv6 multicast optimization entry information.

Syntax

display wlan ipv6 multicast-optimization entry [ client mac-address [ group group-ip [ source source-ip ] ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

client mac-address: Specifies a client by its MAC address. If you do not specify this option, the command displays information about all IPv6 multicast optimization entries.

group group-ip: Specifies a multicast group by its IP address. If you do not specify this option, the command displays information about all IPv6 multicast optimization entries for the specified client.

source source-ip: Specifies a multicast source by its IP address. If you do not specify this option, the command displays information about all IPv6 multicast optimization entries for the specified multicast group to which the specified client belongs.

Examples

# Display information about all IPv6 multicast optimization entries.

<Sysname> display wlan ipv6 multicast-optimization entry

Total 2 clients reported

 Client: 0000-0000-0001

  Reported from AP 1 on radio 1

  Total number of groups: 1

 

  Group: FF25::1

    Version: MLDv2

    Mode: Include

    Duration: 00h 02m 03s

    Sources: 3

      Source: 1::1

        Duration: 00h 02m 03s

      Source: 1::2

        Duration: 00h 02m 15s

      Source: 1::3

        Duration: 00h 02m 45s

 

 Client: 0000-0000-0002

  Reported from AP 1 on radio 1

  Total number of groups: 1

 

  Group: FF25::2

    Version: MLDv2

    Mode: Include

    Duration: 00h 01m 09s

    Sources: 3

      Source: 1::1

        Duration: 00h 01m 11s

      Source: 1::2

        Duration: 00h 01m 09s

      Source: 1::3

        Duration: 00h 01m 45s

Table 1 Command output

Field	Description
Total 2 clients reported	Number of clients in the multicast optimization entry table.
Client	MAC address of the client.
Group	Multicast group address.
Version	Version of the multicast group: ·     MLDv1. ·     MLDv2.
Mode	WLAN multicast optimization mode of the multicast group: ·     Include—Multicast packets destined to the multicast group are converted to unicast packets if the multicast source address exists in the source address list obtained from MLDv2 reports. ·     Exclude—Multicast packets destined to the multicast group are not converted to unicast packets if the multicast source address does not exist in the source address list obtained from MLDv2 reports. This field always displays Exclude for MLDv1 multicast groups.
Duration	Lifetime of the multicast optimization entry for the multicast group or multicast source.
Source	Multicast source address.

‌

display wlan multicast-optimization entry

Use display wlan multicast-optimization entry to display IPv4 multicast optimization entry information.

Syntax

display wlan multicast-optimization entry [ client mac-address [ group group-ip [ source source-ip ] ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

client mac-address: Specifies a client by its MAC address. If you do not specify this option, the command displays information about all IPv4 multicast optimization entries.

group group-ip: Specifies a multicast group by its IP address. If you do not specify this option, the command displays information about all IPv4 multicast optimization entries for the specified client.

source source-ip: Specifies a multicast source by its IP address. If you do not specify this option, the command displays information about all IPv4 multicast optimization entries for the specified multicast group to which the specified client belongs.

Examples

# Display information about all IPv4 multicast optimization entries.

<Sysname> display wlan multicast-optimization entry

Total 2 clients reported

 Client: 0000-0000-0001

  Reported from AP 1 on radio 1

  Total number of groups: 1

 

  Group: 226.0.0.1

    Version: IGMPv3

    Mode: Include

    Duration: 00h 03m 03s

    Sources: 3

      Source: 27.0.0.1

        Duration: 00h 03m 32s

      Source: 27.0.0.2

        Duration: 00h 03m 15s

      Source: 27.0.0.3

        Duration: 00h 03m 03s

 

 Client: 0000-0000-0002

  Reported from AP 1 on radio 1

  Total number of groups: 2

 

  Group: 226.0.0.1

    Version: IGMPv3

    Mode: Include

    Duration: 00h 02m 15s

    Sources: 3

      Source: 27.0.0.1

        Duration: 00h 02m 32s

      Source: 27.0.0.2

        Duration: 00h 02m 15s

      Source: 27.0.0.3

        Duration: 00h 02m 23s

 

  Group: 226.0.0.2

    Version: IGMPv3

    Mode: Include

    Duration: 00h 01m 11s

    Sources: 2

      Source: 27.0.0.1

        Duration: 00h 01m 12s

      Source: 27.0.0.2

        Duration: 00h 01m 11s

Table 2 Command output

Field	Description
Total 2 clients reported	Number of clients in the multicast optimization entry table.
Client	MAC address of the client.
Group	Multicast group address.
Version	Version of the multicast group: ·     IGMPv1v2—IGMPv1 or IGMPv2. ·     IGMPv3.
Mode	WLAN multicast optimization mode of the multicast group: ·     Include—Multicast packets destined to the multicast group are converted to unicast packets if the multicast source address exists in the source address list obtained from IGMPv3 reports. ·     Exclude—Multicast packets destined to the multicast group are not converted to unicast packets if the multicast source address does not exist in the source address list obtained from IGMPv3 reports. This field always displays Exclude for IGMPv1/v2 multicast groups.
Duration	Lifetime of the multicast optimization entry for the multicast group or multicast source.
Source	Multicast source address.

‌

ipv6 multicast-optimization enable

Use ipv6 multicast-optimization enable to enable IPv6 WLAN multicast optimization.

Use undo ipv6 multicast-optimization enable to disable IPv6 WLAN multicast optimization.

Syntax

ipv6 multicast-optimization enable

undo ipv6 multicast-optimization enable

Default

IPv6 WLAN multicast optimization is disabled.

Views

Service template view

Predefined user roles

network-admin

Examples

# Enable IPv6 WLAN multicast optimization for service template 1.

<Sysname> system-view

[Sysname] wlan service-template 1

[Sysname-wlan-st-1] ipv6 multicast-optimization enable

multicast-optimization enable

Use multicast-optimization enable to enable IPv4 WLAN multicast optimization.

Use undo multicast-optimization enable to disable IPv4 WLAN multicast optimization.

Syntax

multicast-optimization enable

undo multicast-optimization enable

Default

IPv4 WLAN multicast optimization is disabled.

Views

Service template view

Predefined user roles

network-admin

Examples

# Enable IPv4 WLAN multicast optimization for service template 1.

<Sysname> system-view

[Sysname] wlan service-template 1

[Sysname-wlan-st-1] multicast-optimization enable

reset wlan ipv6 multicast-optimization entry

Use reset wlan ipv6 multicast-optimization entry to clear IPv6 multicast optimization entries.

Syntax

reset wlan ipv6 multicast-optimization entry { all | client mac-address [ group group-ip [ source source-ip ] ] }

Views

User view

Predefined user roles

network-admin

Parameters

all: Specifies all IPv6 multicast optimization entries.

client mac-address: Specifies a client by its MAC address.

group group-ip: Specifies a multicast group by its IP address. If you do not specify this option, the command clears all IPv6 multicast optimization entries for the specified client.

source source-ip: Specifies a multicast source by its IP address. If you do not specify this option, the command clears all IPv6 multicast optimization entries for the specified multicast group to which the specified client belongs.

Examples

# Clear all IPv6 multicast optimization entries for the client with MAC address 1011-2222-3334.

<Sysname> reset wlan ipv6 multicast-optimization entry client 1011-2222-3334

Related commands

display wlan ipv6 multicast-optimization entry

reset wlan ipv6 multicast-optimization entry group

Use reset wlan ipv6 multicast-optimization entry group to clear IPv6 multicast optimization entries for the specified multicast group.

Syntax

reset wlan ipv6 multicast-optimization entry group group-ip [ source source-ip ]

Views

User view

Predefined user roles

network-admin

Parameters

group-ip: Specifies a multicast group by its IP address.

source source-ip: Specifies a multicast source by its IP address. If you do not specify this option, the command clears all IPv6 multicast optimization entries for the specified multicast group.

Examples

# Clear IPv6 multicast optimization entries for the multicast group with IPv6 address FF28::1.

<Sysname> reset wlan ipv6 multicast-optimization entry group FF28::1

reset wlan multicast-optimization entry

Use reset wlan multicast-optimization entry to clear IPv4 multicast optimization entries.

Syntax

reset wlan multicast-optimization entry { all | client mac-address [ group group-ip [ source source-ip ] ] }

Views

User view

Predefined user roles

network-admin

Parameters

all: Specifies all IPv4 multicast optimization entries.

client mac-address: Specifies a client by its MAC address.

group group-ip: Specifies a multicast group by its IP address. If you do not specify this option, the command clears all IPv4 multicast optimization entries for the specified client.

source source-ip: Specifies a multicast source by its IP address. If you do not specify this option, the command clears all IPv4 multicast optimization entries for the specified multicast group to which the specified client belongs.

Examples

# Clear all IPv4 multicast optimization entries for the client with MAC address 1011-2222-3334.

<Sysname> reset wlan multicast-optimization entry client 1011-2222-3334

Related commands

display wlan multicast-optimization entry

reset wlan multicast-optimization entry group

Use reset wlan multicast-optimization entry group to clear IPv4 multicast optimization entries for the specified multicast group.

Syntax

reset wlan multicast-optimization entry group group-ip [ source source-ip ]

Views

User view

Predefined user roles

network-admin

Parameters

group-ip: Specifies a multicast group by its address.

source source-ip: Specifies a multicast source by its IP address. If you do not specify this option, the command clears all IPv4 multicast optimization entries for the specified multicast group.

Examples

# Clear IPv4 multicast optimization entries for the multicast group with address 235.1.1.1.

<Sysname> reset wlan multicast-optimization entry group 235.1.1.1

wlan ipv6 multicast-optimization aging-time

Use wlan ipv6 multicast-optimization aging-time to set the aging time for IPv6 multicast optimization entries.

Use undo wlan ipv6 multicast-optimization aging-time to restore the default.

Syntax

wlan ipv6 multicast-optimization aging-time aging-value

undo wlan ipv6 multicast-optimization aging-time

Default

The aging time is 260 seconds for IPv6 multicast optimization entries.

Views

System view

Predefined user roles

network-admin

Parameters

aging-value: Specifies the aging time for IPv6 multicast optimization entries, in the range of 60 to 3600 seconds.

Examples

# Set the aging time to 600 seconds for IPv6 multicast optimization entries.

<Sysname> system-view

[Sysname] wlan ipv6 multicast-optimization aging-time 600

wlan ipv6 multicast-optimization client entry-limit

Use wlan ipv6 multicast-optimization client entry-limit to set the limit for IPv6 multicast optimization entries per client.

Use undo wlan ipv6 multicast-optimization client entry-limit to restore the default.

Syntax

wlan ipv6 multicast-optimization client entry-limit [ limit-value ]

undo wlan ipv6 multicast-optimization client entry-limit

Default

No limit is set for IPv6 multicast optimization entries per client.

Views

System view

Predefined user roles

network-admin

Parameters

limit-value: Specifies the limit for IPv6 multicast optimization entries per client, in the range of 8 to 1024. The default value is 256.

Usage guidelines

Configure this command to limit the number of multicast optimization entries that an AP maintains for each client to prevent a client from occupying excessive system resources.

Examples

# Set the limit to 64 for IPv6 multicast optimization entries per client.

<Sysname> system-view

[Sysname] wlan ipv6 multicast-optimization client entry-limit 64

wlan ipv6 multicast-optimization entry client-limit

Use wlan ipv6 multicast-optimization entry client-limit to configure an IPv6 multicast optimization policy.

Use undo wlan ipv6 multicast-optimization entry client-limit to restore the default.

Syntax

wlan ipv6 multicast-optimization entry client-limit [ limit-value ] [ drop | multicast | unicast ]

undo wlan ipv6 multicast-optimization entry client-limit

Default

No IPv6 multicast optimization policies exist and an AP performs WLAN multicast optimization for all clients.

Views

System view

Predefined user roles

network-admin

Parameters

limit-value: Specifies the threshold for the number of clients that WLAN multicast optimization supports, in the range of 1 to 256. The default value is 8.

drop: Configures an AP to drop a multicast packet when the number of clients to receive the packet exceeds the threshold.

multicast: Configures an AP to forward a multicast packet to all clients when the number of clients to receive the packet exceeds the threshold.

unicast: Configures an AP to process a multicast packet as follows when the number of clients to receive the packet exceeds the threshold:

·     Convert the multicast packet to unicast packets.

·     Send the unicast packets to only n (n equal to the specified threshold) clients that are randomly selected.

Usage guidelines

Use this command to configure the maximum number of clients that WLAN multicast optimization supports and define the action an AP takes when the limit is reached.

If you do not specify an action, an AP performs unicast forwarding.

Examples

# Set the threshold for the number of clients that WLAN multicast optimization supports to 32, and specify the unicast forwarding mode.

<Sysname> system-view

[Sysname] wlan ipv6 multicast-optimization entry client-limit 32 unicast

wlan ipv6 multicast-optimization global entry-limit

Use wlan ipv6 multicast-optimization global entry-limit to set the limit for IPv6 multicast optimization entries.

Use undo wlan ipv6 multicast-optimization global entry-limit to restore the default.

Syntax

wlan ipv6 multicast-optimization global entry-limit [ limit-value ]

undo wlan ipv6 multicast-optimization global entry-limit

Default

No limit is set for IPv6 multicast optimization entries.

Views

System view

Predefined user roles

network-admin

Parameters

limit-value: Specifies the limit for IPv6 multicast optimization entries, in the range of 8 to 8192. The default value is 1024.

Usage guidelines

When the number of multicast optimization entries reaches the limit, the AP stops creating new entries until the number falls below the limit. This action saves system resources.

Examples

# Set the limit for IPv6 multicast optimization entries to 512.

<Sysname> system-view

[Sysname] wlan ipv6 multicast-optimization global entry-limit 512

wlan ipv6 multicast-optimization packet-rate-limit

Use wlan ipv6 multicast-optimization packet-rate-limit to set the maximum number of MLD packets that can be received from clients within the specified period.

Use undo wlan ipv6 multicast-optimization packet-rate-limit to restore the default.

Syntax

wlan ipv6 multicast-optimization packet-rate-limit [ interval interval-value | threshold threshold-value ] *

undo wlan ipv6 multicast-optimization packet-rate-limit

Default

No limit is set for the number of MLD packets that can be received from clients.

Views

System view

Predefined user roles

network-admin

Parameters

interval interval-value: Specifies the interval for calculating the incoming MLD packet rate. The value range is 60 to 3600 seconds. The default setting is 60 seconds.

threshold threshold-value: Specifies the threshold on the number of incoming MLD packets over the specified interval. The value range is 1 to 100000. The default threshold is 100.

Usage guidelines

If the number of MLD packets received from clients reaches the threshold within the specified interval, the AP stops receiving MLD packets from clients until the next period.

Examples

# Configure an AP to receive a maximum of 240 MLD packets every 120 seconds.

<Sysname> system-view

[Sysname] wlan ipv6 multicast-optimization packet-rate-limit interval 120 threshold 240

wlan multicast-optimization aging-time

Use wlan multicast-optimization aging-time to set the aging time for IPv4 multicast optimization entries.

Use undo wlan multicast-optimization aging-time to restore the default.

Syntax

wlan multicast-optimization aging-time aging-value

undo wlan multicast-optimization aging-time

Default

The aging time is 260 seconds for IPv4 multicast optimization entries.

Views

System view

Predefined user roles

network-admin

Parameters

aging-value: Specifies the aging time for IPv4 multicast optimization entries, in the range of 60 to 3600 seconds.

Examples

# Set the aging time to 600 seconds for IPv4 multicast optimization entries.

<Sysname> system-view

[Sysname] wlan multicast-optimization aging-time 600

wlan multicast-optimization client entry-limit

Use wlan multicast-optimization client entry-limit to set the limit for IPv4 multicast optimization entries per client.

Use undo wlan multicast-optimization client entry-limit to restore the default.

Syntax

wlan multicast-optimization client entry-limit [ limit-value ]

undo wlan multicast-optimization client entry-limit

Default

No limit is set for IPv4 multicast optimization entries per client.

Views

System view

Predefined user roles

network-admin

Parameters

limit-value: Specifies the limit for IPv4 multicast optimization entries per client, in the range of 8 to 1024. The default value is 256.

Usage guidelines

Configure this command to limit the number of multicast optimization entries that an AP maintains for each client to prevent a client from occupying excessive system resources.

Examples

# Set the limit to 64 for IPv4 multicast optimization entries per client.

<Sysname> system-view

[Sysname] wlan multicast-optimization client entry-limit 64

wlan multicast-optimization entry client-limit

Use wlan multicast-optimization entry client-limit to configure an IPv4 multicast optimization policy.

Use undo wlan multicast-optimization entry client-limit to restore the default.

Syntax

wlan multicast-optimization entry client-limit [ limit-value ] [ drop | multicast | unicast ]

undo wlan multicast-optimization entry client-limit

Default

No IPv4 multicast optimization policies exist and an AP performs WLAN multicast optimization for all clients.

Views

System view

Predefined user roles

network-admin

Parameters

limit-value: Specifies the threshold for the number of clients that WLAN multicast optimization supports, in the range of 1 to 256. The default value is 8.

drop: Configures an AP to drop a multicast packet when the number of clients to receive the packet exceeds the threshold.

multicast: Configures an AP to forward a multicast packet to all clients when the number of clients to receive the packet exceeds the threshold.

unicast: Configures an AP to process a multicast packet as follows when the number of clients to receive the packet exceeds the threshold:

·     Convert the multicast packet to unicast packets.

·     Send the unicast packets to only n (n equal to the specified threshold) clients that are randomly selected.

Usage guidelines

Use this command to configure the maximum number of clients that WLAN multicast optimization supports and define the action an AP takes when the limit is reached. If you do not specify an action, the AP performs unicast forwarding.

Examples

# Set the threshold for the number of clients that WLAN multicast optimization supports to 32, and specify the unicast forwarding mode.

<Sysname> system-view

[Sysname] wlan multicast-optimization entry client-limit 32 unicast

wlan multicast-optimization global entry-limit

Use wlan multicast-optimization global entry-limit to set the limit for IPv4 multicast optimization entries.

Use undo wlan multicast-optimization global entry-limit to restore the default.

Syntax

wlan multicast-optimization global entry-limit [ limit-value ]

undo wlan multicast-optimization global entry-limit

Default

No limit is set for IPv4 multicast optimization entries.

Views

System view

Predefined user roles

network-admin

Parameters

limit-value: Specifies the limit for IPv4 multicast optimization entries, in the range of 8 to 8192. The default value is 1024.

Usage guidelines

When the number of multicast optimization entries reaches the limit, the AP stops creating new entries until the number falls below the limit. This action saves system resources.

Examples

# Set the limit for IPv4 multicast optimization entries to 512.

<Sysname> system-view

[Sysname] wlan multicast-optimization global entry-limit 512

wlan multicast-optimization packet-rate-limit

Use wlan multicast-optimization packet-rate-limit to set the maximum number of IGMP packets that can be received from clients within the specified period.

Use undo wlan multicast-optimization packet-rate-limit to restore the default.

Syntax

wlan multicast-optimization packet-rate-limit [ interval interval-value | threshold threshold-value ] *

undo wlan multicast-optimization packet-rate-limit

Default

No limit is set for the number of IGMP packets that can be received from clients within the specified period.

Views

System view

Predefined user roles

network-admin

Parameters

interval interval-value: Specifies the interval for calculating the incoming IGMP packet rate. The value range is 60 to 3600 seconds. The default setting is 60 seconds.

threshold threshold-value: Specifies the threshold on the number of incoming IGMP packets over the specified interval. The value range is 1 to 100000. The default threshold is 100.

Usage guidelines

If the number of IGMP packets received from clients reaches the threshold within the specified interval, the AP stops receiving IGMP packets from clients until the next period.

Examples

# Configure an AP to receive a maximum of 240 IGMP packets from clients every 120 seconds.

<Sysname> system-view

[Sysname] wlan multicast-optimization packet-rate-limit interval 120 threshold 240