platform-update-home/doc/Test Scenarios/eclipse update.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.7 - (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.7 &nbsp;
12 :     <table BORDER COLS=1 WIDTH="100%" >
13 :     <tr>
14 :     <td><font color="#FF0000">NOTE: The test scenarios are being updated to
15 :     match the F2 build structure. At present, only scenario Part 2 (Alphabet
16 :     Soup) can be tried</font></td>
17 :     </tr>
18 :     </table>
19 : vlad 1.1
20 : vlad 1.7 <p>Last Updated: June 1, 2002 2:45PM&nbsp; .... being updated
21 : vlad 1.1 <h3>
22 :     Objectives:</h3>
23 : vlad 1.3 The objective of these scenarios is to illustrate the Eclipse update manager
24 : vlad 1.4 function through simple end-to-end use cases. The scenarios are divided
25 : vlad 1.7 into two parts.
26 : vlad 1.2 <ul>
27 :     <li>
28 :     Part-1 excercises updating of Eclipse itself from a test site containing
29 :     Eclipse builds repackaged as downloadable features. The Eclipse feature
30 :     structure is a reasonable representation of a non-trivial product. It contains
31 :     a primary feature (the platform) and a number of other features ( jdt,
32 : vlad 1.7 pde, etc) and is nested.</li>
33 : vlad 1.2
34 :     <li>
35 :     Part-2 uses an example "product" to go through the various steps of updating
36 :     and extending it using both the update manager, as well as native installation
37 :     (using .zip file containing features and plugins that can be extracted
38 :     directly into the file system)</li>
39 :     </ul>
40 :    
41 :     <h2>
42 :     Part 1: Updating Eclipse</h2>
43 :    
44 : vlad 1.1 <h3>
45 :     Setup:</h3>
46 :     Available sites:
47 :     <ul>
48 :     <li>
49 :     <a href="http://download.eclipse.org/updates/">http://download.eclipse.org/updates/</a></li>
50 : vlad 1.2 </ul>
51 : vlad 1.1
52 :     <table BORDER COLS=1 WIDTH="100%" >
53 :     <tr>
54 :     <td>
55 :     <center><b><font color="#FF0000">*** PLEASE READ *** PLEASE READ *** PLEASE
56 :     READ *** PLEASE READ ***</font></b></center>
57 :     </td>
58 :     </tr>
59 :    
60 :     <tr>
61 : vlad 1.3 <td><font color="#000000">As part of this scenario you will be downloading
62 : vlad 1.1 and installing various versions of the Eclipse components into the running
63 : vlad 1.3 Eclipse. The update site is populated with features that have their version
64 : vlad 1.1 numbers modified as part of the build process. They are generally of the
65 :     form 2.0.0.QUALIFIER, where the qualifier differs build to build. Note,
66 : vlad 1.3 however, that when you install base Eclipse (.zip downloaded from eclipse.org),
67 :     all of its features and plugins only use 3 part version identifiers (generally
68 :     2.0.0). So all the 2.0.0.Q updates in fact appear more recent that the
69 :     build you are running, even though they may in fact be an older build.
70 :     Note, that when you update the Eclipse components from the update site
71 :     and restart you may in fact now be running </font><font color="#FF0000">DIFFERENT
72 :     CODE THAN WHAT YOU STARTED WITH</font><font color="#000000">. So it is
73 :     really important that you save your starting configuration (scenario steps
74 :     B) and restore it (scenario steps F) when told by the scenario, or any
75 :     time you have in fact updated the Eclipse Paltform feature (includes the
76 :     update manager support). </font><font color="#FF0000">It is suggested that
77 :     you always use a second install of Eclipse running with a different workspace
78 :     to actually run through these scenarios.</font>
79 : vlad 1.1 <p><font color="#000000">When openning Bugzilla defects, use the platform/update
80 : vlad 1.2 component. Please ALWAYS specify the failing scenario step, and include
81 :     a .zip of the &lt;workspace>/.metadata/ directory</font></td>
82 : vlad 1.1 </tr>
83 :     </table>
84 :    
85 :     <h3>
86 :     Steps:</h3>
87 :    
88 :     <ul>
89 :     <li>
90 :     Install second copy of Eclipse to run these scenarios ... do not use your
91 :     development copy of Eclipse for this.</li>
92 :    
93 :     <li>
94 :     either use the default workspace created by the second Eclipse copy, or
95 :     specify (-data) a new workspace for these scenarios</li>
96 :     </ul>
97 :    
98 :     <h4>
99 :     A. Startup new Eclipse</h4>
100 :    
101 :     <ul>
102 :     <li>
103 :     A.1. startup Eclipse. On the initial startup with new workspace you should
104 :     see the splash come up, be taken down down, and come up again before it
105 :     is finally taken down before the Workbench appears. This is due to Eclipse
106 :     restart when new features are detected on startup.</li>
107 :    
108 :     <li>
109 :     A.2. go to update manager and verify that the features corresponding to
110 :     the baseline install appear in the "Current Configuration"</li>
111 :     </ul>
112 :    
113 :     <h4>
114 :     B. Save baseline configuration</h4>
115 :    
116 :     <ul>
117 :     <li>
118 :     B.1. in "Configuration" view, expand "Configuration History"</li>
119 :    
120 :     <li>
121 :     B.2. select the current configuration (at this point it should be the only
122 :     one)</li>
123 :    
124 :     <li>
125 :     B.3. popup menu, Save</li>
126 :    
127 :     <li>
128 :     B.4. expand "Saved Configurations"</li>
129 :    
130 :     <li>
131 :     B.5. select the configuration you have just saved</li>
132 :    
133 :     <li>
134 :     B.6. popup, Properties, change name to "Baseline"</li>
135 :     </ul>
136 :    
137 :     <h4>
138 :     C. View the test site</h4>
139 :    
140 :     <ul>
141 :     <li>
142 :     C.1. create new site bookmark (popup in Updates view, New> Site Bookmark...)</li>
143 :    
144 :     <li>
145 :     C.2. type in a name (eg. Eclipse Updates) and copy the test site URL as
146 :     specified in the scenario "Setup"</li>
147 :    
148 :     <li>
149 :     C.3. New site bookmark appears ... expand it. You should see categories
150 :     representing various available updates.</li>
151 :    
152 :     <ul>
153 :     <li>
154 :     Note: the content of the site will be changing (ie. will be growing) as
155 :     new builds become available</li>
156 :     </ul>
157 :    
158 :     <li>
159 : vlad 1.3 C.4. select the category representing the latest build and expand the list
160 :     of individual features</li>
161 : vlad 1.1
162 :     <li>
163 :     C.5. you should see features corresponding to the updates</li>
164 : vlad 1.3
165 :     <li>
166 :     C.6. uncheck the "Show matching features only" .... you should not see
167 :     other platform-specific features that do not match you environment</li>
168 :    
169 :     <li>
170 :     C.7. check the "Show matching features only" again (to reduce the clutter)</li>
171 : vlad 1.1 </ul>
172 :    
173 :     <table BORDER COLS=1 WIDTH="100%" >
174 :     <tr>
175 :     <td>Note: at various points in the scenarios you are asked to verify the
176 :     configuration state of features. To see disabled (unconfigured) features
177 :     you need to press the "Show disabled features" button in the Configuration
178 :     view tool bar</td>
179 :     </tr>
180 :     </table>
181 :    
182 :     <h4>
183 : vlad 1.3 D. Update&nbsp; JDT and its source</h4>
184 : vlad 1.1 Note: JDT is "middle of the stack" feature
185 :     <ul>
186 :     <li>
187 : vlad 1.3 D.1. select "Eclipse Java Development Tools"</li>
188 : vlad 1.1
189 :     <li>
190 :     D.2. Click [Update] in the Preview and follow the Install Wizard (taking
191 :     defaults) to install the feature.</li>
192 :    
193 :     <li>
194 : vlad 1.3 D.3. <font color="#000000"><b>DO NOT</b> restart </font>the workbench when
195 :     prompted (on completion of the installation)</li>
196 : vlad 1.1
197 :     <li>
198 : vlad 1.3 D.4. select "Eclipse Java Development Tools SDK"</li>
199 : vlad 1.1
200 :     <li>
201 :     D.5. Click [Update] in the Preview and follow the Install Wizard (taking
202 :     defaults) to install the feature.</li>
203 :    
204 :     <li>
205 : vlad 1.3 D.6. <b>Restart</b> the workbench when prompted (on completion of the installation)</li>
206 : vlad 1.1
207 :     <li>
208 :     D.7. workbench should restart automatically, and open into Update manager</li>
209 :    
210 :     <li>
211 :     D.8. expand "Current Configuration" and verify you now recognize the new
212 : vlad 1.3 versions of the 2 features that were updated. Click on the "Show Disabled
213 :     Features" button to see the prior versions of the features (different icon).
214 :     The unconfigured feature should show a warning overlay (but may not, depending
215 :     on the combination of the base build and the update). If they do, select
216 :     the feature, right click, Show Status ... The error dialog shows details
217 :     (in this case reporting the fact that if this feature were to be configured
218 :     it would result in multiple versions of the same plugin being configured)</li>
219 : vlad 1.1
220 :     <ul>
221 :     <li>
222 : vlad 1.3 confusing message text, <font color="#FF0000">defect 16712</font></li>
223 : vlad 1.1 </ul>
224 : vlad 1.3
225 :     <li>
226 :     D.9. go to Help> About dialog, [About Plug-Ins] and verify you are in fact
227 :     running updated versions of the JDT plugins.</li>
228 : vlad 1.1 </ul>
229 :    
230 :     <h4>
231 :     E. Update PDE</h4>
232 :     Note: PDE is a "top of the stack" feature
233 :     <ul>
234 :     <li>
235 :     E.0. expand the update site bookmark (in Updates view) to show the available
236 : vlad 1.3 individual features for the latest build</li>
237 : vlad 1.1
238 :     <li>
239 : vlad 1.3 E.1. select "Eclipse Plug-In Development Environment"</li>
240 : vlad 1.1
241 :     <li>
242 :     E.2. Click [Update] in the Preview and follow the Install Wizard (taking
243 :     defaults) to install the feature.</li>
244 :    
245 :     <li>
246 :     E.3. Restart the workbench when prompted (on completion of the installation)</li>
247 :    
248 :     <li>
249 :     E.4. workbench should restart automatically, and open into Update manager</li>
250 :    
251 :     <li>
252 :     E.5. expand "Current Configuration" and verify you now recognize the new
253 :     version of the feature that was updated</li>
254 : vlad 1.3
255 :     <li>
256 :     E.6. go to Help> About dialog, [About Plug-Ins] and verify you are in fact
257 :     running updated versions of the PDE plugins.</li>
258 : vlad 1.1 </ul>
259 :    
260 :     <h4>
261 :     F. Restoring Original Configuration</h4>
262 :    
263 :     <ul>
264 :     <li>
265 :     F.1. expand "Saved Configurations"</li>
266 :    
267 :     <li>
268 :     F.2. select "Baseline" created in step B</li>
269 :    
270 :     <li>
271 :     F.3. press restore</li>
272 :    
273 :     <li>
274 :     F.4. Restart the workbench when prompted</li>
275 :    
276 :     <li>
277 :     F.5. workbench should restart automatically, and open into Update manager</li>
278 :    
279 :     <li>
280 :     F.6. expand "Current Configuration" and verify all configured features
281 :     are the baseline feature versions (generally 2.0.0)</li>
282 :    
283 :     <li>
284 :     F.7. click the "Show disabled features" button in the Configuration view
285 :     tool bar</li>
286 :    
287 :     <li>
288 :     F.8. verify "Current Configuration" shows the features updated in steps
289 :     D and E as disabled (different icon)</li>
290 : vlad 1.3
291 :     <li>
292 :     F.9. go to Help> About dialog, [About Plug-Ins] and verify you are in fact
293 :     running the baseline plugins (all 2.0.0, except for the "special cases"
294 :     like xerces, ant, luce, tomcat, etc)</li>
295 : vlad 1.1 </ul>
296 :    
297 :     <h4>
298 :     <b>G. [removed]</b></h4>
299 :    
300 :     <h4>
301 : vlad 1.3 H. [removed]</h4>
302 : vlad 1.1
303 : vlad 1.3 <h4>
304 :     I. Update the platform</h4>
305 :     Note: platform is a "bottom of the stack" feature, and is the primary feature
306 : vlad 1.1 <ul>
307 :     <li>
308 : vlad 1.3 I.0. expand the configuration view. Select the "Eclipse Platform" feature.
309 :     In preview, click [Disable] ... should be notified you cannot disable the
310 :     platform or a primary feature (our selection is both)</li>
311 : vlad 1.1
312 :     <li>
313 :     I.1. expand the update site bookmark (in Updates view) to show the available
314 : vlad 1.3 individual features for the latest build</li>
315 : vlad 1.1
316 :     <li>
317 :     I.1. select "Eclipse Platform"</li>
318 :    
319 :     <li>
320 :     I.2. Click [Update] in the Preview and follow the Install Wizard (taking
321 :     defaults) to install the feature.</li>
322 :    
323 :     <li>
324 :     I.3. Restart the workbench when prompted (on completion of the installation)</li>
325 :    
326 :     <li>
327 :     I.4. workbench should restart automatically, and open into Update manager</li>
328 :    
329 :     <ul>
330 :     <li>
331 : vlad 1.3 <b>PLEASE NOTE</b>: at this point you are no longer executing the update
332 :     manager code you started with, but rather are running a version of the
333 :     update manager that was contained in the update (along with the rest of
334 :     the platform plugins). If you did not select the latest build from the
335 :     update site (and instead selected some old build) the platform may not
336 :     even restart, and you may need to reinstall eclipse to continue. Do not
337 :     report defects in this step unless you did get the latest available update.</li>
338 : vlad 1.1 </ul>
339 :    
340 :     <li>
341 : vlad 1.3 I.5. expand "Current Configuration" and verify you now recognize the new
342 :     version of the platform that was updated</li>
343 : vlad 1.1
344 :     <li>
345 : vlad 1.3 I.5.1. go to Help> About> [About Plug-Ins] to verify you are running new
346 :     version of the platform.</li>
347 : vlad 1.1
348 :     <li>
349 : vlad 1.3 I.6. repeat step F to <b><font color="#FF0000">restore the original configuration</font></b>
350 :     (ie. the code you are testing)</li>
351 : vlad 1.1 </ul>
352 :    
353 : vlad 1.3 <h4>
354 :     J. [removed]</h4>
355 : vlad 1.1
356 :     <h4>
357 :     K. "Natively" installed extension</h4>
358 :    
359 :     <li>
360 :     Note: if you performed Step I, make sure you repeat step F (revert to original
361 : vlad 1.3 configuration) and then shot down.</li>
362 : vlad 1.1
363 :     <ul>
364 :     <li>
365 : vlad 1.3 K.0. in the first 2 steps you will be performing manually a linking task
366 :     typically done by the extension native installer (end users will never
367 :     need to do this)</li>
368 :    
369 :     <li>
370 : vlad 1.1 K.1. unzip the <a href="reddot_extension.zip">"RedDot" extension</a> somewhere
371 :     into the file system (the .zip contains a root directory RedDotInstall)</li>
372 :    
373 :     <li>
374 :     K.2. manually create a link file in the Eclipse install you are using</li>
375 :    
376 :     <ul>
377 :     <li>
378 :     in the eclipse/ directory, create links/ subdirectory</li>
379 :    
380 :     <li>
381 :     in the links/ subdirectory create a file called "reddot.link"</li>
382 :    
383 :     <li>
384 :     edit the file and type in a line</li>
385 :    
386 : vlad 1.3 <br>path=&lt;red dot install path>
387 : vlad 1.1 <li>
388 :     Note: the path value is a file path to the target install directory using
389 : vlad 1.3 native OS format. On Win, double up backslashes, eg. path=c:\\temp\\RedDotInstall</li>
390 : vlad 1.1 </ul>
391 :    
392 :     <li>
393 :     K.3. start Eclipse. Should observe Eclipse restarting (doing the "2 splash
394 :     dance")</li>
395 :    
396 :     <li>
397 :     K.4. workbench opends with a dialog saying we have detected changes.</li>
398 :    
399 :     <li>
400 :     K.5. click [OK] to open Update Manager</li>
401 :    
402 :     <li>
403 : vlad 1.3 K.6. Configuration Changes wizard shows. Check the changes you want to
404 : vlad 1.1 apply (check the box beside the change, should only see one change)</li>
405 :    
406 :     <li>
407 :     K.7. Click [Finish] and restart the workbench when prompted</li>
408 :    
409 :     <li>
410 :     K.8. workbench should restart automatically. Open the update manager (if
411 :     not opened already ... depends if it was opened when the change was detected)</li>
412 :    
413 :     <li>
414 :     K.9. expand "Current Configuration" and verify you now recognize the new
415 :     extension site and it contains configured RedDot feature</li>
416 :    
417 :     <li>
418 :     K.10. Window> Customize Perspective...> Other> check Red Dot Set, [OK]</li>
419 :    
420 :     <li>
421 :     K.11. verify new tool button appears, and a dialog shows when the button
422 :     is clicked.</li>
423 :     </ul>
424 :    
425 : vlad 1.2 <h2>
426 :     Part 2: Alphabet Soup</h2>
427 :    
428 :     <h3>
429 :     Setup:</h3>
430 :     Available sites:
431 :     <ul>
432 :     <li>
433 : 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>
434 : vlad 1.2 </ul>
435 :     The above site contains prebuilt features used as part of the following
436 :     scenario steps. It also includes several .zip files (containing features
437 :     and plugins) that are used to simulate native installer steps.
438 :     <br>&nbsp;
439 :     <table BORDER COLS=1 WIDTH="100%" >
440 :     <tr>
441 :     <td>
442 :     <center><b><font color="#FF0000">*** PLEASE READ *** PLEASE READ *** PLEASE
443 :     READ *** PLEASE READ ***</font></b></center>
444 :     </td>
445 :     </tr>
446 :    
447 :     <tr>
448 :     <td><font color="#000000">When openning Bugzilla defects, use the platform/update
449 :     component. Please ALWAYS specify the failing scenario step, and include
450 :     a .zip of the &lt;workspace>/.metadata/ directory</font></td>
451 :     </tr>
452 :     </table>
453 :    
454 :     <h3>
455 :     Description:</h3>
456 :     The Alphabet Soup is a simple application packaged as an Eclipse product,
457 :     plus several extensions. The application installs a tool button, and a
458 :     menu ("Alphabet Soup") that can be used to query the content of the "soup
459 :     bowl" and interact with the individual installed "letters" (each letter
460 :     in the bowl corresponds to a separate plugin)
461 :     <ul>
462 :     <li>
463 :     base product is a nested feature, my.alphabet, containing two sub-features
464 :     with base sets of "letters"</li>
465 :    
466 :     <li>
467 :     3 extension features containing additional "letters" (plugins). The features
468 :     have a dependency relationship as follows:</li>
469 :    
470 :     <ul>
471 :     <li>
472 :     "round letters" extension pack requires the base to be installed</li>
473 :    
474 :     <li>
475 :     "straight letters" extension pack requires "round letters" extension pack
476 :     to be installed</li>
477 :    
478 :     <li>
479 :     "numbers" extension pack requires both "round letters" extension pack and
480 :     "straight letters" extension pack to be installed</li>
481 :     </ul>
482 :     </ul>
483 :     Just follow the steps and you'll get the idea.
484 :     <h3>
485 :     Steps:</h3>
486 :    
487 :     <ul>
488 :     <li>
489 :     Install second copy of Eclipse to run these scenarios ... do not use your
490 :     development copy of Eclipse for this.</li>
491 :    
492 :     <li>
493 :     either use the default workspace created by the second Eclipse copy, or
494 :     specify (-data) a new workspace for these scenarios</li>
495 :     </ul>
496 :    
497 :     <h4>
498 :     O. Completing the install</h4>
499 :    
500 :     <ul>
501 :     <li>
502 :     O.1. after you have installed baseline eclipse, unzip the Aplhabet Soup
503 :     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>&nbsp;
504 :     into the eclipse/ installation directory. The unzip should overwrite the
505 :     install.ini file that is packaged with Eclipse (sets the Alphabet Soup
506 :     feature as the primary feature). The product feature .zips can be found
507 :     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>
508 :    
509 :     <li>
510 :     O.2. start eclipse .... after "Completing the install ..." the platform
511 :     restarts as "Alphabet Soup" application (own Welcome, About)</li>
512 :    
513 :     <li>
514 :     O.3. Click on the "Alphabet Soup" button in the tool bar ... you should
515 :     have letters A, B, C and E (all 1.0.0) in your bowl.</li>
516 :    
517 :     <li>
518 :     O.4. Go to the "Alphabet Soup" menu and verify you can interact with each
519 :     letter (one action per letter on the menu)</li>
520 :    
521 :     <li>
522 :     O.5. Open Help> Software Updates> Update Manager</li>
523 :    
524 :     <li>
525 :     O.6. Expand "Current Configuration". Verify "Alphabet Soup 1.0.0" is configured,
526 :     and it contains 2 subfeatures (Round and Straight letters)</li>
527 :    
528 :     <li>
529 :     O.7. click on each of the features and view more details about each freature</li>
530 :    
531 :     <li>
532 :     O.8. select "Alphabet Soup 1.0.0" and press [Disable]. You should be notified
533 :     that you cannot disable the primary feature (if this is not the case, [Cancel]
534 :     the disable action and report a defect).</li>
535 :     </ul>
536 :    
537 :     <h4>
538 :     P. Updating the primary feature using update manager</h4>
539 :    
540 :     <ul>
541 :     <li>
542 :     P.1. expand "Sites to Visit", and "Alphabet Soup Update Site" and "Alphabet
543 :     Soup Category"</li>
544 :    
545 :     <ul>
546 :     <li>
547 :     wait for it to expand, even after the "hourglass" disappears - <font color="#FF0000">defect
548 :     16487</font></li>
549 :     </ul>
550 :    
551 :     <li>
552 :     P.2. Select "Alphabet Soup 1.0.0" ... preview should not show [Update]
553 :     button</li>
554 :    
555 :     <li>
556 :     P.3. Select "Alphabet Soup 1.0.1" and select [Update]. Go through the install
557 :     wizard accepting defaults.</li>
558 :    
559 :     <li>
560 :     P.4. Restart the workbench when prompted. Will restart with update manager
561 :     open.</li>
562 :    
563 :     <li>
564 :     P.5. Expand "Current Configuration" .... verify you now have Alphabet Soup
565 :     1.0.1 installed and configured.</li>
566 :    
567 :     <li>
568 :     P.6. Click the "Show disabled features" filter button .... should see both
569 :     versions (one configured, the other unconfugured (icon with grey "stop"
570 :     overlay))</li>
571 :    
572 :     <li>
573 :     P.7. click the "Alphabet Soup" tool button ... should show new versions
574 :     of the base letters (1.0.1). The actions on "Alphabet Soup" menu should
575 :     also indicate we are running the new version.</li>
576 :    
577 :     <li>
578 :     P.8. close update manager</li>
579 :    
580 :     <li>
581 :     P.9. shut down the workbench</li>
582 :     </ul>
583 :    
584 :     <h4>
585 :     Q. Updating the primary feature using "native" install (.zip)</h4>
586 :    
587 :     <ul>
588 :     <li>
589 :     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>&nbsp;
590 :     into the eclipse/ installation directory (look into the features/ or plugins/
591 :     subdirectory to veify you see new 1.1.0 versions)</li>
592 :    
593 :     <li>
594 :     Q.2. start Eclipse (a.k.a. Alphabet Soup). You'll see the splash comming
595 :     up twice as the platfrom is updating the configuration. Workbench will
596 :     come up, with a dialog informing you have changes. Click [OK] to open the
597 :     update manager change dialog.</li>
598 :    
599 :     <li>
600 :     Q.3. check the change (so it is applied) and press [Finish]</li>
601 :    
602 :     <ul>
603 :     <li>
604 :     nested structure not shown - <font color="#FF0000">defect 16496</font></li>
605 :     </ul>
606 :    
607 :     <li>
608 :     Q.4. restart the workbench when prompted</li>
609 :    
610 :     <li>
611 :     Q.5. click the "Alphabet Soup" tool button and trigger "Alphabet Soup"
612 :     menu action to see you have the new version (1.1.0) of the "soup bowl and
613 :     letters"</li>
614 :    
615 :     <li>
616 :     Q.6. Open update manager and expand "Current Configuration". Should see
617 :     Alphabet Soup 1.1.0 configured, and the other 2 unconfigured (click the
618 :     "Show disabled features").</li>
619 :    
620 :     <ul>
621 :     <li>
622 :     showing 2 features as configured - <font color="#FF0000">defect 16502</font></li>
623 :     </ul>
624 :     </ul>
625 :    
626 :     <h4>
627 :     <font color="#000000">R. Adding an extension using the update manager</font></h4>
628 :    
629 :     <ul>
630 :     <li>
631 :     <font color="#000000">R.1. expand "Sites to Visit", "Alphabet Soup Update
632 :     Site", "Alphabet Soup Fun Pack - Round Letters"</font></li>
633 :    
634 :     <ul>
635 :     <li>
636 :     <font color="#000000">wait for expansion (</font><font color="#FF0000">defect
637 :     16487 </font><font color="#000000">as in P.1.), ignore duplicate sites
638 :     (</font><font color="#FF0000">defect 16502 </font><font color="#000000">as
639 :     in Q.6.)</font></li>
640 :     </ul>
641 :    
642 :     <li>
643 :     <font color="#000000">R.2. select "Alphabet Soup Round Letters Extension
644 :     Pack 1.0.0" and click [Install]. Accept defaults in wizard and [Finish].
645 :     Restart workbench when prompted.</font></li>
646 :    
647 :     <li>
648 :     <font color="#000000">R.3. click of the "Alphaber Soup" tool button and
649 :     interact with "Alphabet Soup" menu to see new round letters (D and G).
650 : vlad 1.3 <b>Note:</b>
651 :     may need to go to Window> Costomize Perspective...> Other and select the
652 :     action sets for the new letters</font></li>
653 : vlad 1.2
654 :     <li>
655 :     <font color="#000000">R.4. expand Current Configuration ans verify the
656 :     new feature is showing as configured.</font></li>
657 :    
658 :     <li>
659 :     <font color="#000000">R.4. close the update manager and shut down the workbench</font></li>
660 :     </ul>
661 :    
662 :     <h4>
663 :     <font color="#000000">S. Adding an extension using "native" install (.zip)
664 :     and link file</font></h4>
665 :    
666 :     <ul>
667 :     <li>
668 :     <font color="#000000">S.0. <b>Note</b>: the first 3 steps will typically
669 :     be performed by a native installer. Since you are simulating these steps
670 :     you need to do this manually.</font></li>
671 :    
672 :     <li>
673 :     <font color="#000000">S.1. Set up a new install directory somewhere in
674 :     your file system. Create eclipse/ subdirectory under it. U</font>nzip the
675 :     Aplhabet Soup Straight Letters extension&nbsp; 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>&nbsp;
676 :     into the eclipse/ subdirectory. You should end up with</li>
677 :    
678 :     <ul>
679 :     <li>
680 : vlad 1.3 &lt;some new install directory>/</li>
681 :    
682 :     <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; eclipse/
683 :     <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
684 :     features/
685 :     <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
686 :     plugins/</ul>
687 : vlad 1.2
688 :     <li>
689 :     S.2. In the original eclipse install (the one that contains the platform
690 :     and Alphabet Soup), create a new directory called "links" as a peer to
691 :     features/ and plugins/. You should end up with</li>
692 :    
693 :     <ul>
694 :     <li>
695 : vlad 1.3 &lt;eclipse platform install directory>/</li>
696 :    
697 :     <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; eclipse/
698 :     <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
699 :     links/
700 :     <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; features/
701 :     <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
702 :     plugins/</ul>
703 : vlad 1.2
704 :     <li>
705 :     S.3. within the links/ subdirectory, create a file called my.alphabet.link&nbsp;
706 : vlad 1.3 and add a single line into it</li>
707 :    
708 : vlad 1.6 <br>&nbsp;
709 :     <p>&nbsp;
710 : vlad 1.7 <br>&nbsp;
711 :     <br>&nbsp;
712 : vlad 1.6 <p>path=&lt;some new install directory>
713 : vlad 1.3 <p><b>Note</b>: the path should be an absolute path using local file system
714 : vlad 1.2 syntax. The .link file is loaded as a Java properties file, so on Windows
715 : vlad 1.3 you need to double up the back-slashes (eg. path=c:\\temp\\install)
716 : vlad 1.2 <li>
717 :     S.4. start eclipse (Alphabet Soup). You'll see the splash comming up twice
718 :     as the platfrom is updating the configuration. Workbench will come up,
719 :     with a dialog informing you have changes. Click [OK] to open the update
720 :     manager change dialog.</li>
721 :    
722 :     <li>
723 :     S.5. check the change (so it is applied) and press [Finish]</li>
724 :    
725 :     <li>
726 :     S.6. restart the workbench when prompted</li>
727 :    
728 :     <li>
729 :     S.7. click the "Alphabet Soup" tool button and trigger "Alphabet Soup"
730 : vlad 1.3 menu action to see you have the new letters.</li>
731 : vlad 1.2
732 : vlad 1.3 <br><b>Note</b>: may need to go to Window> Customize Perspective...> Other
733 :     and select the new letters to get the menu actions to become visible
734 :     <br><b>Note</b>: if you are following all the steps in the scenario, the
735 :     base letters (A, B, C, E) should be at 1.1.0, and the extensions (D, G)
736 :     (F, H) at 1.0.0
737 : vlad 1.2 <li>
738 :     S.8. Open update manager and expand "Current Configuration". Should see
739 :     a new site representing the extension install, and it should contain the
740 :     extension feature you've installed.</li>
741 :    
742 :     <ul>
743 :     <li>
744 :     side note: the symptoms of <font color="#FF0000">defect 16502 </font><font color="#000000">(Q.6.)
745 :     disappear</font></li>
746 :     </ul>
747 :     </ul>
748 :    
749 :     <h4>
750 :     T. Installing another extension using the update manager (with environment
751 :     filtering)</h4>
752 :    
753 :     <ul>
754 :     <li>
755 :     <font color="#000000">T.1. expand "Sites to Visit", "Alphabet Soup Update
756 :     Site", "Alphabet Soup Fun Pack - Numbers"</font></li>
757 :    
758 :     <ul>
759 :     <li>
760 :     <font color="#000000">wait for expansion (</font><font color="#FF0000">defect
761 :     16487 </font><font color="#000000">as in P.1.)</font></li>
762 :     </ul>
763 :    
764 :     <li>
765 :     <font color="#000000">T.2. The Numbers extension specifies an OS in its
766 :     feature definition. The update site contains features for Win and Linux.
767 :     On those two platforms you should see a list of features designated for
768 :     than platform. On other platforms you are out of luck ... you don't get
769 :     to play with numbers (skip the rest of this step)</font></li>
770 :    
771 :     <li>
772 :     <font color="#000000">T.3. uncheck the "Show matching features only" filter
773 : vlad 1.6 .... should now see all the features for both platforms. Check the filter
774 : vlad 1.2 back again.</font></li>
775 :    
776 :     <li>
777 :     <font color="#000000">T.4. select "Alphabet Soup Numbers Extension Pack
778 :     for &lt;OS>1.0.1" and click [Install]. Accept defaults in wizard. In the
779 :     location selection page ensure the extension location created in steps
780 :     S is not offered as a choice. Press [Finish]. Restart workbench when prompted.</font></li>
781 :    
782 :     <li>
783 :     <font color="#000000">T.5. click of the "Alphabet Soup" tool button and
784 :     interact with "Alphabet Soup" menu to see new numbers (3 and 5). <b>Note:</b>
785 :     may need to go to Window> Costomize Perspective...> Other and select the
786 :     action sets for the new numbers</font></li>
787 :    
788 :     <li>
789 : vlad 1.6 <font color="#000000">T.6. expand Current Configuration ans verify the
790 : vlad 1.2 new feature is showing as configured in the original install site</font></li>
791 :    
792 :     <li>
793 : vlad 1.6 <font color="#000000">T.7. close the update manager and shut down the workbench</font></li>
794 : vlad 1.2 </ul>
795 :    
796 : vlad 1.1 <h4>
797 : vlad 1.2 <font color="#000000">"Free-form" testing</font></h4>
798 :    
799 :     <ul>
800 :     <li>
801 :     <font color="#000000">the above scenarios describe a path through the update
802 :     support. Run through it once as described. There is lot's of opportunity
803 :     to do thing in different order, click on ither buttons, try other features
804 :     in the UI. Go ahead an explore. Remember, is you see something that does
805 :     not work, is not correct, or is not what you'd expected, open Bugzilla
806 :     defects in the platform/update component. Please ALWAYS specify the steps
807 :     leading up to the failure, and include a .zip of the &lt;workspace>/.metadata/
808 :     directory</font></li>
809 :     </ul>
810 : vlad 1.3
811 :     <h2>
812 :     <font color="#000000">Part-3: Adopting Eclipse</font></h2>
813 : vlad 1.4
814 :     <h3>
815 :     Setup:</h3>
816 :     Available sites:
817 :     <ul>
818 :     <li>
819 :     <a href="http://klicnik.torolab.ibm.com/shrek/">http://klicnik.torolab.ibm.com/shrek/</a></li>
820 :     </ul>
821 :     <b>Note</b>: this site is not available on the public internet. It is a
822 :     test site containing an example of Eclipse packaged as a nested feature.
823 : vlad 1.6 <b>The
824 :     data on the site contains only Eclipse support for Windows.</b>
825 : vlad 1.4 <h3>
826 :     Description:</h3>
827 :     This scenario starts with base eclipse install. It is then updated with
828 :     new feature definitions that "adopt" the features in the base build into
829 :     a nested structure. The base nested feature containing Eclipse runtime
830 :     support is then updated to a new version.
831 :     <h3>
832 :     Steps:</h3>
833 :    
834 :     <ul>
835 :     <li>
836 :     Install second copy of Eclipse to run these scenarios ... do not use your
837 :     development copy of Eclipse for this.</li>
838 :    
839 :     <li>
840 :     either use the default workspace created by the second Eclipse copy, or
841 :     specify (-data) a new workspace for these scenarios</li>
842 :     </ul>
843 :    
844 :     <h4>
845 :     V. Adopting "Flat" Eclipse</h4>
846 :    
847 :     <ul>
848 :     <li>
849 :     V.1. startup Eclipse. On the initial startup with new workspace you should
850 :     see the splash come up, be taken down down, and come up again before it
851 :     is finally taken down before the Workbench appears. This is due to Eclipse
852 :     restart when new features are detected on startup.</li>
853 :    
854 :     <li>
855 :     V.2. go to update manager and verify that the features corresponding to
856 :     the baseline install appear in the "Current Configuration"</li>
857 :    
858 :     <li>
859 :     V.3. create new site bookmark (popup in Updates view, New> Site Bookmark...)</li>
860 :    
861 :     <li>
862 :     V.4. type in a name (eg. Nested Updates) and copy the test site URL as
863 :     specified in the scenario "Setup"</li>
864 :    
865 :     <li>
866 :     V.5. New site bookmark appears ... expand it. You should see a category
867 :     "Adopt Flat Eclipse". Expand it, and select "Eclipse Runtime for Windows".
868 :     Note this is a nested feature. Click on the [+] to see its content. Note
869 :     that is you select any of the child features you cannot perform update
870 :     functions on these (no action buttons in preview). If you select the parent
871 :     you should see [Install]</li>
872 :    
873 :     <li>
874 :     V.6. Click [Install] when the parent feature is selected and and follow
875 :     the Install Wizard (taking defaults) to install the feature. The install
876 :     should be very fast, since all the plugins referenced by the nested structure
877 :     are already installed (they are the base 2.0.0 versions)</li>
878 :    
879 :     <li>
880 :     V.7. <b>Restart</b> the workbench when prompted (on completion of the installation)</li>
881 :    
882 :     <li>
883 :     V.8. workbench should restart automatically, and open into Update manager</li>
884 :    
885 :     <li>
886 :     V.9. expand "Current Configuration" and verify the baseline features have
887 : vlad 1.6 been "adopted" into the nested structure. The baseline SDK features remain
888 : vlad 1.4 non-nested (top level features)</li>
889 :    
890 :     <li>
891 :     V.10. go to Help> About> [About Plug-Ins] and verify you are still running
892 :     the baseline versions of all plugins (ie. the update only affected the
893 :     feature structure)</li>
894 :    
895 :     <li>
896 :     V.11. Expand "Current Configuration". Select the nested feature and press
897 :     [Disable] in the preview. You should be notified that you cannot disable
898 :     the feature (contains the platform).</li>
899 :     </ul>
900 :    
901 :     <h4>
902 :     W. Updating the nested Eclipse</h4>
903 :    
904 :     <ul>
905 :     <li>
906 :     W.1. Expand the update site bookmarked in the previous step. This time
907 :     expand the NESTED category corresponding to the latest build. Select "Eclipse
908 :     Runtime for Windows".</li>
909 :    
910 :     <li>
911 :     W.2. Click [Update] when the parent feature is selected and and follow
912 :     the Install Wizard (taking defaults) to install the feature. The install
913 :     should be slow, since we are downloading all new features and plugins (they
914 :     are the&nbsp; 2.0.0.QUALIFIER versions). Do not do this step unless you
915 :     have a reasonably fast connection.</li>
916 :    
917 :     <li>
918 :     W.3. <b>Restart</b> the workbench when prompted (on completion of the installation)</li>
919 :    
920 :     <li>
921 :     W.4. workbench should restart automatically, and open into Update manager</li>
922 :    
923 :     <li>
924 :     W.5. expand "Current Configuration" and verify you now have an updated
925 :     version of the nested feature (new parent version as well as new children)</li>
926 :    
927 :     <li>
928 :     W.5. go to Help> About> [About Plug-Ins] and verify that all runtime plugins
929 :     have in fact been updated to the new version (the SDK plugins have not)</li>
930 :     </ul>
931 : vlad 1.2
932 : vlad 1.1 </body>
933 :     </html>