[mirrorbrain-commits] r8003 - /trunk/docs/installation/initial_config.rst

Author: poeml
Date: Sun Mar 14 22:34:01 2010
New Revision: 8003

URL: http://svn.mirrorbrain.org/viewvc/mirrorbrain?rev=8003&view=rev
Log:
describe a logging setup

Modified:
    trunk/docs/installation/initial_config.rst

Modified: trunk/docs/installation/initial_config.rst
URL: http://svn.mirrorbrain.org/viewvc/mirrorbrain/trunk/docs/installation/initial_config.rst?rev=8003&r1=8002&r2=8003&view=diff
==============================================================================
--- trunk/docs/installation/initial_config.rst (original)
+++ trunk/docs/installation/initial_config.rst Sun Mar 14 22:34:01 2010
@@ -160,6 +160,8 @@
   30 1 * * mon              mirrorbrain   mb db vacuum
 
 
+Testing
+-------
 
 TODO: describe how to test that the install was successful
     (When testing, consider any excludes that you configured, and which might
@@ -183,25 +185,31 @@
 .. _`cURL`: http://curl.haxx.se/
 
 
-TODO: describe a decent logging setup
-
-
-* further things that you might want to configure:
-
-  * mod_autoindex_mb, a replacement for the standard module mod_autoindex::
-
-      a2dismod autoindex
-      a2enmod autoindex_mb
-      Add IndexOptions Metalink Mirrorlist
-      # or IndexOptions +Metalink +Mirrorlist, depending on your config
-
-  * add a link to a CSS stylesheet for mirror lists::
-
-      MirrorBrainMirrorlistStylesheet "http://static.opensuse.org/css/mirrorbrain.css"
-
-    and for the autoindex::
-
-      IndexStyleSheet "http://static.opensuse.org/css/mirrorbrain.css"
+Logging setup
+-------------
+
+You may want to log more details than Apache normally logs into the access_log
+file. You can define a new log format that gives you an access_log, with
+details from MirrorBrain added::
+
+  LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" \
+  %{X-MirrorBrain-Mirror}o r:%{MB_REALM}e \
+  %{MB_CONTINENT_CODE}e:%{MB_COUNTRY_CODE}e ASN:%{ASN}e P:%{PFX}e \
+  size:%{MB_FILESIZE}e %{Range}i" combined_redirect
+
+
+This defines a new log format called "combined_redirect", which you can use in
+your virtual hosts with the CustomLog directive. 
+
+Instead of::
+
+  CustomLog /var/log/apache2/myhost/access_log combined
+
+you would use:
+
+  CustomLog /var/log/apache2/myhost/access_log combined_redirect
+
+.. TODO: describe a good logging setup with cronolog
 
 
 Create hashes
@@ -231,7 +239,28 @@
 (This command was called ``metalink-hasher`` in previous releases of
 MirrorBrain.)
 
-
+.. TODO: show how to run this command (and others) under withlock
+
+
+Optional things you might want
+------------------------------
+
+* further things that you might want to configure:
+
+  * mod_autoindex_mb, a replacement for the standard module mod_autoindex::
+
+      a2dismod autoindex
+      a2enmod autoindex_mb
+      Add IndexOptions Metalink Mirrorlist
+      # or IndexOptions +Metalink +Mirrorlist, depending on your config
+
+  * add a link to a CSS stylesheet for mirror lists::
+
+      MirrorBrainMirrorlistStylesheet "http://static.opensuse.org/css/mirrorbrain.css"
+
+    and for the autoindex::
+
+      IndexStyleSheet "http://static.opensuse.org/css/mirrorbrain.css"
 
 
 




_______________________________________________
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