release revision 63404af69b0b99b8fa551e92702921f01c3bbfd7
9bff67898d55cddfcec9ce30cc2b1bb6211ec691David LawrenceCopyright (C) 2000 Internet Software Consortium.
9bff67898d55cddfcec9ce30cc2b1bb6211ec691David LawrenceSee COPYRIGHT in the source root or http://www.isc.org/copyright for terms.
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas GustafssonPreparing a bind9 release
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas GustafssonHere's a rough outline of the steps to follow in preparing a new bind9
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson - Update the README file
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)
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 - Check that http://status.isc.org/bind9/bind9.html shows
76458ec215a57c6806afdd831b9c9a30b93344b0Andreas Gustafsson a clean build and test status for all supported systems.
76458ec215a57c6806afdd831b9c9a30b93344b0Andreas Gustafsson - Check that "make all_tests" does not produce compile errors.
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
63404af69b0b99b8fa551e92702921f01c3bbfd7Andreas Gustafsson - Update the copyrights. According to tale:
63404af69b0b99b8fa551e92702921f01c3bbfd7Andreas Gustafsson Go to the root of the source tree.
63404af69b0b99b8fa551e92702921f01c3bbfd7Andreas Gustafsson The scripts need to be run from there; they reference the util
63404af69b0b99b8fa551e92702921f01c3bbfd7Andreas Gustafsson subdirectory internally.
63404af69b0b99b8fa551e92702921f01c3bbfd7Andreas Gustafsson $ make distclean
63404af69b0b99b8fa551e92702921f01c3bbfd7Andreas Gustafsson $ diff util/copyrights util/newcopyrights
63404af69b0b99b8fa551e92702921f01c3bbfd7Andreas Gustafsson ... examine output, particularly any files with the "?" type, and
63404af69b0b99b8fa551e92702921f01c3bbfd7Andreas Gustafsson ... then edit util/newcopyrights if necessary
63404af69b0b99b8fa551e92702921f01c3bbfd7Andreas Gustafsson $ cvs ci -m'merge_copyrights' util/copyrights
63404af69b0b99b8fa551e92702921f01c3bbfd7Andreas Gustafsson $ util/update_copyrights < util/copyrights
63404af69b0b99b8fa551e92702921f01c3bbfd7Andreas Gustafsson ... examine output, edit as necessary. mail me about anything that
63404af69b0b99b8fa551e92702921f01c3bbfd7Andreas Gustafsson ... the script should have been able to do itself. :-)
63404af69b0b99b8fa551e92702921f01c3bbfd7Andreas Gustafsson $ cvs ci -m'update_copyrights'
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson - Announce a CVS pool freeze on bind-dev
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson - Do basic tests on each build system:
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson check out a source tree
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson recursive query
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson exit cleanly with no leaks
c296c085a17b2d7d6823a554ebfe88ff9a5d19a7Andreas Gustafsson - On a system with gcc, run
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson - On selected platforms, do more detailed tests:
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson Using bind9 as a caching server during web surfing
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson Resolving IPv6 addresses
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson Doing queries over IPv6
76458ec215a57c6806afdd831b9c9a30b93344b0Andreas Gustafsson - Add a marker line like " --- 9.0.0b3 released ---"
76458ec215a57c6806afdd831b9c9a30b93344b0Andreas Gustafsson to the CHANGES file.
76458ec215a57c6806afdd831b9c9a30b93344b0Andreas Gustafsson - Tag the CVS source tree with the final tag, as in
76458ec215a57c6806afdd831b9c9a30b93344b0Andreas Gustafsson "cvs rtag v9_0_0b3 bind9".
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"
76458ec215a57c6806afdd831b9c9a30b93344b0Andreas Gustafsson - Run "make kit" (actually, "sh configure && make kit").
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 - Change file permissions on the signature file to make sure
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson it is not writable
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson - Build bind9 from the kit on at least one machine
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson - Prepare a release announcement based on the previous one
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson - Prepare new web site information
76458ec215a57c6806afdd831b9c9a30b93344b0Andreas Gustafsson - Verify the PGP signature:
76458ec215a57c6806afdd831b9c9a30b93344b0Andreas Gustafsson pgp bind-9.0.0b3.tar.gz.asc bind-9.0.0b3.tar.gz
b976f9c60a09f4a098852d0653ad5df6842557a7Andreas Gustafsson - Copy the distribution and PGP signature files to the FTP site:
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
b976f9c60a09f4a098852d0653ad5df6842557a7Andreas Gustafsson - Download using FTP and verify the PGP signature again
76458ec215a57c6806afdd831b9c9a30b93344b0Andreas Gustafsson - Increment the version in the file "version"
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson - Announce end of CVS pool freeze on bind-dev
b976f9c60a09f4a098852d0653ad5df6842557a7Andreas Gustafsson - Announce the release