Annotation of embedaddon/freevrrpd/freevrrpd.cat8, revision 1.1.1.1

1.1       misho       1: FREEVRRPD(8)            NetBSD System Manager's Manual            FREEVRRPD(8)
                      2: 
                      3: NNAAMMEE
                      4:      ffrreeeevvrrrrppdd - Virtual Redundancy Router Protocol Daemon
                      5: 
                      6: SSYYNNOOPPSSIISS
                      7:      ffrreeeevvrrrrppdd [--FF] [--ff _c_o_n_f_i_g___f_i_l_e] [--cc _c_h_r_o_o_t___d_i_r_e_c_t_o_r_y]
                      8: 
                      9: DDEESSCCRRIIPPTTIIOONN
                     10:      ffrreeeevvrrrrppdd is a RFC2338 compliant daemon, you can use VRRP protocol with
                     11:      multiple interfaces and multiple VRID. For each VRID defined in the con-
                     12:      figuration file, ffrreeeevvrrrrppdd create a thread for managing a poll of one or
                     13:      multiple virtual IP addresses. Thios daemon work only in IPv4 environ-
                     14:      nement and not in IPv6 yet.
                     15: 
                     16:      you can eliminate all point of failures of your network with this util-
                     17:      ity. When ffrreeeevvrrrrppdd is started, it reads /usr/local/etc/freevrrpd.conf
                     18:      file and go to background. All options are defined in this file. For more
                     19:      informations, you can read comments on this file or go to configuration
                     20:      section.
                     21: 
                     22:      ffrreeeevvrrrrppdd iiss ccoommppaattiibbllee wwiitthh FFrreeeeBBSSDD,, NNeettBBSSDD aanndd OOppeennBBSSDD..
                     23: 
                     24:      List of functionnalities :
                     25:      ++oo   Support of multiples VRID
                     26:      ++oo   Master announce state by sending multicast packets via BPF device
                     27:      ++oo   Changing routes and IP in 3 seconds
                     28:      ++oo   Doing gratuitous ARP requests to clean the ARP cache of all hosts
                     29:      ++oo   Election between differents SLAVE servers with differents priorities
                     30:      ++oo   Same host can be a SLAVE and MASTER at the same time for different
                     31:          VRID
                     32:      ++oo   Autmatic downgrade to SLAVE state if a MASTER is up again
                     33:      ++oo   Support of plain text authentication described in RFC2338
                     34:      ++oo   Support netmask for virtual IP addresses
                     35: 
                     36: CCOONNFFIIGGUURRAATTIIOONN
                     37:      ffrreeeevvrrrrppdd reads configuration data from /usr/local/etc/freevrrpd.conf (or
                     38:      the file specified with -f on the command line). The file contains key-
                     39:      word-argument pairs, one per line. Each VRID definition is define by the
                     40:      [VRID] keyword. Lines statring with '#' and empty lines are interpreted
                     41:      as comments.
                     42: 
                     43:      The possible keywords and their meanings are as follows (note that key-
                     44:      words and arguments are cas-sensitive):
                     45: 
                     46:      sseerrvveerriidd
                     47:              This keyword is followed by a decimal number between 1 and 255
                     48:              and represent the group identifier (Virtual Router Identifier).
                     49: 
                     50:      iinntteerrffaaccee
                     51:              This keyword is followed by an interface name where multicast
                     52:              VRRP annonce on the specified serverid group will be sent.
                     53: 
                     54:      uusseeVVMMAACC
                     55:              Specifies wheter Virtual MAC adress (like 00:5E:00:...) is per-
                     56:              mitted.  The default is ``yes''.  Note that disabling useVMAC is
                     57:              a RFC infragment but must be necessary for some specific cases.
                     58:              If disabled, ``sendgratuitousarp'' must be enabled.
                     59: 
                     60:      pprriioorriittyy
                     61:              This keyword can be followed by a decimal number between 0 to
                     62:              255. a priority of 255 mean a MASTER server. a priority between 0
                     63:              to 254 is a BACKUP priority.  Note that 0 is the minimal BACKUP
                     64:              priority and 254 is the higher. If the VRID MASTER fail, tha
                     65:              higher BACKUP priority will become MASTER.
                     66: 
                     67:      aaddddrr    Specifies all Virtual IP adresses separated by commas of the cor-
                     68:              responded VRID. a VIP syntax will be: ``xxx.xxx.xxx.xxx/yy'' or
                     69:              ``device:xxx.xxx.xxx.xxx/yy.'' ``xxx.xxx.xxx.xxx'' represent the
                     70:              IP adress and ``yy'' is a netmask in CIDR format. device is an
                     71:              optional device where VIP will be setted.
                     72: 
                     73:      mmoonniittoorreeddcciirrccttuuiiss
                     74:              Specifies whether NIC monitoring is enabled. This option use a
                     75:              special ioctl for getting carrier, duplex and health of the net-
                     76:              work card.  The default is ``yes''.  Note that your NIC driver
                     77:              must support mii bus functionnality. Some old drivers cannot use
                     78:              this option and must be disabled.
                     79: 
                     80:      MMCCCClleeaarrEErrrroorrssCCoouunntt
                     81:              This keyword can be followed by a decimal number that represent
                     82:              the number of concurrent valid checks (monitored circuits) before
                     83:              nberrors flag will be resetted at 0.  The default is ``3600''.
                     84:              Note that the default value mean that 30 concurrent checks ok on
                     85:              a NIC by monitored circuits will reset the error counter for this
                     86:              NIC.  If a value of
                     87: 
                     88:      mmaasstteerrssccrriipptt
                     89:              This keyword can be followed by a script name with an absolute
                     90:              path and will be executed during MASTER transition state.
                     91: 
                     92:      bbaacckkuuppssccrriipptt
                     93:              This keyword take same argument as ``masterscript'' except that
                     94:              this script is executed during BACKUP transition state.
                     95: 
                     96:      vvrriiddssddeepp
                     97:              This keyword can be followed by a list of VRID in decimal format
                     98:              separated by commas and depends from this one. If this VRID
                     99:              become BACKUP, all VRIDs specified will become BACKUP too.
                    100: 
                    101:      ppaasssswwoorrdd
                    102:              This keyword can be followed by a password for authenticate VRRP
                    103:              packets on a specific VRID.  Note that the password will be
                    104:              transmitted in clear with this method.
                    105: 
                    106:      AAHHeennccrryyppttiioonn
                    107:              Not implemented yet
                    108: 
                    109:      uusseeIIKKEE  Not implemented yet
                    110: 
                    111:      pprreesshhaarreeddkkeeyy
                    112:              Not implemented yet
                    113: 
                    114: IIMMPPLLEEMMEENNTTAATTIIOONN NNOOTTEESS
                    115:      This utility doesn't quit properly if you use the -KILL signal. If you
                    116:      want to stop freevrrpd, you can use kill [PID] and not kill -9 [PID],
                    117:      then it can delete virtual IP addresses and routes properly on shutdown.
                    118: 
                    119: BBUUGGSS
                    120:      ffrreeeevvrrrrppdd is in active developpement, please send me bugs report and sug-
                    121:      gestions.
                    122: 
                    123: AAUUTTHHOORRSS
                    124:      Sebastien Petit <spe@bsdfr.org>
                    125: 
                    126: HHIISSTTOORRYY
                    127:      first appeared in FreeBSD-4.3
                    128: 
                    129: FreeBSD 4.3                    January 28, 2000                    FreeBSD 4.3

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>