9.4. PIMv6 Commands

Command Purpose

Use this command to apply an access-list to limit the ipv6 pim register message received by rp.

To remove this setting, use the no form of this command.

Prerequisites

Command Syntax

ipv6 pim accept-register list LISTNAME

no ipv6 pim accept-register

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 ipv6 pim register message received by rp:

Switch# configure terminal
Switch(config)# ipv6 pim accept-register list acl1

This example shows how to remove the limits:

Switch# configure terminal
Switch(config)# no ipv6 pim accept-register

Related Commands

None

Command Purpose

Use this command to set anycast rendezvous-point.

To remove the configurations, use the no form of this command.

Prerequisites

Command Syntax

ipv6 pim anycast-rp ANYCAST_RP_ADDR ANYCAST_MEMBER_ADDR

no ipv6 pim anycast-rp ANYCAST_RP_ADDR ( ANYCAST_MEMBER_ADDR | )

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)# ipv6 pim anycast-rp 2001::2 2001::10

This example shows how to remove the member in anycast rendezvous-point:

Switch# configure terminal
Switch(config)# no ipv6 pim anycast-rp 2001::2 2001::10

Related Commands

None

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

Command Syntax

ipv6 pim bsr-candidate IFNAME ( HASH_MASK ( PRIORITY ) | )

no ipv6 pim bsr-candidate

Command Mode

Global Config

Default

None

Usage

None

Examples

This example shows how to configure the candidate BSR:

Switch# configure terminal
Switch(config)# ipv6 pim bsr-candidate eth-0-1

This example shows how to cancel the candidate BSR configured:

Switch# configure terminal
Switch(config)# no ipv6 pim bsr-candidate

Related Commands

ipv6 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

Command Syntax

ipv6 pim bsr-border

no ipv6 pim bsr-border

Command Mode

Interface Configuration

Default

None

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)# ipv6 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 ipv6 pim bsr-border

Related Commands

ipv6 pim bsr-candidate

Command Purpose

Use this command to configure the DR priority.

To return it to default value, use the no form of this command.

Prerequisites

Command Syntax

ipv6 pim dr-priority PRIORITY

no ipv6 pim dr-priority

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 ipv6 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)# ipv6 pim dr-priority 1000

This example shows how to return the pim router DR priority to default value:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ipv6 pim dr-priority

Related Commands

None

Command Purpose

Use this command to exclude generation id option from pim hello packets on this interface.

To return to the default setting, use the no form of this command.

Prerequisites

Command Syntax

ipv6 pim exclude-genid

no ipv6 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)# ipv6 pim exclude-genid

This example shows how to return the generation id option to the default setting:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ipv6 pim exclude-genid

Related Commands

None

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

Command Syntax

ipv6 pim hello-interval INTERVAL

no ipv6 pim hello-interval

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)# ipv6 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 ipv6 pim hello-interval

Related Commands

None

Command Purpose

Use this command to ignore RP set priority value.

To not ignore the priority, use the no form of this command.

Prerequisites

Command Syntax

ipv6 pim ignore-rp-set-priority

no ipv6 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)# ipv6 pim ignore-rp-set-priority

This example shows how to return the configurations to default value:

Switch# configure terminal
Switch(config)# no ipv6 pim ignore-rp-set-priority

Related Commands

None

Command Purpose

Use this command to set the join/prune timer value.

To return the timer to default value, use the no form of this command.

Prerequisites

Command Syntax

ipv6 pim jp-timer SECOND

no ipv6 pim jp-timer

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)# ipv6 pim jp-timer 100

This example shows how to return the join/prune timer value to default value:

Switch# configure terminal
Switch(config)# no ipv6 pim jp-timer

Related Commands

None

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

Command Syntax

ipv6 pim neighbor-filter LISTNAME

no ipv6 pim neighbor-filter

Command Mode

Interface Configuration

Default

None

Usage

Neighbours would send hello message to eachother to establish connections with other neighbour，you can use this command to filter which neighbour 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)# ipv6 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 ipv6 pim neighbor-filter

Related Commands

None

Command Purpose

Use this command to set the rate limit for pim registers.

To return the rate limit to default value, use the no form of this command.

Prerequisites

Command Syntax

ipv6 pim register-rate-limit LIMIT

no ipv6 pim register-rate-limit

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)# ipv6 pim register-rate-limit 100

This example shows how to cancel the rate limit:

Switch# configure terminal
Switch(config)# no ipv6 pim register-rate-limit

Related Commands

ipv6 pim register-rp-reachability

ipv6 pim register-source

ipv6 pim register-suppression

Command Purpose

Use this command to set the source address for pim register.

To return the source address for pim register to default value, use the no form of this command.

Prerequisites

Command Syntax

ipv6 pim register-source IFNAME

no ipv6 pim register-source

Command Mode

Global Config

Default

The source address for pim register is the interface ipv6 address of dr by default.

Usage

None

Examples

This example shows how to set the source address for pim register to the ipv6 address of interface eth-0-1:

Switch# configure terminal
Switch(config)# ipv6 pim register-source eth-0-1

This example shows how to return the source address for pim register to default value:

Switch# configure terminal
Switch(config)# no ipv6 pim register-source

Related Commands

ipv6 pim register-rate-limit

ipv6 pim register-rp-reachability

ipv6 pim register-suppression

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

Command Syntax

ipv6 pim register-rp-reachability

no ipv6 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)# ipv6 pim register-rp-reachability

This example shows how to disable rp reachability check for pim registers:

Switch# configure terminal
Switch(config)# no ipv6 pim register-rp-reachability

Related Commands

ipv6 pim register-rate-limit

ipv6 pim register-source

Command Purpose

Use this command to set the register suppression time.

To return this time to default value, use the no form of this command.

Prerequisites

Command Syntax

ipv6 pim register-suppression SECOND

no ipv6 pim register-suppression

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)# ipv6 pim register-suppression 100

This example shows how to return the register suppression time to default value:

Switch# configure terminal
Switch(config)# no ipv6 pim register-suppression

Related Commands

ipv6 pim register-rate-limit

ipv6 pim register-rp-reachability

ipv6 pim register-source

Command Purpose

Use this command to set the ipv6 pim rp (rendezvous point) address.

To remove it, use the no form of this command.

Prerequisites

Command Syntax

ipv6 pim rp-address IPV6_ADDR ( LISTNAME | override | )

no ipv6 pim rp-address IPV6_ADDR ( LISTNAME | )

Command Mode

Global Config

Default

None

Usage

None

Examples

This example shows how to set the pim rp address to 2001::2:

Switch# configure terminal
Switch(config)# ipv6 pim rp-address 2001::2

This example shows how to remove the rp address 2001::2:

Switch# configure terminal
Switch(config)# no ipv6 pim rp-address 2001::2

Related Commands

ipv6 pim rp-candidate

ipv6 pim rp-register-kat

Command Purpose

Use this command to set the candidate rp.

To remove the candidate rp, use the no form of this command.

Prerequisites

Command Syntax

ipv6 pim rp-candidate IFNAME ( { priority PRIORITY | interval INTERVAL | group-list LISTNAME } | )

no ipv6 pim rp-candidate ( IFNAME | )

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)# ipv6 pim rp-candidate eth-0-1

This example shows how to cancel the configured candidate rp:

Switch# configure terminal
Switch(config)# no ipv6 pim rp-candidate eth-0-1

Related Commands

ipv6 pim rp-address

Command Purpose

Use this command to set the keepalive timer (KAT) for (S,G) at RP from PIM registers.

To return this timer to default value, use the no form of this command.

Prerequisites

Command Syntax

ipv6 pim rp-register-kat SECOND

no ipv6 pim rp-register-kat

Command Mode

Global Config

Default

185s

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)# ipv6 pim rp-register-kat 100

This example shows how to return this timer to default value:

Switch# configure terminal
Switch(config)# no ipv6 pim rp-register-kat

Related Commands

ipv6 pim rp-address

ipv6 pim rp-candidate

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

Command Syntax

ipv6 pim spt-switch-threshold infinity ( group-list LISTNAME | )

no ipv6 pim spt-switch-threshold infinity ( group-list LISTNAME | )

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)# ipv6 pim spt-switch-threshold infinity

This example shows how to return the spt-switch-threshold to default:

Switch# configure terminal
Switch(config)# no ipv6 pim spt-switch-threshold infinity

Related Commands

show ipv6 pim sparse-mode spt-threshold

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

Command Syntax

ipv6 pim cisco-register-checksum ( group-list LISTNAME | )

no ipv6 pim cisco-register-checksum ( group-list LISTNAME | )

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)# ipv6 pim cisco-register-checksum

This example shows how to remove this setting:

Switch# configure terminal
Switch(config)# no ipv6 pim cisco-register-checksum

Related Commands

None

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

Command Syntax

ipv6 pim sparse-mode ( passive | )

no ipv6 pim sparse-mode ( passive | )

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)# ipv6 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 ipv6 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)# ipv6 pim sparse-mode passive

Related Commands

None

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

Command Syntax

ipv6 pim unicast-bsm

no ipv6 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)# ipv6 pim unicast-bsm

This example shows how to cancel this setting:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ipv6 pim unicast-bsm

Related Commands

None

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

Command Syntax

ipv6 pim ssm ( default | range LISTNAME )

no ipv6 pim ssm

Command Mode

Global Config

Default

Disable

Usage

Enable pim-ssm and set ssm group range.

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)# ipv6 pim ssm default

This example shows how to cancel this setting:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# no ipv6 pim ssm

Related Commands

None

Command Purpose

Use this command to show the information of bootstrap router.

Prerequisites

Command Syntax

show ipv6 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 ipv6 pim sparse-mode bsr-router

PIM6v2 Bootstrap information
This system is the Bootstrap Router (BSR)
  BSR address: 2001:2::1 (?)
  Uptime:      00:00:08, BSR Priority: 64, Hash mask length: 126
  Next bootstrap message in 00:00:52
  Role: Candidate BSR
  State: Elected BSR

Related Commands

None

Command Purpose

Use this command to show the information of pim interface.

Prerequisites

Command Syntax

show ipv6 pim sparse-mode interface ( detail | )

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to display the information of pim interface:

Switch# show ipv6 pim sparse-mode interface detail

eth-0-1 (vif 0): 
  Address fe80::9c7c:7eff:fe94:8300, DR fe80::9c7c:7eff:fe94:8300
  Hello period 30 seconds, Next Hello in 3 seconds
  Triggered Hello period 5 seconds
  Secondary addresses:
   2001:1::1
  Neighbors:

Related Commands

None

Command Purpose

Use this command to show the pim local membership information.

Prerequisites