Cisco IOS XR Commands by Software Package, Release 3.8.0

VRRP Commands on Cisco IOS XR Software

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

For detailed information about VRRP concepts, configuration tasks, and examples, see the Cisco IOS XR IP Addresses and Services Configuration Guide.

clear vrrp statistics

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

clear vrrp statistics [interface interface-type instance [vrid]]

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator.For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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.

Examples

The following example shows how to clear vrrp statistics:

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

Related Commands

interface (VRRP)

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

interface type interface-path-id

no interface type interface-path-id

Syntax Description

Defaults

VRRP is disabled.

Command Modes

VRRP configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator.For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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

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

Examples

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 10.0.1.20

Related Commands

router vrrp

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

router vrrp

no router vrrp

Syntax Description

The command has no argument or keywords.

Defaults

VRRP is not configured.

Command Modes

Global configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator.For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Use the router vrrp command to enter VRRP configuration mode.

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

Examples

The following example shows how to configure a VRRP with 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 priority 254

Related Commands

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 EXEC mode.

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

Syntax Description

Defaults

No default behavior or values

Command Modes

EXEC

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator.For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

If no interface is specified, all virtual routers are displayed.

Examples

The following sample output is from the show vrrp command:

RP/0/RP0/CPU0:router# show 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         10.0.1.20

Te0/3/0/2      7  100   P Init     unknown         10.1.13.0

Table 101 describes the significant fields shown in the display.

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

RP/0/RP0/CPU0:router# show vrrp detail

GigabitEthernet0/5/0/0 - vrID 1

  State is Master

    2 state changes, last state change 00:00:28

  Virtual IP address is 4.0.0.100

  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 100, may preempt

      minimum delay 0 secs

TenGigE0/3/0/0 - vrID 1

  State is Init

    0 state changes, last state change never

  Virtual IP address is 10.0.1.20

  Virtual MAC address is 0000.5E00.0101

  Master router is unknown

  Advertise time 1 secs

    Master Down Timer 3.609 (3 x 1 + 156/256)

  Current priority 100

    Configured priority 100, may preempt

      minimum delay 0 secs

TenGigE0/3/0/2 - vrID 7

  State is Init

    0 state changes, last state change never

  Virtual IP address is 10.1.13.0

  Virtual MAC address is 0000.5E00.0107

  Master router is unknown

  Advertise time 1 secs

    Master Down Timer 3.609 (3 x 1 + 156/256)

  Current priority 100

    Configured priority 100, may preempt

      minimum delay 0 secs

TenGigE0/2/0/4 - vrID 2

   State is Master

     16 state changes, last state change 00:04:55

   Virtual IP address is 7.7.7.123

   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)

   Current priority 80

     Configured priority 100, may preempt

       minimum delay 0 secs

  Tracked items: 1/3 up: 20 decrement

                                            Priority

      Interface                  State     Decrement

      POS0/5/0/2                 Down            10

      POS0/5/0/1                 Down            10

      TenGigE0/3/0/3             Up              10

Table 102 describes the significant fields shown in the displays.

The following sample output is from the show vrrp command with the interface and detail keywords for 10-Gigabit Ethernet interface 0/3/0/0:

RP/0/RP0/CPU0:router# show vrrp interface gigabitEthernet 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         10.0.1.20

Te0/3/0/2      7  100   P Init     unknown         10.1.13.0

Table 103 describes the significant fields shown in the displays.

Related Commands

vrrp assume-ownership disable

The VRRP router assumes ownership of the virtual IP Address in the master state by default. To disable this feature, use the vrrp assume ownership disable command in VRRP interface configuration mode. To restore the default setting (assumed ownership), use the no form of this command.

vrrp vrid assume-ownership disable

no vrrp vrid assume- ownership disable

Syntax Description

Defaults

The master router assumes ownership by default and accepts IP packets sent to the Virtual IP address.

Command Modes

VRRP interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator.For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

By default, a router that is not the IP address owner, but is the master router for another IP address, accepts and responds to pings and accepts a Telnet to that router. Accepting packets sent to the other IP address is a useful tool during verification of network configuration. The vrrp assume-ownership disable command specifies that the router should not assume ownership of the virtual IP address if it is the master router regardless of whether it is the IP address owner, which means that it will not accept packets sent to that IP address during verification of network configuration.This command is ignored (irrelevant) when the router is the IP address owner (section 6.4.3 of RFC 2338, Virtual Router Redundancy Protocol).

Examples

The following example shows how the configuration disables the vrrp assume-ownership command 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 10.0.0.101 secondary

RP/0/RP0/CPU0:router(config-vrrp-if)# vrrp 1 assume-ownership disable

Related Commands

vrrp delay

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

vrrp delay {minimum value reload value}

no vrrp delay

Syntax Description

Defaults

minimum value: 1
reload value: 5

Command Modes

VRRP interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator.For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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.

Examples

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 mgmtEth 0/RP0/CPU0/0

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

Related Commands

vrrp ipv4

To enable the Virtual Router Redundancy Protocol (VRRP) on an interface and specify the IP address of the virtual router, use the vrrp ipv4 command in VRRP interface configuration mode. To disable VRRP on the interface and remove the IP address of the virtual router, use the no form of this command.

vrrp vrid ipv4 ip-address [secondary]

no vrrp vrid ipv4 ip-address [secondary]

Syntax Description

Defaults

VRRP is not configured on the interface.

Command Modes

VRRP interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator.For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Configure the vrrp ipv4 command once without the secondary keyword to indicate the virtual router IP address. If you want to indicate additional IP addresses supported by the virtual router, include the secondary keyword.

Removing the VRRP configuration from the IP address owner and leaving the IP address of the interface active is considered a misconfiguration because this results in duplicate IP addresses on the LAN.

Examples

The following example shows how to enable VRRP on 10-Gigabit Ethernet interface 0/3/0/0. The VRRP virtual router identifier is 1, and 10.0.1.20 is the IP address of the virtual router.

RP/0/RP0/1:router(config)# router vrrp

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

RP/0/RP0/1:router(config-vrrp-if)# vrrp 1 ipv4 10.0.1.20 secondary

Related Commands

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 vrrp preempt disable command. To delay preemption, so that the higher priority router waits for a period of time before taking over, use the vrrp preempt delay command. To restore the default behavior (preempt enabled with no delay), use the no form of the command.

vrrp vrid preempt [delay seconds | disable]

no vrrp vrid preempt [delay seconds | disable]

Syntax Description

Defaults

VRRP preempt is enabled.

seconds: 0 (no delay)

Command Modes

VRRP interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator.For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Using the delay keyword, you 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.

Examples

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 TenGigE 0/3/0/0

RP/0/RP0/CPU0:router(config-vrrp-if)# vrrp 1 preempt delay 15

RP/0/RP0/CPU0:router(config-vrrp-if)# vrrp 1 priority 200

Related Commands

vrrp priority

To set the priority of the virtual router, use the vrrp priority command in VRRP interface configuration mode. To remove the priority of the virtual router, use the no form of this command.

vrrp vrid priority priority

no vrrp vrid priority priority

Syntax Description

Defaults

priority: 100

Command Modes

VRRP interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator.For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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

Examples

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 TenGigE 0/3/0/0

RP/0/RP0/CPU0:router(config-vrrp-if)# vrrp 1 priority 254

Related Commands

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 vrrp text-authentication command in VRRP interface configuration mode. To disable VRRP authentication, use the no form of this command.

vrrp vrid text-authentication string

no vrrp vrid text-authentication [string]

Syntax Description

Defaults

No authentication of VRRP messages occurs.

Command Modes

VRRP interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator.For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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.

Examples

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 TenGigE 0/3/0/0

RP/0/RP0/CPU0:router(config-vrrp-if)# vrrp 1 text-authentication x30dn78k

Related Commands

vrrp timer

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

vrrp vrid timer [msec] interval [force]

no vrrp vrid timer [msec] interval [force]

Syntax Description

Defaults

interval: 1 second

Command Modes

VRRP interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator.For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Examples

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 TenGigE 0/3/0/0

RP/0/RP0/CPU0:router(config-vrrp-if)# vrrp 1 timer 4

Related Commands

vrrp track interface

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

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

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

Syntax Description

Defaults

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

Command Modes

VRRP interface configuration

Command History

Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator.For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

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.

Examples

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 vrrp 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 TenGigE 0/3/0/0

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

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

RP/0/RP0/CPU0:router(config-vrrp-if)# vrrp 1 preempt delay 15

RP/0/RP0/CPU0:router(config-vrrp-if)# vrrp 1 ipv4 192.92.72.46

Related Commands