[mirrorbrain-commits] r7733 - trunk/docs

Author: poeml
Date: Thu Jul 30 20:48:57 2009
New Revision: 7733
URL: http://svn.mirrorbrain.org/viewvc/mirrorbrain?view=revision&revision=7733

Log:
docs: describe how to use MirrorBrain without GeoIP

Modified:
   trunk/docs/configuration.rst

Modified: trunk/docs/configuration.rst
==============================================================================
--- trunk/docs/configuration.rst	Thu Jul 30 20:27:28 2009	(r7732)
+++ trunk/docs/configuration.rst	Thu Jul 30 20:48:57 2009	(r7733)
_at_@ -1,3 +1,54 @@
 
 Configuring MirrorBrain
 =======================
+
+To be written.
+
+
+
+
+
+
+
+
+
+
+Using mod_mirrorbrain without GeoIP
+-----------------------------------
+
+mod_mirrorbrain can be used without GeoIP. This could happen in (at least) two
+ways:
+
+1) Let's assume that GeoIP *cannot* be used: this would be the case if the
+   traffic to be redirected is in an intranet.
+
+   Country information that mod_mirrorbrain uses to select mirrors can be faked
+   with the standard Apache module `mod_setenvif`_ as in the following
+   example::
+
+        SetEnvIf Remote_Addr ^10\.10\.*      GEOIP_COUNTRY_CODE=us
+        SetEnvIf Remote_Addr ^10\.10\.*      GEOIP_CONTINENT_CODE=na
+        SetEnvIf Remote_Addr ^192\.168\.2\.* GEOIP_COUNTRY_CODE=de
+        SetEnvIf Remote_Addr ^192\.168\.2\.* GEOIP_CONTINENT_CODE=eu
+
+   The ``SetEnvIf`` directive sets two variables for each client per its
+   network address. Thus, you can configure your mirrors in the database to
+   reflect those countries. You could make up pseudo country codes, if needed.
+   
+   Based on this information, mod_mirrorbrain will chose an appropriate
+   server.
+
+2) Let's assume that a simple round-robin distribution of requests is
+   sufficient. This would be the case if the clients are all located in the same network or country. 
+
+   In such a scenario, mod_mirrorbrain will farm out the requests to all the
+   available mirrors by random. It will still do this according to the
+   preference of each mirror, and according to availability of the requested
+   files on each mirror. Mirror selection criteria as the online status of each
+   mirror will still apply. 
+   
+   Thus, this solution is more powerful than simple DNS-based round robin, or
+   random request distribution via mod_rewrite.
+
+
+.. _`mod_setenvif`: http://httpd.apache.org/docs/2.2/mod/mod_setenvif.html


_______________________________________________
mirrorbrain-commits mailing list
Archive: http://mirrorbrain.org/archive/mirrorbrain-commits/

Note: To remove yourself from this list, send a mail with the content
 	unsubscribe
to the address mirrorbrain-commits-request_at_mirrorbrain.org