release revision 69efd3ac39a416a0054b1ac8e5c4020336852768
f02c22d58ac88777655e0b407b22b07864d39184Evan HuntCopyright (C) 2000 Internet Software Consortium.
7bd455641455950eff7d21be652c8142b134d32fTinderbox UserSee COPYRIGHT in the source root or http://www.isc.org/copyright for terms.
7bd455641455950eff7d21be652c8142b134d32fTinderbox User
7bd455641455950eff7d21be652c8142b134d32fTinderbox User$Id: release,v 1.9 2000/06/23 03:16:24 tale Exp $
7bd455641455950eff7d21be652c8142b134d32fTinderbox User
7bd455641455950eff7d21be652c8142b134d32fTinderbox UserPreparing a bind9 release
7bd455641455950eff7d21be652c8142b134d32fTinderbox User
7bd455641455950eff7d21be652c8142b134d32fTinderbox UserHere's a rough outline of the steps to follow in preparing a new bind9
7bd455641455950eff7d21be652c8142b134d32fTinderbox Userrelease.
7bd455641455950eff7d21be652c8142b134d32fTinderbox User
7bd455641455950eff7d21be652c8142b134d32fTinderbox User - Update the README file
7bd455641455950eff7d21be652c8142b134d32fTinderbox User
7bd455641455950eff7d21be652c8142b134d32fTinderbox User - Update doc/misc/options
7bd455641455950eff7d21be652c8142b134d32fTinderbox User
8cbf3b6fc35091abde426930f2eadb8f53476c98Evan Hunt - Verify that the file "version" contains the correct version
bf8267aa453e5d2a735ed732a043b77a0b355b20Mark Andrews number (it should have been incremented after the
bf8267aa453e5d2a735ed732a043b77a0b355b20Mark Andrews previous release)
bf8267aa453e5d2a735ed732a043b77a0b355b20Mark Andrews
bf8267aa453e5d2a735ed732a043b77a0b355b20Mark Andrews - If this is a final release (not a beta), update the
bf8267aa453e5d2a735ed732a043b77a0b355b20Mark Andrews lib/*/api files as needed. See the libtool info file
bf8267aa453e5d2a735ed732a043b77a0b355b20Mark Andrews for information about what the various numbers mean.
bf8267aa453e5d2a735ed732a043b77a0b355b20Mark Andrews
bf8267aa453e5d2a735ed732a043b77a0b355b20Mark Andrews - Check that http://status.isc.org/bind9/bind9.html shows
bf8267aa453e5d2a735ed732a043b77a0b355b20Mark Andrews a clean build and test status for all supported systems.
bf8267aa453e5d2a735ed732a043b77a0b355b20Mark Andrews
bf8267aa453e5d2a735ed732a043b77a0b355b20Mark Andrews - Check that "make all_tests" does not produce compile errors.
bf8267aa453e5d2a735ed732a043b77a0b355b20Mark Andrews
bf8267aa453e5d2a735ed732a043b77a0b355b20Mark Andrews - Make sure that the most recent version of the ARM has been
9c3531d72aeaad6c5f01efe6a1c82023e1379e4dDavid Lawrence checked in. Look for any obvious broken links in the
866d106459313499d0ca7bfccb4b2d23d5e4377cDavid Lawrence .html files.
74cb99072c4b0ebd2ccafcfa284288fa760f7a1aMark Andrews
bff64bf12b58a6f80e740e94f2e42a32df18113aEvan Hunt - Update the copyrights. According to tale:
866d106459313499d0ca7bfccb4b2d23d5e4377cDavid Lawrence
7c74e180c206e6ed99e8beb820da5f399d845c3eDavid Lawrence Go to the root of the source tree.
92b796c963e7ba0217debfa27a0709f94934f5d5Mark Andrews The scripts need to be run from there; they reference the util
03e200df5dc283f24a6a349f0b31d3eab26da893Mark Andrews subdirectory internally.
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley $ make distclean
63dd46733010bb9622810faa17d88c3e3c28b730Mark Andrews $ util/merge_copyrights
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley $ diff util/copyrights util/newcopyrights
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley ... examine output, particularly any files with the "?" type, and
a5d43b72413db3edd6b36a58f9bdf2cf6ff692f2Bob Halley ... then edit util/newcopyrights if necessary
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff $ mv util/newcopyrights util/copyrights
f4ea363e3acc321b24ffe95a64a583e8041d6fd5Mark Andrews $ cvs ci -m'merge_copyrights' util/copyrights
f4ea363e3acc321b24ffe95a64a583e8041d6fd5Mark Andrews $ util/update_copyrights < util/copyrights
f4ea363e3acc321b24ffe95a64a583e8041d6fd5Mark Andrews $ cvs diff
f4ea363e3acc321b24ffe95a64a583e8041d6fd5Mark Andrews ... examine output, edit as necessary. mail me about anything that
f4ea363e3acc321b24ffe95a64a583e8041d6fd5Mark Andrews ... the script should have been able to do itself. :-)
f4ea363e3acc321b24ffe95a64a583e8041d6fd5Mark Andrews $ cvs ci -m'update_copyrights'
f4ea363e3acc321b24ffe95a64a583e8041d6fd5Mark Andrews
f4ea363e3acc321b24ffe95a64a583e8041d6fd5Mark Andrews - Announce a CVS pool freeze on bind-dev
f4ea363e3acc321b24ffe95a64a583e8041d6fd5Mark Andrews
f4ea363e3acc321b24ffe95a64a583e8041d6fd5Mark Andrews - Do basic tests on each build system:
f4ea363e3acc321b24ffe95a64a583e8041d6fd5Mark Andrews
f4ea363e3acc321b24ffe95a64a583e8041d6fd5Mark Andrews check out a source tree
f4ea363e3acc321b24ffe95a64a583e8041d6fd5Mark Andrews do a build
914eeb33149a0008e26741d9e7d89dcd6f8b6d0bMark Andrews test it:
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff transfer in
a903095bf4512dae561c7f6fc7854a51bebf334aMark Andrews transfer out
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff auth query
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff recursive query
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff exit cleanly with no leaks
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff
3d776d762914d1b675b4fd49728ce353ccf6f77eBrian Wellington - On a system with gcc, run
5b7abbef511cea0b568be0bc8d5b3120a0b9034dEvan Hunt
6b66ee9147e940572a0e873ecbd67456ccb85c39Mark Andrews find lib -name '*.h' -print | xargs util/check-includes.pl
ccdac53c027e8964753b36c4d8c7b0e98af501c2Michael Graff util/check-instincludes.sh
11dbf2fc38eea8c5d3fe7123718bf197a8bb2e6bMark Andrews
11dbf2fc38eea8c5d3fe7123718bf197a8bb2e6bMark Andrews - On selected platforms, do more detailed tests:
11dbf2fc38eea8c5d3fe7123718bf197a8bb2e6bMark Andrews
11dbf2fc38eea8c5d3fe7123718bf197a8bb2e6bMark Andrews Using bind9 as a caching server during web surfing
11dbf2fc38eea8c5d3fe7123718bf197a8bb2e6bMark Andrews Resolving IPv6 addresses
11dbf2fc38eea8c5d3fe7123718bf197a8bb2e6bMark Andrews Doing queries over IPv6
11dbf2fc38eea8c5d3fe7123718bf197a8bb2e6bMark Andrews
11dbf2fc38eea8c5d3fe7123718bf197a8bb2e6bMark Andrews - Add a marker line like " --- 9.0.0b3 released ---"
11dbf2fc38eea8c5d3fe7123718bf197a8bb2e6bMark Andrews to the CHANGES file.
11dbf2fc38eea8c5d3fe7123718bf197a8bb2e6bMark Andrews
11dbf2fc38eea8c5d3fe7123718bf197a8bb2e6bMark Andrews - Tag the CVS source tree with the final tag, as in
11dbf2fc38eea8c5d3fe7123718bf197a8bb2e6bMark Andrews "cvs rtag v9_0_0b3 bind9".
11463c0ac24692e229ec87f307f5e7df3c0a7e10Evan Hunt
11463c0ac24692e229ec87f307f5e7df3c0a7e10Evan Hunt - Export the source tree in to a fresh directory by
1c1290afabb3c8f4dd498170ac9592e5be450161Mark Andrews running "cvs export", as in "cvs export -rv9_0_0b3 bind9"
1c1290afabb3c8f4dd498170ac9592e5be450161Mark Andrews
b123b265e3a3d9b72a14230b6517e0f6fdb5c5b5Mark Andrews - Run "make kit" (actually, "sh configure && make kit").
32ebb157b1d9409a186c86002827f8a1f4931f5aMark Andrews
32ebb157b1d9409a186c86002827f8a1f4931f5aMark Andrews - Take the resulting distribution files to a secure system
740e7340c55e9f0cf80c6fbbf7e8d3c1bdeaa255Mark Andrews and sign them with the ISC signing PGP key:
32ebb157b1d9409a186c86002827f8a1f4931f5aMark Andrews "pgp -sba bind-9.0.0b3.tar.gz -u 0x51BAB2ED"
84f95ddb2572641022619950a211aff49e331c98Mukund Sivaraman
32ebb157b1d9409a186c86002827f8a1f4931f5aMark Andrews - Change file permissions on the signature file to make sure
32ebb157b1d9409a186c86002827f8a1f4931f5aMark Andrews it is not writable
32ebb157b1d9409a186c86002827f8a1f4931f5aMark Andrews
71697fd082b1c76562dc80fa91787af3860146bfEvan Hunt - Build bind9 from the kit on at least one machine
1c1290afabb3c8f4dd498170ac9592e5be450161Mark Andrews and test it
11463c0ac24692e229ec87f307f5e7df3c0a7e10Evan Hunt
a97185d9e01800850222878c2af93ea5cb08a68cMark Andrews - Prepare a release announcement based on the previous one
32ebb157b1d9409a186c86002827f8a1f4931f5aMark Andrews
32ebb157b1d9409a186c86002827f8a1f4931f5aMark Andrews - Prepare new web site information
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt - Verify the PGP signature:
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt pgp bind-9.0.0b3.tar.gz.asc bind-9.0.0b3.tar.gz
1831311ac6179951c8fcca75aa29dc2f5c0218b9Francis Dupont
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt - Copy the distribution and PGP signature files to the FTP site:
206e697f24e47b8868bd68a5b6ef42f5f62e39d5Evan Hunt
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt ssh isrv4.pa.vix.com "mkdir /udir/ftp/isc/bind9/9.0.0b4"
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt scp bind-9.0.0b4.tar.gz bind-9.0.0b4.tar.gz.asc \
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt isrv4.pa.vix.com:/udir/ftp/isc/bind9/9.0.0b4
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt - Download using FTP and verify the PGP signature again
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt - Increment the version in the file "version"
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt - Announce end of CVS pool freeze on bind-dev
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt - Announce the release
6fa84a3e255ef9e6233f0a8d134fc6d273f04599Evan Hunt