morciuch 2003/11/03 16:10:30 Modified: . RELEASE-TODO Log: Updated release steps to reflect the new Apache download mirroring and code signing requirements Revision Changes Path 1.19 +127 -44 jakarta-jetspeed/RELEASE-TODO Index: RELEASE-TODO =================================================================== RCS file: /home/cvs/jakarta-jetspeed/RELEASE-TODO,v retrieving revision 1.18 retrieving revision 1.19 diff -u -r1.18 -r1.19 --- RELEASE-TODO 30 Sep 2003 20:06:30 -0000 1.18 +++ RELEASE-TODO 4 Nov 2003 00:10:30 -0000 1.19 @@ -1,76 +1,159 @@ JetSpeed RELEASE-TODO Last Modified: $Date$ Latest version at: http://cvs.apache.org/viewcvs/jakarta-jetspeed/RELEASE-TODO -Author: [EMAIL PROTECTED], [EMAIL PROTECTED], [EMAIL PROTECTED] +Author: [EMAIL PROTECTED], [EMAIL PROTECTED], [EMAIL PROTECTED], [EMAIL PROTECTED] -******************************************************************************** +************************************************************************************ -These are misc notes that are used when building a Jetspeed distribution. +These are steps to be used when building a Jetspeed release distribution: 1) Update the version number in the following files: - project.xml - webapp/WEB-INF/conf/JetspeedResources.properties - (Their may be other files, so do a search on the previous version # and "-dev" + + - project.xml + - webapp/WEB-INF/conf/JetspeedResources.properties + (There may be other files, so do a search on the previous version # and "-dev") 2) Update the distribution URL in the following files: - - docs\channels\jetspeed.rss - - webapp\rss\Jetspeed.rss -3) move around TODO notes so that any done items are reflected in TODO/CHANGELOG + - docs/channels/jetspeed.rss + - webapp/rss/Jetspeed.rss + +3) Move around TODO notes so that any finished items are reflected in TODO/CHANGELOG + +4) Update the release notes in README file + +5) Update xdocs/install.xml to reference the latest download area + +6) clean your distribution (remove Jetspeed.jar from you classpath). This will +ensure a clean build + +******************************************************************************* +** Use JDK 1.3 or greater when compiling (do not use Jikes for distribution) ** +******************************************************************************* + +7) Do a cvs checkout of jakarta-jetspeed module with a -P (Prune) to a clean directory: + + cvs checkout -P jakarta-jetspeed + +8) Run unit tests: + + ant unittest-all + ant tests_tomcat_40 + +9) Build releases: + + ant clean release + ant clean release_binary + +10) Tag CVS with the revision release number (for example, JETSPEED-RELEASE-1-4): + + cvs tag JETSPEED-RELEASE-xxx + +11) Copy the distributions to the download directory on minotaur.apache.org: -4) Update the release notes + jetspeed-1.xxx-war.zip -> /www/www.apache.org/dist/jakarta/jetspeed/binaries + jetspeed-1.xxx-src.zip -> /www/www.apache.org/dist/jakarta/jetspeed/source + +12) Download the distributions to a local machine and test the .war file -5) Create the distribution directory on the apache site +13) Sign the distributions on a local machine: -6) Update xdocs/install.xml to reference the latest download area + a. If you don't have a public key yet, generate it using 'pgp -kg' + + b. If not already there, append your public key to + /www/www.apache.org/dist/jakarta/jetspeed/KEYS (dump your public key + using 'pgp -kxa <username>, where username is whatever you used in + generating the public key, for example 'morciuch') + + c. Add contents of KEYS to your public ring using 'pgp -ka KEYS' + + d. Generate the .asc files using: + + pgp -sb jetspeed-xxx-war.zip -u <username> + pgp -sb jetspeed-xxx-src.zip -u <username> + + e. Generate md5 hashes using: + + openssl md5 < jetspeed-xxx-war.zip > jetspeed-xxx-war.zip.md5 + openssl md5 < jetspeed-xxx-src.zip > jetspeed-xxx-src.zip.md5 + + f. Upload generated signature files to download directory on minotaur.apache.org: + + jetspeed-xxx-war.zip.md5 -> /www/www.apache.org/dist/jakarta/jetspeed/binaries + jetspeed-xxx-war.zip -> /www/www.apache.org/dist/jakarta/jetspeed/binaries + jetspeed-xxx-src.zip -> /www/www.apache.org/dist/jakarta/jetspeed/source + jetspeed-xxx-src.zip.md5 -> /www/www.apache.org/dist/jakarta/jetspeed/source -7) Update the channels on jakarta.apache.org/jetspeed/channels +14) Relink current release symbolic links on minotaur.apache.org: -8) clean your distribution (remove Jetspeed.jar from you classpath). This will - ensure a clean build + cd /www/www.apache.org/dist/jakarta/jetspeed + rm jetspeed-current-* + ln -s source/jetspeed-xxx-war.zip jetspeed-current.zip + ln -s source/jetspeed-xxx-src.zip jetspeed-current-src.zip + ln -s source/jetspeed-xxx-war.zip.asc jetspeed-current.zip.asc + ln -s source/jetspeed-xxx-src.zip.asc jetspeed-current-src.zip.asc -**** -** Use JDK 1.3 or greater when compiling (do not use Jikes for distribution) -**** +15) Manually update README.html in the distribution directory on minotaur.apache.org. -9) Do a cvs checkout Jetspeed with a -P (Prune) to a clean directory +16) Add the version number and the -dev version number to Bugzilla: -10) Run unit test (unittest-all and tests_tomcat_40) + HOW??? -11) Build releases (target release and release_binaray) +17) Update the Jetspeed home page on minotaur.apache.org: -12) tag CVS with the revision release number + cd /www/jakarta.apache.org/jetspeed/site + umask 002 + cvs update -13) Update the documentation on jakarta.apache.org/jetspeed/site +18) Update the Jetspeed channels on minotaur.apache.org: -14) Add the version number and the -dev version number to Bugzilla + umask 002 + cd /www/jakarta.apache.org/jetspeed/channels + cvs update -15) Copy the distributions to the download directory +19) Update Javadocs on the Jetspeed home page on minotaur.apache.org: -16) Update the news page on the Jakarta site + a. On minotaur.apache.org: + + umask 002 + cd /www.jakarta.apache.org/jetspeed + rm -r api -17) Update the download page on the Jakarta site + a. On your local machine: + + ant javadocs + + (upload docs/api --> /www/jakarta.apache.org/jetspeed) -18) Update Javadocs on the Jetspeed web site (http://jakarta.apache.org) - - ant javadocs - - scp docs/api --> /www/jakarta.apache.org/jetspeed/api +20) Check out/refresh your copy of 'jakarta-site2' module and do the following: -19) Update the Jetspeed website (jetspeed/site/) + a. Edit the Jakarta news page: /docs/index.html + + b. Edit the Jakarta source downloads page: /docs/site/sourceindex.html + + c. Edit the Jakarta binary downloads page: /docs/site/binindex.html + + d. commit the changes back to CVS + + e. Update the jakarta home page from CVS: + + cd /www/jakarta.apache.org + umask 002 + cvs update -20) Write and post announcement to mailing lists - - [EMAIL PROTECTED] - - [EMAIL PROTECTED] - - [EMAIL PROTECTED] - - post to javaworld.com - - post to freshmeat.net +21) Write and post release announcement to mailing lists: -**** -** Post release activities -**** + [EMAIL PROTECTED] + [EMAIL PROTECTED] + [EMAIL PROTECTED] + +***************************** +** Post release activities ** +***************************** -21) Update release number to "-dev". See the simular step in the previous section +22) Update release number to "-dev". See the simular steps#1 and #2. -22) Update this todo list where appropiate +23) Update this todo list where appropiate -23) Relax :) +24) Relax :)
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
