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