<h2>Update/Install Test Scenarios for Eclipse 3.0</h2>
<p>[ work in progress ]</p>
<h3>Objectives:</h3>
<p>The objective of these scenarios is to cover the main functionality of the 
Update/Install component in Eclipse 3.0 through simple end-to-end use cases. The 
scenarios are divided into two parts. </p>
<ul>
  <li>Part-1 exercises updating of Eclipse itself from a test site containing 
  Eclipse builds repackaged as downloadable features. The Eclipse feature 
  structure is a reasonable representation of a non-trivial product. It contains 
  a primary feature (the platform) and a number of other features ( jdt, pde, 
  etc) and is nested. </li>
  <li>Part-2 uses an example &quot;product&quot; to go through the various steps of 
  updating and extending it using both the Eclipse Update, as well as native 
  installation (using .zip file containing features and plug-ins that can be 
  extracted directly into the file system) </li>
  <li>Part-3 uses an even simpler feature hierarchy to go through more advanced 
  capabilities that include optional features and emergency fixes. </li>
</ul>
<h2>Part 1: Updating Eclipse</h2>
<h4>1. Install Eclipse</h4>

<p>Download Eclipse SDK and install it to 
<i>D:\eclipseTest</i>. </p>

<h4><font color="#FF0000"><b>Note: If you install it to another directory 
(including an OS other than Windows), please make sure that the path names that 
appear in the text below are properly renamed, to reflect your particular setup.</b></font><br>
<br>
2.&nbsp; Create a product extension</h4>

<p>Unzip the file </p>

<p><i>
<a href="http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/platform-update-home/3.0/org.eclipse.update.tests.jarred.site.ToLink.zip">http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/platform-update-home/3.0/org.eclipse.update.tests.jarred.site.ToLink.zip</a></i></p>

<p>into folder <i> D:\eclipseTestSite2</i></p>

<p>(FYI: URL for installing the same set of features, but from http site:<br>
<i>
<a href="http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/platform-update-home/projects/org.eclipse.update.tests.jarred.site/">http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/projects/org.eclipse.update.tests.jarred.site/</a></i>)<br>
<br>
Now, to register the extension with our eclipse install,&nbsp; create the links 
subfolder in the eclipse installation directory: <i>
D:\eclipseTest\eclipse\links</i> and a new file 
<i>D:\eclipseTest\eclipse\links\site2.link</i> with the following content:</p>


<p>path=D:\\eclipseTestSite2<br>
</p>


<h4>3. Launch Eclipse</h4>
Launch the Eclipse workbench<p>3.1)&nbsp; from the menu, select Help -&gt; Software Updates -&gt; Manage Configuration<br>
Expand the configuration and verify that both the installation and the extension 
sites are listed:<br>
<i>-
file:/d:/eclipseTest/eclipse/</i>&nbsp;
with six eclipse features<br>
<i>-
file:/d:/eclipseTestSite2/eclipse</i>
with org.eclipse.update.tests.jarred.feature 1.0.0<br>
<br>
3.2) From the menu, select Help -&gt; About -&gt; Feature Details<br>
Verify the following feature is present: org.eclipse.update.tests.jarred.feature 
1.0.0 <br>
&nbsp;</p>
<p>3.3) From the menu, select Help -&gt; About -&gt; Plugin Details<br>
Verify that following plugins are present:<br>
org.eclipse.update.tests.jarred.plugin 1.0.0<br>
org.eclipse.update.tests.jarred.fragment 1.0.0<br>
org.eclipse.update.tests.jarred.bundle 1.0.0<br>
&nbsp;</p>
<p>3.4)
From either a toolbar or &quot;Jarred Plugin Menu&quot; lunch three actions:<br>
Jarred Plug-in Action, Jarred Fragment Action, Jarred Bundle Action.<br>
Verify that all are present and work.<br>
<br>
// Help -&gt; About -&gt; Software Update -&gt; Find and Install...<br>
// Features form org.eclipse.update.tests.nested.site have nl attributed on 
netsted features and do not work.<br>
// Skipping this.<br>
<br>
</p>
<h4>4. Update Policy</h4>
<p>An update policy file allows features to be updated from a different update 
site, particularly from a site hosted inside the local network.</p>
<p>
Create directory outside of eclipse directory, say D:\eclipseTestPolicy<br>
Download a policy file from <br>
<a href="http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/platform-update-home/3.0/zippedPatchesPolicy.xml">http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/3.0/zippedPatchesPolicy.xml</a><br>
into this directory.<br>
Download  zipped updated site from<br>
<a href="http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/platform-update-home/3.0/org.eclipse.update.tests.patches.site.zip">http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/3.0/org.eclipse.update.tests.patches.site.zip</a><br>
into this directory. Do NOT unzip.<br>
If you use a different directory name, edit policy file and fill in the correct 
path.<br>
(FYI: URL for installing the same set of features, but from http site:<br>
<a href="http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/platform-update-home/projects/org.eclipse.update.tests.patches.site/">http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/projects/org.eclipse.update.tests.patches.site/</a>)<br>
<br>
Start Eclipse, if not already started.<br>
From the menu, open Windows -&gt; Preferences -&gt; Install/Update, fill in Update Policy URL as:<br>
<a href="file:///D:/eclipseTestPolicy/zippedPatchesPolicy.xml">file:///D:/eclipseTestPolicy/zippedPatchesPolicy.xml</a></p>
<p>
From the menu, launch the install wizard:<br>
Help -&gt; Software Updates -&gt; Find and Install.</p>
<p>
-Click next, select SDK patch, accept license, click finish.<br>
-Accept unsigned jar.<br>
-After installation, confirm dialog to restart.<br>
&nbsp;</p>
<p>
4.1)&nbsp;
Verify Eclipse restarted.<br>
4.2)&nbsp;
In Help -&gt; Software Updates -&gt; Manage Configuration, verify SDK patch containing 
Platform and PDE patches are installed.<br>
4.3)&nbsp;
In Help -&gt; About -&gt; Feature Details, verify both original features (SDK, 
Platform, PDE) and 3 patch features are listed.<br>
4.4)&nbsp;
Select SDK patch, click Plugin Details, verify feature does not contain any 
plugins. Click OK<br>
4.5)&nbsp;
Select Platform patch, click Plugin Details, verify feature contains osgi, help, 
update configurator plugins version 3.0.0.patch1. Click OK<br>
4.6)&nbsp;
Select PDE patch, click Plugin Details, verify feature contains PDE UI plugin 
version 3.0.0.patch1. Click OK.<br>
4.7)
Click OK again to go back to About dialog, click Plugin Details.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Verify eclipse runs version 3.0.0.patch1 of org.eclipse.help, org.eclipse.osgi, 
org.eclipse.pde.ui, and org.eclipse.update.configurator plug-in.</p>
<p>
Close all open dialogs. Exit eclipse.<br>
<br>
Change policy in D:/eclipseTestPolicy/zippedPatchesPolicy.xml to use<br>
<a href="http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/platform-update-home/projects/org.eclipse.update.tests.patches.site/">http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/projects/org.eclipse.update.tests.patches.site/</a><br>
for updates/install from http.</p>
<p>
-Start eclipse and launch the install wizard again:
Help -&gt; Software Updates -&gt; Find and Install.<br>
-Click next, select PDE patch2, accept license, click finish, restart.</p>
<p>
4.8)&nbsp;
Check if D:\eclipseTest\eclipse\plugins\org.eclipse.pde.ui_3.0.0.patch2 contains 
same number of files as<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
D:\eclipseTest\eclipse\plugins\org.eclipse.pde.ui_3.0.0.patch2.<br>
4.9) i n Help -&gt; Software Updates -&gt; Manage Configuration, verify PDE patch2 
installed.<br>
4.10)&nbsp; in Help -&gt; About -&gt; Feature Details, verify both original PDE feature and 
org.eclipse.pde.patch2 is installed.<br>
4.11)&nbsp;
Click OK to go back to About dialog, click Plugin Details.
Verify eclipse runs version 3.0.0.patch2 of org.eclipse.pde.ui plug-in.</p>
<p>
Close all open dialogs. Exit eclipse.<br>
&nbsp;</p>
<h4>
5. Revert configuration</h4>
<p>
<br>
5.1)
In Help -&gt; Software Updates -&gt; Manage Configuration, right click Eclipse 
product, choose Revert... from the popup menu.<br>
5.2)
Pick original configuration (before starting update tests), click finish, 
confirm restart.<br>
5.3)
In Help -&gt; About -&gt; Feature Details, verify no patches are enabled.<br>
5.4)
Click OK to go back to About dialog, click Plugin Details.Verify eclipse runs original version of plugins (usually 3.0.0).<br>
<br>
<br>
Do &quot;One click&quot; Update suite.<br>
<br>
Do &quot;Alphabet Soup&quot; suite.<br>
<br>
Don't do &quot;Optional features and e-fixes&quot; suite.</p>