How To Make A Release
|Revision as of 23:56, 6 April 2006
Wayne (Talk | contribs)
← Previous diff
|Revision as of 20:20, 11 April 2006
Wayne (Talk | contribs)
Next diff →
|Line 14:||Line 14:|
|1) Create a ReleaseNotesX.Y.Z file describing the release, commit to cvs under readme.dir.||1) Create a ReleaseNotesX.Y.Z file describing the release, commit to cvs under readme.dir.|
|-||2) change the SRB_VERSION number for the system||+||2) If it hasn't been done already, change the SRB_VERSION number for the system|
|-||go into the top level directory and change the SRB_VERSION number in||+||Go into the top level directory and change the SRB_VERSION number in|
|configure.in, run autoconf, checkin configure.in and configure, e.g.:||configure.in, run autoconf, checkin configure.in and configure, e.g.:|
|Line 33:||Line 33:|
|makeHTML.sh script to create a new srbcommands.html file and a||makeHTML.sh script to create a new srbcommands.html file and a|
|complete new set of html files in the html subdirectory (Sinit.1.html,||complete new set of html files in the html subdirectory (Sinit.1.html,|
|-||etc), and commit those into CVS. After the release, put these in||+||etc), and commit those into CVS. With the new wiki system, we no|
|-||place on the SRB web site (/misc/www/server/srb/srbcommands).||+||longer put this on the web site but you might confirm that the|
|+||authors have updated the wiki man pages to match the .1 files.|
|3) tag the current version||3) tag the current version|
Revision as of 20:20, 11 April 2006
Here are some notes on how to make releases.
Whenever one of these minor releases is created, the tree will be tagged. If needed, you can checkout a particular version of the SRB2 tree to a directory of your choosing, e.g.
cvs checkout -r Release2_1_2 -d SRB-2.1.2-debug
How to make a Release:
(Be sure you are working in a directory with the current version of the code tree)
1) Create a ReleaseNotesX.Y.Z file describing the release, commit to cvs under readme.dir.
2) If it hasn't been done already, change the SRB_VERSION number for the system
Go into the top level directory and change the SRB_VERSION number in configure.in, run autoconf, checkin configure.in and configure, e.g.:
emacs configure.in autoconf (be sure you are using a recent version) (there is currently a bug in the configure script that requires some editing after running autoconf; so be sure to do this (see configure.readme.srbteam) cvs commit -m "Updated SRB_VERSION number" configure.in configure
Instead of the above, you can also just edit both configure.in and configure to change the version number. It is one line in each, identified with SRB_VERSION=.
2b) If the man pages have changed, cd to utilities/man and run the makeHTML.sh script to create a new srbcommands.html file and a complete new set of html files in the html subdirectory (Sinit.1.html, etc), and commit those into CVS. With the new wiki system, we no longer put this on the web site but you might confirm that the authors have updated the wiki man pages to match the .1 files.
3) tag the current version
tag the current version of all the files, recursively, with an appropriate tag for the version you are creating (since CVS does not like "."s, use _ instead, e.g.
cvs tag Release2_1_2
(this immediately records it in the repository, no need to commit)
(If you have to check in more stuff later, and then set it to the same
tag (reset the tag), use: cvs tag -F Release2_1_2 files
4) Checkout a clean version of the latest code to make sure you don't get anything that isn't checked in, e.g.
cvs checkout SRB2
cvs checkout -d SRB2.1.2 SRB2
cvs checkout -r Release2_1_2 -d SRB2.1.2 SRB2
Quite a while ago, we created an alias for the source repository so that either SRB2 or SRB2_0_0rel will work fine, since this is the repository for all the releases.
We had trouble with using the "cvs export" command, as we need the empty directories; so just a simple "cvs checkout" seems to work best altho it does create the CVS directories/files.
Currently, we need to remove the utilities/bin/Sput.pl and Sget.pl scripts before making the release. So do this by hand after the checkout.
You should also remove the inQ subdirectory.
Also remove the subdirectories under mySRB, leaving just the README.mySRB file (which refers to the web page).
5) Make encrypted tar files
(I have a script, in ~schroede/perl/mktar.pl, that helps with this; but you need to check what it does and edit some parameters.)
We now need to create 4 tar files, encrypted with pgp or openssl and with either the edu or gov copyright files. So the steps below need to be repeated. Our naming conventions for this are:
SRB3.0.1relg_bf.tar Gov, openssl(blowfish) encrypted SRB3.0.1rele_bf.tar Edu, openssl(blowfish) encrypted SRB3.0.1relg_pgp.tar Gov, pgp encrypted SRB3.0.1rele_pgp.tar Edu, pgp encrypted
Remove COPYRIGHT/Copyright.gov when making the Edu tar files, and put it back remove COPYRIGHT/Copyright.edu when making the Gov tar files.
tar up the code, e.g.
tar cf SRB2.1.2.tar SRB2.1.2
(don't use compression since some sites may have touble with that and pgp will compress it itself.)
pgp -c SRB2.1.2.tar -o srb (this will prompt for the password) mv srb.pgp SRB2.1.2rel_pgp.tar
openssl enc -e -bf -in SRB2.1.2.tar -out SRB2.1.2rel_bf.tar (this will prompt for the password)
These encrypted files go on our web site under tarfiles.
6) Update web pages (various ones) and email srb-chat, srb-news, and Paul Tooby firstname.lastname@example.org.
The ReleaseNotes file is html, so to send the email you might display it in a browser and cut and paste it to make it semi-formated plain-text. I like to include a link to the on-line html version in the email.
7) Client-only and some binary distributions should be added to the web site sometime after the release (a few days is probably OK). There is a script to create the client-only release in the readme.dir/client_only_releases subdirectory.