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

Parent Directory Parent Directory | Revision Log Revision Log


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