perlbal::manual::selector(3pm) [debian man page]

Perlbal::Manual::Selector(3pm)				User Contributed Perl Documentation			    Perlbal::Manual::Selector(3pm)

NAME

       Perlbal::Manual::Selector - Configuring Perlbal as a virtual service that maps onto other services

   VERSION
       Perlbal 1.78.

   DESCRIPTION
       How to configure a Perlbal "selector" service.

   READ ME FIRST
       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 Selector
       The "selector" role allows you to create a service that selects to which other service a request should be sent to.

       Here's an example of how to do that with the help of Perlbal::Plugin::VHosts:

	   LOAD vhosts

	   CREATE SERVICE selector_service
	     SET listen 	= 0.0.0.0:80
	     SET role		= selector
	     SET plugins	= vhosts

	     VHOST *.site1.com	= service1
	     VHOST *.site2.com	= service2
	   ENABLE selector_service

       In this case, requests to both "site1" and "site2" are received by "selector_service", which then sends requests for "site1" to "service1"
       and requests for "site2" to "service2".

       Depending on your needs, you may want to use an existing plugin (e.g., Perlbal::Plugin::Vhosts, Perlbal::Plugin::VPaths) or create your own
       (see "selector" under Perlbal::Manual::Plugins).

   SEE ALSO
       Perlbal::Manual::Configuration, Perlbal::Manual::Management, Perlbal::Manual::Plugins, Perlbal::Plugin::Vhosts, Perlbal::Plugin::VPaths.

perl v5.14.2							    2011-01-23					    Perlbal::Manual::Selector(3pm)

Perlbal::Plugin::XFFExtras(3pm) 			User Contributed Perl Documentation			   Perlbal::Plugin::XFFExtras(3pm)

NAME

       Perlbal::Plugin::XFFExtras - Perlbal plugin that can optionally add an X-Forwarded-Port and/or X-Forwarded-Proto header to reverse proxied
       requests.

SYNOPSIS

	   # in perlbal.conf

	   LOAD XFFExtra

	   CREATE POOL web
	       POOL web ADD 10.0.0.1:80

	   CREATE SERVICE proxy
	       SET role 		       = reverse_proxy
	       SET listen		       = 0.0.0.0:80
	       SET pool 		       = web

	       SET plugins	       = XFFExtras

	       SET send_backend_port   = yes
	       SET send_backend_proto  = yes
	   ENABLE proxy

DESCRIPTION

       This plugin adds optional headers to be sent to backend servers in reverse proxy mode.

HEADERS

       o   X-Forwarded-Port

	   This header will contain an integer value indicating the port that the peer connected to.  This will correspond to the port number
	   specified on the listen line of the perlbal service that initially handled the connection.

       o   X-Forwarded-Proto

	   This header will contain a string indicating the protocol the client connected to perlbal via. Currently this will be either 'http' or
	   'https'.

AUTHOR

       Jonathan Steinert, <hachi@kuiki.net>

COPYRIGHT AND LICENSE

       Copyright (C) 2012 by Say Media Inc, <cpan@saymedia.com>

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or,
       at your option, any later version of Perl 5 you may have available.

perl v5.14.2							    2012-02-06					   Perlbal::Plugin::XFFExtras(3pm)