[mirrorbrain-commits] r8205 - in /trunk/docs: changes.rst upgrading.rst

Author: poeml
Date: Sat Nov  6 04:26:56 2010
New Revision: 8205

URL: http://svn.mirrorbrain.org/viewvc/mirrorbrain?rev=8205&view=rev
Log:
draft release notes for 2.14.0

Modified:
    trunk/docs/changes.rst
    trunk/docs/upgrading.rst

Modified: trunk/docs/changes.rst
URL: http://svn.mirrorbrain.org/viewvc/mirrorbrain/trunk/docs/changes.rst?rev=8205&r1=8204&r2=8205&view=diff
==============================================================================
--- trunk/docs/changes.rst (original)
+++ trunk/docs/changes.rst Sat Nov  6 04:26:56 2010
_at_@ -2,6 +2,62 @@
 
 Release Notes/Change History
 ============================
+
+
+Release 2.14.0 (r8208, Nov 6, 2010)
+-----------------------------------
+
+This release brings a number of new features, and also some bug fixes.
+
+
+- On the precondition that the "GeoLite City" GeoIP database is used,
+  MirrorBrain now uses geographical distance as additional criterion in mirror
+  selection. This is useful in
+  
+    1) large countries (like the US) and any countries with many mirrors 
+    
+    2) countries without mirrors, where only a random mirror from the continent
+       could be selected otherwise. (Defining fallback mirrors for the latter
+       countries worked before, and still has precedence.) 
+  
+  To take advantage of this feature, the free `GeoLite City
+  <http://www.maxmind.com/app/geolitecity>`_ GeoIP database needs to be used.
+  See the `2.14.0 upgrade notes`_ for instructions. (This implements `issue
+  34`_.)
+
+- Per-file mirror lists have been improved by showing data in a better readable
+  way, and by embedding a link to a Google map showing the 9 closest mirrors.
+
+- When running behind a proxy, prefix detection (for containment in network
+  prefixes of mirrors) did not work because mod_mirrorbrain only saw the
+  connecting IP address, and didn't look at an address passed via HTTP headers
+  from the proxy. This has been fixed. (AS, country and continent comparisons
+  already did this.)
+
+- An experimental feature for restricted downloads has been added, by
+  redirecting to temporary URLs whose validity need to be verified by the
+  mirrors. See
+  http://www.mail-archive.com/mirrorbrain_at_mirrorbrain.org/msg00011.html
+  This a prototype implementation that might be changed later, hence the new
+  Apache config directive is called
+  ``MirrorBrainRedirectStampKey_EXPERIMENTAL`` at the moment.
+
+- The module did not work when access was restricted with authentication (e.g.
+  Basic Authentication), due to a broken check which simply needed to be
+  removed. (A bit of code inherited from mod_offload, and likely still dating
+  back to old Apache 1.3 API.)
+
+- MirrorBrain has been tested (successfully) against the latest
+  :program:`zsync` release (0.6.2) and the documentation updated. 
+
+- An optimization in the :func:`find_lowest_rank` function, which is use to
+  fetch the prioritized mirror from an array, makes it return immediately when
+  the size of the array is 1. This might save some CPU cycles.
+
+Please read the `2.14.0 upgrade notes`_ before upgrading!
+
+.. _`2.14.0 upgrade notes`: http://mirrorbrain.org/docs/upgrading/#to-2.14.0
+.. _`issue 34`: http://mirrorbrain.org/issues/issue34
 
 
 Release 2.13.4 (r8188, Oct 19, 2010)

Modified: trunk/docs/upgrading.rst
URL: http://svn.mirrorbrain.org/viewvc/mirrorbrain/trunk/docs/upgrading.rst?rev=8205&r1=8204&r2=8205&view=diff
==============================================================================
--- trunk/docs/upgrading.rst (original)
+++ trunk/docs/upgrading.rst Sat Nov  6 04:26:56 2010
_at_@ -234,6 +234,23 @@
 Version-specific upgrade notes
 -------------------------------
 
+To `2.14.0 <http://mirrorbrain.org/docs/changes/#release-2-14-0-r8208-nov-6-2010>`_:
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To take advantage of mirror selection by geographical distance (as additional criterion to country, network prefix etc.), the free `GeoLite City
+<http://www.maxmind.com/app/geolitecity>`_ GeoIP database needs to be used. If
+you used the simpler database so far, you need to switch to the city edition
+which contains the required data. The following steps are necessary:
+
+1) Use the provided :program:`geoip-lite-update` tool to
+   download it (and keep it updated regularly via cron). 
+   
+2) Edit your mod_geoip configuration and change ``GeoIP.dat`` to ``GeoLiteCity.dat.updated``
+
+3) Run :program:`mb update -A --all-mirrors` to update the mirrors' GeoIP data (coordinates, country and region), and (if :program:`mod_asn` is used) autonomous system and prefix.
+
+
+
 From 2.13.x to `2.13.3 <http://mirrorbrain.org/docs/changes/#release-2-13-3-r8166-sep-26-2010>`_:
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
_at_@ -248,6 +265,8 @@
 You can use :program:`mb makehashes` with the ``--force`` option once to
 recreate the hashes.
 
+
+
 From 2.12.x to `2.13.0 <http://mirrorbrain.org/docs/changes/#release-2-13-0-r8123-sep-6-2010>`_:
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
_at_@ -264,6 +283,7 @@
   easier to get it to do what you want.
 
 
+
 From 2.11.1 to `2.11.2 <http://mirrorbrain.org/docs/changes/#release-2-11-2-r7917-dec-5-2009>`_:
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
_at_@ -276,6 +296,7 @@
 lowered to 20 seconds with release.
 
 
+
 From 2.10.3 to `2.11.0 <http://mirrorbrain.org/docs/changes/#release-2-11-0-r7896-dec-2-2009>`_:
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 




_______________________________________________
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