Once a release have been build for Ivy or IvyDE, they should be pushed to the Eclipse updatesite so that Eclipse users will be able to update automatically their installed version of Ivy or IvyDE. This doc is in two parts, the <a href="#setup">setup</a> of the updatesite which will be the candidate for the vote of the Ivy or IvyDE release, and the <a href="#deployment">final deployment</a> once the release is accepted. <u>Important note:</u> in this doc, the released version is denoted as $VERSION (and have to be replaced accordingly in every commands), but this is the OSGi one, not the usually shown one, in particular for release candidate versions. For instance an Ivy version can be <tt>2.0.0-RC1</tt> but the OSGi one, and the one to use here is <tt>2.0.0.cr1</tt>. <h1><a name="setup"></a>Build a p2 repository</h1> The svn location of the updatesite builder is there: https://svn.apache.org/repos/asf/ant/ivy/updatesite/trunk . We will build the p2 repository dedicated to the version to release. <ul><li>For an <u>Ivy</u> release: As you have a build jar for Ivy, just do: <code>ant build-ivy-p2-repo -Divy.jar=...../path/to/ivy.jar</code> </li><li> For an <u>IvyDE</u> release: The zip distribution needs to be unpacked into the updatesite directory: <code>ant build-ivyde-p2-repo -Divyde.zip=...../path/to/org.apache.ivyde.feature-${VERSION}.zip</code> </li> </ul> Now the binary files need to be signed. <ul><li>For an <u>Ivy</u> release:<li> <pre>./signArtifacts.sh ivy-${VERSION}</pre> </li><li> For an <u>IvyDE</u> release: <pre>./signArtifacts.sh ivyde-${VERSION}</pre> </li> </ul> And finally commit your changes in <tt>dist/dev</tt> (this will put the p2 repository in the dev space of the dist repository). <h2>Test the updatesite</h2> The updatesite is ready to be tested at: <tt>https://dist.apache.org/repos/dist/dev/ant/ivyde/updatesite/ivyde-${VERSION} </tt> <h2>In case of an unaccepted release</h2> In case the release has not been accepted by the PMC, don't forget to cleanup the svn repository. To do so, just run: <pre>svn rm https://dist.apache.org/repos/dist/dev/ant/eclipse-updatesite/ivyde-$VERSION -m 'Remove rejected release' </pre> <h1><a name="deployment"></a>Deployment of a release</h1> <h2>Clean up old releases</h2> First, you may want to remove from the main repository references to the older releases. Note also that the ASF policy regarding the space occupied by the main dist is about rectricting to only have the main stable released version available there; older are archived on archiche.apache.org. To remove a version from the main dist, you'll need to remove the data and remove its reference in the main updatesite. To remove the data: <pre>svn rm https://dist.apache.org/repos/dist/release/ant/ivyde/updatesite/ivyde-$OLD_VERSION -m 'Remove old version' </pre> Then the version listed in the updatesite are maintained in <tt>https://svn.apache.org/repos/asf/ant/ivy/updatesite/trunk/versions.xml</tt> Then you have to decide if the version you removed should be still listed in the Eclipse updatesite or not. <ul>To remove a version from the listed one, edit the file <tt>versions.xml</tt> <li>If the version should no appear anymore, just delete the line about the deleted version.</li> <li>If the version should still be listed, prepend the reference to the old version by <tt>http://archive.apache.org/dist/ant/ivy/updatesite/</tt></li> </ul> NB: adding or removing lines in <tt>versions.xml</tt> infer that you should edit the <tt>size</tt> attribute in the <tt>versions.xml</tt>, it should correspond to the number of "child". <h2>Publish the p2 repository data</h2> It is just about moving data (svn rm is not allowed, the two steps are required): <pre>svn mv https://dist.apache.org/repos/dist/dev/ant/ivyde/updatesite/ivyde-$VERSION https://dist.apache.org/repos/dist/release/ant/ivyde/updatesite/ -m 'publishing the p2 repo of the release of IvyDE $VERSION' </pre> <h2>Regenerate the main repo</h2> Last but not least, the p2 repository should now list the new release. Edit the file <tt>versions.xml</tt>, and add a line about the released version: <code><child location='ivyde-2.1.0'/> </code> NB: adding or removing lines in <tt>versions.xml</tt> infer that you should edit the <tt>size</tt> attribute in the <tt>versions.xml</tt>, it should correspond to the number of "child". And run: <pre>ant build-main-p2-repo </pre> And now commit every modification in <tt>dist/release</tt>.