Table of Contents

Release

2.19.0

Date

Feb 27, 2022

• Introduction
  • How to improve this documentation
    • Sources
    • Submitting changes
    • Testing documentation locally before committing
  • Implementation and design notes
    • Database hash store
• FAQ - Frequently Asked Questions
  • Is it required that all mirror servers have the same data set of files?
  • Is MirrorBrain suitable only for Linux distributions?
  • Is only HTTP supported as protocol?
  • Your fundamental design looks like that everything has to be done in a single machine. Right?
  • Do you have plans to support MySQL in addition to PostgreSQL?
  • How can requests/traffic be logged?
  • How much traffic can MirrorBrain handle?
  • Does a copy of the mirrored content have to be kept locally?
• Platforms
• Installation
  • Prerequirements
    • General
    • Apache
      • Status of Apache version on individual platforms
    • Frontend (mod_mirrorbrain, the redirector)
    • Database
    • Python and Perl modules
  • Installing from source
    • Installing Apache
    • Building Apache modules
      • mod_form
      • mod_mirrorbrain
      • mod_autoindex_mb
      • mod_geoip
    • Installing Python and Perl modules
    • Installing PostgreSQL
    • Creating database schema
    • Creating a “mirrorbrain” user and group
    • Installation of the tools
    • Configuring Apache
    • Next steps
  • Installation on openSUSE Linux or SLE
    • Adding package repositories
    • Installing the MirrorBrain packages
    • Next steps
  • Installation on Debian/Ubuntu Linux
    • Add package repository
    • Install the MirrorBrain packages
    • Select and install an Apache MPM
      • Loading Apache modules
      • Configure mod_geoip
      • Configure mod_dbd
    • Install PostgreSQL
      • Create the postgresql user account and database
      • Edit host-based authentication
      • Import initial mirrorbrain data
    • Next steps
  • Installation on Gentoo Linux
    • Next steps
  • Installing mod_asn
  • Initial configuration steps on all platforms
    • Creating a file tree
    • Creating mirrorbrain.conf
    • Testing the database admin tool
    • Creating some mirrors
    • Setting up required cron jobs
      • Setting up mirror monitoring
      • Setting up mirror scanning
      • Maintenance
      • Keeping the GeoIP database uptodate
    • Testing
    • Setting up logging
    • Creating hashes
    • Optional things you might want
    • Configuring GeoIP
      • Seting up automatic updates of the GeoIP database
    • Creating a virtual host
  • Troubleshooting
• Maintaining the mirror database
  • Concepts – the mb command
    • Built-in help
  • Creating a new mirror
  • Enabling mirror
  • Disabling a mirror
  • Deleting a mirror
  • Displaying details about a mirror
  • A mirror record explained
  • Editing a mirror
  • Editing a mirrors network location
  • Listing mirrors
  • Scanning mirrors
  • Listing files
  • Exporting mirror lists
    • Exporting in mirmon format
    • Exporting to a Version Control System (VCS)
    • Exporting in PostgreSQL format
    • Exporting in Django format
  • Performing database maintenance
    • Regular cleanups with mb db vacuum
    • Database shell with mb db shell
    • Database size info with mb db size
• Further configuring MirrorBrain
  • Generating Torrents
    • Performance considerations
    • Configuration
    • Registering with a tracker
  • Configuring zsync support
  • Magnet links
  • Serving Yum-style mirror lists
    • Security notes
  • Styling the mirrorlist / details pages
  • Configuring URL signatures
  • Using mod_mirrorbrain without GeoIP
• Use cases
  • Generating Hashes
  • Torrent server with webseeds
  • Giving mirrors a different weight - balancing the load
    • 1) Score value
    • 2) Geographical distance
• Tuning guide
  • Tuning Apache
    • MPM
    • DBD connection pool
    • Thread stack size
    • HTTP/1.1 KeepAlive
  • Tuning PostgreSQL
    • Memory sizing
    • Connection setup
    • Transaction log
    • Deadlocks
    • Enhancing logging
    • Preventing kernel “write floods”
• Upgrading
  • Refreshing package sign keys
  • Upgrading PostgreSQL
    • General notes
    • Offline upgrade
    • Online upgrade
  • Version-specific upgrade notes
    • To 2.18.0:
    • To 2.14.0:
    • From 2.13.x to 2.13.3:
    • From 2.12.x to 2.13.0:
    • From 2.11.1 to 2.11.2:
    • From 2.10.3 to 2.11.0:
• Documentation for Developers
  • Participating in the community
• Known problems
  • Database reconnections issues
  • Sporadic corruption of ASN and PFX variables in the subprocess environment
  • Inaccurate logging of ASN lookup data for 404s
  • Inaccurate logging of ASN lookup data for overridden AS
  • Wrong reporting by the scanner about symlinks
  • Pondering a hard dependency on mod_geoip
  • Mirror list shows wrong region when overridden with query parameter
  • Mirror list gives inaccurate “number of mirrors”, if mirrors were excluded
  • mb file ls crashes if probing for files that don’t exist in the database
• Release Notes/Change History
  • Release 2.18.1 (r8379, Feb 3, 2014)
  • Release 2.18.0 (r8365, Feb 2, 2014)
  • Release 2.17.0 (r8289, Apr 21, 2012)
  • Release 2.16.1 (r8261, Mar 25, 2012)
  • Release 2.16.0 (r8251, Feb 21, 2012)
  • Release 2.15.0 (r8232, Nov 13, 2010)
  • Release 2.14.0 (r8210, Nov 6, 2010)
  • Release 2.13.4 (r8188, Oct 19, 2010)
  • Release 2.13.3 (r8166, Sep 26, 2010)
  • Release 2.13.2 (r8153, Sep 19, 2010)
  • Release 2.13.1 (r8136, Sep 18, 2010)
  • Release 2.13.0 (r8123, Sep 6, 2010)
  • Release 2.12.0 (r7957, Feb 10, 2010)
  • Release 2.11.3 (r7933, Dec 16, 2009)
  • Release 2.11.2 (r7917, Dec 5, 2009)
  • Release 2.11.1 (r7899, Dec 3, 2009)
  • Release 2.11.0 (r7896, Dec 2, 2009)
  • Release 2.10.3 (r7871, Nov 28, 2009)
  • Release 2.10.2 (r7853, Nov 9, 2009)
  • Release 2.10.1 (r7798, Sep 9, 2009)
  • Release 2.10.0 (r7789, Sep 4, 2009)
  • Release 2.9.2 (Aug 21, 2009)
  • Release 2.9.1 (Jul 30, 2009)
  • Release 2.9.0 (Jul 28, 2009)
  • Release 2.8.1 (Jun 5, 2009)
  • Release 2.8 (Mar 31, 2009)
  • Release 2.7 (Mar 4, 2009)
  • Release 2.6 (Feb 13, 2009)
  • Release 2.5 (Feb 3, 2009)
  • Release 2.4 (Jan 23, 2009)
  • Release 2.3 (Dec 13, 2008)
  • Release 2.2 (Nov 22, 2008)
  • Release 2.1 (Nov 9, 2008)
  • Release 2.0 (Nov 3, 2008)
  • Release 1.9 (Oct 26, 2008)
  • Release 1.8 (Jun 2, 2008)
  • Release 1.7 (Apr 21, 2008)
  • Older changes

Indices and tables

• Index

• Module Index