<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!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>3. From PowerDNS Authoritative Server 3.1 to 3.2</title><link rel="stylesheet" href="docbook.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="PowerDNS manual" /><link rel="up" href="upgrades.html" title="Chapter 11. Notes on upgrading" /><link rel="prev" href="from3.0to3.1.html" title="2. From PowerDNS Authoritative Server 3.0 to 3.1" /><link rel="next" href="powerdnssec-auth.html" title="Chapter 12. Serving authoritative DNSSEC data" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3. From PowerDNS Authoritative Server 3.1 to 3.2</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="from3.0to3.1.html">Prev</a> </td><th width="60%" align="center">Chapter 11. Notes on upgrading</th><td width="20%" align="right"> <a accesskey="n" href="powerdnssec-auth.html">Next</a></td></tr></table><hr /></div><div class="sect1" title="3. From PowerDNS Authoritative Server 3.1 to 3.2"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="from3.1to3.2"></a>3. From PowerDNS Authoritative Server 3.1 to 3.2</h2></div></div></div><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
If you are coming from 2.9.x, please also read <a class="xref" href="upgrades.html#from2.9to3.0" title="1. From PowerDNS Authoritative Server 2.9.x to 3.0">Section 1, “From PowerDNS Authoritative Server 2.9.x to 3.0”</a> and <a class="xref" href="from3.0to3.1.html" title="2. From PowerDNS Authoritative Server 3.0 to 3.1">Section 2, “From PowerDNS Authoritative Server 3.0 to 3.1”</a>.
</p></td></tr></table></div><p>
Previously, on Linux, if the PowerDNS Authoritative Server was configured to bind to the IPv6 address ::, the server would answer
questions that came in via IPv6 *and* IPv4.
</p><p>
As of 3.2, binding to :: on Linux now does the same thing as binding to :: on other operating systems: perform IPv6 service. To continue
the old behaviour, use 'local-address=0.0.0.0' and 'local-ipv6=::'.
</p><p>
3.2 again involves some SQL schema changes, to make sure 'ordername' is ordered correctly for NSEC generation. For MySQL:
</p><pre class="screen">
alter table records modify ordername VARCHAR(255) BINARY;
drop index orderindex on records;
create index recordorder on records (domain_id, ordername);
</pre><p>
You can test the BINARY change with the new and experimental 'pdnssec test-schema' command.
For PostgreSQL, there are no real schema changes, but our indexes turned out to be inefficient, especially given the changed ordername queries in 3.2.
Changes:
</p><pre class="screen">
drop index orderindex;
create index recordorder on records (domain_id, ordername text_pattern_ops);
</pre><p>
Additionally, with 3.2 supporting empty non-terminals (see <a class="xref" href="dnssec-modes.html#dnssec-direct-database" title="8.5. Rules for filling out fields in database backends">Section 8.5, “Rules for filling out fields in database backends”</a>), your frontend may need some changes.
</p><p>
Due to a bug, in 3.1 and earlier releases, the pipebackend would default to a 1000 second timeout for
responses from scripts, instead of the intended and documented 1000 milliseconds (1 second). In 3.2,
pipe-timeout is in fact in milliseconds. To avoid some surprise, the default is now 2000 (2 seconds). If you
have slow pipebackend scripts, make sure to increase pipe-timeout.
</p><p>
Some configuration settings (that did not do anything, anyway) have been removed. You need to remove
them from your configuration to start pdns_server. They are: lazy-recursion, use-logfile, logfile.
</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="from3.0to3.1.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="upgrades.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="powerdnssec-auth.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2. From PowerDNS Authoritative Server 3.0 to 3.1 </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 12. Serving authoritative DNSSEC data</td></tr></table></div></body></html>
