Man Linux: Main Page and Category List

NAME

       vrrpd - Virtual Router Redundancy Protocol Deamon

SYNOPSIS

       vrrpd  -i  ifname  -v  vrid  [-f  piddir]  [-s] [-a auth] [-p prio] [-m
       ifname] [-c delta] [-nhD] ipaddr

DESCRIPTION

       vrrpd is an implementation of VRRPv2 as specified in rfc2338. It run in
       userspace  for  linux.   In  short,  VRRP  is a protocol which elects a
       master server on a  LAN  and  the  master  answers  to  a  ’virtual  ip
       address’. If it fails, a backup server takes over the ip address.

       A  longer  answer  in  the  rfc2338  abstract  : "This memo defines the
       Virtual Router Redundancy Protocol (VRRP).  VRRP specifies an  election
       protocol  that  dynamically assigns responsibility for a virtual router
       to one of the VRRP routers on a LAN.  The VRRP router  controlling  the
       IP  address(es)  associated with a virtual router is called the Master,
       and forwards packets sent to these IP addresses.  The election  process
       provides  dynamic fail over in the forwarding responsibility should the
       Master become unavailable.  This allows any of the  virtual  router  IP
       addresses on the LAN to be used as the default first hop router by end-
       hosts.  The advantage gained from using VRRP is a  higher  availability
       default  path  without  requiring  configuration  of dynamic routing or
       router discovery protocols  on  every  end-host."   Copyright  (C)  The
       Internet Society (1998).  All Rights Reserved.

       Monitored interface functionality is useful on high availability router
       or  firewall  platforms,  where  single  interface  failure  can  cause
       asymmetrical routing issues.

       Ideally,  what  is required is a method for a vrrpd process to detect a
       failure of the ’other’ network  interface,  and  lower  it’s  own  VRRP
       priority  below  that  of  the  ’backup’  vrrpd  process.   This allows
       failover to occur normally.

   OPTIONS
       -h     display this short inlined help

       -n     Don’t handle the virtual mac address

       -D     Go into background mode, daemonize

       -i ifname
              the interface name to run on.  More than one  interface  can  be
              monitored  by the one vrrpd process, a list like "eth1 eth2 eth3
              eth4 eth5" is acceptable. Losing link-beat on any of these  will
              cause  the priority of that vrrpd process to be decreased by the
              specified value, or a default of 100.  Note that  as  MII  calls
              are  used,  this  implementation  is limited to Fast and Gigabit
              Ethernet chipsets only - 10Mbps Ethernet cards will not work.

       -v vrid
              the id of the virtual server [1-255]

       -s     iqxSwitch the preemption mode (Enabled by default)

       -a auth
              set the  authentification  type  auth=(none|pw/hexkey|ah/hexkey)
              hexkey=0x[0-9a-fA-F]+  Password  is a symbolic security, anybody
              with a sniffer can break it.  AH is a bit stronger.

       -p prio
              Set the priority of this host in the virtual server (dfl: 100)

       -f piddir
              specify the  directory  where  the  pid  file  is  stored  (dfl:
              /var/run)

       -d delay
              Set  the  advertisement  interval  (in  sec)  (dfl: 1) -m ifname
              Interface(s) to monitor  for  failure.  Use  "  "  for  multiple
              interfaces

       -c delta
              Set the delta to decrease priority by (dfl: 50)

       ipaddr the ip address(es) of the virtual server

EXAMPLES

       vrrpd -i eth0 -v 50 10.0.0.1

       run  vrrp  on the interface eth0 with the virtual id 50 and 10.0.0.1 as
       virtual ip address

AUTHOR

       vrrpd was written by Jerome Etienne <jetienne@arobas.net>, it was later
       improved  by  Alexandre Cassert <acassen@linux-vs.org> and David Hunter
       <david.hunter@gen-i.co.nz>

BUGS

       Suggestions, bugs or questions should be directed  to  the  Sourceforge
       project at http://sourceforge.net/projects/vrrpd/

       Bug  reports regarding this package should be submitted to Debian using
       the reportbug or bug tool.

MORE INFO

       For   more   information    please    read    the    documents    under
       /usr/share/doc/vrrpd/ : README,  README.Debian FAQ  and TODO.