xr(1) Man Page xr(1)
NAME
xr - Crossroads Load Balancer & Fail Over Utility
SYNOPSIS
xr [--verbose] [--web-interface XRSERVER:PORT] --server
tcp:XRSERVER:PORT --backend BACKEND:PORT [--backend BACKEND:PORT] ...
DESCRIPTION
This manual page briefly documents XR, the Crossroads Load Balancer &
Fail Over Utility.
XR is an open source load balancer and fail over utility for TCP based
services. It is a dae mon running in user space, and features extensive
configurability, polling of back ends using wake up calls, status
reporting, many algorithms to select the 'right' back end for a reques
t (and user-defined algorithms for very special cases), and much more.
XR is service-independent: it is usable for any TCP service, such as
HTTP(S), SSH, SMTP, dat abase connections. In the case of HTTP balanc-
ing, XR handles multiple host balancing, and can provide session stick-
iness for back end processes that need sessions, but aren't session-awa
re of other back ends.
XR furthermore features a management web interface and can be run as a
stand-alone daemon, or via inetd.
Execute 'xr -h' to get a complete list of available command-line param-
eters.
EXAMPLE
xr --verbose --server tcp:0:80 --backend 10.1.1.1:80 --backend
10.1.1.2:80 --backend 10.1.1. 3:80 --web-interface 0:8001
This instructs XR to listen to port 80 and to dispatch traffic to the
servers 10.1.1.1, 10.1.1.2 and 10.1.1.2, port 80. A web interface for
the balancer is started on port 8001.
Direct your browser to the server running XR. You will see the pages
served by one of the three back ends. The console where XR is started,
will show what's going on (due to the presence of --verbose).
Direct your browser to the server running XR, but port 8001. You will
see the web interface, which shows the status, and where you can alter
some settings.
SEE ALSO
xrctl(1)
AUTHOR
XR was written by Karel Kubat <karel@kubat.nl>. Web page: http://cross-
roads.e-tunity.com
This man page was written by Frederik Dannemare <frederik@dan-
nemare.net>.
Crossroads Nov 6, 2008 xr(1)
crossroads 2.36 - Generated Wed Nov 12 18:27:21 CST 2008