Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Add documentation for DEFAULT

The new DEFAULT command is now documented.
  • Loading branch information...
commit 93d4ba53b6e98b90f900a0987bd7a79312c37c11 1 parent 5329da6
@zorkian zorkian authored
View
9 conf/perlbal.conf
@@ -5,6 +5,10 @@
# and configuration syntax.
#
+# set up some defaults for all services that we create
+DEFAULT persist_client = on
+DEFAULT persist_backend = on
+DEFAULT verify_backend = off
# this service's nodes are configured via a pool object. if you need
# to change them, telnet on in to the management port and you and/or your
@@ -17,8 +21,9 @@ CREATE SERVICE balancer
SET listen = 0.0.0.0:80
SET role = reverse_proxy
SET pool = dynamic
- SET persist_client = on
- SET persist_backend = on
+
+ # we know this set of backends supports verification, so override the
+ # default that we set above.
SET verify_backend = on
ENABLE balancer
View
10 devtools/gendocs.pl
@@ -21,9 +21,15 @@
<pre>SET &lt;service-name&gt; &lt;param&gt; = &lt;value&gt;
SET &lt;param&gt; = &lt;value&gt;
</pre>
-HTML
-print H "Note on types: 'bool' values can be set using one of 1, true, yes, on, 0, false, off, or no. 'size' values are in integer bytes, or an integer followed by 'b', 'k', or 'm' (case-insensitive) for bytes, KiB, or MiB.";
+<p>Note on types: 'bool' values can be set using one of 1, true, yes, on, 0, false, off, or no.
+'size' values are in integer bytes, or an integer followed by 'b', 'k', or 'm' (case-insensitive)
+for bytes, KiB, or MiB.</p>
+
+<p>Note that you can set defaults for all services you create by using the DEFAULT command:</p>
+
+<pre>DEFAULT &lt;param&gt; = &lt;value&gt;</pre>
+HTML
foreach my $role ("*", "reverse_proxy", "web_server") {
if ($role eq "*") {
View
3  doc/config-guide.txt
@@ -17,6 +17,9 @@ create service <name> -- create a new service
set [<service>] <param> = <value> -- set a property on a service (see service-parameters.txt)
service name is optional when service was just created.
+default param = value -- set a default value for a service parameter, to be used
+ whenever you create a new service
+
enable <service> -- enable a service (start listening)
disable <service> -- disable a service (stops listening)
View
13 doc/service-parameters.txt
@@ -9,6 +9,11 @@
false, off, or no. 'size' values are in integer bytes, or an integer
followed by 'b', 'k', or 'm' (case-insensitive) for bytes, KiB, or MiB.
+ Note that you can set defaults for all services you create by using the
+ DEFAULT command:
+
+ DEFAULT <param> = <value>
+
For all services:
+----------------------------------------------------------------------------------+
@@ -75,6 +80,9 @@ For all services:
| | | |service that maps onto |
| | | |other services. |
|---------------------------+----+---------------------+---------------------------|
+|server_tokens |bool|true |Whether to provide a |
+| | | |"Server" header. |
+|---------------------------+----+---------------------+---------------------------|
| | | |Path to directory |
|ssl_ca_path | | |containing certificates for|
| | | |SSL. |
@@ -98,11 +106,6 @@ For all services:
| | | |where trusted means their |
| | | |X-Forwarded-For/etc headers|
| | | |are not munged. |
-|---------------------------+----+---------------------+---------------------------|
-| | | |Whether to provide a |
-|server_tokens |bool|true |'Server' header in the |
-| | | |headers that are sent back |
-| | | |to the user |
+----------------------------------------------------------------------------------+
Only for 'reverse_proxy' services:
Please sign in to comment.
Something went wrong with that request. Please try again.