You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 126 Next »

Steps

  1. (error) 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: These notes are written for release 2.1.2. Change the version number accordingly for your release!

  2. (error) Update the release notes. They are the file PLUGIN_RELEASE-NOTES-2.1.2.txt in trunk.

  3. (error) Copy the trunk to branches using the following command: 
    svn copy SRC-URL DEST-URL -m "Reason for this commit"
    For example: 
    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.1.2 -m "Prepare for GEP 2.1.2 release"
  4. (error) Checkout or update this branches tree on your machine.

  5. (error) Update the <scm> URLs in the pom.xml to point to the final URL in tags. For example: 
    <scm>
     <connection>scm:svn:https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/tags/2.1.2/</connection>
     <developerConnection>scm:svn:https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/tags/2.1.2/</developerConnection>
     <url>https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/tags/2.1.2/</url>
</scm>
  6. (error) Build the new branches tree that will soon be released

  7. (error) 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.1.2/RC2/staging_site/
  8. (error) Copy the deployable and updatesite zip files to the staging site. For example http://people.apache.org/~mcconne/releases/2.1.2/RC2/staging_site/2.1.2

  9. (error) 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:
    • (error) Instructions for using the staging site
  10. (error) 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.1.2-deployable.zip and geronimo-eclipse-plugin-2.1.2-updatesite.zip)

      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.1.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)

  11. (error) Test the staging site by downloading the adapter from it (using the same instructions in previous step)

  12. Make sure to start both a [VOTE] and a [DISCUSS] thread on the Geronimo dev list

    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)

  13. (error) After the vote has been approved:

    • Publish the results on a [RESULTS] reply to the original [VOTE] thread on the Geronimo dev list

    • (error) Publish the staging site, including the deployable.zip and updatesite.zip files, and the release notes to the Geronimo Eclipse distribution location on apache.org here: 
      /www/www.apache.org/dist/geronimo/eclipse
    • (error) Ensure that the version subdirectory is used (e.g., 2.1.2)
    • (error) Ensure that the file(s) you copy to the distribution directory have 0775 dir permission and a 0644 file permission set on them
    • (error) Ensure that the file(s) you copy to the distribution directory have the RCx acronym removed from the filename
    • (error) Ensure that the file(s) you copy have the proper checksum files as well (i.e., .asc, .md5, .sha) using these gpg commands: 
      gpg --print-md MD5 [fileName] > [fileName].md5
gpg --print-md SHA1 [fileName] > [fileName].sha
gpg --armor --output [fileName].asc --detach-sig [fileName]
    • (error) 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

  14. (error) Ensure that the corresponding Geronimo Eclipse distribution website is updated automatically and properly with the deployable.zip file and the updatesite.zip file

  15. (error) Update the Geronimo Eclipse Update Site with the contents of the updatesite.zip: 
    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

    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.

    • (error) Ensure that the file(s) you copy to the update site directories have 0755 dir permission and a 0644 file permisison set on them
    • (error) Ensure that the file(s) you copy have the proper checksum files as well (i.e., .asc, .md5, .sha) using these gpg commands: 
      gpg --print-md MD5 [fileName] > [fileName].md5
gpg --print-md SHA1 [fileName] > [fileName].sha
gpg --armor --output [fileName].asc --detach-sig [fileName]
  16. (error) Ensure that corresponding Geronimo Eclipse Update Site website (http://apache.org/dist/geronimo/eclipse/updates/) (is updated automatically in the next 24 hours with the contents of the upatesite.zip file.

  17. (error) Copy (do not move as the branch needs to remain for future maintenance) the branches tree to tags using the following command: 
    svn copy SRC-URL DEST-URL -m "Reason for this commit".
    For example: 
    svn copy https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/branches/2.1.2
         https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/tags/2.1.2 -m "Tagging GEP 2.1.2"
  18. (error) Merge changes from tags into trunk to ensure they are in sync (except for the assembly pom.xml described above)

  19. (error) Update version number in trunk (e.g., 2.1.2 -> 2.1.3)

  20. (error) Update Geronimo version number in trunk (e.g., 2.1.2 -> 2.1.3-SNAPSHOT)

  21. (error) Update the Apache Geronimo Development Tools Subproject web site. Please include:
    • Updated Release Notes
    • All Eclipse and WTP prerequisites and download instructions
    • Links to recent, pertinent, and relevant presentations (e.g., Shiva's, EclipseWorld, look for others, etc)

  22. (error) Administer the GERONIMODEVTOOLS JIRA project to update the released and unreleased versions

  23. (error) Update the Geronimo Home Page with a News item that we have an updated Geronimo Eclipse Plugin available

  24. (error) Final step is to update the Geronimo Release Roadmaps with the release date.
  • No labels