Update/Install Test Scenarios for Eclipse 3.1

[ work in progress ]

Objectives:

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.

Part 1: Updating Eclipse

1. Install Eclipse

Download Eclipse SDK and install it to D:\eclipseTest.

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.

2.  Create a product extension

Unzip the file

http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/platform-update-home/3.0/org.eclipse.update.tests.jarred.site.ToLink.zip

into folder D:\eclipseTestSite2

(FYI: URL for installing the same set of features, but from http site:
http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/projects/org.eclipse.update.tests.jarred.site/)

Now, to register the extension with our eclipse install,  create the links subfolder in the eclipse installation directory: D:\eclipseTest\eclipse\links and a new file D:\eclipseTest\eclipse\links\site2.link with the following content:

path=D:\\eclipseTestSite2

3. Launch Eclipse

Launch the Eclipse workbench

3.1)  from the menu, select Help -> Software Updates -> Manage Configuration
Expand the configuration and verify that both the installation and the extension sites are listed:
- file:/d:/eclipseTest/eclipse/  with six eclipse features
- file:/d:/eclipseTestSite2/eclipse with org.eclipse.update.tests.jarred.feature 1.0.0

3.2) From the menu, select Help -> About -> Plugin Details
Verify that following plugins are present:
org.eclipse.update.tests.jarred.plugin 1.0.0
org.eclipse.update.tests.jarred.fragment 1.0.0
org.eclipse.update.tests.jarred.bundle 1.0.0
 

3.3) From either a toolbar or "Jarred Plugin Menu" lunch three actions:
Jarred Plug-in Action, Jarred Fragment Action, Jarred Bundle Action.
Verify that all are present and work.

4. Update Policy

An update policy file allows features to be updated from a different update site, particularly from a site hosted inside the local network.

Create directory outside of eclipse directory, say D:\eclipseTestPolicy
Download a policy file from
http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/3.0/zippedPatchesPolicy.xml
into this directory.
Download zipped updated site from
http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/3.0/org.eclipse.update.tests.patches.site.zip
into this directory. Do NOT unzip.
If you use a different directory name, edit policy file and fill in the correct path.
(FYI: URL for installing the same set of features, but from http site:
http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/projects/org.eclipse.update.tests.patches.site/)

Start Eclipse, if not already started.
From the menu, open Windows -> Preferences -> Install/Update, fill in Update Policy URL as:
file:///D:/eclipseTestPolicy/zippedPatchesPolicy.xml

From the menu, launch the install wizard:
Help -> Software Updates -> Find and Install.

-Click next, select SDK patch, accept license, click finish.
-Accept unsigned jar.
-After installation, confirm dialog to restart.
 

4.1)  Verify Eclipse restarted.
4.2)  In Help -> Software Updates -> Manage Configuration, verify SDK patch containing Platform and PDE patches are installed.
4.3)  In Help -> About -> Feature Details, verify both original features (SDK, Platform, PDE) and 3 patch features are listed.
4.4)  Select SDK patch, click Plugin Details, verify feature does not contain any plugins. Click OK
(Bug 97093 Update configuration does not show plug-ins for a feature.)
4.5)  Select Platform patch, click Plugin Details, verify feature contains osgi, help, update configurator plugins version 3.1.0.patch1. Click OK
4.6)  Select PDE patch, click Plugin Details, verify feature contains PDE UI plugin version 3.1.0.patch1. Click OK.
4.7) Click OK again to go back to About dialog, click Plugin Details.
       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.

Close all open dialogs. Exit eclipse.

Change policy in D:/eclipseTestPolicy/zippedPatchesPolicy.xml to use
http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/projects/org.eclipse.update.tests.patches.site/
for updates/install from http.

-Start eclipse and launch the install wizard again: Help -> Software Updates -> Find and Install.
-Click next, select PDE patch2, accept license, click finish, restart.

4.8)  Check if D:\eclipseTest\eclipse\plugins\org.eclipse.pde.ui_3.1.0.patch2 contains same number of files as
        D:\eclipseTest\eclipse\plugins\org.eclipse.pde.ui_3.1.0.patch2.
4.9) i n Help -> Software Updates -> Manage Configuration, verify PDE patch2 installed.
4.10)  in Help -> About -> Feature Details, verify both original PDE feature and org.eclipse.pde.patch2 is installed.
4.11)  Click OK to go back to About dialog, click Plugin Details. Verify eclipse runs version 3.1.0.patch2 of org.eclipse.pde.ui plug-in.

(PDE-UI plugin is installed, but does not work - Bug 97094 Partial patch for jarred bundles not working easily )

Close all open dialogs. Exit eclipse.


5. Update Eclipse

This should be done after test 4 above (Update Policy).

5.1 Search for updates to existing features. You should see SDK 3.1.1 update. Select it and install it. Restart when prompted

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

5.3 All the patches installed in test 4 should be disabled.

6. Revert configuration


6.1) In Help -> Software Updates -> Manage Configuration, right click Eclipse product, choose Revert... from the popup menu.
6.2) Pick original configuration (before starting update tests), click finish, confirm restart.
6.3) In Help -> About -> Feature Details, verify no patches are enabled.
6.4) Click OK to go back to About dialog, click Plugin Details.Verify eclipse runs original version of plugins (usually 3.1.0).