platform-update-home/doc/Test Scenarios/eclipse update.html
Parent Directory
| 
Revision Log
Revision 1.8 - (view) (download) (as text)
| 1 : | vlad | 1.1 | <!doctype html public "-//w3c//dtd html 4.0 transitional//en"> |
| 2 : | <html> | ||
| 3 : | <head> | ||
| 4 : | <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> | ||
| 5 : | <meta name="GENERATOR" content="Mozilla/4.72 [en] (Windows NT 5.0; U) [Netscape]"> | ||
| 6 : | </head> | ||
| 7 : | <body> | ||
| 8 : | |||
| 9 : | vlad | 1.2 | <h1> |
| 10 : | Scenario: Updating Eclipse Install Using The Update Manager</h1> | ||
| 11 : | vlad | 1.8 | Last Updated: June 2, 2002 9:45PM |
| 12 : | vlad | 1.1 | <h3> |
| 13 : | Objectives:</h3> | ||
| 14 : | vlad | 1.3 | The objective of these scenarios is to illustrate the Eclipse update manager |
| 15 : | vlad | 1.4 | function through simple end-to-end use cases. The scenarios are divided |
| 16 : | vlad | 1.7 | into two parts. |
| 17 : | vlad | 1.2 | <ul> |
| 18 : | <li> | ||
| 19 : | Part-1 excercises updating of Eclipse itself from a test site containing | ||
| 20 : | Eclipse builds repackaged as downloadable features. The Eclipse feature | ||
| 21 : | structure is a reasonable representation of a non-trivial product. It contains | ||
| 22 : | a primary feature (the platform) and a number of other features ( jdt, | ||
| 23 : | vlad | 1.7 | pde, etc) and is nested.</li> |
| 24 : | vlad | 1.2 | |
| 25 : | <li> | ||
| 26 : | Part-2 uses an example "product" to go through the various steps of updating | ||
| 27 : | and extending it using both the update manager, as well as native installation | ||
| 28 : | (using .zip file containing features and plugins that can be extracted | ||
| 29 : | directly into the file system)</li> | ||
| 30 : | </ul> | ||
| 31 : | |||
| 32 : | <h2> | ||
| 33 : | vlad | 1.8 | Part 1: Updating Eclipse - "One Click" Update</h2> |
| 34 : | vlad | 1.2 | |
| 35 : | vlad | 1.1 | <h3> |
| 36 : | Setup:</h3> | ||
| 37 : | Available sites: | ||
| 38 : | <ul> | ||
| 39 : | <li> | ||
| 40 : | <a href="http://download.eclipse.org/updates/">http://download.eclipse.org/updates/</a></li> | ||
| 41 : | vlad | 1.2 | </ul> |
| 42 : | vlad | 1.1 | |
| 43 : | <table BORDER COLS=1 WIDTH="100%" > | ||
| 44 : | <tr> | ||
| 45 : | <td> | ||
| 46 : | <center><b><font color="#FF0000">*** PLEASE READ *** PLEASE READ *** PLEASE | ||
| 47 : | READ *** PLEASE READ ***</font></b></center> | ||
| 48 : | </td> | ||
| 49 : | </tr> | ||
| 50 : | |||
| 51 : | <tr> | ||
| 52 : | vlad | 1.3 | <td><font color="#000000">As part of this scenario you will be downloading |
| 53 : | vlad | 1.1 | and installing various versions of the Eclipse components into the running |
| 54 : | vlad | 1.3 | Eclipse. The update site is populated with features that have their version |
| 55 : | vlad | 1.1 | numbers modified as part of the build process. They are generally of the |
| 56 : | form 2.0.0.QUALIFIER, where the qualifier differs build to build. Note, | ||
| 57 : | vlad | 1.3 | however, that when you install base Eclipse (.zip downloaded from eclipse.org), |
| 58 : | all of its features and plugins only use 3 part version identifiers (generally | ||
| 59 : | 2.0.0). So all the 2.0.0.Q updates in fact appear more recent that the | ||
| 60 : | build you are running, even though they may in fact be an older build. | ||
| 61 : | Note, that when you update the Eclipse components from the update site | ||
| 62 : | and restart you may in fact now be running </font><font color="#FF0000">DIFFERENT | ||
| 63 : | CODE THAN WHAT YOU STARTED WITH</font><font color="#000000">. So it is | ||
| 64 : | really important that you save your starting configuration (scenario steps | ||
| 65 : | B) and restore it (scenario steps F) when told by the scenario, or any | ||
| 66 : | time you have in fact updated the Eclipse Paltform feature (includes the | ||
| 67 : | update manager support). </font><font color="#FF0000">It is suggested that | ||
| 68 : | you always use a second install of Eclipse running with a different workspace | ||
| 69 : | to actually run through these scenarios.</font> | ||
| 70 : | vlad | 1.1 | <p><font color="#000000">When openning Bugzilla defects, use the platform/update |
| 71 : | vlad | 1.2 | component. Please ALWAYS specify the failing scenario step, and include |
| 72 : | a .zip of the <workspace>/.metadata/ directory</font></td> | ||
| 73 : | vlad | 1.1 | </tr> |
| 74 : | </table> | ||
| 75 : | |||
| 76 : | <h3> | ||
| 77 : | Steps:</h3> | ||
| 78 : | |||
| 79 : | <ul> | ||
| 80 : | <li> | ||
| 81 : | Install second copy of Eclipse to run these scenarios ... do not use your | ||
| 82 : | development copy of Eclipse for this.</li> | ||
| 83 : | |||
| 84 : | <li> | ||
| 85 : | either use the default workspace created by the second Eclipse copy, or | ||
| 86 : | specify (-data) a new workspace for these scenarios</li> | ||
| 87 : | </ul> | ||
| 88 : | |||
| 89 : | <h4> | ||
| 90 : | A. Startup new Eclipse</h4> | ||
| 91 : | |||
| 92 : | <ul> | ||
| 93 : | <li> | ||
| 94 : | A.1. startup Eclipse. On the initial startup with new workspace you should | ||
| 95 : | see the splash come up, be taken down down, and come up again before it | ||
| 96 : | is finally taken down before the Workbench appears. This is due to Eclipse | ||
| 97 : | restart when new features are detected on startup.</li> | ||
| 98 : | |||
| 99 : | <li> | ||
| 100 : | vlad | 1.8 | A.2 go to Help> About and click [About Features] and [About Plugins] to |
| 101 : | see more details of what is actually running. Note the baseline version | ||
| 102 : | of the various items (most will be 2.0.0)</li> | ||
| 103 : | |||
| 104 : | <li> | ||
| 105 : | A.3. go to Help> Software Updates> Update Manager and verify that the features | ||
| 106 : | corresponding to the baseline install appear in the "Current Configuration"</li> | ||
| 107 : | vlad | 1.1 | </ul> |
| 108 : | |||
| 109 : | <h4> | ||
| 110 : | B. Save baseline configuration</h4> | ||
| 111 : | |||
| 112 : | <ul> | ||
| 113 : | <li> | ||
| 114 : | B.1. in "Configuration" view, expand "Configuration History"</li> | ||
| 115 : | |||
| 116 : | <li> | ||
| 117 : | B.2. select the current configuration (at this point it should be the only | ||
| 118 : | one)</li> | ||
| 119 : | |||
| 120 : | <li> | ||
| 121 : | B.3. popup menu, Save</li> | ||
| 122 : | |||
| 123 : | <li> | ||
| 124 : | B.4. expand "Saved Configurations"</li> | ||
| 125 : | |||
| 126 : | <li> | ||
| 127 : | B.5. select the configuration you have just saved</li> | ||
| 128 : | |||
| 129 : | <li> | ||
| 130 : | B.6. popup, Properties, change name to "Baseline"</li> | ||
| 131 : | |||
| 132 : | <li> | ||
| 133 : | vlad | 1.8 | B.7 close update manager</li> |
| 134 : | vlad | 1.1 | </ul> |
| 135 : | |||
| 136 : | vlad | 1.8 | <h4> |
| 137 : | C. "One Click" update</h4> | ||
| 138 : | vlad | 1.1 | |
| 139 : | <ul> | ||
| 140 : | <li> | ||
| 141 : | vlad | 1.8 | C.0. NOTE: you must be connected to the network with access to www.eclipse.org |
| 142 : | to perform this step. You will be downloading a full eclipse sdk drop as | ||
| 143 : | part of this step. So you should have a reasonably fast network connection | ||
| 144 : | for this step.</li> | ||
| 145 : | vlad | 1.1 | |
| 146 : | <li> | ||
| 147 : | vlad | 1.8 | C.1. select Help> Software Updates> New Updates</li> |
| 148 : | vlad | 1.1 | |
| 149 : | <li> | ||
| 150 : | vlad | 1.8 | C.2. wait while eclipse is searching for new updates</li> |
| 151 : | vlad | 1.1 | |
| 152 : | <li> | ||
| 153 : | vlad | 1.8 | C.3. the search results page should display a new version of eclipse SDK |
| 154 : | preselected</li> | ||
| 155 : | vlad | 1.1 | |
| 156 : | <li> | ||
| 157 : | vlad | 1.8 | C.4. click [Finish] and proceed to install the update. When you see feature |
| 158 : | verification dialog, click [Install Feature].</li> | ||
| 159 : | vlad | 1.1 | |
| 160 : | <li> | ||
| 161 : | vlad | 1.8 | C.5. when you complete the installation, you'll be prompter to restart. |
| 162 : | Select [OK] to restart the platform</li> | ||
| 163 : | vlad | 1.1 | |
| 164 : | <li> | ||
| 165 : | vlad | 1.8 | C.6. workbench should restart automatically</li> |
| 166 : | vlad | 1.1 | |
| 167 : | <ul> | ||
| 168 : | <li> | ||
| 169 : | vlad | 1.8 | <b>PLEASE NOTE</b>: at this point you are no longer executing the update |
| 170 : | manager code you started with, but rather are running a version of the | ||
| 171 : | update manager that was contained in the update (along with the rest of | ||
| 172 : | the platform plugins). Depending on what the update site contained at that | ||
| 173 : | point (changes build to build) the platform may not even restart, and you | ||
| 174 : | may need to reinstall eclipse to continue. Report defects for this (to | ||
| 175 : | make sure there is not actually a legitimate problem) but please be clear | ||
| 176 : | that you failed in step C.6.</li> | ||
| 177 : | vlad | 1.1 | </ul> |
| 178 : | |||
| 179 : | <li> | ||
| 180 : | vlad | 1.8 | C.7. go to Help> About> [About Plug-Ins] and [About Features] to verify |
| 181 : | you are running new version of the platform (the versions for the items | ||
| 182 : | will be 2.0.0.<qualifier>)</li> | ||
| 183 : | vlad | 1.1 | |
| 184 : | <li> | ||
| 185 : | vlad | 1.8 | C.8. Go to Help> Software Updates> Update Manager and expand "Current Configuration" |
| 186 : | and verify you now recognize the new version of the platform that was updated</li> | ||
| 187 : | vlad | 1.1 | </ul> |
| 188 : | |||
| 189 : | <h4> | ||
| 190 : | vlad | 1.8 | D. Restoring Original Configuration</h4> |
| 191 : | vlad | 1.1 | |
| 192 : | <ul> | ||
| 193 : | <li> | ||
| 194 : | vlad | 1.8 | D.1. in Update Manager, expand "Saved Configurations"</li> |
| 195 : | vlad | 1.1 | |
| 196 : | <li> | ||
| 197 : | vlad | 1.8 | D.2. select "Baseline" created in step B</li> |
| 198 : | vlad | 1.1 | |
| 199 : | <li> | ||
| 200 : | vlad | 1.8 | D.3. press restore</li> |
| 201 : | vlad | 1.1 | |
| 202 : | <li> | ||
| 203 : | vlad | 1.8 | D.4. Restart the workbench when prompted</li> |
| 204 : | vlad | 1.1 | |
| 205 : | <li> | ||
| 206 : | vlad | 1.8 | D.5. workbench should restart automatically, and open into Update manager</li> |
| 207 : | vlad | 1.1 | |
| 208 : | <li> | ||
| 209 : | vlad | 1.8 | D.6. expand "Current Configuration" and verify all configured features |
| 210 : | vlad | 1.1 | are the baseline feature versions (generally 2.0.0)</li> |
| 211 : | |||
| 212 : | <li> | ||
| 213 : | vlad | 1.8 | D.7. click the "Show disabled features" button in the Configuration view |
| 214 : | vlad | 1.1 | tool bar</li> |
| 215 : | |||
| 216 : | <li> | ||
| 217 : | vlad | 1.8 | D.8. verify "Current Configuration" shows the features updated in steps |
| 218 : | vlad | 1.1 | D and E as disabled (different icon)</li> |
| 219 : | vlad | 1.3 | |
| 220 : | <li> | ||
| 221 : | vlad | 1.8 | D.9. go to Help> About dialog, [About Plug-Ins] and verify you are in fact |
| 222 : | vlad | 1.3 | running the baseline plugins (all 2.0.0, except for the "special cases" |
| 223 : | like xerces, ant, luce, tomcat, etc)</li> | ||
| 224 : | vlad | 1.1 | |
| 225 : | <li> | ||
| 226 : | vlad | 1.8 | D.10. shut down the workbench</li> |
| 227 : | vlad | 1.1 | </ul> |
| 228 : | |||
| 229 : | vlad | 1.2 | <h2> |
| 230 : | Part 2: Alphabet Soup</h2> | ||
| 231 : | |||
| 232 : | <h3> | ||
| 233 : | Setup:</h3> | ||
| 234 : | Available sites: | ||
| 235 : | <ul> | ||
| 236 : | <li> | ||
| 237 : | vlad | 1.5 | <a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/site/index.html">http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/site/</a></li> |
| 238 : | vlad | 1.2 | </ul> |
| 239 : | The above site contains prebuilt features used as part of the following | ||
| 240 : | scenario steps. It also includes several .zip files (containing features | ||
| 241 : | and plugins) that are used to simulate native installer steps. | ||
| 242 : | <br> | ||
| 243 : | <table BORDER COLS=1 WIDTH="100%" > | ||
| 244 : | <tr> | ||
| 245 : | <td> | ||
| 246 : | <center><b><font color="#FF0000">*** PLEASE READ *** PLEASE READ *** PLEASE | ||
| 247 : | READ *** PLEASE READ ***</font></b></center> | ||
| 248 : | </td> | ||
| 249 : | </tr> | ||
| 250 : | |||
| 251 : | <tr> | ||
| 252 : | <td><font color="#000000">When openning Bugzilla defects, use the platform/update | ||
| 253 : | component. Please ALWAYS specify the failing scenario step, and include | ||
| 254 : | a .zip of the <workspace>/.metadata/ directory</font></td> | ||
| 255 : | </tr> | ||
| 256 : | </table> | ||
| 257 : | |||
| 258 : | <h3> | ||
| 259 : | Description:</h3> | ||
| 260 : | The Alphabet Soup is a simple application packaged as an Eclipse product, | ||
| 261 : | plus several extensions. The application installs a tool button, and a | ||
| 262 : | menu ("Alphabet Soup") that can be used to query the content of the "soup | ||
| 263 : | bowl" and interact with the individual installed "letters" (each letter | ||
| 264 : | in the bowl corresponds to a separate plugin) | ||
| 265 : | <ul> | ||
| 266 : | <li> | ||
| 267 : | base product is a nested feature, my.alphabet, containing two sub-features | ||
| 268 : | with base sets of "letters"</li> | ||
| 269 : | |||
| 270 : | <li> | ||
| 271 : | 3 extension features containing additional "letters" (plugins). The features | ||
| 272 : | have a dependency relationship as follows:</li> | ||
| 273 : | |||
| 274 : | <ul> | ||
| 275 : | <li> | ||
| 276 : | "round letters" extension pack requires the base to be installed</li> | ||
| 277 : | |||
| 278 : | <li> | ||
| 279 : | "straight letters" extension pack requires "round letters" extension pack | ||
| 280 : | to be installed</li> | ||
| 281 : | |||
| 282 : | <li> | ||
| 283 : | "numbers" extension pack requires both "round letters" extension pack and | ||
| 284 : | "straight letters" extension pack to be installed</li> | ||
| 285 : | </ul> | ||
| 286 : | </ul> | ||
| 287 : | Just follow the steps and you'll get the idea. | ||
| 288 : | <h3> | ||
| 289 : | Steps:</h3> | ||
| 290 : | |||
| 291 : | <ul> | ||
| 292 : | <li> | ||
| 293 : | Install second copy of Eclipse to run these scenarios ... do not use your | ||
| 294 : | development copy of Eclipse for this.</li> | ||
| 295 : | |||
| 296 : | <li> | ||
| 297 : | either use the default workspace created by the second Eclipse copy, or | ||
| 298 : | specify (-data) a new workspace for these scenarios</li> | ||
| 299 : | </ul> | ||
| 300 : | |||
| 301 : | <h4> | ||
| 302 : | O. Completing the install</h4> | ||
| 303 : | |||
| 304 : | <ul> | ||
| 305 : | <li> | ||
| 306 : | O.1. after you have installed baseline eclipse, unzip the Aplhabet Soup | ||
| 307 : | product features from <a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/site/native/my.alphabet_1.0.0.zip">my.alphabet_1.0.0.zip</a> | ||
| 308 : | into the eclipse/ installation directory. The unzip should overwrite the | ||
| 309 : | install.ini file that is packaged with Eclipse (sets the Alphabet Soup | ||
| 310 : | feature as the primary feature). The product feature .zips can be found | ||
| 311 : | in <a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/site/native/">http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/site/native/</a></li> | ||
| 312 : | |||
| 313 : | <li> | ||
| 314 : | O.2. start eclipse .... after "Completing the install ..." the platform | ||
| 315 : | restarts as "Alphabet Soup" application (own Welcome, About)</li> | ||
| 316 : | |||
| 317 : | <li> | ||
| 318 : | O.3. Click on the "Alphabet Soup" button in the tool bar ... you should | ||
| 319 : | have letters A, B, C and E (all 1.0.0) in your bowl.</li> | ||
| 320 : | |||
| 321 : | <li> | ||
| 322 : | O.4. Go to the "Alphabet Soup" menu and verify you can interact with each | ||
| 323 : | letter (one action per letter on the menu)</li> | ||
| 324 : | |||
| 325 : | <li> | ||
| 326 : | O.5. Open Help> Software Updates> Update Manager</li> | ||
| 327 : | |||
| 328 : | <li> | ||
| 329 : | O.6. Expand "Current Configuration". Verify "Alphabet Soup 1.0.0" is configured, | ||
| 330 : | and it contains 2 subfeatures (Round and Straight letters)</li> | ||
| 331 : | |||
| 332 : | <li> | ||
| 333 : | O.7. click on each of the features and view more details about each freature</li> | ||
| 334 : | |||
| 335 : | <li> | ||
| 336 : | O.8. select "Alphabet Soup 1.0.0" and press [Disable]. You should be notified | ||
| 337 : | that you cannot disable the primary feature (if this is not the case, [Cancel] | ||
| 338 : | the disable action and report a defect).</li> | ||
| 339 : | </ul> | ||
| 340 : | |||
| 341 : | <h4> | ||
| 342 : | P. Updating the primary feature using update manager</h4> | ||
| 343 : | |||
| 344 : | <ul> | ||
| 345 : | <li> | ||
| 346 : | P.1. expand "Sites to Visit", and "Alphabet Soup Update Site" and "Alphabet | ||
| 347 : | Soup Category"</li> | ||
| 348 : | |||
| 349 : | <li> | ||
| 350 : | P.2. Select "Alphabet Soup 1.0.0" ... preview should not show [Update] | ||
| 351 : | button</li> | ||
| 352 : | |||
| 353 : | <li> | ||
| 354 : | P.3. Select "Alphabet Soup 1.0.1" and select [Update]. Go through the install | ||
| 355 : | wizard accepting defaults.</li> | ||
| 356 : | |||
| 357 : | <li> | ||
| 358 : | P.4. Restart the workbench when prompted. Will restart with update manager | ||
| 359 : | open.</li> | ||
| 360 : | |||
| 361 : | <li> | ||
| 362 : | P.5. Expand "Current Configuration" .... verify you now have Alphabet Soup | ||
| 363 : | 1.0.1 installed and configured.</li> | ||
| 364 : | |||
| 365 : | <li> | ||
| 366 : | P.6. Click the "Show disabled features" filter button .... should see both | ||
| 367 : | versions (one configured, the other unconfugured (icon with grey "stop" | ||
| 368 : | overlay))</li> | ||
| 369 : | |||
| 370 : | <li> | ||
| 371 : | P.7. click the "Alphabet Soup" tool button ... should show new versions | ||
| 372 : | of the base letters (1.0.1). The actions on "Alphabet Soup" menu should | ||
| 373 : | also indicate we are running the new version.</li> | ||
| 374 : | |||
| 375 : | <li> | ||
| 376 : | P.8. close update manager</li> | ||
| 377 : | |||
| 378 : | <li> | ||
| 379 : | P.9. shut down the workbench</li> | ||
| 380 : | </ul> | ||
| 381 : | |||
| 382 : | <h4> | ||
| 383 : | Q. Updating the primary feature using "native" install (.zip)</h4> | ||
| 384 : | |||
| 385 : | <ul> | ||
| 386 : | <li> | ||
| 387 : | Q.1. unzip the Aplhabet Soup product features from <a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/site/native/my.alphabet_1.1.0.zip">my.alphabet_1.1.0.zip</a> | ||
| 388 : | into the eclipse/ installation directory (look into the features/ or plugins/ | ||
| 389 : | subdirectory to veify you see new 1.1.0 versions)</li> | ||
| 390 : | |||
| 391 : | <li> | ||
| 392 : | Q.2. start Eclipse (a.k.a. Alphabet Soup). You'll see the splash comming | ||
| 393 : | up twice as the platfrom is updating the configuration. Workbench will | ||
| 394 : | come up, with a dialog informing you have changes. Click [OK] to open the | ||
| 395 : | update manager change dialog.</li> | ||
| 396 : | |||
| 397 : | <li> | ||
| 398 : | Q.3. check the change (so it is applied) and press [Finish]</li> | ||
| 399 : | |||
| 400 : | <li> | ||
| 401 : | Q.4. restart the workbench when prompted</li> | ||
| 402 : | |||
| 403 : | <li> | ||
| 404 : | Q.5. click the "Alphabet Soup" tool button and trigger "Alphabet Soup" | ||
| 405 : | menu action to see you have the new version (1.1.0) of the "soup bowl and | ||
| 406 : | letters"</li> | ||
| 407 : | |||
| 408 : | <li> | ||
| 409 : | Q.6. Open update manager and expand "Current Configuration". Should see | ||
| 410 : | Alphabet Soup 1.1.0 configured, and the other 2 unconfigured (click the | ||
| 411 : | "Show disabled features").</li> | ||
| 412 : | </ul> | ||
| 413 : | |||
| 414 : | <h4> | ||
| 415 : | <font color="#000000">R. Adding an extension using the update manager</font></h4> | ||
| 416 : | |||
| 417 : | <ul> | ||
| 418 : | <li> | ||
| 419 : | <font color="#000000">R.1. expand "Sites to Visit", "Alphabet Soup Update | ||
| 420 : | Site", "Alphabet Soup Fun Pack - Round Letters"</font></li> | ||
| 421 : | |||
| 422 : | <li> | ||
| 423 : | <font color="#000000">R.2. select "Alphabet Soup Round Letters Extension | ||
| 424 : | Pack 1.0.0" and click [Install]. Accept defaults in wizard and [Finish]. | ||
| 425 : | Restart workbench when prompted.</font></li> | ||
| 426 : | |||
| 427 : | <li> | ||
| 428 : | <font color="#000000">R.3. click of the "Alphaber Soup" tool button and | ||
| 429 : | interact with "Alphabet Soup" menu to see new round letters (D and G). | ||
| 430 : | vlad | 1.3 | <b>Note:</b> |
| 431 : | may need to go to Window> Costomize Perspective...> Other and select the | ||
| 432 : | action sets for the new letters</font></li> | ||
| 433 : | vlad | 1.2 | |
| 434 : | <li> | ||
| 435 : | <font color="#000000">R.4. expand Current Configuration ans verify the | ||
| 436 : | new feature is showing as configured.</font></li> | ||
| 437 : | |||
| 438 : | <li> | ||
| 439 : | <font color="#000000">R.4. close the update manager and shut down the workbench</font></li> | ||
| 440 : | </ul> | ||
| 441 : | |||
| 442 : | <h4> | ||
| 443 : | <font color="#000000">S. Adding an extension using "native" install (.zip) | ||
| 444 : | and link file</font></h4> | ||
| 445 : | |||
| 446 : | <ul> | ||
| 447 : | <li> | ||
| 448 : | <font color="#000000">S.0. <b>Note</b>: the first 3 steps will typically | ||
| 449 : | be performed by a native installer. Since you are simulating these steps | ||
| 450 : | you need to do this manually.</font></li> | ||
| 451 : | |||
| 452 : | <li> | ||
| 453 : | <font color="#000000">S.1. Set up a new install directory somewhere in | ||
| 454 : | your file system. Create eclipse/ subdirectory under it. U</font>nzip the | ||
| 455 : | Aplhabet Soup Straight Letters extension from <a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/site/native/my.alphabet.more.straight.letters_1.0.0.zip">my.alphabet.more.straight.letters_1.0.0.zip</a> | ||
| 456 : | into the eclipse/ subdirectory. You should end up with</li> | ||
| 457 : | |||
| 458 : | <ul> | ||
| 459 : | <li> | ||
| 460 : | vlad | 1.3 | <some new install directory>/</li> |
| 461 : | |||
| 462 : | <br> eclipse/ | ||
| 463 : | <br> | ||
| 464 : | features/ | ||
| 465 : | <br> | ||
| 466 : | plugins/</ul> | ||
| 467 : | vlad | 1.2 | |
| 468 : | <li> | ||
| 469 : | S.2. In the original eclipse install (the one that contains the platform | ||
| 470 : | and Alphabet Soup), create a new directory called "links" as a peer to | ||
| 471 : | features/ and plugins/. You should end up with</li> | ||
| 472 : | |||
| 473 : | <ul> | ||
| 474 : | <li> | ||
| 475 : | vlad | 1.3 | <eclipse platform install directory>/</li> |
| 476 : | |||
| 477 : | <br> eclipse/ | ||
| 478 : | <br> | ||
| 479 : | links/ | ||
| 480 : | <br> features/ | ||
| 481 : | <br> | ||
| 482 : | plugins/</ul> | ||
| 483 : | vlad | 1.2 | |
| 484 : | <li> | ||
| 485 : | S.3. within the links/ subdirectory, create a file called my.alphabet.link | ||
| 486 : | vlad | 1.3 | and add a single line into it</li> |
| 487 : | |||
| 488 : | vlad | 1.8 | <p><br>path=<some new install directory> |
| 489 : | vlad | 1.3 | <p><b>Note</b>: the path should be an absolute path using local file system |
| 490 : | vlad | 1.2 | syntax. The .link file is loaded as a Java properties file, so on Windows |
| 491 : | vlad | 1.3 | you need to double up the back-slashes (eg. path=c:\\temp\\install) |
| 492 : | vlad | 1.2 | <li> |
| 493 : | S.4. start eclipse (Alphabet Soup). You'll see the splash comming up twice | ||
| 494 : | as the platfrom is updating the configuration. Workbench will come up, | ||
| 495 : | with a dialog informing you have changes. Click [OK] to open the update | ||
| 496 : | manager change dialog.</li> | ||
| 497 : | |||
| 498 : | <li> | ||
| 499 : | S.5. check the change (so it is applied) and press [Finish]</li> | ||
| 500 : | |||
| 501 : | <li> | ||
| 502 : | S.6. restart the workbench when prompted</li> | ||
| 503 : | |||
| 504 : | <li> | ||
| 505 : | S.7. click the "Alphabet Soup" tool button and trigger "Alphabet Soup" | ||
| 506 : | vlad | 1.3 | menu action to see you have the new letters.</li> |
| 507 : | vlad | 1.2 | |
| 508 : | vlad | 1.3 | <br><b>Note</b>: may need to go to Window> Customize Perspective...> Other |
| 509 : | and select the new letters to get the menu actions to become visible | ||
| 510 : | <br><b>Note</b>: if you are following all the steps in the scenario, the | ||
| 511 : | base letters (A, B, C, E) should be at 1.1.0, and the extensions (D, G) | ||
| 512 : | (F, H) at 1.0.0 | ||
| 513 : | vlad | 1.2 | <li> |
| 514 : | S.8. Open update manager and expand "Current Configuration". Should see | ||
| 515 : | a new site representing the extension install, and it should contain the | ||
| 516 : | extension feature you've installed.</li> | ||
| 517 : | </ul> | ||
| 518 : | |||
| 519 : | <h4> | ||
| 520 : | T. Installing another extension using the update manager (with environment | ||
| 521 : | filtering)</h4> | ||
| 522 : | |||
| 523 : | <ul> | ||
| 524 : | <li> | ||
| 525 : | <font color="#000000">T.1. expand "Sites to Visit", "Alphabet Soup Update | ||
| 526 : | Site", "Alphabet Soup Fun Pack - Numbers"</font></li> | ||
| 527 : | |||
| 528 : | <li> | ||
| 529 : | <font color="#000000">T.2. The Numbers extension specifies an OS in its | ||
| 530 : | feature definition. The update site contains features for Win and Linux. | ||
| 531 : | On those two platforms you should see a list of features designated for | ||
| 532 : | than platform. On other platforms you are out of luck ... you don't get | ||
| 533 : | to play with numbers (skip the rest of this step)</font></li> | ||
| 534 : | |||
| 535 : | <li> | ||
| 536 : | <font color="#000000">T.3. uncheck the "Show matching features only" filter | ||
| 537 : | vlad | 1.6 | .... should now see all the features for both platforms. Check the filter |
| 538 : | vlad | 1.2 | back again.</font></li> |
| 539 : | |||
| 540 : | <li> | ||
| 541 : | <font color="#000000">T.4. select "Alphabet Soup Numbers Extension Pack | ||
| 542 : | for <OS>1.0.1" and click [Install]. Accept defaults in wizard. In the | ||
| 543 : | location selection page ensure the extension location created in steps | ||
| 544 : | S is not offered as a choice. Press [Finish]. Restart workbench when prompted.</font></li> | ||
| 545 : | |||
| 546 : | <li> | ||
| 547 : | <font color="#000000">T.5. click of the "Alphabet Soup" tool button and | ||
| 548 : | interact with "Alphabet Soup" menu to see new numbers (3 and 5). <b>Note:</b> | ||
| 549 : | may need to go to Window> Costomize Perspective...> Other and select the | ||
| 550 : | action sets for the new numbers</font></li> | ||
| 551 : | |||
| 552 : | <li> | ||
| 553 : | vlad | 1.6 | <font color="#000000">T.6. expand Current Configuration ans verify the |
| 554 : | vlad | 1.2 | new feature is showing as configured in the original install site</font></li> |
| 555 : | |||
| 556 : | <li> | ||
| 557 : | vlad | 1.6 | <font color="#000000">T.7. close the update manager and shut down the workbench</font></li> |
| 558 : | vlad | 1.2 | </ul> |
| 559 : | |||
| 560 : | vlad | 1.1 | <h4> |
| 561 : | vlad | 1.2 | <font color="#000000">"Free-form" testing</font></h4> |
| 562 : | |||
| 563 : | <ul> | ||
| 564 : | <li> | ||
| 565 : | <font color="#000000">the above scenarios describe a path through the update | ||
| 566 : | support. Run through it once as described. There is lot's of opportunity | ||
| 567 : | to do thing in different order, click on ither buttons, try other features | ||
| 568 : | in the UI. Go ahead an explore. Remember, is you see something that does | ||
| 569 : | not work, is not correct, or is not what you'd expected, open Bugzilla | ||
| 570 : | defects in the platform/update component. Please ALWAYS specify the steps | ||
| 571 : | leading up to the failure, and include a .zip of the <workspace>/.metadata/ | ||
| 572 : | directory</font></li> | ||
| 573 : | vlad | 1.4 | </ul> |
| 574 : | vlad | 1.2 | |
| 575 : | vlad | 1.1 | </body> |
| 576 : | </html> |
| help@eclipse.org | ViewVC Help |
| Powered by ViewVC 1.0.3 |