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