Differences between revisions 22 and 23
Revision 22 as of 2006-09-18 03:55:51
Size: 10189
Editor: VDSL-130-13-157-245
Comment: Record vote and GA checklist
Revision 23 as of 2009-09-20 23:12:04
Size: 10213
Editor: localhost
Comment: converted to 1.6 markup
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
 1. Struts [http://struts.apache.org/releases.html#Releases Release Guidelines]  1. Struts [[http://struts.apache.org/releases.html#Releases|Release Guidelines]]
Line 8: Line 8:
 2. [http://wiki.apache.org/incubator/SigningReleases Signing Releases]

 3. Apache [http://apache.org/dev/mirrors.html Mirroring Guidelines]
 2. [[http://wiki.apache.org/incubator/SigningReleases|Signing Releases]]

 3. Apache [[http://apache.org/dev/mirrors.html|Mirroring Guidelines]]
Line 16: Line 16:
 * [http://wiki.wsmoak.net/cgi-bin/wiki.pl?Struts135ReleaseDiary Release Diary]  * [[http://wiki.wsmoak.net/cgi-bin/wiki.pl?Struts135ReleaseDiary|Release Diary]]
Line 50: Line 50:
 * [http://issues.apache.org/struts/secure/IssueNavigator.jspa?reset=true&mode=hide&sorter/order=DESC&sorter/field=priority&resolution=-1&pid=10121&fixfor=21721 Unresolved Issues] (zero when tagged)

 * [http://issues.apache.org/struts/secure/ReleaseNote.jspa?version=21721&styleName=Text&projectId=10121&Create=Create JIRA Release Notes]

 * [http://issues.apache.org/struts/secure/IssueNavigator.jspa?reset=true&&pid=10121&version=21721&sorter/field=priority&sorter/order=DESC All issues marked 'Affects 1.3.5']
 * [[http://issues.apache.org/struts/secure/IssueNavigator.jspa?reset=true&mode=hide&sorter/order=DESC&sorter/field=priority&resolution=-1&pid=10121&fixfor=21721|Unresolved Issues]] (zero when tagged)

 * [[http://issues.apache.org/struts/secure/ReleaseNote.jspa?version=21721&styleName=Text&projectId=10121&Create=Create|JIRA Release Notes]]

 * [[http://issues.apache.org/struts/secure/IssueNavigator.jspa?reset=true&&pid=10121&version=21721&sorter/field=priority&sorter/order=DESC|All issues marked 'Affects 1.3.5']]
Line 73: Line 73:
The Commons [http://jakarta.apache.org/commons/releases/prepare.html Preparation Guide] is a helpful preparation backgrounder, but Commons The Commons [[http://jakarta.apache.org/commons/releases/prepare.html|Preparation Guide]] is a helpful preparation backgrounder, but Commons
Line 76: Line 76:
Likewise, the [http://httpd.apache.org/dev/release.html HTTPD Release Guidelines] is a helpful "overall process" backgrounder, Likewise, the [[http://httpd.apache.org/dev/release.html|HTTPD Release Guidelines]] is a helpful "overall process" backgrounder,
Line 106: Line 106:
See also Commons [http://jakarta.apache.org/commons/releases/release.html Step-by-Step Guide] See also Commons [[http://jakarta.apache.org/commons/releases/release.html|Step-by-Step Guide]]
Line 128: Line 128:
Voting thread is [http://www.nabble.com/-VOTE--Struts-1.3.5-Quality-%28re-vote%29-t2057958.html here] Voting thread is [[http://www.nabble.com/-VOTE--Struts-1.3.5-Quality-%28re-vote%29-t2057958.html|here]]
Line 143: Line 143:
Voting thread is [http://www.nabble.com/-VOTE--Promote-Struts-1.3.5-to-General-Availability-t2269886.html here]. Voting thread is [[http://www.nabble.com/-VOTE--Promote-Struts-1.3.5-to-General-Availability-t2269886.html|here]].

Struts 1.3.5 Release

Info

  1. Struts Release Guidelines

  2. Signing Releases

  3. Apache Mirroring Guidelines

Release Manager

The release managers are Wendy Smoak and Ted Husted

How to Help

Everyone in the Struts community, users, developers, and committers, is encouraged to test a release, report any issues, and post to dev@ any comments on the overall quality of the release.

The Struts 1.3.5 distribution is available here: http://people.apache.org/builds/struts/1.3.5

To help everyone get started with Struts 1.3.5, here are the simplest installation instructions that can possibly work:

  • Download the Struts 1.3.5 distribution
  • Extract the distribution to a likely location (/opt/struts-1.3.5).
  • If possible, try the JARs in a 1.2.x application that already compiles WITHOUT deprecations.
  • Deploy and play-test the example applications from the /webapps folder to your web container
    • If you see any error messages, please do a quick search of the mail archives and/or post them on the Dev list, and if they appear to be newly introduced issues, a JIRA tickets will need to be created so we can track and resolve the issue as quickly as possible.

      • Vesion 1.3.5 is tagged. The issue can be logged against 1.3.5, but the fix would happen in 1.3.6 or later.
  • Change to the /docs directory and click-thru the documentation. If you notice anything awry, follow the "error messages" advice.

To test building Struts 1.3.5

  • Install Java 1.4 or later and set JAVA_HOME
  • Install Maven 2 and set MAVEN_HOME
  • * http://wiki.apache.org/struts/StrutsMaintenanceMaven

  • Change to the new folder (e.g., /opt/struts-1.3.5/src)
  • $ mvn install
  • Wait five minutes or more for Maven to download and build everything
  • $ cd assmbly
  • $ mvn assembly:assembly
  • The distribution will be deposited in 'assembly/target/assembly/out'.
  • If you encounter any problems with the build, follow the "error messages" advice.
  • Oh, and THANK YOU for your help. :)

Issues

Remarks

The taglib reference plugin requires JDK 1.5, so we are compiling Struts 1.3.5 under JDK 1.5, with the compiler plugin configured to target 1.4 (in struts1/pom.xml).

There is probably some sequence of commands that would deploy the jars with 1.4, then switch to 1.5 to build the site and the distribution assembly. But, it doesn't seem worth the trouble to do the research so long as the compiler works as advertised.

TO DO

Preparation Checklist

#

Description

Status

1.

Announce plan to dev@ list

(./)

2.

Review/Resolve Outstanding Bugs

(./)

3.

Update Release Notes

(./)

4.

Check Dependencies

(./)

The Commons Preparation Guide is a helpful preparation backgrounder, but Commons uses the "beta/release-candidate/final" process.

Likewise, the HTTPD Release Guidelines is a helpful "overall process" backgrounder, but HTTPD does not use a test-build stage.

External Dependency versions for this release:

Dependency

Version

Status

Used In

Antlr

2.7.2

Released

Struts Validator

Bean Scripting Framework

2.3.0

Released

Scripting

Commons BeanUtils

1.7.0

Released

core (ActionServlet, configuration, DynaActionForm)

Commons Chain

1.0

Released

core (RequestProcessor)

Commons Digester

1.6

Released

core (ActionServlet, configuration)

Commons FileUpload

1.1

Released

Struts Upload

Commons IO

1.1

Released

Required by Commons FileUpload

Commons Logging

1.0.4

Released

core (logging all over)

Commons Validator

1.3.0

Released

Struts Validator

Jakarta Oro

2.0.8

Released

Commons Validator

Testing Checklist

Testing Summary

#

Description

Completed

1.

Run Unit Test targets

(./)

2.

Run Cactus Tests (see below)

NA

3.

Play test applications (TC 5.5.x)

(./)

Note: Cactus tests are not working and have been moved to the sandbox.

Test Build Checklist (A)

See also Commons Step-by-Step Guide

#

Description

Completed

A0.

Update all pom.xml files to omit "-SNAPSHOT"

(./)

A1.

Tag release in svn: STRUTS_1_3_5

(./)

A2.

Check out a clean copy using the tag created in A1 and see StrutsMavenRelease

(./)

A3.

Deploy Test Build to people.apache.org: /www/cvs.apache.org/m2-snapshot-repository

(./)

A4.

Upload distributions to people.apache.org:/www/people.apache.org/builds/struts/v1.3.x

(./)

A5.

Refresh default website at /1.x and create archival copy at /1.3.5

(./)

A6.

Update all pom.xml files to "1.3.6-SNAPSHOT"

(./)

A7.

Create a new JIRA version level (1.x next)

(./)

A8.

Announce the Test Build on dev@ and (optionally)user@

(./)

A9.

Post release-quality vote on dev@ list

(./)

Vote (A)

PMC Member

Quality

Wendy Smoak

Beta

Don Brown

GA

James Mitchell

GA

James Holmes

Beta

Voting thread is here

If release vote fails, including for a lack of quorum, remove 1.3.5 archive from builds folder and remove archival version of website.

Vote (B)

PMC Member

Quality

Wendy Smoak

GA

James Holmes

GA

James Mitchell

GA

Joe Germuska

GA

Don Brown

GA

Laurie Harper

GA

Voting thread is here.

Voting continues until a GA or "withdraw" vote passes, or there is a subsequent release.

General Availability Checklist (C)

#

Description

Completed

C1.

Update top-level website: index.html, download pages, menus

(./)

C2.

Update the 'current' symlinks in www.apache.org/dist/struts

(./)

C3.

Post an announcement to lists and website

_


Proposed Release Announcement

Subject: [ANNOUNCE] Struts v1.3.5

The Apache Struts team is pleased to announce that Struts 1.3.5 has been promoted to General Availability.

Struts 1.3.5 is available in a full distribution, or as separate library, source, example and documentation distributions.

It is also available in the central Maven repository under Group ID "org.apache.struts".

Major changes since Struts 1.2 include

  • Composable Request Processor
  • Arbitrary configuration properties
  • Opt-In Cancel Handling
  • Enhanced Global Exception Handlers
  • Extends attribute
  • "isCommitted" Exception Handling
  • Postback Actions
  • Wildcard ActionConfig properties

Composable Request Processor: For Struts 1.3, we turned the request processor methods into Commands that are part of a flexible Chain of Commands.

Arbitrary configuration properties: Most every Struts configuration element now accepts a map of key/value pairs. Arbitrary configuration properties let us externalize more of our configurations, encouraging reuse.

Opt-In Cancel Handling: In Struts 1.3, the Cancel token is only honored if the new property "cancellable" is set for the Action Mapping. If the Cancel token is present, but cancellable is not set, then an InvalidCancelException is thrown. The InvalidCancelExeption may be caught by a Declarative Exception Handler, like any other Exception.

Enhanced Global Exception Handlers: We now support use of global exception handlers in cases when no ActionConfig has yet been identified, as in with "preprocessing" commands in a custom request processing chain.

Extends attribute: In the Struts configuration file, we can now use the extends attribute to adopt default settings from another element, as we already can in the Tiles configuration files.

"isCommitted" Exception Handling: When using Tiles, sometimes the response is already committed when an exception occurs. Now, the ExceptionHandler tests response.isCommitted, and, if true, includes the configured view path, rather than forwarding to it.

Postback Forms: The action attribute of the Form taglib is now optional. If omitted, the original URI of the original request is used.

Wildcard ActionConfig properties: Wildcards can now be used in the properties of an ActionConfig.

The 1.3.x series of the Apache Struts framework has a minumum requirement of the following specification versions:

  • Java Servlet 2.3 and JavaServer Pages (JSP) 1.2

  • Java 2 Standard Platform Edition (J2SE) 1.4

The release notes are available online at:

Notes on upgrading from prior versions can be found on the community-maintained wiki:

StrutsRelease135 (last edited 2009-09-20 23:12:04 by localhost)