Permalink
Browse files

Documents new failover balancer

git-svn-id: svn://cherokee-project.com/cherokee/trunk@5908 5dc97367-97f1-0310-9951-d761b3857238
  • Loading branch information...
1 parent ea17658 commit 47bff7597d5437c10be0fc78b42e786436874d10 taher committed Dec 10, 2010
Showing with 27 additions and 0 deletions.
  1. +1 −0 doc/Makefile.am
  2. +1 −0 doc/modules.txt
  3. +2 −0 doc/modules_balancers.txt
  4. +23 −0 doc/modules_balancers_failover.txt
View
1 doc/Makefile.am
@@ -69,6 +69,7 @@ cookbook_https_accelerator.html \
cookbook_http_to_https.html \
modules.html \
modules_balancers.html \
+modules_balancers_failover.html \
modules_balancers_ip_hash.html \
modules_balancers_round_robin.html \
modules_encoders.html \
View
1 doc/modules.txt
@@ -37,3 +37,4 @@
. link:modules_balancers.html[Balancers]: Load balancing strategies.
- link:modules_balancers_round_robin.html[Round robin]: Round Robin strategy.
- link:modules_balancers_ip_hash.html[IP Hash]: Client IP hash strategy.
+ - link:modules_balancers_failover.html[Failover]: Failover/backup-server strategy.
View
2 doc/modules_balancers.txt
@@ -26,9 +26,11 @@ This is the list of currently supported balancing strategies:
* link:modules_balancers_round_robin.html[Round Robin]
* link:modules_balancers_ip_hash.html[IP Hash]
+* link:modules_balancers_failover.html[Failover]
And these are the handlers that use balancing:
* link:modules_handlers_fcgi.html[FastCGI]
* link:modules_handlers_scgi.html[SCGI]
+* link:modules_handlers_wsgi.html[uWSGI]
* link:modules_handlers_dbslayer.html[MySQL bridge]
View
23 doc/modules_balancers_failover.txt
@@ -0,0 +1,23 @@
+== link:index.html[Index] -> link:modules.html[Modules] -> link:modules_balancers.html[Balancers]
+
+Balancer: Failover
+------------------
+
+This balancer type is intended to provided a failover or backup server
+to fulfill requests only during failure of the machine(s) in the
+backend pool.
+
+This balancer is very useful when the tendency is to use single
+backends to accomodate an existing code base using tracking sessions,
+log-ins, etc. In such scenarios, just-in-case balancing might be
+required for situations where the main application server fails.
+
+If multiple entries are defined, the requests will be serverd through
+the first one on the list. When a failure is detected, Cherokee will
+kick requests to the next entry on the list for processing. Upon the
+application server returning, Cherokee will resume sending traffic to
+the original main backend application server for processing.
+
+The only thing needed to configure this balancer is a list of
+link:config_info_sources.html[information sources]. At least one must
+be selected in order for this to work.

0 comments on commit 47bff75

Please sign in to comment.