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.

-Make sure the top radio button is selected. Click Finish.
-drill down into patches and select only SDK patch1 version 1.0.0,
-click next, accept license, click next, and 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.7) In Help -> 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.
-Make sure the top radio button is selected. Click Finish.
-drill down into patches and select only PDE patch2 version 1.0.0,
-click next, accept license, click next, and finish.
-Accept unsigned jar.
-After installation, confirm dialog to 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.
4.9) in Help -> Software Updates -> Manage Configuration, verify PDE patch2 installed.
4.10)  in Help -> About -> 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 Open Help -> Software Updates -> Manage Configuration. Select Show Disabled Features toolbar button. 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).