Annotation of embedaddon/freevrrpd/freevrrpd.8, revision 1.1.1.1
1.1 misho 1: .Dd 30 January, 2015
2: .Dt FREEVRRPD 8
3: .Sh NAME
4: .Nm freevrrpd
5: .Nd Virtual Redundancy Router Protocol Daemon
6: .Sh SYNOPSIS
7: .Nm freevrrpd
8: .Bk -words
9: .Op Fl F
10: .Op Fl f Ar config_file
11: .Op Fl c Ar chroot_directory
12: .Sh DESCRIPTION
13: .Nm freevrrpd
14: is a RFC2338/5798 compliant daemon. VRRP can be used with multiple
15: interfaces as well as multiple VRIDs. For each VRID defined in the
16: configuration file,
17: .Nm freevrrpd
18: creates a thread for managing a poll of one or multiple virtual IP
19: addresses. The daemon currently only supports IPv4 but IPv6 is being
20: developed.
21: .Pp
22: When
23: .Nm freevrrpd
24: start, it reads /usr/local/etc/freevrrpd.conf file and then daemonizes
25: itself. All of the options are defined in the config file.
26: .Pp
27: .Nm freevrrpd is compatible with FreeBSD.
28: .Pp
29: Functionality includes :
30: .Bl -bullet -compact
31: .It
32: Support of multiple VRIDs
33: .It
34: State announcements are multicast using the
35: .Xr bpf 4
36: device.
37: .It
38: Changing routes and IP in 3 seconds
39: .It
40: Sending gratuitous ARP requests to clean the ARP cache of all hosts listening hosts.
41: .It
42: Election between different backup and master servers with differing priorities
43: .It
44: THe same host can be both a SLAVE and MASTER at the same time for different VRIDs.
45: .It
46: Automatic downgrade to BACKUP state if the MASTER returns to service.
47: .It
48: Support of netmasks for virtual IP addresses.
49: .El
50: .Sh CONFIGURATION
51: .Pp
52: .Nm freevrrpd
53: reads its configuration data from /usr/local/etc/freevrrpd.conf, or
54: the file specified with -f on the command line. The config file
55: contains keyword-argument pairs, one per line. Each VRID definition is
56: define by the [VRID] keyword. Lines statring with '#' and empty lines
57: are interpreted as comments.
58: .Pp
59: The possible keywords and their meanings are as follows (note that keywords and arguments are cas-sensitive):
60: .Bl -tag -width Ds
61: .It Cm serverid
62: This keyword is followed by a decimal number between 1 and 255 and represent the group identifier (Virtual Router Identifier).
63: .It Cm interface
64: This keyword is followed by an interface name where multicast VRRP annonce on the specified serverid group will be sent.
65: .It Cm useVMAC
66: Specifies wheter Virtual MAC adress (like 00:5E:00:...) is permitted.
67: The default is
68: .Dq yes .
69: Note that disabling useVMAC is a RFC infragment but must be necessary for some specific cases. If disabled,
70: .Dq sendgratuitousarp
71: must be enabled.
72: .It Cm priority
73: This keyword can be followed by a decimal number between 0 to 255. a priority of 255 mean a MASTER server. a priority between 0 to 254 is a BACKUP priority.
74: Note that 0 is the minimal BACKUP priority and 254 is the higher. If the VRID MASTER fail, tha higher BACKUP priority will become MASTER.
75: .It Cm addr
76: Specifies all Virtual IP adresses separated by commas of the corresponded VRID. a VIP syntax will be:
77: .Dq xxx.xxx.xxx.xxx/yy
78: or
79: .Dq device:xxx.xxx.xxx.xxx/yy.
80: .Dq xxx.xxx.xxx.xxx
81: represent the IP adress and
82: .Dq yy
83: is a netmask in CIDR format. device is an optional device where VIP will be setted.
84: .It Cm monitoredcirctuis
85: Specifies whether NIC monitoring is enabled. This option use a special ioctl for getting carrier, duplex and health of the network card.
86: The default is
87: .Dq yes .
88: Note that your NIC driver must support mii bus functionnality. Some old drivers cannot use this option and must be disabled.
89: .It Cm MCClearErrorsCount
90: This keyword can be followed by a decimal number that represent the number of concurrent valid checks (monitored circuits) before nberrors flag will be resetted at 0.
91: The default is
92: .Dq 3600 .
93: Note that the default value mean that 30 concurrent checks ok on a NIC by monitored circuits will reset the error counter for this NIC.
94: If a value of
95: .It Cm masterscript
96: This keyword can be followed by a script name with an absolute path and will be executed during MASTER transition state.
97: .It Cm backupscript
98: This keyword take same argument as
99: .Dq masterscript
100: except that this script is executed during BACKUP transition state.
101: .It Cm vridsdep
102: This keyword can be followed by a list of VRID in decimal format separated by commas and depends from this one. If this VRID become BACKUP, all VRIDs specified will become BACKUP too.
103: .It Cm password
104: This keyword can be followed by a password for authenticate VRRP packets on a specific VRID.
105: Note that the password will be transmitted in clear with this method.
106: .It Cm AHencryption
107: Not implemented yet
108: .It Cm useIKE
109: Not implemented yet
110: .It Cm presharedkey
111: Not implemented yet
112: .Sh IMPLEMENTATION NOTES
113: This utility doesn't quit properly if you use the -KILL signal. If you want to stop freevrrpd, you can use kill [PID] and not kill -9 [PID], then it can delete virtual IP addresses and routes properly on shutdown.
114: .Sh BUGS
115: .Nm freevrrpd
116: is in active developpement, please send me bugs report and suggestions.
117: .Sh AUTHORS
118: .An Sebastien Petit Aq spe@bsdfr.org
119: .Sh HISTORY
120: first appeared in FreeBSD-4.3
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>