Page History

...

1. The plan is to sync Geronimo Eclipse Plugin (GEP) releases with those of the Geronimo server. The goal is to release GEP as soon as possible after the release of the corresponding server.
   
   

   Note
   Note: These notes are written for release 2.2. Change the version number accordingly for your release!

   
   
2. Pick up JIRA list of fixed bugs and new features from Release Notes and defer unresolved JIRAs
3. Update the release notes. They are the file PLUGIN_RELEASE-NOTES-2.2.txt in trunk. Copy the JIRA list from Step 2 into it.
   
   
4. (https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/branches/2.2) Copy the trunk to branches using the following command:

   No Format
   svn copy SRC-URL DEST-URL -m "Reason for this commit"

   For example:

   No Format
   svn copy https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/trunk https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/branches/2.2 -m "Prepare for GEP 2.2 release"

5. Checkout or update this branches tree on your machine.
   
   
6. Scan With tool Apache RAT, scan all the source code to make sure Apache license headers have been added into neccessarily. The header is neccessary for .java, .xsd,.xml,.html and .properties, which contain functional code or configuration information.
7. Update the <scm> URLs in the pom.xml to point to the final URL in tags. For example:

   Code Block
   xml xml
   <scm> <connection>scm:svn:https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/tags/2.2/</connection> <developerConnection>scm:svn:https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/tags/2.2/</developerConnection> <url>https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/tags/2.2/</url> </scm>

8. Build the new branches tree that will soon be released
   
   
9. Build a publicly accessible staging site so that the reviewers can download the plugins from it. An example staging site is http://people.apache.org/~mcconne/releases/2.2/RC1/staging_site/
   • mirror the structure of the production site http://www.apache.org/dist/geronimo/eclipse/
   • the deployable and updatesite zip files go in http://www.apache.org/dist/geronimo/eclipse/2.2
   • the eclipse update site is http://www.apache.org/dist/geronimo/eclipse/updates
     
     
10. Copy the deployable and updatesite zip files to the staging site. For example http://people.apache.org/~mcconne/releases/2.2/RC1/staging_site/
11. Package the source code in the branch just created. For example package branches/2.2.0 into geronimo-eclipse-plugin-2.2.0-source.tar.gz and geronimo-eclipse-plugin-2.2.0-source.zip.
    
    
12. Create the update site by extracting the updatesite zip to the staging site, for example http://people.apache.org/~mcconne/releases/2.1.2/RC2/staging_site/updates. Also include:
    • Instructions for using the staging site
13. Put the staging site up for a vote. In the vote notice, please include:
    • The precise names and versions being voted on (e.g. geronimo-eclipse-plugin-2.2-deployable.zip and geronimo-eclipse-plugin-2.2-updatesite.zip)

      Tip
      title Tips
      1. Be certain to use the Release Candidate (RC) acronym in the name as it will not likely pass on the first vote 2. Be certain to use the same version numbers as the Geronimo Server (e.g., 2.2)

    • The svn urls to the current source and where the tag will be created
    • The svn revision levels being voted on along with pointers to the source and build output files
    • URL of the staging site (with instructions on how to use it)
    • Eclipse requirements if any (with instructions on how to download them and from where)
      
      
14. Test the staging site by downloading the adapter from it (using the same instructions in previous step) 
15. Create the How to install GEP v2.2 wiki page. Be sure this includes the pre-reqs. The idea is to have a single page with this release-specific information. In the vote note below, refer to this page, with overrides for the staging site URL. The idea here is to create the install page before hand, and use it for the voting, so that folks will review the doc we'll go live with when the vote passes. There is a How to install GEP page, with children of the various versions. These are for folks who may want to install old versions. When the vote passes, move all it's children to the v2.2 page, then rename the How to install GEP page to the v2.1.1 page. Make it a child of the v2.1.2 page. Then, rename the v2.1.2 page to the generic How to install GEP page.
    
    

16. Wiki Markup
    (/) Make sure to start both a *\[VOTE\]* and a *\[DISCUSS\]* thread on the Geronimo dev list

    Tip
    title Tip
    Be certain to get enough binding votes according to the Apache Foundation requirements, which in general stipulates 3 PMC +1 votes (see http://www.apache.org/foundation/voting.html#ReleaseVotes for more details)

17. After the vote has been approved:

    • Wiki Markup
      (/) Publish the results on a *\[RESULTS\]* reply to the original *\[VOTE\]* thread on the Geronimo dev list

    • Publish the staging site, including the deployable.zip and updatesite.zip files, and the release notes to the Geronimo Eclipse distribution location on people.apache.org here:

      No Format
      /www/www.apache.org/dist/geronimo/eclipse

    • Ensure that the version subdirectory is used (e.g., 2.1.2)
    • Ensure that the file(s) you copy to the distribution directory have 0775 dir permission and a 0644 file permission set on them
    • Ensure that the file(s) you copy to the distribution directory have the RCx acronym removed from the filename
    • Ensure that the file(s) you copy have the proper checksum files as well (i.e., .asc, .md5, .sha) using these gpg commands:

      No Format
      gpg --print-md MD5 [fileName] > [fileName].md5 gpg --print-md SHA1 [fileName] > [fileName].sha gpg --armor --output [fileName].asc --detach-sig [fileName]

    • Similarly, ensure that your GPG public key is in the /www/www.apache.org/dist/geronimo/KEYS file before publishing anything to the distribution location
      
      
18. Ensure that the corresponding Geronimo Eclipse distribution website is updated automatically and properly with the deployable.zip file and the updatesite.zip file
    
    
19. Update the Geronimo Eclipse Update Site with the contents of the updatesite.zip:

    No Format
    1. /www/www.apache.org/dist/geronimo/eclipse/updates/features 2. /www/www.apache.org/dist/geronimo/eclipse/updates/plugins 3. /www/www.apache.org/dist/geronimo/eclipse/updates/site.xml

    Warning
    title Warning
    Never delete old releases from the update site - always append to it !! Likewise, do not create a new update site as this will break everyone who has this current site configured, and WTP which uses the update site for the downloadable server adapter support.

    Warning
    title Warning
    If you use FTP to transfer the files to the Geronimo Eclipse Update Site make sure to transfer everything in binary mode. Otherwise, the checksum files may not transfer correctly (especially if they are transferred in text mode).

...