Author: poeml Date: Thu Oct 1 20:47:30 2009 New Revision: 7821 URL: http://svn.mirrorbrain.org/viewvc/mirrorbrain?rev=7821&view=rev Log: docs/install Ubuntu: use the packages Modified: trunk/docs/installation/debian.rst Modified: trunk/docs/installation/debian.rst URL: http://svn.mirrorbrain.org/viewvc/mirrorbrain/trunk/docs/installation/debian.rst?rev=7821&r1=7820&r2=7821&view=diff ============================================================================== --- trunk/docs/installation/debian.rst (original) +++ trunk/docs/installation/debian.rst Thu Oct 1 20:47:30 2009 _at_@ -3,56 +3,71 @@ =================================== .. note:: - The following recipe for installing MirrorBrain is based on Ubuntu 9.04. + The following recipe for installing MirrorBrain was tested on Ubuntu 9.04. + A similar procedure should work on Debian 5.0 as well. Install a standard Ubuntu LAMP server. -Download the latest MirrorBrain tarball from -http://mirrorbrain.org/files/releases/ and extract it:: - - wget http://mirrorbrain.org/files/releases/mirrorbrain-$VERSION.tar.gz - tar xzf mirrorbrain-$VERSION.tar.gz - - -Install Python dependencies ---------------------------- - -Install the following Python modules via :program:`apt-get`:: - - sudo apt-get install python-sqlobject python-psycopg2 - -The Python :mod:`cmdln` module is not prepackaged for Ubuntu so it must be installed manually:: - - wget http://cmdln.googlecode.com/files/cmdln-1.1.2.zip - sudo apt-get install unzip - unzip cmdln-1.1.2.zip - cd cmdln-1.1.2 - sudo python setup.py install - - -Install Perl dependencies -------------------------- - -For the MirrorBrain scanner, which is written in Perl, install the following Perl modules that it requires:: - - sudo apt-get install libconfig-inifiles-perl libwww-perl libdbd-pg-perl libdatetime-perl libdigest-md4-perl - - -Build, install, and configure Apache2 modules ---------------------------------------------- - -MirrorBrain requires several Apache modules, several of which must be built manually. Apache modules are built and installed using :program:`apxs2`. (APache eXtenSion tool) Apxs2 is in the ``apache2-threaded-dev`` package:: - - sudo apt-get install apache2-threaded-dev apache2-mpm-worker - - -Install and configure mod_geoip -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -mod_geoip is available as a prebuilt package:: - - sudo apt-get install libapache2-mod-geoip libgeoip-dev geoip-bin + +Add package repository +---------------------- + +To subscribe to the repository with packages for Ubuntu 9.04, add the following +to :file:`/etc/apt/sources.list`:: + + # sudo vim /etc/apt/sources.list + [...] + deb http://download.opensuse.org/repositories/Apache:/MirrorBrain/xUbuntu_9.04/ / + + +There are more repositories at +http://download.opensuse.org/repositories/Apache:/MirrorBrain/ for other Ubuntu +and Debian releases. + + +After adding the repository, update the local :program:`apt-get` package +cache:: + + sudo apt-get update + + +Install the MirrorBrain packages +-------------------------------- + +The following commands will install all needed software via +:program:`apt-get`:: + + sudo apt-get install mirrorbrain mirrorbrain-tools mirrorbrain-scanner + sudo apt-get install libapache2-mod-mirrorbrain libapache2-mod-autoindex-mb + + +.. note:: + The packages are unsigned, thus a corresponding warning needs to be + answered with 'y'. + + + + +Install an Apache MPM +--------------------- + +The MirrorBrain packages have dependencies on the Apache common packages, but +not on a MPM, since the choice of an MPM is one that the system admin must +make, and the MPMs cannot be installed in parallel. Thus, an MPM needs to be +installed (unless a LAMP package selection was installed initially). + +To install the worker MPM, run:: + + sudo apt-get install apache2-mpm-worker + +*If* the LAMP server has been installed, the prefork MPM was probably +preselected. It may make sense to switch to the worker MPM in such cases, which +is a good choice for busy download servers. + + +Configure mod_geoip +~~~~~~~~~~~~~~~~~~~ mod_geoip must be configured to find the the GeoIP data set:: _at_@ -81,24 +96,8 @@ sudo /etc/init.d/apache2 restart -Install and configure mod_form -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -mod_form must be build from scratch. Download the source from here:: - - wget http://apache.webthing.com/svn/apache/forms/mod_form.c - wget http://apache.webthing.com/svn/apache/forms/mod_form.h - -Build, install and activate mod_form (all done in one step, if ``-cia`` is used):: - - sudo apxs2 -cia mod_form.c - -Create loader:: - - sudo sh -c "cat > /etc/apache2/mods-available/form.load << EOF - LoadModule form_module /usr/lib/apache2/modules/mod_form.so - EOF - " +Configure mod_form +~~~~~~~~~~~~~~~~~~ Enable module:: _at_@ -139,20 +138,8 @@ sudo /etc/init.d/apache2 restart -Install and configure mod_mirrorbrain -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Build mod_mirrorbrain:: - - sudo apxs2 -cia mod_mirrorbrain.c - -Create module loader:: - - sudo sh -c "cat > /etc/apache2/mods-available/mirrorbrain.load << EOF - LoadModule mirrorbrain_module /usr/lib/apache2/modules/mod_mirrorbrain.so - EOF - " - +Configure mod_mirrorbrain +~~~~~~~~~~~~~~~~~~~~~~~~~ Enable module:: _at_@ -161,20 +148,6 @@ Restart Apache:: sudo /etc/init.d/apache2 restart - - -Build and install helper programs ---------------------------------- - -Build and install :program:`geoiplookup_continent`:: - - cd tools - gcc -Wall -lGeoIP -o geoiplookup_continent geoiplookup_continent.c - sudo install -m 0755 geoiplookup_continent /usr/bin/geoiplookup_continent - -Install the :program:`scanner`:: - - sudo cp ../tools/scanner.pl /usr/bin/scanner Install PostgreSQL _at_@ -279,7 +252,7 @@ If the following command returns no error, but rather displays its usage info, the installation should be quite fine:: - ./mirrordoctor.py + mb help Create a virtual host _______________________________________________ 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.orgReceived on Thu Oct 01 2009 - 18:47:33 GMT
This archive was generated by hypermail 2.3.0 : Mon Feb 20 2012 - 23:47:04 GMT