09 IP Multicast Command Reference

HomeSupportResource CenterReference GuidesCommand ReferencesH3C MSR Router Series Comware 7 Command References-R0615-6W20209 IP Multicast Command Reference
Table of Contents
Related Documents
01-Text
Title Size Download
01-Text 1.76 MB

Contents

IGMP snooping commands· 1

display igmp-snooping· 1

display igmp-snooping group· 3

display igmp-snooping router-port 5

display igmp-snooping static-group· 7

display igmp-snooping static-router-port 9

display igmp-snooping statistics· 10

display l2-multicast fast-forwarding cache· 11

display l2-multicast ip· 13

display l2-multicast ip forwarding· 14

display l2-multicast mac· 16

display l2-multicast mac forwarding· 17

dot1p-priority (IGMP-snooping view) 19

enable (IGMP-snooping view) 19

entry-limit (IGMP-snooping view) 20

fast-leave (IGMP-snooping view) 21

group-policy (IGMP-snooping view) 21

host-aging-time (IGMP-snooping view) 22

igmp-snooping· 23

igmp-snooping dot1p-priority· 24

igmp-snooping drop-unknown· 25

igmp-snooping enable· 26

igmp-snooping fast-leave· 26

igmp-snooping general-query source-ip· 27

igmp-snooping group-limit 28

igmp-snooping group-policy· 29

igmp-snooping host-aging-time· 30

igmp-snooping host-join· 31

igmp-snooping last-member-query-interval 32

igmp-snooping leave source-ip· 32

igmp-snooping max-response-time· 33

igmp-snooping overflow-replace· 34

igmp-snooping querier 35

igmp-snooping query-interval 36

igmp-snooping report source-ip· 36

igmp-snooping router-aging-time· 37

igmp-snooping router-port-deny· 38

igmp-snooping source-deny· 39

igmp-snooping special-query source-ip· 39

igmp-snooping static-group· 40

igmp-snooping static-router-port 41

igmp-snooping version· 42

last-member-query-interval (IGMP-snooping view) 42

max-response-time (IGMP-snooping view) 43

overflow-replace (IGMP-snooping view) 44

report-aggregation (IGMP-snooping view) 45

reset igmp-snooping group· 45

reset igmp-snooping router-port 46

reset igmp-snooping statistics· 46

reset l2-multicast fast-forwarding cache· 47

router-aging-time (IGMP-snooping view) 48

source-deny (IGMP-snooping view) 48

version (IGMP-snooping view) 49

Multicast routing and forwarding commands· 51

delete ip rpf-route-static· 52

display mac-address [ multicast ] 52

display mrib interface· 53

display multicast boundary· 54

display multicast fast-forwarding cache· 55

display multicast forwarding df-info· 57

display multicast forwarding event 59

display multicast forwarding-table· 61

display multicast forwarding-table df-list 64

display multicast routing-table· 65

display multicast routing-table static· 67

display multicast rpf-info· 68

ip rpf-route-static· 69

load-splitting (MRIB view) 70

longest-match (MRIB view) 70

mac-address multicast 71

multicast boundary· 72

multicast routing· 73

reset multicast fast-forwarding cache· 74

reset multicast forwarding event 75

reset multicast forwarding-table· 75

reset multicast routing-table· 76

IGMP commands· 78

display igmp group· 78

display igmp interface· 82

display igmp proxy group· 84

display igmp proxy routing-table· 86

display igmp ssm-mapping· 88

igmp· 89

igmp enable· 90

igmp fast-leave· 90

igmp group-policy· 91

igmp last-member-query-count 92

igmp last-member-query-interval 93

igmp max-response-time· 94

igmp non-stop-routing· 94

igmp other-querier-present-interval 95

igmp proxy enable· 96

igmp proxy forwarding· 97

igmp query-interval 97

igmp robust-count 98

igmp startup-query-count 99

igmp startup-query-interval 99

igmp static-group· 100

igmp version· 101

last-member-query-count (IGMP view) 101

last-member-query-interval (IGMP view) 102

max-response-time (IGMP view) 103

other-querier-present-interval (IGMP view) 103

proxy multipath (IGMP view) 104

query-interval (IGMP view) 105

reset igmp group· 105

robust-count (IGMP view) 106

ssm-mapping (IGMP view) 107

startup-query-count (IGMP view) 108

startup-query-interval (IGMP view) 108

PIM commands· 110

anycast rp (PIM view) 110

auto-rp enable (PIM view) 111

bidir-pim enable (PIM view) 111

bidir-rp-limit (PIM view) 112

bsm-fragment enable (PIM view) 113

bsm-reflection enable (PIM view) 114

bsr-policy (PIM view) 114

c-bsr (PIM view) 115

c-rp (PIM view) 116

crp-policy (PIM view) 117

display interface register-tunnel 118

display pim bsr-info· 120

display pim claimed-route· 122

display pim c-rp· 123

display pim df-info· 124

display pim interface· 125

display pim nbma-link· 128

display pim neighbor 129

display pim routing-table· 130

display pim rp-info· 135

display pim statistics· 137

hello-option dr-priority (PIM view) 138

hello-option holdtime (PIM view) 138

hello-option lan-delay (PIM view) 139

hello-option neighbor-tracking (PIM view) 140

hello-option override-interval (PIM view) 141

holdtime join-prune (PIM view) 141

jp-pkt-size (PIM view) 142

pim·· 143

pim bfd enable· 143

pim bsr-boundary· 144

pim dm·· 144

pim hello-option dr-priority· 145

pim hello-option holdtime· 146

pim hello-option lan-delay· 146

pim hello-option neighbor-tracking· 147

pim hello-option override-interval 148

pim holdtime join-prune· 149

pim nbma-mode· 150

pim neighbor-policy· 150

pim non-stop-routing· 151

pim passive· 152

pim require-genid· 153

pim sm·· 153

pim state-refresh-capable· 154

pim timer graft-retry· 154

pim timer hello· 155

pim timer join-prune· 155

pim triggered-hello-delay· 156

register-policy (PIM view) 157

register-suppression-timeout (PIM view) 157

register-whole-checksum (PIM view) 158

snmp-agent trap enable pim·· 158

source-lifetime (PIM view) 159

source-policy (PIM view) 160

spt-switch-threshold (PIM view) 161

ssm-policy (PIM view) 162

state-refresh-interval (PIM view) 162

state-refresh-rate-limit (PIM view) 163

state-refresh-ttl (PIM view) 164

static-rp (PIM view) 164

timer hello (PIM view) 166

timer join-prune (PIM view) 166

MSDP commands· 168

cache-sa-enable· 168

display msdp brief 169

display msdp peer-status· 170

display msdp sa-cache· 173

display msdp sa-count 175

encap-data-enable· 176

import-source· 176

msdp· 177

originating-rp· 178

peer 178

peer description· 179

peer mesh-group· 180

peer minimum-ttl 180

peer password· 181

peer request-sa-enable· 181

peer sa-cache-maximum·· 182

peer sa-policy· 183

peer sa-request-policy· 184

reset msdp peer 185

reset msdp sa-cache· 185

reset msdp statistics· 186

shutdown (MSDP view) 186

static-rpf-peer 187

timer keepalive· 188

timer retry· 189

Multicast VPN commands· 190

address-family ipv4· 190

address-family ipv4 mdt 191

address-family ipv6· 192

data-delay· 193

data-group· 193

data-holddown· 194

default-group· 195

display bgp routing-table ipv4 mdt 196

display multicast-domain data-group receive· 199

display multicast-domain data-group send· 200

display multicast-domain default-group· 202

display multicast-domain ipv6 data-group receive· 203

display multicast-domain ipv6 data-group send· 205

display multicast-domain ipv6 default-group· 206

log data-group-reuse· 208

multicast-domain· 208

multicast rpf-proxy-vector compatible· 209

rpf proxy vector 209

source· 210

MLD snooping commands· 211

display ipv6 l2-multicast fast-forwarding cache· 211

display ipv6 l2-multicast ip· 213

display ipv6 l2-multicast ip forwarding· 215

display ipv6 l2-multicast mac· 216

display ipv6 l2-multicast mac forwarding· 218

display mld-snooping· 219

display mld-snooping group· 221

display mld-snooping router-port 223

display mld-snooping static-group· 225

display mld-snooping static-router-port 227

display mld-snooping statistics· 228

dot1p-priority (MLD-snooping view) 229

enable (MLD-snooping view) 230

entry-limit (MLD-snooping view) 230

fast-leave (MLD-snooping view) 231

group-policy (MLD-snooping view) 232

host-aging-time (MLD-snooping view) 233

last-listener-query-interval (MLD-snooping view) 234

max-response-time (MLD-snooping view) 234

mld-snooping· 235

mld-snooping done source-ip· 235

mld-snooping dot1p-priority· 236

mld-snooping drop-unknown· 237

mld-snooping enable· 238

mld-snooping fast-leave· 239

mld-snooping general-query source-ip· 239

mld-snooping group-limit 240

mld-snooping group-policy· 241

mld-snooping host-aging-time· 242

mld-snooping host-join· 243

mld-snooping last-listener-query-interval 244

mld-snooping max-response-time· 245

mld-snooping overflow-replace· 246

mld-snooping querier 247

mld-snooping query-interval 247

mld-snooping report source-ip· 248

mld-snooping router-aging-time· 249

mld-snooping router-port-deny· 250

mld-snooping source-deny· 250

mld-snooping special-query source-ip· 251

mld-snooping static-group· 252

mld-snooping static-router-port 253

mld-snooping version· 253

overflow-replace (MLD-snooping view) 254

report-aggregation (MLD-snooping view) 255

reset ipv6 l2-multicast fast-forwarding cache· 255

reset mld-snooping group· 256

reset mld-snooping router-port 257

reset mld-snooping statistics· 258

router-aging-time (MLD-snooping view) 258

source-deny (MLD-snooping view) 259

version (MLD-snooping view) 260

IPv6 multicast routing and forwarding commands· 261

display ipv6 mrib interface· 262

display ipv6 multicast boundary· 263

display ipv6 multicast fast-forwarding cache· 264

display ipv6 multicast forwarding df-info· 266

display ipv6 multicast forwarding event 268

display ipv6 multicast forwarding-table· 269

display ipv6 multicast forwarding-table df-list 273

display ipv6 multicast routing-table· 274

display ipv6 multicast rpf-info· 276

ipv6 multicast boundary· 277

ipv6 multicast routing· 278

load-splitting (IPv6 MRIB view) 279

longest-match (IPv6 MRIB view) 279

reset ipv6 multicast fast-forwarding cache· 280

reset ipv6 multicast forwarding event 281

reset ipv6 multicast forwarding-table· 281

reset ipv6 multicast routing-table· 282

MLD commands· 284

display mld group· 284

display mld interface· 288

display mld proxy group· 290

display mld proxy routing-table· 292

display mld ssm-mapping· 294

last-listener-query-count (MLD view) 295

last-listener-query-interval (MLD view) 296

max-response-time (MLD view) 296

mld· 297

mld enable· 298

mld fast-leave· 298

mld group-policy· 299

mld last-listener-query-count 300

mld last-listener-query-interval 301

mld max-response-time· 301

mld non-stop-routing· 302

mld other-querier-present-timeout 303

mld proxy enable· 304

mld proxy forwarding· 305

mld query-interval 305

mld robust-count 306

mld startup-query-count 307

mld startup-query-interval 307

mld static-group· 308

mld version· 309

other-querier-present-timeout (MLD view) 309

proxy multipath (MLD view) 310

query-interval (MLD view) 311

reset mld group· 311

robust-count (MLD view) 312

ssm-mapping (MLD view) 313

startup-query-count (MLD view) 314

startup-query-interval (MLD view) 314

IPv6 PIM commands· 316

anycast rp (IPv6 PIM view) 316

bidir-pim enable (IPv6 PIM view) 317

bidir-rp-limit (IPv6 PIM view) 318

bsm-fragment enable (IPv6 PIM view) 319

bsm-reflection enable (IPv6 PIM view) 319

bsr-policy (IPv6 PIM view) 320

bsr-rp-mapping rfc2362 (IPv6 PIM view) 321

c-bsr (IPv6 PIM view) 321

c-rp (IPv6 PIM view) 322

crp-policy (IPv6 PIM view) 323

display ipv6 pim bsr-info· 324

display ipv6 pim claimed-route· 326

display ipv6 pim c-rp· 327

display ipv6 pim df-info· 328

display ipv6 pim interface· 329

display ipv6 pim nbma-link· 331

display ipv6 pim neighbor 332

display ipv6 pim routing-table· 334

display ipv6 pim rp-info· 338

display ipv6 pim statistics· 340

hello-option dr-priority (IPv6 PIM view) 342

hello-option holdtime (IPv6 PIM view) 342

hello-option lan-delay (IPv6 PIM view) 343

hello-option neighbor-tracking (IPv6 PIM view) 344

hello-option override-interval (IPv6 PIM view) 344

holdtime join-prune (IPv6 PIM view) 345

ipv6 pim·· 346

ipv6 pim bfd enable· 346

ipv6 pim bsr-boundary· 347

ipv6 pim dm·· 348

ipv6 pim hello-option dr-priority· 348

ipv6 pim hello-option holdtime· 349

ipv6 pim hello-option lan-delay· 350

ipv6 pim hello-option neighbor-tracking· 350

ipv6 pim hello-option override-interval 351

ipv6 pim holdtime join-prune· 352

ipv6 pim nbma-mode· 353

ipv6 pim neighbor-policy· 353

ipv6 pim non-stop-routing· 354

ipv6 pim passive· 355

ipv6 pim require-genid· 356

ipv6 pim sm·· 356

ipv6 pim state-refresh-capable· 357

ipv6 pim timer graft-retry· 357

ipv6 pim timer hello· 358

ipv6 pim timer join-prune· 359

ipv6 pim triggered-hello-delay· 359

jp-pkt-size (IPv6 PIM view) 360

register-policy (IPv6 PIM view) 360

register-suppression-timeout (IPv6 PIM view) 361

register-whole-checksum (IPv6 PIM view) 362

snmp-agent trap enable pim6· 362

source-lifetime (IPv6 PIM view) 363

source-policy (IPv6 PIM view) 363

spt-switch-threshold (IPv6 PIM view) 364

ssm-policy (IPv6 PIM view) 365

state-refresh-hoplimit (IPv6 PIM view) 366

state-refresh-interval (IPv6 PIM view) 367

state-refresh-rate-limit (IPv6 PIM view) 367

static-rp (IPv6 PIM view) 368

timer hello (IPv6 PIM view) 369

timer join-prune (IPv6 PIM view) 370

Index· 372

 


IGMP snooping commands

This feature is supported only on the following ports:

·          Layer 2 Ethernet ports on the following modules:

?  HMIM-8GSW.

?  HMIM-8GSWF.

?  HMIM-24GSW/24GSW-PoE.

?  SIC-4GSW/4GSWF/4GSW-PoE.

?  SIC-9FSW/9FSW-PoE.

·          Fixed Layer 2 Ethernet ports on the following routers:

?  MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK.

?  MSR2600-6-X1/2600-10-X1.

?  MSR3600-28/3600-51.

Commands and descriptions for centralized devices apply to the following routers:

·          MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK.

·          MSR2600-6-X1/2600-10-X1.

·          MSR 2630.

·          MSR3600-28/3600-51.

·          MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC.

·          MSR 3610/3620/3620-DP/3640/3660.

·          MSR810-LM-GL/810-W-LM-GL/830-6EI-GL/830-10EI-GL/830-6HI-GL/830-10HI-GL/2600-6-X1-GL.

Commands and descriptions for distributed devices apply to the following routers:

·          MSR5620.

·          MSR 5660.

·          MSR 5680.

display igmp-snooping

Use display igmp-snooping to display IGMP snooping status.

Syntax

display igmp-snooping [ global | vlan vlan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

global: Displays the global IGMP snooping status.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

Usage guidelines

If you do not specify any parameters, this command displays the global IGMP snooping status and the IGMP snooping status in all VLANs.

Examples

# Display the global IGMP snooping status and the IGMP snooping status for all VLANs.

<Sysname> display igmp-snooping

IGMP snooping information: Global

 IGMP snooping: Enabled

 Drop-unknown: Disabled

 Host-aging-time: 260s

 Router-aging-time: 260s

 Max-response-time: 10s

 Last-member-query-interval: 1s

 Report-aggregation: Enabled

 Dot1p-priority: --

 

IGMP snooping information: VLAN 1

 IGMP snooping: Enabled

 Drop-unknown: Disabled

 Version: 2

 Host-aging-time: 260s

 Router-aging-time: 260s

 Max-response-time: 10s

 Last-member-query-interval: 1s

 Querier: Disabled

 Query-interval: 125s

 General-query source IP: 1.1.1.1

 Special-query source IP: 2.2.2.2

 Report source IP: 3.0.0.3

 Leave source IP: 1.0.0.1

 Dot1p-priority: 2

 

IGMP snooping information: VLAN 10

 IGMP snooping: Enabled

 Drop-unknown: Enabled

 Version: 3

 Host-aging-time: 260s

 Router-aging-time: 260s

 Max-response-time: 10s

 Last-member-query-interval: 1s

 Querier: Disabled

 Query-interval: 125s

 General-query source IP: 1.1.1.1

 Special-query source IP: 2.2.2.2

 Report source IP: 3.0.0.3

 Leave source IP: 1.0.0.1

 Dot1p-priority: --

 

Table 1 Command output

Field

Description

IGMP snooping

IGMP snooping status:

·         Enabled.

·         Disabled.

Drop-unknown

Status of dropping unknown multicast data:

·         Enabled.

·         Disabled.

Version

IGMP snooping version.

Host-aging-time

Aging timer for the dynamic member port.

Router-aging-time

Aging timer for the dynamic router port.

Max-response-time

Maximum response time for IGMP general queries.

Last-member-query-interval

Interval for sending IGMP group-specific queries.

Report-aggregation

Status of IGMP report suppression:

·         Enabled.

·         Disabled.

Dot1p-priority

802.1p priority for IGMP messages. If the priority is not configured, this field displays two hyphens (--).

Querier

Status of IGMP snooping querier:

·         Enabled.

·         Disabled.

Query-interval

Interval for sending IGMP general queries.

General-query source IP

Source IP address of IGMP general queries.

Special-query source IP

Source IP address of IGMP group-specific queries.

Report source IP

Source IP address of IGMP reports.

Leave source IP

Source IP address of IGMP leave messages.

 

display igmp-snooping group

Use display igmp-snooping group to display dynamic IGMP snooping group entries.

Syntax

Centralized devices in standalone mode:

display igmp-snooping group [ group-address | source-address ] * [ vlan vlan-id ] [ verbose ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display igmp-snooping group [ group-address | source-address ] * [ vlan vlan-id ] [ verbose ] [ slot slot-number ]

Distributed devices in IRF mode:

display igmp-snooping group [ group-address | source-address ] * [ vlan vlan-id ] [ verbose ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255. If you do not specify a multicast group, this command displays dynamic IGMP snooping group entries for all multicast groups.

source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command displays dynamic IGMP snooping group entries for all multicast sources.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays dynamic IGMP snooping group entries for all VLANs.

verbose: Displays detailed information about dynamic IGMP snooping group entries. If you do not specify the keyword, this command displays brief information about dynamic IGMP snooping group entries.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays dynamic IGMP snooping group entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays dynamic IGMP snooping group entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays dynamic IGMP snooping group entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display detailed information about dynamic IGMP snooping group entries for VLAN 2.

<Sysname> display igmp-snooping group vlan 2 verbose

Total 1 entries.

 

VLAN 2: Total 1 entries.

  (0.0.0.0, 224.1.1.1)

    Attribute: local port

    FSM information: normal

    Host slots (0 in total):

    Host ports (1 in total):

      GE1/0/2                             (00:03:23)

Table 2 Command output

Field

Description

Total 1 entries

Total number of dynamic IGMP snooping group entries.

VLAN 2: Total 1 entries

Total number of dynamic IGMP snooping group entries in VLAN 2.

(0.0.0.0, 224.1.1.1)

(S, G) entry, where 0.0.0.0 in the S position means all multicast sources.

Attribute

Entry attribute:

·         global port—The entry has a global port.

·         local port—The entry has a port that resides on the specified card or the MPU when no card is specified.

·         slot—The entry has a port that resides on a card other than the specified card or the MPU when no card is specified.

FSM information

Finite state machine information of the entry:

·         delete—The entry attributes have been deleted.

·         dummy—The entry is a new temporary entry.

·         no info—No entry exists.

·         normal—The entry is a correct entry.

Host slots (0 in total)

This field is not supported. (Centralized devices in standalone mode.)

Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.)

Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.)

Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)

Host ports (1 in total)

Member ports, and the total number of member ports.

(00:03:23)

Remaining aging time for the dynamic member port.

For a global port, this field is always displayed.

(Centralized devices in standalone mode.) For a global port, this field is always displayed.

(Distributed devices in standalone mode.) For a global port, this field is displayed when one of the following conditions exists:

·         The port is on the specified card.

·         The port is on the MPU and no card is specified.

(Centralized devices in IRF mode.) For a global port, this field is displayed when one of the following conditions exists:

·         The port is on the specified member device.

·         The port is on the master device and no member device is specified.

(Distributed devices in IRF mode.) For a global port, this field is displayed when one of the following conditions exists:

·         The port is on the specified card.

·         The port is on the global active MPU and no card is specified.

 

Related commands

reset igmp-snooping group

display igmp-snooping router-port

Use display igmp-snooping router-port to display dynamic router port information.

Syntax

Centralized devices in standalone mode:

display igmp-snooping router-port [ verbose | vlan vlan-id [ verbose ] ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display igmp-snooping router-port [ verbose | vlan vlan-id [ verbose ] ] [ slot slot-number ]

Distributed devices in IRF mode:

display igmp-snooping router-port [ verbose | vlan vlan-id [ verbose ] ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

verbose: Displays detailed information. If you do not specify the keyword, this command displays brief information.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays dynamic router port information for all VLANs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays dynamic router port information for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays dynamic router port information for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays dynamic router port information for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display dynamic router port information for VLAN 2.

<Sysname> display igmp-snooping router-port vlan 2

VLAN 2:

  Router slots (0 in total):

  Router ports (2 in total):

    GE1/0/1                              (00:01:30)

    GE1/0/2                              (00:00:23)

Table 3 Command output

Field

Description

VLAN 2

VLAN ID.

Router slots (0 in total)

This field is not supported. (Centralized devices in standalone mode.)

Slot numbers and total number of the cards that have dynamic router ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.)

Member IDs and total number of the member devices that have dynamic router ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.)

Chassis numbers, slot numbers, and total number of the cards that have dynamic router ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)

Router ports (2 in total)

Dynamic router ports, and the total number of dynamic router ports.

(00:01:30)

Remaining aging time for the dynamic router port.

For a global port, this field is always displayed.

(Centralized devices in standalone mode.) For a global port, this field is always displayed.

(Distributed devices in standalone mode.) For a global port, this field is displayed when one of the following conditions exists:

·         The port is on the specified card.

·         The port is on the MPU and no card is specified.

(Centralized devices in IRF mode.) For a global port, this field is displayed when one of the following conditions exists:

·         The port is on the specified member device.

·         The port is on the master device and no member device is specified.

(Distributed devices in IRF mode.) For a global port, this field is displayed when one of the following conditions exists:

·         The port is on the specified card.

·         The port is on the global active MPU and no card is specified.

 

Related commands

reset igmp-snooping router-port

display igmp-snooping static-group

Use display igmp-snooping static-group to display static IGMP snooping group entries.

Syntax

Centralized devices in standalone mode:

display igmp-snooping static-group [ group-address | source-address ] * [ vlan vlan-id ] [ verbose ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display igmp-snooping static-group [ group-address | source-address ] * [ vlan vlan-id ] [ verbose ] [ slot slot-number ]

Distributed devices in IRF mode:

display igmp-snooping static-group [ group-address | source-address ] * [ vlan vlan-id ] [ verbose ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255. If you do not specify a multicast group, this command displays static IGMP snooping group entries for all multicast groups.

source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command displays static IGMP snooping group entries for all multicast sources.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays static IGMP snooping group entries for all VLANs.

verbose: Displays detailed information about static IGMP snooping group entries. If you do not specify the keyword, this command displays brief information about static IGMP snooping group entries.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays static IGMP snooping group entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays static IGMP snooping group entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays static IGMP snooping group entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display detailed information about static IGMP snooping group entries for VLAN 2.

<Sysname> display igmp-snooping static-group vlan 2 verbose

Total 1 entries.

 

VLAN 2: Total 1 entries.

  (0.0.0.0, 224.1.1.1)

    Attribute: local port

    FSM information: normal

    Host slots (0 in total):

    Host ports (1 in total):

      GE1/0/2

Table 4 Command output

Field

Description

Total 1 entries

Total number of static IGMP snooping group entries.

VLAN 2: Total 1 entries

Total number of static IGMP snooping group entries in VLAN 2.

(0.0.0.0, 224.1.1.1)

(S, G) entry, where 0.0.0.0 in the S position means all multicast sources.

Attribute

Entry attribute:

·         global port—The entry has a global port.

·         local port—The entry has a port that resides on the specified card or on the MPU when no card is specified.

·         slot—The entry has a port that resides on a card other than the specified card or the MPU when no card is specified.

FSM information

Finite state machine information of the entry:

·         delete—The entry attributes have been deleted.

·         dummy—The entry is a new temporary entry.

·         no info—No entry exists.

·         normal—The entry is a correct entry.

Host slots (0 in total)

This field is not supported. (Centralized devices in standalone mode.)

Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.)

Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.)

Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)

Host ports (1 in total)

Member ports, and the total number of member ports.

 

display igmp-snooping static-router-port

Use display igmp-snooping static-router-port to display static router port information.

Syntax

Centralized devices in standalone mode:

display igmp-snooping static-router-port [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display igmp-snooping static-router-port [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display igmp-snooping static-router-port [ vlan vlan-id ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays static router port information for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays static router port information for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays static router port information for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display static router port information for VLAN 2.

<Sysname> display igmp-snooping static-router-port vlan 2

VLAN 2:

  Router slots (0 in total):

  Router ports (2 in total):

    GE1/0/1

    GE1/0/2

Table 5 Command output

Field

Description

VLAN 2

VLAN ID.

Router slots (0 in total)

This field is not supported. (Centralized devices in standalone mode.)

Slot numbers and total number of the cards that have static router ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.)

Member IDs and total number of the member devices that have static router ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.)

Chassis numbers, slot numbers, and total number of the cards that have static router ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)

Router ports (2 in total)

Static router ports, and the total number of static router ports.

 

display igmp-snooping statistics

Use display igmp-snooping statistics to display statistics for the IGMP messages and PIMv2 hello messages learned through IGMP snooping.

Syntax

display igmp-snooping statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display statistics for the IGMP messages and PIMv2 hello messages learned through IGMP snooping.

<Sysname> display igmp-snooping statistics

Received IGMP general queries:  0

Received IGMPv1 reports:  0

Received IGMPv2 reports:  19

Received IGMP leaves:  0

Received IGMPv2 specific queries:  0

Sent     IGMPv2 specific queries:  0

Received IGMPv3 reports:  1

Received IGMPv3 reports with right and wrong records:  0

Received IGMPv3 specific queries:  0

Received IGMPv3 specific sg queries:  0

Sent     IGMPv3 specific queries:  0

Sent     IGMPv3 specific sg queries:  0

Received PIMv2 hello:  0

Received error IGMP messages:  19

Table 6 Command output

Field

Description

general queries

Number of IGMP general queries.

specific queries

Number of IGMP group-specific queries.

reports

Number of IGMP reports.

leaves

Number of IGMP leave messages.

reports with right and wrong records

Number of IGMP reports with correct and incorrect records.

specific sg queries

Number of IGMP group-and-source-specific queries.

PIMv2 hello

Number of PIMv2 hello messages.

error IGMP messages

Number of IGMP messages with errors.

 

Related commands

reset igmp-snooping statistics

display l2-multicast fast-forwarding cache

Use display l2-multicast fast-forwarding cache to display Layer 2 multicast fast forwarding entries.

Syntax

Centralized devices in standalone mode:

display l2-multicast fast-forwarding cache [ vlan vlan-id ] [ source-address | group-address ] *

Distributed devices in standalone mode/centralized devices in IRF mode:

display l2-multicast fast-forwarding cache [ vlan vlan-id ] [ source-address | group-address ] * [ slot slot-number ]

Distributed devices in IRF mode:

display l2-multicast fast-forwarding cache [ vlan vlan-id ] [ source-address | group-address ] * [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

source-address: Specifies a multicast source address. If you do not specify a multicast source, this command displays Layer 2 multicast fast forwarding entries for all multicast sources.

group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255. If you do not specify a multicast group, this command displays Layer 2 multicast fast forwarding entries for all multicast groups.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays Layer 2 multicast fast forwarding entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays Layer 2 multicast fast forwarding entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays Layer 2 multicast fast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display Layer 2 multicast fast forwarding entries.

<Sysname> display l2-multicast fast-forwarding cache

Total 1 entries, 1 matched

 

(10.1.1.2,225.1.1.1)

     Status      : Enable                VLAN            : 1

     Source port : 9876                  Destination port: 5432

     Protocol    : 17                    Flag            : 0x2

     Ingress port: GigabitEthernet1/0/2

     List of 1 egress ports:

         GigabitEthernet1/0/3

         Status: Enable                Flag: 0x10

Table 7 Command output

Field

Description

Total 1 entries, 1 matched

Total number of (S, G) entries in the Layer 2 multicast fast forwarding table, and the total number of matching entries.

(10.1.1.2, 225.1.1.1)

(S, G) entry in the Layer 2 multicast fast forwarding table.

Protocol

Protocol number.

VLAN

VLAN ID.

Flag

Flag for the (S, G) entry or the outgoing port.

This field displays one flag or the sum of multiple flags. In this example, the value 0x2 means that the entry has only one flag 0x2.

The following flags are available for an entry:

·         0x1—The entry is created because of packets passed through between cards.

·         0x2—The entry is added by multicast forwarding.

The following flags are available for an outgoing interface:

·         0x1—The port is added to the entry because of packets passed through between cards.

·         0x2—The port is added to an existing entry.

·         0x10—The port is associated with the entry.

·         0x20—The port is to be deleted.

Status

Status of the (S, G) entry or the outgoing port:

·         Enabled—Available.

·         Disabled—Unavailable.

Ingress port

Incoming port of the (S, G) entry.

List of 1 egress ports

Outgoing port list of the (S, G) entry.

 

Related commands

reset l2-multicast fast-forwarding cache all

display l2-multicast ip

Use display l2-multicast ip to display information about Layer 2 IP multicast groups.

Syntax

Centralized devices in standalone mode:

display l2-multicast ip [ group group-address | source source-address ] * [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display l2-multicast ip [ group group-address | source source-address ] * [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display l2-multicast ip [ group group-address | source source-address ] * [ vlan vlan-id ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

group group-address: Specifies a multicast group by its IP address. If you do not specify a multicast group, this command displays information about all Layer 2 IP multicast groups.

source source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command displays information about Layer 2 IP multicast groups for all multicast sources.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays information about Layer 2 IP multicast groups for all VLANs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information about Layer 2 IP multicast groups for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays information about Layer 2 IP multicast groups for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays information about Layer 2 IP multicast groups for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display information about Layer 2 IP multicast groups for VLAN 2.

<Sysname> display l2-multicast ip vlan 2

Total 1 entries.

 

VLAN 2: Total 1 IP entries.

  (0.0.0.0, 224.1.1.1)

    Attribute: static, success

    Host slots (0 in total):

    Host ports (1 in total):

      GE1/0/1                              (S, SUC)

Table 8 Command output

Field

Description

Total 1 entries

Total number of Layer 2 IP multicast groups.

VLAN 2: Total 1 IP entries

Total number of Layer 2 IP multicast groups in VLAN 2.

(0.0.0.0, 224.1.1.1)

(S, G) entry, where 0.0.0.0 in the S position means all multicast sources.

Attribute

Entry attribute:

·         dynamic—The entry is created by a dynamic protocol.

·         static—The entry is created by a static protocol.

·         pim—The entry is created by PIM.

·         kernel—The entry is obtained from the kernel.

·         success—Processing succeeds.

·         fail—Processing fails.

Host slots (0 in total)

This field is not supported. (Centralized devices in standalone mode.)

Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.)

Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.)

Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)

Host ports (1 in total)

Member ports, and the total number of member ports.

(S, SUC)

Port attribute:

·         D—Dynamic port.

·         S—Static port.

·         P—PIM port.

·         K—Port obtained from the kernel.

·         R—Port learned from (*, *) entries.

·         W—Port learned from (*, G) entries.

·         SUC—Processing succeeds.

·         F—Processing fails.

·         BC—Broadcast port. The TRILL port floods multicast data after the topology changes.

 

display l2-multicast ip forwarding

Use display l2-multicast ip forwarding to display Layer 2 multicast IP forwarding entries.

Syntax

Centralized devices in standalone mode:

display l2-multicast ip forwarding [ group group-address | source source-address ] * [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display l2-multicast ip forwarding [ group group-address | source source-address ] * [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display l2-multicast ip forwarding [ group group-address | source source-address ] * [ vlan vlan-id ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

group group-address: Specifies a multicast group by its IP address. If you do not specify a multicast group, this command displays Layer 2 multicast IP forwarding entries for all multicast groups.

source source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command displays Layer 2 multicast IP forwarding entries for all multicast sources.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays Layer 2 multicast IP forwarding entries for all VLANs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays Layer 2 multicast IP forwarding entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays Layer 2 multicast IP forwarding entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays Layer 2 multicast IP forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display Layer 2 multicast IP forwarding entries for VLAN 2.

<Sysname> display l2-multicast ip forwarding vlan 2

Total 1 entries.

 

VLAN 2: Total 1 IP entries.

  (0.0.0.0, 224.1.1.1)

    Host slots (0 in total):

    Host ports (3 in total):

      GigabitEthernet1/0/1

      GigabitEthernet1/0/2

      GigabitEthernet1/0/3

Table 9 Command output

Field

Description

Total 1 entries

Total number of Layer 2 multicast IP forwarding entries.

VLAN 2: Total 1 IP entries

Total number of Layer 2 multicast IP forwarding entries in VLAN 2.

(0.0.0.0, 224.1.1.1)

(S, G) entry, where 0.0.0.0 in the S position means all multicast sources.

Host slots (0 in total)

This field is not supported. (Centralized devices in standalone mode.)

Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.)

Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.)

Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)

Host ports (3 in total)

Member ports, and the total number of member ports.

 

display l2-multicast mac

Use display l2-multicast mac to display information about Layer 2 MAC multicast groups.

Syntax

Centralized devices in standalone mode:

display l2-multicast mac [ mac-address ] [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display l2-multicast mac [ mac-address ] [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display l2-multicast mac [ mac-address ] [ vlan vlan-id ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

mac-address: Specifies a MAC multicast group by its multicast MAC address. If you do not specify a MAC multicast group, this command displays information about all Layer 2 MAC multicast groups.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays information about Layer 2 MAC multicast groups for all VLANs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information about Layer 2 MAC multicast groups for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays information about Layer 2 MAC multicast groups for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays information about Layer 2 MAC multicast groups for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display information about Layer 2 MAC multicast groups for VLAN 2.

<Sysname> display l2-multicast mac vlan 2

Total 1 MAC entries.

 

VLAN 2: Total 1 MAC entries.

  MAC group address: 0100-5e01-0101

    Attribute: success

    Host slots (0 in total):

    Host ports (1 in total):

      GE1/0/1

Table 10 Command output

Field

Description

Total 1 MAC entries

Total number of Layer 2 MAC multicast groups.

VLAN 2: Total 1 MAC entries

Total number of Layer 2 MAC multicast groups in VLAN 2.

MAC group address

Address of the MAC multicast group.

Attribute

Entry attribute:

·         success—Processing succeeds.

·         fail—Processing fails.

Host slots (0 in total)

This field is not supported. (Centralized devices in standalone mode.)

Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.)

Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.)

Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)

Host ports (1 in total)

Member ports, and the total number of member ports.

 

display l2-multicast mac forwarding

Use display l2-multicast mac forwarding to display Layer 2 multicast MAC forwarding entries.

Syntax

Centralized devices in standalone mode:

display l2-multicast mac forwarding [ mac-address ] [ vlan vlan-id ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display l2-multicast mac forwarding [ mac-address ] [ vlan vlan-id ] [ slot slot-number ]

Distributed devices in IRF mode:

display l2-multicast mac forwarding [ mac-address ] [ vlan vlan-id ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

mac-address: Specifies a MAC multicast group by its MAC address. If you do not specify a MAC multicast group, this command displays Layer 2 multicast MAC forwarding entries for all MAC multicast groups.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays Layer 2 multicast MAC forwarding entries for all VLANs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays Layer 2 multicast MAC forwarding entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays Layer 2 multicast MAC group entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays Layer 2 multicast MAC group entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display Layer 2 multicast MAC forwarding entries for VLAN 2.

<Sysname> display l2-multicast mac forwarding vlan 2

Total 1 MAC entries.

 

VLAN 2: Total 1 MAC entries.

  MAC group address: 0100-5e01-0101

    Host slots (0 in total):

    Host ports (3 in total):

      GigabitEthernet1/0/1

      GigabitEthernet1/0/2

      GigabitEthernet1/0/3

Table 11 Command output

Field

Description

Total 1 MAC entries

Total number of Layer 2 multicast MAC forwarding entries.

VLAN 2: Total 1 MAC entries

Total number of Layer 2 multicast MAC forwarding entries in VLAN 2.

MAC group address

Address of the MAC multicast group.

Host slots (0 in total)

This field is not supported. (Centralized devices in standalone mode.)

Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (Distributed devices in standalone mode.)

Member IDs and total number of the member devices that have member ports, except for the specified member device or the master device when no member device is specified. (Centralized devices in IRF mode.)

Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified. (Distributed devices in IRF mode.)

Host ports (3 in total)

Member ports, and the total number of member ports.

 

dot1p-priority (IGMP-snooping view)

Use dot1p-priority to set the 802.1p priority for IGMP messages globally.

Use undo dot1p-priority to restore the default.

Syntax

dot1p-priority priority

undo dot1p-priority

Default

The 802.1p priority for IGMP messages is not set.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

priority: Specifies an 802.1p priority for IGMP messages, in the range of 0 to 7. The greater the value, the higher the priority.

Usage guidelines

You can set the 802.1p priority globally for all VLANs in IGMP-snooping view or for a VLAN in VLAN view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration.

Examples

# Set the 802.1p priority for IGMP messages to 3 globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] dot1p-priority 3

Related commands

igmp-snooping dot1p-priority

enable (IGMP-snooping view)

Use enable to enable IGMP snooping for VLANs.

Use undo enable to disable IGMP snooping for VLANs.

Syntax

enable vlan vlan-list

undo enable vlan vlan-list

Default

IGMP snooping is disabled for a VLAN.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN ID is in the range of 1 to 4094.

Usage guidelines

You must enable IGMP snooping globally before you enable IGMP snooping for VLANs.

You can enable IGMP snooping for the specified VLANs in IGMP-snooping view or for a VLAN in VLAN view. For a VLAN, the configuration in IGMP-snooping view has the same priority as the configuration in VLAN view, and the most recent configuration takes effect.

Examples

# Enable IGMP snooping globally, and enable IGMP snooping for VLAN 2 through VLAN 10.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] enable vlan 2 to 10

Related commands

igmp-snooping

igmp-snooping enable

entry-limit (IGMP-snooping view)

Use entry-limit to globally set the maximum number of IGMP snooping forwarding entries, including dynamic entries and static entries.

Use undo entry-limit to restore the default.

Syntax

entry-limit limit

undo entry-limit

Default

The maximum number of IGMP snooping forwarding entries is 4294967295.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

limit: Specifies the maximum number of IGMP snooping forwarding entries, in the range of 0 to 4294967295.

Examples

# Set the global maximum number of IGMP snooping forwarding entries to 512.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] entry-limit 512

fast-leave (IGMP-snooping view)

Use fast-leave to enable fast-leave processing globally.

Use undo fast-leave to disable fast-leave processing globally.

Syntax

fast-leave [ vlan vlan-list ]

undo fast-leave [ vlan vlan-list ]

Default

Fast-leave processing is disabled.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.

Usage guidelines

The fast-leave processing feature enables the device to immediately remove a port from the forwarding entry for a multicast group when the port receives a leave message.

You can enable fast-leave processing globally for all ports in IGMP-snooping view or for a port in interface view. For a port, the port-specific configuration takes priority over the global configuration.

Examples

# Globally enable fast-leave processing for VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] fast-leave vlan 2

Related commands

igmp-snooping fast-leave

group-policy (IGMP-snooping view)

Use group-policy to globally configure a multicast group policy to control the multicast groups that hosts can join.

Use undo group-policy to globally delete multicast group policies.

Syntax

group-policy ipv4-acl-number [ vlan vlan-list ]

undo group-policy [ vlan vlan-list ]

Default

Multicast group policies are not configured, and hosts can join any multicast groups.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

ipv4-acl-number: Specifies an IPv4 basic or advanced ACL by its number in the range of 2000 to 3999. Hosts can join only the multicast groups that the ACL permits. If the ACL does not exist or does not have valid rules, hosts cannot join multicast groups.

vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.

Usage guidelines

This command takes effect only on the multicast groups that a port joins dynamically.

You can configure a multicast group policy globally for all ports in IGMP-snooping view or for a port in interface view. For a port, the port-specific configuration takes priority over the global configuration.

When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:

·          For the rule to take effect, do not specify the vpn-instance vpn-instance option.

·          In a basic ACL, the source source-address source-wildcard option specifies a multicast group address.

·          In an advanced ACL, the source source-address source-wildcard option specifies a multicast source address. The destination dest-address dest-wildcard option specifies a multicast group address.

To match the following IGMP reports, set the source source-address source-wildcard option to 0.0.0.0:

?  IGMPv1 and IGMPv2 reports.

?  IGMPv3 IS_EX and IGMPv3 TO_EX reports that do not carry multicast source addresses.

·          Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

You can configure different ACLs for all ports in different VLANs. If you configure multiple ACLs for all ports in the same VLAN, the most recent configuration takes effect.

Examples

# Configure a multicast group policy for VLAN 2 so that hosts in VLAN 2 can join only multicast group 225.1.1.1.

<Sysname> system-view

[Sysname] acl basic 2000

[Sysname-acl-ipv4-basic-2000] rule permit source 225.1.1.1 0

[Sysname-acl-ipv4-basic-2000] quit

[Sysname] igmp-snooping

[Sysname-igmp-snooping] group-policy 2000 vlan 2

Related commands

igmp-snooping group-policy

host-aging-time (IGMP-snooping view)

Use host-aging-time to set the aging timer for dynamic member ports globally.

Use undo host-aging-time to restore the default.

Syntax

host-aging-time seconds

undo host-aging-time

Default

The aging timer for dynamic member ports is 260 seconds.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

seconds: Specifies an aging timer for dynamic member ports, in the range of 1 to 8097894 seconds.

Usage guidelines

You can set the timer globally for all VLANs in IGMP-snooping view or for a VLAN in VLAN view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration.

To avoid mistakenly deleting multicast group members, set the aging timer for dynamic member ports to be greater than the value calculated by using the following formula:

[ IGMP general query interval ] + [ maximum response time for IGMP general queries ]

As a best practice, set the aging timer of dynamic member ports to the value calculated by using the following formula:

[ IGMP general query interval ] × 2 + [ maximum response time for IGMP general queries ]

Examples

# Set the global aging timer for dynamic member ports to 300 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] host-aging-time 300

Related commands

igmp-snooping host-aging-time

igmp-snooping

Use igmp-snooping to enable IGMP snooping globally and enter IGMP-snooping view.

Use undo igmp-snooping to disable IGMP snooping globally.

Syntax

igmp-snooping

undo igmp-snooping

Default

IGMP snooping is disabled globally.

Views

System view

Predefined user roles

network-admin

Examples

# Enable IGMP snooping globally, and enter IGMP-snooping view.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping]

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping dot1p-priority

Use igmp-snooping dot1p-priority to set the 802.1p priority for IGMP messages in a VLAN.

Use undo igmp-snooping dot1p-priority to restore the default.

Syntax

igmp-snooping dot1p-priority priority

undo igmp-snooping dot1p-priority

Default

The 802.1p priority for IGMP messages is not set.

Views

VLAN view

Predefined user roles

network-admin

Parameters

priority: Specifies an 802.1p priority for IGMP messages, in the range of 0 to 7. The greater the value, the higher the priority.

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

You can set the 802.1p priority for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration.

Examples

# In VLAN 2, enable IGMP snooping, and set the 802.1p priority for IGMP messages to 3.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping dot1p-priority 3

Related commands

dot1p-priority (IGMP-snooping view)

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping drop-unknown

Use igmp-snooping drop-unknown to enable dropping unknown multicast data packets for a VLAN.

Use undo igmp-snooping drop-unknown to disable dropping unknown multicast data packets for a VLAN.

Syntax

igmp-snooping drop-unknown

undo igmp-snooping drop-unknown

Default

Dropping unknown multicast data packets is disabled for a VLAN, and unknown multicast data packets are flooded in the VLAN.

Views

VLAN view

Predefined user roles

network-admin

Usage guidelines

This feature is supported on the following ports:

·          Layer 2 Ethernet ports on the following modules:

?  HMIM-8GSW.

?  HMIM-8GSWF.

?  HMIM-24GSW/24GSW-PoE.

?  SIC-4GSW/4GSWF/4GSW-PoE.

·          Fixed Layer 2 Ethernet ports on the following routers:

?  MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK.

?  MSR2600-6-X1/2600-10-X1.

?  MSR3600-28/3600-51.

You must enable IGMP snooping for a VLAN before you execute this command.

Examples

# In VLAN 2, enable IGMP snooping, and enable dropping unknown multicast data packets.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping drop-unknown

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping enable

Use igmp-snooping enable to enable IGMP snooping for a VLAN.

Use undo igmp-snooping enable to disable IGMP snooping for a VLAN.

Syntax

igmp-snooping enable

undo igmp-snooping enable

Default

IGMP snooping is disabled for a VLAN.

Views

VLAN view

Predefined user roles

network-admin

Usage guidelines

You must enable IGMP snooping globally before you execute this command.

You can enable IGMP snooping for a VLAN in VLAN view or for the specified VLANs in IGMP-snooping view. For a VLAN, the configuration in VLAN view has the same priority as the configuration in IGMP-snooping view, and the most recent configuration takes effect.

Examples

# Enable IGMP snooping globally, and enable IGMP snooping for VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

Related commands

enable (IGMP-snooping view)

igmp-snooping

igmp-snooping fast-leave

Use igmp-snooping fast-leave to enable fast-leave processing on a port.

Use undo igmp-snooping fast-leave to disable fast-leave processing on a port.

Syntax

igmp-snooping fast-leave [ vlan vlan-list ]

undo igmp-snooping fast-leave [ vlan vlan-list ]

Default

Fast-leave processing is disabled on a port.

Views

Layer 2 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.

Usage guidelines

The fast-leave processing feature enables the device to immediately remove a port from the forwarding entry for a multicast group when the port receives a leave message.

You can enable fast-leave processing for a port in interface view or globally for all ports in IGMP-snooping view. For a port, the port-specific configuration takes priority over the global configuration.

Examples

# Enable fast-leave processing for VLAN 2 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping fast-leave vlan 2

Related commands

fast-leave (IGMP-snooping view)

igmp-snooping general-query source-ip

Use igmp-snooping general-query source-ip to configure the source IP address for IGMP general queries.

Use undo igmp-snooping general-query source-ip to restore the default.

Syntax

igmp-snooping general-query source-ip ip-address

undo igmp-snooping general-query source-ip

Default

In a VLAN, the source IP address of IGMP general queries is the IP address of the current VLAN interface. If the current VLAN interface does not have an IP address, the source IP address is 0.0.0.0.

Views

VLAN view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for IGMP general queries.

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

Examples

# In VLAN 2, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP general queries.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping general-query source-ip 10.1.1.1

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping group-limit

Use igmp-snooping group-limit to set the maximum number of multicast groups that a port can join.

Use undo igmp-snooping group-limit to remove the limit on the maximum number of multicast groups that a port can join.

Syntax

igmp-snooping group-limit limit [ vlan vlan-list ]

undo igmp-snooping group-limit [ vlan vlan-list ]

Default

No limit is placed on the maximum number of multicast groups that a port can join.

Views

Layer 2 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

limit: Specifies the maximum number of multicast groups that a port can join, in the range of 0 to 4294967295.

vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.

Usage guidelines

This command takes effect only on the multicast groups that a port joins dynamically.

Examples

# On GigabitEthernet 1/0/1, set the maximum number of multicast groups the port can join in VLAN 2 to 10.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping group-limit 10 vlan 2

igmp-snooping group-policy

Use igmp-snooping group-policy to configure a multicast group policy on a port to control the multicast groups that hosts attached to the port can join.

Use undo igmp-snooping group-policy to delete multicast group policies on a port.

Syntax

igmp-snooping group-policy ipv4-acl-number [ vlan vlan-list ]

undo igmp-snooping group-policy [ vlan vlan-list ]

Default

No multicast group polices are configured on a port, and hosts attached to the port can join any multicast groups.

Views

Layer 2 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

ipv4-acl-number: Specifies an IPv4 basic or advanced ACL by its number in the range of 2000 to 3999. Hosts can join only the multicast groups that the ACL permits. If the ACL does not exist or does not have valid rules, hosts cannot join multicast groups.

vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.

Usage guidelines

This command takes effect only on the multicast groups that a port joins dynamically.

You can configure a multicast group policy for a port in interface view or globally for all ports in IGMP-snooping view. For a port, the port-specific configuration takes priority over the global configuration.

When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:

·          For the rule to take effect, do not specify the vpn-instance vpn-instance option.

·          In a basic ACL, the source source-address source-wildcard option specifies a multicast group address.

·          In an advanced ACL, the source source-address source-wildcard option specifies a multicast source address. The destination dest-address dest-wildcard option specifies a multicast group address.

To match the following IGMP reports, set the source source-address source-wildcard option to 0.0.0.0:

?  IGMPv1 and IGMPv2 reports.

?  IGMPv3 IS_EX and IGMPv3 TO_EX reports that do not carry multicast source addresses.

·          Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

You can configure different ACLs on a port in different VLANs. If you configure multiple ACLs on a port in the same VLAN, the most recent configuration takes effect.

Examples

# On GigabitEthernet 1/0/1, configure a multicast group policy for VLAN 2 so that hosts in VLAN 2 can join only multicast group 225.1.1.1.

<Sysname> system-view

[Sysname] acl basic 2000

[Sysname-acl-ipv4-basic-2000] rule permit source 225.1.1.1 0

[Sysname-acl-ipv4-basic-2000] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping group-policy 2000 vlan 2

Related commands

group-policy (IGMP-snooping view)

igmp-snooping host-aging-time

Use igmp-snooping host-aging-time to set the aging timer for dynamic member ports in a VLAN.

Use undo igmp-snooping host-aging-time to restore the default.

Syntax

igmp-snooping host-aging-time seconds

undo igmp-snooping host-aging-time

Default

The aging timer for dynamic member ports is 260 seconds.

Views

VLAN view

Predefined user roles

network-admin

Parameters

seconds: Specifies an aging timer for dynamic member ports, in the range of 1 to 8097894 seconds.

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

You can set the timer for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration.

To avoid mistakenly deleting multicast group members, set the aging timer for dynamic member ports to be greater than the value calculated by using the following formula:

[ IGMP general query interval ] + [ maximum response time for IGMP general queries ]

As a best practice, set the aging timer of dynamic member ports to the value calculated by using the following formula:

[ IGMP general query interval ] × 2 + [ maximum response time for IGMP general queries ]

Examples

# In VLAN 2, enable IGMP snooping, and set the aging timer for dynamic member ports to 300 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping host-aging-time 300

Related commands

enable (IGMP-snooping view)

host-aging-time (IGMP-snooping view)

igmp-snooping enable

igmp-snooping host-join

Use igmp-snooping host-join to configure a port as a simulated member host for a multicast group.

Use undo igmp-snooping host-join to remove the configuration of a simulated member host for a multicast group.

Syntax

igmp-snooping host-join group-address [ source-ip source-address ] vlan vlan-id

undo igmp-snooping host-join { group-address [ source-ip source-address ] vlan vlan-id | all }

Default

A port is not configured as a simulated member host for multicast groups.

Views

Layer 2 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

group-address: Specifies a multicast group in the range of 224.0.1.0 to 239.255.255.255.

source-ip source-address: Specifies a multicast source by its IP address. If you specify a multicast source, this command configures the port as a simulated member host for a multicast source and group. If you do not specify a multicast source, this command configures the port as a simulated member host for a multicast group. This option takes effect on IGMPv3 snooping devices.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

all: Specifies all multicast groups.

Usage guidelines

A port configured as a simulated member host ages out in the same way as a dynamic member port.

Make sure the simulated member host runs the same version of IGMP and IGMP snooping.

Examples

# Configure GigabitEthernet 1/0/1 as a simulated member host of multicast source and group (1.1.1.1, 232.1.1.1) in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

[Sysname-vlan2] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping host-join 232.1.1.1 source-ip 1.1.1.1 vlan 2

igmp-snooping last-member-query-interval

Use igmp-snooping last-member-query-interval to set the IGMP last member query interval for a VLAN.

Use undo igmp-snooping last-member-query-interval to restore the default.

Syntax

igmp-snooping last-member-query-interval interval

undo igmp-snooping last-member-query-interval

Default

The IGMP last member query interval is 1 second.

Views

VLAN view

Predefined user roles

network-admin

Parameters

interval: Specifies an IGMP last member query interval in the range of 1 to 25 seconds.

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

You can set the interval for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration.

Examples

# In VLAN 2, enable IGMP snooping, and set the IGMP last member query interval to 3 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping last-member-query-interval 3

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

last-member-query-interval (IGMP-snooping view)

igmp-snooping leave source-ip

Use igmp-snooping leave source-ip to configure the source IP address for IGMP leave messages.

Use undo igmp-snooping leave source-ip to restore the default.

Syntax

igmp-snooping leave source-ip ip-address

undo igmp-snooping leave source-ip

Default

The source IP address of IGMP leave messages is the IP address of the current VLAN interface. If the current VLAN interface does not have an IP address, the source IP address is 0.0.0.0.

Views

VLAN view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for IGMP leave messages.

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

Examples

# In VLAN 2, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP leave messages.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping leave source-ip 10.1.1.1

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping max-response-time

Use igmp-snooping max-response-time to set the maximum response time for IGMP general queries in a VLAN.

Use undo igmp-snooping max-response-time to restore the default.

Syntax

igmp-snooping max-response-time seconds

undo igmp-snooping max-response-time

Default

The maximum response time for IGMP general queries is 10 seconds in a VLAN.

Views

VLAN view

Predefined user roles

network-admin

Parameters

seconds: Specifies the maximum response time for IGMP general queries, in the range of 1 to 3174 seconds.

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

You can set the time for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration.

To avoid mistakenly deleting multicast group members, set the maximum response time for IGMP general queries to be less than the IGMP general query interval.

Examples

# In VLAN 2, enable IGMP snooping, and set the maximum response time for IGMP general queries to 5 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping max-response-time 5

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping query-interval

max-response-time (IGMP-snooping view)

igmp-snooping overflow-replace

Use igmp-snooping overflow-replace to enable the multicast group replacement feature on a port.

Use undo igmp-snooping overflow-replace to disable the multicast group replacement feature on a port.

Syntax

igmp-snooping overflow-replace [ vlan vlan-list ]

undo igmp-snooping overflow-replace [ vlan vlan-list ]

Default

The multicast group replacement feature is disabled.

Views

Layer 2 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.

Usage guidelines

This command takes effect only on the multicast groups that a port joins dynamically.

You can enable the multicast group replacement feature for a port in interface view or globally for all ports in IGMP-snooping view. For a port, the port-specific configuration takes priority over the global configuration.

This feature does not take effect if the following conditions exist:

·          The number of the IGMP snooping forwarding entries on the device reaches or exceeds the upper limit.

·          The multicast group that the port newly joins is not included in the multicast group list maintained by the device.

Examples

# On GigabitEthernet 1/0/1, enable the multicast group replacement feature for VLAN 2.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping overflow-replace vlan 2

Related commands

overflow-replace (IGMP-snooping view)

igmp-snooping querier

Use igmp-snooping querier to enable the IGMP snooping querier.

Use undo igmp-snooping querier to disable the IGMP snooping querier.

Syntax

igmp-snooping querier

undo igmp-snooping querier

Default

The IGMP snooping querier is disabled.

Views

VLAN view

Predefined user roles

network-admin

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

For a sub-VLAN of a multicast VLAN, this command takes effect only after you remove the sub-VLAN from the multicast VLAN.

Examples

# In VLAN 2, enable IGMP snooping, and enable the IGMP snooping querier.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping querier

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

subvlan (multicast VLAN view)

igmp-snooping query-interval

Use igmp-snooping query-interval to set the IGMP general query interval for a VLAN.

Use undo igmp-snooping query-interval to restore the default.

Syntax

igmp-snooping query-interval interval

undo igmp-snooping query-interval

Default

The IGMP general query interval is 125 seconds for a VLAN.

Views

VLAN view

Predefined user roles

network-admin

Parameters

interval: Specifies an IGMP general query interval in the range of 2 to 31744 seconds.

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

To avoid mistakenly deleting multicast group members, set the IGMP general query interval to be greater than the maximum response time for IGMP general queries.

Examples

# In VLAN 2, enable IGMP snooping, and set the IGMP general query interval to 20 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping query-interval 20

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping max-response-time

igmp-snooping querier

max-response-time

igmp-snooping report source-ip

Use igmp-snooping report source-ip to configure the source IP address for IGMP reports.

Use undo igmp-snooping report source-ip to restore the default.

Syntax

igmp-snooping report source-ip ip-address

undo igmp-snooping report source-ip

Default

The source IP address of IGMP reports is the IP address of the current VLAN interface. If the current VLAN interface does not have an IP address, the source IP address is 0.0.0.0.

Views

VLAN view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for IGMP reports.

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

Examples

# In VLAN 2, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP reports.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping report source-ip 10.1.1.1

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping router-aging-time

Use igmp-snooping router-aging-time to set the aging timer for dynamic router ports in a VLAN.

Use undo igmp-snooping router-aging-time to restore the default.

Syntax

igmp-snooping router-aging-time seconds

undo igmp-snooping router-aging-time

Default

The aging timer for dynamic router ports is 260 seconds in a VLAN.

Views

VLAN view

Predefined user roles

network-admin

Parameters

seconds: Specifies an aging timer for dynamic router ports, in the range of 1 to 8097894 seconds.

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

You can set the timer for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration.

Examples

# In VLAN 2, enable IGMP snooping, and set the aging timer for dynamic router ports to 100 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping router-aging-time 100

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

router-aging-time (IGMP-snooping view)

igmp-snooping router-port-deny

Use igmp-snooping router-port-deny to disable a port from becoming a dynamic router port.

Use undo igmp-snooping router-port-deny to allow a port to become a dynamic router port.

Syntax

igmp-snooping router-port-deny [ vlan vlan-list ]

undo igmp-snooping router-port-deny [ vlan vlan-list ]

Default

A port is allowed to become a dynamic router port.

Views

Layer 2 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN ID is in the range of 1 to 4094. If you specify VLANs, this command takes effect only when the port belongs to the specified VLANs. If you do not specify a VLAN, this command takes effect on all VLANs to which the port belongs.

Examples

# Disable GigabitEthernet 1/0/1 from becoming a dynamic router port in VLAN 2.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping router-port-deny vlan 2

igmp-snooping source-deny

Use igmp-snooping source-deny to enable multicast source port filtering on a port to discard all multicast data packets.

Use undo igmp-snooping source-deny to disable multicast source port filtering on a port.

Syntax

igmp-snooping source-deny

undo igmp-snooping source-deny

Default

Multicast source port filtering is disabled.

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

This feature is supported on the following ports:

·          Layer 2 Ethernet ports on the following modules:

?  HMIM-8GSW.

?  HMIM-8GSWF.

?  HMIM-24GSW/24GSW-PoE.

·          Fixed Layer 2 Ethernet ports on the following routers:

?  MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK.

?  MSR2600-6-X1/2600-10-X1.

?  MSR3600-28/3600-51.

You can enable this feature for a port in interface view or for the specified ports in IGMP-snooping view. For a port, the configuration in interface view has the same priority as the configuration in IGMP-snooping view, and the most recent configuration takes effect.

Examples

# Enable source port filtering for multicast data on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping source-deny

Related commands

source-deny (IGMP-snooping view)

igmp-snooping special-query source-ip

Use igmp-snooping special-query source-ip to configure the source IP address for IGMP group-specific queries.

Use undo igmp-snooping special-query source-ip to restore the default.

Syntax

igmp-snooping special-query source-ip ip-address

undo igmp-snooping special-query source-ip

Default

In a VLAN, the source IP address of IGMP group-specific queries is one of the following:

·          The source address of IGMP group-specific queries if the IGMP snooping querier has received IGMP general queries.

·          The IP address of the current VLAN interface if the IGMP snooping querier does not receive an IGMP general query.

·          0.0.0.0 if the IGMP snooping querier does not receive an IGMP general query and the current VLAN interface does not have an IP address.

Views

VLAN view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for IGMP group-specific queries.

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

Examples

# In VLAN 2, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP group-specific queries.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping special-query source-ip 10.1.1.1

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping static-group

Use igmp-snooping static-group to configure a port as a static member port of a multicast group.

Use undo igmp-snooping static-group to remove the configuration of static member ports.

Syntax

igmp-snooping static-group group-address [ source-ip source-address ] vlan vlan-id

undo igmp-snooping static-group { group-address [ source-ip source-address ] vlan vlan-id | all }

Default

A port is not a static member port of a multicast group.

Views

Layer 2 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

source-ip source-address: Specifies a multicast source by its IP address. If you specify a multicast source, this command configures the port as a static member port for a multicast source and group. If you do not specify a multicast source, this command configures the port as a static member port for a multicast group. This option takes effect on IGMPv3 snooping devices.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

all: Specifies all multicast groups.

Examples

# Configure GigabitEthernet 1/0/1 as a static member port of multicast source and group (1.1.1.1, 225.0.0.1) in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

[Sysname-vlan2] quit

[Sysname] interface Gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping static-group 225.0.0.1 source-ip 1.1.1.1 vlan 2

igmp-snooping static-router-port

Use igmp-snooping static-router-port to configure a port as a static router port.

Use undo igmp-snooping static-router-port to remove the configuration of static router ports.

Syntax

igmp-snooping static-router-port vlan vlan-id

undo igmp-snooping static-router-port { all | vlan vlan-id }

Default

A port is not a static router port.

Views

Layer 2 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

all: Specifies all VLANs.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

Examples

# Configure GigabitEthernet 1/0/1 as a static router port in VLAN 2.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping static-router-port vlan 2

igmp-snooping version

Use igmp-snooping version to specify an IGMP snooping version for a VLAN.

Use undo igmp-snooping version to restore the default.

Syntax

igmp-snooping version version-number

undo igmp-snooping version

Default

The IGMP snooping version in a VLAN is 2.

Views

VLAN view

Predefined user roles

network-admin

Parameters

version-number: Specifies an IGMP snooping version, 2 or 3.

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

You can specify the version for a VLAN in VLAN view or for the specified VLANs in IGMP-snooping view. For a VLAN, the configuration in VLAN view has the same priority as the configuration in IGMP-snooping view, and the most recent configuration takes effect.

Examples

# In VLAN 2, enable IGMP snooping, and specify IGMP snooping version 3.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

version (IGMP-snooping view)

last-member-query-interval (IGMP-snooping view)

Use last-member-query-interval to set the IGMP last member query interval globally.

Use undo last-member-query-interval to restore the default.

Syntax

last-member-query-interval interval

undo last-member-query-interval

Default

The IGMP last member query interval is 1 second.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

interval: Specifies an IGMP last member query interval in the range of 1 to 25 seconds.

Usage guidelines

You can set the interval for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP last member query interval to 3 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] last-member-query-interval 3

Related commands

igmp-snooping last-member-query-interval

max-response-time (IGMP-snooping view)

Use max-response-time to set the maximum response time for IGMP general queries globally.

Use undo max-response-time to restore the default.

Syntax

max-response-time seconds

undo max-response-time

Default

The maximum response time for IGMP general queries is 10 seconds.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

seconds: Specifies the maximum response time for IGMP general queries, in the range of 1 to 3174 seconds.

Usage guidelines

You can set the time for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration.

To avoid mistakenly deleting multicast group members, set the maximum response time for IGMP general queries to be less than the IGMP general query interval.

Examples

# Set the global maximum response time for IGMP general queries to 5 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] max-response-time 5

Related commands

igmp-snooping max-response-time

igmp-snooping query-interval

overflow-replace (IGMP-snooping view)

Use overflow-replace to enable the multicast group replacement feature globally.

Use undo overflow-replace to disable the multicast group replacement feature globally.

Syntax

overflow-replace [ vlan vlan-list ]

undo overflow-replace [ vlan vlan-list ]

Default

The multicast group replacement feature is disabled.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs.

Usage guidelines

This command takes effect only on the multicast groups that a port joins dynamically.

You can enable the multicast group replacement feature globally for all ports in IGMP-snooping view or for a port in interface view. For a port, the port-specific configuration takes priority over the global configuration.

This feature does not take effect if the following conditions exist:

·          The number of the IGMP snooping forwarding entries on the device reaches or exceeds the upper limit.

·          The multicast group that the port newly joins is not included in the multicast group list maintained by the device.

Examples

# Globally enable the multicast group replacement feature for VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] overflow-replace vlan 2

Related commands

igmp-snooping overflow-replace

report-aggregation (IGMP-snooping view)

Use report-aggregation to enable IGMP report suppression.

Use undo report-aggregation to disable IGMP report suppression.

Syntax

report-aggregation

undo report-aggregation

Default

IGMP report suppression is enabled.

Views

IGMP-snooping view

Predefined user roles

network-admin

Examples

# Disable IGMP report suppression.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] undo report-aggregation

reset igmp-snooping group

Use reset igmp-snooping group to clear dynamic IGMP snooping group entries.

Syntax

reset igmp-snooping group { group-address [ source-address ] | all } [ vlan vlan-id ]

Views

User view

Predefined user roles

network-admin

Parameters

group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

source-address: Specifies a multicast source address. If you do not specify a multicast source, this command clears dynamic IGMP snooping group entries for all multicast sources.

all: Specifies all multicast groups.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command clears dynamic IGMP snooping group entries for all VLANs.

Examples

# Clear all dynamic IGMP snooping group entries.

<Sysname> reset igmp-snooping group all

Related commands

display igmp-snooping group

reset igmp-snooping router-port

Use reset igmp-snooping router-port to clear dynamic router port information.

Syntax

reset igmp-snooping router-port { all | vlan vlan-id }

Views

User view

Predefined user roles

network-admin

Parameters

all: Specifies all dynamic router ports.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command clears dynamic router port information for all VLANs.

Examples

# Clear dynamic router port information.

<Sysname> reset igmp-snooping router-port all

Related commands

display igmp-snooping router-port

reset igmp-snooping statistics

Use reset igmp-snooping statistics to clear statistics for IGMP messages and PIMv2 hello messages learned through IGMP snooping.

Syntax

reset igmp-snooping statistics

Views

User view

Predefined user roles

network-admin

Examples

# Clear the statistics for all IGMP messages and PIMv2 hello messages learned through IGMP snooping.

<Sysname> reset igmp-snooping statistics

Related commands

display igmp-snooping statistics

reset l2-multicast fast-forwarding cache

Use reset l2-multicast fast-forwarding cache to clear Layer 2 multicast fast forwarding entries.

Syntax

Centralized devices in standalone mode:

reset l2-multicast fast-forwarding cache [ vlan vlan-id ] { { source-address | group-address } * | all }

Distributed devices in standalone mode/centralized devices in IRF mode:

reset l2-multicast fast-forwarding cache [ vlan vlan-id ] { { source-address | group-address } * | all } [ slot slot-number ]

Distributed devices in IRF mode:

reset l2-multicast fast-forwarding cache [ vlan vlan-id ] { { source-address | group-address } * | all } [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

Parameters

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command clears Layer 2 multicast fast forwarding entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command clears Layer 2 multicast fast forwarding entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command clears Layer 2 multicast fast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

all: Specifies all Layer 2 multicast fast forwarding entries.

Examples

# Clear all Layer 2 multicast fast forwarding entries.

<Sysname> reset l2-multicast fast-forwarding cache all

# Clear the Layer 2 multicast fast forwarding entry for multicast source and group (20.0.0.2, 225.0.0.2).

<Sysname> reset l2-multicast fast-forwarding cache 20.0.0.2 225.0.0.2

Related commands

display l2-multicast fast-forwarding cache

router-aging-time (IGMP-snooping view)

Use router-aging-time to set the aging timer for dynamic router ports globally.

Use undo router-aging-time to restore the default.

Syntax

router-aging-time seconds

undo router-aging-time

Default

The aging timer for dynamic router ports is 260 seconds.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

seconds: Specifies an aging timer for dynamic router ports, in the range of 1 to 8097894 seconds.

Usage guidelines

You can set the timer globally for all VLANs in IGMP-snooping view or for a VLAN in VLAN view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration.

Examples

# Set the global aging timer for dynamic router ports to 100 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] router-aging-time 100

Related commands

igmp-snooping router-aging-time

source-deny (IGMP-snooping view)

Use source-deny to enable multicast source port filtering on ports to discard all multicast data packets.

Use undo source-deny to disable multicast source port filtering on ports.

Syntax

source-deny port interface-list

undo source-deny port interface-list

Default

Multicast source port filtering is disabled.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

port interface-list: Specifies a space-separated list of port items. Each item specifies a port by its port type and number or a range of ports in the form of start-interface-type interface-number to end-interface-type interface-number.

Usage guidelines

This feature is supported on the following ports:

·          Layer 2 Ethernet ports on the following modules:

?  HMIM-8GSW.

?  HMIM-8GSWF.

?  HMIM-24GSW/24GSW-PoE.

·          Fixed Layer 2 Ethernet ports on the following routers:

?  MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK.

?  MSR2600-6-X1/2600-10-X1.

?  MSR3600-28/3600-51.

You can enable this feature for the specified ports in IGMP-snooping view or for a port in interface view. For a port, the configuration in IGMP-snooping view has the same priority as the configuration in interface view, and the most recent configuration takes effect.

Examples

# Enable multicast source port filtering on ports GigabitEthernet 1/0/1 through GigabitEthernet 1/0/4.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] source-deny port gigabitethernet 1/0/1 to gigabitethernet 1/0/4

Related commands

igmp-snooping source-deny

version (IGMP-snooping view)

Use version to specify an IGMP snooping version for VLANs.

Use undo version to restore the default.

Syntax

version version-number vlan vlan-list

undo version vlan vlan-list

Default

The IGMP snooping version in a VLAN is 2.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

version-number: Specifies an IGMP snooping version, 2 or 3.

vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN ID is in the range of 1 to 4094.

Usage guidelines

You must enable IGMP snooping for the specified VLANs before you execute this command.

You can specify the version for the specified VLANs in IGMP-snooping view or for a VLAN in VLAN view. For a VLAN, the configuration in IGMP-snooping view has the same priority as the configuration in VLAN view, and the most recent configuration takes effect.

Examples

# Enable IGMP snooping for VLAN 2 through VLAN 10, and specify IGMP snooping version 3 for these VLANs.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] enable vlan 2 to 10

[Sysname-igmp-snooping] version 3 vlan 2 to 10

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping version


Multicast routing and forwarding commands

The following matrix shows the feature and hardware compatibility:

 

Hardware

Multicast routing and forwarding compatibility

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK

Yes

MSR810-LMS/810-LUS

No

MSR2600-6-X1/2600-10-X1

Yes

MSR 2630

Yes

MSR3600-28/3600-51

Yes

MSR3600-28-SI/3600-51-SI

No

MSR 3610/3620/3620-DP/3640/3660

Yes

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC

Yes

MSR5620/5660/5680

Yes

 

Hardware

Multicast routing and forwarding compatibility

MSR810-LM-GL

Yes

MSR810-W-LM-GL

Yes

MSR830-6EI-GL

Yes

MSR830-10EI-GL

Yes

MSR830-6HI-GL

Yes

MSR830-10HI-GL

Yes

MSR2600-6-X1-GL

Yes

MSR3600-28-SI-GL

No

 

Commands and descriptions for centralized devices apply to the following routers:

·          MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK.

·          MSR2600-6-X1/2600-10-X1.

·          MSR2630.

·          MSR3600-28/3600-51.

·          MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC.

·          MSR 3610/3620/3620-DP/3640/3660.

Commands and descriptions for distributed devices apply to the following routers:

·          MSR5620.

·          MSR 5660.

·          MSR 5680.

delete ip rpf-route-static

Use delete ip rpf-route-static to delete all static multicast routes.

Syntax

delete ip rpf-route-static [ vpn-instance vpn-instance-name ]

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command deletes all static multicast routes on the public network.

Usage guidelines

This command deletes all static multicast routes. To delete a specified static multicast route, use the undo ip rpf-route-static command.

Examples

# Delete all static multicast routes on the public network.

<Sysname> system-view

[Sysname] delete ip rpf-route-static

This will erase all multicast static routes and their configurations, you must reconfigure all static routes.

Are you sure?[Y/N]:y

Related commands

ip rpf-route-static

display mac-address [ multicast ]

Use display mac-address [ multicast ] to display static multicast MAC address entries.

Syntax

display mac-address [ mac-address [ vlan vlan-id ] | [ multicast ] [ vlan vlan-id ] [ count ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

mac-address: Specifies a multicast MAC address. The MAC address can be any legal multicast MAC address except 0100-5Exx-xxxx and 3333-xxxx-xxxx, where "x" represents a hexadecimal number from 0 to F.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays MAC address entries for all VLANs.

multicast: Specifies static multicast MAC address entries.

count: Specifies the number of MAC address entries. If you specify the keyword, this command displays the number of matching MAC address entries. If you do not specify the keyword, this command displays the contents of the matching entries rather than the entry count.

Usage guidelines

If you do not specify any parameters, this command displays all MAC address entries, including unicast MAC address entries and static multicast MAC address entries.

Examples

# Display static multicast MAC address entries for VLAN 2.

<Sysname> display mac-address multicast vlan 2

MAC Address      VLAN ID    State            Port/NickName            Aging

0100-0001-0001   2          Multicast        GE1/0/1                  N

                                             GE1/0/2

# Display the number of static multicast MAC address entries.

<Sysname> display mac-address multicast count

1 mac address(es) found.

Table 12 Command output

Field

Description

MAC address

MAC address of a multicast group.

VLAN ID

ID of the VLAN to which the network device identified by the MAC address belongs.

State

Status of the MAC address. If the multicast MAC address entry is static, this field displays Multicast.

Port/NickName

Outgoing ports or nickname of the Egress RB in a TRILL network for the packet that is sent to the MAC address in this MAC address entry.

Aging

Aging time state. If this entry never expires, this field displays N.

1 mac address(es) found

One static multicast MAC address entry is found.

 

Related commands

mac-address multicast

display mrib interface

Use display mrib interface to display information about interfaces maintained by the MRIB.

Syntax

display mrib [ vpn-instance vpn-instance-name ] interface [ interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about interfaces maintained by the MRIB on the public network.

interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays information about all interfaces maintained by the MRIB.

Examples

# Display information about all interfaces maintained by the MRIB on the public network.

<Sysname> display mrib interface

 Interface: GigabitEthernet1/0/1

     Index: 0x00000001

     Current state: up

     MTU: 1500

     Type: BROADCAST

     Protocol: PIM-DM

     PIM protocol state: Enabled

     Address list:

          1. Local address : 8.12.0.2/16

             Remote address: 0.0.0.0

             Reference     : 1

             State         : NORMAL

Table 13 Command output

Field

Description

Interface

Interface name.

Index

Index number of the interface.

Current state

Current status of the interface: up or down.

MTU

MTU value.

Type

Interface type:

·         BROADCAST—Broadcast link interface.

·         P2P—P2P interface.

·         LOOP—Loopback interface.

·         REGISTER—Register interface.

·         NBMA—NBMA interface.

·         MTUNNEL—Multicast tunnel interface.

This field is empty if the interface is Null 0.

Protocol

Protocol running on the interface: PIM-DM, PIM-SM, IGMP, PROXY, or MD.

PIM protocol state

Whether PIM is enabled: Enabled or Disabled.

Address list

Interface address list.

Local address

Local IP address.

Remote address

Remote end IP address. This field is displayed only when the interface is vlink type.

Reference

Number of times that the address has been referenced.

State

Status of the interface address: NORMAL or DEL.

 

display multicast boundary

Use display multicast boundary to display multicast boundary information.

Syntax

display multicast [ vpn-instance vpn-instance-name ] boundary [ group-address [ mask-length | mask ] ] [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast boundary information on the public network.

group-address: Specifies a multicast group by its IP address in the range of 224.0.0.0 to 239.255.255.255. If you do not specify a multicast group, this command displays multicast boundary information for all multicast groups.

mask-length: Specifies an address mask length in the range of 4 to 32. The default is 32.

mask: Specifies an address mask. The default is 255.255.255.255.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays multicast boundary information for all interfaces.

Examples

# Display information about all multicast boundaries on the public network.

<Sysname> display multicast boundary

 Boundary            Interface

 224.1.1.0/24        GE1/0/1

 239.2.2.0/24        GE1/0/2

Table 14 Command output

Field

Description

Boundary

Multicast group associated with the multicast boundary.

Interface

Boundary interface associated with the multicast boundary.

 

Related commands

multicast boundary

display multicast fast-forwarding cache

Use display multicast fast-forwarding cache to display multicast fast forwarding entries.

Syntax

Centralized devices in standalone mode:

display multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ source-address | group-address ] *

Distributed devices in standalone mode/centralized devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ source-address | group-address ] * [ slot slot-number ]

Distributed devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ source-address | group-address ] * [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast fast forwarding entries on the public network.

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays multicast fast forwarding entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays multicast fast forwarding entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays multicast fast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display multicast fast forwarding entries on the public network.

<Sysname> display multicast fast-forwarding cache

Total 1 entries, 1 matched

 

(60.1.1.200, 225.0.0.2)

     Status     : Enabled

     Source port: 2001                   Destination port: 2002

     Protocol   : 2                      Flag            : 0x2

     Incoming interface: GigabitEthernet2/0/6

     List of 1 outgoing interfaces:

        GigabitEthernet3/0/2

        Status: Enabled               Flag: 0x14

Table 15 Command output

Field

Description

Total 1 entries, 1 matched

Total number of (S, G) entries in the multicast fast forwarding table, and the total number of matching (S, G) entries.

(60.1.1.200, 225.0.0.2)

(S, G) entry.

Protocol

Protocol number.

Flag

Flag of the (S, G) entry or the outgoing interface in the entry.

This field displays one flag or the sum of multiple flags. In this example, the value 0x2 means that the entry has only one flag 0x2. The value 0x14 means that the interface has flags 0x4 and 0x10.

The following flags are available for an entry:

·         0x1—The entry is created because of packets passed through between cards.

·         0x2—The entry is added by multicast forwarding.

The following flags are available for an outgoing interface:

·         0x1—The interface is added to the entry because of packets passed through between cards.

·         0x2—The interface is added to an existing entry.

·         0x4—The MAC address of the interface is needed for fast forwarding.

·         0x8—The interface is an outgoing interface associated with the incoming VLAN or super VLAN interface.

·         0x10—The interface is associated with the entry.

·         0x20—The interface is to be deleted.

Status

Status of the (S, G) entry or the outgoing interface:

·         Enabled—Available.

·         Disabled—Unavailable.

Incoming interface

Incoming interface of the (S, G) entry.

List of 1 outgoing interfaces

Outgoing interface list of the (S, G) entry.

 

Related commands

reset multicast fast-forwarding cache all

display multicast forwarding df-info

Use display multicast forwarding df-info to display DF information.

Syntax

Centralized devices in standalone mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ rp-address ] [ verbose ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ rp-address ] [ verbose ] [ slot slot-number ]

Distributed devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ rp-address ] [ verbose ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays DF information on the public network.

rp-address: Specifies a BIDIR-PIM RP by its IP address.

verbose: Specifies detailed information. If you do not specify the keyword, this command displays brief information.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays DF information for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays DF information for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays DF information for the global active MPU. (Distributed devices in IRF mode.)

Usage guidelines

In a BIDIR-PIM domain, only the DF on each subnet can forward multicast data destined for a multicast group toward the RP of the group. For more information about the DF, see IP Multicast Configuration Guide.

Examples

# Display brief information about DFs on an ADVPN network.

<Sysname> display multicast forwarding df-info

Total 1 RPs, 1 matched

 

00001. RP address: 1.1.1.1

     Flags: 0x0

     Uptime: 00:00:53

     RPF interface: Tunnel0, 192.168.0.1

     List of 2 DF interfaces:

       1: LoopBack0

       2: Tunnel0, 192.168.0.3

# Display brief information about DFs on the public network.

<Sysname> display multicast forwarding df-info

Total 1 RPs, 1 matched

 

00001. RP address: 7.11.0.2

     Flags: 0x0

     Uptime: 04:14:40

     RPF interface: GigabitEthernet1/0/1

     List of 1 DF interfaces:

       1: GigabitEthernet1/0/2

# Display detailed information about DFs on the public network.

<Sysname> display multicast forwarding df-info verbose

Total 1 RPs, 1 matched

 

00001. RP address: 7.11.0.2

     MID: 2, Flags: 0x0

     Uptime: 03:37:22

       Product information: 0x7a2f762f, 0x718fee9f, 0x4b82f137, 0x71c32184

     RPF interface: GigabitEthernet1/0/1

       Product information: 0xa567d6fc, 0xadeb03e3

       Tunnel  information: 0xdfb107d4, 0x7aa5d510

     List of 1 DF interfaces:

       1: GigabitEthernet1/0/2

          Product information: 0xa986152b, 0xb74a9a2f

          Tunnel  information: 0x297ca208, 0x76985b89

Table 16 Command output

Field

Description

Total 1 RPs, 1 matched

Total number of RPs, and the total number of matching RPs.

00001

Sequence number of the entry to which the RP is designated.

RP address

IP address of the RP.

MID

ID of the entry to which the RP is designated. Each entry to which the RP is designated has a unique MID.

Flags

Entry flag.

This field displays one flag or the sum of multiple flags. In this example, the value 0x0 means that the entry has only one flag 0x0.

The following flags are available for an entry:

·         0x0—The entry is in correct state.

·         0x4—The entry fails to update.

·         0x8—DF interface information fails to update for the entry.

·         0x40—The entry is to be deleted.

·         0x100—The entry is being deleted.

·         0x200—The entry is in GR state.

Uptime

Length of time for which the entry has been up.

RPF interface

RPF interface to the RP.

List of 1 DF interfaces

DF interface list.

Tunnel0, 192.168.0.3

ADVPN tunnel interface, and the IP address of the remote end.

 

display multicast forwarding event

Use display multicast forwarding event to display statistics of multicast forwarding events.

Syntax

Centralized devices in standalone mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding event

Distributed devices in standalone mode/centralized devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding event [ slot slot-number ]

Distributed devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding event [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays statistics of the multicast forwarding events on the public network.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays statistics of multicast forwarding events for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays statistics of multicast forwarding events for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays statistics of multicast forwarding events for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display statistics of multicast forwarding events on the public network.

<Sysname> display multicast forwarding event

Total entry active events sent: 0

Total entry inactive events sent: 0

Total NoCache events sent: 2

Total NoCache events dropped: 0

Total WrongIF events sent: 0

Total WrongIF events dropped: 0

Total SPT switch events sent: 0

NoCache rate limit: 1024 packets/s

WrongIF rate limit: 1 packets/10s

Total timer of register suppress timeout: 0

Table 17 Command output

Field

Description

Total entry active events sent

Number of times that entry-active events have been sent.

Total entry inactive events sent

Number of times that entry-inactive events have been sent.

Total NoCache events sent

Number of times that NoCache events have been sent.

Total NoCache events dropped

Number of times that NoCache events have been dropped.

Total WrongIF events sent

Number of times that WrongIF events have been sent.

Total WrongIF event dropped

Number of times that WrongIF events have been dropped.

Total SPT switch events sent

Number of times that SPT-switch events have been sent.

NoCache rate limit

Rate limit for sending NoCache events, in pps.

WrongIF rate limit

Rate limit for sending WrongIF events, in packets per 10 seconds.

Total timer of register suppress timeout

Number of times that the registration suppression has timed out in total.

 

Related commands

reset multicast forwarding event

display multicast forwarding-table

Use display multicast forwarding-table to display multicast forwarding entries.

Syntax

Centralized devices in standalone mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number | statistics ] *

Distributed devices in standalone mode/centralized devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number | slot slot-number | statistics ] *

Distributed devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | chassis chassis-number slot slot-number | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number | statistics ] *

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast forwarding entries on the public network.

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

mask-length: Specifies an address mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.

mask: Specifies an address mask. The default value is 255.255.255.255.

incoming-interface: Specifies the multicast forwarding entries that contain the specified incoming interface.

interface-type interface-number: Specifies an incoming interface by its type and number.

outgoing-interface: Specifies the multicast forwarding entries that contain the specified outgoing interface.

exclude: Specifies the multicast forwarding entries that do not contain the specified interface in the outgoing interface list.

include: Specifies the multicast forwarding entries that contain the specified interface in the outgoing interface list.

match: Specifies the forwarding entries that contain only the specified interface in the outgoing interface list.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays multicast forwarding entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays multicast forwarding entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays multicast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

statistics: Displays statistics for the multicast forwarding table.

Examples

# Display multicast forwarding entries an ADVPN network.

<Sysname> display multicast forwarding-table

Total 1 entries, 1 matched

 

00001. (172.168.0.2, 227.0.0.1)

     Flags: 0x0

     Uptime: 00:08:32, Timeout in: 00:03:26

     Incoming interface: Tunnel1, 12.1.1.3

     List of 2 outgoing interface:

             1:  Tunnel1, 12.1.1.1

             2:  Tunnel1, 12.1.1.2

     Matched 19648 packets(20512512 bytes), Wrong If 0 packet

     Forwarded 19648 packets(20512512 bytes)

# Display multicast forwarding entries on the public network.

<Sysname> display multicast forwarding-table

Total 1 entries, 1 matched

 

00001. (172.168.0.2, 227.0.0.1)

     Flags: 0x0

     Uptime: 00:08:32, Timeout in: 00:03:26

     Incoming interface: Vlan-interface10

          Incoming sub-VLAN: VLAN 11

          Outgoing sub-VLAN: VLAN 12

                             VLAN 13

     List of 1 outgoing interfaces:

       1: Vlan-interface20

          Sub-VLAN: VLAN 21

                    VLAN 22

     Matched 19648 packets(20512512 bytes), Wrong If 0 packet

     Forwarded 19648 packets(20512512 bytes)

Table 18 Command output

Field

Description

Total 1 entries, 1 matched

Total number of (S, G) entries, and the total number of matching (S, G) entries.

00001

Sequence number of the (S, G) entry.

(172.168.0.2,227.0.0.1)

(S, G) entry.

Flags

Entry flag.

This field displays one flag or the sum of multiple flags. In this example, the value 0x0 means that the entry has only one flag 0x0.

The following entries are available for an entry:

·         0x0—The entry is in correct state.

·         0x1—The entry is in inactive state.

·         0x2—The entry is null.

·         0x4—The entry fails to update.

·         0x8—Outgoing interface information fails to update for the entry.

·         0x10—Data-group information fails to update for the entry.

·         0x20—A register outgoing interface is available.

·         0x40—The entry is to be deleted.

·         0x80—The entry is in registration suppression state.

·         0x100—The entry is being deleted.

·         0x200—The entry is in GR state.

·         0x400—The entry has the VLAN interface of the super VLAN.

·         0x800—The entry has the associated ARP entry for the multicast source address.

·         0x400000—The entry is created by the IGMP proxy.

·         0x2000000—The entry is a BIDIR-PIM forwarding entry.

Uptime

Length of time for which the (S, G) entry has been up.

Timeout in

Length of time in which the (S, G) entry will expire.

Incoming interface

Incoming interface of the (S, G) entry.

Incoming sub-VLAN

Incoming sub-VLAN of the super VLAN when the incoming interface of the (S, G) entry is the VLAN interface of this super VLAN.

Outgoing sub-VLAN

Outgoing sub-VLAN of the super VLAN when the incoming interface of the (S, G) entry is the VLAN interface of this super VLAN.

List of 1 outgoing interfaces

Outgoing interface list of the (S, G) entry.

Sub-VLAN

Outgoing sub-VLAN of the super VLAN when the outgoing interface of the (S, G) entry is the VLAN interface of this super VLAN.

Tunnel1, 12.1.1.1

ADVPN tunnel interface, and the IP address of the remote end.

Matched 19648 packets(20512512 bytes), Wrong If 0 packet

Number of packets (bytes) that match the (S, G) entry, and number of packets with incoming interface errors.

The numbers are displayed as 0 if an outgoing interface of the (S, G) entry is on the specified slot.

Forwarded 19648 packets(20512512 bytes)

Number of packets (bytes) that have been forwarded.

The numbers are displayed as 0 if an outgoing interface of the (S, G) entry is on the specified slot.

 

Related commands

reset multicast forwarding-table

display multicast forwarding-table df-list

Use display multicast forwarding-table df-list to display information about the DF list in multicast forwarding entries.

Syntax

Centralized devices in standalone mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ group-address ] [ verbose ]

Distributed devices in standalone mode/centralized devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ group-address ] [ verbose ] [ slot slot-number ]

Distributed devices in IRF mode:

display multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ group-address ] [ verbose ] [ chassis chassis-number slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about the DF list in multicast forwarding entries on the public network.

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

verbose: Specifies detailed information about the DF list in multicast forwarding entries. If you do not specify the keyword, this command displays brief information about the DF list in multicast forwarding entries.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information about the DF list in multicast forwarding entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays information about the DF list in multicast forwarding entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays information about the DF list in multicast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

Examples

# Display brief information about the DF list in multicast forwarding entries on the public network.

<Sysname> display multicast forwarding-table df-list

Total 1 entries, 1 matched

 

00001. (0.0.0.0, 225.0.0.1)

     List of 1 DF interfaces:

       1: GigabitEthernet1/0/1

# Display detailed information about the DF list in multicast forwarding entries on the public network.

<Sysname> display multicast forwarding-table df-list verbose

Total 1 entries, 1 matched

 

00001. (0.0.0.0, 225.0.0.1)

       List of 1 DF interfaces:

         1: GigabitEthernet1/0/1

            Product information: 0x347849f6, 0x14bd6837

            Tunnel  information: 0xc4857986, 0x128a9c8f

Table 19 Command output

Field

Description

Total 1 entries, 1 matched

Total number of forwarding entries, and the total number of matching entries.

00001

Sequence number of the entry.

(0.0.0.0, 225.0.0.1)

(*, G) entry.

List of 1 DF interfaces

DF interface list.

 

display multicast routing-table

Use display multicast routing-table to display multicast routing entries.

Syntax

display multicast [ vpn-instance vpn-instance-name ] routing-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number ] *

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast routing entries on the public network.

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

mask-length: Specifies an address mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.

mask: Specifies an address mask. The default is 255.255.255.255.

incoming-interface: Specifies the multicast routing entries that contain the specified incoming interface.

interface-type interface-number: Specifies an interface by its type and number.

outgoing-interface: Specifies the multicast routing entries that contain the specified outgoing interface.

exclude: Specifies the multicast routing entries that do not contain the specified interface in the outgoing interface list.

include: Specifies the multicast routing entries that contain the specified interface in the outgoing interface list.

match: Specifies the multicast routing entries that contain only the specified interface in the outgoing interface list.

Usage guidelines

Multicast routing entries are the basis of multicast forwarding. You can use this command to view the establishment state of (S, G) entries.

Examples

# Display multicast routing entries on an ADVPN network.

<Sysname> display multicast routing-table

 Total 1 entries

 

 00001. (172.168.0.2, 227.0.0.1)

       Uptime: 00:00:28

       Upstream Interface: Tunnel1, 12.1.1.3

       List of 2 downstream interfaces

           1:  Tunnel1, 12.1.1.1

           2:  Tunnel1, 12.1.1.2

# Display multicast routing entries on the public network.

<Sysname> display multicast routing-table

 Total 1 entries

 

 00001. (172.168.0.2, 227.0.0.1)

       Uptime: 00:00:28

       Upstream Interface: GigabitEthernet1/0/1

       List of 2 downstream interfaces

           1:  GigabitEthernet1/0/2

           2:  GigabitEthernet1/0/3

Table 20 Command output

Field

Description

Total 1 entries

Total number of (S, G) entries.

00001

Sequence number of the (S, G) entry.

(172.168.0.2, 227.0.0.1)

(S, G) entry.

Uptime

Length of time for which the (S, G) entry has been up.

Upstream Interface

Upstream interface at which (S, G) packets should arrive.

List of 2 downstream interfaces

List of downstream interfaces that need to forward (S, G) packets.

Tunnel11, 12.1.1.1

ADVPN tunnel interface, and the IP address of the remote end.

 

Related commands

reset multicast routing-table

display multicast routing-table static

Use display multicast routing-table static to display static multicast routing entries.

Syntax

display multicast [ vpn-instance vpn-instance-name ] routing-table static [ source-address { mask-length | mask } ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays static multicast routing entries on the public network.

source-address: Specifies a multicast source address.

mask-length: Specifies an address mask length in the range of 0 to 32.

mask: Specifies an address mask.

Usage guidelines

This command displays only valid static multicast routing entries.

Examples

# Display static multicast routing entries on the public network.

<Sysname> display multicast routing-table static

Destinations: 3        Routes: 4

 

Destination/Mask   Pre  RPF neighbor    Interface

1.1.0.0/16         10   7.12.0.1        GE1/0/1

                        7.11.0.1        GE1/0/2

2.2.2.0/24         20   7.11.0.1        GE1/0/3

3.3.3.3/32         50   7.12.0.1        GE1/0/4

Table 21 Command output

Field

Description

Destinations

Number of the multicast destination addresses.

Routes

Number of routes.

Destination/Mask

Destination address and its mask length.

Pre

Route preference.

RPF neighbor

IP address of the RPF neighbor to the reachable destination.

Interface

Outgoing interface to the reachable destination.

 

display multicast rpf-info

Use display multicast rpf-info to display RPF information for a multicast source.

Syntax

display multicast [ vpn-instance vpn-instance-name ] rpf-info source-address [ group-address ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays RPF information for a multicast source on the public network.

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

Examples

# Display RPF information for multicast source 192.168.1.55 on the public network.

<Sysname> display multicast rpf-info 192.168.1.55

 RPF information about source 192.168.1.55:

     RPF interface: GigabitEthernet1/0/1, RPF neighbor: 10.1.1.1

     Referenced route/mask: 192.168.1.0/24

     Referenced route type: igp

     Route selection rule: preference-preferred

     Load splitting rule: disable

Table 22 Command output

Field

Description

RPF neighbor

IP address of the RPF neighbor.

Referenced route/mask

Referenced route and its mask length.

Referenced route type

Type of the referenced route:

·         igp—IGP unicast route.

·         egp—EGP unicast route.

·         unicast (direct)—Directly connected unicast route.

·         unicast—Other unicast routes, such as static unicast route.

·         multicast static—Static multicast route.

·         mbgp—MBGP route.

Route selection rule

Rule for RPF route selection:

·         Route preference.

·         Longest prefix match.

Load splitting rule

Status of the load splitting rule: enable or disable.

 

Related commands

display multicast forwarding-table

display multicast routing-table

ip rpf-route-static

Use ip rpf-route-static to configure a static multicast route.

Use undo ip rpf-route-static to delete a static multicast route.

Syntax

ip rpf-route-static [ vpn-instance vpn-instance-name ] source-address { mask-length | mask } { rpf-nbr-address | interface-type interface-number } [ preference preference ]

undo ip rpf-route-static [ vpn-instance vpn-instance-name ] source-address { mask-length | mask } { rpf-nbr-address | interface-type interface-number }

Default

No static multicast routes exist.

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command configures a static multicast route on the public network.

source-address: Specifies a multicast source address.

mask-length: Specifies an address mask length in the range of 0 to 32.

mask: Specifies an address mask.

rpf-nbr-address: Specifies an RPF neighbor by its IP address.

interface-type interface-number: Specifies an interface by its type and number. The interface connects the RPF neighbor.

preference: Sets a route preference in the range of 1 to 255. The default value is 1.

Usage guidelines

When you specify an RPF neighbor, follow these guidelines:

·          If the RPF neighbor is a point-to-point interface, you must specify the type and number of the interface.

·          If the RPF neighbor is not a point-to-point interface, you must specify the IP address of the interface. This type of interfaces includes Layer 3 Ethernet, Layer 3 aggregate, Loopback, and VLAN interfaces.

The configured static multicast route might not take effect when one of the following conditions exists:

·          The outgoing interface iteration fails.

·          The specified interface is not in the public network or the same VPN instance as the current interface.

·          The specified interface is not a point-to-point interface.

·          The specified interface is down.

If multiple static multicast routes within the same multicast source address range are available, only the one with the highest route preference can become active. You can use the display multicast routing-table static command to verify that the configured static multicast route has taken effect.

The undo ip rpf-route-static command deletes the specified static multicast route, but the delete ip rpf-route-static command deletes all static multicast routes.

Examples

# On the public network, configure a static multicast route to multicast source 10.1.1.1/24 and specify the interface with IP address 192.168.1.23 as the RPF neighbor.

<Sysname> system-view

[Sysname] ip rpf-route-static 10.1.1.1 24 192.168.1.23

Related commands

delete ip rpf-route-static

display multicast routing-table static

load-splitting (MRIB view)

Use load-splitting to enable load splitting of multicast traffic.

Use undo load-splitting to restore the default.

Syntax

load-splitting { source | source-group }

undo load-splitting

Default

Multicast load splitting is disabled.

Views

MRIB view

Predefined user roles

network-admin

Parameters

source: Specifies load splitting on a per-source basis.

source-group: Specifies load splitting both on a per-source basis and on a per-group basis.

Usage guidelines

This command does not take effect on BIDIR-PIM.

Examples

# Enable load splitting of multicast traffic on a per-source basis on the public network.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] load-splitting source

longest-match (MRIB view)

Use longest-match to specify the longest prefix match principle for RPF route selection.

Use undo longest-match to restore the default.

Syntax

longest-match

undo longest-match

Default

Route preference is used for RPF route selection. The route with the highest preference is used as the RPF route.

Views

MRIB view

Predefined user roles

network-admin

Usage guidelines

This command enables the device to use the matching route with the longest prefix as the RPF route.

Examples

# Specify the longest prefix match principle for RPF route selection on the public network.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] multicast longest-match

mac-address multicast

Use mac-address multicast to configure a static multicast MAC address entry.

Use undo mac-address multicast to delete a static multicast MAC address entry.

Syntax

In system view:

mac-address multicast mac-address interface interface-list vlan vlan-id

undo mac-address [ multicast ] [ [ mac-address [ interface interface-list ] ] vlan vlan-id ]

In Layer 2 aggregate interface view or Layer 2 Ethernet interface view:

mac-address multicast mac-address vlan vlan-id

undo mac-address [ multicast ] mac-address vlan vlan-id

Default

No static multicast MAC address entries exist.

Views

System view

Layer 2 aggregate interface view

Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

mac-address: Specifies a static multicast MAC address, in the format H-H-H. You must specify an unused multicast MAC address. A multicast MAC address is a MAC address in which the least significant bit of the most significant octet is 1.

interface interface-list: Specifies a space-separated list of up to four interface items. Each item specifies an interface or an interface list in the format of start-interface-type interface-number to end-interface-type interface-number. The interface-type interface-number argument specifies an interface by its type and number. The available interface types include Layer 2 Ethernet interfaces and Layer 2 aggregate interfaces.

vlan vlan-id: Specifies an existing VLAN by its VLAN ID in the range of 1 to 4094. The system gives a prompt if the specified interface does not belong to the VLAN.

Usage guidelines

You do not need to enable IP multicast routing before you execute this command.

You can configure static multicast MAC address entries for the specified interfaces in system view or for the current interface in interface view.

If you do not specify the multicast keyword in the undo mac-address command, all static unicast MAC address entries and static multicast MAC entries are deleted.

Examples

# Configure a static multicast MAC address entry. In the entry, the multicast MAC address is 0100-0001-0001 and the outgoing ports are GigabitEthernet 1/0/1 through GigabitEthernet 1/0/5 in VLAN 2.

<Sysname> system-view

[Sysname] mac-address multicast 0100-0001-0001 interface gigabitethernet 1/0/1 to gigabitethernet 1/0/5 vlan 2

# Configure a static multicast MAC address entry for multicast MAC address 0100-0001-0001 on GigabitEthernet 1/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mac-address multicast 0100-0001-0001 vlan 2

Related commands

display mac-address multicast

multicast boundary

Use multicast boundary to configure a multicast forwarding boundary.

Use undo multicast boundary to delete a multicast forwarding boundary.

Syntax

multicast boundary group-address { mask-length | mask }

undo multicast boundary { group-address { mask-length | mask } | all }

Default

No multicast forwarding boundaries are configured on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

mask-length: Specifies an address mask length in the range of 4 to 32.

mask: Specifies an address mask.

all: Specifies all forwarding boundaries configured on the interface.

Usage guidelines

A multicast forwarding boundary sets the boundary condition for the multicast groups in the specified address range. If the destination address of a multicast packet matches the set boundary condition, the packet is not forwarded.

You can configure an interface as a multicast forwarding boundary for different multicast group ranges by executing this command multiple times on the interface.

You do not need to enable IP multicast routing before you execute this command.

Assume that Set A and Set B are multicast forwarding boundary sets with different address ranges, and B is a subset of A. A takes effect on the interface no matter whether A is configured earlier or later than B.

Examples

# Configure GigabitEthernet 1/0/1 as the forwarding boundary of multicast groups in the range of 239.2.0.0/16.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] multicast boundary 239.2.0.0 16

Related commands

display multicast boundary

multicast routing

Use multicast routing to enable IP multicast routing and enter MRIB view.

Use undo multicast routing to disable IP multicast routing.

Syntax

multicast routing [ vpn-instance vpn-instance-name ]

undo multicast routing [ vpn-instance vpn-instance-name ]

Default

IP multicast routing is disabled.

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command enables IP multicast routing on the public network.

Usage guidelines

Other Layer 3 multicast commands take effect only when IP multicast routing is enabled.

The device does not forward multicast packets before IP multicast routing is enabled.

Examples

# Enable IP multicast routing on the public network and enter MRIB view.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib]

# Enable IP multicast routing for VPN instance mvpn and enter MRIB view.

<Sysname> system-view

[Sysname] multicast routing vpn-instance mvpn

[Sysname-mrib-mvpn]

reset multicast fast-forwarding cache

Use reset multicast fast-forwarding cache to clear multicast fast forwarding entries.

Syntax

Centralized devices in standalone mode:

reset multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { source-address | group-address } * | all }

Distributed devices in standalone mode/centralized devices in IRF mode:

reset multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { source-address | group-address } * | all } [ slot slot-number ]

Distributed devices in IRF mode:

reset multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { source-address | group-address } * | all } [ chassis chassis-number slot slot-number ]

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears multicast fast forwarding entries on the public network.

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command clears multicast fast forwarding entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command clears multicast fast forwarding entries for the master device. (Centralized devices in IRF mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command clears multicast fast forwarding entries for the global active MPU. (Distributed devices in IRF mode.)

all: Specifies all multicast fast forwarding entries.

Examples

# Clear all multicast fast forwarding entries.

<Sysname> reset multicast fast-forwarding cache all

# Clear the multicast fast forwarding entry for the multicast source and group (20.0.0.2, 225.0.0.2).

<Sysname> reset multicast fast-forwarding cache 20.0.0.2 225.0.0.2

Related commands

display multicast fast-forwarding cache

reset multicast forwarding event

Use reset multicast forwarding event to clear statistics for multicast forwarding events.

Syntax

reset multicast [ vpn-instance vpn-instance-name ] forwarding event

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears statistics for the multicast forwarding events on the public network.

Examples

# Clear statistics for multicast forwarding events on the public network.

<Sysname> reset multicast forwarding event

Related commands

display multicast forwarding event

reset multicast forwarding-table

Use reset multicast forwarding-table to clear multicast forwarding entries.

Syntax

reset multicast [ vpn-instance vpn-instance-name ] forwarding-table { { source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | incoming-interface { interface-type interface-number } } * | all }

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears multicast forwarding entries on the public network.

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

mask-length: Specifies an address mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.

mask: Specifies an address mask. The default is 255.255.255.255.

incoming-interface: Specifies the multicast forwarding entries that contain the specified incoming interface.

interface-type interface-number: Specifies an incoming interface by its type and number.

all: Specifies all multicast forwarding entries.

Usage guidelines

When you clear a multicast forwarding entry, the associated multicast routing entry is also cleared.

Examples

# Clear multicast forwarding entries for multicast group 225.5.4.3 on the public network.

<Sysname> reset multicast forwarding-table 225.5.4.3

Related commands

display multicast forwarding-table

reset multicast routing-table

Use reset multicast routing-table to clear multicast routing entries.

Syntax

reset multicast [ vpn-instance vpn-instance-name ] routing-table { { source-address [ mask { mask-length | mask } ] | group-address [ mask { mask | mask-length } ] | incoming-interface interface-type interface-number } * | all }

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears multicast routing entries on the public network.

source-address: Specifies a multicast source address.

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

mask-length: Specifies an address mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.

mask: Specifies an address mask. The default is 255.255.255.255.

incoming-interface: Specifies the routing entries that contain the specified incoming interface.

interface-type interface-number: Specifies an incoming interface by its type and number.

all: Specifies all multicast routing entries.

Usage guidelines

When you clear a multicast routing entry, the associated multicast forwarding entry is also cleared.

Examples

# Clear multicast routing entries for multicast group 225.5.4.3 on the public network.

<Sysname> reset multicast routing-table 225.5.4.3

Related commands

display multicast routing-table


IGMP commands

The following matrix shows the feature and hardware compatibility:

 

Hardware

IGMP compatibility

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK

Yes

MSR810-LMS/810-LUS

No

MSR2600-6-X1/2600-10-X1

Yes

MSR 2630

Yes

MSR3600-28/3600-51

Yes

MSR3600-28-SI/3600-51-SI

No

MSR 3610/3620/3620-DP/3640/3660

Yes

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC

Yes

MSR5620/5660/5680

Yes

 

Hardware

IGMP compatibility

MSR810-LM-GL

Yes

MSR810-W-LM-GL

Yes

MSR830-6EI-GL

Yes

MSR830-10EI-GL

Yes

MSR830-6HI-GL

Yes

MSR830-10HI-GL

Yes

MSR2600-6-X1-GL

Yes

MSR3600-28-SI-GL

No

 

display igmp group

Use display igmp group to display information about IGMP multicast groups (multicast groups that hosts have joined through IGMP).

Syntax

display igmp [ vpn-instance vpn-instance-name ] group [ group-address | interface interface-type interface-number ] [ static | verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays information about IGMP multicast groups on the public network.

group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255. If you do not specify a multicast group, the command displays information about all IGMP multicast groups.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, the command displays information about IGMP multicast groups for all interfaces.

static: Specifies IGMP multicast groups that hosts have joined statically. If you do not specify this keyword, the command displays information about IGMP multicast groups that hosts have joined dynamically.

verbose: Displays detailed information.

Examples

# Display information about IGMP multicast groups that hosts have dynamically joined on the public network.

<Sysname> display igmp group

IGMP groups in total: 3

 GigabitEthernet1/0/1(10.10.1.20):

  IGMP groups reported in total: 3

   Group address   Last reporter   Uptime      Expires

   225.1.1.1       10.10.1.10      00:02:04    00:01:15

   225.1.1.2       10.10.1.10      00:02:04    00:01:15

   225.1.1.3       10.10.1.10      00:02:04    00:01:15

Table 23 Command output

Field

Description

IGMP groups in total

Total number of IGMP multicast groups.

IGMP groups reported in total

Total number of IGMP multicast groups that hosts attached to the interface have joined dynamically.

Group address

Multicast group address.

Last reporter

Address of the last host that reported its membership to the multicast group.

Uptime

Length of time since the multicast group was reported.

Expire

Remaining lifetime for the multicast group. This field displays Off if the timer is disabled.

 

# Display detailed information about IGMP multicast group 232.1.1.1 that hosts have dynamically joined on the public network. In this example, the router is configured with IGMPv3.

<Sysname> display igmp group 232.1.1.1 verbose

GigabitEthernet1/0/1(10.10.1.20):

  IGMP groups reported in total: 3

   Group: 232.1.1.1

     Uptime: 00:00:34

     Exclude expires: 00:04:16

     Mapping expires: 00:02:16

     Last reporter: 10.10.1.10

     Last-member-query-counter: 0

     Last-member-query-timer-expiry: Off

     Mapping last-member-query-counter: 0

     Mapping last-member-query-timer-expiry: Off

     Group mode: Exclude

     Version1-host-present-timer-expiry: Off

     Version2-host-present-timer-expiry: 00:02:11

     Mapping version1-host-present-timer-expiry: Off

     Source list (sources in total: 1):

       Source: 10.1.1.1

          Uptime: 00:00:03

          V3 expires: 00:04:16

          Mapping expires: 00:02:16

          Last-member-query-counter: 0

          Last-member-query-timer-expiry: Off

Table 24 Command output

Field

Description

IGMP groups reported in total

Total number of IGMP multicast groups that hosts attached to the interface have joined dynamically.

Group

Multicast group address.

Uptime

Length of time since the multicast group was reported.

Exclude expires

Remaining lifetime for the multicast group in Exclude mode. This field displays Off if the timer is disabled.

Mapping expires

Remaining time for the multicast group specified in IGMP SSM mappings.

This field is displayed only when the device is configured with IGMP SSM mappings.

Last reporter

Address of the last host that reported its membership to this multicast group.

Last-member-query-counter

Number of IGMP group-specific queries or IGMP source-and-group-specific queries sent for the multicast group.

Last-member-query-timer-expiry

Remaining time for the last member query timer for the multicast group. This field displays Off if the timer is disabled.

Mapping last-member-query-counter

Number of IGMP group-specific queries or IGMP source-and-group-specific queries sent for the multicast group specified in IGMP SSM mappings.

This field is displayed only when the device is configured with IGMP SSM mappings.

Mapping last-member-query-timer-expiry

Remaining time for the last member query timer of the multicast group specified in IGMP SSM mappings.

This field displays Off if the timer is disabled.

This field is displayed only when the device is configured with IGMP SSM mappings.

Group mode

Multicast source filtering mode:

·         Include—Include mode.

·         Exclude—Exclude mode.

For a device that runs IGMPv1 or IGMPv2:

·         If IGMP SSM mappings are not configured, this field displays Exclude.

·         If IGMP SSM mappings are configured, this field displays Include or Exclude depending on the SSM mappings and the multicast groups that the host joins.

Version1-host-present-timer-expiry

Remaining time for the IGMPv1 host present timer.

This field displays Off if the timer is disabled.

This field is displayed only when the device runs IGMPv2 or IGMPv3.

Version2-host-present-timer-expiry

Remaining time for the IGMPv2 host present timer.

This field displays Off if the timer is disabled.

This field is displayed only when the device runs IGMPv3.

Mapping version1-host-present-timer-expiry

Remaining time for the IGMPv1 host present timer when the device is configured with IGMP SSM mappings.

This field displays Off if the timer is disabled.

This field is displayed only when the device is configured with IGMP SSM mappings.

Source list (sources in total)

List of multicast sources and total number of multicast sources.

This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings.

Source

Multicast source address.

This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings.

Uptime

Length of time since the multicast source was reported.

This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings.

V3 expires

Remaining time for the multicast source when the device runs IGMPv3.

This field displays Off if the timer is disabled and displays three hyphens (---) if the multicast source is specified in IGMP SSM mappings.

This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings.

Mapping expires

Remaining time for the multicast source specified in IGMP SSM mappings.

This field is displayed only when the device is configured with IGMP SSM mappings.

Last-member-query-counter

Number of IGMP group-specific queries or IGMP group-and-source-specific queries sent for the multicast source and group.

This field is displayed only when the device runs IGMPv3 or is configured with IGMP SSM mappings.

Last-member-query-timer-expiry

Remaining time for the last member query timer for the multicast source and group.

This field displays Off if the timer is disabled.

This field is displayed only when the device runs IGMPv3 or is configured with IGMP SSM mappings.

 

# Display information about IGMP multicast groups that hosts have statically joined on the public network.

<Sysname> display igmp group static

 Entries in total: 2

   Group address   Source address  Interface           Expires

   225.1.1.1       0.0.0.0         GE1/0/1             Never

   225.2.2.2       1.1.1.1         GE1/0/1             Never

Table 25 Command output

Field

Description

Entries in total

Total number of the multicast groups that hosts have joined statically.

Group address

Multicast group address.

Source address

Multicast source address.

Interface

Interface name.

Expires

Remaining lifetime for the multicast group. This field always displays Never because the multicast group never expires.

 

Related commands

reset igmp group

display igmp interface

Use display igmp interface to display IGMP information for interfaces.

Syntax

display igmp [ vpn-instance vpn-instance-name ] interface [ interface-type interface-number ] [ proxy ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays IGMP information for interfaces on the public network.

interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, the command displays IGMP information for all IGMP-enabled interfaces.

proxy: Displays the IGMP proxy interface information. If you do not specify this keyword, the command displays IGMP information about all interfaces.

verbose: Displays detailed IGMP information.

Examples

# Display detailed IGMP information for GigabitEthernet 1/0/1 (non-proxy interface) on the public network.

<Sysname> display igmp interface gigabitethernet 1/0/1 verbose

 GigabitEthernet1/0/1(10.10.1.20):

   IGMP is enabled.

   IGMP version: 2

   Query interval for IGMP: 125s

   Other querier present time for IGMP: 255s

   Maximum query response time for IGMP: 10s

   Last member query interval: 1s

   Last member query count: 2

   Startup query interval: 31s

   Startup query count: 2

   General query timer expiry (hh:mm:ss): 00:00:54

   Querier for IGMP: 10.10.1.20 (This router)

   IGMP activity: 1 join(s), 0 leave(s)

   Multicast routing on this interface: Enabled

   Robustness: 2

   Require-router-alert: Disabled

   Fast-leave: Disabled

   Startup-query: Off

   Other-querier-present-timer-expiry (hh:mm:ss): Off

   Authorization: Disabled

   Join-by-session: Disabled

   User-VLAN-aggregation: Disabled

  IGMP groups reported in total: 1

# Display detailed IGMP information for all IGMP proxy interfaces on the public network.

<Sysname> display igmp interface proxy verbose

 GigabitEthernet1/0/2(20.10.1.20):

   IGMP proxy is enabled.

   IGMP version: 2

   Multicast routing on this interface: Enabled

   Require-router-alert: Disabled

   Version1-querier-present-timer-expiry (hh:mm:ss): Off

Table 26 Command output

Field

Description

GigabitEthernet1/0/1(10.10.1.20)

Interface and its IP address. (on a router)

IGMP is enabled

IGMP is enabled on the interface.

IGMP version

Version of IGMP that the interface runs.

Query interval for IGMP

IGMP general query interval, in seconds.

Other querier present time for IGMP

IGMP other querier present interval, in seconds.

Maximum query response time for IGMP

Maximum response time for IGMP general queries, in seconds.

Last member query interval

Interval for sending IGMP group-specific queries or IGMP group-and-source-specific queries, in seconds.

Last member query count

Number of IGMP group-specific queries or IGMP group-and-source-specific queries sent for the multicast group.

Startup query interval

Interval for sending IGMP general queries on startup, in seconds.

Startup query count

Number of IGMP general queries that the device sends on startup.

General query timer expiry

Remaining time for the IGMP general query timer. This field displays Off if the timer is disabled.

Querier for IGMP

IP address of the IGMP querier.

This field is not displayed when the device runs IGMPv1 and the device is not the IGMP querier.

NOTE:

In IGMPv1, the PIM DR acts as the IGMP querier. You can use the display pim interface command to display PIM information.

No querier elected

No IGMP querier election is performed.

This field is displayed when the device runs IGMPv1 and is not the IGMP querier.

NOTE:

In IGMPv1, the PIM DR acts as the IGMP querier. You can use the display pim interface command to display PIM information.

IGMP activity: 1 join(s), 0 leave(s)

Statistics of IGMP activities:

·         join(s)—Total number of multicast groups that this interface has joined.

·         leave(s)—Total number of multicast groups that this interface has left.

Multicast routing on this interface

Whether IP multicast routing is enabled: Enabled or Disabled.

Robustness

Robustness variable of the IGMP querier.

Require-router-alert

Whether the feature of dropping IGMP messages without Router-Alert is enabled: Enabled or Disabled,

Fast-leave

Whether the fast-leave processing feature is enabled: Enabled or Disabled.

Startup-query

Whether the IGMP querier sends IGMP general queries at the startup query interval on startup:

·         OnThe IGMP querier performs the above action.

·         OffThe IGMP querier does not perform the above action.

Other-querier-present-timer-expiry

Remaining time for the other querier present timer. This field displays Off if the timer is disabled.

IGMP groups reported in total

Total number of multicast groups that the interface has joined dynamically.

This field is not displayed if the interface does not join multicast groups.

IGMP proxy is enabled

IGMP proxying is enabled on the interface.

Version1-querier-present-timer-expiry

Remaining time for the IGMPv1 querier present timer. This field displays Off if the timer is disabled.

 

display igmp proxy group

Use display igmp proxy group to display information about multicast groups maintained by the IGMP proxy.

Syntax

display igmp [ vpn-instance vpn-instance-name ] proxy group [ group-address | interface interface-type interface-number ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays information about multicast groups maintained by the IGMP proxy on the public network.

group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255. If you do not specify a multicast group, the command displays information about all multicast groups maintained by the IGMP proxy.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, the command displays information about multicast groups maintained by the IGMP proxy for all interfaces.

verbose: Displays detailed information.

Examples

# Display information about multicast groups maintained by the IGMP proxy on the public network.

<Sysname> display igmp proxy group

IGMP proxy group records in total: 2

 GigabitEthernet1/0/1(1.1.1.20):

  IGMP proxy group records in total: 2

   Group address      Member state      Expires

   225.1.1.1          Delay             00:00:02

   225.1.1.2          Idle              Off

# Display detailed information about multicast group 225.1.1.1 maintained by the IGMP proxy on the public network.

<Sysname> display igmp proxy group 225.1.1.1 verbose

 GigabitEthernet1/0/1(1.1.1.20):

  IGMP proxy group records in total: 2

   Group: 225.1.1.1

     Group mode: Include

     Member state: Delay

     Expires: 00:00:02

     Source list (sources in total: 1):

       1.1.1.1

Table 27 Command output

Field

Description

IGMP groups records in total

Total number of multicast groups maintained by the IGMP proxy.

GigabitEthernet1/0/1(1.1.1.20)

IGMP proxy interface and its IP address. (on a router)

Pending proxy group

Pending multicast groups maintained by the IGMP proxy.

Group address/Group

Multicast group address.

Member state

Member host states:

·         Delay—The member host has joined a group and started a delay timer.

·         Idle—The member host has joined a group, but didn't start a delay timer.

Expires

Remaining delay time for the member host to send a responding report. This field displays Off if the timer is disabled.

Group mode

Multicast source filtering mode: Include or Exclude.

Source list

Multicast source list for the multicast group maintained by the IGMP proxy.

sources in total

Total number of multicast sources.

 

display igmp proxy routing-table

Use display igmp proxy routing-table to display multicast routing entries maintained by the IGMP proxy.

Syntax

display igmp [ vpn-instance vpn-instance-name ] proxy routing-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] ] * [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays multicast routing entries maintained by the IGMP proxy on the public network.

source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, the command displays multicast routing entries for all multicast sources maintained by the IGMP proxy.

group-address: Specifies a multicast group address by its IP address in the range of 224.0.1.0 to 239.255.255.255. If you do not specify a multicast group, the command displays multicast routing entries for all multicast groups maintained by the IGMP proxy.

mask-length: Specifies a mask length of the multicast group address or multicast source address. For a multicast source address, the value range for this argument is 0 to 32. For a multicast group address, the value range for this argument is 4 to 32. The default value is 32 in both cases.

mask: Specifies a mask of the multicast group address or multicast source address. The default value is 255.255.255.255.

verbose: Displays detailed information about multicast routing entries maintained by the IGMP proxy.

Examples

# Display multicast routing entries maintained by the IGMP proxy on the public network.

<Sysname> display igmp proxy routing-table

 Total 1 (*, G) entries, 2 (S, G) entries.

 

 (172.168.0.12, 227.0.0.1)

     Upstream interface: GigabitEthernet1/0/1

     Downstream interfaces (1 in total):

         1: GigabitEthernet1/0/2

             Protocol: IGMP

 

(*, 225.1.1.1)

     Upstream interface: GigabitEthernet1/0/1

     Downstream interfaces (1 in total):

         1: GigabitEthernet1/0/2

             Protocol: STATIC

 

  (2.2.2.2, 225.1.1.1)

     Upstream interface: GigabitEthernet1/0/1

     Downstream interfaces (2 in total):

         1: LoopBack1

             Protocol: STATIC

         2: GigabitEthernet1/0/2

             Protocol: PROXY

# Display detailed information about multicast routing entries maintained by the IGMP proxy on the public network.

<Sysname> display igmp proxy routing-table verbose

 Total 1 (*, G) entries, 2 (S, G) entries.

 

 (172.168.0.12, 227.0.0.1)

     Upstream interface: GigabitEthernet1/0/1

     Downstream interfaces (1 in total):

         1: GigabitEthernet1/0/2

             Protocol: IGMP

             Querier state: Querier

             Join/Prune state:Join

 

     Non-downstream interfaces: None

 

 (*, 225.1.1.1)

     Upstream interface: GigabitEthernet1/0/1

     Downstream interfaces (1 in total):

         1: GigabitEthernet1/0/2

             Protocol: STATIC

             Querier state: Querier

             Join/Prune state:Join

 

     Non-downstream interfaces (1 in total):

         1: GigabitEthernet1/0/2

             Protocol: IGMP

             Querier state: Non-querier

             Join/Prune state:Join

 

(2.2.2.2, 225.1.1.1)

     Upstream interface: GigabitEthernet1/0/1

     Downstream interfaces (2 in total):

         1: LoopBack1

             Protocol: STATIC

             Querier state: Querier

             Join/Prune state: Join

         2: GigabitEthernet1/0/2

             Protocol: PROXY

             Querier state: Querier

             Join/Prune state: Join

 

     Non-downstream interfaces: None

Table 28 Command output

Field

Description

Total 1 (*, G) entries, 2 (S, G) entries

Total number of (*, G) entries, and the total number of (S, G) entries.

(172.168.0.12, 227.0.0.1)

(S, G) entry.

Upstream interface

Incoming interface of the (S, G) entry.

Downstream interfaces (1 in total)

Outgoing interfaces of the (S, G) entry, and the total number of outgoing interfaces.

Non-downstream interfaces (1 in total)

Non-outgoing interfaces of the (S, G) entry, and the total number of non-outgoing interfaces.

1: GigabitEthernet1/0/2

Index of an interface, and the interface. (on a router)

Protocol

Protocol type:

·         IGMP—Dynamic IGMP.

·         PROXY—IGMP proxy.

·         STATIC—Static IGMP.

Querier state

Querier state:

·         Querier.

·         Non-querier.

Join/Prune state

Joined or pruned state of the interface:

·         NI—Default state.

·         Join—Joined state.

·         Prune—Pruned state.

 

display igmp ssm-mapping

Use display igmp ssm-mapping to display IGMP SSM mappings.

Syntax

display igmp [ vpn-instance vpn-instance-name ] ssm-mapping group-address

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays information about the IGMP SSM mappings on the public network.

group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255.

Examples

# Display IGMP SSM mappings for multicast group 232.1.1.1 on the public network.

<Sysname> display igmp ssm-mapping 232.1.1.1

 Group: 232.1.1.1

 Source list:

        1.2.3.4

        5.5.5.5

        10.1.1.1

        100.1.1.10

Table 29  Command output

Field

Description

Group

Multicast group address.

Source list

List of multicast source addresses.

 

igmp

Use igmp to enter IGMP view.

Use undo igmp to delete the configurations in IGMP view.

Syntax

igmp [ vpn-instance vpn-instance-name ]

undo igmp [ vpn-instance vpn-instance-name ]

Views

System view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command applies to the public network.

Examples

# Enter IGMP view for the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp]

# Enter IGMP view for VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn]

igmp enable

Use igmp enable to enable IGMP on an interface.

Use undo igmp enable to disable IGMP on an interface.

Syntax

igmp enable

undo igmp enable

Default

IGMP is disabled on an interface.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

This command takes effect only when IP multicast routing is enabled on the public network or for the VPN instance to which the interface belongs.

Other IGMP configurations on the interface take effects only when IGMP is enabled on the interface.

Examples

# Enable IP multicast routing on the public network, and enable IGMP on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp enable

Related commands

multicast routing

igmp fast-leave

Use igmp fast-leave to enable fast-leave processing on an interface.

Use undo igmp fast-leave to disable fast-leave processing on an interface.

Syntax

igmp fast-leave [ group-policy ipv4-acl-number ]

undo igmp fast-leave

Default

Fast-leave processing is disabled. The IGMP querier sends IGMP group-specific or group-and-source-specific queries after receiving a leave message.

Views

Interface view

Predefined user roles

network-admin

Parameters

ipv4-acl-number: Specifies an IPv4 basic ACL by its number in the range of 2000 to 2999. If you specify an ACL, the fast-leave processing feature takes effect only on the multicast groups that the ACL permits. The feature takes effect on all multicast groups when one of the following conditions exists:

·          You do not specify an ACL.

·          The specified ACL does not exist.

·          The specified ACL does not have valid rules.

Usage guidelines

This feature enables an IGMP querier to send leave notifications to the upstream routers without sending group-specific or group-and-source-specific queries after receiving leave messages.

When you configure a rule in the IPv4 basic ACL, follow these restrictions and guidelines:

·          For the rule to take effect, do not specify the vpn-instance vpn-instance option.

·          The source source-address source-wildcard option specifies a multicast group address.

·          Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

Examples

# Enable fast-leave processing on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp fast-leave

igmp group-policy

Use igmp group-policy to configure a multicast group policy on an interface to control the multicast groups that hosts attached to the interface can join.

Use undo igmp group-policy to delete all multicast group polices.

Syntax

igmp group-policy ipv4-acl-number [ version-number ]

undo igmp group-policy

Default

No multicast group policies exist on an interface, and hosts attached to the interface can join any multicast groups.

Views

Interface view

Predefined user roles

network-admin

Parameters

ipv4-acl-number: Specifies an IPv4 basic or advanced ACL by its number in the range of 2000 to 3999. Hosts can join only the multicast groups that the ACL permits. If the ACL does not exist or does not have valid rules, hosts cannot join any multicast groups.

version-number: Specifies an IGMP version in the range of 1 to 3. By default, this command takes effect on IGMP reports of all versions.

Usage guidelines

A multicast group policy control the multicast groups that the hosts can join by filtering IGMP messages. It does not take effect on a static member interface, because a static member interface does not send IGMP messages.

When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:

·          For the rule to take effect, do not specify the vpn-instance vpn-instance option.

·          In a basic ACL, the source source-address source-wildcard option specifies a multicast group address.

·          In an advanced ACL, the source source-address source-wildcard option specifies a multicast source address. The destination dest-address dest-wildcard option specifies a multicast group address.

To match the following IGMP reports, set the source source-address source-wildcard option to 0.0.0.0:

?  IGMPv1 and IGMPv2 reports.

?  IGMPv3 IS_EX and IGMPv3 TO_EX reports that do not carry multicast source addresses.

·          Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

Examples

# Configure a multicast group policy on GigabitEthernet 1/0/1 so that hosts attached to the interface can join only multicast group 225.1.1.1.

<Sysname> system-view

[Sysname] acl basic 2005

[Sysname-acl-ipv4-basic-2005] rule permit source 225.1.1.1 0

[Sysname-acl-ipv4-basic-2005] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp group-policy 2005

igmp last-member-query-count

Use igmp last-member-query-count to set the IGMP last member query count on an interface.

Use undo igmp last-member-query-count to restore the default.

Syntax

igmp last-member-query-count count

undo igmp last-member-query-count

Default

The IGMP last member query count equals the IGMP querier's robustness variable.

Views

Interface view

Predefined user roles

network-admin

Parameters

count: Specifies an IGMP last member query count in the range of 1 to 255.

Usage guidelines

You can set the IGMP last member query count for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the IGMP last member query count to 6 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp last-member-query-count 6

Related commands

last-member-query-count (IGMP view)

igmp last-member-query-interval

Use igmp last-member-query-interval to set the IGMP last member query interval on an interface.

Use undo igmp last-member-query-interval to restore the default.

Syntax

igmp last-member-query-interval interval

undo igmp last-member-query-interval

Default

The IGMP last member query interval is 1 second.

Views

Interface view

Predefined user roles

network-admin

Parameters

interval: Specifies an IGMP last member query interval in the range of 1 to 25 seconds.

Usage guidelines

You can set the IGMP last member query interval for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the IGMP last member query interval to 6 seconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp last-member-query-interval 6

Related commands

last-member-query-interval (IGMP view)

igmp max-response-time

Use igmp max-response-time to set the maximum response time for IGMP general queries on an interface.

Use undo igmp max-response-time to restore the default.

Syntax

igmp max-response-time time

undo igmp max-response-time

Default

The maximum response time for IGMP general queries is 10 seconds.

Views

Interface view

Predefined user roles

network-admin

Parameters

time: Specifies the maximum response time for IGMP general queries, in the range of 1 to 3174 seconds.

Usage guidelines

You can set the maximum response time for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the maximum response time for IGMP general queries to 25 seconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp max-response-time 25

Related commands

max-response-time (IGMP view)

igmp non-stop-routing

Use igmp non-stop-routing to enable IGMP NSR.

Use undo igmp non-stop-routing to disable IGMP NSR.

Syntax

igmp non-stop-routing

undo igmp non-stop-routing

Default

IGMP NSR is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

The following matrix shows the command and hardware compatibility:

 

Hardware

Command compatibility

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK/810-LMS/810-LUS

No

MSR2600-6-X1/2600-10-X1

No

MSR 2630

Yes

MSR3600-28/3600-51

Yes

MSR3600-28-SI/3600-51-SI

No

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC

Yes

MSR 3610/3620/3620-DP/3640/3660

Yes

MSR5620/5660/5680

Yes

 

Hardware

Command compatibility

MSR810-LM-GL

No

MSR810-W-LM-GL

No

MSR830-6EI-GL

No

MSR830-10EI-GL

No

MSR830-6HI-GL

No

MSR830-10HI-GL

No

MSR2600-6-X1-GL

No

MSR3600-28-SI-GL

No

 

Examples

# Enable IGMP NSR.

<Sysname> system-view

[Sysname] igmp non-stop-routing

igmp other-querier-present-interval

Use igmp other-querier-present-interval to set the IGMP other querier present timer on an interface.

Use undo igmp other-querier-present-interval to restore the default.

Syntax

igmp other-querier-present-interval interval

undo igmp other-querier-present-interval

Default

The IGMP other querier present timer is calculated by using the following formula:

[ IGMP general query interval ] × [ IGMP querier's robustness variable ] + [ maximum response time for IGMP general queries ] / 2.

Views

Interface view

Predefined user roles

network-admin

Parameters

interval: Specifies an IGMP other querier present timer in the range of 1 to 31744 seconds.

Usage guidelines

You can set the IGMP other querier present timer for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the IGMP other querier present timer to 125 seconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp other-querier-present-interval 125

Related commands

other-querier-present-interval (IGMP view)

igmp proxy enable

Use igmp proxy enable to enable IGMP proxying on an interface.

Use to undo igmp proxy enable to disable IGMP proxying on an interface.

Syntax

igmp proxy enable

undo igmp proxy enable

Default

IGMP proxying is disabled on an interface.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

This command takes effect only when IP multicast routing is enabled on the public network or for the VPN instance to which the interface belongs.

Examples

# Enable IP multicast routing on the public network, and enable IGMP proxying on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp proxy enable

Related commands

multicast routing

igmp proxy forwarding

Use igmp proxy forwarding to enable multicast forwarding on a non-querier interface.

Use undo igmp proxy forwarding to disable multicast forwarding on a non-querier interface.

Syntax

igmp proxy forwarding

undo igmp proxy forwarding

Default

Multicast forwarding is disabled for a non-querier interface.

Views

Interface view

Predefined user roles

network-admin

Usage guidelines

Typically, only IGMP queriers can forward multicast traffic but non-queriers cannot. This mechanism prevents multicast data from being repeatedly forwarded. If a router interface on the IGMP proxy failed the querier election, enable multicast forwarding on the interface to forward multicast data to attached receivers.

Examples

# Enable multicast forwarding on GigabitEthernet 1/0/1. (GigabitEthernet 1/0/1 is a non-querier interface on the IGMP proxy device.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp proxy forwarding

igmp query-interval

Use igmp query-interval to set the IGMP general query interval on an interface.

Use undo igmp query-interval to restore the default.

Syntax

igmp query-interval interval

undo igmp query-interval

Default

The IGMP general query interval is 125 seconds.

Views

Interface view

Predefined user roles

network-admin

Parameters

interval: Specifies an IGMP general query interval in the range of 1 to 31744 seconds.

Usage guidelines

You can set the IGMP general query interval for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the IGMP general query interval to 60 seconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp query-interval 60

Related commands

query-interval (IGMP view)

igmp robust-count

Use igmp robust-count to set the IGMP querier's robustness variable on an interface.

Use undo igmp robust-count to restore the default.

Syntax

igmp robust-count count

undo igmp robust-count

Default

The IGMP querier's robustness variable is 2.

Views

Interface view

Predefined user roles

network-admin

Parameters

count: Specifies an IGMP querier's robustness variable in the range of 1 to 255.

Usage guidelines

The IGMP querier's robustness variable defines the number of times to retransmit queries if packet loss occurs. A higher robustness variable makes the IGMP querier more robust, but it increases timeout time for multicast groups.

You can set the IGMP querier's robustness variable for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the IGMP querier's robustness variable to 5 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp robust-count 5

Related commands

robust-count (IGMP view)

igmp startup-query-count

Use igmp startup-query-count to set the IGMP startup query count on an interface.

Use undo igmp startup-query-count to restore the default.

Syntax

igmp startup-query-count count

undo igmp startup-query-count

Default

The IGMP startup query count equals the IGMP querier's robustness variable.

Views

Interface view

Predefined user roles

network-admin

Parameters

count: Specifies an IGMP startup query count in the range of 1 to 255.

Usage guidelines

You can set the IGMP startup query count for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the IGMP startup query count to 5 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp startup-query-count 5

Related commands

startup-query-count (IGMP view)

igmp startup-query-interval

Use igmp startup-query-interval to set the IGMP startup query interval on an interface.

Use undo igmp startup-query-interval to restore the default.

Syntax

igmp startup-query-interval interval

undo igmp startup-query-interval

Default

The IGMP startup query interval equals one quarter of the IGMP general query interval.

Views

Interface view

Predefined user roles

network-admin

Parameters

interval: Specifies an IGMP startup query interval in the range of 1 to 31744 seconds.

Usage guidelines

You can set the IGMP startup query interval for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the IGMP startup query interval to 100 seconds on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp startup-query-interval 100

Related commands

startup-query-interval (IGMP view)

igmp static-group

Use igmp static-group to configure an interface as a static group member of a multicast group.

Use undo igmp static-group to restore the default.

Syntax

igmp static-group group-address [ source source-address ]

undo igmp static-group { all | group-address [ source source-address ]

Default

An interface is not a static group member of multicast groups.

Views

Interface view

Predefined user roles

network-admin

Parameters

group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255.

source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, the command configures an interface as a static member of the multicast groups with all multicast source addresses.

all: Specifies all multicast groups that the interface has statically joined.

Usage guidelines

For multicast routing entries to be created, you must specify a multicast source if the specified multicast group is in the SSM group range.

Examples

# Configure GigabitEthernet 1/0/1 as a static group member of multicast group 224.1.1.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp static-group 224.1.1.1

# Configure GigabitEthernet 1/0/1 as a static group member of multicast source and group (192.168.1.1, 232.1.1.1).

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp static-group 232.1.1.1 source 192.168.1.1

# Enable per-session multicast forwarding on GigabitEthernet 1/0/1.1. Configure the subinterface as a static group member of multicast group 224.1.1.1 for users with outer VLAN ID 10 and inner VLAN IDs in the range of 10 to 20.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1.1

[Sysname-GigabitEthernet1/0/1.1] igmp join-by-session

[Sysname-GigabitEthernet1/0/1.1] igmp static-group 224.1.1.1 dot1q vid 10 second-dot1q 10 to 20

igmp version

Use igmp version to specify an IGMP version on an interface.

Use undo igmp version to restore the default.

Syntax

igmp version version-number

undo igmp version

Default

The IGMP version on an interface is 2.

Views

Interface view

Predefined user roles

network-admin

Parameters

version-number: Specifies an IGMP version in the range of 1 to 3.

Examples

# Specify IGMP version 1 on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp version 1

last-member-query-count (IGMP view)

Use last-member-query-count to set the IGMP last member query count globally.

Use undo last-member-query-count to restore the default.

Syntax

last-member-query-count count

undo last-member-query-count

Default

The IGMP last member query count equals the IGMP querier's robustness variable.

Views

IGMP view

Predefined user roles

network-admin

Parameters

count: Specifies an IGMP last member query count in the range of 1 to 255.

Usage guidelines

You can set the IGMP last member query count globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP last member query count to 6 on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] last-member-query-count 6

Related commands

igmp last-member-query-count

last-member-query-interval (IGMP view)

Use last-member-query-interval to set the IGMP last member query interval globally.

Use undo last-member-query-interval to restore the default.

Syntax

last-member-query-interval interval

undo last-member-query-interval

Default

The IGMP last member query interval is 1 second.

Views

IGMP view

Predefined user roles

network-admin

Parameters

interval: Specifies an IGMP last member query interval in the range of 1 to 25 seconds.

Usage guidelines

You can set the IGMP last member query interval globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP last member query interval to 6 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] last-member-query-interval 6

Related commands

igmp last-member-query-interval

max-response-time (IGMP view)

Use max-response-time to set the maximum response time for IGMP general queries globally.

Use undo max-response-time to restore the default.

Syntax

max-response-time time

undo max-response-time

Default

The maximum response time for IGMP general queries is 10 seconds.

Views

IGMP view

Predefined user roles

network-admin

Parameters

time: Specifies the maximum response time for IGMP general queries in the range of 1 to 3174 seconds.

Usage guidelines

You can set the maximum response time globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

#Set the global maximum response time for IGMP general queries to 25 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] max-response-time 25

Related commands

igmp max-response-time

other-querier-present-interval (IGMP view)

Use other-querier-present-interval to set the IGMP other querier present timer globally.

Use undo other-querier-present-interval to restore the default.

Syntax

other-querier-present-interval interval

undo other-querier-present-interval

Default

The IGMP other querier present timer is calculated by using the following formula:

[ IGMP general query interval ] × [ IGMP querier's robustness variable ] + [ maximum response time for IGMP general queries ] / 2.

Views

IGMP view

Predefined user roles

network-admin

Parameters

interval: Specifies an IGMP other querier present timer in the range of 1 to 31744 seconds.

Usage guidelines

You can set the IGMP other querier present timer globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP other querier present timer to 125 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] other-querier-present-interval 125

Related commands

igmp other-querier-present-interval

proxy multipath (IGMP view)

Use proxy multipath to enable load splitting on an IGMP proxy device.

Use undo proxy multipath to disable load splitting on an IGMP proxy device.

Syntax

proxy multipath

undo proxy multipath

Default

The load splitting feature is disabled on the IGMP proxy device.

Views

IGMP view

Predefined user roles

network-admin

Usage guidelines

Use this feature when the IGMP proxy device has multiple proxy interfaces. All proxy interfaces on the IGMP proxy device share multicast traffic on a per-group basis. If you do not enable this feature, only the proxy interface with the highest IP address forwards multicast data.

Examples

# Enable load splitting on the IGMP proxy device on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] proxy multipath

query-interval (IGMP view)

Use query-interval to set the IGMP general query interval globally.

Use undo query-interval to restore the default.

Syntax

query-interval interval

undo query-interval

Default

The IGMP general query interval is 125 seconds.

Views

IGMP view

Predefined user roles

network-admin

Parameters

interval: Specifies an IGMP general query interval in the range of 1 to 31744 seconds.

Usage guidelines

You can set the IGMP general query interval globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP general query interval to 60 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] query-interval 60

Related commands

igmp query-interval

reset igmp group

Use reset igmp group to clear dynamic IGMP multicast group entries.

Syntax

reset igmp [ vpn-instance vpn-instance-name ] group { all | interface interface-type interface-number { all | group-address [ mask { mask | mask-length } ] [ source-address [ mask { mask | mask-length } ] ] } }

Views

User view

Predefined user roles

network-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command clears dynamic IGMP multicast group entries on the public network.

all: Specifies all interfaces (the first all), or all IGMP multicast groups (the second all).

interface-type interface-number: Specifies an interface by its type and number.

group-address: Specifies a multicast group by its IP address in the range of 224.0.0.0 to 239.255.255.255.

source-address: Specifies a multicast source address. If you do not specify a multicast source, the command deletes dynamic IGMP multicast group entries for all multicast source addresses.

mask: Specifies an address mask. The default is 255.255.255.255.

mask-length: Specifies an address mask length. The default is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.

Usage guidelines

This command might interrupt the multicast information transmission.

Examples

# Clear dynamic IGMP multicast group entries for all interfaces on the public network.

<Sysname> reset igmp group all

# Clear all dynamic IGMP multicast group entries for GigabitEthernet 1/0/1 on the public network.

<Sysname> reset igmp group interface gigabitethernet 1/0/1 all

# Clear the dynamic IGMP multicast group entry of the group 225.0.0.1 for GigabitEthernet 1/0/1 on the public network.

<Sysname> reset igmp group interface gigabitethernet 1/0/1 225.0.0.1

Related commands

display igmp group

robust-count (IGMP view)

Use robust-count to set the IGMP querier's robustness variable globally.

Use undo robust-count to restore the default.

Syntax

robust-count count

undo robust-count

Default

The IGMP querier's robustness variable is 2.

Views

IGMP view

Predefined user roles

network-admin

Parameters

count: Specifies an IGMP querier's robustness variable in the range of 1 to 255.

Usage guidelines

The IGMP querier's robustness variable defines the number of times to retransmit queries if packet loss occurs. A higher robustness variable makes the IGMP querier more robust, but it increases the timeout time for multicast groups.

You can set the IGMP querier's robustness variable globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP querier's robustness variable to 5 on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] robust-count 5

Related commands

igmp robust-count

ssm-mapping (IGMP view)

Use ssm-mapping to configure an IGMP SSM mapping.

Use undo ssm-mapping to delete IGMP SSM mappings.

Syntax

ssm-mapping source-address ipv4-acl-number

undo ssm-mapping { source-address | all }

Default

No IGMP SSM mappings exist.

Views

IGMP view

Predefined user roles

network-admin

Parameters

source-address: Specifies a multicast source by its IP address.

ipv4-acl-number: Specifies a basic ACL number in the range of 2000 to 2999. In IGMP SSM mappings, the specified multicast source is associated with multicast groups that the ACL permits. The multicast source is not associated with any multicast groups if the ACL does not exist or does not have valid rules.

all: Specifies all IGMP SSM mappings.

Usage guidelines

When you configure a rule in the IPv4 basic ACL, follow these restrictions and guidelines:

·          For the rule to take effect, do not specify the vpn-instance vpn-instance option.

·          The source source-address source-wildcard option specifies a multicast group address.

·          Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

Examples

# Configure an IGMP SSM mapping with multicast source 125.1.1.1 and multicast group range 232.1.1.0/24.

<Sysname> system-view

[Sysname] acl basic 2001

[Sysname-acl-ipv4-basic-2001] rule permit source 232.1.1.1 0.0.0.255

[Sysname-acl-ipv4-basic-2001] quit

[Sysname] igmp

[Sysname-igmp] ssm-mapping 125.1.1.1 2001

Related commands

display igmp ssm-mapping

startup-query-count (IGMP view)

Use startup-query-count to set the IGMP startup query count globally.

Use undo startup-query-count to restore the default.

Syntax

startup-query-count count

undo startup-query-count

Default

The IGMP startup query count equals the IGMP querier's robustness variable.

Views

IGMP view

Predefined user roles

network-admin

Parameters

count: Specifies an IGMP startup query count in the range of 1 to 255.

Usage guidelines

You can set the IGMP startup query count globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP startup query count to 5 on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] startup-query-count 5

Related commands

igmp startup-query-count

startup-query-interval (IGMP view)

Use startup-query-interval to set the IGMP startup query interval globally.

Use undo startup-query-interval to restore the default.

Syntax

startup-query-interval interval

undo startup-query-interval

Default

The IGMP startup query interval equals one quarter of the IGMP general query interval.

Views

IGMP view

Predefined user roles

network-admin

Parameters

interval: Specifies an IGMP startup query interval in the range of 1 to 31744 seconds.

Usage guidelines

You can set the IGMP startup query interval globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP startup query interval to 100 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] startup-query-interval 100

Related commands

igmp startup-query-interval


PIM commands

The following matrix shows the feature and hardware compatibility:

 

Hardware

PIM compatibility

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK

Yes

MSR810-LMS/810-LUS

No

MSR2600-6-X1/2600-10-X1

Yes

MSR 2630

Yes

MSR3600-28/3600-51

Yes

MSR3600-28-SI/3600-51-SI

No

MSR 3610/3620/3620-DP/3640/3660

Yes

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC

Yes

MSR5620/5660/5680

Yes

 

Hardware

PIM compatibility

MSR810-LM-GL

Yes

MSR810-W-LM-GL

Yes

MSR830-6EI-GL

Yes

MSR830-10EI-GL

Yes

MSR830-6HI-GL

Yes

MSR830-10HI-GL

Yes

MSR2600-6-X1-GL

Yes

MSR3600-28-SI-GL

No

 

anycast rp (PIM view)

Use anycast-rp to configure an Anycast RP.

Use undo anycast-rp to remove an Anycast RP.

Syntax

anycast-rp anycast-rp-address member-address

undo anycast-rp anycast-rp-address member-address

Default

No Anycast RPs exist.

Views

PIM view

Predefined user roles

network-admin

Parameters

anycast-rp-address: Specify an Anycast RP address. It must be a legal unicast IP address that is not in the range of 127.0.0.0/8.

member-address: Specify an Anycast RP member address. It must be a legal unicast IP address that is not in the range of 127.0.0.0/8.

Usage guidelines

To add multiple RP member addresses to an Anycast RP set, use this command repeatedly with the same Anycast RP address but different RP member addresses.

An RP member address must be different from the Anycast RP address.

Examples

# On the public network, specify 1.1.0.0 as the Anycast RP address, and specify 1.1.0.1 and 1.2.0.1 as the member addresses.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] anycast-rp 1.1.0.0 1.1.0.1

[Sysname-pim] anycast-rp 1.1.0.0 1.2.0.1

Related commands

display pim rp-info

auto-rp enable (PIM view)

Use auto-rp enable to enable Auto-RP listening.

Use undo auto-rp enable to disable Auto-RP listening.

Syntax

auto-rp enable

undo auto-rp enable

Default

Auto-RP listening is disabled.

Views

PIM view

Predefined user roles

network-admin

Examples

# Enable Auto-RP listening on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] auto-rp enable

bidir-pim enable (PIM view)

Use bidir-pim enable to enable BIDIR-PIM.

Use undo bidir-pim enable to disable BIDIR-PIM.

Syntax

bidir-pim enable

undo bidir-pim enable

Default

BIDIR-PIM is disabled.

Views

PIM view

Predefined user roles

network-admin

Usage guidelines

This command takes effect only when IP multicast routing is enabled.

Examples

# Enable IP multicast routing on the public network, and enable BIDIR-PIM.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] pim

[Sysname-pim] bidir-pim enable

Related commands

multicast routing

bidir-rp-limit (PIM view)

Use bidir-rp-limit to set the maximum number of BIDIR-PIM RPs.

Use undo bidir-rp-limit to restore the default.

Syntax

bidir-rp-limit limit

undo bidir-rp-limit

Default

The upper limit is 6.

Views

PIM view

Predefined user roles

network-admin

Parameters

limit: Specifies the maximum number of RPs in BIDIR-PIM, in the range of 1 to the number allowed by the system.

The following matrix shows the limit argument and hardware compatibility:

 

Hardware

Argument compatibility

Value range

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-10-PoE/810-LM-HK/810-W-LM-HK

Yes

1 to 64

MSR810-LMS/810-LUS

No

N/A

MSR2600-6-X1/2600-10-X1

Yes

1 to 64

MSR 2630

Yes

1 to 64

MSR3600-28/3600-51

Yes

1 to 64

MSR3600-28-SI/3600-51-SI

No

N/A

MSR3610-X1/3610-X1-DP/3610-X1-DC/3610-X1-DP-DC

Yes

1 to 128

MSR 3610/3620/3620-DP/3640/3660

Yes

1 to 128

MSR5620/5660/5680

Yes

1 to 256

 

Hardware

Argument compatibility

Value range

MSR810-LM-GL

Yes

1 to 64

MSR810-W-LM-GL

Yes

1 to 64

MSR830-6EI-GL

Yes

1 to 64

MSR830-10EI-GL

Yes

1 to 64

MSR830-6HI-GL

Yes

1 to 64

MSR830-10HI-GL

Yes

1 to 64

MSR2600-6-X1-GL

Yes

1 to 64

MSR3600-28-SI-GL

No

N/A

 

Usage guidelines

In a BIDIR-PIM domain, one DF election per RP is implemented on all PIM interfaces. As a best practice to avoid unnecessary DF elections, do not configure multiple BIDIR-PIM RPs.

This command sets a limit on the number of BIDIR-PIM RPs. If the number of RPs exceeds the limit, excess RPs can be used only for DF election rather than multicast data forwarding.

Examples

# Set the maximum number of BIDIR-PIM RPs to 3 on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] bidir-rp-limit 3

bsm-fragment enable (PIM view)

Use bsm-fragment enable to enable bootstrap message (BSM) semantic fragmentation.

Use undo bsm-fragment enable to disable BSM semantic fragmentation.

Syntax

bsm-fragment enable

undo bsm-fragment enable

Default

BSM semantic fragmentation is enabled.

Views

PIM view

Predefined user roles

network-admin

Usage guidelines

Disable BSM semantic fragmentation if the PIM-SM or BIDIR-PIM domain contains a device that does not support BSM semantic fragmentation.

Examples

# Disable BSM semantic fragmentation on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] undo bsm-fragment enable

bsm-reflection enable (PIM view)

Use bsm-reflection enable to enable the device to forward BSMs out of incoming interfaces.

Use undo bsm-reflection enable to disable the device to forward BSMs out of incoming interfaces.

Syntax

bsm-reflection enable

undo bsm-reflection enable

Default

The device is enabled to forward BSMs out of incoming interfaces.

Views

PIM view

Predefined user roles

network-admin

Usage guidelines

Disable this feature if all the devices in the PIM-SM or BIDIR-PIM domain have consistent routing information.

Examples

# Disable the device to forward BSMs out of incoming interfaces on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] undo bsm-reflection enable

bsr-policy (PIM view)

Use bsr-policy to configure a BSR policy to guard against BSR spoofing.

Use undo bsr-policy to restore the default.

Syntax

bsr-policy ipv4-acl-number

undo bsr-policy

Default

No BSR policies exist, and all bootstrap messages are regarded as legal.

Views

PIM view

Predefined user roles

network-admin

Parameters

ipv4-acl-number: Specifies an IPv4 basic ACL by its number in the range of 2000 to 2999.

Usage guidelines

When you configure a rule in the IPv4 basic ACL, follow these restrictions and guidelines:

·          For the rule to take effect, do not specify the vpn-instance vpn-instance option.

·          The source source-address source-wildcard option specifies a BSR address.

·          Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

Examples

# On the public network, configure a BSR policy so that only the devices on the subnet of 10.1.1.0/24 can act as the BSR.

<Sysname> system-view

[Sysname] acl basic 2000

[Sysname-acl-ipv4-basic-2000] rule permit source 10.1.1.0 0.0.0.255

[Sysname-acl-ipv4-basic-2000] quit

[Sysname] pim

[Sysname-pim] bsr-policy 2000

Related commands

c-bsr (PIM view)

c-bsr (PIM view)

Use c-bsr to configure a candidate-BSR (C-BSR).

Use undo c-bsr to remove the configuration of a C-BSR.

Syntax

c-bsr ip-address [ scope group-address { mask-length | mask } ] [ hash-length hash-length | priority priority ] *

undo c-bsr ip-address [ scope group-address { mask-length | mask } ]

Default

No C-BSRs exist.

Views

PIM view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the IP address of a C-BSR. You must specify the IP address of a local PIM interface.

scope group-address: Specifies a multicast group by its IP address in the range of 239.0.0.0 to 239.255.255.255. If you do not specify a multicast group, the command designates the C-BSR to the global-scoped zone.

mask-length: Specifies an address mask length in the range of 8 to 32.

mask: Specifies an address mask.

hash-length hash-length: Specifies a hash mask length in the range of 0 to 32. The default setting is 30.

priority priority: Specifies a C-BSR priority in the range of 0 to 255. The default setting is 64. The greater the value, the higher the priority.

Usage guidelines

If you execute this command for a zone multiple times, the most recent configuration takes effect.

You can configure the same C-BSR for different zones.

Examples

# Configure the interface with IP address 1.1.1.1 as the C-BSR for the global-scoped zone on the public network.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr 1.1.1.1

c-rp (PIM view)

Use c-rp to configure a candidate-RP (C-RP).

Use undo c-rp to remove the configuration of a C-RP.

Syntax

c-rp ip-address [ advertisement-interval adv-interval | group-policy ipv4-acl-number | holdtime hold-time | priority priority ] * [ bidir ]

undo c-rp ip-address

Default

No C-RPs exist.

Views

PIM view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the IP address of a C-RP. You must specify the IP address of a local PIM interface.

advertisement-interval adv-interval: Specifies a C-RP advertisement interval in the range of 1 to 65535 seconds. The default value is 60 seconds.

group-policy ipv4-acl-number: Specifies an IPv4 basic ACL by its number in the range of 2000 to 2999. If you specify an ACL, the command designates the C-RP to IPv4 multicast groups that the ACL permits. The C-RP is designated to all IPv4 multicast groups when one of the following conditions exists:

·          You do not specify an ACL.

·          The specified ACL does not exist.

·          The specified ACL does not have valid rules.

holdtime hold-time: Specifies a C-RP lifetime in the range of 1 to 65535 seconds. The default value is 150 seconds.

priority priority: Specifies a C-RP priority in the range of 0 to 255. The default setting is 192. The greater the value, the lower the priority.

bidir: Specifies BIDIR-PIM to which the C-RP is designated. If you do not specify this keyword, the C-RP provides services for PIM-SM.

Usage guidelines

When you configure a rule in the IPv4 basic ACL, follow these restrictions and guidelines:

·          For the rule to take effect, do not specify the vpn-instance vpn-instance option.

·          The source source-address source-wildcard option specifies a multicast group range.

·          Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

To designate a C-RP to multiple multicast group ranges, create multiple rules that specify different multicast group ranges in the ACL.

If you execute this command by using the same C-RP IP address multiple times, the most recent configuration takes effect.

Examples

# On the public network, configure the interface with IP address 1.1.1.1 as the C-RP for multicast group ranges 225.1.0.0/16 and 226.2.0.0/16, and set its priority to 10.

<Sysname> system-view

[Sysname] acl basic 2000

[Sysname-acl-ipv4-basic-2000] rule permit source 225.1.0.0 0.0.255.255

[Sysname-acl-ipv4-basic-2000] rule permit source 226.2.0.0 0.0.255.255

[Sysname-acl-ipv4-basic-2000] quit

[Sysname] pim

[Sysname-pim] c-rp 1.1.1.1 group-policy 2000 priority 10

crp-policy (PIM view)

Use crp-policy to configure a C-RP policy to guard against C-RP spoofing.

Use undo crp-policy to restore the default.

Syntax

crp-policy ipv4-acl-number

undo crp-policy

Default

No C-RP policies exist, and all C-RP messages are regarded as legal.

Views

PIM view

Predefined user roles

network-admin

Parameters

ipv4-acl-number: Specifies an IPv4 advanced ACL number in the range of 3000 to 3999.

Usage guidelines

When you configure a rule in the IPv4 advanced ACL, follow these restrictions and guidelines:

·          For the rule to take effect, do not specify the vpn-instance vpn-instance option.

·          The source source-address source-wildcard option specifies an RP address.

·          The destination dest-address dest-wildcard option specifies a multicast group address.

·          Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

The device uses only the prefixes of the multicast group ranges in advertisement messages to match the destination field in ACL rules. For example, the multicast group range in an advertisement message is 224.1.0.0/16. If the prefix 224.1.0.0 is in the range specified by the destination field of an ACL rule, the specified C-RPs are designated to this multicast group range.

Examples

# On the public network, configure a C-RP policy so that only devices in the address range of 1.1.1.1/24 can be C-RPs for the groups in the range of 225.1.1.0/24.

<Sysname> system-view

[Sysname] acl advanced 3000

[Sysname-acl-ipv4-adv-3000] rule permit ip source 1.1.1.1 0.0.0.255 destination 225.1.1.0 0.0.0.255

[Sysname-acl-ipv4-adv-3000] quit

[Sysname] pim

[Sysname-pim] crp-policy 3000

Related commands

c-rp (PIM view)

display interface register-tunnel

Use display interface register-tunnel to display register-tunnel interface information.

Syntax

display interface [ register-tunnel [ interface-number ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

register-tunnel: Displays information about the register-tunnel interface. If you do not specify this keyword, the command displays information about all interfaces on the device.

interface-number: Specifies a register-tunnel interface by its number. The device has only one register-tunnel interface, and the value for this argument is fixed at 0. The command always displays information about Register-Tunnel 0 when you specify the register-tunnel keyword, regardless of whether you specify an interface number.

brief: Displays brief information. If you do not specify this keyword, the command displays detailed information.

description: Displays the full interface description. If you do not specify this keyword, the command displays only the first 27 characters of the interface description.

down: Displays information about the interfaces in down state and the reasons why the interfaces are down. If you do not specify this keyword, the command displays information about interfaces in all states.

Usage guidelines

The register-tunnel interface is a virtual interface that is automatically created by the system. You cannot configure it or delete it, but you can display the interface information by using this command.

In the initial stage of multicast source registration, the register-tunnel interface is used to establish a channel between the source-side DR and the RP to transmit multicast register messages. The process of initial source registration is as follows:

1.        After receiving the first multicast data from the source, the source-side DR encapsulates the multicast data into a register message. Then, it forwards the message to the RP through the register-tunnel interface.

2.        The register message reaches RP on the register-tunnel interface on the RP. The RP decapsulates the register message and forwards the multicast data to the receiver hosts. At the same time, the RP learns the IP address of the multicast source.

3.        The RP sends a join message toward the multicast source to build an SPT.

4.        After the SPT is built, the multicast data travels to the RP along the SPT rather than through the register-tunnel interface.

Examples

# Display detailed information about Register-Tunnel 0.

<Sysname> display interface register-tunnel 0

Register-Tunnel0

Current state: UP

Line protocol state: DOWN

Description: Register-Tunnel0 Interface

Maximum Transmit Unit: 1536

Internet protocol processing: disabled

Physical: Unknown

Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec

Last 300 seconds output rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec

Input: 0 packets, 0 bytes, 0 drops

Output: 0 packets, 0 bytes, 0 drops

# Display brief information about Register-Tunnel 0.

<Sysname> display interface register-tunnel 0 brief

Brief information on interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface            Link Protocol Main IP         Description

REG0                 UP   --       --

Table 30 Command output

Field

Description

Current state

Physical state of the register-tunnel interface. This field always displays UP.

Line protocol state

Link state of the register-tunnel interface. This field always displays DOWN.

Description

Description of the register-tunnel interface. It is not configurable.

Maximum Transmit Unit

MTU of the register-tunnel interface. It is not configurable.

Internet protocol processing

IP protocol processing capability. This field always displays disabled, because the register-tunnel interface cannot process IP protocol packets.

Physical

Physical type of the register-tunnel interface. This field always displays Unknown, because the physical type of the register-tunnel interface is unknown.

Last 300 seconds input rate

Average incoming rate in the last 300 seconds. This field always displays 0.

Last 300 seconds output rate

Average outgoing rate in the last 300 seconds. This field always displays 0.

Input

Number of incoming packets, incoming bytes, and discarded packets. This field always displays 0.

Output

Number of outgoing packets, outgoing bytes, and discarded packets. This field always displays 0.

Brief information on interface(s) under route mode

Brief information about Layer 3 interfaces.

Link: ADM - administratively down; Stby - standby

Physical state of the interface:

·         UP—The interface is physically up.

·         DOWN—The interface is physically down.

·         ADM—The interface has been administratively shut down. To recover its physical state, use the undo shutdown command.

·         Stby—The interface is a backup interface. To display information about the primary interface, use the display interface-backup command.

Protocol: (s) - spoofing

If the Protocol field contains "(s)", it means one of the following conditions:

·         The data link protocol state of the interface is UP, but no link is present on the interface.

·         The link is created on demand.

Typically, null interfaces or loopback interfaces have this attribute.

Protocol

Protocol connection state of the interface. This field always displays double hyphens (--).

Main IP

IP address of the interface. This field always displays double hyphens (--).

Cause

Causes why the physical state of the interface is down. This field always displays Not connected.

 

display pim bsr-info

Use display pim bsr-info to display BSR information.

Syntax

display pim [ vpn-instance vpn-instance-name ] bsr-info

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, the command displays BSR information on the public network.

Examples

# Display BSR information on the public network.

<Sysname> display pim bsr-info

 Scope: non-scoped

     State: Accept Preferred

     Bootstrap timer: 00:01:44

     Elected BSR address: 12.12.12.1

       Priority: 64

       Hash mask length: 30

       Uptime: 00:21:56

 

 Scope: 239.4.0.0/16

     State: Accept Any

     Scope-zone expiry timer: 00:21:12