<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Release Notes/Change History — mod_asn 1.5 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '',
VERSION: '1.5',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="mod_asn 1.5 documentation" href="index.html" />
<link rel="prev" title="Glossary" href="glossary.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="glossary.html" title="Glossary"
accesskey="P">previous</a> |</li>
<li><a href="index.html">mod_asn 1.5 documentation</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="release-notes-change-history">
<h1>Release Notes/Change History<a class="headerlink" href="#release-notes-change-history" title="Permalink to this headline">¶</a></h1>
<div class="section" id="release-1-5-r88-sep-5-2010">
<h2>Release 1.5 (r88, Sep 5, 2010)<a class="headerlink" href="#release-1-5-r88-sep-5-2010" title="Permalink to this headline">¶</a></h2>
<p>This release fixes one important bug, and improves documentation.</p>
<ul class="simple">
<li>mod_asn now avoids lookups of IPv6 addresses. The database of AS (autonomous
system) numbers is IPv4-only, and in addition, attempted lookups seem to
cause problems within the PostgreSQL <tt class="docutils literal"><span class="pre">ip4r</span></tt> contrib data type. The symptom
was a failure of the database after a while of running, and subsequent error
messages from Apache. See <a class="reference external" href="http://mirrorbrain.org/issues/issue58">issue 58</a>.</li>
<li>The used version of the APR/APR-Util library is now checked when Apache
starts, and not when the module is compiled. This is useful to choose the
correct way to access the database, which unfortunately changed between the
1.2 and 1.3 (APR-Util) release. This change makes the deployment more robust,
because even if a user mixes packages from different distro versions on a
system, mod_asn will still work correctly. This improves the existing fix for
<a class="reference external" href="http://mirrorbrain.org/issues/issue7">issue 7</a>.</li>
<li>The documentation has been updated with<ul>
<li>updated examples of Debian package names and filenames</li>
<li>an improved example about installing onto an existing database</li>
</ul>
</li>
</ul>
</div>
<div class="section" id="release-1-4-r79-mar-27-2010">
<h2>Release 1.4 (r79, Mar 27, 2010)<a class="headerlink" href="#release-1-4-r79-mar-27-2010" title="Permalink to this headline">¶</a></h2>
<p>This release does not bring about significant user-visible changes, but under
the hood, some optimizations were done.</p>
<ul class="simple">
<li>For more efficient database connection usage, mod_asn now closes the used
connection when its handler quits. Before, a connection with lifetime of the
request was acquired; if a long-running handler runs after mod_asn, this
could mean that the connection is blocked for other threads until the end of
the request. This could occur, for instance, when mod_mirrorbrain ran later,
but exited early because a file was supposed to be delivered directly.
This was tracked in <a class="reference external" href="http://mirrorbrain.org/issues/issue44">issue 44</a>.</li>
<li>Database errors from the lower DBD layer are now resolved to strings, where
available. In relation to this: if an IP address is not found it isn’t
necessarily an error, because it could be a private IP, for instance, which
is never present in global routing tables. That case is now logged with
NOTICE log level.</li>
<li>When compiling mod_asn with the Apache Portable Runtime 1.2, different
semantics are used to access database rows, couting from 0 instead of from 1. It
seemed to work either way (maybe because only a single row is accessed), but
hopefully now it is done more correctly and therefore safer in the future.
See <a class="reference external" href="http://mirrorbrain.org/issues/issue29">issue 29</a> and <a class="reference external" href="http://mirrorbrain.org/issues/issue7">issue 7</a> for the context.</li>
<li>In the documentation, the support scripts are now mentioned without their
<tt class="file docutils literal"><span class="pre">.py</span></tt> suffix in the example for data import, which might be less
confusing.</li>
</ul>
</div>
<div class="section" id="release-1-3-r70-jul-30-2009">
<h2>Release 1.3 (r70, Jul 30, 2009)<a class="headerlink" href="#release-1-3-r70-jul-30-2009" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Bugs in the <strong class="program">asn_get_routeviews</strong> and <strong class="program">asn_import</strong> scripts were fixed:<ul>
<li>The logic which decided whether to download the routing data snapshot file
was fixed. If <strong class="program">asn_get_routeviews</strong> is called and it finds a file
which was downloaded less then 8 hours ago, the file is reused. If no file
exists or the file is older than 8 hours, it is downloaded again.</li>
<li>Deletion of existing entries in the database is now prevented, if not at
least one entry has been imported. This fixes a bug where the routing data
would be deleted if the script was called with no input.</li>
</ul>
</li>
</ul>
</div>
<div class="section" id="release-1-2-jul-28-2009">
<h2>Release 1.2 (Jul 28, 2009)<a class="headerlink" href="#release-1-2-jul-28-2009" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><strong class="program">asn_get_routeviews</strong> script:<ul>
<li>download data from the <a class="reference external" href="http://mirrorbrain.org/routeviews/">mirror</a>
provided by the MirrorBrain project, so routeviews.org doesn’t get
additional traffic by additional users downloading from them</li>
</ul>
</li>
<li>the documentation has been moved into a docs subdirectory, and rewritten in
reStructured Text format, from which HTML is be generated via Sphinx
(<a class="reference external" href="http://sphinx.pocoo.org/">http://sphinx.pocoo.org/</a>). When the documentation is changed in subversion,
the changes automatically get online on <a class="reference external" href="http://mirrorbrain.org/mod_asn/docs/">http://mirrorbrain.org/mod_asn/docs/</a></li>
<li>documentation updates<ul>
<li>section <a class="reference internal" href="installation.html#keep-the-data-up-to-date"><em>Keep the data up to date</em></a> added</li>
<li>add <a class="reference internal" href="upgrading.html#upgrading"><em>Upgrading</em></a> notes about PostgreSQL (8.4)</li>
<li>install the new documentaion when building Debian or RPM packages</li>
</ul>
</li>
<li>“debian” subdirectory added, for Debian package builds</li>
<li>the Subversion repository was moved to <a class="reference external" href="http://svn.mirrorbrain.org/svn/mod_asn/trunk/">http://svn.mirrorbrain.org/svn/mod_asn/trunk/</a></li>
</ul>
</div>
<div class="section" id="release-1-1-jul-4-2009">
<h2>Release 1.1 (Jul 4, 2009)<a class="headerlink" href="#release-1-1-jul-4-2009" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>mod_asn.c:<ul>
<li>bump version (1.1)</li>
<li>update year in copyright header</li>
</ul>
</li>
<li><strong class="program">asn_import</strong> script:<ul>
<li>be able to read config from <tt class="file docutils literal"><span class="pre">/etc/asn_import.conf</span></tt> or
<tt class="file docutils literal"><span class="pre">/etc/mirrorbrain.conf</span></tt>; thus, the script doesn’t need to be edited
any longer with database configuration data and credentials.<ol class="arabic">
<li>if a MirrorBrain config file is found, it is used (and the MirrorBrain
instance can be selected with -b on the commandline, if needed)</li>
<li>alternatively, the script looks for a config file named
<tt class="file docutils literal"><span class="pre">/etc/asn_import.conf</span></tt>.</li>
</ol>
</li>
</ul>
</li>
<li><strong class="program">asn_get_routeviews</strong> script:<ul>
<li>handle the slightly changed format of routeviews data</li>
<li>more sanity checks for parsing newer routing data</li>
</ul>
</li>
<li>INSTALL:<ul>
<li>add links to binaries for Debian and ebuilds for Gentoo</li>
<li>add instructions for troubleshooting and testing</li>
<li>correct a wrong example of loading mod_asn instead of mod_dbd</li>
<li>added example for cron snippet for updating the routing database</li>
<li>documentation about the newly supported config file</li>
</ul>
</li>
<li>add debian subdirectory for building Debian packages</li>
</ul>
</div>
<div class="section" id="release-1-0-mar-31-2009">
<h2>Release 1.0 (Mar 31, 2009)<a class="headerlink" href="#release-1-0-mar-31-2009" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>mod_asn.c:<ul>
<li>fix bug that lead to ignorance of variables in the subprocess environment
set by <tt class="docutils literal"><span class="pre">ASIPEnvvar</span></tt>, which falsely looked for the wrong variable name (one
that was configured via <tt class="docutils literal"><span class="pre">ASIPHeader</span></tt>).</li>
</ul>
</li>
<li>document an example how to log the looked up data</li>
</ul>
</div>
<div class="section" id="older-changes">
<h2>Older changes<a class="headerlink" href="#older-changes" title="Permalink to this headline">¶</a></h2>
<p>Please refer to the subversion changelog: <a class="reference external" href="http://svn.mirrorbrain.org/svn/mod_asn/trunk">http://svn.mirrorbrain.org/svn/mod_asn/trunk</a>
respectively <a class="reference external" href="http://svn.mirrorbrain.org/viewvc/mod_asn/trunk/">http://svn.mirrorbrain.org/viewvc/mod_asn/trunk/</a></p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Release Notes/Change History</a><ul>
<li><a class="reference internal" href="#release-1-5-r88-sep-5-2010">Release 1.5 (r88, Sep 5, 2010)</a></li>
<li><a class="reference internal" href="#release-1-4-r79-mar-27-2010">Release 1.4 (r79, Mar 27, 2010)</a></li>
<li><a class="reference internal" href="#release-1-3-r70-jul-30-2009">Release 1.3 (r70, Jul 30, 2009)</a></li>
<li><a class="reference internal" href="#release-1-2-jul-28-2009">Release 1.2 (Jul 28, 2009)</a></li>
<li><a class="reference internal" href="#release-1-1-jul-4-2009">Release 1.1 (Jul 4, 2009)</a></li>
<li><a class="reference internal" href="#release-1-0-mar-31-2009">Release 1.0 (Mar 31, 2009)</a></li>
<li><a class="reference internal" href="#older-changes">Older changes</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="glossary.html"
title="previous chapter">Glossary</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/changes.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="glossary.html" title="Glossary"
>previous</a> |</li>
<li><a href="index.html">mod_asn 1.5 documentation</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2010, Peter Poeml.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
</div>
</body>
</html>
