platform-update-home/3.0/test_scenarios.html

Parent Directory Parent Directory | Revision Log Revision Log

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