File	Date	Author	Commit
etc	2016-02-11	Charles Williams (Slydder)	[d94dd8] Initial 0.2 beta commit
scripts	2016-02-11	Charles Williams (Slydder)	[b6528e] Added License and Copyright information to files
usr	2016-02-11	Charles Williams (Slydder)	[b6528e] Added License and Copyright information to files
LICENSE	2016-02-11	Charles Williams (Slydder)	[87779d] Update README and add LICENSE
README	2016-02-11	Charles Williams (Slydder)	[b6528e] Added License and Copyright information to files

Read Me

LBActive is an dynamic and active load balancer health check system written in
Python. Currently it supports only Nginx.

LBActive dynamically adjusts the weight of a weighted round robin or ip hash Nginx
load balancer by retrieving the current load on each backend server.

The next release (if there is one) will move to a more modular approach to enable
support for other load balancers that do not have dynamic and/or active checks and
other types of backend checks if needed.

LBActive is released under the GNU General Public License version 3.0 (GPLv3).

Copyright (c) 2015 Charles Williams <chuck@itadmins.net>

This version has been tested only with Python 2.7 with the daemon and subprocess modules

1. Insert the following near the end of your nginx.conf file and restart

   include /etc/nginx/upstreams-enabled/*.conf;

2. create the directory structure needed for the upstreams (example in the tarball)

3. create the upstream configs which hold the Nginx upstream configs in upstreams-available

4. link to the upstream config you want to activate in upstreams-enabled

5. restart Nginx

6. copy lbactive script to /usr/sbin and make sure it's executable

7. copy the needed SYSV and/or Systemd LBActive scripts (see tarball)

8. install the lbfeedback script (see the README in the scripts/lbfeedback directory)

9. start LBActive