Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show vrrp

Syntax

Description

Display status information about Virtual Router Redundancy Protocol (VRRP) groups.

Options

none

(Same as brief) Display brief status information about all VRRP interfaces.

brief | detail | extensive | summary

(Optional) Display the specified level of output.

interface interface-name <group number>

(Optional) Display information and status about the specified VRRP interface and, optionally, the group number.

logical-system logical-system-name

(Optional) Perform this operation on a particular logical system.

nsr

(Optional) Display state replication information when graceful Routing Engine switchover (GRES) with nonstop active routing (NSR) is configured. Use only on the backup Routing Engine.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show vrrp command. Output fields are listed in the approximate order in which they appear

Table 1: show vrrp Output Fields

Field Name

Field Description

Level of Output

Interface

Name of the logical interface.

brief extensive none summary

Interface index

Physical interface index number, which reflects its initialization sequence.

extensive

Groups

Total number of VRRP groups configured on the interface.

extensive

Active

Total number of VRRP groups that are active (that is, whose interface state is either up or down).

extensive

Interface VRRP PDU statistics

Non-errored statistics for the logical interface:

  • Advertisement sent—Number of VRRP advertisement protocol data units (PDUs) that the interface has transmitted.

  • Advertisement received—Number of VRRP advertisement PDUs received by the interface.

  • Packets received—Number of VRRP packets received for VRRP groups on the interface.

  • No group match received—Number of VRRP packets received for VRRP groups that do not exist on the interface.

extensive

Interface VRRP PDU error statistics

Errored statistics for the logical interface:

  • Invalid IPAH next type received—Number of packets received that use the IP Authentication Header protocol (IPAH) and that do not encapsulate VRRP packets.

  • Invalid VRRP ttl value received—Number of packets received whose IP time- to-live (TTL) value is not 255.

  • Invalid VRRP version received—Number of packets received whose VRRP version is not 2.

  • Invalid VRRP pdu type received—Number of packets received whose VRRP PDU type is not 1.

  • Invalid VRRP authentication type received—Number of packets received whose VRRP authentication is not none, simple, or md5.

  • Invalid VRRP IP count received—Number of packets received whose VRRP IP count exceeds 8.

  • Invalid VRRP checksum received—Number of packets received whose VRRP checksum does not match the calculated one.

extensive

Physical interface

Name of the physical interface.

detail extensive

Unit

Logical unit number.

All levels

Address

Address of the physical interface.

brief detail extensive none

Index

Physical interface index number, which reflects its initialization sequence.

detail extensive

SNMP ifIndex

SNMP index number for the physical interface.

detail extensive

VRRP-Traps

Status of VRRP traps: Enabled or Disabled.

detail extensive

VRRP-Version

VRRP version: 2 or 3.

detail extensive

Type and Address

Identifier for the address and the address itself:

  • lcl—Configured local interface address.

  • mas—Address of the primary virtual router. This address is displayed only when the local interface is acting as a backup router.

  • vip—Configured virtual IP addresses.

brief none summary

Interface state/Int state/State

State of the physical interface:

  • down—The device is present and the link is unavailable.

  • not present—The interface is configured, but no physical device is present.

  • unknown—The VRRP process has not had time to query the kernel about the state of the interface.

  • up—The device is present and the link is established.

brief extensive none summary

Group

VRRP group number.

brief extensive none summary

State

The state of the interface on which VRRP is running:

  • backup—The interface is acting as the backup router interface.

  • bringup—VRRP is just starting and the physical device is not yet present.

  • idle—VRRP is configured on the interface and is disabled. This can occur when VRRP is first enabled on an interface whose link is established.

  • init—VRRP is initializing.

  • master—The interface is acting as the primary router interface.

  • master(ISSU)—The primary router interface is going through a unified in-service software upgrade.

  • transition—The interface is changing between being the backup and being the primary router.

extensive

VRRP Mode

If the interface inherits its state and configuration from the active VRRP group, or if it is part of the active VRRP group.

  • Active—Part of the active VRRP group

  • Inherit—Inherits state and configuration from the active VRRP group.

detail extensive

Priority

Configured VRRP priority for the interface.

detail extensive

Advertisement interval

Configured VRRP advertisement interval.

detail extensive

Authentication type

Configured VRRP authentication type: none, simple, or md5.

detail extensive

Advertisement Threshold

A value from 1 through 15, used for setting the time when a peer should be considered down.

  • The time a peer is considered down is equal to the advertisement-threshold multiplied by the advertisement-interval.

  • (advertisement-threshold *advertisement-interval) = Peer down.

detail extensive

Computed Send Rate

How many protocol data units (PDUs) are generated per second.

Based on the number of instances and the advertisement interval.

detail extensive

Preempt

Whether preemption is allowed on the interface: yes or no.

detail extensive

Accept-data mode

Whether the interface is configured to accept packets destined for the virtual IP address: yes or no.

detail extensive

VIP count

Number of virtual IP addresses that have been configured on the interface.

detail extensive

VIP

List of virtual IP addresses configured on the interface.

detail extensive

Advertisement timer

How long, in seconds, until the advertisement timer expires.

detail extensive

Master router

IP address of the interface that is acting as the primary. If the VRRP interface is down, the output is N/A.

detail extensive

Virtual router uptime

How long, in seconds, that the virtual router has been up.

detail extensive

Master router uptime

How long, in seconds, that the primary route has been up.

detail extensive

Virtual MAC

MAC address associated with the virtual IP address.

detail extensive

Tracking

Whether tracking is enabled or disabled.

detail extensive

Current priority

Current operational priority for being the VRRP primary.

detail extensive

Configured priority

Configured base priority for being the VRRP primary.

detail extensive

Priority hold-time

Minimum time interval, in seconds, between successive changes to the current priority. Disabled indicates no minimum interval.

detail extensive

Remaining-time

(track option only) Displays the time remaining in the priority hold-time interval.

detail

Interface tracking

Whether interface tracking is enabled or disabled. When enabled, the output also displays the number of tracked interfaces.

detail extensive

Interface/Tracked interface/Track Int

Name of the tracked interface.

detail extensive

Int state/Interface state/State

Current operational state of the tracked interface: up or down.

detail extensive

Int speed/Speed

Current operational speed, in bits per second, of the tracked interface.

detail extensive

Incurred priority cost

Operational priority cost incurred due to the state and speed of this tracked interface. This cost is applied to the configured priority to obtain the current priority.

detail extensive

Threshold

Speed below which the corresponding priority cost is incurred. In other words, when the speed of the interface drops below the threshold speed, the corresponding priority cost is incurred.

An entry of down means that the corresponding priority cost is incurred when the interface is down.

detail extensive

Route tracking

Whether route tracking is enabled or disabled. When enabled, the output also displays the number of tracked routes.

detail extensive

Route count

The number of routes being tracked.

detail extensive

Route

The IP address of the route being tracked.

detail extensive

VRF name

The VPN routing and forwarding (VRF) routing instance that the tracked route is in.

detail extensive

Route state

The state of the route being tracked: up, down, or unknown.

detail extensive

Priority cost

Configured priority cost. This value is incurred when the interface speed drops below the corresponding threshold or when the tracked route goes down.

detail extensive

Active

Whether the threshold is active (*). If the threshold is active, the corresponding priority cost is incurred.

detail extensive

Group VRRP PDU statistics

Number of VRRP advertisements sent and received by the group.

extensive

Group VRRP PDU error statistics

Errored statistics for the VRRP group:

  • Bad authentication type received—Number of VRRP PDUs received with an invalid authentication type. The received authentication can be none, simple, or md5 and must be the same for all routers in the VRRP group.

  • Bad password received—Number of VRRP PDUs received with an invalid key (password). The password for simple authentication must be the same for all routers in the VRRP group

  • Bad MD5 digest received—Number of VRRP PDUs received for which the MD5 digest computed from the VRRP PDU differs from the digest expected by the VRRP instance configured on the router.

  • Bad advertisement timer received—Number of VRRP PDUs received with an advertisement time interval that is inconsistent with the one in use among the routers in the VRRP group.

  • Bad VIP count received—Number of VRRP PDUs whose virtual IP address counts differ from the count that has been configured on the VRRP instance.

  • Bad VIPADDR received—Number of VRRP PDUs whose virtual IP addresses differ from the list of virtual IP addresses configured on the VRRP instance.

extensive

Group state transition statistics

State transition statistics for the VRRP group:

  • Idle to master transitions—Number of times that the VRRP instance transitioned from the idle state to the primary state.

  • Idle to backup transitions—Number of times that the VRRP instance transitioned from the idle state to the backup state.

  • Backup to master transitions—Number of times that the VRRP instance transitioned from the backup state to the primary state.

  • Master to backup transitions—Number of times that the VRRP instance transitioned from the primary state to the backup state.

extensive

VR state

The state of the VRRP:

  • backup—The interface is acting as the backup router interface.

  • bringup—VRRP is just starting, and the physical device is not yet present.

  • idle—VRRP is configured on the interface and is disabled. This can occur when VRRP is first enabled on an interface whose link is established.

  • init—VRRP is initializing.

  • master—The interface is acting as the primary router interface.

  • transition—The interface is changing between being the backup and being the primary router.

Note:

When show vrrp nsr is used on the backup Routing Engine, it displays the current VRRP state on the primary Routing Engine, which is the future VRRP state for the backup Routing Engine. Do not use on the primary Routing Engine.

brief none summary

NSR

VRRP nonstop active routing is enabled for the configured VRRP group: yes or no.

Note:

A yes value means that the new primary Routing Engine will immediately start with the VRRP State value from the original primary Routing Engine.

A no value means that the VRRP session will:

  • Start afresh.

  • Go through asilent startup period.

  • Move to a backup state.

  • Wait for the D Timer to run out before becoming the primary (only if the primary has not been configured already).

brief none

RPD-NSR

The routing options have been set to nonstop active routing: yes or no.

brief none

Timer

VRRP timer information:

  • A—How long, in seconds, until the advertisement timer expires.

  • D—How long, in seconds, until the Primary is Down timer expires.

brief none

Sample Output

show vrrp

show vrrp brief

The output for the show vrrp brief command is identical to that for the show vrrp command. For sample output, see show vrrp.

show vrrp detail (IPv6)

show vrrp detail (Route Track)

show vrrp detail (Route Track)

show vrrp extensive

show vrrp interface

show vrrp nsr

This command is similar to show vrrp. Here, the VR state column displays the current VRRP state on the primary Routing Engine, which is the future VRRP state for the backup Routing Engine. Do not use on the primary Routing Engine.

NSR is yes if VRRP nonstop active routing is enabled for the configured VRRP group.

RPD-NSR is yes if the routing options have been set to nonstop active routing.

show vrrp summary

Release Information

Command introduced before Junos OS Release 7.4.

nsr option added in Junos OS Release 13.2.