- Table of Contents
-
- H3C S9500 Command Manual-Release2132[V2.03]-04 IP Multicast Volume
- 00-1Cover
- 01-Multicast Routing and Forwarding Commands
- 02-IGMP Snooping Commands
- 03-IGMP Commands
- 04-PIM Commands
- 05-MSDP Commands
- 06-IPv6 Multicast Routing and Forwarding Commands
- 07-MLD Snooping Commands
- 08-MLD Commands
- 09-IPv6 PIM Commands
- 10-Multicast VLAN Commands
- Related Documents
-
Title | Size | Download |
---|---|---|
09-IPv6 PIM Commands | 236.88 KB |
Chapter 1 IPv6 PIM Configuration Commands
1.1 IPv6 PIM Configuration Commands
1.1.8 c-rp advertisement-interval
1.1.12 display pim ipv6 bsr-info
1.1.13 display pim ipv6 claimed-route
1.1.14 display pim ipv6 control-message counters
1.1.15 display pim ipv6 grafts
1.1.16 display pim ipv6 interface
1.1.17 display pim ipv6 join-prune
1.1.18 display pim ipv6 neighbor
1.1.19 display pim ipv6 routing-table
1.1.20 display pim ipv6 rp-info
1.1.22 hello-option dr-priority
1.1.25 hello-option neighbor-tracking
1.1.26 hello-option override-interval
1.1.33 pim ipv6 hello-option dr-priority
1.1.34 pim ipv6 hello-option holdtime
1.1.35 pim ipv6 hello-option lan-delay
1.1.36 pim ipv6 hello-option neighbor-tracking
1.1.37 pim ipv6 hello-option override-interval
1.1.38 pim ipv6 holdtime join-prune
1.1.41 pim ipv6 state-refresh-capable
1.1.42 pim ipv6 timer graft-retry
1.1.44 pim ipv6 timer join-prune
1.1.45 pim ipv6 triggered-hello-delay
1.1.48 register-suppression-timeout
1.1.49 register-whole-checksum
1.1.50 reset pim ipv6 control-message counters
1.1.56 state-refresh-rate-limit
Chapter 1 IPv6 PIM Configuration Commands
& Note:
The term “router” in this document refers to a router in a generic sense or an S9500 series routing switch running IPv6 PIM.
1.1 IPv6 PIM Configuration Commands
1.1.1 bsr-policy
Syntax
bsr-policy acl6-number
undo bsr-policy
View
IPv6 PIM view
Default Level
2: System level
Parameters
acl6-number: Basic IPv6 ACL number. When an IPv6 ACL is defined, the source keyword in the rule command specifies a legal BSR source IPv6 address range.
Description
Use the bsr-policy command to configure a legal range of BSR global unicast addresses so that the device discards any bootstrap messages from out of the configured address range to guard against BSR spoofing.
Use the undo bsr-policy command to remove the restore the system default.
By default, there are no restrictions on the BSR address range, namely the BSR messages from any source are regarded to be valid.
Examples
# Configure a legal BSR address range so that only routers with an address in the range of 2001::2/64 can become the BSR.
<Sysname> system-view
[Sysname] acl ipv6 number 2000
[Sysname-acl6-basic-2000] rule 0 permit source 2001::2 64
[Sysname-acl6-basic-2000] quit
[Sysname] multicast ipv6 routing-enable
[Sysname-pim6] bsr-policy 2000
1.1.2 c-bsr
Syntax
c-bsr ipv6-address [ hash-length [ priority ] ]
undo c-bsr
View
IPv6 PIM view
Default Level
2: System level
Parameters
ipv6-address: IPv6 global unicast address of the interface that is to act as a C-BSR.
hash-length: Hash mask length. If you do not include this keyword in your command, the corresponding global setting will be used.
priority: Priority of the C-BSR, 0 by default. If you do not include this keyword in your command, the corresponding global setting will be used. A larger value of this argument means a higher priority.
Description
Use the c-bsr command to configure the specified interface as a C-BSR.
Use the undo c-bsr command to restore the system default.
No C-BSR is configured by default.
Note that any interface serving as a C-BSR must be IPv6 PIM-SM enabled.
Related commands: pim ipv6 sm, c-bsr hash-length, c-bsr priority, c-rp.
Examples
# Configure the interface with an IPv6 global unicast address of 1101::1 as a C-BSR.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] c-bsr 1101::1
1.1.3 c-bsr hash-length
Syntax
c-bsr hash-length hash-length
undo c-bsr hash-length
View
IPv6 PIM view
Default Level
2: System level
Parameters
hash-length: Hash mask length.
Description
Use the c-bsr hash-length command to configure the global Hash mask length.
Use the undo c-bsr hash-length command to restore the system default.
By default, the Hash mask length is 126.
Related commands: c-bsr.
Examples
# Set the global Hash mask length to 16.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] c-bsr hash-length 16
1.1.4 c-bsr holdtime
Syntax
c-bsr holdtime interval
undo c-bsr holdtime
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: Bootstrap timeout in seconds.
Description
Use the c-bsr holdtime command to configure the bootstrap timeout time, namely the length of time the device as a C-BSR waits before it must receive a bootstrap message from the BSR.
Use the undo c-bsr holdtime command to restore the system default.
By default, the bootstrap timeout value is determined by this formula: Bootstrap timeout = Bootstrap interval × 2 + 10.
& Note:
The default bootstrap interval is 60 seconds, so the default bootstrap timeout = 60 × 2 + 10 = 130 (seconds).
Related commands: c-bsr, c-bsr interval.
Examples
# Set the bootstrap timeout time to 150 seconds.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] c-bsr holdtime 150
1.1.5 c-bsr interval
Syntax
c-bsr interval interval
undo c-bsr interval
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: Bootstrap interval in seconds.
Description
Use the c-bsr interval command to configure the bootstrap interval, namely the interval the BSR waits between sending bootstrap messages.
Use the undo c-bsr interval command to restore the system default.
By default, the bootstrap interval value is determined by this formula: Bootstrap interval = (Bootstrap timeout – 10) / 2.
& Note:
The default bootstrap timeout is 130 seconds, so the default bootstrap interval = (130 – 10) / 2 = 60 (seconds).
Related commands: c-bsr, c-bsr holdtime.
Examples
# Set the bootstrap interval to 30 seconds.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] c-bsr interval 30
1.1.6 c-bsr priority
Syntax
c-bsr priority priority
undo c-bsr priority
View
IPv6 PIM view
Default Level
2: System level
Parameters
priority: Priority of the C-BSR. A larger value means a higher priority.
Description
Use the c-bsr priority command to configure the global C-BSR priority.
Use the undo c-bsr priority command to restore the system default.
By default, the C-BSR priority is 0.
Related commands: c-bsr.
Examples
# Set the global C-BSR priority to 5.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] c-bsr priority 5
1.1.7 c-rp
Syntax
c-rp ipv6-address [ group-policy acl6-number | priority priority | holdtime hold-interval | advertisement-interval adv-interval ] *
undo c-rp ipv6-address
View
IPv6 PIM view
Default Level
2: System level
Parameters
ipv6-address: IPv6 global unicast address of the interface that is to act as a C-RP.
acl6-number: Basic IPv6 ACL number. This IPv6 ACL defines a range of IPv6 multicast groups the C-RP is going to serve, rather than defining a filtering rule. Any IPv6 multicast group range that matches the permit statement in the ACL will be advertised as an RP served group, while configurations matching other statements like deny will not take effect.
priority: Priority of the C-RP, 0 by default. A larger value means a lower priority.
hold-interval: C-RP timeout time, in seconds. If you do not include this argument in your command, the corresponding global setting will be used.
adv-interval: C-RP-Adv interval in seconds. If you do not include this argument in your command, the corresponding global setting will be used.
Description
Use the c-rp command to configure the specified interface a C-RP.
Use the undo c-rp command to remove the related C-RP configuration.
No C-RPs are configured by default.
Note that:
l Note that any interface serving as a C-RP must be IPv6 PIM-SM enabled.
l If you do not specify an IPv6 multicast group range for the C-RP, the C-RP will serve all IPv6 multicast groups.
l If you wish a device to be a C-RP for multiple group ranges, you need to include these group ranges in multiple rules in the IPv6 ACL corresponding to the group-policy keyword.
l If you carry out this command repeatedly on the same interface, the last configuration will take effect.
Related commands: c-bsr.
Examples
# Configure the interface with an IPv6 global unicast address of 2001::1 to be a C-RP for IPv6 multicast group FF35:0:1391::/96, with a priority of 10.
<Sysname> system-view
[Sysname] acl ipv6 number 2000
[Sysname-acl6-basic-2000] rule permit source ff35:0:1391:: 96
[Sysname-acl6-basic-2000] quit
[Sysname] pim ipv6
[Sysname-pim6] c-rp 2001::1 group-policy 2000 priority 10
1.1.8 c-rp advertisement-interval
Syntax
c-rp advertisement-interval interval
undo c-rp advertisement-interval
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: C-RP-Adv interval in seconds.
Description
Use the c-rp advertisement-interval command to configure globally the interval the device waits between sending C-RP-Adv messages.
Use the undo c-rp advertisement-interval command to restore the system default.
By default, the C-RP-Adv interval is 60 seconds.
Related commands: c-rp.
Examples
# Set the global C-RP-Adv interval to 30 seconds.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] c-rp advertisement-interval 30
1.1.9 c-rp holdtime
Syntax
c-rp holdtime interval
undo c-rp holdtime
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: C-RP timeout in seconds.
Description
Use the c-rp holdtime command to configure globally the C-RP timeout time, namely the length of time the BSR waits before it must receive a C-RP-Adv message from a C-RP.
Use the undo c-rp holdtime command to restore the system default.
By default, the C-RP timeout time is 150 seconds.
Because a non-BSR router refreshes its C-RP timeout time through BSR bootstrap messages, to prevent loss of C-RP information in BSR bootstrap messages, the C-RP timeout time should be longer than the bootstrap interval. The recommended C-RP timeout setting is 2.5 times the bootstrap interval or longer.
Related commands: c-rp, c-bsr interval.
Examples
# Set the global C-RP timeout time to 200 seconds.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] c-rp holdtime 200
1.1.10 crp-policy
Syntax
crp-policy acl6-number
undo crp-policy
View
IPv6 PIM view
Default Level
2: System level
Parameters
acl6-number: Advanced IPv6 ACL number. When configuring the IPv6 ACL, use the source keyword in the rule command to specify the IPv6 address of a C-RP and the destination keyword to specify the address range of the IPv6 multicast groups that the C-RP will serve.
Description
Use the crp-policy command to configure a legal C-RP address range and the range of served IPv6 multicast groups, so as to guard against C-RP spoofing.
Use the undo crp-policy command to restore the system default.
By default, there are no restrictions on C-RP address ranges and the address ranges of served groups, namely all received C-RP messages are assumed to be legal.
Examples
# Configure a C-RP address range so that only routers in the address range of 2001::2/64 can be C-RPs.
<Sysname> system-view
[Sysname] acl ipv6 number 3000
[Sysname-acl6-adv-3000] rule 0 permit ipv6 source 2001::2 64
[Sysname-acl6-adv-3000] quit
[Sysname] pim ipv6
[Sysname-pim6] crp-policy 3000
1.1.11 debugging pim ipv6
Syntax
debugging pim ipv6 { all | event [ advanced-acl6-number ] | routing-table [ advanced-acl6-number ] | neighbor [ basic-acl6-number ] [ receive | send ] | assert [ advanced-acl6-number ] [ receive | send ] | rp [ receive | send ] | join-prune [ advanced-acl6-number ] [ receive | send ] | register [ advanced-acl6-number ] | state-refresh [ advanced-acl6-number ] [ receive | send ] }
undo debugging pim ipv6 { all | event | routing-table | neighbor [ receive | send ] | assert state-refresh [ receive | send ] | rp [ receive | send ] | join-prune [ receive | send ] | register }
View
User view
Default Level
1: Monitor level
Parameters
all: Turns on/off all types of IPv6 PIM debugging.
event: Turns on/off event debugging.
advanced-acl6-number: Advanced IPv6 ACL number.
routing-table: Turns on/off debugging for IPv6 PIM multicast routing table state changes.
neighbor: Turns on/off neighbor information debugging.
basic-acl6-number: Basic IPv6 ACL number.
receive: Turns on/off debugging for received messages.
receive: Turns on/off debugging for sent messages.
assert: Turns on/off debugging for assert messages. Currently, S9500 series routing switches do not support this parameter.
rp: Turns on/off RP debugging.
join-prune: Turns on/off debugging for join and prune messages.
register: Turns on/off PIM debugging for register messages.
state-refresh: Turns on/off state-refresh debugging.
Description
Use the debugging pim ipv6 command to turn on IPv6 PIM debugging.
Use the undo debugging pim ipv6 command to turn off IPv6 PIM debugging.
By default, IPv6 PIM debugging is disabled.
Table 1-1 debugging pim ipv6 event command output description
Field |
Description |
unsupported PIM version |
The IPv6 PIM version is not supported |
PIM packet too short |
Too small packet size of IPv6 PIM message |
checksum error |
Checksum error |
non-pim interface |
An IPv6 PIM message was received on a non-PIM-enabled interface. |
unsupported type |
The specified IPv6 PIM message type is not supported. |
Socket set option error |
Failed to set socket option |
Packet send error |
Failed to send IPv6 PIM message |
Source address is one of the interfaces address |
The source address is the address of a local interface. |
Source address address is invalid |
The source address is invalid. |
Invalid source mask |
Incorrect source address prefix |
Active event received |
A source-active event was received. |
Inactive event received |
A source-inactive event was received. |
Clear event received |
A clear-entry event was received. |
Wrong IF |
Incorrect incoming interface |
NoInfo |
The downstream state machine is in the Noinfo state. |
PPending |
The downstream state machine is in the Prune Pending state. |
Pruned |
The IPv6 PIM-DM downstream state machine is in the Pruned state. |
Joined |
The IPv6 PIM-SM downstream state machine is in the Joined state. |
Forwarding |
The IPv6 PIM-DM upstream state machine is in the Forward state. |
Pruned |
The IPv6 PIM-DM upstream state machine is in the Pruned state. |
AckPending |
The IPv6 PIM-DM upstream state machine is in the Ack Pending state. |
Joined |
The IPv6 PIM-SM (S, G) or (*, G) upstream state machine is in the Joined state. |
NotJoined |
The IPv6 PIM-SM (S, G) or (*, G) upstream state machine is in the Not Joined state. |
PruneTmp |
The IPv6 PIM-SM (S, G, RPT) downstream state machine is in the Prune Tmp state. |
PPendingTmp |
The IPv6 PIM-SM (S, G, RPT) downstream state machine is in the Prune Pending Tmp state. |
PPT Expired |
The Prune Pending timer timed out. |
RPF_Interface changed |
The RPF interface changed. |
Genid changed |
The neighbor generation ID changed. |
PT Expired |
The prune timer timed out. |
Failed to pass MSF |
Failed to pass multicast source filtering |
NotOriginator |
The originator state machine is in the Not Originator state. |
Originator |
The originator state machine is in the Originator state. |
SAT Expired |
The source-alive timer timed out. |
Join suppressed |
The device received a join message to the upstream neighbor on the incoming interface and suppressed its own join message. |
Override it |
The device received a prune message to the upstream neighbor on the incoming interface and sent a join message. |
ET Expired |
The IPv6 PIM-SM downstream interface aging timers timed out. |
register downstream |
Registering the outgoing interface |
Mcast-Boundary-Changed |
Multicast boundary change event |
Table 1-2 debugging pim ipv6 join-prune command output description
Field |
Description |
JP |
Join/prune message |
GFT |
Graft message |
GAK |
Graft-ack message |
receiving |
Messages received |
sending |
Message sent |
unknown address |
Unknown address, address decoding failed |
bad group address, mask or family |
Incorrect IPv6 group address, prefix, or family |
Bad source address, mask or family |
Incorrect source address, prefix or family |
Upstream |
Upstream neighbor information in the message |
Groups |
Number of groups in the message |
Group: addr/mask --- m joins n prunes |
Group information in the message: IPv6 group address/prefix length — m joins and n prunes |
Join: addr/mask flag |
Join: source address/ prefix flag |
Message truncated. Ignoring message |
The message was dropped due to invalid packet size. |
Unable to decode address |
Address decoding failed |
Upstream neighbor is not this router. Ignoring |
The message was dropped because the upstream neighbor is not this device. |
group boundary detected for address1 on address2 |
address1 is within the multicast boundary configured on the interface corresponding to address2. |
Group address1 ignored in message on address2 |
address1 is within the multicast boundary configured on the interface corresponding to address2, and this group is ignored |
Message from unknown neighbor |
A message was received from an unknown neighbor. |
Join/Prune received for non-local neighbor |
A join/prune message for a non-local upstream neighbor was received. |
Override timer expires |
The prune override timer timed out. |
Table 1-3 debugging pim ipv6 neighbor command output description
Field |
Description |
HEL |
IPv6 PIM hello message |
hello packet |
IPv6 PIM hello message |
receiving |
Message received |
sending |
Message sent |
on interfacename |
Interface on which the message was received or sent |
Option: m, length: n |
IPv6 PIM hello message option: option value, option length: length value |
Holdtime: |
Holdtime field of the IPv6 PIM hello message |
Tbit |
Tbit option |
Lan delay |
LAN delay option |
Override interval |
Override interval option |
DR priority |
DR priority option |
Genid |
Generation ID option |
Version |
Version field of the state refresh option |
Refresh interval |
State refresh interval field |
Reserved |
Reserved field of the state refresh option |
Secondary address(es) |
Address(es) in the address list option |
Unknown option value |
Unknown option |
without SR capability |
No state refresh capability |
Elected as DR on interface interfacename |
Elected as the DR for the network attached to interfacename |
Unelected as DR on interface interfacename |
No longer the DR for the network attached to interfacename |
PIM Neighbor address on interface interfacename timed out |
Neighbor address on interfacename timed out. |
Table 1-4 debugging pim ipv6 register command output description
Field |
Description |
REG |
Register message |
RSP |
Register-stop message |
Register Stop |
Register stopped |
receiving |
Message received |
sending |
Message sent |
Border bit |
Boundary bit |
Null bit |
Null bit |
src |
Source address of the IPv6 packet |
dst |
Destination address of the IPv6 packet |
Non-DR interface |
Non-DR interface |
probe |
Probe message |
ignored |
Message dropped |
Table 1-5 debugging pim ipv6 routing-table command output description
Field |
Description |
Creating |
Creating entries |
Deleting |
Deleting entries |
mrt |
IPv6 multicast routing table |
Add oil |
Adding outgoing interface |
Del oil |
Deleting outgoing interface |
Null iif |
|
Adding iif |
Adding incoming interface |
Deleting iif |
Deleting incoming interface |
RP is not found |
RP is not found |
Table 1-6 debugging pim ipv6 rp command output description
Field |
Description |
receiving |
Message received |
sending |
Message sent |
auto-RP announce |
auto-RP announce message |
auto-RP discovery |
auto-RP discovery message |
C-RP |
Candidate RP |
CRP |
Candidate RP |
BSR |
Bootstrap router |
prefix count |
Prefix count field in the C-RP advertisement message |
priority |
Priority field in the C-RP advertisement message |
holdtime |
Holdtime field in the C-RP advertisement message |
Admin Scope Zone |
Admin-scope region |
Bad BSR address |
Incorrect BSR address |
frag |
Fragment tag field in the BSR bootstrap message |
pri |
Priority field in the BSR bootstrap message |
hash mask len |
Hash mask length field in the BSR bootstrap message |
Group address/length: frags m, C-RP's n |
The frags filed corresponding to address/length in the BSR bootstrap message is m, and the number of C-RPs is n. |
address pri: m, holdtime: n |
The priority of C-RP address in the BSR bootstrap message is m and holdtime is n. |
Auto-RP discovery packet: RP agent address, RP count m, Holdtime n |
An auto-RP discovery message was received: RP agent is address, RP count is m, and holdtime is n |
delete RP-Set |
Deleting an RP set |
too short length |
Too small packet size |
wrong RP agent address |
Incorrect RP agent address |
wrong RP address |
Incorrect RP address |
bad group address |
Incorrect IPv6 group address |
bad group mask length |
Incorrect group address prefix |
bad BSR address |
Incorrect BSR address |
bad BSR address family |
Incorrect BSR address family |
bad BSR hash mask length |
Incorrect BSR hash mask length |
bad scope zone mask |
Incorrect admin-scope region prefix |
Unknown group address family |
Incorrect IPv6 group address family |
not directly connected source |
Address of a source not directly connected |
unknown neighbor |
unknown neighbor |
ACL |
Access control list |
Bad frag-rp-count field |
Incorrect frag-rp-count field in the BSR bootstrap message |
Bad frag-rp field length |
Incorrect total length of frag-rp fields in the BSR bootstrap message |
BSR mechanism |
BSR mechanism independent of administrative scoping |
Upstream to BSR |
Upstream to the BSR device |
no BSR is available |
No available BSR |
add register vif |
Adding a register virtual interface |
Remove register vif |
Removing a register virtual interface |
Expiring CRP |
Aged C-RP |
Lose the ASBSR election |
The device lost BSR election for the admin-scope region |
Lose the BSR election |
The device lost BSR election |
locally scoped |
Node-local or link-local scope |
RP changed |
The RP changed. |
pending state |
The BSR changed to the pending state. |
Update the BSR's state to elected |
The BSR changed to the elected state. |
RPF Failure |
RPF check failed. |
admin scope multicast address |
Address in the admin-scope range |
Table 1-7 debugging pim ipv6 state-refresh command output description
Field |
Description |
SRM |
State refresh message |
sending |
Message sent |
receiving |
Message received |
Message truncated |
Invalid packet size |
bad group address |
Incorrect IPv6 group address |
Invalid group mask length |
Incorrect group address prefix length |
Group address |
IPv6 group address |
Source address |
Source address |
Originator address |
Address of the state refresh message originator |
preference |
Preference field of the message |
metric |
Metric field of the message |
mask length |
Prefix length field of the message |
ttl |
TTL value of the message |
prune indicator |
Prune Indicator flag bit |
prune now |
Prune Now indicator flag bit |
Examples
# Enable debugging for IPv6 PIM events.
<Sysname> debugging pim ipv6 event
*Mar 26 14:18:10:635 2007 Sysname PIM/7/EVENT:IPv6: PIM-SM: Downstream (100:100::168, FF0E::101:101) on interface Vlan-interface20 (FE80::2E0:FCFF:FE02:1A01) FSM transited from Joined to PPending. Prune Received (S131565)
// A prune message was received. The downstream state machine of the outgoing interface VLAN-interface 20 (FE80::2E0:FCFF:FE02:1A01) of the IPv6 PIM-SM entry (100:100::168, FF0E::101:101) transferred from Joined to Prune Pending.
*Mar 26 14:18:11:635 2007 Sysname PIM/7/EVENT:IPv6: PIM-SM: Downstream (100:100::168, FF0E::101:101) on interface Vlan-interface20 (FE80::2E0:FCFF:FE02:1A01) FSM transited from PPending to NoInfo. PPT Expired (S13993)
// Since the Prune Pending timer timed out, the downstream state machine of the outgoing interface VLAN-interface 20 (FE80::2E0:FCFF:FE02:1A01) of the IPv6 PIM-SM entry (100:100::168, FF0E::101:101) transferred from Prune Pending to NoInfo..
1.1.12 display pim ipv6 bsr-info
Syntax
display pim ipv6 bsr-info
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display pim ipv6 bsr-info command to view the BSR information in the IPv6 PIM-SM domain and the locally configured C-RP information in effect.
Related commands: c-bsr, c-rp.
Examples
# View the BSR information in the IPv6 PIM-SM domain and the locally configured C-RP information in effect.
<Sysname> display pim ipv6 bsr-info
Elected BSR Address: 2004::2
Priority: 0
Hash mask length: 126
State: Elected
Uptime: 00:01:10
Next BSR message scheduled at: 00:00:48
Candidate BSR Address: 2004::2
Priority: 0
Hash mask length: 126
State: Elected
Candidate RP: 2001::1(LoopBack1)
Priority: 0
HoldTime: 130
Advertisement Interval: 60
Next advertisement scheduled at: 00:00:48
Table 1-8 display pim ipv6 bsr-info command output description
Field |
Description |
Elected BSR Address |
IPv6 global unicast address of the elected BSR |
Priority |
BSR priority |
Hash mask length |
Hash mask length |
State |
BSR state |
Uptime |
Length of time since the BSR was up |
Next BSR message scheduled at |
Length of time the BSR waits before sending the next bootstrap message |
Candidate RP |
C-RP address |
Priority |
C-RP priority |
HoldTime |
Timeout time of the C-RP |
Advertisement Interval |
Interval the C-RP waits between sending C-RP-Adv messages |
Next advertisement scheduled at |
Length of time the C-RP waits before sending the next C-RP-Adv message |
1.1.13 display pim ipv6 claimed-route
Syntax
display pim ipv6 claimed-route [ ipv6-source-address ]
View
Any view
Default Level
1: Monitor level
Parameters
ipv6-source-address: Displays the information of the IPv6 unicast route to a particular IPv6 multicast source. If you do not provide this argument, this command will display the information about all IPv6 unicast routes used by IPv6 PIM.
Description
Use the display pim ipv6 claimed-route command to view the information of IPv6 unicast routes used by IPv6 PIM.
If an (S, G) is marked SPT, this (S, G) entry uses an IPv6 unicast route.
Examples
# View the information of the IPv6 unicast route to the multicast source 2001::2.
<Sysname> display pim ipv6 claimed-route 2001::2
RPF information about: 2001::2
RPF interface: Vlan-interface22, RPF neighbor: FE80::A01:100:1
Referenced prefix/prefix length: 2001::/64
Referenced route type: igp
RPF-route selecting rule: preference-preferred
The (S, G) or (*, G) list dependent on this route entry
(2001::2, FF1E::101:101)
Table 1-9 display pim ipv6 claimed-route command output description
Field |
Description |
RPF information about: 2001::2 |
Information of RPF router to IPv6 multicast source 2001::2 |
RPF interface: |
RPF interface type and number |
RPF neighbor: |
IPv6 address of the RPF neighbor |
Referenced prefix/prefix length: |
Destination address/prefix of the IPv6 PIM route |
Referenced route type: |
Name of the routing protocol |
RPF-route selecting rule: |
Rule of RPF route selection |
The (S,G) or (*,G) list dependent on this route entry |
List of (S, G) or (*, G) entries based on this RPF route |
1.1.14 display pim ipv6 control-message counters
Syntax
display pim ipv6 control-message counters [ message-type { probe | register | register-stop } | [ interface interface-type interface-number | message-type { assert | bsr | crp | graft | graft-ack | hello | join-prune | state-refresh } ] * ]
View
Any view
Default Level
1: Monitor level
Parameters
probe: Null register messages.
register: Register messages.
register-stop: Register-stop messages.
interface-type interface-number: Displays the number of IPv6 PIM control messages on the specified interface. Currently, only VLAN interfaces are supported for the S9500 series routing switches.
assert: Assert messages. Currently, S9500 series routing switches do not support this parameter.
bsr: Bootstrap messages.
crp: C-RP-Adv messages.
graft: Graft messages.
graft-ack: Graft-ack messages.
hello: Hello messages.
join-prune: Join/prune messages.
state-refresh: State refresh messages.
Description
Use the display pim ipv6 control-message counters command to view the statistics information of IPv6 PIM control messages.
& Note:
Since register, register-stop, and probe messages are counted globally, you cannot view the statistics on these messages on a specific interface.
Examples
# View the statistics information of all types of IPv6 PIM control messages on all interfaces.
<Sysname> display pim ipv6 control-message counters
PIM global control-message counters:
Received Sent Invalid
Register 20 37 2
Register-Stop 25 20 1
Probe 10 5 0
PIM control-message counters for interface: Vlan-interface12
Received Sent Invalid
Assert 0 0 0
Graft 20 37 2
Graft-Ack 25 20 1
Hello 1232 453 0
Join/Prune 15 30 21
State-Refresh 8 7 1
BSR 3243 589 1
C-RP 53 32 0
Table 1-10 display pim ipv6 control-message counters command output description
Field |
Description |
Received |
Number of messages received |
Sent |
Number of messages sent |
Invalid |
Number of invalid messages |
Register |
Register messages |
Register-Stop |
Register-stop messages |
Probe |
Null register messages |
Assert |
Assert messages |
Graft |
Graft messages |
Graft-Ack |
Graft-ack messages |
Hello |
Hello messages |
Join/Prune |
Join/prune messages |
State Refresh |
State refresh messages |
BSR |
Bootstrap messages |
C-RP |
C-RP-Adv messages |
1.1.15 display pim ipv6 grafts
Syntax
display pim ipv6 grafts
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display pim ipv6 grafts command to view the information about unacknowledged graft messages.
Examples
# View the information about unacknowledged graft messages.
<Sysname> display pim ipv6 grafts
Source Group Age RetransmitIn
1004::2 ff1e::101:101 00:00:24 00:00:02
Table 1-11 display pim ipv6 grafts command output description
Field |
Description |
Source |
IPv6 multicast source address in the graft message |
Group |
IPv6 multicast group address in the graft message |
Age |
Remaining aging time of the graft message |
RetransmitIn |
Length of time before a retry graft message is sent |
1.1.16 display pim ipv6 interface
Syntax
display pim ipv6 interface [ interface-type interface-number ] [ verbose ]
View
Any view
Default Level
1: Monitor level
Parameters
interface-type interface-number: Displays the IPv6 PIM information on a particular interface. Currently, only VLAN interfaces are supported for the S9500 series routing switches.
verbose: Displays the detailed IPv6 PIM information.
Description
Use the display pim ipv6 interface command to view the IPv6 PIM information on the specified interface or all interfaces.
Examples
# View the detailed IPv6 PIM information on VLAN-interface 1024.
<Sysname> display pim ipv6 interface vlan-interface1024 verbose
Interface: Vlan-interface1024, FE80::20F:E2FF:FE45:8345
PIM version: 2
PIM mode: Sparse
PIM DR: FE80::20F:E2FF:FE45:8345 (local)
PIM DR Priority (configured): 1
PIM neighbor count: 0
PIM hello interval: 30 s
PIM LAN delay (negotiated): 500 ms
PIM LAN delay (configured): 500 ms
PIM override interval (negotiated): 2500 ms
PIM override interval (configured): 2500 ms
PIM neighbor tracking (negotiated): disabled
PIM neighbor tracking (configured): disabled
PIM generation ID: 0xD9065FF2
PIM require generation ID: disabled
PIM hello hold interval: 105 s
PIM assert hold interval: 180 s
PIM triggered hello delay: 5 s
PIM J/P interval: 60 s
PIM J/P hold interval: 210 s
PIM BSR domain border: disabled
Number of routers on network not using DR priority: 0
Number of routers on network not using LAN delay: 0
Number of routers on network not using neighbor tracking: 1
Table 1-12 display pim ipv6 interface command output description
Field |
Description |
Interface |
Interface name and its IPv6 address |
PIM version |
IPv6 PIM version |
PIM mode |
IPv6 PIM mode, dense or sparse |
PIM DR |
IPv6 address of the DR |
PIM DR Priority (configured) |
Configured priority for DR election |
PIM neighbor count |
Total number of IPv6 PIM neighbors |
PIM hello interval |
Interval between IPv6 PIM hello messages |
PIM LAN delay (negotiated) |
Negotiated prune delay |
PIM LAN delay (configured) |
Configured prune delay |
PIM override interval (negotiated) |
Negotiated prune override interval |
PIM override interval (configured) |
Configured prune override interval |
PIM neighbor tracking (negotiated) |
Negotiated neighbor tracking status (enabled/disabled) |
PIM neighbor tracking (configured) |
Configured neighbor tracking status (enabled/disabled) |
PIM generation ID |
Generation_ID value |
PIM require generation ID |
Rejection of Hello messages without Generation_ID (enabled/disabled) |
PIM hello hold interval |
IPv6 PIM neighbor timeout time |
PIM hello assert interval |
Assert timeout time |
PIM triggered hello delay |
Maximum delay of sending hello messages |
PIM J/P interval |
Join/prune interval |
PIM J/P hold interval |
Join/prune timeout time |
PIM BSR domain border |
Whether an IPv6 PIM-SM domain border is configured |
Number of routers on network not using DR priority |
Number of routers not using the DR priority field on the subnet where the interface resides |
Number of routers on network not using LAN delay |
Number of routers not using the LAN delay field on the subnet where the interface resides |
Number of routers on network not using neighbor tracking |
Number of routers not using neighbor tracking on the subnet where the interface resides |
1.1.17 display pim ipv6 join-prune
Syntax
display pim ipv6 join-prune mode { sm [ flags flag-value ] | ssm } [ interface interface-type interface-number | neighbor ipv6-neighbor-address ] * [ verbose ]
View
Any view
Default Level
1: Monitor level
Parameters
mode: Displays the information of join/prune messages to send in the specified IPv6 PIM mode. IPv6 PIM modes include sm and ssm, which represent IPv6 PIM-SM and IPv6 PIM-SSM respectively.
flags flag-value: Specifies to display IPv6 PIM routing entries containing the specified flag(s).Values and meanings of flag-value are as follows:
l rpt: Specifies routing entries on the RPT.
l spt: Specifies routing entries on the SPT.
l wc: Specifies wildcard routing entries.
interface-type interface-number: Displays the information of join/prune messages to send on the specified interface. Currently, only VLAN interfaces are supported for the S9500 series routing switches.
ipv6-neighbor-address: Displays the information of join/prune messages to send to the specified IPv6 PIM neighbor.
verbose: Displays the detailed information of join/prune messages to send.
Description
Use the display pim join-prune command to view the information about the join/prune messages to send.
Examples
# View the information of join/prune messages to send in the IPv6 PIM-SM mode.
<Sysname> display pim ipv6 join-prune mode sm
Expiry Time: 50 sec
Upstream nbr: FE80::2E0:FCFF:FE03:1004 (Vlan-interface22)
1 (*, G) join(s), 0 (S, G) join(s), 1 (S, G, rpt) prune(s)
-------------------------------------------------------------------------
Total (*, G) join(s): 1, (S, G) join(s): 0, (S, G, rpt) prune(s): 1
Table 1-13 display pim join-prune command output description
Field |
Description |
Expiry Time |
Waiting time before ending join/prune messages |
Upstream nbr: |
IPv6 address of the upstream IPv6 PIM neighbor and the interface connecting to it |
(*, G) join(s) |
Number of (*, G) joins to send |
(S, G) join(s) |
Number of (S, G) joins to send |
(S, G, rpt) prune(s) |
Number of (S, G, rpt) prunes |
1.1.18 display pim ipv6 neighbor
Syntax
display pim ipv6 neighbor [ interface interface-type interface-number | ipv6-neighbor-address | verbose ] *
View
Any view
Default Level
1: Monitor level
Parameters
interface-type interface-number: Displays the IPv6 PIM neighbor information on a particular interface. Currently, only VLAN interfaces are supported for the S9500 series routing switches.
ipv6-neighbor-address: Displays the information of a particular IPv6 PIM neighbor.
verbose: Displays the detailed IPv6 PIM neighbor information.
Description
Use the display pim ipv6 neighbor command to view the IPv6 PIM neighbor information.
Examples
# View the information of all IPv6 PIM neighbors.
<Sysname> display pim ipv6 neighbor
Total Number of Neighbors = 2
Neighbor Interface Uptime Expires Dr-Priority
2002::1 Vlan12 02:50:49 00:01:31 1
2004::1 Vlan22 02:49:39 00:01:42 1
Table 1-14 display pim ipv6 neighbor command output description
Field |
Description |
Total Number of Neighbors |
Total number of IPv6 PIM neighbors |
Neighbor |
IPv6 address of the PIM neighbor |
Interface |
Interface connecting the IPv6 PIM neighbor |
Uptime |
Length of time since the IPv6 PIM neighbor was up |
Expires |
Remaining time before the IPv6 PIM neighbor expires |
Dr-Priority |
Designated router priority |
1.1.19 display pim ipv6 routing-table
Syntax
display pim ipv6 routing-table [ ipv6-group-address [ prefix-length ] | ipv6-source-address [ prefix-length ] | incoming-interface [ interface-type interface-number | register ] | outgoing-interface { include | exclude | match } { interface-type interface-number | register } | mode mode-type | flags flag-value | fsm ] *
View
Any view
Default Level
1: Monitor level
Parameters
ipv6-group-address: Specifies an IPv6 multicast group.
ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 global unicast address.
prefix-length: Prefix length of the IPv6 multicast group/source address. For an IPv6 multicast group address, the effective range is 8 to 128; for an IPv6 multicast source address, the effective range is 0 to 128. The default value is 128 in both cases.
incoming-interface: Displays routing entries that contain the specified interface as the incoming interface.
interface-type interface-number: Specifies an interface by its type and number. Currently, only VLAN interfaces are supported for the S9500 series routing switches.
register: Specifies the register interface. This keyword is valid only if mode-type is not specified or is sm.
outgoing-interface: Displays routing entries that contain the specified interface as the outgoing interface.
include: Displays routing entries of which the OIL includes the specified interface. This keyword must be followed by the interface type and number.
exclude: Displays routing entries of which the OIL excludes the specified interface. This keyword must be followed by the interface type and number.
match: Displays routing entries of which the OIL includes only the specified interface. If no interface type and number is specified, this command displays those routing entries with an empty OIL.
mode mode-type: Specifies an IPv6 PIM mode, where mode-type can have the following values:
l dm: Specifies IPv6 PIM-DM.
l sm: Specifies IPv6 PIM-SM.
l ssm: Specifies IPv6 PIM-SSM.
flags flag-value: Displays IPv6 PIM routing entries containing the specified flag(s). The values of flag-value and their meanings are as follows:
l act: Specifies IPv6 multicast routing entries to which actual data has arrived.
l del: Specifies IPv6 multicast routing entries scheduled to be deleted.
l ext: Specifies IPv6 routing entries containing outgoing interfaces contributed by other IPv6 multicast routing protocols.
l loc: Specifies IPv6 multicast routing entries on routers on the same subnet with the IPv6 multicast source.
l niif: Specifies IPv6 multicast routing entries containing unknown incoming interfaces.
l nonbr: Specifies routing entries with IPv6 PIM neighbor searching failure.
l rpt: Specifies routing entries on RPT branches where (S, G) prunes have been sent to the RP.
l spt: Specifies routing entries on the SPT.
l swt: Specifies routing entries in the process of RPT-to-SPT switchover.
l wc: Specifies wildcard routing entries.
fsm: Displays the detailed information of the finite state machine (FSM).
Description
Use the display pim ipv6 routing-table command to view IPv6 PIM routing table information.
Related commands: display ipv6 multicast routing-table in IPv6 Multicast Routing and Forwarding Commands in the IP Multicast Volume.
Examples
# View the content of the IPv6 PIM routing table.
<Sysname> display pim ipv6 routing-table
Total 0 (*, G) entry; 1 (S, G) entry
(2001::2, FF15::101:101)
Protocol: pim-dm, Flag:
UpTime: 00:04:24
Upstream interface: Vlan-interface12
Upstream neighbor: 2002::1
RPF prime neighbor: 2002::1
Downstream interface(s) information:
Total number of downstreams: 1
1: Vlan-interface122
Protocol: pim-dm, UpTime: 00:04:24, Expires: 00:02:47
Table 1-15 display pim ipv6 routing-table command output description
Field |
Description |
Total 0 (*, G) entry; 1 (S, G) entry |
Number of (S, G) and (*, G) entries in the IPv6 PIM routing table |
(2001::2, FF15::101:101) |
An (S, G) entry in the IPv6 PIM routing table |
Protocol |
IPv6 PIM mode, IPv6 PIM-SM or IPv6 PIM-DM |
Flag |
Flag of an (S, G) or (*, G) entry in the IPv6 PIM routing table. For more information, see the parameter flags flag-value. |
Uptime |
Length of time since the (S, G) or (*, G) entry was installed in the routing table |
Upstream interface |
Upstream (incoming) interface of the (S, G) or (*, G) entry |
Upstream neighbor |
Upstream neighbor of the (S, G) or (*, G) entry |
RPF prime neighbor |
RPF neighbor of the (S, G) or (*, G) entry l For a (*, G) entry, if this router is the RP, the RPF neighbor of this (*, G) entry is NULL. l For an (S, G) entry, if this router directly connects to the IPv6 multicast source, the RPF neighbor of this (S, G) entry is NULL. |
Downstream interface(s) information |
Information of the downstream interface(s), including: l Number of downstream interfaces l Downstream interface name l IPv6 multicast protocol mode configured on this downstream interface l Length of time since this downstream interface was up l Remaining aging time of this downstream interface |
1.1.20 display pim ipv6 rp-info
Syntax
display pim ipv6 rp-info [ ipv6-group-address ]
View
Any view
Default Level
1: Monitor level
Parameters
ipv6-group-address: Specifies an IPv6 multicast group. If you do not provide a group address, this command will display the RP information corresponding to all IPv6 multicast groups.
Description
Use the display pim ipv6 rp-info command to view the RP information.
Note that:
l The RP information includes the information of RPs dynamically found by the BSR mechanism and static RPs.
l Because a non-BSR router refreshes its local RP-Set only based on the received BSR bootstrap messages, the system does not delete an RP even if its expiry time is 0. Instead, the system waits for the next bootstrap message from the BSR: if the bootstrap message does not contain information of the RP, the system will delete it.
Examples
# View the RP information corresponding to the IPv6 multicast group FF0E::101:101.
<Sysname> display pim ipv6 rp-info ff0e::101:101
PIM-SM BSR RP information:
prefix/prefix length: FF0E::101:101/64
RP: 2004::2
Priority: 0
HoldTime: 130
Uptime: 00:05:19
Expires: 00:02:11
Table 1-16 display pim ipv6 rp-info command output description
Field |
Description |
prefix/prefix length |
The IPv6 multicast group served by the RP |
RP |
IPv6 global unicast address of the RP |
Priority |
RP priority |
HoldTime |
Timeout time of the RP |
Uptime |
Length of time since the RP was up |
Expires |
Remaining time of the RP |
1.1.21 embedded-rp
Syntax
embedded-rp [ acl6-number ]
undo embedded-rp [ acl6-number ]
View
IPv6 PIM view
Default Level
2: System level
Parameters
acl6-number: Basic IPv6 ACL number.
Description
Use the embedded-rp command to enable embedded RP.
Use the undo embedded-rp command to disable embedded RP.
By default, embedded RP is enabled for IPv6 multicast groups in the default embedded RP address scopes..
Note that:
l When you use the embedded-rp command without specifying acl6-number, the embedded RP feature will be enabled for all the IPv6 multicast groups in the default embedded RP address scopes; if you specify acl6-number, the embedded RP feature will be enabled for only those IPv6 multicast groups that are within the default embedded RP address scopes and pass the ACL check.
l When you use the undo embedded-rp command without specifying acl6-number, the embedded RP feature will be disabled for all the IPv6 multicast groups; if you specify acl6-number, this command will disable the embedded RP feature.
Examples
# Enable embedded RP for only those IPv6 multicast groups in the address scope FF7E:140:20::101/64.
<Sysname> system-view
[Sysname] acl ipv6 number 2000
[Sysname-acl6-basic-2000] rule permit source ff7e:140:20::101:101 64
[Sysname-acl6-basic-2000] quit
[Sysname] pim ipv6
[Sysname-pim6] embedded-rp 2000
1.1.22 hello-option dr-priority
Syntax
hello-option dr-priority priority
undo hello-option dr-priority
View
IPv6 PIM view
Default Level
2: System level
Parameters
priority: Priority for DR election. A larger value means a higher priority.
Description
Use the hello-option dr-priority command to configure the global value of the priority for DR election.
Use the undo hello-option dr-priority command to restore the system default.
By default, the priority for DR election is 1.
Related commands: pim ipv6 hello-option dr-priority.
Examples
# Set the priority for DR election to 3.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] hello-option dr-priority 3
1.1.23 hello-option holdtime
Syntax
hello-option holdtime interval
undo hello-option holdtime
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: IPv6 PIM neighbor timeout time in seconds.
Description
Use the hello-option holdtime command to configure the IPv6 PIM neighbor timeout time.
Use the undo hello-option holdtime command to restore the system default.
By default, the IPv6 PIM neighbor timeout time is 105 seconds.
Related commands: pim ipv6 hello-option holdtime.
Examples
# Set the IPv6 PIM neighbor timeout time to 120 seconds globally.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] hello-option holdtime 120
1.1.24 hello-option lan-delay
Syntax
hello-option lan-delay interval
undo hello-option lan-delay
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: LAN-delay time in milliseconds.
Description
Use the hello-option lan-delay command to configure the global value of the LAN-delay time.
Use the undo hello-option lan-delay command to restore the default.
By default, the LAN-delay time is 500 milliseconds.
Related commands: pim ipv6 hello-option lan-delay, hello-option override-interval, pim ipv6 hello-option override-interval.
Examples
# Set the prune delay to 200 milliseconds globally.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] hello-option lan-delay 200
1.1.25 hello-option neighbor-tracking
Syntax
hello-option neighbor-tracking
undo hello-option neighbor-tracking
View
IPv6 PIM view
Default Level
2: System level
Parameters
None
Description
Use the hello-option neighbor-tracking command to globally disable join suppression, namely enable neighbor tracking.
Use the undo hello-option neighbor-tracking command to enable join suppression.
By default, join suppression is enabled, namely neighbor tracking is disabled.
Related commands: pim ipv6 hello-option neighbor-tracking.
Examples
# Disable join suppression globally.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] hello-option neighbor-tracking
1.1.26 hello-option override-interval
Syntax
hello-option override-interval interval
undo hello-option override-interval
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: Prune override interval in milliseconds.
Description
Use the hello-option override-interval command to configure the global value of the prune override interval.
Use the undo hello-option override-interval command to restore the system default.
By default, the prune override interval is 2,500 milliseconds.
Related commands: hello-option lan-delay, pim ipv6 hello-option lan-delay, pim ipv6 hello-option override-interval.
Examples
# Set the prune override interval to 2,000 milliseconds globally.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] hello-option override-interval 2000
1.1.27 holdtime join-prune
Syntax
holdtime join-prune interval
undo holdtime join-prune
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: Join/prune timeout time in seconds.
Description
Use the holdtime join-prune command to configure the global value of the join/prune timeout time.
Use the undo holdtime join-prune command to restore the system default.
By default, the join/prune timeout time is 210 seconds.
Related commands: pim ipv6 holdtime join-prune.
Examples
# Set the global value of the join/prune timeout time to 280 seconds.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] holdtime join-prune 280
1.1.28 jp-pkt-size
Syntax
jp-pkt-size packet-size
undo jp-pkt-size
View
IPv6 PIM view
Default Level
2: System level
Parameters
packet-size: Maximum size of join/prune messages in bytes.
Description
Use the jp-pkt-size command to configure the maximum size of join/prune messages.
Use the undo jp-pkt-size command to restore the system default.
By default, the maximum size of join/prune messages is 8,100 bytes.
Related commands: jp-queue-size.
Examples
# Set the maximum size of join/prune messages to 1,500 bytes.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] jp-pkt-size 1500
1.1.29 jp-queue-size
Syntax
jp-queue-size queue-size
undo jp-queue-size
View
IPv6 PIM view
Default Level
2: System level
Parameters
queue-size: Maximum number of (S, G) entries in a join/prune message.
Description
Use the jp-queue-size command to configure the maximum number of (S, G) entries in a join/prune message.
Use the undo jp-queue-size command to restore the system default.
By default, a join/prune messages contains a maximum of 1,020 (S, G) entries.
When you use this command, take into account the (S, G) join/prune state timeout time on the upstream device. If you configure a small queue size, the outgoing interface of the corresponding entry may have been pruned due to timeout before the last join/prune message in a queue reaches the upstream device.
Related commands: jp-pkt-size, holdtime join-prune, pim ipv6 holdtime join-prune..
Examples
# Configure a join/prune messages to contain a maximum of 2,000 (S, G) entries.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] jp-queue-size 2000
1.1.30 pim ipv6
Syntax
pim ipv6
undo pim ipv6
View
System view
Default Level
2: System level
Parameters
None
Description
Use the pim ipv6 command to enter IPv6 PIM view.
Use the undo pim ipv6 command to remove all configurations performed in IPv6 PIM view and return to system view.
Note that IPv6 multicast must be enabled on the device before this command can take effect.
Related commands: multicast ipv6 routing-enable in IPv6 Multicast Routing and Forwarding Commands in the IP Multicast Volume.
Examples
# Enter IPv6 PIM view.
<Sysname> system-view
[Sysname] multicast ipv6 routing-enable
[Sysname] pim ipv6
[Sysname-pim6]
1.1.31 pim ipv6 bsr-boundary
Syntax
pim ipv6 bsr-boundary
undo pim ipv6 bsr-boundary
View
VLAN interface view
Default Level
2: System level
Parameters
None
Description
Use the pim ipv6 bsr-boundary command to configure an IPv6 PIM-SM domain border, namely an IPv6 PIM bootstrap message boundary.
Use the undo pim ipv6 bsr-boundary command to remove the configured IPv6 PIM-SM domain border.
By default, no IPv6 PIM-SM domain border is configured.
Related commands: c-bsr.
Examples
# Configure VLAN-interface 100 to be the IPv6 PIM-SM domain border.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 bsr-boundary
1.1.32 pim ipv6 dm
Syntax
pim ipv6 dm
undo pim ipv6 dm
View
VLAN interface view
Default Level
2: System level
Parameters
None
Description
Use the pim ipv6 dm command to enable IPv6 PIM-DM.
Use the undo pim ipv6 dm command to disable IPv6 PIM-DM.
Caution:
l This command can take effect only after IPv6 multicast routing is enabled.
l After IPv6 PIM-DM is enabled on a VLAN interface, MLD snooping cannot be enabled in the corresponding VLAN, and vice versa.
By default, IPv6 PIM-DM is disabled.
Examples
# Enable IPv6 PIM-DM on VLAN-interface 100.
<Sysname> system-view
[Sysname] multicast ipv6 routing-enable
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 dm
1.1.33 pim ipv6 hello-option dr-priority
Syntax
pim ipv6 hello-option dr-priority priority
undo pim ipv6 hello-option dr-priority
View
VLAN interface view
Default Level
2: System level
Parameters
priority: Priority for DR election. A larger value means a higher priority.
Description
Use the pim ipv6 hello-option dr-priority command to configure the priority for DR election on the current interface.
Use the undo pim ipv6 hello-option dr-priority command to restore the system default.
By default, the priority for DR election is 1.
This command is the same as the hello-option dr-priority command for IPv6 PIM view, with the exception of the view in which it is carried out. Configurations performed in IPv6 PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in IPv6 PIM view are used only if the corresponding configurations have not been carried out in interface view.
Related commands: hello-option dr-priority.
Examples
# Set the priority for DR election to 3 on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 hello-option dr-priority 3
1.1.34 pim ipv6 hello-option holdtime
Syntax
pim ipv6 hello-option holdtime interval
undo pim ipv6 hello-option holdtime
View
VLAN interface view
Default Level
2: System level
Parameters
interval: IPv6 PIM neighbor timeout time in seconds.
Description
Use the pim ipv6 hello-option holdtime command to configure the PIM neighbor timeout time on the current interface.
Use the undo pim ipv6 hello-option holdtime command to restore the system default.
By default, the IPv6 PIM neighbor timeout time is 105 seconds.
This command is the same as the hello-option holdtime command for IPv6 PIM view, with the exception of the view in which it is carried out. Configurations performed in IPv6 PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in IPv6 PIM view are used only if the corresponding configurations have not been carried out in interface view.
Related commands: hello-option holdtime.
Examples
# Set the IPv6 PIM neighbor timeout time to 120 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 hello-option holdtime 120
1.1.35 pim ipv6 hello-option lan-delay
Syntax
pim ipv6 hello-option lan-delay interval
undo pim ipv6 hello-option lan-delay
View
VLAN interface view
Default Level
2: System level
Parameters
interval: Prune delay in milliseconds.
Description
Use the pim ipv6 hello-option lan-delay command to configure the LAN-delay time, namely the length of time the device waits before taking a prune action, on the current interface.
Use the undo pim ipv6 hello-option lan-delay command to restore the system default.
By default, the LAN-delay time is 500 milliseconds.
This command is the same as the hello-option lan-delay command for IPv6 PIM view, with the exception of the view in which it is carried out. Configurations performed in IPv6 PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in IPv6 PIM view are used only if the corresponding configurations have not been carried out in interface view.
Related commands: pim ipv6 hello-option override-interval, hello-option override-interval, hello-option lan-delay.
Examples
# Set the LAN-delay time to 200 milliseconds on VLAN-interface100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 hello-option lan-delay 200
1.1.36 pim ipv6 hello-option neighbor-tracking
Syntax
pim ipv6 hello-option neighbor-tracking
undo pim ipv6 hello-option neighbor-tracking
View
VLAN interface view
Default Level
2: System level
Parameters
None
Description
Use the pim ipv6 hello-option neighbor-tracking command to disable join suppression, namely enable neighbor tracking, on the current interface.
Use the undo pim ipv6 hello-option neighbor-tracking command to enable join suppression.
By default, join suppression is enabled, namely neighbor tracking is disabled.
This command is the same as the hello-option neighbor-tracking command for IPv6 PIM view, with the exception of the view in which it is carried out. Configurations performed in IPv6 PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in IPv6 PIM view are used only if the corresponding configurations have not been carried out in interface view.
Related commands: hello-option neighbor-tracking.
Examples
# Enable neighbor tracking on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 hello-option neighbor-tracking
1.1.37 pim ipv6 hello-option override-interval
Syntax
pim ipv6 hello-option override-interval interval
undo pim ipv6 hello-option override-interval
View
VLAN interface view
Default Level
2: System level
Parameters
interval: Prune override interval in milliseconds.
Description
Use the pim ipv6 hello-option override-interval command to configure the prune override interval on the current interface.
Use the undo pim ipv6 hello-option override-interval command to restore the system default.
By default, the prune override interval is 2,500 milliseconds.
This command is the same as the hello-option override-interval command for IPv6 PIM view, with the exception of the view in which it is carried out. Configurations performed in IPv6 PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in IPv6 PIM view are used only if the corresponding configurations have not been carried out in interface view.
Related commands: pim ipv6 hello-option lan-delay, hello-option lan-delay, hello-option override-interval.
Examples
# Set the prune override interval to 2,000 milliseconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 hello-option override-interval 2000
1.1.38 pim ipv6 holdtime join-prune
Syntax
pim ipv6 holdtime join-prune interval
undo pim ipv6 holdtime join-prune
View
VLAN interface view
Default Level
2: System level
Parameters
interval: Join/prune timeout time in seconds.
Description
Use the pim ipv6 holdtime join-prune command to configure the join/prune timeout time on the interface.
Use the undo pim ipv6 holdtime join-prune command to restore the system default.
By default, the join/prune timeout time is 210 seconds.
This command is the same as the holdtime join-prune command for IPv6 PIM view, with the exception of the view in which it is carried out. Configurations performed in IPv6 PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in IPv6 PIM view are used only if the corresponding configurations have not been carried out in interface view.
Related commands: holdtime join-prune.
Examples
# Set the join/prune timeout time to 280 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 holdtime join-prune 280
1.1.39 pim ipv6 require-genid
Syntax
pim ipv6 require-genid
undo pim ipv6 require-genid
View
VLAN interface view
Default Level
2: System level
Parameters
None
Description
Use the pim ipv6 require-genid command enable rejection of hello messages without Generation_ID.
Use the undo pim ipv6 require-genid command to restore the default configuration.
By default, hello messages without Generation_ID are accepted.
Examples
# Enable VLAN-interface 100 to reject hello messages without Generation_ID.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 require-genid
1.1.40 pim ipv6 sm
Syntax
pim ipv6 sm
undo pim ipv6 sm
View
VLAN interface view
Default Level
2: System level
Parameters
None
Description
Use the pim ipv6 sm command to enable IPv6 PIM-SM.
Use the undo pim ipv6 sm command to disable IPv6 PIM-SM.
By default, IPv6 PIM-SM is disabled.
Caution:
l This command can take effect only after IPv6 multicast routing is enabled on the device.
l After IPv6 PIM-SM is enabled on a VLAN interface, MLD Snooping cannot be enabled in the corresponding VLAN, and vice versa.
Related commands: pim ipv6 dm.
Examples
# Enable IPv6 PIM-SM on VLAN-interface 100.
<Sysname> system-view
[Sysname] multicast ipv6 routing-enable
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 sm
1.1.41 pim ipv6 state-refresh-capable
Syntax
pim ipv6 state-refresh-capable
undo pim ipv6 state-refresh-capable
View
VLAN interface view
Default Level
2: System level
Parameters
None
Description
Use the pim ipv6 state-refresh-capable command to enable the state fresh feature on the interface.
Use the undo pim ipv6 state-refresh-capable command to disable the state fresh feature.
By default, the state refresh feature is enabled.
Related commands: state-refresh-interval, state-refresh-rate-limit, state-refresh-ttl.
Examples
# Disable state refresh on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] undo pim ipv6 state-refresh-capable
1.1.42 pim ipv6 timer graft-retry
Syntax
pim ipv6 timer graft-retry interval
undo pim ipv6 timer graft-retry
View
VLAN interface view
Default Level
2: System level
Parameters
interval: IPv6 PIM-DM graft retry period in seconds.
Description
Use the pim ipv6 timer graft-retry command to configure the graft retry period, namely the length of time the device waits between sending graft messages before a graft-ack is received.
Use the undo pim ipv6 timer graft-retry command to restore the system default.
By default, the graft retry period is 3 seconds.
Examples
# Set the graft retry period to 80 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 timer graft-retry 80
1.1.43 pim ipv6 timer hello
Syntax
pim ipv6 timer hello interval
undo pim ipv6 timer hello
View
VLAN interface view
Default Level
2: System level
Parameters
interval: Hello interval in seconds.
Description
Use the pim ipv6 timer hello command to configure the hello interval, namely the length of time the device waits between sending hello messages, on the current interface.
Use the undo pim ipv6 timer hello command to restore the system default.
By default, the hello interval is 30 seconds.
This command is the same as the timer hello command for IPv6 PIM view, with the exception of the view in which it is carried out. Configurations performed in IPv6 PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in IPv6 PIM view are used only if the corresponding configurations have not been carried out in interface view.
Related commands: timer hello.
Examples
# Set the hello interval to 40 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 timer hello 40
1.1.44 pim ipv6 timer join-prune
Syntax
pim ipv6 timer join-prune interval
undo pim ipv6 timer join-prune
View
VLAN interface view
Default Level
2: System level
Parameters
interval: Join/prune interval in seconds.
Description
Use the pim ipv6 timer join-prune command to configure the prune/join interval, namely the length of time the device waits between sending prune/join messages, on the current interface.
Use the undo pim ipv6 timer join-prune command to restore the system default.
By default, the join/prune interval is 60 seconds.
This command is the same as the timer join-prune command for IPv6 PIM view, with the exception of the view in which it is carried out. Configurations performed in IPv6 PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in IPv6 PIM view are used only if the corresponding configurations have not been carried out in interface view.
Related commands: timer join-prune.
Examples
# Set the join/prune interval to 80 seconds on VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 timer join-prune 80
1.1.45 pim ipv6 triggered-hello-delay
Syntax
pim ipv6 triggered-hello-delay interval
undo pim ipv6 trigged-hello-delay
View
VLAN interface view
Default Level
2: System level
Parameters
interval: Maximum hello delay in seconds.
Description
Use the pim ipv6 triggered-hello-delay command to configure the maximum hello delay, namely the maximum length of time the device waits before sending a hello message.
Use the undo pim ipv6 triggered-hello-delay command to restore the system default.
By default, the maximum hello delay is 5 seconds.
Examples
# Set the maximum hello delay to 3 seconds on VLAN-interface100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] pim ipv6 trigged-hello-delay 3
1.1.46 probe-interval
Syntax
probe-interval interval
undo probe-interval
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: Probe time in seconds.
Description
Use the probe-interval command to configure the probe time, namely the interval at which the source-side DR sends null register messages before the register suppression timer expires.
Use the undo probe-interval command to restore the system default.
By default, the probe time is 5 seconds.
Related commands: register-suppression-timeout.
Examples
# Set the probe time to 6 seconds.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] probe-interval 6
1.1.47 register-policy
Syntax
register-policy acl6-number
undo register-policy
View
IPv6 PIM view
Default Level
1: Monitor level
Parameters
acl6-number: Advanced IPv6 ACL number. Only those register messages that match the permit statement of the IPv6 ACL can be accepted by the RP.
Description
Use the register-policy command to configure an IPv6 ACL rule to filter register messages.
Use the undo register-policy command to remove the configured register filtering rule.
By default, no register filtering rule is configured.
Within an IPv6 PIM-SM domain, the DR sends register messages with different source/group addresses to the RP. You can configure a filtering rule to accept or reject certain register messages so that the RP can serve specific IPv6 multicast groups.
If an (S, G) entry is denied by the ACL, or the action for this entry is not defined, the RP will send a register-stop message to the DR to stop the registration process for the multicast stream.
Caution:
The RP will reject all register messages if you specify an IPv6 advanced ACL without a rule definition.
Examples
# Configure a register filtering policy on the RP so that only IPv6 multicast sources on the subnet 3:1::/64 can send register messages to the IPv6 multicast groups on the subnet FF35:13::/64.
<Sysname> system-view
[Sysname] acl ipv6 number 3000
[Sysname-acl6-adv-3000] rule permit ipv6 source 3:1:: 64 destination ff35:13:: 64
[Sysname-acl6-adv-3000] quit
[Sysname] pim ipv6
[Sysname-pim6] register-policy 3000
1.1.48 register-suppression-timeout
Syntax
register-suppression-timeout interval
undo register-suppression-timeout
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: Register suppression timeout in seconds.
Description
Use the register-suppression-timeout command to configure the register suppression timeout time.
Use the undo register-suppression-timeout command to restore the system default.
By default, the register suppression timeout time is 60 seconds.
Note that:
l When a device, as a DR, receives an (S, G)-specific register-stop message from the RP, the device immediately stops sending register messages with encapsulated multicast data and enters the register suppression state.
l A smaller timeout setting causes bursts of multicast data to flow to the RP more frequently, and a larger timeout setting results in a larger delay for new receivers to join a multicast group.
l Defining a probe time setting in the probe-interval command reduces bursts of register messages, and a appropriately reduced setting of the suppression timeout time reduces the delay for new receivers to join a multicast group.
Related commands: probe-interval.
Examples
# Set the register suppression timeout time to 70 seconds.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] register-suppression-timeout 70
1.1.49 register-whole-checksum
Syntax
register-whole-checksum
undo register-whole-checksum
View
IPv6 PIM view
Default Level
2: System level
Parameters
None
Description
Use the register-whole-checksum command to configure the router to calculate the checksum based on the entire register message.
Use the undo register-whole-checksum command to restore the system default.
By default, the checksum is calculated based only on the header in the register message.
Related commands: register-policy, register-suppression-timeout.
Examples
# Configure the router to calculate the checksum based on the entire register message.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] register-whole-checksum
1.1.50 reset pim ipv6 control-message counters
Syntax
reset pim ipv6 control-message counters [ interface interface-type interface-number ]
View
User view
Default Level
1: Monitor level
Parameters
interface interface-type interface-number: Specifies to reset the IPv6 PIM control message counter on a particular interface. Currently, only VLAN interfaces are supported for the S9500 series routing switches.
Description
Use the reset pim ipv6 control-message counters command to reset IPv6 PIM control message counters.
Examples
# Reset IPv6 PIM control message counters on all interfaces.
<Sysname> reset pim ipv6 control-message counters
1.1.51 source-lifetime
Syntax
source-lifetime interval
undo source-lifetime
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: IPv6 multicast source lifetime in seconds.
Description
Use the source-lifetime command to configure the IPv6 multicast source lifetime.
Use the undo source-lifetime command to restore the system default.
By default, the lifetime of an IPv6 multicast source is 210 seconds.
Examples
# Set the IPv6 multicast source lifetime to 200 seconds.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] source-lifetime 200
1.1.52 source-policy
Syntax
source-policy acl6-number
undo source-policy
View
IPv6 PIM view
Default Level
2: System level
Parameters
acl6-number: Basic or advanced IPv6 ACL number.
Description
Use the source-policy command to configure an IPv6 multicast data filter.
Use the undo source-policy command to remove the configured IPv6 multicast data filter.
By default, no IPv6 multicast data filter is configured.
Note that:
l If you specify a basic ACL, the device filters the received IPv6 multicast packets based on the source address, and discards packets that fail the source address match.
l If you specify an advanced ACL, the device filters the received IPv6 multicast packets based on the source and group addresses, and discards packets that fail the match.
l If this command is executed repeatedly, the last configuration will take effect.
Examples
# Configure the router to accept IPv6 multicast packets originated from 3121::1 and discard IPv6 multicast packets originated from 3121::2.
<Sysname> system-view
[Sysname] acl ipv6 number 2000
[Sysname-acl6-basic-2000] rule permit source 3121::1 128
[Sysname-acl6-basic-2000] rule deny source 3121::2 128
[Sysname-acl6-basic-2000] quit
[Sysname] pim ipv6
[Sysname-pim6] source-policy 2000
[Sysname-pim6] quit
1.1.53 spt-switch-threshold
Syntax
spt-switch-threshold infinity [ group-policy acl6-number [ order order-value ] ]
undo spt-switch-threshold [ group-policy acl6-number ]
View
IPv6 PIM view
Default Level
2: System level
Parameters
group-policy acl6-number: Specifies an IPv6 group policy. RPT-to-SPT switchover will be disabled for IPv6 multicast groups that match the specified group policy. In this option, acl6-number refers to a basic IPv6 ACL number, in the range of 2000 to 2999. If you do not include this option in your command, the configuration will apply on all IPv6 multicast groups.
order order-value: Specifies the order of the IPv6 ACL in the group-policy list, where order-value has an effective range of 1 to (the largest order value in the existing group-policy list + 1), but the value range should not include the original order value of the IPv6 ACL in the group-policy list. If you have assigned an order-value to a certain IPv6 ACL, do not specify the same order-value for another IPv6 ACL; otherwise the system will give error information. If you do not specify an order-value, the order value of the IPv6 ACL will remain the same in the group-policy list.
Description
Use the spt-switch-threshold command to disable RPT-to-SPT switchover.
Use the undo spt-switch-threshold command to restore the system default.
By default, the device switches to the SPT immediately after it receives the first IPv6 multicast packet from the RPT.
Note that:
l To adjust the order of an IPv6 ACL that already exists in the group-policy list, you can use the acl6-number argument to specify this IPv6 ACL and set its order-value. This will insert the IPv6 ACL to the position of order-value in the group-policy list. The order of the other existing IPv6 ACLs in the group-policy list will remain unchanged.
l To use an IPv6 ACL that does not exist in the group-policy list, you can use the acl6-number argument to specify an IPv6 ACL and set its order-value. This will insert the IPv6 ACL to the position of order-value in the group-policy list. If you do not include the order order-value option in your command, the ACL will be appended to the end of the group-policy list.
l If you use this command multiple times on the same IPv6 multicast group, the first traffic rate configuration matched in sequence will take effect.
l To avoid forwarding failure, do not include the infinity keyword in the spt-switch-threshold command on a switch that may become an RP (namely, a static RP or a C-RP).
Examples
# Disable RPT-to-SPT switchover.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] spt-switch-threshold infinity
1.1.54 ssm-policy
Syntax
ssm-policy acl6-number
undo ssm-policy
View
IPv6 PIM view
Default Level
2: System level
Parameters
acl6-number: Basic IPv6 ACL number, in the range of 2000 to 2999.
Description
Use the ssm-policy command to configure the IPv6 SSM group range.
Use the undo ssm-policy command to restore the system default.
By default, the IPv6 SSM group range is FF3x::/32. Here x refers to any legal scope.
This command allows you to define an address range of permitted or denied IPv6 multicast groups. If the match succeeds, the running multicast mode will be IPv6 PIM-SSM; otherwise the multicast mode will be IPv6 PIM-SM.
Examples
# Configure the IPv6 SSM group range as FF3E:0:8192::/96.
<Sysname> system-view
[Sysname] acl ipv6 number 2000
[Sysname-acl6-basic-2000] rule permit source ff3e:0:8192:: 96
[Sysname-acl6-basic-2000] quit
[Sysname] pim ipv6
[Sysname-pim6] ssm-policy 2000
1.1.55 state-refresh-interval
Syntax
state-refresh-interval interval
undo state-refresh-interval
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: State refresh interval in seconds.
Description
Use the state-refresh-interval command to configure the interval between state refresh messages.
Use the undo state-refresh-interval command to restore the system default.
By default, the state refresh interval is 60 seconds.
Related commands: pim ipv6 state-refresh-capable, state-refresh-rate-limit, state-refresh-ttl.
Examples
# Set the state refresh interval to 70 seconds.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] state-refresh-interval 70
1.1.56 state-refresh-rate-limit
Syntax
state-refresh-rate-limit interval
undo state-refresh-rate-limit
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: Time to wait before receiving a new refresh message, in seconds.
Description
Use the state-refresh-rate-limit command to configure the time the router must wait before receiving a new state refresh message.
Use the undo state-refresh-rate-limit command to restore the system default.
By default, the device waits 30 seconds before receiving a new state refresh message.
Related commands: pim ipv6 state-refresh-capable, state-refresh-interval, state-refresh-ttl.
Examples
Configure the device to wait 45 seconds before receiving a new state refresh message.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] state-refresh-rate-limit 45
1.1.57 state-refresh-ttl
Syntax
state-refresh-ttl ttl-value
undo state-refresh-ttl
View
IPv6 PIM view
Default Level
2: System level
Parameters
ttl-value: TTL value of state refresh messages.
Description
Use the state-refresh-ttl command to configure the TTL value of state refresh messages.
Use the undo state-refresh-ttl command to restore the system default.
By default, the TTL value of state refresh messages is 255.
Related commands: pim ipv6 state-refresh-capable, state-refresh-interval, state-refresh-rate-limit.
Examples
# Set the TTL value of state refresh messages to 45.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] state-refresh-ttl 45
1.1.58 static-rp
Syntax
static-rp ipv6-rp-address [ acl6-number ] [ preferred ]
undo static-rp rp-address
View
IPv6 PIM view
Default Level
2: System level
Parameters
ipv6-rp-address: IPv6 address of the static RP to be configured. This address must be a valid, globally scoped IPv6 unicast address.
acl6-number: Basic IPv6 ACL number. If you provide this argument, the configured static RP will serve only those IPv6 multicast groups that pass the filtering; otherwise, the configured static RP will serve the all IPv6 multicast groups.
preferred: Specifies to give priority to the static RP if the static RP conflicts with the dynamic RP. If you do not include the preferred keyword in your command, the dynamic RP will be given priority, and the static RP takes effect on if no dynamic RP exists in the network or when the dynamic RP fails.
Description
Use the static-rp command to configure a static RP.
Use the undo static-rp command to restore the system default.
By default, no static RP is configured.
Note that:
l IPv6 PIM-SM or IPv6 PIM-DM cannot be enabled on an interface that serves as a static RP. Use this command to designate the same RP address on all the devices in the IPv6 PIM domain.
l When the IPv6 ACL rule applied on a static RP changes, a new RP must be elected for all IPv6 multicast groups.
l You can configure multiple static RPs by carrying out this command repeatedly. However, if you carry out this command multiple times and specify the same static RP address or reference the same IPv6 ACL rule, the last configuration will override the previous one. If multiple static RPs have been configured for the same IPv6 multicast group, the one with the highest IPv6 address will be chosen to serve the group.
l You can configure up to 50 static RPs on the same device.
Related commands: display pim ipv6 rp-info.
Examples
# Configure the interface with an IPv6 address of 2001::2 as a static RP.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] static-rp 2001::2
1.1.59 timer hello
Syntax
timer hello interval
undo timer hello
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: Hello interval in seconds.
Description
Use the timer hello command to configure the hello interval globally.
Use the undo timer hello command to restore the system default.
By default, hello messages are sent at the interval of 30 seconds.
This command is the same as the pim ipv6 timer hello command for IPv6 PIM view, with the exception of the view in which it is carried out. Configurations performed in IPv6 PIM view are effective to all interfaces, while configurations performed in interface view are effective to the current interface only. The system gives priority to configurations made in interface view. Configurations made in IPv6 PIM view are used only if the corresponding configurations have not been carried out in interface view.
Related commands: pim ipv6 timer hello.
Examples
# Set the global hello interval to 40 seconds.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] timer hello 40
1.1.60 timer join-prune
Syntax
timer join-prune interval
undo timer join-prune
View
IPv6 PIM view
Default Level
2: System level
Parameters
interval: Join/prune interval in seconds.
Description
Use the timer join-prune command to configure the join/prune interval globally.
Use the undo timer join-prune command to restore the system default.
By default, the join/prune interval is 60 seconds.
Related commands: pim ipv6 timer join-prune.
Examples
# Set the global join/prune interval to 80 seconds.
<Sysname> system-view
[Sysname] pim ipv6
[Sysname-pim6] timer join-prune 80