[mirrorbrain-commits] [opensuse-svn] r6371 - trunk/tools/download-redirector-v2

From: Novell Forge SVN <noreply_at_novell.com>
Date: Wed, 4 Feb 2009 08:31:15 -0700 (MST)
Author: poeml
Date: 2009-02-04 08:31:05 -0700 (Wed, 04 Feb 2009)
New Revision: 6371

Modified:
   trunk/tools/download-redirector-v2/INSTALL
Log:
work on the install documentation


Modified: trunk/tools/download-redirector-v2/INSTALL
===================================================================
--- trunk/tools/download-redirector-v2/INSTALL	2009-02-04 15:27:14 UTC (rev 6370)
+++ trunk/tools/download-redirector-v2/INSTALL	2009-02-04 15:31:05 UTC (rev 6371)
_at_@ -237,50 +237,49 @@
 
   - create a DNS alias for your web host, if needed
 
-  - configure the database adapter (mod_dbd) and mod_mirrorbrain. Put this
-    configuration in server-wide context. Make the file chmod 0640, owned
-    root:root because it will contain the database password.
+  - configure the database adapter (mod_dbd), resp. its connection pool.
+    Put the configuration into server-wide context. 
 
+    Config example::
+    ------------------------------------------------------------------------
+    # for prefork, this configuration is inactive. prefork simply uses 1
+    # connection per child.
+    <IfModule !prefork.c>
+            DBDMin  0
+            DBDMax  32
+            DBDKeep 4
+            DBDExptime 10
+    </IfModule>
+    ------------------------------------------------------------------------
 
-Config example::
+  - configure the database driver.
+    Put this configuration into server-wide OR vhost context. Make the file
+    chmod 0640, owned root:root because it will contain the database password.
 
+    Config example::
     ------------------------------------------------------------------------
     # for MySQL:
 
-    <IfModule mod_dbd.c>
-        DBDriver mysql
-        # reconnect=0 is needed with the mysql adapter. It means that connections
-        # should not be "reanimated", because prepared statements would be lost anyway,
-        # so dead connections should rather be invalidated and new ones made.
-        DBDParams "host=localhost, user=wwwrun, pass=12345, dbname=mirrorbrain, reconnect=0"
-        # # threaded MPMs only. prefork will have use db connection per process
-        <IfModule !prefork.c>
-                # 
-                DBDMin  0
-                DBDMax  32
-                DBDKeep 4
-                DBDExptime 10
-        </IfModule>
-    </IfModule>
+    DBDriver mysql
+    # reconnect=0 is needed with the mysql adapter. It means that connections
+    # should not be "reanimated", because prepared statements would be lost anyway,
+    # so dead connections should rather be invalidated and new ones made.
+    DBDParams "host=localhost, user=wwwrun, pass=12345, dbname=mirrorbrain, reconnect=0"
+    # # threaded MPMs only. prefork will have use db connection per process
     
     # or, for PostgreSQL:
 
-    <IfModule mod_dbd.c>
-        DBDriver pgsql
-        DBDParams "host=localhost, user=wwwrun, pass=12345, dbname=mirrorbrain"
-        <IfModule !prefork.c>
-                #
-                DBDMin  0
-                DBDMax  32
-                DBDKeep 4
-                DBDExptime 10
-        </IfModule>
-    </IfModule>
+    DBDriver pgsql
+    # note that the connection string (which is passed straight through to
+    # PGconnectdb in this case) looks slightly different - pass vs. password
+    DBDParams "host=localhost user=mb password=12345 dbname=mirrorbrain connect_timeout=15"
     ------------------------------------------------------------------------
 
-  - create a vhost for it (e.g. /etc/apache2/vhosts.d/go-oo.zrkadlo.org.conf)
 
-  - create a vhost for it (e.g. /etc/apache2/vhosts.d/go-oo.mirrorbrain.org.conf)
+  - configure mod_mirrorbrain.
+    You probably want to reate a vhost (e.g.
+    /etc/apache2/vhosts.d/go-oo.mirrorbrain.org.conf) and add the MirrorBrain
+    configuration like shown here:
 
     ------------------------------------------------------------------------
     <VirtualHost your.host.name:80>
_at_@ -298,9 +297,12 @@
             MirrorBrainDebug Off
             FormGET On
             MirrorBrainHandleHEADRequestLocally Off
-            MirrorBrainMinSize 0
+            MirrorBrainMinSize 2048
             MirrorBrainHandleDirectoryIndexLocally On
-    
+            MirrorBrainExcludeUserAgent rpm/4.4.2
+            MirrorBrainExcludeUserAgent *APT-HTTP*
+            MirrorBrainExcludeMimeType application/pgp-keys
+
             Options FollowSymLinks Indexes
             AllowOverride None
             Order allow,deny
_at_@ -315,10 +317,43 @@
       rcapache2 restart
 
     
+  - mirror surveillance:
+    put this into /etc/crontab:
+      -* * * * *     root       /usr/bin/mirrorprobe -t 20 &>/dev/null
+    likewise, configure scanning:
+      44 0,4,8,12,16,20 * * *   mirrorbrain   mb scan -j 3 -a
 
 
+  - TODO: describe how to test that the install was successful
+    (When testing, consider any excludes that you configured, and which may
+    confuse you.)
 
 
+  - TODO: describe 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"
+ 
+     - prepare the metalink hashes. First, add some configuration:
+         MirrorBrainMetalinkPublisher "openSUSE" http://download.opensuse.org
+         MirrorBrainMetalinkHashesPathPrefix /var/lib/apache2/metalink-hashes/ppc
+       install the "metalink" tool from http://metamirrors.nl/metalinks_project
+       (openSUSE package called metalink, http://download.opensuse.org/repositories/network:/utilities/)
+       create the actual hashes:
+         metalink-hasher update -t /var/lib/apache2/metalink-hashes/ppc/srv/ftp/pub/opensuse/ppc -b /srv/ftp/pub/opensuse/ppc /srv/ftp/pub/opensuse/ppc
+       add the hashing command to /etc/crontab to be run every few hours.
+
+
 +++
 That's how far the instructions go. I hope they are useful. Please subscribe to
 the mirrorbrain mailing list, see http://mirrorbrain.org/communication .

_______________________________________________
Opensuse-svn mailing list
Opensuse-svn_at_forge.novell.com
http://forge.novell.com/mailman/listinfo/opensuse-svn


_______________________________________________
mirrorbrain-commits mailing list

Note: To remove yourself from this list, send a mail with the content
 	unsubscribe
to the address mirrorbrain-commits-request_at_mirrorbrain.org
Received on Wed Feb 04 2009 - 15:31:52 GMT

This archive was generated by hypermail 2.3.0 : Mon Feb 20 2012 - 23:47:04 GMT