vrrp
interface/vrrp
Type: Directory
| Flag | Name | Description |
|---|---|---|
| X | disabled | The VRRP interface is disabled by the user. |
| I | invalid | The VRRP interface is in the invalid state, for example due to a configuration error. |
| G | grp-authority | The VRRP interface is group-authority. It controls the state of the other group members and is the only interface that sends VRRP advertisements. |
| g | grp-member | The VRRP interface is a group member. Its state machine follows the state of the specified group-authority interface. |
| R | running | running. |
| M | master | The VRRP interface is in the master state. |
| B | backup | The VRRP interface is in the backup state. |
| F | failure | The VRRP interface is in the failure state, for example due to a link-down on its parent interface. |
| Argument | Type | Description |
|---|---|---|
| name | string | VRRP interface name. |
| arp | enum (disabled | enabled | proxy-arp | reply-only | local-proxy-arp) { disabled:0, enabled:1, proxy-arp:2, reply-only:3, local-proxy-arp:4 } | Address Resolution Protocol mode. |
| arp-timeout | alt { arp-timeout: enum (auto) { auto:0 } , arp-timeout: time } | How long the ARP record is kept in the ARP table after no packets are received from IP. Value auto equals the value of arp-timeout in IP/Settings, default is 30s. |
| interface ( mandatory ) | iface_enum | Interface name on which VRRP instance will be running. |
| group-master | iface_enum { :0, none:0, self } | deprecated. |
| group-authority | iface_enum { :0, none:0, self } | Allows multiple VRRP interfaces to be grouped so they share the same VRRP state. Within a group, a single group authority interface is selected. It controls the state of the other group members and is the only interface that sends VRRP advertisements. When the group-authority VRRP interface transitions to the backup state, all group members also transition to the backup state. If a failure is detected on any group member, for example due to a link-down on its parent interface, all group members transition to the failure state.
|
| vrid | num | Virtual Router identifier. Each Virtual router must have a unique id number. |
| priority | num | Priority of VRRP node used in Master election algorithm. A higher number means higher priority. 255 is reserved for the router that owns the VR IP and 0 is reserved for the Master router to indicate that it is releasing responsibility. |
| interval | time | The VRRP interval defines how often the VRRP master router sends Advertisement packets to backup routers. This interval directly determines the frequency at which backups receive keepalive information confirming that the master is operational. A shorter interval increases the rate of Advertisement packets, allowing faster detection of master failure, but also increases sensitivity to packet loss, processing delays, and timer inaccuracies. Longer intervals reduce control traffic and improve stability, at the cost of slower failover detection. The Master Down interval is derived from the configured VRRP interval and the router's priority, and is calculated to allow multiple missed Advertisements before triggering failover. Warning: Configuring VRRP intervals below 1 second can lead to unpredictable behavior and unintended master role changes. |
| preemption-mode | bool | Whether the master node always has the priority. When set to no the backup node will not be elected to be a master until the current master fails, even if the backup node has higher priority. |
| authentication | enum (none | simple | ah) { none:0, simple:1, ah:2 } | Authentication method to use for VRRP advertisement packets.
|
| password | string | Password required for authentication. Can be ignored if authentication is not used. |
| on-backup | alt { script: string } | Script to execute when the node is switched to the backup state. |
| on-master | alt { script: string } | Script to execute when the node is switched to the master state. |
| on-fail | alt { script: string } | Script to execute when the node fails. |
| version | enum (2 | 3) { 2:2, 3:3 } | Which VRRP version to use. |
| v3-protocol | enum (ipv4 | ipv6) { ipv4:1, ipv6:2 } | A protocol that will be used by VRRPv3. Valid only if the version is 3. |
| v3-checksum-as-v2 | bool | Controls whether the VRRPv3 IPv4 checksum is calculated with or without the IPv4 pseudoheader. Different vendors interpret RFC 5798 section 5.2.8 differently regarding the pseudoheader in IPv4 checksum calculation. Linux-based implementations (including FRR) include the pseudoheader for both IPv4 and IPv6, while Cisco includes it only for IPv6.
This setting applies only to VRRPv3 with IPv4. It has no effect on VRRPv3 IPv6 or VRRPv2. All VRRP routers in the same Virtual Router must use the same value for this setting. Mismatched values will cause "bad checksum" errors and VRRP advertisement packets will be discarded. |
| sync-connection-tracking | bool | Synchronize connection tracking entries from Master to Backup device. The VRRP connection tracking synchronization requires that RouterOS connection tracking is running. |
| remote-address | ipAddr | Specifies the remote address of the other VRRP router for connection tracking synchronization. If not set, the system autodetects the remote address through VRRP. The remote address is used only if
|
| connection-tracking-mode | enum (passive-active | active-active) { passive-active:0, active-active:1 } | Specifies the mode for connection tracking synchronization. This setting is relevant only when
Using multiple VRRP groups with passive-active mode can lead to unsynchronized connection tracking tables because only one master handles synchronization, and the others do not exchange tracking data. |
| connection-tracking-port | num | Specifies UDP port for connection tracking synchronization. This setting is only relevant when sync-connection-tracking is enabled. |
| Read-only Argument | Type | Description |
|---|---|---|
| mtu | num | Layer3 MTU size. The VRRP interface always uses slave interface MTU. |
| mac-address | macAddr | MAC address of the VRRP interface. |