release revision 9bff67898d55cddfcec9ce30cc2b1bb6211ec691
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoCopyright (C) 2000 Internet Software Consortium.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoSee COPYRIGHT in the source root or http://www.isc.org/copyright for terms.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoPreparing a bind9 release
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanoHere's a rough outline of the steps to follow in preparing a new bind9
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcanorelease.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Update the README file
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Update doc/misc/options
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Verify that the file "version" contains the correct version
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano number (it should have been incremented after the
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano previous release)
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - If this is a final release (not a beta), update the
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano lib/*/api files as needed. See the libtool info file
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano for information about what the various numbers mean.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Check that http://status.isc.org/bind9/bind9.html shows
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano a clean build and test status for all supported systems.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Check that "make all_tests" does not produce compile errors.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
99e4008cad9e959b683c6f48411fcf15a92be3b5Michel Normand - Make sure that the most recent version of the ARM has been
99e4008cad9e959b683c6f48411fcf15a92be3b5Michel Normand checked in. Look for any obvious broken links in the
10fba81b9d0221b8e47aa1e0b43236413b7d28dfMichel Normand .html files.
99e4008cad9e959b683c6f48411fcf15a92be3b5Michel Normand
99e4008cad9e959b683c6f48411fcf15a92be3b5Michel Normand - Announce a CVS pool freeze on bind-dev
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Do basic tests on each build system:
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano check out a source tree
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano do a build
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano test it:
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano transfer in
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano transfer out
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano auth query
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano recursive query
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano exit cleanly with no leaks
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - On a system with gcc, run
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano util/check-includes.pl
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano util/check-instincludes.sh
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - On selected platforms, do more detailed tests:
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano Using bind9 as a caching server during web surfing
b4578c5b380130a41a69b5b49c970157acaf1dbbDwight Engen Resolving IPv6 addresses
b4578c5b380130a41a69b5b49c970157acaf1dbbDwight Engen Doing queries over IPv6
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Add a marker line like " --- 9.0.0b3 released ---"
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano to the CHANGES file.
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Tag the CVS source tree with the final tag, as in
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano "cvs rtag v9_0_0b3 bind9".
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Export the source tree in to a fresh directory by
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano running "cvs export", as in "cvs export -rv9_0_0b3 bind9"
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Run "make kit" (actually, "sh configure && make kit").
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Take the resulting distribution files to a secure system
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano and sign them with the ISC signing PGP key:
10fba81b9d0221b8e47aa1e0b43236413b7d28dfMichel Normand "pgp -sba bind-9.0.0b3.tar.gz -u 0x51BAB2ED"
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Change file permissions on the signature file to make sure
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano it is not writable
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Build bind9 from the kit on at least one machine
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano and test it
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Prepare a release announcement based on the previous one
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Prepare new web site information
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Verify the PGP signature:
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano pgp bind-9.0.0b3.tar.gz.asc bind-9.0.0b3.tar.gz
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Copy the distribution and PGP signature files to the FTP site:
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano ssh isrv4.pa.vix.com "mkdir /udir/ftp/isc/bind9/9.0.0b4"
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano scp bind-9.0.0b4.tar.gz bind-9.0.0b4.tar.gz.asc \
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano isrv4.pa.vix.com:/udir/ftp/isc/bind9/9.0.0b4
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Download using FTP and verify the PGP signature again
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Increment the version in the file "version"
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Announce end of CVS pool freeze on bind-dev
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano - Announce the release
d823d5b966f49d975a09a8512d084389d6d7ffc7dlezcano