release revision 20df5357b17d31a3adc4d6f7cfdd9d4f1c5addf2
9bff67898d55cddfcec9ce30cc2b1bb6211ec691David LawrenceCopyright (C) 2000 Internet Software Consortium.
9bff67898d55cddfcec9ce30cc2b1bb6211ec691David LawrenceSee COPYRIGHT in the source root or http://www.isc.org/copyright for terms.
20df5357b17d31a3adc4d6f7cfdd9d4f1c5addf2Andreas Gustafsson$Id: release,v 1.13 2000/08/08 23:37:21 gson Exp $
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
20df5357b17d31a3adc4d6f7cfdd9d4f1c5addf2Andreas Gustafsson - Update doc/misc/options, verify that doc/misc/dnssec is up-to-date
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.
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence - 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
f7aa8ce0b3cf7f5df618a42beecf8d5517c000acAndreas Gustafsson ... [I prefer to check out a fresh source tree --gson]
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
f7aa8ce0b3cf7f5df618a42beecf8d5517c000acAndreas Gustafsson $ perl 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
20df5357b17d31a3adc4d6f7cfdd9d4f1c5addf2Andreas Gustafsson - Run util/altbuild.sh. This is to make sure that builds using libtool,
20df5357b17d31a3adc4d6f7cfdd9d4f1c5addf2Andreas Gustafsson separate source/object directories, and other obscure build options
20df5357b17d31a3adc4d6f7cfdd9d4f1c5addf2Andreas Gustafsson work. Save the output and look for error and warning messages.
20df5357b17d31a3adc4d6f7cfdd9d4f1c5addf2Andreas Gustafsson - On a system like the one Tale is using (:-)), run the command
f7aa8ce0b3cf7f5df618a42beecf8d5517c000acAndreas Gustafsson find lib -name '*.h' -print | xargs perl util/check-includes.pl
f7aa8ce0b3cf7f5df618a42beecf8d5517c000acAndreas Gustafsson - On a system using gcc, do a "make install" and then
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
f7aa8ce0b3cf7f5df618a42beecf8d5517c000acAndreas Gustafsson "cvs rtag v9_0_0b3 bind9" (mainline) or
f7aa8ce0b3cf7f5df618a42beecf8d5517c000acAndreas Gustafsson "cvs rtag -r v9_0 v9_0_0rc1 bind9" (release branch).
20df5357b17d31a3adc4d6f7cfdd9d4f1c5addf2Andreas Gustafsson - Build the release kit:
20df5357b17d31a3adc4d6f7cfdd9d4f1c5addf2Andreas Gustafsson cd <temporary directory>
20df5357b17d31a3adc4d6f7cfdd9d4f1c5addf2Andreas Gustafsson cvs export -r v9_0_0rc2 bind9
f7aa8ce0b3cf7f5df618a42beecf8d5517c000acAndreas Gustafsson - Build bind9 from the kit on at least one machine
f7aa8ce0b3cf7f5df618a42beecf8d5517c000acAndreas Gustafsson - If problems are found at this stage, fix them, move the
f7aa8ce0b3cf7f5df618a42beecf8d5517c000acAndreas Gustafsson release tag up using "rtag -F", and respin the kit.
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence - 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"
20df5357b17d31a3adc4d6f7cfdd9d4f1c5addf2Andreas Gustafsson - Fix the permissions on the signature file:
f7aa8ce0b3cf7f5df618a42beecf8d5517c000acAndreas Gustafsson - Verify the PGP signature:
c7d445ce7f4db5262ba3412eac7b1ee9d053b93dAndreas Gustafsson pgp bind-9.0.0b3.tar.gz.asc bind-9.0.0b3.tar.gz
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson - Prepare a release announcement based on the previous one
2d54cf04fc02db7c369592b6f91bbd1330df3387Andreas Gustafsson - Prepare new web site information
b976f9c60a09f4a098852d0653ad5df6842557a7Andreas Gustafsson - Copy the distribution and PGP signature files to the FTP site:
20df5357b17d31a3adc4d6f7cfdd9d4f1c5addf2Andreas Gustafsson ssh isrv4.pa.vix.com "mkdir /udir/ftp/isc/bind9/$ver"
20df5357b17d31a3adc4d6f7cfdd9d4f1c5addf2Andreas Gustafsson scp bind-$ver.tar.gz bind-$ver.tar.gz.asc \
20df5357b17d31a3adc4d6f7cfdd9d4f1c5addf2Andreas Gustafsson isrv4.pa.vix.com:/udir/ftp/isc/bind9/$ver
c7d445ce7f4db5262ba3412eac7b1ee9d053b93dAndreas Gustafsson - Download using FTP (or Netscape) 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