]> CyberLeo.Net >> Repos - FreeBSD/releng/9.2.git/blob - contrib/bind9/doc/misc/migration-4to9
- Copy stable/9 to releng/9.2 as part of the 9.2-RELEASE cycle.
[FreeBSD/releng/9.2.git] / contrib / bind9 / doc / misc / migration-4to9
1 Copyright (C) 2004  Internet Systems Consortium, Inc. ("ISC")
2 Copyright (C) 2001  Internet Software Consortium.
3 See COPYRIGHT in the source root or http://isc.org/copyright.html for terms.
4
5 $Id: migration-4to9,v 1.4 2004/03/05 05:04:53 marka Exp $
6
7                    BIND 4 to BIND 9 Migration Notes
8
9 To transition from BIND 4 to BIND 9 you first need to convert your
10 configuration file to the new format.  There is a conversion tool in
11 contrib/named-bootconf that allows you to do this.
12
13         named-bootconf.sh < /etc/named.boot > /etc/named.conf
14
15 BIND 9 uses a system assigned port for the UDP queries it makes rather
16 than port 53 that BIND 4 uses.  This may conflict with some firewalls.
17 The following directives in /etc/named.conf allows you to specify
18 a port to use.
19
20         query-source address * port 53;
21         transfer-source * port 53;
22         notify-source * port 53;
23
24 BIND 9 no longer uses the minimum field to specify the TTL of records
25 without a explicit TTL.  Use the $TTL directive to specify a default TTL
26 before the first record without a explicit TTL.
27
28         $TTL 3600
29         @       IN      SOA     ns1.example.com. hostmaster.example.com. (
30                                 2001021100
31                                 7200
32                                 1200
33                                 3600000
34                                 7200 )
35
36 BIND 9 does not support multiple CNAMEs with the same owner name.
37         
38         Illegal:
39         www.example.com. CNAME host1.example.com.
40         www.example.com. CNAME host2.example.com.
41
42 BIND 9 does not support "CNAMEs with other data" with the same owner name,
43 ignoring the DNSSEC records (SIG, NXT, KEY) that BIND 4 did not support.
44
45         Illegal:
46         www.example.com. CNAME host1.example.com.
47         www.example.com. MX 10 host2.example.com.
48
49 BIND 9 is less tolerant of errors in master files, so check your logs and
50 fix any errors reported.  The named-checkzone program can also be to check
51 master files.
52
53 Outgoing zone transfers now use the "many-answers" format by default.
54 This format is not understood by certain old versions of BIND 4.  
55 You can work around this problem using the option "transfer-format
56 one-answer;", but since these old versions all have known security
57 problems, the correct fix is to upgrade the slave servers.