<h2>Update/Install Test Scenarios for Eclipse 3.1</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.1 through simple end-to-end use cases. The 
scenarios are divided into two parts. </p>
<ul>
  <li>Part-1 exercises updating of Eclipse features, installing new features, 
  redirecting updates, etc.</li>
  <li>Part-2 exercises various aspects of update/install.</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; 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.3)
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>
</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>
-Make sure the top radio button is selected.  Click Finish.<br>
-drill down into patches and select only SDK patch1 version 1.0.0,<br>
-click next, accept license, click next, and 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.7)
In Help -&gt; About -&gt; dialog, click Plugin Details.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Verify eclipse runs version 3.1.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>
-Make sure the top radio button is selected.  Click Finish.<br>
-drill down into patches and select only PDE patch2 version 1.0.0,<br>
-click next, accept license, click next, and finish.<br>
-Accept unsigned jar.<br>
-After installation, confirm dialog to restart.<br>
<p>
4.8)&nbsp;
Check if D:\eclipseTest\eclipse\plugins\org.eclipse.pde.ui_3.1.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.1.0.<br>
4.9) in Help -&gt; Software Updates -&gt; Manage Configuration, verify PDE patch2 
installed.<br>
4.10)&nbsp; in Help -&gt; About -&gt; click Plugin Details.
Verify eclipse runs version 3.1.0.patch2 of org.eclipse.pde.ui plug-in.</p>
<p>(PDE-UI plugin is installed, but does not work - Bug 97094 Partial patch for jarred bundles not working easily )</p>
<p>
Close all open dialogs. Exit eclipse.</p>
<h4>
<br>
5. Update Eclipse</h4>
<p>
This should be done after test 4 above (Update Policy).</p>
<p>
5.1 Search for updates to existing features. You should see SDK 3.1.1 update. 
Select it and install it. Restart when prompted</p>
<p>
5.2 Eclipse should restart and you should see the new versions (3.1.1) for 
plugins org.eclipse.help, org.eclipse.osgi, org.eclipse.pde.ui, 
org.eclipse.update.configurator, and the updated features (SDK, Platform, and 
PDE).</p>
<p>
5.3 All the patches installed in test 4 should be disabled.</p>
<h4>
6. Revert configuration</h4>
<p>
<br>
6.1)
In Help -&gt; Software Updates -&gt; Manage Configuration, right click Eclipse 
product, choose Revert... from the popup menu.<br>
6.2)
Pick original configuration (before starting update tests), click finish, 
confirm restart.<br>
6.3)
In Help -&gt; About -&gt; Feature Details, verify no patches are enabled.<br>
6.4)
Click OK to go back to About dialog, click Plugin Details.Verify eclipse runs original version of plugins (usually 3.1.0).<br>
<br>
</p>