[mirrorbrain-commits] r7731 - trunk/docs/installation

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

Log:
docs: move the section about enabling mirror stickiness into its own file

Added:
   trunk/docs/installation/memcache.rst
Modified:
   trunk/docs/installation/index.rst
   trunk/docs/installation/source.rst

Modified: trunk/docs/installation/index.rst
==============================================================================
--- trunk/docs/installation/index.rst	Thu Jul 30 19:37:36 2009	(r7730)
+++ trunk/docs/installation/index.rst	Thu Jul 30 20:10:00 2009	(r7731)
_at_@ -8,4 +8,5 @@
     opensuse
     gentoo
     source
+    memcache
 

Added: trunk/docs/installation/memcache.rst
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ trunk/docs/installation/memcache.rst	Thu Jul 30 20:10:00 2009	(r7731)
_at_@ -0,0 +1,44 @@
+Enabling memcache support for mirror stickiness
+===============================================
+
+Memcache support can be compiled into mod_mirrorbrain to implement "mirror
+stickiness".  Mirror stickiness means that the server tracks the client-mirror
+association. This may be useful to prevent clients from getting redirected to
+random mirrors, and rather give them the same mirror for each request.
+
+The feature is implemented using a memcache daemon.
+
+.. note:: This is an optional feature, which you should not need normally. 
+
+When compiling with memcache support, ``-DWITH_MEMCACHE`` needs to be among the
+compile flags for mod_mirrorbrain::
+
+    apxs2 -c -Wc,"-DWITH_MEMCACHE -Wall -g" mod_mirrorbrain.c
+
+If you use an apr-util version prior to 1.3, the memcache client support isn't included. Then you'll
+need to get and build libapr_memcache, and then you'll probably build mod_mirrorbrain like this::
+
+    apxs2 -c -I/usr/include/apr_memcache-0 -lapr_memcache '-Wc,-Wall -DWITH_MEMCACHE -g -D_GNU_SOURCE' mod_mirrorbrain.c
+
+
+Further steps required for memcache support would be:
+
+* install memcached
+* make sure it listens on localhost only (:file:`/etc/sysconfig/memcached` on openSUSE)
+* start it: :command:`/etc/init.d/memcached start`
+* configure it to start at boot: :command:`chkconfig -a memcached`
+* install mod_memcache from http://code.google.com/p/modmemcache/
+  (openSUSE package apache2-mod_memcache)
+* load mod_memcache: :command:`a2enmod memcache`
+
+Configuration example::
+
+    <IfModule mod_memcache.c>
+        MemcacheServer 127.0.0.1:11211 min=0 smax=4 max=16 ttl=600
+    </IfModule>
+    <IfModule mod_mirrorbrain.c>
+        MirrorBrainMemcached On
+        MirrorBrainMemcachedLifetime 1800
+    </IfModule>
+
+

Modified: trunk/docs/installation/source.rst
==============================================================================
--- trunk/docs/installation/source.rst	Thu Jul 30 19:37:36 2009	(r7730)
+++ trunk/docs/installation/source.rst	Thu Jul 30 20:10:00 2009	(r7731)
_at_@ -328,42 +328,3 @@
 
 
 
-Memcache support
-================
-
-Memcache support can be compiled into mod_mirrorbrain to implement "mirror
-stickiness". 
-
-This is an optional feature, which you should not need normally. 
-
-When compiling with memcache support, ``-DWITH_MEMCACHE`` needs to be among the
-compile flags::
-
-    apxs2 -c -Wc,"-DWITH_MEMCACHE -Wall -g" mod_mirrorbrain.c
-
-If you use an apr-util version prior to 1.3, the memcache client support isn't included. Then you'll
-need to get and build libapr_memcache, and then you'll probably build mod_mirrorbrain like this::
-
-    apxs2 -c -I/usr/include/apr_memcache-0 -lapr_memcache '-Wc,-Wall -DWITH_MEMCACHE -g -D_GNU_SOURCE' mod_mirrorbrain.c
-
-
-Further steps required for memcache support would be:
-
-* install memcached
-* make sure it listens on localhost only (/etc/sysconfig/memcached)
-* start it ("/etc/init.d/memcached start")
-* configure it to start at boot ("chkconfig -a memcached")
-* install mod_memcache from http://code.google.com/p/modmemcache/
-  (openSUSE package apache2-mod_memcache); a2enmod memcache
-
-Configuration example::
-
-    <IfModule mod_memcache.c>
-        MemcacheServer 127.0.0.1:11211 min=0 smax=4 max=16 ttl=600
-    </IfModule>
-    <IfModule mod_mirrorbrain.c>
-        MirrorBrainMemcached On
-        MirrorBrainMemcachedLifetime 1800
-    </IfModule>
-
-


_______________________________________________
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