1Perlbal::Manual::WebSerUvseerr(3C)ontributed Perl DocumePnetraltbiaoln::Manual::WebServer(3)
2
3
4

NAME

6       Perlbal::Manual::WebServer - Configuring Perlbal as a Web Server
7
8   VERSION
9       Perlbal 1.78.
10
11   DESCRIPTION
12       How to configure a Perlbal Web Server service.
13
14   READ ME FIRST
15       Please read Perlbal::Manual::Configuration first for a better
16       explanation on how to configure Perlbal. This document will make much
17       more sense after reading that.
18
19   Configuring Perlbal as a Web Server
20       By default, perlbal looks for a configuration file at
21       /etc/perlbal/perlbal.conf.
22
23       You can also point perlbal at a different configuration file with the
24       -c flag.
25
26           $ perlbal -c /home/user/perlbal.conf
27
28       Here's a very simple example where we configure a simple web server
29       that serves an index file under /tmp
30
31           CREATE SERVICE perlbal_test
32               SET role           = web_server
33               SET listen         = 0.0.0.0:80
34               SET docroot        = /tmp
35           ENABLE perlbal_test
36
37       The first line creates a service called "perlbal_test". The last line
38       enables that service.
39
40       The three parameters state - in order - that the service is a web
41       server, that it listens on all addresses on port 80, and that its
42       document root is "/tmp".
43
44   Parameters
45       You can set parameters via commands of either forms:
46
47           SET <service-name> <param> = <value>
48           SET <param> = <value>
49
50       dirindexing = bool
51               Show directory indexes when an HTTP request is for a directory.
52               Warning: this is not an async operation, so will slow down
53               Perlbal on heavily loaded sites.
54
55               Default if false.
56
57       docroot = directory/root
58               Directory root for web server.
59
60       enable_concatenate_get = bool
61               Enable Perlbal's multiple-files-in-one-request mode, where a
62               client have use a comma-separated list of files to return,
63               always in text/plain.
64
65               Useful for web apps which have dozens/hundreds of tiny css/js
66               files, and don't trust browsers/etc to do pipelining.
67
68               Decreases overall round-trip latency a bunch, but requires app
69               to be modified to support it. See t/17-concat.t test for
70               details.
71
72               Default is false.
73
74       enable_md5 = bool
75               Enable verification of the Content-MD5 header in HTTP PUT
76               requests.
77
78               Default is true.
79
80       enable_delete = bool
81               Enable HTTP DELETE requests.
82
83               Default is false.
84
85       enable_put = bool
86               Enable HTTP PUT requests.
87
88               Default is false.
89
90       index_files = comma-separated list of filenames
91               Comma-separated list of filenames to load when a user visits a
92               directory URL, listed in order of preference.
93
94               Default is index.html.
95
96       max_put_size = size
97               The maximum content-length that will be accepted for a PUT
98               request, if enable_put is on.
99
100               Default is 0, which means there is no limit.
101
102       min_put_directory = int
103               If PUT requests are enabled, require this many levels of
104               directories to already exist. If not, fail.
105
106               Default is 0.
107
108       server_tokens = bool
109               Whether to provide a "Server" header.
110
111               Perlbal by default adds a header to all replies (such as the
112               web_server role). By setting this default to "off", you can
113               prevent Perlbal from identifying itself.
114
115               Default is "on".
116
117   SEE ALSO
118       Perlbal::Manual::Configuration, Perlbal::Manual::Management.
119
120
121
122perl v5.36.0                      2023-01-18     Perlbal::Manual::WebServer(3)