check interval = n\n" "
Defines the number of second between server checks.\n" "
Default: 10 seconds\n" "\n" "
check timeout = n\n" "
Timeout in seconds for connect, external and ping checks. If the timeou" "t is exceeded then the real server is declared dead.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "
If undefined then the value of negotiatetimeout is used. negotiatetimeo" "ut is also a global value that may be overriden by a per-virtual setting.\n" "
If both checktimeout and negotiatetimeout are unset, the default is use" "d.\n" "
Default: 5 seconds\n" "\n" "
failure count = n\n" "
The number of consecutive times a failure will have to be reported by a" " check before the realserver is considered to have failed. A value of 1 will " "have the realserver considered failed on the first failure. A successful chec" "k will reset the failure counter to 0.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "
Default: 1\n" "\n" "
negotiate timeout = n\n" "
Timeout in seconds for negotiate checks.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "
If undefined then the value of connecttimeout is used. connecttimeout i" "s also a global value that may be overriden by a per-virtual setting.\n" "
If both negotiatetimeout and connecttimeout are unset, the default is u" "sed.\n" "
Default: 30 seconds\n" "\n" "
fallback = ip_address|hostname[:portnumber|sercvic" "ename] [gate|masq|ipip]\n" "
the server onto which a webservice is redirected if all real servers ar" "e down. Typically this would be 127.0.0.1 with an emergency page.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "\n" "
log file = \"/path/to/logfile\"|syslog_fa" "cility\n" "
An alternative logfile might be specified with this directive. If the l" "ogfile does not have a leading '/', it is assumed to be a syslog(3) facility name.\n" "
Default: log directly to the file /var/log/ldirectord.log.\n" "\n" "
email alert = \"emailaddress\"\n" "
A valid email address for sending alerts about the changed connection s" "tatus to any real server defined in the virtual service. This option requires " "perl\n" "module MailTools to be installed. Automatically tries to send email using any " "of the built-in methods. See perldoc Mail::Mailer for more info on methods.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "\n" "
email alert freq = n\n" "
Delay in seconds between repeating email alerts while any given real se" "rver in the virtual service remains inaccessible. A setting of zero seconds wi" "ll\n" "inhibit the repeating alerts. The email timing accuracy of this setting is dep" "endent on the number of seconds defined in the checkinterval configuration\n" "option.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "
Default: 0\n" "\n" "
email alert status = all|none|starting|" "running|stopping|reloading,...\n" "
Comma delimited list of server states in which email alerts should be s" "ent. all is a short-hand for\n" "\"starting,running,stopping,reloading\". If none<" "/b> is specified, no other option may be specified, otherwise options are ored" "\n" "with each other.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "
Default: all\n" "\n" "
callback = \"/path/to/callback\"\n" "
If this directive is defined, ldirectord automatically calls the" " executable /path/to/callback after the configuration file has changed " "on\n" "disk. This is useful to update the configuration file through scp on th" "e other heartbeated host. The first argument to the callback is the name of th" "e\n" "configuration.\n" "
This directive might also be used to restart ldirectord automati" "cally after the configuration file changed on disk. However, if autoreload<" "/b> is\n" "set to yes, the configuration is reloaded anyway.\n" "\n" "
execute = \"configuration\"\n" "
Use this directive to start an instance of ldirectord for the named " "configuration.\n" "\n" "
auto reload = yes|no\n" "
Defines if <ldirectord> should continuously check the configurati" "on file for modification. If this is set to 'yes' and the configuration file c" "hanged\n" "on disk and its modification time (mtime) is newer than the previous version, " "the configuration is automatically reloaded.\n" "
Default: no\n" "\n" "
quiescent = yes|no\n" "
If yes, then when real or failback servers are determined to be " "down, they are not actually removed from the kernel's LVS table" ".\n" "Rather, their weight is set to zero which means that no new connections will b" "e accepted.\n" "
This has the side effect, that if the real server has persistent connec" "tions, new connections from any existing clients will continue to be routed to" " the\n" "real server, until the persistant timeout can expire. See ipvsadm for more inf" "ormation on persistant connections.\n" "
This side-effect can be avoided by running the following:\n" "
echo 1 > /proc/sys/net/ipv4/vs/expire_quiescent_template\n" "
If the proc file isn't present this probably means that the kernel does" "n't have lvs support, LVS support isn't loaded, or the kernel i" "s too\n" "old to have the proc file. Running ipvsadm as root should load LVS into the kernel if it is possible.\n" "
If no, then the real or failback servers will be removed from th" "e kernel's LVS table. The default is yes.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "
Default: yes\n" "\n" "
fork = yes|no\n" "
If yes, then ldirectord will spawn a child proccess for every vi" "rtual server, and run checks against the real servers from them. This will inc" "rease\n" "response times to changes in real server status in configurations with many vi" "rtual servers. This may also use less memory then running many seperate instan" "ces\n" "of ldirectord. Child processes will be automaticly restarted if they die.\n" "
Default: no\n" "\n" "
supervised = yes|no\n" "
If yes, then ldirectord does not go into background mode. All lo" "g-messages are redirected to stdout instead of a logfile. This is useful to ru" "n\n" "ldirectord supervised from daemontools. See http://untroubled.org/rpms/daemontools/ or http://cr.yp.to/daemontools.html for de" "tails.\n" "
Default: no\n" "
\n" iplb.pot (query 2 of 2) What is meant by "the virtual"? "If the virtual is specified as an IP address" Also there is a typo: "For an information on the available sehedulers please see the" String: #: src/include/iplb/helps.rb:127 msgid "" "\n" "virtual server = (ip_address|hostname:portnumber|servi" "cename)|firewall-mark\n" "
Defines a virtual service by IP-address (or hostname) and port (or serv" "icename) or firewall-mark. A firewall-mark is an integer greater than zero. Th" "e\n" "configuration of marking packets is controled using the \"-m\" option t" "o ipchains(8). All real services and flags for a virtual service\n" "must follow this line immediately and be indented.\n" "\n" "\n" "
real servers = ip_address|hostname[->ip_address" "|hostname][:portnumber|servicename]\n" "gate|masq|ipip [weight] [\"request" "\", \"receive\"]\n" "
Defines a real service by IP-address (or hostname) and port (or service" "name). If the port is omitted then a 0 will be used, this is intended primaril" "y for\n" "fwmark services where the port for real servers is ignored. Optionally a range" " of IP addresses (or two hostnames) may be given, in which case" "\n" "each IP address in the range will be treated as a real server u" "sing the given port. The second argument defines the forwarding method, must b" "e\n" "gate, ipip or masq. The thrid argument is optional and de" "fines the weight for that real server. If omitted then a weight of 1 will be\n" "used. The last two arguments are also optional. They define a request-receive " "pair to be used to check if a server is alive. They override the request-recei" "ve\n" "pair in the virtual server section. These two strings must be quoted. If the r" "equest string starts with http://... the IP-address and port of the real\n" "server is overridden, otherwise the IP-address and port of the real server is " "used.\n" "
For TCP and UDP (non fwmark) virtual serv" "ices, unless the forwarding method is masq and the IP address o" "f a\n" "real server is non-local (not present on a interface on the host running ldire" "ctord) then the port of the real server will be set to that of its virtual\n" "service. That is, port-mapping is only available to if the real server is anot" "her machine and the forwarding method is masq. This is due to the way that the" "\n" "underlying LVS code in the kernel functions.\n" "
More than one of these entries may be inside a virtual section. The che" "cktimeout, negotiatetimeout, failurecount, fallback, emailalert, emailalertfre" "q and\n" "quiescent options listed above may also appear inside a virtual section, in wh" "ich case the global setting is overridden.\n" "\n" "\n" "
check type = connect|external|negotiate" "|off|on|ping|checktimeoutN\n" "
Type of check to perform. Negotiate sends a request and matches a recei" "ve string. Connect only attemts to make a TCP/IP connection, th" "us the\n" "request and receive strings may be omitted. If checktype is a number then nego" "tiate and connect is combined so that after each N connect attempts one negoti" "ate\n" "attempt is performed. This is useful to check often if a service answers and i" "n much longer intervalls a negotiating check is done. Ping means that\n" "ICMP ping will be used to test the availability of real servers" ". Ping is also used as the connect check for UDP services. Off\n" "means no checking will take place and no real or fallback servers will be acti" "vated. On means no checking will take place and real servers will always be\n" "activated. Default is negotiate.\n" "\n" "\n" "
service = dns|ftp|http|https|" "imap|imaps|ldap|mysql|nntp|none|orac" "le|pgsql|pop|pops|radius|simpletcp|s" "ip|smtp\n" "
The type of service to monitor when using checktype=negotiate. None den" "otes a service that will not be monitored.\n" "
simpletcp sends the request string to the server and tests it ag" "ainst the receive regexp. The other types of checks connect to the serv" "er\n" "using the specified protocol. Please see the request and receive" " sections for protocol specific information.\n" "
Default:\n" "
This setting is used if checktype is external and is the command to be run " "to check the status of a real server. It should exit with status 0 if everythi" "ng\n" "is ok, or non-zero otherwise.\n" "
Four parameters are passed to the script:\n" "
check port = n\n" "
Number of port to monitor. Sometimes check port differs from service po" "rt.\n" "
Default: port specified for each real server\n" "\n" "\n" "
request = \"uri to requested object\"\n" "
This object will be requested each checkinterval seconds on each real s" "erver. The string must be inside quotes. Note that this string may be overridd" "en by\n" "an optional per real-server based request-string.\n" "
For a DNS check this should the name of an A record, or " "the address of a PTR record to look up.\n" "
For a MySQL, Oracle or PostgeSQL check, this should be an SQL query. The data returned is not checked, only that the answer is one or " "more\n" "rows. This is a required setting.\n" "
For a simpletcp check, this string is sent verbatim except any occuranc" "es of \n" " are replaced with a new line character.\n" "\n" "\n" "
receive = \"regexp to compare\"\n" "
If the requested result contains this regexp to compare, the rea" "l server is declared alive. The regexp must be inside quotes. Keep in mind tha" "t\n" "regexps are not plain strings and that you need to escape the special characte" "rs if they should as literals. Note that this regexp may be overridden by an\n" "optional per real-server based receive regexp.\n" "
For a DNS check this should be any one the A record's ad" "dresses or any one of the PTR record's names.\n" "
For a MySQL check, the receive setting is not used.\n" "\n" "\n" "
http method = GET | HEAD\n" "
Sets the HTTP method which should be used to fetch the <" "small>URI specified in the request-string. GET is the\n" "method used by default if the parameter is not set. If HEAD is " "used, the receive-string should be unset.\n" "
Default: GET\n" "\n" "\n" "
virtual host = \"hostname\"\n" "
Used when using a negotiate check with HTTP or HT" "TPS . Sets the host header used in the HTTP request. In" " the\n" "case of HTTPS this generally needs to match the common name of " "the SSL certificate. If not set then the host header will be\n" "derived from the request url for the real server if present. As a last resort " "the IP address of the real server will be used.\n" "\n" "\n" "
login = \"username\"\n" "
For FTP , IMAP , LDAP , My" "SQL, Oracle, POP and PostgreSQL, the username used to log in.\n" "
For Radius the passwd is used for the attribute User-Name.\n" "
For SIP , the username is used as both the to and from a" "ddress for an OPTIONS query.\n" "
Default:\n" "
Password to use to login to FTP , IMAP ,
For Radius the passwd is used for the attribute User-Password.\n" "
Default:\n" "
Database to use for MySQL, Oracle and PostgreSQL servers, this is the datab" "ase that the query (set by receive above) will be performed against. Th" "is\n" "is a required setting.\n" "\n" "\n" "
radius secret = \"radiussecret\"\n" "
Secret to use for Radius servers, this is the secret used to perform an" " Access-Request with the username (set by login above) and passwd (set " "by\n" "passwd above).\n" "
Default: empty string\n" "\n" "\n" "
persistent = n\n" "
Number of seconds for persistent client connections.\n" "\n" "\n" "
netmask = w.x.y.z\n" "
Netmask to be used for granularity of persistent client connections.\n" "\n" "\n" "
scheduler = scheduler_name\n" "
Scheduler to be used by LVS for loadbalancing. For an in" "formation on the available sehedulers please see the ipvs" "adm(8) man page.\n" "
Default: \"wrr\"\n" "\n" "\n" "
protocol = tcp|udp|fwm\n" "
Protocol to be used. If the virtual is specified as an IP address and port then it must be one of tcp or udp. If a firewall mark then " "the\n" "protocol must be fwm.\n" "
Default:\n" "
check timeout = n\n" "
Timeout in seconds for connect, external and ping checks. If the timeou" "t is exceeded then the real server is declared dead.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "
If undefined then the value of negotiatetimeout is used. negotiatetimeo" "ut is also a global value that may be overriden by a per-virtual setting.\n" "
If both checktimeout and negotiatetimeout are unset, the default is use" "d.\n" "
Default: 5 seconds\n" "\n" "
negotiate timeout = n\n" "
Timeout in seconds for negotiate checks.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "
If undefined then the value of connecttimeout is used. connecttimeout i" "s also a global value that may be overriden by a per-virtual setting.\n" "
If both negotiatetimeout and connecttimeout are unset, the default is u" "sed.\n" "
Default: 30 seconds\n" "\n" "
failure count = n\n" "
The number of consecutive times a failure will have to be reported by a" " check before the realserver is considered to have failed. A value of 1 will " "have the realserver considered failed on the first failure. A successful chec" "k will reset the failure counter to 0.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "
Default: 1\n" "\n" "
email alert = \"emailaddress\"\n" "
A valid email address for sending alerts about the changed connection s" "tatus to any real server defined in the virtual service. This option requires " "perl\n" "module MailTools to be installed. Automatically tries to send email using any " "of the built-in methods. See perldoc Mail::Mailer for more info on methods.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "\n" "
email alert freq = n\n" "
Delay in seconds between repeating email alerts while any given real se" "rver in the virtual service remains inaccessible. A setting of zero seconds wi" "ll\n" "inhibit the repeating alerts. The email timing accuracy of this setting is dep" "endent on the number of seconds defined in the checkinterval configuration\n" "option.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "
Default: 0\n" "\n" "
email alert status = all|none|starting|" "running|stopping|reloading,...\n" "
Comma delimited list of server states in which email alerts should be s" "ent. all is a short-hand for\n" "\"starting,running,stopping,reloading\". If none<" "/b> is specified, no other option may be specified, otherwise options are ored" "\n" "with each other.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "
Default: all\n" "\n" "
fallback = ip_address|hostname[:portnumber|sercvic" "ename] [gate|masq|ipip]\n" "
the server onto which a webservice is redirected if all real servers ar" "e down. Typically this would be 127.0.0.1 with an emergency page.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "\n" "
quiescent = yes|no\n" "
If yes, then when real or failback servers are determined to be " "down, they are not actually removed from the kernel's LVS table" ".\n" "Rather, their weight is set to zero which means that no new connections will b" "e accepted.\n" "
This has the side effect, that if the real server has persistent connec" "tions, new connections from any existing clients will continue to be routed to" " the\n" "real server, until the persistant timeout can expire. See ipvsadm for more inf" "ormation on persistant connections.\n" "
This side-effect can be avoided by running the following:\n" "
echo 1 > /proc/sys/net/ipv4/vs/expire_quiescent_template\n" "
If the proc file isn't present this probably means that the kernel does" "n't have lvs support, LVS support isn't loaded, or the kernel i" "s too\n" "old to have the proc file. Running ipvsadm as root should load LVS into the kernel if it is possible.\n" "
If no, then the real or failback servers will be removed from th" "e kernel's LVS table. The default is yes.\n" "
If defined in a virtual server section then the global value is overrid" "den.\n" "
Default: yes\n" "\n" "\n" "\n" msgstr ""