Release Eclipse Plugin Process

Steps

Wait one to two weeks after the release of the corresponding Geronimo server
Make sure that the ant script that is used to download the Eclipse artifacts (i.e., build.xml) only contains released versions – not maintenace versions of Eclipse, DTP, EMF, GEF, WTP, etc.

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.0.0 -m "Prepare for release"

Checkout or update this branches tree on your machine.

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.0.0/</connection>
     <developerConnection>scm:svn:https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/tags/2.0.0/</developerConnection>
     <url>https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/tags/2.0.0/</url>
</scm>

Update the /assembly/pom.xml to replace the maven-buildnumber-plugin with the geronimodevtools-plugin. It should look something like:

<build>
    <plugins>
        <plugin>
            <artifactId>maven-assembly-plugin</artifactId>
            <configuration>
                <finalName>g-eclipse-plugin-${version}</finalName>
                <descriptors>
                    <descriptor>src/main/assembly/deployable.xml</descriptor>
                    <descriptor>src/main/assembly/updatesite.xml</descriptor>
                </descriptors>
            </configuration>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>attached</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

Build the new branches tree that will soon be released
Build a publicly accessible staging site so that the reviewers can download the plugins and the Geronimo server from it
Copy the deployable zip file, and the updatesite zip file to a publicly accessible location. Put them up for a vote. In the vote notice, please include:
- The precise names and versions being voted on (e.g. geronimo-eclipse-plugin-2.0.0-deployable-RCx.zip and geronimo-eclipse-plugin-2.0.0-updatesite-RCx.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.0.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)
- WTP requirements if any (with instructions on how to download them and from where)
Make sure to start both a VOTE and a DISCUSS thread on the Geronimo dev list

Create the staging site from the updatesite zip. The only change necessary is to ensure that the org.apache.geronimo.st.v20.core_2.0.0 plugin points back to the staging site as below:

<extension point="org.eclipse.wst.server.core.installableRuntimes">
    <installableRuntime id="org.apache.geronimo.runtime.tomcat.20"
        featureVersion="2.0.1"
        featureId="org.apache.geronimo.installableruntime.tomcat.feature"
        featureSite="http://people.apache.org/~mcconne/releases/staging_site/"      <!-- This line was altered -->
        path="geronimo-tomcat6-jee5-2.0.1.zip">
    </installableRuntime>
    <installableRuntime id="org.apache.geronimo.runtime.jetty.20"
        featureVersion="2.0.1"
        featureId="org.apache.geronimo.installableruntime.jetty.feature"
        featureSite="http://people.apache.org/~mcconne/releases/staging_site/"      <!-- This line was altered -->
        path="geronimo-jetty6-jee5-2.0.1.zip">
    </installableRuntime>
</extension>

After it has been approved:
- Publist the results on a RESULTS thread on the Geronimo dev list
- Publish the deployable zip file to the distribution location on people.apache.org here:
```
/www/www.apache.org/dist/geronimo/eclipse
```
- Ensure that the version subdirectory is used (e.g., 2.0.0)
- Ensure that the file(s) you copy to the distribution directory have 0755 dir permission and a 0644 file permisison 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 release notes are included in the same directory
- 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]
```
- Similiarly, ensure that your GPG public key is in the /www/www.apache.org/dist/geronimo/KEYS file before publishing anything to the distribution location
Ensure that the production distrubution site is updated automatically in the next 24 hours with the deployable zip file
Update the distribution Update Site with the contents of the updatesite.zip:
```
/www/www.apache.org/dist/geronimo/eclipse/updates
```
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.
- Ensure that the file(s) you copy to the update site directories have 0755 dir permission and a 0644 file permisison set on them
- 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]
```
- Augment the existing site.xml file from the update site to include all the new features, plugins, and references to the corresponding Geronimo server
  
  Why is the site.xml from the updatesite.zip file not used instead ?? Process improvement possible here (see GERONIOMODEVTOOLS-227).
Ensure that production Update Site is updated automatically in the next 24 hours with the contents of the upatesite.zip file

Move the branches tree to tags using the following command:

svn mv SRC-URL DEST-URL -m "Reason for this commit".

For example:

 
svn move https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/branches/2.0.0
         https://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/tags/2.0.0 -m "Released"

Merge changes from tags into trunk to ensure they are in sync (except for the assembly pom.xml described above)
Update the Apache Geronimo Development Tools Subproject web site. Please include:
- Updated Release Notes
- All WTP prerequisites and download instructions
- Links to recent, pertinent, and relevant presentations (e.g., Shiva's, EclipseWorld, look for others, etc)
Cleanup the unstable repo
Administer the GERONIMODEVTOOLS JIRA project to update the released and unreleased versions
Update appropriate remote Eclipse download site(s) so users can download the Geronimo server and the Geronimo Eclipse plugin from within Eclipse (without having to add a new "Remote Site" from the Eclipse Help panels)
Final step is to update the Geronimo Home Page with a News item that we have an updated Geronimo Eclipse Plugin available
TBD
TBD

Child pages

Release Eclipse Plugin Process

Steps