platform-update-home/3.0/test_scenarios.html

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1.2 - (view) (download) (as text)

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