set vrrp

Purpose

Configures Virtual Router Redundancy Protocol (VRRP) settings. VRRP allows several routers on a subnet to use the same virtual IP address. In this configuration setup, two or more physical routers are configured to represent the virtual router with only one doing the actual routing at any given time. If the current physical router fails, another physical router automatically replaces it. The advantage in using a virtual router redundancy protocol is that systems can be configured with a single default gateway, rather than running an active routing protocol.

Digi devices can support up to 8 virtual routers.

Required permissions

For Digi products with two or more users, to use this command, permissions must be set to set permissions s‑vrrp=read to display settings, and set permissions s‑vrrp=rw to display and configure settings. See set permissions for details on setting user permissions for commands.

Syntax

Configure VRRP

set vrrp [index=1..8]
  [state={enabled|disabled}]
  [interface=eth0]
  [vrid=1..255]
  [priority={1..254}]
  [advertisement_interval=100..60000 (ms)]
  [preempt={enabled|disabled}]
  [ip_address=IP address of virtual router]

Display current VRRP settings

set vrrp

Options

index=1..8

The index number for a virtual router. Up to 8 virtual routers can be defined.

state={enabled|disabled}

Enables or disables the VRRP feature.

interface=eth0

The Ethernet interface on which VRRP advertisements should be sent and received.

vrid=1..255

The Virtual Router Identifier (VRID). All routers in the same VRID communicate with each other. The VRID can be any value between 1 and 255. All routers that are to communicate must have the same VRID.

priority={1..254}

Priority determines which router is the master. The router with the highest priority is the master. The default priority is 100.

advertisement_interval=100..60000 (ms)

The amount of time in milliseconds between VRRP master advertisements. All routers in the virtual routing group should be set to the same value. 3000 milliseconds (3 seconds) is typically used.

preempt={enabled|disabled}

Controls whether a higher priority backup router preempts a lower priority master. Enter enabled to enable preemption; enter disabled to prohibit preemption. The default setting is enabled.

ip_address=IP address of virtual router

The IP Address of the virtual router. All routers in the same VRID should use the same virtual IP address. Clients should be configured to use this value as the default gateway.

Example

This command sets up a virtual router with an IP address of 192.168.1.101, ID 10, and priority 100, advertising at 3 sec. intervals:

#> set vrrp index=1 state=enabled vrid=10 priority=100 advertisement_interval=3000 preempt=disabled ip_address=192.168.1.101