Notes on the MyFaces Core 1.1.6 Release

Release manager: Leonardo Uribe

Timeline

  • 2008-08-01 - Prepare release candidate because myfaces-builder-plugins needs testing procedures
  • Proposed release date: 2008-08-14

Issues

Testing

Here's how you can help us test the distribution.

Download a nightly build of the distribution assemblies:

Configure a <repository> for Maven 2:

        <repository>
           <id>apache.snapshots</id>
           <name>Apache Snapshot Repository</name>
           <url>http://people.apache.org/repo/m2-snapshot-repository</url>
        </repository>

And declare a dependency on the 1.1.6 snapshots:

        <dependency>
            <groupId>org.apache.myfaces.core</groupId>
            <artifactId>myfaces-api</artifactId>
            <version>1.1.6-SNAPSHOT</version>
        </dependency>
        <dependency>
            <groupId>org.apache.myfaces.core</groupId>
            <artifactId>myfaces-impl</artifactId>
            <version>1.1.6-SNAPSHOT</version>
        </dependency>

Note: Maven 2.0.4 will not download a new version if one is already present in your local repository. You will need to delete $M2_REPO/org/apache/myfaces/core to force Maven to download the new version. (Usually, $M2_REPO is <your home directory>/.m2/repository .)

Test your application, then, let us know the results (good or bad!) on dev at myfaces.apache.org. (You must be subscribed to post. See: http://myfaces.apache.org/mail-lists.html.)

Tasks

Proposed Release Announcement

}}}

== Diary ==
<<Anchor(diary)>>

1. Preparing shared 2.0.8-rc1

    * copied trunk to temporary work branch shared/branches/2_0_8prepare
    * Trying to prepare (version is 2.0.8-rc1-SNAPSHOT) SUCCESS!.
{{{
mvn release:prepare -DtagBase=https://svn.apache.org/repos/asf/myfaces/shared/branches -Dusername=lu4242 -Dscm.password=??? -Dtag=2_0_8rc1 -DdryRun=true
  • Release it! FAIL.
mvn release:prepare -DtagBase=https://svn.apache.org/repos/asf/myfaces/shared/branches -Dusername=lu4242 -Dscm.password=??? -Dtag=2_0_8rc1 -Dresume=false
  • mvn install, mvn release:rollback and try again SUCCESS!
mvn release:prepare -DtagBase=https://svn.apache.org/repos/asf/myfaces/shared/branches -Dusername=lu4242 -Dscm.password=??? -Dtag=2_0_8rc1 -Dresume=false

2. Preparing core 1.1.6-rc1 (here we need to do it using release:branch since we have snapshot dependencies with release candidate of shared)

  • copied trunk to temporary work branch core/branches/1_1_6prepare
  • Set all dependencies to org.apache.myfaces.shared artifacts to version "2.0.8-rc1-SNAPSHOT" instead 2.0.8-SNAPSHOT
  • -DdryRun=true SUCCESS!
mvn release:branch -DupdateBranchVersions=true -DupdateWorkingCopyVersions=false -DtagBase=https://svn.apache.org/repos/asf/myfaces/core/branches -Dusername=lu4242 -Dscm.password=??? -DbranchName=1_1_6rc1 -DdryRun=true
  • Do it! -Dresume=false SUCCESS! (bug: mvn release:rollback does not work, so just delete generated pom.backup files before branch)
mvn release:branch -DupdateBranchVersions=true -DupdateWorkingCopyVersions=false -DtagBase=https://svn.apache.org/repos/asf/myfaces/core/branches -Dusername=lu4242 -Dscm.password=??? -DbranchName=1_1_6rc1 -Dresume=false
  • Checkout 1_1_6rc1 branch, change assembly project version and mvn install

3. Deploy all on snapshots repo (since the version ends with -SNAPSHOT, automatically when deploy the artifacts are put on http://people.apache.org/repo/m2-snapshot-repository)

mvn clean deploy -Psign-artifacts -Dpassphrase=???

4. Announce release candidate mail (subject: MyFaces Core 1.1.6-rc1 release candidate available for testing)

Hi All,

A release candidate for MyFaces Core 1.1.6 (with version number
"1.1.6-rc1-SNAPSHOT") has been made available for testing. The 1.1.x
line of releases implements the (old) JSF1.1 specification. The
artifacts can be found here:

http://people.apache.org/repo/m2-snapshot-repository/org/apache/myfaces/core/myfaces-api/1.1.6-rc1-SNAPSHOT/ http://people.apache.org/repo/m2-snapshot-repository/org/apache/myfaces/core/myfaces-impl/1.1.6-rc1-SNAPSHOT/

The last release of Myfaces Core for JSF1.1 (version 1.1.5) was in Feb
2007. Since then a lot of changes have been made. Therefore for the
upcoming 1.1.6 release we have decided to build a "release candidate"
with version number 1.1.6-rc1 for wider testing.

We would very much appreciate people testing this *release candidate*
and reporting any *regressions* since the 1.1.5 release. Please do NOT
point out any bugs that also exist in the 1.1.5 release; it has been far
too long since the last release of Core 1.1.x and we need to get things
"rolling" again, so only regressions will be dealt with at this time.

Regressions should be discussed on the dev or user list, so they get
immediate attention. Please put the text "[core 1.1.6]" at the start of
the subject line of the email.

If you are using myfaces 1.1.x in production, then you really should
test this new artifact. Those who report problems *after* the release is
out may not get a lot of sympathy!

As the rc1 artifacts are in the standard apache snapshot repository,
maven users can test them by defining the apache snapshot repo
("http://people.apache.org/repo/m2-snapshot-repository") in an active
profile in their settings.xml file then just referencing the artifact
from the pom.xml of their projects. For non-maven users, the jars can be
downloaded manually from the above locations.

If there are no significant regressions reported in the next couple of
weeks against 1.1.6-rc1-SNAPSHOT, then the final artifacts for a 1.1.6
release will be built and a release vote called (on the dev list). You
can "vote" on this thread if you like, but these "-rc1" artifacts are
not intended for release; the "real" vote will be later.


Regards,
Simon
(on behalf of Lenardo Uribe)

5. One week later prepare artifacts for release. Preparing shared 2.0.8

  • Trying to prepare SUCCESS!.
mvn release:prepare -DtagBase=https://svn.apache.org/repos/asf/myfaces/shared/branches -Dusername=lu4242 -Dscm.password=??? -Dtag=2_0_8 -DdryRun=true
  • Release it! FAIL.
mvn release:prepare -DtagBase=https://svn.apache.org/repos/asf/myfaces/shared/branches -Dusername=lu4242 -Dscm.password=??? -Dtag=2_0_8 -Dresume=false
  • mvn install, mvn release:rollback and try again SUCCESS!
mvn release:prepare -DtagBase=https://svn.apache.org/repos/asf/myfaces/shared/branches -Dusername=lu4242 -Dscm.password=??? -Dtag=2_0_8 -Dresume=false

6. Preparing core 1.1.6

  • copied trunk to temporary work branch core/branches/1_1_6prepare
  • Set all dependencies to org.apache.myfaces.shared artifacts to version "2.0.8" instead 2.0.8-SNAPSHOT
  • -DdryRun=true SUCCESS!
mvn release:prepare -DtagBase=https://svn.apache.org/repos/asf/myfaces/core/branches -Dusername=lu4242 -Dscm.password=??? -Dtag=1_1_6 -DdryRun=true
  • Do it! -Dresume=false SUCCESS!
mvn release:prepare -DtagBase=https://svn.apache.org/repos/asf/myfaces/core/branches -Dusername=lu4242 -Dscm.password=??? -Dtag=1_1_6 -Dresume=false
  • Checkout 1_1_6 branch mvn install

7. Deploy on local repo

  • shared 2.0.8
mvn clean deploy -DaltDeploymentRepository=myfaces-local-staging::default::scp://localhost/home/lu4242/stage/repo116 -Psign-artifacts -Dpassphrase=??? 
  • core 1.1.6
mvn clean deploy -DaltDeploymentRepository=myfaces-local-staging::default::scp://localhost/home/lu4242/stage/repo116 -Psign-artifacts -DperformRelease=true -Dpassphrase=??? 

*copy manually using scp to the account on people.apache.org. Due to a bug on linux [WWW] http://jira.codehaus.org/browse/MDEPLOY-62 deploy not work on linux. SUCCESS

   cd home/lu4242/stage/repo
   scp -p -r org lu4242@people.apache.org:/home/lu4242/public_html/myfaces116

8. JIRA Release Management

  • Create 1.1.6 and 1.1.7-SNAPSHOT versions
  • Find resolved issues and close them
  • Unresolved issues moved to 1.1.7-SNAPSHOT

9. Generate assembly

  • Try to do it automatically javadoc and other stuff SUCCESS. It generate myfaces-core-1.1.6-bin.tar.gz and zip,
cd 1_1_6
mvn install -Pgenerate-assembly
cd assembly
mvn assembly:assembly -Psign-artifacts -Dpassphrase=??? 

  • Create myfaces-core-1.1.6-src.tar.gz and zip manually and create .asc .md5 .sha1 for bin and src
openssl md5 myfaces-core-1.1.6-src.tar.gz > myfaces-core-1.1.6-src.tar.gz.md5
openssl md5 myfaces-core-1.1.6-src.zip > myfaces-core-1.1.6-src.zip.md5
openssl sha1 myfaces-core-1.1.6-src.tar.gz > myfaces-core-1.1.6-src.tar.gz.sha1
openssl sha1 myfaces-core-1.1.6-src.zip > myfaces-core-1.1.6-src.zip.sha1
gpg --armor --output myfaces-core-1.1.6-src.tar.gz.asc --detach-sig myfaces-core-1.1.6-src.tar.gz
gpg --armor --output myfaces-core-1.1.6-src.zip.asc --detach-sig myfaces-core-1.1.6-src.zip

openssl md5 myfaces-core-1.1.6-bin.tar.gz > myfaces-core-1.1.6-bin.tar.gz.md5
openssl md5 myfaces-core-1.1.6-bin.zip > myfaces-core-1.1.6-bin.zip.md5
openssl sha1 myfaces-core-1.1.6-bin.tar.gz > myfaces-core-1.1.6-bin.tar.gz.sha1
openssl sha1 myfaces-core-1.1.6-bin.zip > myfaces-core-1.1.6-bin.zip.sha1
gpg --armor --output myfaces-core-1.1.6-bin.tar.gz.asc --detach-sig myfaces-core-1.1.6-bin.tar.gz
gpg --armor --output myfaces-core-1.1.6-bin.zip.asc --detach-sig myfaces-core-1.1.6-bin.zip

10. TCK Test

  • TCK passed confirmed by Leonardo Uribe

11 Clirr check SUCCESS!

mvn clirr:check -DcomparisonVersion=1.1.5

12. VOTE

Hi,

I was running the needed tasks to get the 1.1.6 release of Apache
MyFaces core out.

The artifacts passed all TCK test.

Please note that this vote concerns all of the following parts:
 1. Maven artifact group "org.apache.myfaces.shared" v2.0.8  [1]
 2. Maven artifact group "org.apache.myfaces.core" v1.1.6  [1]

The artifacts are deployed to my private Apache account ([1] and [3] for binary and source packages).

The release notes could be found at [4].

Also the clirr test does not show binary incompatibilities with myfaces-api.

Please take a look at the "1.1.6" artifacts and vote!

Please note: This vote is "majority approval" with a minimum of three
+1 votes (see [3]).

------------------------------------------------
[ ] +1 for community members who have reviewed the bits
[ ] +0
[ ] -1 for fatal flaws that should cause these bits not to be released,
 and why..............
------------------------------------------------

Thanks,
Leonardo Uribe

[1] http://people.apache.org/~lu4242/myfaces116
[2] http://www.apache.org/foundation/voting.html#ReleaseVotes
[3] http://people.apache.org/~lu4242/myfaces116binsrc
[4] https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12312312&styleName=Html&projectId=10600

13. Vote closed, starting distribution

  • copy on /www/www.apache.org/dist/myfaces/source and /www/www.apache.org/dist/myfaces/binaries
cd /home/lu4242/public_html/myfaces116binsrc/sources
cp * /www/www.apache.org/dist/myfaces/source
cd /home/lu4242/public_html/myfaces116binsrc/binaries
cp * /www/www.apache.org/dist/myfaces/binaries
  • copy shared on /www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/myfaces/shared SUCCESS
Alternative for manual copy:

mvn clean deploy -DaltDeploymentRepository=myfaces-staging::default::scpexe://people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository -Psign-artifacts -Dpassphrase=???

  • copy core on /www/people.apache.org/repo/m2-ibiblio-rsync-repository/org/apache/myfaces/core SUCCESS
Alternative for manual copy:

mvn clean deploy -DaltDeploymentRepository=myfaces-staging::default::scpexe://people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository -Psign-artifacts -Dpassphrase=??? -DperformRelease=true

14. Announce

Subject: [ANNOUNCE] MyFaces Core v1.1.6 Release

The Apache MyFaces team is pleased to announce the release of MyFaces Core 1.1.6.

MyFaces Core is a JavaServer(tm) Faces 1.1 implementation as specified by JSR-127.  MyFaces Core has passed Sun's JSR-127 TCK and is 100% compliant with the JSR-127 specification. 

MyFaces Core 1.1.6 is available in both binary and source distributions.

    * http://myfaces.apache.org/download.html

MyFaces Core is also available in the central Maven repository under Group ID "org.apache.myfaces.core".

Release Notes - MyFaces Core - Version 1.1.6

Bug

    * [MYFACES-1287] - Provider for javax.xml.parsers.SAXParserFactory cannot be found
    * [MYFACES-1310] - IllegalStateException:Strict Servlet api:cannot call getOutputSteam() after getWriter() on Weblogic 8.1 sp 5
    * [MYFACES-1311] - MyFaces Portlet at Weblogic 8.1 SP5: Request Parameter weren't submitted
    * [MYFACES-1379] - CLONE -commandLink actions ignored inside tree2
    * [MYFACES-1467] - Validation doesn't run for required fields if submitted value is null
    * [MYFACES-1504] - oamSetHiddenInput function missing if ...
    * [MYFACES-1513] - myfaces-api has unnecessary commons-digester dependency
    * [MYFACES-1543] - mbean_source.jsp not working
    * [MYFACES-1549] - MyFaces-API issue: getValue of UIInput
    * [MYFACES-1555] - h:messages and h:message don't use style attribute when rendering
    * [MYFACES-1581] - UISelectOne encounters exception in call to equals()
    * [MYFACES-1590] - MyFaces build doesn't work offline - validation of TLDs fails
    * [MYFACES-1641] - ContentType cannot be set when only text/* media range is accepted
    * [MYFACES-1707] - log catched exceptions
    * [MYFACES-1740] - NullPointer exception in ErrorPageWriter
    * [MYFACES-1744] - Validation messages is shown for SelectOneMenu in case first child is not SelectItems or SelectItem
    * [MYFACES-1750] - Evaluation of EL-Expression fails with custom PropertyResolver
    * [MYFACES-1762] - h:messages - error while rendering id and styleClass attributes
    * [MYFACES-1797] - Config Parameter for refresh Period is never retrieved
    * [MYFACES-1802] - FacesException and nested exceptions
    * [MYFACES-1809] - Linkrenderer with TrinidadForm does not render parameters
    * [MYFACES-1818] - JavascriptUtils.encodeString does not properly translate '\' characters into "\\" (2) characters
    * [MYFACES-1832] - bad charset encoding on <f:param> tag
    * [MYFACES-1871] - UIInput throws IllegalArgumentException for unknown event types in broadcast()
    * [MYFACES-1876] - 1.1.6-SNAPSHOT version is not JDK 1.4 compatible
    * [MYFACES-1883] - /WEB-INF/faces-config.xml Loaded twice if logging disabled.
    * [MYFACES-1891] - ClassCastException in converter when Hiding / Showing unselected selectOneRadio

Improvement

    * [MYFACES-1535] - findComponent slow for a high amount of calls
    * [MYFACES-1552] - Rendering less JavaScript for each button
    * [MYFACES-1569] - Error message when input text is disabled or readOnly
    * [MYFACES-1591] - Improved error handling in config management
    * [MYFACES-1688] - Highlighting of component on error page
    * [MYFACES-1689] - Reload of faces-config-files if changes are detected
    * [MYFACES-1853] - ErrorPageWriter causes Facelets/MyFaces confusion
    * [MYFACES-1874] - Component generation using myfaces builder plugin for 1.1
    * [MYFACES-1887] - Print Multiple exceptions information thrown on update model
    * [MYFACES-1888] - catch Throwable errors when using ErrorPageWriter (myfaces error handling)

New Feature

    * [MYFACES-1784] - Arabizing MyFaces Core Components

Enjoy!

regards

Leonardo Uribe

  • No labels