platform-update-home/3.0/test_scenarios.html
Parent Directory
| 
Revision Log
Revision 1.1 - (view) (download) (as text)
| 1 : | dbirsan | 1.1 | <h2>Update/Install Test Scenarios for Eclipse 3.0</h2> |
| 2 : | <p>[ work in progress ]</p> | ||
| 3 : | <h3>Objectives:</h3> | ||
| 4 : | <p>The objective of these scenarios is to cover the main functionality of the | ||
| 5 : | Update/Install component in Eclipse 3.0 through simple end-to-end use cases. The | ||
| 6 : | scenarios are divided into two parts. </p> | ||
| 7 : | <ul> | ||
| 8 : | <li>Part-1 exercises updating of Eclipse itself from a test site containing | ||
| 9 : | Eclipse builds repackaged as downloadable features. The Eclipse feature | ||
| 10 : | structure is a reasonable representation of a non-trivial product. It contains | ||
| 11 : | a primary feature (the platform) and a number of other features ( jdt, pde, | ||
| 12 : | etc) and is nested. </li> | ||
| 13 : | <li>Part-2 uses an example "product" to go through the various steps of | ||
| 14 : | updating and extending it using both the Eclipse Update, as well as native | ||
| 15 : | installation (using .zip file containing features and plug-ins that can be | ||
| 16 : | extracted directly into the file system) </li> | ||
| 17 : | <li>Part-3 uses an even simpler feature hierarchy to go through more advanced | ||
| 18 : | capabilities that include optional features and emergency fixes. </li> | ||
| 19 : | </ul> | ||
| 20 : | <h2>Part 1: Updating Eclipse</h2> | ||
| 21 : | <h4>1. Install Eclipse</h4> | ||
| 22 : | |||
| 23 : | <p>Download Eclipse SDK and install it to | ||
| 24 : | <i>D:\eclipseTest</i>. </p> | ||
| 25 : | |||
| 26 : | <h4><font color="#FF0000"><b>Note: If you install it to another directory | ||
| 27 : | (including an OS other than Windows), please make sure that the path names that | ||
| 28 : | appear in the text below are properly renamed, to reflect your particular setup.</b></font><br> | ||
| 29 : | <br> | ||
| 30 : | 2. Create a product extension</h4> | ||
| 31 : | |||
| 32 : | <p>Unzip the file </p> | ||
| 33 : | |||
| 34 : | <p><i> | ||
| 35 : | <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> | ||
| 36 : | |||
| 37 : | <p>into folder <i> D:\eclipseTestSite2</i></p> | ||
| 38 : | |||
| 39 : | <p>(URL for installing the same set of features, but from http site:<br> | ||
| 40 : | <i>http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/projects/org.eclipse.update.tests.jarred.site/</i>)<br> | ||
| 41 : | <br> | ||
| 42 : | Now, to register the extension with our eclipse install, create the links | ||
| 43 : | subfolder in the eclipse installation directory: <i> | ||
| 44 : | D:\eclipseTest\eclipse\links</i> and a new file | ||
| 45 : | <i>D:\eclipseTest\eclipse\links\site2.link</i> with the following content:</p> | ||
| 46 : | |||
| 47 : | |||
| 48 : | <p>path=D:\\eclipseTestSite2<br> | ||
| 49 : | </p> | ||
| 50 : | |||
| 51 : | |||
| 52 : | <h4>3. Launch Eclipse</h4> | ||
| 53 : | Launch the Eclipse workbench<p>3.1) from the menu, select Help -> Software Updates -> Manage Configuration<br> | ||
| 54 : | Expand the configuration and verify that both the installation and the extension | ||
| 55 : | sites are listed:<br> | ||
| 56 : | <i>- | ||
| 57 : | file:/d:/eclipseTest/eclipse/</i> | ||
| 58 : | with six eclipse features<br> | ||
| 59 : | <i>- | ||
| 60 : | file:/d:/eclipseTestSite2/eclipse</i> | ||
| 61 : | with org.eclipse.update.tests.jarred.feature 1.0.0<br> | ||
| 62 : | <br> | ||
| 63 : | 3.2) From the menu, select Help -> About -> Feature Details<br> | ||
| 64 : | Verify the following feature is present: org.eclipse.update.tests.jarred.feature | ||
| 65 : | 1.0.0 <br> | ||
| 66 : | </p> | ||
| 67 : | <p>3.3) From the menu, select Help -> About -> Plugin Details<br> | ||
| 68 : | Verify that following plugins are present:<br> | ||
| 69 : | org.eclipse.update.tests.jarred.plugin 1.0.0<br> | ||
| 70 : | org.eclipse.update.tests.jarred.fragment 1.0.0<br> | ||
| 71 : | org.eclipse.update.tests.jarred.bundle 1.0.0<br> | ||
| 72 : | </p> | ||
| 73 : | <p>3.4) | ||
| 74 : | From either a toolbar or "Jarred Plugin Menu" lunch three actions:<br> | ||
| 75 : | Jarred Plug-in Action, Jarred Fragment Action, Jarred Bundle Action.<br> | ||
| 76 : | Verify that all are present and work.<br> | ||
| 77 : | <br> | ||
| 78 : | // Help -> About -> Software Update -> Find and Install...<br> | ||
| 79 : | // Features form org.eclipse.update.tests.nested.site have nl attributed on | ||
| 80 : | netsted features and do not work.<br> | ||
| 81 : | // Skipping this.<br> | ||
| 82 : | <br> | ||
| 83 : | </p> | ||
| 84 : | <h4>Update Policy</h4> | ||
| 85 : | <p>An update policy file allows features to be updated from a different update | ||
| 86 : | site, particularly from a site hosted inside the local network.</p> | ||
| 87 : | <p> | ||
| 88 : | Create directory outside of eclipse directory, say D:\eclipseTestPolicy<br> | ||
| 89 : | Download a policy file from <br> | ||
| 90 : | <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> | ||
| 91 : | into this directory.<br> | ||
| 92 : | Download zipped updated site from<br> | ||
| 93 : | <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> | ||
| 94 : | into this directory.<br> | ||
| 95 : | If you use a different directory name, edit policy file and fill in the correct | ||
| 96 : | path.<br> | ||
| 97 : | (URL for installing the same set of features, but from http site:<br> | ||
| 98 : | http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/projects/org.eclipse.update.tests.patches.site/)<br> | ||
| 99 : | <br> | ||
| 100 : | Start Eclipse<br> | ||
| 101 : | Open Windows -> Preferences -> Install/Update, fill in Update Policy URL as:<br> | ||
| 102 : | file:///D:/eclipseTestPolicy/zippedPatchesPolicy.xml<br> | ||
| 103 : | Help -> Software Updates -> Find and Install.<br> | ||
| 104 : | Click next, select SDK patch, accept license, click finish.<br> | ||
| 105 : | Accept unsigned jar.<br> | ||
| 106 : | After installation, confirm dialog to restart.<br> | ||
| 107 : | Verify Eclipse restarted.<br> | ||
| 108 : | In Help -> Software Updates -> Manage Configuration, verify SDK patch containing | ||
| 109 : | Platform and PDE patches are installed.<br> | ||
| 110 : | In Help -> About -> Feature Details, verify both original features (SDK, | ||
| 111 : | Platform, PDE) and 3 patch features are listed.<br> | ||
| 112 : | Select SDK patch, click Plugin Details, verify feature does not contain any | ||
| 113 : | plugins. Click OK<br> | ||
| 114 : | Select Platform patch, click Plugin Details, verify feature contains osgi, help, | ||
| 115 : | update configurator plugins version 3.0.0.patch1. Click OK<br> | ||
| 116 : | Select PDE patch, click Plugin Details, verify feature contains PDE UI plugin | ||
| 117 : | version 3.0.0.patch1. Click OK.<br> | ||
| 118 : | Click OK again to go back to About dialog, click Plugin Details.<br> | ||
| 119 : | Verify eclipse runs version 3.0.0.patch1 of org.eclipse.help, org.eclipse.osgi, | ||
| 120 : | org.eclipse.pde.ui, and org.eclipse.update.configurator plug-in.<br> | ||
| 121 : | Close all open dialogs. Exit eclipse.<br> | ||
| 122 : | <br> | ||
| 123 : | Change policy in D:/eclipseTestPolicy/zippedPatchesPolicy.xml to use<br> | ||
| 124 : | http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/projects/org.eclipse.update.tests.patches.site/<br> | ||
| 125 : | for updates - install from http.<br> | ||
| 126 : | Help -> Software Updates -> Find and Install.<br> | ||
| 127 : | Click next, select PDE patch2, accept license, click finish, restart.<br> | ||
| 128 : | Check if D:\eclipseTest\eclipse\plugins\org.eclipse.pde.ui_3.0.0.patch2 contains | ||
| 129 : | same number of files as<br> | ||
| 130 : | D:\eclipseTest\eclipse\plugins\org.eclipse.pde.ui_3.0.0.patch2.<br> | ||
| 131 : | In Help -> Software Updates -> Manage Configuration, verify PDE patch2 | ||
| 132 : | installed.<br> | ||
| 133 : | In Help -> About -> Feature Details, verify both original PDE feature and | ||
| 134 : | org.eclipse.pde.patch2 is installed.<br> | ||
| 135 : | Click OK to go back to About dialog, click Plugin Details.<br> | ||
| 136 : | Verify eclipse runs version 3.0.0.patch2 of org.eclipse.pde.ui plug-in.<br> | ||
| 137 : | Close all open dialogs. Exit eclipse.<br> | ||
| 138 : | <br> | ||
| 139 : | In Help -> Software Updates -> Manage Configuration, right click Eclipse | ||
| 140 : | product, choose Revert... from the popup menu.<br> | ||
| 141 : | Pick original configuration (before starting update tests), click finish, | ||
| 142 : | confirm restart.<br> | ||
| 143 : | In Help -> About -> Feature Details, verify no patches are enabled.<br> | ||
| 144 : | Click OK to go back to About dialog, click Plugin Details.<br> | ||
| 145 : | Verify eclipse runs original version of plugins (usually 3.0.0).<br> | ||
| 146 : | <br> | ||
| 147 : | <br> | ||
| 148 : | Do "One click" Update suite.<br> | ||
| 149 : | <br> | ||
| 150 : | Do "Alphabet Soup" suite.<br> | ||
| 151 : | <br> | ||
| 152 : | Don't do "Optional features and e-fixes" suite.</p> |
| help@eclipse.org | ViewVC Help |
| Powered by ViewVC 1.0.3 |