VRRP Commands


Note

All commands applicable for the Cisco NCS 5500 Series Router are also supported on the Cisco NCS 540 Series Router that is introduced from Cisco IOS XR Release 6.3.2. References to earlier releases in Command History tables apply to only the Cisco NCS 5500 Series Router.



Note

  • Starting with Cisco IOS XR Release 6.6.25, all commands applicable for the Cisco NCS 5500 Series Router are also supported on the Cisco NCS 560 Series Routers.

  • Starting with Cisco IOS XR Release 6.3.2, all commands applicable for the Cisco NCS 5500 Series Router are also supported on the Cisco NCS 540 Series Router.

  • References to releases before Cisco IOS XR Release 6.3.2 apply to only the Cisco NCS 5500 Series Router.

  • Cisco IOS XR Software Release 7.0.1 specific updates are not applicable for the following variants of Cisco NCS 540 Series Routers:

    • N540-28Z4C-SYS-A

    • N540-28Z4C-SYS-D

    • N540X-16Z4G8Q2C-A

    • N540X-16Z4G8Q2C-D

    • N540-12Z20G-SYS-A

    • N540-12Z20G-SYS-D

    • N540X-12Z16G-SYS-A

    • N540X-12Z16G-SYS-D


This document describes the Cisco IOS XR software commands used to configure and monitor the Virtual Router Redundancy Protocol (VRRP) features.

For detailed information about VRRP concepts, configuration tasks, and examples, refer to the IP Addresses and Services Configuration Guide for Cisco NCS 5500 Series RoutersIP Addresses and Services Configuration Guide for Cisco NCS 540 Series Routers.

accept-mode

To disable the installation of routes for the Virtual Router Redundancy Protocol (VRRP) virtual addresses, use the accept-mode command in the VRRP virtual router submode. To enable the installation of routes for the VRRP virtual addresses, use the no form of this command.

accept-mode disable

no accept-mode disable

Syntax Description

disable

Disables the accept mode.

Command Default

By default, the accept mode is enabled.

Command Modes

VRRP virtual router configuration

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
vrrp

read, write

Example

This example shows how to disable the installation of routes for the VRRP virtual addresses:


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# router vrrp 
RP/0/RP0/CPU0:router(config-vrrp)# interface  0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 3 version 2
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)# accept-mode disable
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)#

accept-mode(slave)

To disable the installation of routes for the Virtual Router Redundancy Protocol (VRRP) virtual addresses, use the accept-mode command in the VRRP slave submode. To enable the installation of routes for the VRRP virtual addresses, use the no form of this command.

accept-mode disable

no accept-mode disable

Syntax Description

disable

Disables the accept mode.

Command Default

By default, the accept mode is enabled.

Command Modes

VRRP slave submode configuration

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
vrrp

read, write

Example

This example shows how to disable the installation of routes for the VRRP virtual addresses:


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# router vrrp 
RP/0/RP0/CPU0:router(config-vrrp)# interface tenGigE 0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 3 slave
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)# accept-mode disable
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)#

address-family

To enable address-family mode, use the address-family command in interface configuration mode. To terminate address-family mode, use the no form of this command.

address-family { ipv4 | ipv6 }

no address-family { ipv4 | ipv6 }

Syntax Description

ipv4

IPv4 address-family.

ipv6

IPv6 address-family.

Command Default

None.

Command Modes

Interface configuration

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation

vrrp

read, write

Example

The following example shows how to enable address-family mode:



RP/0/RP0/CPU0:router # config
RP/0/RP0/CPU0:router(config)# router vrrp
RP/0/RP0/CPU0:router(config-vrrp)# interface  0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4

address (VRRP)

To configure the primary virtual IPv4 address for a virtual router, use the address command in the Virtual Router Redundancy Protocol (VRRP) virtual router submode. To deconfigure the primary virtual IPv4 address for the virtual router, use the no form of this command.

address address

no address address

Syntax Description

address

VRRP IPv4 address.

Command Default

None

Command Modes

VRRP virtual router

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
vrrp

read, write

Example

This example shows how to set the primary virtual IPv4 address for the virtual router:


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# router vrrp 
RP/0/RP0/CPU0:router(config-vrrp)# interface  0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 3 version 3
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)# address 192.168.18.1 
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)#

address global

To configure the global virtual IPv6 address for a virtual router, use the address global command in the Virtual Router Redundancy Protocol (VRRP) virtual router submode. To deconfigure the global virtual IPv6 address for a virtual router, use the no form of this command.

address global ipv6-address

no address global ipv6-address

Syntax Description

ipv6-address

Global VRRP IPv6 address.

Command Default

None

Command Modes

VRRP virtual router

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
vrrp

read, write

Example

This example shows how to add a global virtual IPv6 address for the virtual router:


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# router vrrp 
RP/0/RP0/CPU0:router(config-vrrp)# interface  0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv6
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 3 
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)# address global 4000::1000 
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)#

address linklocal

To either configure the virtual link-local IPv6 address for a virtual router or to specify that the virtual link-local IPv6 address should be enabled and calculated automatically from the virtual router virtual Media Access Control (MAC) address, use the address linklocal command in the Virtual Router Redundancy Protocol (VRRP) virtual router submode. To deconfigure the virtual link-local IPv6 address for a virtual router, use the no form of this command.

address linklocal [ ipv6-address | autoconfig ]

no address linklocal [ ipv6-address | autoconfig ]

Syntax Description

ipv6-address

VRRP IPv6 link-local address.

autoconfig

Autoconfigures the VRRP IPv6 link-local address.

Command Default

None

Command Modes

VRRP virtual router

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
vrrp

read, write

Example

This example shows how to autoconfigure the VRRP IPv6 link-local address:


RP/0/RP0/CPU0:router#configure 
RP/0/RP0/CPU0:router(config)#router vrrp 
RP/0/RP0/CPU0:router(config-vrrp)#interface  0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)#address-family ipv6
RP/0/RP0/CPU0:router(config-vrrp-address-family)#vrrp 3
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)#address linklocal autoconfig 
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)#

This example shows how to configure the virtual link-local IPv6 address for the virtual router:


RP/0/RP0/CPU0:router#configure 
RP/0/RP0/CPU0:router(config)#router vrrp 
RP/0/RP0/CPU0:router(config-vrrp)#interface  0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)#address-family ipv6
RP/0/RP0/CPU0:router(config-vrrp-address-family)#vrrp 3
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)#address linklocal FE80::260:3EFF:FE11:6770 
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)#


Note

The version keyword is available only if IPv4 address-family is selected. By default, version is set to 3 for IPv6 address families.


address secondary

To configure the secondary virtual IPv4 address for a virtual router, use the address secondary command in the Virtual Router Redundancy Protocol (VRRP) virtual router submode. To deconfigure the secondary virtual IPv4 address for a virtual router, use the no form of this command.

address address secondary

no address address secondary

Syntax Description

secondary

Sets the secondary VRRP IP address.

address

VRRP IPv4 address.

Command Default

None

Command Modes

VRRP virtual router

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
vrrp

read, write

Example

This example shows how to set the secondary virtual IPv4 address for the virtual router:


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# router vrrp 
RP/0/RP0/CPU0:router(config-vrrp)# interface  0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 3 version 2
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)# address 192.168.18.1 secondary
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)#

clear vrrp statistics

To reset the Virtual Router Redundancy Protocol (VRRP) statistics (to zero or default value), use the clear vrrp statistics command in XR EXEC mode.

clear vrrp statistics { ipv4 | | ipv6 } [ interface type interface-path-id [ vrid ] ]

Syntax Description

ipv4

(Optional) Resets the IPv4 information.

ipv6

(Optional) Resets the IPv6 information.

interface type

(Optional) Interface type. For more information, use the question mark (?) online help function.

interface-path-id

(Optional) Either a physical interface instance or a virtual interface instance as follows:

  • Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

    • rack: Chassis number of the rack.

    • slot: Physical slot number of the modular services card or line card.

    • module: Module number. A physical layer interface module (PLIM) is always 0.

    • port: Physical port number of the interface.

  • Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.

vrid

(Optional) Virtual router identifier, which is the number identifying the virtual router for which status is displayed.

Command Default

No default behavior or values

Command Modes

XR EXEC mode

Usage Guidelines

If no interface is specified, the statistics for all virtual routers on all interfaces are cleared.

If no value for vrid is specified, the statistics for all virtual routers on the specified interface are cleared.

Task ID

Task ID

Operations

vrrp

read, write

The following example shows how to clear vrrp statistics:


RP/0/RP0/CPU0:router# clear vrrp statistics

delay (VRRP)

To configure the activation delay for a VRRP router, use the delay command in interface configuration mode. To delete the activation delay, use the no form of this command.

delay minimum value reload value

no delay

Syntax Description

minimum value

Sets the minimum delay in seconds for every interface up event. Range is 0 to 10000.

reload value

Sets the reload delay in seconds for first interface up event. Range is 0 to 10000.

Command Default

minimum value: 1

reload value: 5

Command Modes

VRRP interface configuration

Usage Guidelines

The vrrp delay command delays the start of the VRRP finite state machine (FSM) on an interface up event to ensure that the interface is ready to pass traffic. This ensures that there are no mistaken state changes due to loss of hello packets. The minimum delay is applied on all interface up events and the reload delay is applied on the first interface up event.

The values of zero must be explicitly configured to turn this feature off.

Task ID

Task ID

Operations

vrrp

read, write

The following example shows how to configure a minimum delay of 10 seconds with a reload delay of 100 seconds:


RP/0/RP0/CPU0:router(config)# router vrrp
RP/0/RP0/CPU0:router(config-vrrp)# interface /CPU0/0
RP/0/RP0/CPU0:router(config-vrrp-if)# delay minimum 10 reload 100

hw-module vrrpscale enable

To increase the scale limit of VRRP sessions to 255, use the hw-module vrrpscale enable command in the global confiuration mode. You can use the no form of this command to disable this command.

hw-module vrrpscale enable

no hw-module vrrpscale enable

Table 1. Syntax Description

hw-module

Configures the hardware module.

vrrpscale

Configures scaling for VRRP sessions.

enable

Enables scaling of VRRP sessions.

Command Default

None.

Command Mode

Global configuration mode.

Command History

Release Modification
Release 6.6.1 This command was introduced.

Usage Guidelines

Reload the router after you enable or disable this command.

Task ID Operations
VRRP read, write

Example

This example shows you how to increase the scale of VRRP sessions to up to 255 on a node:

Router# config
Router(config)# hw-module vrrpscale enable
Router(config)# commit

interface (VRRP)

To enable VRRP interface configuration mode, use the interface (VRRP) command in VRRP configuration mode. To terminate VRRP interface configuration mode, use the no form of this command.

interface type interface-path-id

no interface type interface-path-id

Syntax Description

type

Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Physical interface or virtual interface.

Note 

Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

Command Default

VRRP is disabled.

Command Modes

VRRP configuration

Usage Guidelines

Use the interface (VRRP) command to enter VRRP interface configuration mode.

You must configure all VRRP configuration commands in VRRP interface configuration mode.

Task ID

Task ID

Operations

vrrp

read, write

The following example shows how to configure VRRP and a virtual router 1 on 10-Gigabit Ethernet interface 0/3/0/0:


RP/0/RP0/CPU0:router(config)# router vrrp
RP/0/RP0/CPU0:router(config-vrrp)# interface TenGigE 0/3/0/0
RP/0/RP0/CPU0:router(config-vrrp-if)# vrrp 1 ipv4 192.168.18.1


RP/0/RP0/CPU0:router# config
RP/0/RP0/CPU0:router(config)# router vrrp
RP/0/RP0/CPU0:router(config-vrrp)# interface  0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 3 version 2
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)#

message state disable

To disable the task of logging the Virtual Router Redundancy Protocol (VRRP) state change events via syslog, use the message state disable command in the VRRP virtual router submode. To re-enable the task of logging the VRRP state change events , use the no form of this command.

message state disable

no message state disable

Syntax Description

This command has no keywords or arguments.

Command Default

By default, the task of logging the VRRP state change events is enabled.

Command Modes

VRRP global

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
vrrp

read, write

Example

This example shows how to disable the logging of VRRP state change events:


RP/0/RP0/CPU0:router#configure
RP/0/RP0/CPU0:router(config)#router vrrp
RP/0/RP0/CPU0:router(config-vrrp)#message state disable 
RP/0/RP0/CPU0:router(config-vrrp)#

router vrrp

To configure Virtual Router Redundancy Protocol (VRRP), use the router vrrp command in XR Config mode. To remove the VRRP configuration, use the no form of this command.

router vrrp

no router vrrp

Command Default

This command has no keywords or arguments.

VRRP is disabled.

Command Modes

XR Config mode

Usage Guidelines

Use the router vrrp command to enter VRRP configuration mode.

You must configure all VRRP configuration commands in VRRP interface configuration mode.

Task ID

Task ID

Operations

vrrp

read, write

The following example shows how to configure a VRRP with virtual router 1 on an interface:



RP/0/RP0/CPU0:router# config
RP/0/RP0/CPU0:router(config)# router vrrp
RP/0/RP0/CPU0:router(config-vrrp)# interface  0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 3 version 2
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)#

session name(vrrp)

To configure a VRRP session name, use the session name command in the VRRP virtual router submode. To deconfigure a VRRP session name, use the no form of this command.

name name

no name name

Syntax Description

name

MGO session name

Command Default

None

Command Modes

VRRP virtual router configuration

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
vrrp

read

Example

This example shows how to configure a VRRP session name.


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# router vrrp 
RP/0/RP0/CPU0:router(config-vrrp)# interface tenGigE 0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-ipv4)# vrrp 1
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)# name s1
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)#

show vrrp

To display a brief or detailed status of one or all Virtual Router Redundancy Protocol (VRRP) virtual routers, use the show vrrp command in XR EXEC mode.

show vrrp [ ipv4 | ipv6 ] [ interface type interface-path-id ] [ brief | detail | statistics [all] ]

Syntax Description

ipv4

(Optional) Displays the IPv4 information.

ipv6

(Optional) Displays the IPv6 information.

interface

(Optional) Displays the status of the virtual router interface.

type

Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Physical interface or virtual interface.

Note 

Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

brief

(Optional) Provides a summary view of the virtual router information.

detail

(Optional) Displays detailed running state information.

statistics

(Optional) Displays total statistics.

all

(Optional) Displays statistics for each virtual router.

Command Modes

XR EXEC mode

Usage Guidelines

If no interface is specified, all virtual routers on all interfaces are displayed. If no vrid is specified, all vrids on the given interface are displayed.

Task ID

Task ID

Operations

vrrp

read

The following sample output is from the show vrrp command:


RP/0/RP0/CPU0:routershow vrrp 

                      A indicates IP address owner
                      | P indicates configured to preempt
                      | |
Interface   vrID Prio A P State    Master addr     VRouter addr
Te0/3/0/0      1  100   P Init     unknown         192.168.18.10
Te0/3/0/2      7  100   P Init     unknown         192.168.19.1

This table describes the significant fields shown in the display.

Table 2. show vrrp Command Field Descriptions

Field

Description

Interface

Interface of the virtual router.

vrID

ID of the virtual router.

Prio

Priority of the virtual router.

A

Indicates whether the VRRP router is the IP address owner.

P

Indicates whether the VRRP router is configured to preempt (default).

State

State of the virtual router.

Master addr

IP address of the master router.

VRouter addr

Virtual router IP address of the virtual router.

The following sample output is from the show vrrp command with the detail keyword:



RP/0/RP0/CPU0:router# show vrrp detail
0/4/0/0 – IPv4 vrID 1
  State is Master, IP address owner
    2 state changes, last state change 00:00:59
  Virtual IP address is 192.168.10.1
    Secondary Virtual IP address is 192.168.10.2
    Secondary Virtual IP address is 192.168.11.1
  Virtual MAC address is 0000.5E00.0101
  Master router is local
  Advertise time 1 secs
    Master Down Timer 3.609 (3 x 1 + 156/256)
  Minimum delay 1 sec, reload delay 5 sec
  Current priority 100
    Configured priority 110, may preempt
      Minimum delay 0 secs
  Authentication enabled, string “myauth”
  BFD enabled: state Up, interval 15ms multiplier 3 remote IP 192.168.10.3
    Tracked items:
                                        Priority
    Interface                State     Decrement
    0/5/0/1                Down            10

0/4/0/0 – IPv4 vrID 2
  State is Backup
    3 state changes, last state change 00:01:58
  Virtual IP address is 192.168.10.2
  Virtual MAC address is 0000.5E00.0102
  Master router is IP address owner (192.168.11.1), priority 200
  Advertise time 1.500 secs (forced)
    Master Down Timer 5.109 (3 x 1 + 156/256)
  Minimum delay 1 sec, reload delay 5 sec
  Current priority 100
    Configured priority 100, may preempt
      Minimum delay 20 secs


Bundle-Ether1 – IPv4 vrID 5
  State is Init
    0 state changes, last state change never
  Virtual IP address is unknown
  Virtual MAC address is 0000.5E00.0100
  Master router is unknown
  Advertise time 1 secs 
    Master Down Timer 3.500 (3 x 1 + 128/256)
  Minimum delay 1 sec, reload delay 5 sec
  Current priority 128
    Configured priority 128

0/4/0/0 – IPv6 vrID 1
  State is Master
    2 state changes, last state change 00:10:01
  Virtual Linklocal address is FE80::100
    Global Virtual IPv6 address is 4000::100
    Global Virtual IPv6 address is 5000::100
  Virtual MAC address is 0000.5E00.0201
  Master router is local
  Advertise time 1 secs 
    Master Down Timer 3.609 (3 x 1 + 156/256)
  Minimum delay 1 sec, reload delay 5 sec
  Current priority 100
    Configured priority 100, may preempt
      Minimum delay 0 secs   


This table describes the significant fields shown in the displays.

Table 3. show vrrp detail Command Field Descriptions

Field

Description

0/3/0/0 - vrID 1

Interface type and number, and VRRP group number.

State is

Role this interface plays within VRRP (master or backup).

Virtual IP address is

Virtual IP address for this virtual router.

Virtual MAC address is

Virtual MAC address for this virtual router.

Master router is

Location of the master router.

Advertise time

Interval (in seconds) at which the router sends VRRP advertisements when it is the master virtual router. This value is configured with the vrrp timer command.

Master Down Timer

Time the backup router waits for the master router advertisements before assuming the role of master router.

Minimum delay

Time that the state machine start-up is delayed when an interface comes up, giving the network time to settle. The minimum delay is the delay that is applied after any subsequent interface up event (if the interface flaps) and the reload delay is the delay applied after the first interface up event.

Current priority

Priority of the virtual router.

Configured priority

Priority configured on the virtual router.

may preempt

Indication of whether preemption is enabled or disabled.

minimum delay

Delay time before preemption (default) occurs.

Tracked items

Section indicating the items being tracked by the VRRP router.

Interface

Interface being tracked.

State

State of the tracked interface.

Priority Decrement

Priority to decrement from the VRRP priority when the interface is down.

The following sample output is from the show vrrp command with the interface for Ethernet interface 0/3/0/0:


RP/0/RP0/CPU0:router# show vrrp interface 0/3/0/0

                      A indicates IP address owner
                      | P indicates configured to preempt
                      | |
Interface   vrID Prio A P State    Master addr     VRouter addr
Te0/3/0/0      1  100   P Init     unknown         192.168.10.20
Te0/3/0/2      7  100   P Init     unknown         192.168.20.0

slave follow(vrrp)

To instruct the slave group to inherit its state from a specified group, use the slave follow command in VRRP slave submode.

follow mgo-session-name

Syntax Description

mgo-session-name

Name of the MGO session from which the slave group will inherit the state.

Command Default

None

Command Modes

VRRP slave submode configuration

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
vrrp

read, write

Example

This example shows how to instruct the slave group to inherit its state from a specified group.


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# router vrrp 
RP/0/RP0/CPU0:router(config-vrrp)# interface tenGigE 0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 2 slave 
RP/0/RP0/CPU0:router(config-vrrp-slave)# follow m1


Note

Before configuring a slave group to inherit its state from a specified group, the group must be configured with the session name command on another vrrp group.


slave primary virtual IPv4 address(vrrp)

To configure the primary virtual IPv4 address for the slave group, use the slave primary virtual IPv4 address command in the VRRP slave submode.

address ip-address

Syntax Description

ip-address

IP address of the Hot Standby router interface.

Command Default

None

Command Modes

VRRP slave submode configuration

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
vrrp

read, write

Example

This example shows how to configure the primary virtual IPv4 address for the slave group.


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# router vrrp 
RP/0/RP0/CPU0:router(config-vrrp)# interface tenGigE 0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 2 slave 
RP/0/RP0/CPU0:router(config-vrrp-slave)# address 192.168.10.4

slave secondary virtual IPv4 address(vrrp)

To configure the secondary virtual IPv4 address for the slave group, use the slave secondary virtual IPv4 address command in the VRRP slave submode.

address ip-address secondary

Syntax Description

ip-address

IP address of the Hot Standby router interface.

secondary

Sets the secondary hot standby IP address.

Command Default

None

Command Modes

VRRP slave submode configuration

Usage Guidelines

Before configuring secondary virtual IPv4 address, the primary virtual IPv4 address for the slave group must be configured.

Task ID

Task ID Operation
vrrp

read, write

Example

This example shows how to configure the secondary virtual IPv4 address for the slave group.


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# router vrrp 
RP/0/RP0/CPU0:router(config-vrrp)# interface tenGigE 0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 2 slave 
RP/0/RP0/CPU0:router(config-vrrp-slave)# address 192.168.10.4 secondary

snmp-server traps vrrp events

To enable the Simple Network Management Protocol (SNMP) server notifications (traps) available for VRRP, use the snmp-server traps vrrp events command in XR Config mode. To disable all available VRRP SNMP notifications, use the no form of this command.

snmp-server traps vrrp events

no snmp-server traps vrrp events

Syntax Description

events

Specifies all VRRP SNMP server traps.

Command Default

None

Command Modes

XR Config mode

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID

Operations

snmp

read, write

The following example shows how to enable snmpserver notifications for VRRP:


RP/0/RP0/CPU0:routerrouter(config)# snmp-server traps vrrp events

track object(vrrp)

To enable tracking of a named object with the specified decrement, use the track object command in VRRP virtual router submode. To remove the tracking, use the no form of this command.

track object name [priority-decrement]

no track object name [priority-decrement]

Syntax Description

object name

Object tracking. Name of the object to be tracked.

priority-decrement

(Optional) Amount by which the VRRP priority for the router is decremented when the interface goes down (or comes back up). Range is 1 to 255.

Command Default

The default priority-decrement is 10.

Command Modes

VRRP virtual router configuration

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
vrrp

read, write

Example

This example shows how to configure object tracking under the VRRP virtual router submode.


RP/0/RP0/CPU0:router# configure 
RP/0/RP0/CPU0:router(config)# router vrrp 
RP/0/RP0/CPU0:router(config-vrrp)# interface tenGigE 0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-ipv4)# vrrp 1
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)# track object t1 2
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)#

vrrp

To enable Virtual Router Redundancy Protocol (VRRP) virtual router mode, use the vrrp command in address-family mode. To terminate VRRP virtual router mode, use the no form of this command.

vrrp vrid version version-no

no vrrp vrid version version-no

Syntax Description

vrid

(Optional) Virtual router identifier, which is the number identifying the virtual router for which status is displayed. The virtual router identifier is configured with the vrrp ipv4 command. Range is 1 to 255.

version version-no

The VRRP version number. Range is 2-3.

Note 

The version keyword is available only for the ipv4 address family. By default, version is set to 3 for IPv6 address families.

Command Default

None.

Command Modes

address-family

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID Operation
vrrp

read, write

Example

The following example shows how to enable VRRP virtual router mode:



RP/0/RP0/CPU0:router# config
RP/0/RP0/CPU0:router(config)# router vrrp
RP/0/RP0/CPU0:router(config-vrrp)# interface  0/4/0/4
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 3 version 2
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)# 

vrrp preempt

VRRP preempt is enabled by default. This means, a VRRP router with higher priority than the master VRRP router will take over as master router. To disable this feature, use the preempt disable command. To delay preemption, so that the higher priority router waits for a period of time before taking over, use the preempt delay command. To restore the default behavior (preempt enabled with no delay), use the no form of the command.

preempt { delay seconds | disable }

no preempt { delay seconds | disable }

Syntax Description

delay seconds

Specifies the number of seconds the router delays before issuing an advertisement claiming virtual IP address ownership to be the master router. Range is 1 to 3600 seconds (1 hour).

disable

Disables preemption

Command Default

VRRP preempt is enabled.

seconds : 0 (no delay)

Command Modes

VRRP virtual router

Usage Guidelines

, can configure a delay, which causes the VRRP router to wait the specified number of seconds before issuing an advertisement claiming virtual IP address ownership to be the master router.


Note

The router that is the virtual IP address owner preempts, regardless of the setting of this command.


Task ID

Task ID

Operations

vrrp

read, write

The following example shows how to configure the router to preempt the current master router when its priority of 200 is higher than that of the current master router. If the router preempts the current master router, it waits 15 seconds before issuing an advertisement claiming that it is the master router.


RP/0/RP0/CPU0:router(config)# router vrrp
RP/0/RP0/CPU0:router(config-vrrp)# interface  0/3/0/0
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 1 version 3 
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)# preempt delay 15
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)# priority 200

vrrp priority

To set the priority of the virtual router, use the priority command in VRRP virtual router submode. To remove the priority of the virtual router, use the no form of this command.

priority priority

no priority priority

Syntax Description

priority

Priority of the virtual router. Range is 1 to 254.

Command Default

priority : 100

Command Modes

VRRP virtual router

Usage Guidelines

Use this command to control which router becomes the master router. This command is ignored while the router is the virtual IP address owner.

Task ID

Task ID

Operations

vrrp

read, write

The following example shows how to configure the router with a priority of 254:


RP/0/RP0/CPU0:router(config)# router vrrp
RP/0/RP0/CPU0:router(config-vrrp)# interface  0/3/0/0
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 1 version 3 
RP/0/RP0/CPU0:router(config-vrrp-virtual router)# priority 254

vrrp text-authentication

To configure the simple text authentication used for Virtual Router Redundancy Protocol (VRRP) packets received from other routers running VRRP, use the text-authentication command in VRRP virtual router submode. To disable VRRP authentication, use the no form of this command.

text-authentication string

no text-authentication [string]

Syntax Description

string

Authentication string (up to eight alphanumeric characters) used to validate incoming VRRP packets.

Command Default

No authentication of VRRP messages occurs.

Command Modes

VRRP virtual router

Usage Guidelines

When a VRRP packet arrives from another router in the VRRP group, its authentication string is compared to the string configured on the local system. If the strings match, the message is accepted. If they do not match, the packet is discarded.

All routers within the group must be configured with the same authentication string.


Note

Plain text authentication is not meant to be used for security. It simply provides a way to prevent a misconfigured router from participating in VRRP.


Task ID

Task ID

Operations

vrrp

read, write

The following example shows how to configure an authentication string of x30dn78k:


RP/0/RP0/CPU0:router(config)# router vrrp
RP/0/RP0/CPU0:router(config-vrrp)# interface  0/3/0/0
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 1 version 2 
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)# text-authentication x30dn78k

Note

Text authentication is only valid for VRRP version 2 routers.


vrrp timer

To configure the interval between successive advertisements by the master router in a Virtual Router Redundancy Protocol (VRRP) virtual router, use the timer command in VRRP virtual router submode. To restore the default value, use the no form of this command.

timer [msec] interval [force]

no timer [msec] interval [force]

Syntax Description

msec

(Optional) Changes the unit of the advertisement time from seconds to milliseconds. Without this keyword, the advertisement interval is in seconds. Range is 20 to 3000 milliseconds.

interval

Time interval between successive advertisements by the master router. The unit of the interval is in seconds, unless the msec keyword is specified. Range is 1 to 255 seconds.

force

(Optional) Forces the configured value to be used. This keyword is required if milliseconds is specified.

Command Default

interval :1 second

Command Modes

VRRP virtual router

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID

Operations

vrrp

read, write

The following example shows how to configure the master router to send advertisements every 4 seconds:


RP/0/RP0/CPU0:router(config)# router vrrp
RP/0/RP0/CPU0:router(config-vrrp)# interface  0/3/0/0
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 1 version 3 
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)# timer 4

vrrp track interface

To configure the Virtual Router Redundancy Protocol (VRRP) to track an interface, use the track interface command in VRRP virtual router submode. To disable the tracking, use the no form of this command.

track interface type interface-path-id [priority-decrement]

no track interface type interface-path-id [priority-decrement]

Syntax Description

vrid

Virtual router identifier, which is the number identifying the virtual router to which tracking applies.

type

Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Physical interface or virtual interface.

Note 

Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

priority-decrement

(Optional) Amount by which the priority for the router is decremented (or incremented) when the tracked interface goes down (or comes back up). Decrements can be set to any value between 1 and 254. Default value is 10.

Command Default

The default decrement value is 10. Range is 1 to 254.

Command Modes

VRRP virtual router

Usage Guidelines

The vrrp track interface command ties the priority of the router to the availability of its interfaces. It is useful for tracking interfaces that are not configured for VRRP. Only IP interfaces are tracked. A tracked interface is up if IP on that interface is up. Otherwise, the tracked interface is down.

You can configure VRRP to track an interface that can alter the priority level of a virtual router for a VRRP virtual router. When the IP protocol state of an interface goes down or the interface has been removed from the router, the priority of the backup virtual router is decremented by the value specified in the priority-decrement argument. When the IP protocol state on the interface returns to the up state, the priority is restored.

Task ID

Task ID

Operations

vrrp

read, write

In the following example, 10-Gigabit Ethernet interface 0/3/0/0 tracks interface 0/3/0/3 and 0/3/0/2. If one or both of these two interfaces go down, the priority of the router decreases by 10 (default priority decrement) for each interface. The default priority decrement is changed using the priority-decrement argument. In this example, because the default priority of the virtual router is 100, the priority becomes 90 when one of the tracked interfaces goes down and the priority becomes 80 when both go down. See the priority command for details on setting the priority of the virtual router.


RP/0/RP0/CPU0:router(config)# router vrrp
RP/0/RP0/CPU0:router(config-vrrp)# interface  0/3/0/0
RP/0/RP0/CPU0:router(config-vrrp-if)# address-family ipv4
RP/0/RP0/CPU0:router(config-vrrp-address-family)# vrrp 1 version 3 
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)# track interface  0/3/0/3
RP/0/RP0/CPU0:router(config-vrrp-virtual-router)# track interface  0/3/0/2