release revision 682d0209e8a67d53594fb524b5d9ae4141bcc9b2
f73e0305a745f17c6a584c4470f99ea1e023657fHans RosenfeldCopyright (C) 2004-2007, 2009 Internet Systems Consortium, Inc. ("ISC")
f73e0305a745f17c6a584c4470f99ea1e023657fHans RosenfeldCopyright (C) 2000-2003 Internet Software Consortium.
f73e0305a745f17c6a584c4470f99ea1e023657fHans RosenfeldSee COPYRIGHT in the source root or http://isc.org/copyright.html for terms.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld$Id: release,v 1.74 2009/08/06 23:47:44 tbox Exp $
f73e0305a745f17c6a584c4470f99ea1e023657fHans RosenfeldPreparing a bind9 release
f73e0305a745f17c6a584c4470f99ea1e023657fHans RosenfeldHere's a rough outline of the steps to follow in preparing a new bind9
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - Update the README file
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - Send the new README file to webteam@nominum.com at least 48
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld hours prior to the planned release and ask them to prepare
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld the web pages for the new version. If there have been only
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld minor changes, send context diffs relative to the previous
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld release instead.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - Do a "cvs update" to check that all changes have been committed.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - Verify that the file "version" contains the correct version
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld number (it should have been incremented after the
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld previous release)
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - If building from a release branch, check that any important
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld bug fixes made on the mainline since the last release have
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld been pulled up. You can do this by comparing the CHANGES
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld files using the util/check-pullups.pl script. For example,
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld running the script from a mainline tree:
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld perl util/check-pullups.pl CHANGES ../9.2/CHANGES ../9.2/EXCLUDED
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld This will list all bug fixes on the mainline that are not
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld on the 9.2 release branch.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - Before creating a new release branch, update the lib/*/api files
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld as needed. See the libtool info file for information about what
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld the various numbers mean.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld cvs rdiff -r <last_release> -r <branch/HEAD> bind9/lib > diff
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld cvs rdiff -r v9_4_0rc2 -r v9_4 bind9/lib > diff
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - Check that https://internal.isc.org/bind-build/
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld shows a clean build and test status for all supported
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld systems and that the tests are actually being run on the
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld version being released (the version can be found in the
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld page behind the "Source tar build" link).
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - Check that running "make all_tests" in bin/tests does not
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld produce compile errors.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - Regenerate the documentation by running "make man" (mainline/9.2)
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld or by running genhtml.sh in doc/arm (9.1 release branch)
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld and commit it. Note that not all machines have the
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld necessary XML tools, but at least trebuchet, cuba,
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld and Scanner's machine do. Commit any files that were
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld Most of this has now been automated, only doc/arm/ARM.pdf will
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld not be committed:
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld ssh tbox@docs.lab.isc.org
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld run this command from crontab.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld1 1 * * * /usr/bin/lockf -s -t 0 /udir/tbox/bind9-documents/regenerate.lock /udir/tbox/bind9-documents/regenerate
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld Check to see if the ARM has changed since the last release
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld and if it has commit doc/arm/ARM.pdf.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld cvs rdiff -r v9_6_1 -r v9_6 bind9/doc/arm
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - Verify that the documents in doc/misc are up-to-date.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - Update the copyrights.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld ssh tbox@cvs.isc.org
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld run these two command from the crontab
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld# Merge and Update copyrights
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld30 23 * * * /usr/bin/lockf -s -t 3600 /udir/tbox/tarballs/build-tarballs.lock /bin/sh /udir/tbox/tarballs/mergecopyrights
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld45 23 * * * /usr/bin/lockf -s -t 3600 /udir/tbox/updatecopyrights/updatecopyrights.lock /bin/sh /udir/tbox/updatecopyrights/updatecopyrights
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld When tbox@cvs.isc.org is not available:
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld Go to the root of the source tree.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld The scripts need to be run from there; they reference the util
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld subdirectory internally.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld $ make distclean
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld ... [I prefer to check out a fresh source tree --gson]
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld ... examine output, particularly any files with the "?" type, and
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld ... then edit util/newcopyrights if necessary
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld $ cvs ci -m'merge_copyrights' util/copyrights
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld $ perl util/update_copyrights < util/copyrights
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld ... examine output, edit as necessary. mail me about anything that
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld ... the script should have been able to do itself. :-)
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld $ cvs ci -m'update_copyrights'
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - Announce a CVS freeze if doing an alpha or beta release from
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld the mainline, or stop doing pullups if building from a release branch.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - Run util/altbuild.sh. This is to make sure that
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld builds using libtool, separate source/object directories, and other
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld obscure build options work. This script may need some hacking if run
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld on anything other than NetBSD. Save the output (it's big) and look
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld for error and warning messages.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld cd $top_of_mainline_tree
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld cd $top_of_9_1_tree
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld Alteratively, you can do this after building the kit, by giving
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld the kit .tar.gz file as an argument to altbuild.sh instad of
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - If you can (= your system is similar enough to the one Tale is using),
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld check the header files for cruft by running the command
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld [ This step is quite imperfect and should probably be skipped
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld for now -- Tale ]
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld find lib -name '*.h' -print | xargs perl util/check-includes.pl
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld - Ensure that the JPNIC patch applies cleanly (9.2 and 9.3):
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld If you don't have the "iconv" library, you need to get it from
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld http://clisp.cons.org/~haible/packages-libiconv.html and install it.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld If you're reading this part of these instructions in order to generate
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld a version of the patch for a new release, you'll need to pick a
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld version of the patch from some prior release to use as a starting
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld point. In general, the patch corresponding to the most recent
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld prior release will be the best starting point.
f73e0305a745f17c6a584c4470f99ea1e023657fHans Rosenfeld $ patch -p0 < contrib/idn/idnkit-1.0-src/patch/bind9/bind-9.x.y-patch \
(configure and config.h.in) are generated automatically. When
./configure --with-iconv-include=/usr/local/include \
'--with-iconv=-L/usr/local/lib -liconv'
$ autoheader ; : regenerate config.h.in
$ (cd bin/dig ; rm host.1 dig.1 ; make host.1 dig.1 ; cvs update host.1 dig.1 )
$ rm -rf /tmp/idn
[ Some tests will be added to bin/tests/system to validate operation. ]
$ patchd=$idn/patch/bind9
$ old_patch=bind-9.x.y-patch
$ new_patch=bind-9.x.z-patch
do echo Index: $i; diff -u /dev/null $i; done >> $patchd/$new_patch
$ rm README.idnkit
"util/kit.sh" script.
ssh phred.isc.org
gunzip <bind-$ver.tar.gz | tar xfv -
/var/named/keep-running ns-ext &
gunzip <bind-$ver.tar.gz | tar xfv -
/var/named/keep-running9 rc-res1 &
/var/named/keep-running9 ns-int &
pgp -sba bind-$ver.tar.gz -u 0x51BAB2ED
chmod 644 bind-$ver.tar.gz.asc
pgp -sba BIND$ver.zip -u 0x51BAB2ED
chmod 644 BIND$ver.zip.asc
- Increment the version in the file "version", "configure.in" and