8.4. PIM Commands
8.4.1. ip pim accept-register
Command Purpose
Use this command to apply an access-list to limit the pim register message received by rp.
To remove this setting, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim accept-register list LIST
no ip pim accept-register
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
LIST |
The name of the access-list to be applied. |
Up to 40 characters |
Command Mode
Global Config
Default
None
Usage
This feature is used to prevent the unauthorized user registered to the switch.
When enable this feature, the system will send back a register stop message when the unauthorized register message is received.
Examples
This example shows how to apply the access-list acl1 to limit the pim register message received by rp:
Switch# configure terminal
Switch(config)# ip pim accept-register list acl1
This example shows how to remove the limits:
Switch# configure terminal
Switch(config)# no ip pim accept-register
8.4.2. ip pim anycast-rp
Command Purpose
Use this command to set anycast rendezvous-point.
To remove the configurations, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim anycast-rp ANYCAST_RP_ADDR ANYCAST_MEMBER_ADDR
no ip pim anycast-rp ANYCAST_RP_ADDR ( ANYCAST_MEMBER_ADDR | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
ANYCAST_RP_ADDR |
Anycast rp address |
IPv4 Address |
ANYCAST_MEMBER_ADDR |
Anycast member rp address |
IPv4 Address |
Command Mode
Global Config
Default
None.
Usage
Should configure every router in the network, and must configure same RP address.
Examples
This example shows how to set anycast rendezvous-point:
Switch# configure terminal
Switch(config)# ip pim anycast-rp 10.10.10.1 10.10.10.11
This example shows how to remove the member in anycast rendezvous-point:
Switch# configure terminal
Switch(config)# no ip pim anycast-rp 10.10.10.1 10.10.10.11
Related Commands
None
8.4.3. ip pim bsr-candidate
Command Purpose
Use this command to configure the candidate bootstrap router (candidate BSR).
To remove the configurations, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim bsr-candidate IFNAME ( MASK_LEN ( PRIORITY ) ( INTERVAL ) | )
no ip pim bsr-candidate
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
IFNAME |
Interface name |
Support physical/aggregation/loopback/vlan/tunnel ports |
MASK_LEN |
Hash mask length for RP selection |
0-32 |
PRIORITY |
Priority value for candidate bootstrap router |
0-255 |
INTERVAL |
Interval value for candidate bootstrap router |
1-107374177 |
Command Mode
Global Config
Default
None
Usage
None
Examples
This example shows how to configure the candidate BSR:
Switch# configure terminal
Switch(config)# ip pim bsr-candidate eth-0-1
This example shows how to cancel the candidate BSR configured:
Switch# configure terminal
Switch(config)# no ip pim bsr-candidate
Related Commands
ip pim bsr-border
8.4.4. ip pim bsr-border
Command Purpose
Use this command to configure the border of pim domain.
To remove the configurations of the border of pim domain, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim bsr-border
no ip pim bsr-border
Command Mode
Interface Configuration
Default
Disable
Usage
None
Examples
This example shows how to configure the border of pim domain:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim bsr-border
This example shows how to remove the configurations of the border of pim domain:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ip pim bsr-border
Related Commands
ip pim bsr-candidate
8.4.5. ip pim dr-priority
Command Purpose
Use this command to configure DR priority.
To reset it to default value, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim dr-priority PRIORITY
no ip pim dr-priority
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
PRIORITY |
The DR priority |
0-4294967294 |
Command Mode
Interface Configuration
Default
1
Usage
When a hello message without DR priority is received, it will be regarded to have the max DR priority and to be elected as DR. When more than one router’s hello messages do not have DR priority, the one which have the highest ip address will be elected as DR.
Examples
This example shows how to set the pim router DR priority to 1000:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim dr-priority 1000
This example shows how tos reset the pim router DR priority to default value:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ip pim dr-priority
Related Commands
None
8.4.6. ip pim exclude-genid
Command Purpose
Use this command to exclude generation id option from pim hello packets on this interface.
To reset to the default setting, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim exclude-genid
no ip pim exclude-genid
Command Mode
Interface Configuration
Default
Disable
Usage
GenerationID is the ID of a PIM neighbour, it is carried in PIM hello message,the receiver device will record every received GenerationID in the hello packet and check if GenerationID has changed, if GenerationID changed, will consider neighbour state changed and restart state machine.
Examples
This example shows how to exclude generation id option from pim hello packets on this interface:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim exclude-genid
This example shows how to reset the generation id option to the default setting:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ip pim exclude-genid
Related Commands
None
8.4.7. ip pim hello-interval
Command Purpose
Use this command to configure the interval for pim hello packets on this interface.
To reset to the default setting, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim hello-interval INTERVAL
no ip pim hello-interval
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
INTERVAL |
The pim hello message interval in second |
1-18724 |
Command Mode
Interface Configuration
Default
30s
Usage
None
Examples
This example shows how to set the pim hello message interval to 100s:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim hello-interval 100
This example shows how to reset the pim hello message interval to default value:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ip pim hello-interval
Related Commands
None
8.4.8. ip pim ignore-rp-set-priority
Command Purpose
Use this command to ignore RP set priority value.
To not ignore the priority, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim ignore-rp-set-priority
no ip pim ignore-rp-set-priority
Command Mode
Global Config
Default
Not ignore RP set priority value.
Usage
None
Examples
This example shows how to ignore RP set priority value:
Switch# configure terminal
Switch(config)# ip pim ignore-rp-set-priority
This example shows how to reset the configurations to default value:
Switch# configure terminal
Switch(config)# no ip pim ignore-rp-set-priority
Related Commands
None
8.4.9. ip pim jp-timer
Command Purpose
Use this command to set the join/prune timer value.
To reset the timer to default value, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim jp-timer TIMER
no ip pim jp-timer
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
TIMER |
The Join/Prune timer value (second) |
1-65535 |
Command Mode
Global Config
Default
60s
Usage
None
Examples
This example shows how to set the join/prune timer value to 100s:
Switch# configure terminal
Switch(config)# ip pim jp-timer 100
This example shows how to reset the join/prune timer value to default value:
Switch# configure terminal
Switch(config)# no ip pim jp-timer
Related Commands
None
8.4.10. ip pim neighbor-filter
Command Purpose
Use this command to add an access-list to filter the neighbor.
To remove this filter, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim neighbor-filter LIST
no ip pim neighbor-filter
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
LIST |
The name of the access-list |
Up to 40 characters |
Command Mode
Interface Configuration
Default
None
Usage
Neighbors will send hello messages to each other to establish connections with other neighbors. You can use this command to filter which neighbors can be connected or not.
Examples
This example shows how to establish neighbors based on access-list acl1:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim neighbor-filter acl1
This example shows how to cancel the filter:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ip pim neighbor-filter
Related Commands
None
8.4.11. ip pim register-rate-limit
Command Purpose
Use this command to set the rate limit for pim registers.
To reset the rate limit to default value, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim register-rate-limit LIMIT
no ip pim register-rate-limit
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
LIMIT |
The rate limit for pim registers send from dr to rp |
1-65535 |
Command Mode
Global Config
Default
By default, will not limit PIM register messages, if a limit is set, PIM register messages will be discard when pakcet reached by this limit.
Usage
There is no rate limit for pim registers by default.
When the rate limit is configured, the exceed pim register message will be dropped on the rp.
Examples
This example shows how to set the rate limit for pim registers to 100 per second:
Switch# configure terminal
Switch(config)# ip pim register-rate-limit 100
This example shows how to cancel the rate limit:
Switch# configure terminal
Switch(config)# no ip pim register-rate-limit
Related Commands
ip pim register-rp-reachability
ip pim register-source
ip pim register-suppression
8.4.12. ip pim register-source
Command Purpose
Use this command to set the source address for pim register.
To reset the source address for pim register to default value, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim register-source IFNAME
no ip pim register-source
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
IFNAME |
The name of the interface. Use the address of this interface to be the source address for pim register |
Support physical/aggregation/loopback/vlan/tunnel ports |
Command Mode
Global Config
Default
The source address for pim register is the interface ip of dr by default.
Usage
None
Examples
This example shows how to set the source address for pim register to the ip address of interface eth-0-1:
Switch# configure terminal
Switch(config)# ip pim register-source eth-0-1
This example shows how to reset the source address for pim register to default value:
Switch# configure terminal
Switch(config)# no ip pim register-source
Related Commands
ip pim register-rate-limit
ip pim register-rp-reachability
ip pim register-suppression
8.4.13. ip pim register-rp-reachability
Command Purpose
Use this command to enable rp reachability check for pim registers.
To disable this check, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim register-rp-reachability
no ip pim register-rp-reachability
Command Mode
Global Config
Default
Disable.
Usage
None
Examples
This example shows how to enable rp reachability check for pim registers:
Switch# configure terminal
Switch(config)# ip pim register-rp-reachability
This example shows how to disable rp reachability check for pim registers:
Switch# configure terminal
Switch(config)# no ip pim register-rp-reachability
Related Commands
ip pim register-rate-limit
ip pim register-source
ip pim register-suppression
8.4.14. ip pim register-suppression
Command Purpose
Use this command to set the register suppression time.
To reset this time to default value, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim register-suppression TIME
no ip pim register-suppression
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
TIME |
The register suppression time in seconds |
11-18000 seconds |
Command Mode
Global Config
Default
60s
Usage
None
Examples
This example shows how to set the register suppression time to 100s:
Switch# configure terminal
Switch(config)# ip pim register-suppression 100
This example shows how to reset the register suppression time to default value:
Switch# configure terminal
Switch(config)# no ip pim register-suppression
Related Commands
ip pim register-rate-limit
ip pim register-rp-reachability
ip pim register-source
8.4.15. ip pim rp-address
Command Purpose
Use this command to set the pim rp (rendezvous point) address.
To remove this setting, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim rp-address IP_ADDR ( LIST | override | )
no ip pim rp-address IP_ADDR ( LIST | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
IP_ADDR |
The rp address |
IPv4 Address |
LIST |
The name of an access-list |
Up to 40 characters |
override |
Overrides dynamically learned RP mappings |
- |
Command Mode
Global Config
Default
None
Usage
None
Examples
This example shows how to set the pim rp address to 1.1.1.1:
Switch# configure terminal
Switch(config)# ip pim rp-address 1.1.1.1
This example shows how to remove the rp address 1.1.1.1:
Switch# configure terminal
Switch(config)# no ip pim rp-address 1.1.1.1
Related Commands
ip pim rp-candidate
ip pim rp-register-kat
8.4.16. ip pim rp-candidate
Command Purpose
Use this command to set the candidate rp.
To remove the candidate rp, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim rp-candidate IFNAME ( { priority PRIORITY | interval INTERVAL | group-list LIST } | )
no ip pim rp-candidate ( IFNAME | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
IFNAME |
The name of the interface to be the candidate rp |
Support physical/aggregation/loopback/vlan/tunnel ports |
PRIORITY |
The Candidate-RP priority |
0-255 |
INTERVAL |
The C-RP advertisement interval in seconds |
1-16383 seconds |
LIST |
Group ranges for this C-RP, only permit filters would be cared |
Up to 40 characters |
Command Mode
Global Config
Default
None
Usage
None
Examples
This example shows how to set the interface eth-0-1 to be the candidate rp:
Switch# configure terminal
Switch(config)# ip pim rp-candidate eth-0-1
This example shows how to cancel the configured candidate rp:
Switch# configure terminal
Switch(config)# no ip pim rp-candidate eth-0-1
Related Commands
ip pim rp-address
8.4.17. ip pim rp-register-kat
Command Purpose
Use this command to set the keepalive timer (KAT) for (S,G) at RP from PIM registers.
To reset this timer to default value, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim rp-register-kat TIME
no ip pim rp-register-kat
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
TIME |
The KAT time in seconds |
1-65535 seconds |
Command Mode
Global Config
Default
None
Usage
The register message send from dr will add an entry on rp. This entry will be aged when the keepalive timer expired which can be configured by this command.
Examples
This example shows how to set the keepalive timer to 100s at RP from PIM registers:
Switch# configure terminal
Switch(config)# ip pim rp-register-kat 100
This example shows how to reset this timer to default value:
Switch# configure terminal
Switch(config)# no ip pim rp-register-kat
Related Commands
ip pim rp-address
ip pim rp-candidate
8.4.18. ip pim spt-switch-threshold infinity
Command Purpose
Use this command to set the spt switch threshold to infinity.
To cancel this setting, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim spt-switch-threshold infinity ( group-list LIST | )
no ip pim spt-switch-threshold infinity ( group-list LIST | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
LIST |
Group address access list |
Up to 40 characters |
Command Mode
Global Config
Default
The DR will switch to spt immediately when received the first multicast packet by default.
Usage
None
Examples
This example shows how to set the spt switch threshold to infinity:
Switch# configure terminal
Switch(config)# ip pim spt-switch-threshold infinity
This example shows how to reset the spt-switch-threshold to default:
Switch# configure terminal
Switch(config)# no ip pim spt-switch-threshold infinity
Related Commands
show ip pim sparse-mode spt-threshold
8.4.19. ip pim cisco-register-checksum
Command Purpose
Use this command to calculate register checksum over whole packet (cisco compatibility).
To remove this setting, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim cisco-register-checksum ( group-list LIST | )
no ip pim cisco-register-checksum ( group-list LIST | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
LIST |
Group address access list |
String of no more than 40 characters |
Command Mode
Global Config
Default
The register checksum defined in RFC is used by default.
Usage
The register checksum defined in RFC is used by default,if group-list is configured, only packets that verified can be sent in CISCO way.
Examples
This example shows how to set to calculate register checksum over whole packet:
Switch# configure terminal
Switch(config)# ip pim cisco-register-checksum
This example shows how to remove this setting:
Switch# configure terminal
Switch(config)# no ip pim cisco-register-checksum
Related Commands
None
8.4.20. ip pim sparse-mode
Command Purpose
Use this command to enable pim sparse mode on the interface.
To disable pim sparse mode, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim sparse-mode ( passive | )
no ip pim sparse-mode ( passive | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
passive |
Pim passive mode (local members only) |
- |
Command Mode
Interface Configuration
Default
Disable
Usage
The pim hello message will not be sent out from the interface when the passive mode is configured.
Examples
This example shows how to enable pim sparse mode on the interface:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim sparse-mode
This example shows how to disable pim sparse mode on the interface:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ip pim sparse-mode
This example shows how to enable pim sparse mode passive on the interface:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim sparse-mode passive
Related Commands
None
8.4.21. ip pim dense-mode
Command Purpose
Use this command to enable pim dense mode on the interface.
To disable pim dense mode, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim dense-mode ( passive | )
no ip pim dense -mode
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
passive |
Pim passive mode (local members only) |
- |
Command Mode
Interface Configuration
Default
Disable
Usage
Pim spasre-mode and dense-mode can not take effect on the same interface. The pim hello message will not be sent out from the interface when the passive mode is configured.
Examples
This example shows how to enable pim dense mode on the interface:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim dense-mode
This example shows how to disable pim dense mode on the interface:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ip pim dense-mode
This example shows how to enable pim dense mode passive on the interface:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim dense-mode passive
Related Commands
None
8.4.22. ip pim propagation-delay
Command Purpose
Use this command to set propagation delay on its LAN.
To cancel this setting, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim propagation-delay timer
no ip pim propagation-delay
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
timer |
Propagation delay value |
100-5000 ms |
Command Mode
Interface Configuration
Default
1000ms
Usage
If all routers on a LAN support the LAN Prune Delay option, then the PIM routers on that LAN will use the values received to adjust their J/P_Override_Interval on that interface and the interface is LAN Delay Enabled
Examples
This example shows how to set propagation delay:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim propagation-delay 400
This example shows how to unset this setting:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ip pim propagation-delay
Related Commands
None
8.4.23. ip pim state-refresh origination-interval
Command Purpose
Use this command to set the interval of originator sending state refresh messages.
To cancel this setting, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim state-refresh origination-interval INTERVAL
no ip pim state-refresh origination-interval
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
INTERVAL |
state-refreshorigination-interval |
1-100 seconds |
Command Mode
Interface Configuration
Default
60s
Usage
State Refresh Messages are generated periodically by the PIM-DM router directly connected to a source. This command can control the interval of two messages
Examples
This example shows how to set state-refresh origination-interval:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim state-refresh origination-interval 50
This example shows how to unset this setting:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ip pim state-refresh origination-interval
Related Commands
None
8.4.24. ip pim unicast-bsm
Command Purpose
Use this command to enable sending and receiving of unicast BSM for backward compatibility.
To cancel this setting, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim unicast-bsm
no ip pim unicast-bsm
Command Mode
Interface Configuration
Default
Disable
Usage
Interface will send BSM message to the whole pim domain by default.
Examples
This example shows how to enable sending and receiving of unicast BSM for backward compatibility:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim unicast-bsm
This example shows how to cancel this setting:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ip pim unicast-bsm
Related Commands
None
8.4.25. ip pim ssm
Command Purpose
Use this command to enable pim-ssm and set ssm group range.
To cancel this setting, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim ssm ( default | range LIST )
no ip pim ssm
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
default |
Use 232.0.0.0/8 group range for SSM |
- |
LIST |
ACL for group range to be used for SSM |
Up to 40 characters |
Command Mode
Global Config
Default
Disable
Usage
None
Examples
This example shows how to enable pim-ssm and set ssm group range to default:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim ssm default
This example shows how to cancel this setting:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim ssm default
Related Commands
None
8.4.26. ip pim graceful-restart
Command Purpose
Use this command to enable pim graceful-restart and set the GR period time.
To disable pim graceful-restart or set default GR period time, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim graceful-restart ( period TIME | )
no ip pim graceful-restart ( period TIME | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
TIME |
Pim graceful-restart period time |
90-3600 seconds |
Command Mode
Global Config
Default
120 seconds
Usage
The pim graceful-restart can be enabled in stacking system.
Examples
This example shows how to enable pim graceful-restart:
Switch# configure terminal
Switch(config)# ip pim graceful-restart
This example shows how to disable pim graceful-restart:
Switch# configure terminal
Switch(config)# no ip pim graceful-restart
This example shows how to configure pim GR period for the interface:
Switch# configure terminal
Switch(config)# ip pim graceful-restart period 100
Related Commands
None
8.4.27. show ip pim sparse-mode bsr-router
Command Purpose
Use this command to show the information of bootstrap router.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim sparse-mode bsr-router
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display the information of bootstrap router:
Switch# show ip pim sparse-mode bsr-router
PIMv2 bootstrap information
This system is the bootstrap router (BSR)
BSR address: 12.0.9.2
Uptime: 00:00:08, BSR Priority: 64, Hash mask length: 10
Next bootstrap message in 00:00:04
Role: Candidate BSR
State: Elected BSR
Candidate RP: 12.0.9.2(eth-0-9)
Advertisement interval 60 seconds
Next C-RP advertisement in 00:00:57
Related Commands
None
8.4.28. show ip pim sparse-mode interface
Command Purpose
Use this command to show the information of pim interface.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim sparse-mode interface ( detail | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
detail |
Detailed interface information |
- |
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display the information of pim interface:
Switch# show ip pim sparse-mode interface detail
eth-0-9 (vif 0):
Address 12.0.9.1, DR 12.0.9.2
Hello period 30 seconds, Next Hello in 26 seconds
Triggered Hello period 5 seconds
Neighbors:
12.0.9.2
Related Commands
None
8.4.29. show ip pim sparse-mode local-member
Command Purpose
Use this command to show the pim local membership information.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim sparse-mode local-member ( IFNAME | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
IFNAME |
Interface name |
Support physical/aggregation/loopback/vlan/tunnel ports |
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display pim local membership information:
Switch# show ip pim sparse-mode local-members
PIM local membership information
eth-0-3:
(*, 229.1.1.1) : Include
eth-0-9:
(*, 228.1.1.1) : Include
Related Commands
None
8.4.30. show ip pim sparse-mode mroute
Command Purpose
Use this command to show the mroute information of pim sparse mode.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim sparse-mode mroute ( SRC_ADDR | GRP_ADDR | ) ( detail | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
SRC_ADDR |
Source address |
IPv4 Address |
GRP_ADDR |
Group address |
IPv4 Address |
detail |
Detailed interface information |
- |
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display pim mroute information:
Switch# show ip pim sparse-mode mroute detail
IP Multicast Routing Table
(*,*,RP) Entries: 0
(*,G) Entries: 2
(S,G) Entries: 0
(S,G,rpt) Entries: 0
FCR Entries: 0
(*, 228.1.1.1) Uptime: 00:09:55
RP: 0.0.0.0, RPF nbr: None, RPF idx: None
Upstream:
State: NOT JOINED, SPT Switch: Enabled, JT: off
Downstream:
eth-0-9:
State: NO INFO, ET: off, PPT: off
Assert State: NO INFO, AT: off
Winner: 0.0.0.0, Metric: 4294967295, Pref: 4294967295, RPT bit: on
Local Olist:
eth-0-9
(*, 229.1.1.1) Uptime: 00:04:22
RP: 12.0.9.2, RPF nbr: 12.0.9.2, RPF idx: eth-0-9
Upstream:
State: JOINED, SPT Switch: Enabled, JT Expiry: 40 secs
Macro state: Join Desired,
Downstream:
eth-0-3:
State: NO INFO, ET: off, PPT: off
Assert State: NO INFO, AT: off
Winner: 0.0.0.0, Metric: 4294967295, Pref: 4294967295, RPT bit: on
Macro state: Could Assert, Assert Track
Local Olist:
eth-0-3
Related Commands
None
8.4.31. show ip pim sparse-mode neighbor
Command Purpose
Use this command to show the neighbor information of pim sparse mode.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim sparse-mode neighbor ( ( IFNAME ( address | ) ) | detail | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
IFNAME |
Interface name |
Support physical/aggregation/loopback/vlan/tunnel ports |
address |
Neighbor address |
- |
detail |
Detailed interface information |
- |
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display the neighbor information of pim sparse mode:
Switch# show ip pim sparse-mode neighbor
Neighbor Interface Uptime/Expires Ver DR
Address Priority/Mode
12.0.9.2 eth-0-9 00:18:18 /00:01:20 v2 1 / DR
Related Commands
None
8.4.32. show ip pim sparse-mode rp mapping
Command Purpose
Use this command to show group to rp mappings.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim sparse-mode rp mapping
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display group to rp mappings:
Switch# show ip pim sparse-mode rp mapping
PIM group-to-RP mappings
Group(s): 224.0.0.0/4
RP: 12.0.9.2
Info source: 12.0.9.2, via bootstrap, priority 192
Uptime: 00:22:56, expires: 00:01:34
Related Commands
None
8.4.33. show ip pim sparse-mode rp-hash
Command Purpose
Use this command to show the information of rp to be chosen based on group selected.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim sparse-mode rp-hash GRP_ADDR
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
GRP_ADDR |
Multicast group address |
- |
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display the information of rp to be chosen based on group 224.0.0.10:
Switch# show ip pim sparse-mode rp-hash 224.0.0.10
RP: 12.0.9.2
Info source: 12.0.9.2, via bootstrap
Related Commands
None
8.4.34. show ip pim sparse-mode spt-threshold
Command Purpose
Use this command to show the rpt to spt threshold of pim sparse mode.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim sparse-mode spt-threshold
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display the rpt to spt threshold of pim sparse mode:
Switch# show ip pim sparse-mode spt-threshold
PIM spare-mode immediately switches over to SPT upon receiving the first traffic
Related Commands
None
8.4.35. show ip pim dense-mode interface
Command Purpose
Use this command to show the interface information of pim sparse mode.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim dense-mode interface ( detail | )
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display the interface information of pim dense mode:
Switch# show ip pim dense-mode interface
Address Interface VIFIndex Ver/ Nbr
Mode Count
2.2.2.1 eth-0-2 0 v2/D 0
3.3.3.1 eth-0-3 2 v2/D 0
Related Commands
None
8.4.36. show ip pim dense-mode mroute
Command Purpose
Use this command to show the mroute information of pim dense mode.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim dense-mode mroute
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display pim mroute information:
Switch# show ip pim dense-mode mroute
PIM-DM Multicast Routing Table
(2.2.2.2, 225.1.2.3)
Source directly connected on eth-0-2
State-Refresh Originator State: Originator
Upstream IF: eth-0-2
Upstream State: Forwarding
Assert State: NoInfo
Downstream IF List:
eth-0-3, in 'olist':
Downstream State: NoInfo
Assert State: NoInfo
(2.2.2.2, 225.1.2.4)
Source directly connected on eth-0-2
State-Refresh Originator State: Originator
Upstream IF: eth-0-2
Upstream State: Forwarding
Assert State: NoInfo
Downstream IF List:
eth-0-3, in 'olist':
Downstream State: NoInfo
Assert State: NoInfo
Related Commands
None
8.4.37. show ip pim dense-mode neighbor
Command Purpose
Use this command to show the neighbor information of pim dense mode.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim sparse-mode neighbor ( detail | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
detail |
Detailed interface information |
- |
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display the neighbor information of pim dense mode:
Switch# show ip pim dense-mode neighbor
Neighbor-Address Interface Uptime/Expires Ver
4.4.4.4 eth-0-9 03d19h16m/00:01:29 v2
3.3.3.2 agg3 03d19h17m/00:01:37 v2
Related Commands
None
8.4.38. show ip pim dense-mode nexthop
Command Purpose
Use this command to show the nexthop information of pim dense mode.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim sparse-mode nexthop
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display the nexthop information of pim dense mode:
Switch# show ip pim dense-mode nexthop
Destination Nexthop Nexthop Nexthop Metric Pref
Num Addr Interface
1.1.1.2 0 - - - -
Related Commands
None
8.4.39. show ip pim dense-mode interface
Command Purpose
Use this command to show the interface information of pim sparse mode.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim dense-mode interface ( detail | )
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display the interface information of pim dense mode:
Switch# show ip pim dense-mode interface
Address Interface VIFIndex Ver/ Nbr
Mode Count
2.2.2.1 eth-0-2 0 v2/D 0
3.3.3.1 eth-0-3 2 v2/D 0
Related Commands
None
8.4.40. show ip pim dense-mode mroute
Command Purpose
Use this command to show the mroute information of pim dense mode.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim dense-mode mroute
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display pim mroute information:
Switch# show ip pim dense-mode mroute
PIM-DM Multicast Routing Table
(2.2.2.2, 225.1.2.3)
Source directly connected on eth-0-2
State-Refresh Originator State: Originator
Upstream IF: eth-0-2
Upstream State: Forwarding
Assert State: NoInfo
Downstream IF List:
eth-0-3, in 'olist':
Downstream State: NoInfo
Assert State: NoInfo
(2.2.2.2, 225.1.2.4)
Source directly connected on eth-0-2
State-Refresh Originator State: Originator
Upstream IF: eth-0-2
Upstream State: Forwarding
Assert State: NoInfo
Downstream IF List:
eth-0-3, in 'olist':
Downstream State: NoInfo
Assert State: NoInfo
Related Commands
None
8.4.41. show ip pim sparse-mode nexthop-virtual-pair
Command Purpose
Use this command to show the pim nexthop virtual address mapping information.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim sparse-mode nexthop-virtual-pair
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display the pim nexthop virtual address mapping information:
Switch# show ip pim sparse-mode nexthop-virtual-pair
pim nexthop address virtual address
10.1.1.2 20.1.1.2
Related Commands
None
8.4.42. ip pim nexthop-address
Command Purpose
Use this command to set the virtual address of the pim nexthop address.
To cancel this setting, use the no form of this command.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
ip pim nexthop-address NEXTHOP-ADDRESS virtual-address VIRTUAL-ADDRESS
no ip pim nexthop-address ( NEXTHOP-ADDRESS | )
Parameter |
Parameter Description |
Parameter Value |
---|---|---|
NEXTHOP-ADDRESS |
nexthop address |
IPv4 Address |
VIRTUAL-ADDRESS |
virtual address |
IPv4 Address |
Command Mode
Global Config
Default
None
Usage
When PIM use virtual address to connect neighbour, Use this command to the virtual address of the pim nexthop address.
The command is used to enable the linkage between PIM-SM and VRRP,when enbale the command,it need to shutdown or no shutdown the port of ip pim bsr.
When enable the command, it also can be take effect if enable or disable the vrrp.
Examples
This example shows how to set a nexthop address with virtual address:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# ip pim nexthop-address 10.1.1.2 virtual-address 20.1.1.2
This example shows how to unset this setting:
Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ip pim nexthop-address
Related Commands
None
8.4.43. show ip pim graceful-restart
Command Purpose
Use this command to show the pim graceful restart status.
Prerequisites
Platform |
Software |
License |
Comments |
---|---|---|---|
AQ-N3000 |
7.0 |
Base |
|
AQ-N5000 |
7.0 |
Base |
|
AQ-N6000 |
7.0 |
Base |
Command Syntax
show ip pim graceful-restart
Command Mode
Privileged EXEC
Default
None
Usage
None
Examples
This example shows how to display the pim graceful restart status:
Switch# show ip pim graceful-restart
PIMSM Graceful Restart enabled with GR period 300 seconds
Current runnig status is Not at restart period
Related Commands
None