release revision a7038d1a0513c8e804937ebc95fc9cb3a46c04f5
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinCopyright (C) 2000-2002 Internet Software Consortium.
fdd80e9a55c70b36a3bf3e409b86897301c44ff8Automatic UpdaterSee COPYRIGHT in the source root or http://isc.org/copyright.html for terms.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein$Id: release,v 1.54 2002/02/20 03:34:06 marka Exp $
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinPreparing a bind9 release
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob AusteinHere's a rough outline of the steps to follow in preparing a new bind9
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Update the README file
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Send the new README file to webteam@nominum.com at least 48
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein hours prior to the planned release and ask them to prepare
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the web pages for the new version. If there have been only
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein minor changes, send context diffs relative to the previous
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater release instead.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Do a "cvs update" to check that all changes have been committed.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Verify that the file "version" contains the correct version
e21a2904f02a03fa06b6db04d348f65fe9c67b2bMark Andrews number (it should have been incremented after the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein previous release)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Before creating a new release branch, update the lib/*/api files
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein as needed. See the libtool info file for information about what
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the various numbers mean.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - If building from a release branch, check that any important
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein bug fixes made on the mainline since the last release have
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein been pulled up. You can do this by comparing the CHANGES
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein files using the util/check-pullups.pl script. For example,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein running the script from a mainline tree:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein perl util/check-pullups.pl CHANGES ../9.2/CHANGES ../9.2/EXCLUDED
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein This will list all bug fixes on the mainline that are not
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein on the 9.2 release branch.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Check that http://status.isc.org/bind9/bind9.html
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein shows a clean build and test status for all supported
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein systems and that the tests are actually being run on the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein version being released (the version can be found in the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein page behind the "Source tar build" link).
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Check that running "make all_tests" in bin/tests does not
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein produce compile errors.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Regenerate the documentation by running "make man" (mainline/9.2)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein or by running genhtml.sh in doc/arm (9.1 release branch)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein and commit it. Note that not all machines have the
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater necessary XML tools, but at least trebuchet, cuba,
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater and Scanner's machine do. Commit any files that were
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein regenerated.
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater - Verify that the documents in doc/misc are up-to-date.
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater - Update the copyrights. According to tale:
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater Go to the root of the source tree.
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater The scripts need to be run from there; they reference the util
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein subdirectory internally.
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater $ make distclean
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein ... [I prefer to check out a fresh source tree --gson]
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater ... examine output, particularly any files with the "?" type, and
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater ... then edit util/newcopyrights if necessary
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater $ cvs ci -m'merge_copyrights' util/copyrights
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater ... examine output, edit as necessary. mail me about anything that
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater ... the script should have been able to do itself. :-)
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater $ cvs ci -m'update_copyrights'
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater - Announce a CVS freeze if doing an alpha or beta release from
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater the mainline, or stop doing pullups if building from a release branch.
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater - Run util/altbuild.sh. This is to make sure that
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater builds using libtool, separate source/object directories, and other
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater obscure build options work. This script may need some hacking if run
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater on anything other than NetBSD. Save the output (it's big) and look
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater for error and warning messages.
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater cd $top_of_mainline_tree
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater cd $top_of_9_1_tree
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater Alteratively, you can do this after building the kit, by giving
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater the kit .tar.gz file as an argument to altbuild.sh instad of
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater - If you can (= your system is similar enough to the one Tale is using),
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater check the header files for cruft by running the command
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater [ This step is quite imperfect and should probably be skipped
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater for now -- Tale ]
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater find lib -name '*.h' -print | xargs perl util/check-includes.pl
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Ensure that the JPNIC patch applies cleanly:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein If you don't have the "iconv" library, you need to get it from
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein http://clisp.cons.org/~haible/packages-libiconv.html and install it.
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews $ patch -p0 < contrib/idn/mdnkit/patch/bind9/patch.most > patch.out 2>&1
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein All hunks should have applied successfully with no offset or fuzz.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein If all succeeded but some were offset or had fuzz, the patch will be
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein regenerated at the end of this stage.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein [ Sample on netbsd ... ]
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein $ CFLAGS=-I/usr/local/include ./configure '--with-iconv=-L/usr/local/lib -liconv'
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein $ cd ../../.. ; : cd back to top level
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews $ ./configure
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews ... should cleanly compile
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews $ make distclean
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews $ mkdir -p /tmp/mdn/{lib,include}
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein $ ./configure --with-mdn=/tmp/mdn --with-iconv="-L/usr/local/lib -liconv"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein $ LD_LIBRARY_PATH=/usr/local/lib:/tmp/mdn/lib:/usr/lib make
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein ... should cleanly compile
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein [ Some tests will be added to bin/tests/system to validate operation. ]
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Generate a fresh copy of the diffs:
acb72d5e2c83b597332e3eb0c7d59e1142f1adfdMark Andrews $ awk '/^\+\+\+ / {print $2}' $patchd/patch.most |
3cddb2c552ee6582e8db0849c28747f6b6ca57feAutomatic Updater while read i; do
852ccdd42a71550c974111b49415204ffeca6573Automatic Updater $ cvs diff -u2 configure > $patchd/patch.configure
ca67ebfe9eef0b8f04179f7e511a19e0337a5422Automatic Updater - Add a marker line like " --- 9.0.0rc10 released ---"
3cddb2c552ee6582e8db0849c28747f6b6ca57feAutomatic Updater to the CHANGES file.
852ccdd42a71550c974111b49415204ffeca6573Automatic Updater - Tag the CVS source tree with the final tag, as in
852ccdd42a71550c974111b49415204ffeca6573Automatic Updater "cvs rtag v9_0_0rc1 bind9" (mainline) or
acb72d5e2c83b597332e3eb0c7d59e1142f1adfdMark Andrews "cvs rtag -r v9_2 v9_2_0rc10 bind9" (release branch).
acb72d5e2c83b597332e3eb0c7d59e1142f1adfdMark Andrews - Build the release kit. This procedure differs
acb72d5e2c83b597332e3eb0c7d59e1142f1adfdMark Andrews between the 9.0 release branch and later versions.
acb72d5e2c83b597332e3eb0c7d59e1142f1adfdMark Andrews On the 9.0 release branch,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein cd <temporary directory>
38417cbfb1a328c20b5b723b8584a02c57f88897Automatic Updater cvs export -r v9_0_0rc10 bind9
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein On the 9.[1-2] release branch or mainline, use the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Build bind9 from the kit on ns-ext (phred)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein and ns-int (rc), install it, and let it run for
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein a day keeping an eye on it for any problems.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein gunzip <bind-$ver.tar.gz | tar xfv -
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein cd bind-$ver
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein sh configure
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein make install
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein ps -elf | grep named
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein # kill both the keep-running script and named itself
3a5fe5abf08f16b8d31ab8ee9a788063110ef000Automatic Updater gunzip <bind-$ver.tar.gz | tar xfv -
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein make install
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein ps -elf | grep named
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein # kill both keep-running scripts and both named9:s
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - If you can, try resolving some IPv6 addresses and
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein doing queries over IPv6.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - If problems are found at this stage, fix them, move the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein release tag up using "rtag -F", and respin the kit.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Sign the distribution files with the ISC signing PGP key
b05bdb520d83f7ecaad708fe305268c3420be01dMark Andrews and fix the permissions on the signature file:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein pgp -sba bind-$ver.tar.gz -u 0x51BAB2ED
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein chmod 644 bind-$ver.tar.gz.asc
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Verify the PGP signature:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (Look for the words "Good signature" in the output.)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - If there is a companion binary kit for NT, sign it and verify the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein pgp -sba BIND$ver.zip -u 0x51BAB2ED
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein chmod 644 BIND$ver.zip.asc
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Prepare a release announcement based on the previous one.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Copy the distribution and PGP signature files to the FTP site:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein ssh -n isrv4.pa.vix.com "mkdir /udir/ftp/isc/bind9/$ver"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - If there is a companion binary kit for NT, copy it, too:
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein ssh -n isrv4.pa.vix.com "mkdir /udir/ftp/isc/bind/contrib/ntbind-$ver"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein isrv4.pa.vix.com:/udir/ftp/isc/bind/contrib/ntbind-$ver
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Download using FTP (or a web browser) using the URLs in the release
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein announcement and verify the PGP signature again
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews - Ask webteam@nominum.com to publish the updated web pages
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - When the web pages are up, announce the release on
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein bind-announce@isc.org
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Increment the version in the file "version"
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Resume doing pullups