Differences between revisions 84 and 85
Revision 84 as of 2007-06-05 21:58:00
Size: 5161
Comment: Adding forrest ReleaseHowTo
Revision 85 as of 2009-09-20 23:27:21
Size: 5182
Editor: localhost
Comment: converted to 1.6 markup
Deletions are marked like this. Additions are marked like this.
Line 7: Line 7:
 * [http://wiki.apache.org/cocoon/CocoonReleaseHowTo CocoonReleaseHowTo]
 * [http://forrest.apache.org/procedures/release/How_to_release.html ForrestReleaseHowTo]
 * [[http://wiki.apache.org/cocoon/CocoonReleaseHowTo|CocoonReleaseHowTo]]
 * [[http://forrest.apache.org/procedures/release/How_to_release.html|ForrestReleaseHowTo]]
Line 17: Line 17:
 4. '''Start testing''' the freezed code along the [wiki:TestCases test plan]. A '''test sprint on IRC''' is good for concentrated testing. ''The tests should be made on basis of a completely build Lenya binary distribution on Windows and Linux.'' It would be great, if we could make test installations available for the public and during the test sprint.  4. '''Start testing''' the freezed code along the [[TestCases|test plan]]. A '''test sprint on IRC''' is good for concentrated testing. ''The tests should be made on basis of a completely build Lenya binary distribution on Windows and Linux.'' It would be great, if we could make test installations available for the public and during the test sprint.
Line 21: Line 21:
 8. Edit the '''Downloads''' links on the web site with links to the new release files. (Currently that's [http://svn.apache.org/repos/asf/lenya/docu/src/documentation/content/xdocs/index.xml index.xml] and [http://svn.apache.org/repos/asf/lenya/docu/src/documentation/content/xdocs/docs/1_2_x/installation/index.xml docs/1_2_x/installation/index.xml].)  8. Edit the '''Downloads''' links on the web site with links to the new release files. (Currently that's [[http://svn.apache.org/repos/asf/lenya/docu/src/documentation/content/xdocs/index.xml|index.xml]] and [[http://svn.apache.org/repos/asf/lenya/docu/src/documentation/content/xdocs/docs/1_2_x/installation/index.xml|docs/1_2_x/installation/index.xml]].)
Line 48: Line 48:
 * If not yet done add your key to the [http://svn.apache.org/repos/asf/lenya/trunk/KEYS KEYS] file. Follow the instruction at the top of that file.
 * Export you public key with ''gpg -a -export [[apache account]] > .pgpkey'' and place the file ''.pgpkey'' on minotaur.a.o in your home directory. You also would sign up at [https://www.biglumber.com/ Big Lumber; Key management made easy] to easily coordinate and manage signatures for your key.
 * If not yet done add your key to the [[http://svn.apache.org/repos/asf/lenya/trunk/KEYS|KEYS]] file. Follow the instruction at the top of that file.
 * Export you public key with ''gpg -a -export [[apache account]] > .pgpkey'' and place the file ''.pgpkey'' on minotaur.a.o in your home directory. You also would sign up at [[https://www.biglumber.com/|Big Lumber; Key management made easy]] to easily coordinate and manage signatures for your key.
Line 53: Line 53:
 * [http://wiki.apache.org/incubator/SigningReleases Signing Releases How-To]
 * [http://www.apache.org/~henkp/sig/#cant-lenya State of signed Apache software releases]
 * [http://www.apache.org/~henkp/trust/apache.html ASF web of trust]
 * [http://www.apache.org/~henkp/cgi-bin/md5.cgi ASF MD5 checksum veryfier]
 * [https://www.biglumber.com/ Big Lumber; Key management made easy]
 * [[http://wiki.apache.org/incubator/SigningReleases|Signing Releases How-To]]
 * [[http://www.apache.org/~henkp/sig/#cant-lenya|State of signed Apache software releases]]
 * [[http://www.apache.org/~henkp/trust/apache.html|ASF web of trust]]
 * [[http://www.apache.org/~henkp/cgi-bin/md5.cgi|ASF MD5 checksum veryfier]]
 * [[https://www.biglumber.com/|Big Lumber; Key management made easy]]
Line 61: Line 61:
 * compile lenya.nsi with the [http://nsis.sourceforge.net/home/ NSIS compiler] (use the LZMA compressor for the smallest binaries)  * compile lenya.nsi with the [[http://nsis.sourceforge.net/home/|NSIS compiler]] (use the LZMA compressor for the smallest binaries)

This info is for Lenya committers who need to prepare a new release of Lenya. Most steps are the same as for Cocoon. Some additional notes are below.

See also

Release Schedule

Users are encouraged to test the stable branch continuously and report problems.

  1. [OPTIONAL] Vote on making release, if there is no mid or long term release plan with already established release dates.
  2. Announce beginning of release/freeze along this schedule 7 days in advance including the actual freeze date.

  3. Freeze source branch e.g. lenya/branches/BRANCH_1_2_X and send a freezed reminder to dev mailing list. Developers watch commits mailing list for commits to freezed branch, and inspect diffs to determine risk level. Risky changes are alerted on the developer list and rolled back, unless a vote passes to keep the risky change.

  4. Start testing the freezed code along the test plan. A test sprint on IRC is good for concentrated testing. The tests should be made on basis of a completely build Lenya binary distribution on Windows and Linux. It would be great, if we could make test installations available for the public and during the test sprint.

  5. New bugs found during 4 MUST be recorded in bugzilla. Bugs marked as CRITICAL or BLOCKER MUST be fixed before the release.

  6. Start at 4 again
  7. If tests are ok, vote on to release immediately; on a positive vote summary, create a tag branch; svn copy from a branch to a tag e.g. lenya/branches/BRANCH_1_2_X to lenya/tags/RELEASE_1_2_1, lock down the tagged version e.g. lenya/tags/RELEASE_1_2_1, then release (see Platform independent notes below).

  8. Edit the Downloads links on the web site with links to the new release files. (Currently that's index.xml and docs/1_2_x/installation/index.xml.)

  9. Publish a ProjectReleaseAnnouncement to appropriate places:

10. Update the Lenya DOAP file (http://svn.apache.org/repos/asf/lenya/site/doap_Lenya.rdf) with the version and date of this new release.

ISSUES

  • Try to find a day for the test sprint, where lots of devs are present.

Platform independent notes

  • compile a pristine cocoon with the local properties from lenya
  • Set property version in file src/targets/properties-build.xml to the appropriate Lenya version

  • regenerate INSTALL-src.txt and INSTALL-bin.txt with the appropriate XSLT
  • build all distribution archives, except the windows installer .exe, with ./build.sh|build dist in the Lenya source root directory. You will find the distribution archives under LENYA_SRC_DIR/dist. The dist target will also build, in case of the binary distribution, and package the editors BXE and Kupu.

  • sign the release archives with your PGP/GPG key. See instructions below.
  • Upload the release to minotaur.a.o:/x1/www/www.apache.org/dist/lenya

PGP/GPG signatures on releases

  • If not yet done add your key to the KEYS file. Follow the instruction at the top of that file.

  • Export you public key with gpg -a -export apache account > .pgpkey and place the file .pgpkey on minotaur.a.o in your home directory. You also would sign up at Big Lumber; Key management made easy to easily coordinate and manage signatures for your key.

  • Update the KEYS file at minotaur.a.o:/x1/www/www.apache.org/dist/lenya/KEYS from Lenya SVN.

ASF signing Resources

Windows installer

  • Up to Lenya 1.2.x edit file lenya.nsi and replace all version numbers appropriate

  • compile lenya.nsi with the NSIS compiler (use the LZMA compressor for the smallest binaries)

  • Sign the .exe file with your PGP/GPG public key.

ProjectReleaseHowTo (last edited 2009-09-20 23:27:21 by localhost)