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 @@ -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@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 @@ -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>`_: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -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>`_: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -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>`_: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -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-requ...@mirrorbrain.org