Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
Perlbal::Manual::WebSeUser(Contributed Perl DocumPerlbal::Manual::WebServer(3)

       Perlbal::Manual::WebServer - Configuring	Perlbal	as a Web Server

       Perlbal 1.78.

       How to configure	a Perlbal Web Server service.

       Please read Perlbal::Manual::Configuration first	for a better
       explanation on how to configure Perlbal.	This document will make	much
       more sense after	reading	that.

   Configuring Perlbal as a Web	Server
       By default, perlbal looks for a configuration file at

       You can also point perlbal at a different configuration file with the
       -c flag.

	   $ perlbal -c	/home/user/perlbal.conf

       Here's a	very simple example where we configure a simple	web server
       that serves an index file under /tmp

	   CREATE SERVICE perlbal_test
	       SET role		  = web_server
	       SET listen	  =
	       SET docroot	  = /tmp
	   ENABLE perlbal_test

       The first line creates a	service	called "perlbal_test". The last	line
       enables that service.

       The three parameters state - in order - that the	service	is a web
       server, that it listens on all addresses	on port	80, and	that its
       document	root is	"/tmp".

       You can set parameters via commands of either forms:

	   SET <service-name> <param> =	<value>
	   SET <param> = <value>

       dirindexing = bool
	       Show directory indexes when an HTTP request is for a directory.
	       Warning:	this is	not an async operation,	so will	slow down
	       Perlbal on heavily loaded sites.

	       Default if false.

       docroot = directory/root
	       Directory root for web server.

       enable_concatenate_get =	bool
	       Enable Perlbal's	multiple-files-in-one-request mode, where a
	       client have use a comma-separated list of files to return,
	       always in text/plain.

	       Useful for web apps which have dozens/hundreds of tiny css/js
	       files, and don't	trust browsers/etc to do pipelining.

	       Decreases overall round-trip latency a bunch, but requires app
	       to be modified to support it. See t/17-concat.t test for

	       Default is false.

       enable_md5 = bool
	       Enable verification of the Content-MD5 header in	HTTP PUT

	       Default is true.

       enable_delete = bool
	       Enable HTTP DELETE requests.

	       Default is false.

       enable_put = bool
	       Enable HTTP PUT requests.

	       Default is false.

       index_files = comma-separated list of filenames
	       Comma-separated list of filenames to load when a	user visits a
	       directory URL, listed in	order of preference.

	       Default is index.html.

       max_put_size = size
	       The maximum content-length that will be accepted	for a PUT
	       request,	if enable_put is on.

	       Default is 0, which means there is no limit.

       min_put_directory = int
	       If PUT requests are enabled, require this many levels of
	       directories to already exist. If	not, fail.

	       Default is 0.

       server_tokens = bool
	       Whether to provide a "Server" header.

	       Perlbal by default adds a header	to all replies (such as	the
	       web_server role). By setting this default to "off", you can
	       prevent Perlbal from identifying	itself.

	       Default is "on".

       Perlbal::Manual::Configuration, Perlbal::Manual::Management.

perl v5.32.0			  2012-02-20	 Perlbal::Manual::WebServer(3)


Want to link to this manual page? Use this URL:

home | help