platform-update-home/doc/working/documentation/user guide.html

Parent Directory Parent Directory | Revision Log Revision Log


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

1 : celek 1.1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 :     <html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns="http://www.w3.org/TR/REC-html40">
3 :     <head>
4 : vlad 1.6
5 : celek 1.1 <meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
6 : vlad 1.6
7 : celek 1.1 <meta name="ProgId" content="Word.Document">
8 : vlad 1.6
9 : celek 1.1 <meta name="Generator" content="Microsoft Word 9">
10 : vlad 1.6
11 : celek 1.1 <meta name="Originator" content="Microsoft Word 9">
12 : vlad 1.6
13 : vlad 1.5 <link rel="File-List" href="./user%20guide_files/filelist.xml">
14 : vlad 1.6
15 : vlad 1.5 <link rel="Edit-Time-Data" href="./user%20guide_files/editdata.mso">
16 : vlad 1.6 <!--[if !mso]>
17 : vlad 1.5 <style>
18 :     v\:* {behavior:url(#default#VML);}
19 :     o\:* {behavior:url(#default#VML);}
20 :     w\:* {behavior:url(#default#VML);}
21 :     .shape {behavior:url(#default#VML);}
22 :     </style>
23 :     <![endif]--><!--[if gte mso 9]><xml>
24 : celek 1.1 <o:DocumentProperties>
25 :     <o:Author>Labuser</o:Author>
26 :     <o:LastAuthor>Labuser</o:LastAuthor>
27 : vlad 1.5 <o:Revision>4</o:Revision>
28 :     <o:TotalTime>40</o:TotalTime>
29 : celek 1.1 <o:Created>2002-04-12T13:24:00Z</o:Created>
30 : vlad 1.5 <o:LastSaved>2002-04-26T18:30:00Z</o:LastSaved>
31 :     <o:Pages>37</o:Pages>
32 :     <o:Words>7006</o:Words>
33 :     <o:Characters>39939</o:Characters>
34 : celek 1.1 <o:Company>IBM Canada Ltd.</o:Company>
35 : vlad 1.5 <o:Lines>332</o:Lines>
36 :     <o:Paragraphs>79</o:Paragraphs>
37 :     <o:CharactersWithSpaces>49047</o:CharactersWithSpaces>
38 :     <o:Version>9.4402</o:Version>
39 : celek 1.1 </o:DocumentProperties>
40 :     </xml><![endif]--><!--[if gte mso 9]><xml>
41 :     <w:WordDocument>
42 :     <w:View>Normal</w:View>
43 :     </w:WordDocument>
44 :     </xml><![endif]-->
45 : vlad 1.6
46 : celek 1.1 <style>
47 :     <!--
48 : vlad 1.5 /* Font Definitions */
49 :     @font-face
50 :     {font-family:Wingdings;
51 :     panose-1:5 0 0 0 0 0 0 0 0 0;
52 :     mso-font-charset:2;
53 :     mso-generic-font-family:auto;
54 :     mso-font-pitch:variable;
55 :     mso-font-signature:0 268435456 0 0 -2147483648 0;}
56 : celek 1.1 /* Style Definitions */
57 :     p.MsoNormal, li.MsoNormal, div.MsoNormal
58 :     {mso-style-parent:"";
59 :     margin:0in;
60 :     margin-bottom:.0001pt;
61 :     mso-pagination:widow-orphan;
62 :     font-size:12.0pt;
63 :     font-family:"Times New Roman";
64 : vlad 1.5 mso-fareast-font-family:"Times New Roman";}
65 : celek 1.1 a:link, span.MsoHyperlink
66 :     {color:blue;
67 :     text-decoration:underline;
68 :     text-underline:single;}
69 :     a:visited, span.MsoHyperlinkFollowed
70 :     {color:blue;
71 :     text-decoration:underline;
72 :     text-underline:single;}
73 : vlad 1.5 p
74 :     {font-size:12.0pt;
75 :     font-family:"Times New Roman";
76 :     mso-fareast-font-family:"Times New Roman";}
77 : celek 1.1 @page Section1
78 :     {size:8.5in 11.0in;
79 :     margin:1.0in 1.25in 1.0in 1.25in;
80 :     mso-header-margin:.5in;
81 :     mso-footer-margin:.5in;
82 :     mso-paper-source:0;}
83 :     div.Section1
84 :     {page:Section1;}
85 : vlad 1.5 /* List Definitions */
86 :     @list l0
87 :     {mso-list-id:176500654;
88 :     mso-list-type:hybrid;
89 :     mso-list-template-ids:-1610958616 642254348 1802898708 832353870 1508951890 1061685170 -1919385224 2135210068 654506682 1871347928;}
90 :     @list l0:level1
91 :     {mso-level-number-format:bullet;
92 :     mso-level-text:\F0B7;
93 :     mso-level-tab-stop:.5in;
94 :     mso-level-number-position:left;
95 :     text-indent:-.25in;
96 :     mso-ansi-font-size:10.0pt;
97 :     font-family:Symbol;}
98 :     @list l1
99 :     {mso-list-id:218640366;
100 :     mso-list-type:hybrid;
101 :     mso-list-template-ids:34625782 1879064160 1004709138 377518572 -120535498 2063753912 -2023747948 -1093910570 1169450864 -892324782;}
102 :     @list l1:level1
103 :     {mso-level-number-format:bullet;
104 :     mso-level-text:\F0B7;
105 :     mso-level-tab-stop:.5in;
106 :     mso-level-number-position:left;
107 :     text-indent:-.25in;
108 :     mso-ansi-font-size:10.0pt;
109 :     font-family:Symbol;}
110 :     @list l2
111 :     {mso-list-id:352460617;
112 :     mso-list-type:hybrid;
113 :     mso-list-template-ids:-162135770 1573412640 -1143561686 -1359181440 -1778846596 -675634294 2040702502 -1798133188 1104082008 -1747005554;}
114 :     @list l2:level1
115 :     {mso-level-number-format:bullet;
116 :     mso-level-text:\F0B7;
117 :     mso-level-tab-stop:.5in;
118 :     mso-level-number-position:left;
119 :     text-indent:-.25in;
120 :     mso-ansi-font-size:10.0pt;
121 :     font-family:Symbol;}
122 :     @list l3
123 :     {mso-list-id:605431337;
124 :     mso-list-type:hybrid;
125 :     mso-list-template-ids:1882218214 405577580 -2088048828 -620979218 2034551570 -105331346 -1872204942 1960992960 939655452 187189704;}
126 :     @list l3:level1
127 :     {mso-level-number-format:bullet;
128 :     mso-level-text:\F0B7;
129 :     mso-level-tab-stop:.5in;
130 :     mso-level-number-position:left;
131 :     text-indent:-.25in;
132 :     mso-ansi-font-size:10.0pt;
133 :     font-family:Symbol;}
134 :     @list l4
135 :     {mso-list-id:616332951;
136 :     mso-list-type:hybrid;
137 :     mso-list-template-ids:-2121503670 -938192272 -326495040 1344303574 -1323801064 876136946 30171346 -155432398 -275235212 964169354;}
138 :     @list l4:level1
139 :     {mso-level-number-format:bullet;
140 :     mso-level-text:\F0B7;
141 :     mso-level-tab-stop:.5in;
142 :     mso-level-number-position:left;
143 :     text-indent:-.25in;
144 :     mso-ansi-font-size:10.0pt;
145 :     font-family:Symbol;}
146 :     @list l5
147 :     {mso-list-id:866215456;
148 :     mso-list-type:hybrid;
149 :     mso-list-template-ids:1920229162 1560599570 1041117306 129912886 -1062160960 708860616 27537738 1767956120 355867502 -862035300;}
150 :     @list l5:level1
151 :     {mso-level-number-format:bullet;
152 :     mso-level-text:\F0B7;
153 :     mso-level-tab-stop:.5in;
154 :     mso-level-number-position:left;
155 :     text-indent:-.25in;
156 :     mso-ansi-font-size:10.0pt;
157 :     font-family:Symbol;}
158 :     @list l6
159 :     {mso-list-id:1154100461;
160 :     mso-list-type:hybrid;
161 :     mso-list-template-ids:1872510168 -1107939372 1002330802 -109801440 -2066709300 -469189498 -32725494 1094512198 -1131148552 847540354;}
162 :     @list l6:level1
163 :     {mso-level-number-format:bullet;
164 :     mso-level-text:\F0B7;
165 :     mso-level-tab-stop:.5in;
166 :     mso-level-number-position:left;
167 :     text-indent:-.25in;
168 :     mso-ansi-font-size:10.0pt;
169 :     font-family:Symbol;}
170 :     @list l7
171 :     {mso-list-id:1187713294;
172 :     mso-list-type:hybrid;
173 :     mso-list-template-ids:-774317378 863262924 94686218 777449778 -1792346184 -177564868 -543274984 570163436 -839747324 154972114;}
174 :     @list l7:level1
175 :     {mso-level-number-format:bullet;
176 :     mso-level-text:\F0B7;
177 :     mso-level-tab-stop:.5in;
178 :     mso-level-number-position:left;
179 :     text-indent:-.25in;
180 :     mso-ansi-font-size:10.0pt;
181 :     font-family:Symbol;}
182 :     @list l8
183 :     {mso-list-id:1209759940;
184 :     mso-list-type:hybrid;
185 :     mso-list-template-ids:-1384239484 12115666 -1522996244 1357256764 -57769864 287099324 -498568288 1039707782 -994642542 2043954892;}
186 :     @list l8:level1
187 :     {mso-level-number-format:bullet;
188 :     mso-level-text:\F0B7;
189 :     mso-level-tab-stop:.5in;
190 :     mso-level-number-position:left;
191 :     text-indent:-.25in;
192 :     mso-ansi-font-size:10.0pt;
193 :     font-family:Symbol;}
194 :     @list l9
195 :     {mso-list-id:1236814312;
196 :     mso-list-type:hybrid;
197 :     mso-list-template-ids:559448602 -1711787468 1330648572 -883384858 -244786894 -715873546 1211635840 660658588 -744705912 -794755240;}
198 :     @list l9:level1
199 :     {mso-level-number-format:bullet;
200 :     mso-level-text:\F0B7;
201 :     mso-level-tab-stop:.5in;
202 :     mso-level-number-position:left;
203 :     text-indent:-.25in;
204 :     mso-ansi-font-size:10.0pt;
205 :     font-family:Symbol;}
206 :     @list l10
207 :     {mso-list-id:1605460185;
208 :     mso-list-type:hybrid;
209 :     mso-list-template-ids:974180206 1133525928 367190754 2067152578 447217748 -831647314 -1073024844 -1079202094 1437874260 1908586386;}
210 :     @list l10:level1
211 :     {mso-level-number-format:bullet;
212 :     mso-level-text:\F0B7;
213 :     mso-level-tab-stop:.5in;
214 :     mso-level-number-position:left;
215 :     text-indent:-.25in;
216 :     mso-ansi-font-size:10.0pt;
217 :     font-family:Symbol;}
218 :     @list l11
219 :     {mso-list-id:1744404298;
220 :     mso-list-type:hybrid;
221 :     mso-list-template-ids:-88457190 -1540190154 -408363358 -2044964954 -285425460 -240244494 1407350808 -1877299018 -358864090 -1172158700;}
222 :     @list l11:level1
223 :     {mso-level-number-format:bullet;
224 :     mso-level-text:\F0B7;
225 :     mso-level-tab-stop:.5in;
226 :     mso-level-number-position:left;
227 :     text-indent:-.25in;
228 :     mso-ansi-font-size:10.0pt;
229 :     font-family:Symbol;}
230 :     @list l12
231 :     {mso-list-id:1885405565;
232 :     mso-list-type:hybrid;
233 :     mso-list-template-ids:1961771624 327431722 1424228792 1048887018 -866747864 -854166330 1516670514 -1122991992 1998767166 804526810;}
234 :     @list l12:level1
235 :     {mso-level-number-format:bullet;
236 :     mso-level-text:\F0B7;
237 :     mso-level-tab-stop:.5in;
238 :     mso-level-number-position:left;
239 :     text-indent:-.25in;
240 :     mso-ansi-font-size:10.0pt;
241 :     font-family:Symbol;}
242 :     @list l13
243 :     {mso-list-id:1904632842;
244 :     mso-list-type:hybrid;
245 :     mso-list-template-ids:1140086398 -1191815874 -1132298448 -1085131794 2014741232 -1565625484 -1997398374 1304058260 250103498 912524370;}
246 :     @list l13:level1
247 :     {mso-level-number-format:bullet;
248 :     mso-level-text:\F0B7;
249 :     mso-level-tab-stop:.5in;
250 :     mso-level-number-position:left;
251 :     text-indent:-.25in;
252 :     mso-ansi-font-size:10.0pt;
253 :     font-family:Symbol;}
254 :     @list l14
255 :     {mso-list-id:2046173909;
256 :     mso-list-type:hybrid;
257 :     mso-list-template-ids:540473568 1821304618 -460709142 -1138166102 1599221368 788721296 -1790257806 141168422 -1446980396 2088423136;}
258 :     @list l14:level1
259 :     {mso-level-number-format:bullet;
260 :     mso-level-text:\F0B7;
261 :     mso-level-tab-stop:.5in;
262 :     mso-level-number-position:left;
263 :     text-indent:-.25in;
264 :     mso-ansi-font-size:10.0pt;
265 :     font-family:Symbol;}
266 :     ol
267 :     {margin-bottom:0in;}
268 :     ul
269 :     {margin-bottom:0in;}
270 : celek 1.1 -->
271 :     </style> <!--[if gte mso 9]><xml>
272 : vlad 1.5 <o:shapedefaults v:ext="edit" spidmax="1027"/>
273 : celek 1.1 </xml><![endif]--><!--[if gte mso 9]><xml>
274 :     <o:shapelayout v:ext="edit">
275 :     <o:idmap v:ext="edit" data="1"/>
276 :     </o:shapelayout></xml><![endif]-->
277 :     </head>
278 : vlad 1.6 <body lang="EN-US" link="blue" vlink="blue" style="tab-interval:.5in">
279 : vlad 1.5 <div class="Section1">
280 :     <h1 align="Center" style="text-align: center; ">Install/Update User Guide</h1>
281 :     <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p>
282 : celek 1.1 <h2>Getting Started: Install/Update in three steps</h2>
283 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">This
284 : vlad 1.6 section will teach you how to install a new Feature and how to revert to
285 :     a previous state in three easy steps. Before you start, make sure you installed
286 :     the 'mockup' site following the <a href="http://www.eclipse.org">install
287 :     mockup site</a>
288 :     instructions.</p>
289 : vlad 1.5 <h3>Find new Feature</h3>
290 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">This
291 : vlad 1.6 section will focus on finding a feature to install. There are different ways
292 :     of finding a feature. The one we are going to focus in this section is <a href="http://www.eclipse.org">
293 :     browsing a site</a>
294 :     . For more information about other ways of finding a feature, look at
295 :     the <a href="http://www.eclipse.org">Find Features</a>
296 :     section.</p>
297 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">Before
298 : vlad 1.6 browsing a site, we will have to create a site bookmark to access it.</p>
299 : vlad 1.5 <h4>Create a new site bookmark</h4>
300 :     <ul type="Disc">
301 :     <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
302 :     mso-list:l13 level1 lfo1;tab-stops:list .5in">
303 : vlad 1.6 Open the Install/Update perspective Help-&gt;Update Manager</li>
304 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
305 :     mso-list:l13 level1 lfo1;tab-stops:list .5in">
306 : vlad 1.6 Select the Updates View.</li>
307 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
308 :     mso-list:l13 level1 lfo1;tab-stops:list .5in">
309 : vlad 1.6 Open the context menu </li>
310 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
311 :     mso-list:l13 level1 lfo1;tab-stops:list .5in">
312 : vlad 1.6 Select new-&gt;site bookmark...</li>
313 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
314 :     mso-list:l13 level1 lfo1;tab-stops:list .5in">
315 : vlad 1.6 In the Site Name entry field type: Test Site</li>
316 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
317 :     mso-list:l13 level1 lfo1;tab-stops:list .5in">
318 : vlad 1.6 In the Site Address entry field type the URL where you installed
319 :     the mockup site. (i.e. file:c:/eclipse/site)</li>
320 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
321 :     mso-list:l13 level1 lfo1;tab-stops:list .5in">
322 : vlad 1.6 Click Ok </li>
323 : vlad 1.5 </ul>
324 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The
325 : vlad 1.6 Site should appear on the view. The provider of a feature should give you
326 :     the URL of their site so you can find their feature. We will now browse the
327 :     site to discover the features.</p>
328 : vlad 1.5 <h4>Choose Feature</h4>
329 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You
330 : vlad 1.6 can expand the site and the categories to see the Features. In this site
331 :     you should see one category: Red Dot Versions, and two features: Red Dot
332 :     Feature 1.0.0 and Red Dot Feature 2.0.0. </p>
333 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 1in; text-indent: -0.25in; "><!--[if !supportLists]--><span style="font-size: 10pt; font-family: Symbol; ">
334 : vlad 1.6 ·<span style="font-family: &quot;Times New Roman&quot;; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none; "></span></span><!--[endif]-->
335 :     Select Red Dot Feature 1.0.0</p>
336 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The
337 : vlad 1.6 Preview page should now look like the following picture:</p>
338 :     <p class="MsoNormal" align="Center" style="text-align: center; "><img border="0" width="678" height="518" id="_x0000_i1025" src="images%5Cpic001.gif" alt="pic001.gif Preview Page of Red Dot 1.0.0">
339 : vlad 1.5 </p>
340 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You
341 : vlad 1.6 may want to check the license and copyright or decide to have more information
342 :     about the Feature you are about to install. 'Click' on the appropriate link
343 :     at the bottom of the view to automatically open a browser that will show
344 :     you the desired page.</p>
345 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">&lt;TIP
346 : vlad 1.6 the preference page lets you decide if you want to view the HTML page within
347 :     the workbench or by launching an external browser&gt;</p>
348 : vlad 1.5 <h3>Install Feature</h3>
349 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When
350 : vlad 1.6 you are ready to install the feature click on the Install button in the Preview
351 :     View. This will launch the Install Wizard.</p>
352 : vlad 1.5 <h4>Install Wizard</h4>
353 :     <ul type="Disc">
354 :     <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
355 :     mso-list:l10 level1 lfo3;tab-stops:list .5in">
356 : vlad 1.6 The first page of the Wizard summarizes the action you are going
357 :     to take. Click Next.</li>
358 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
359 :     mso-list:l10 level1 lfo3;tab-stops:list .5in">
360 : vlad 1.6 The second page shows the license you have to accept to install the
361 :     feature. Click next of you accept the presented license otherwise click
362 :     cancel.</li>
363 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
364 :     mso-list:l10 level1 lfo3;tab-stops:list .5in">
365 : vlad 1.6 The last page of the Wizard presents the list of Site you can install
366 :     your feature in. You can create a new site from this page. For more
367 :     information about creating new Site see:<a href="http://www.eclipse.org">
368 :     Site Location Tab</a>
369 :     .You should see only one site and it should point to the path where
370 :     the workbench is installed. Click Finish.</li>
371 : vlad 1.5 </ul>
372 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The
373 : vlad 1.6 feature will then be downloaded, verified and installed in the site. You
374 :     can see the progress monitor showing you the evolution of theses tasks. During
375 :     verification, you may be prompted to accept the verification. Click 'Ok'
376 :     when prompted.</p>
377 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When
378 : vlad 1.6 the feature has been installed you will need to restart the workbench for
379 :     the changes to take effect. Click 'Ok' on the dialog box.</p>
380 : vlad 1.5 <h4>Verify the feature has been installed</h4>
381 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The
382 : vlad 1.6 feature you installed will add a red button icon to the tool bar when activated.
383 :     To activate this specific feature customize your perspective and add the
384 :     Red Dot Set Action Set:</p>
385 : vlad 1.5 <ul type="Disc">
386 :     <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
387 :     mso-list:l11 level1 lfo4;tab-stops:list .5in">
388 : vlad 1.6 Open the menu Window</li>
389 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
390 :     mso-list:l11 level1 lfo4;tab-stops:list .5in">
391 : vlad 1.6 Select Customize Perspective</li>
392 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
393 :     mso-list:l11 level1 lfo4;tab-stops:list .5in">
394 : vlad 1.6 Expand Action Sets</li>
395 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
396 :     mso-list:l11 level1 lfo4;tab-stops:list .5in">
397 : vlad 1.6 Check Red Dot Set</li>
398 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
399 :     mso-list:l11 level1 lfo4;tab-stops:list .5in">
400 : vlad 1.6 Click Ok</li>
401 : vlad 1.5 </ul>
402 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You
403 : vlad 1.6 should now se a red button icon on the toolbar. If you click on it the following
404 :     dialog box should appear, meaning the feature and associated plug-ins have
405 :     been successfully installed and configured.</p>
406 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We
407 : vlad 1.6 will now see how to manage your feature in your configuration.</p>
408 : vlad 1.5 <h3>Configure Environment</h3>
409 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">A feature
410 :     that is installed may be configured or unconfigured for your workspace. A
411 :     configured feature means that Install/Update will 'suggests' that the runtime
412 : vlad 1.6 configures the feature to be available. An unconfigured feature means that
413 :     Install/Update will make the feature unavailable to the user.</p>
414 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When
415 : vlad 1.6 you installed Red Dot Feature 1.0.0, Install/Update installed and configured
416 :     the feature for you. You can see that in the Configuration History. For more
417 :     information about Configuration History see <a href="http:/ww.eclipse.org">
418 :     Configuration History</a>
419 :     .</p>
420 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">A configuration
421 :     is a list of configured and unconfigured features that determine what tool
422 :     you can use.<br>
423 : vlad 1.6 The current configuration is the configuration currently active.</p>
424 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">For
425 : vlad 1.6 more information about configuration, see <a href="http://www.eclipse.org">
426 :     Configuring/Unconfiguring</a>
427 :     .</p>
428 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">In
429 : vlad 1.6 this section we will add the current history configuration to the list of
430 :     preserved configuration. We will unconfigure Red Dot 1.0.0, so the feature
431 :     will be unavailable. Then we will restore the preserved configuration, which
432 :     will re-configure the feature.</p>
433 : vlad 1.5 <h4>Add configuration to preserved</h4>
434 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">To
435 : vlad 1.6 add the current configuration, we will first need to find it in the list
436 :     of configurations and then add it to the list of preserved configurations.
437 :     The current configuration is the configuration in the configuration history
438 :     folder with an icon with a running person. It is the last configuration in
439 :     the list.</p>
440 : vlad 1.5 <ul type="Disc">
441 :     <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
442 :     mso-list:l4 level1 lfo5;tab-stops:list .5in">
443 : vlad 1.6 Select the current configuration.</li>
444 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
445 :     mso-list:l4 level1 lfo5;tab-stops:list .5in">
446 : vlad 1.6 Open the context menu.</li>
447 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
448 :     mso-list:l4 level1 lfo5;tab-stops:list .5in">
449 : vlad 1.6 Select Add to preserved.</li>
450 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
451 :     mso-list:l4 level1 lfo5;tab-stops:list .5in">
452 : vlad 1.6 The configuration now appears under the Preserved Configurations
453 :     folder.</li>
454 : vlad 1.5 </ul>
455 :     <h4>Rename configuration</h4>
456 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We
457 : vlad 1.6 will rename the configuration to give it a meaningful name.</p>
458 : vlad 1.5 <ul type="Disc">
459 :     <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
460 :     mso-list:l2 level1 lfo6;tab-stops:list .5in">
461 : vlad 1.6 Select the configuration.</li>
462 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
463 :     mso-list:l2 level1 lfo6;tab-stops:list .5in">
464 : vlad 1.6 Open the context menu and click Properties.</li>
465 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
466 :     mso-list:l2 level1 lfo6;tab-stops:list .5in">
467 : vlad 1.6 Change the name of the configuration to: RedDot 1</li>
468 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
469 :     mso-list:l2 level1 lfo6;tab-stops:list .5in">
470 : vlad 1.6 Click Ok.</li>
471 : vlad 1.5 </ul>
472 :     <h4>Unconfigure Feature</h4>
473 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We
474 : vlad 1.6 will now unconfigure the feature.</p>
475 : vlad 1.5 <ul type="Disc">
476 :     <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
477 :     mso-list:l0 level1 lfo7;tab-stops:list .5in">
478 : vlad 1.6 Expand Current Configuration;</li>
479 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
480 :     mso-list:l0 level1 lfo7;tab-stops:list .5in">
481 : vlad 1.6 Expand the site</li>
482 : vlad 1.5 </ul>
483 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "><img border="0" width="202" height="118" id="_x0000_i1026" src="images%5Cpic004.gif" alt="Expand Current Configuration to reveal the configured Feature.">
484 :     </p>
485 :     <ul type="Disc">
486 :     <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
487 :     mso-list:l3 level1 lfo8;tab-stops:list .5in">
488 : vlad 1.6 Select Red Dot Feature 1.0.0</li>
489 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
490 :     mso-list:l3 level1 lfo8;tab-stops:list .5in">
491 : vlad 1.6 In the preview view click Unconfigure.</li>
492 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
493 :     mso-list:l3 level1 lfo8;tab-stops:list .5in">
494 : vlad 1.6 When the Dialog opens click Ok.</li>
495 : vlad 1.5 </ul>
496 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The
497 : vlad 1.6 workspace will shutdown and restart automatically.</p>
498 : vlad 1.5 <h3>Restore Configuration</h3>
499 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We
500 : vlad 1.6 shall now restore the configuration we added to preserve, so the feature
501 :     will be configured again.</p>
502 : vlad 1.5 <h4>Verify the Feature is not available</h4>
503 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You
504 : vlad 1.6 should not see the red button icon in the toolbar, meaning the feature was
505 :     not activated</p>
506 : vlad 1.5 <ul type="Disc">
507 :     <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
508 :     mso-list:l14 level1 lfo9;tab-stops:list .5in">
509 : vlad 1.6 In the Configuration View, expand Current Configuration.</li>
510 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
511 :     mso-list:l14 level1 lfo9;tab-stops:list .5in">
512 : vlad 1.6 Expand the site.</li>
513 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
514 :     mso-list:l14 level1 lfo9;tab-stops:list .5in">
515 : vlad 1.6 Verify Red Dot Feature 1.0.0 does NOT appear as an icon.</li>
516 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
517 :     mso-list:l14 level1 lfo9;tab-stops:list .5in">
518 : vlad 1.6 Click on the view toolbar button 'show unconfigured features'</li>
519 : vlad 1.5 <li>Verify Red Dot Feature 1.0.0 does appear</li>
520 :     </ul>
521 :     <blockquote>
522 :     <div>
523 :     <div><img border="0" width="257" height="117" id="_x0000_i1027" src="file:///c:/oti/source-code/workspace/platform-update-home/doc/working/documentation/images/pic005.gif" alt="Unconfigured feature revealed">
524 :     </div>
525 :     </div>
526 : celek 1.4 </blockquote>
527 : vlad 1.5 <blockquote>
528 :     <div align="Left">The icon <img border="0" width="16" height="16" id="_x0000_i1028" src="images%5Cunconf_feature_obj.gif" alt="Unconfigured Feature unconf_feature_obj.gif ">
529 : vlad 1.6 means the feature is still installed but not available at this time in
530 :     your workspace. To be able to use the feature we will need to configure
531 :     the feature.</div>
532 : celek 1.4 </blockquote>
533 : vlad 1.5 <h4>Revert to preserved configuration</h4>
534 :     <p class="MsoNormal"> We will now go back to the configuration
535 : vlad 1.6 we had previously, in which Red Dot Feature 1.0.0 was configured.</p>
536 : vlad 1.5 <ul type="Disc">
537 :     <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
538 :     mso-list:l12 level1 lfo10;tab-stops:list .5in">
539 : vlad 1.6 Expand Preserved Configurations</li>
540 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
541 :     mso-list:l12 level1 lfo10;tab-stops:list .5in">
542 : vlad 1.6 Select RedDot 1</li>
543 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
544 :     mso-list:l12 level1 lfo10;tab-stops:list .5in">
545 : vlad 1.6 In the preview view click Restore</li>
546 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
547 :     mso-list:l12 level1 lfo10;tab-stops:list .5in">
548 : vlad 1.6 When the Dialog opens click Ok.</li>
549 : vlad 1.5 </ul>
550 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
551 : vlad 1.6 The workspace will shutdown and restart automatically. After the workspace
552 :     restart, the feature is configured, based on the revert configuration.</p>
553 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
554 : vlad 1.6 There are different ways of configuring a feature. To know more about configuring
555 :     and unconfiguring features see: <a href="http://www.eclipse.org">Configuring/Unconfiguring
556 :     features</a>
557 :     .</p>
558 : vlad 1.5 <p class="MsoNormal">In this section you learnt how to find a feature
559 : vlad 1.6 you want to install, how to install a feature, how to unconfigure a feature
560 :     and how to restore a preserved configuration. The rest of the book will
561 :     go into more details.</p>
562 : vlad 1.5 <h2>The User Interface</h2>
563 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
564 : vlad 1.6 This section describes in details the User Interface of the Install/Update
565 :     perspective. The perspective is composed of four different views: The Configuration
566 :     View to manage the configurations, the Updates View to manage update sites
567 :     and features as well as searches. The Preview View is used to show the details
568 :     of the element selected in the previous two views and the Web View, which
569 :     is used to browse HTML document from either sites or features.</p>
570 : vlad 1.5 <h3>The Configuration View</h3>
571 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
572 : vlad 1.6 The configuration view helps you manage your configurations. A configuration
573 :     is a list of configured and unconfigured features that determine what tool
574 :     are available fro you to use in your workspace. <br>
575 : vlad 1.5 </p>
576 :     <blockquote><img border="0" width="251" height="251" id="_x0000_i1029" src="images%5Cpic006.gif" alt="Configuration View">
577 : celek 1.4 </blockquote>
578 : vlad 1.5 <h4>Current Configuration</h4>
579 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
580 : vlad 1.6 The current configuration is the configuration currently active. When
581 :     you expand the Current Configuration you can see the sites you are connected
582 :     to. Expanding each site reveals the list of Features you have access to. Some
583 :     feature may be configured, some may be unconfigured. The configured features
584 :     are the tools the Install/Update suggested the runtime to activate. To know
585 :     more about configured/Unconfigured features see: <a href="http://www.eclipse.org">
586 :     Configured/Unconfigured</a>
587 :     .</p>
588 : vlad 1.5 <h4>Configuration History</h4>
589 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
590 : vlad 1.6 The Configuration History folder contains the last <i>n</i> configurations
591 :     you used. <i>n</i> is a number you can set in the Install/Update preference
592 :     page. See: <a href="http://www.eclipse.org">Install/Update Preference Page</a>
593 :     .</p>
594 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
595 : vlad 1.6 You can use the history list to see what are the different activities
596 :     that occurred as well as restoring an old configuration to make it the current
597 :     one.</p>
598 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
599 : vlad 1.6 Install/Update creates a new configuration history when one or more activities
600 :     are performed (i.e. install, configure, unconfigure etc...). When the Install/Update
601 :     creates a new configuration, it will add it to the list. If you already have
602 :     n configurations, the framework will automatically delete the oldest configuration
603 :     from the list. To know when the Install/Update creates new configuration
604 :     history and what are the Activities see:<a href="http://www.eclipse.org">
605 :     Configuration History</a>
606 :     .</p>
607 : vlad 1.5 <h4>Preserved Configuration</h4>
608 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
609 : vlad 1.6 The Preserved Configurations folder contains history configurations you
610 :     want to keep. The framework does not automatically delete the configurations
611 :     in the Preserved Configurations folder; you have to explicitly delete them.</p>
612 : vlad 1.5 <h4>Configured/Unconfigured</h4>
613 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
614 : vlad 1.6 You can decide to see only the configured features or both configured/unconfigured
615 :     features by clicking the 'Show Unconfigured Features' toggle button in the
616 :     view tool bar. To know more about configured/unconfigured features see:
617 :     <a href="http://www.eclipse.org"> Configured/Unconfigured</a>
618 :     .</p>
619 : vlad 1.5 <h4>Local View Toolbar Actions</h4>
620 :     <h5>Show Unconfigured Feature</h5>
621 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
622 : vlad 1.6 This button allows you to see only the configured features or both configured
623 :     and unconfigured features. Unconfigured features appear with a red circle
624 :     around the icon. For more information about configuring/unconfiguring features
625 :     see: <a href="http://www.eclipse.org">Configuring/Unconfiguring</a>
626 :     .</p>
627 : vlad 1.5 <h4>Context Actions</h4>
628 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
629 : vlad 1.6 This section describes the different context actions available in the
630 :     Configuration View.</p>
631 : vlad 1.5 <h5>Go Home</h5>
632 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
633 : vlad 1.6 This action &lt;TODO be consistent with navigator&gt;</p>
634 : vlad 1.5 <h5>Go Back</h5>
635 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
636 : vlad 1.6 This action &lt;TODO be consistent with navigator&gt;</p>
637 : vlad 1.5 <h5>Go Into</h5>
638 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
639 : vlad 1.6 This action &lt;TODO be consistent with navigator&gt;</p>
640 : vlad 1.5 <h5>Show Details</h5>
641 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
642 : vlad 1.6 This action opens or refreshes the Preview View with the details of the
643 :     selected element.</p>
644 : vlad 1.5 <h5>Properties</h5>
645 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
646 : vlad 1.6 This opens a Dialog box that presents the label of the selected configuration.
647 :     You are able to change the label of a configuration. Click Ok when you have
648 :     finished and you want to preserve your changes or click Cancel if you do
649 :     not want to change the properties.</p>
650 : vlad 1.5 <h5>Add to Preserved</h5>
651 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
652 : vlad 1.6 This action adds the selected configuration in the Configuration History
653 :     folder to the list of preserved configuration.</p>
654 : vlad 1.5 <h5>Remove from Preserved</h5>
655 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
656 : vlad 1.6 This action removes the selected configuration from the list of preserved
657 :     configurations. This action will not delete any Site, Site Bookmark or Feature.
658 :     This action will not delete the configuration it was created from or any
659 :     other configuration.</p>
660 : vlad 1.5 <h5>Restore</h5>
661 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
662 : vlad 1.6 This action creates a new configuration based on the selected configuration
663 :     and marks it as current. Install/Update will automatically configure all
664 :     the features that were configured in the selected configuration you want to
665 :     restore. To know more about restoring or reverting to a configuration see:
666 :     <a href="http://www.eclipse.org"> Restore a Configuration/Revert to
667 :     previous configuration</a>
668 :     .</p>
669 : vlad 1.5 <h3>The Updates View</h3>
670 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
671 : vlad 1.6 The Updates view allows you to manage the remote sites you can install
672 :     from to search for features as well as features you can install. <br>
673 : vlad 1.5 </p>
674 :     <blockquote><img border="0" width="251" height="249" id="_x0000_i1030" src="images%5Cpic007.gif" alt="Updates View">
675 : celek 1.4 </blockquote>
676 : vlad 1.5 <h4>My Computer</h4>
677 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
678 : vlad 1.6 My Computer lets you browse your computer and any mounted local file to
679 :     discover any site on your file system. You can also search My Computer to
680 :     discover sites: see <a href="http://www.eclipse.org">Search the file system</a>
681 :     .</p>
682 : vlad 1.5 <h4>Places to Visit</h4>
683 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
684 : vlad 1.6 Places to visit are sites suggested by the features you installed for
685 :     you to visit. </p>
686 : vlad 1.5 <h4>Available Updates</h4>
687 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
688 : vlad 1.6 Available Updates will let you search for updates of already installed
689 :     features. The search occurs in the background so you can still use the workbench
690 :     while searching for updates. To know more about searching: see <a href="http://www.eclipse.org">
691 :     Search</a>
692 :     .</p>
693 : vlad 1.5 <h4>Sites Bookmark</h4>
694 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
695 : vlad 1.6 A site is a location that contains features. In the Updates View, the
696 :     sites contain features you can install. You can browse or search features
697 :     in Site bookmarks. There are two ways of adding a site bookmark. You can
698 :     use the context menu and the context action add site bookmarks, or you may
699 :     browse My Computer and add a site as a site bookmark. See <a href="http://www.eclipse.org">
700 :     Context Action</a>
701 :     for more details. </p>
702 : vlad 1.5 <h4>Search</h4>
703 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
704 : vlad 1.6 Search is a bookmark for a specific query that will retrieve features
705 :     from update sites. You can create a new specific query based on a template
706 :     or execute the query to fetch the features from the desired update sites.
707 :     You can also query your local file system. The resulting features appear
708 :     on the same search preview than the query. To know more about how to create
709 :     your own query: see <a href="http://www.eclipse.org">Context Action [new-&gt;Search]</a>
710 :     . To know how to search the file system: see <a href="http://www.eclipse.org">
711 :     Search the file system</a>
712 :     . To search for available updates: see <a href="http://www.eclipse.org">
713 :     Update Already Existing Features</a>
714 :     . To search for new features: see <a href="http://www.eclipse.org">Finding
715 :     New Features</a>
716 :     . To know more about the search Preview View: see <a href="http://www.eclipse.org">
717 :     Search Preview View</a>
718 :     .</p>
719 : vlad 1.5 <h4>Folder</h4>
720 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
721 : vlad 1.6 Folders are placeholders in the Updates View. They are used to help you
722 :     categorize and organize the view. Folders can contain folders, update sites
723 :     and/or searches. You can change the label of a folder. To know more about
724 :     how to create a folder see: <a href="http://www.eclipse.org">Context Action
725 :     [new-&gt;folder]</a>
726 :     .</p>
727 : vlad 1.5 <h4>Local View Toolbar Actions</h4>
728 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
729 : vlad 1.6 This section describes the local view toolbar actions of the Updates View.</p>
730 : vlad 1.5 <h5>Show Feature Categories </h5>
731 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
732 : vlad 1.6 When this action is selected, you will see the features organized in categories.<br>
733 : vlad 1.5 </p>
734 :     <blockquote><img border="0" width="253" height="193" id="_x0000_i1054" src="images%5Cpic008.gif" alt="Categories">
735 :     <br>
736 : celek 1.4 </blockquote>
737 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
738 : vlad 1.6 When this action is not selected, you will see all the features as a list.<br>
739 : vlad 1.5 </p>
740 :     <blockquote><img border="0" width="253" height="97" id="_x0000_i1032" src="images%5Cpic008b.gif" alt="No Categories">
741 : celek 1.4 </blockquote>
742 : vlad 1.5 <h5>Show My Computer Files </h5>
743 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
744 : vlad 1.6 When this action is selected, you will be able to browse the files when
745 :     you expand MyComputer.<br>
746 : vlad 1.5 </p>
747 :     <blockquote><img border="0" width="251" height="249" id="_x0000_i1033" src="images%5Cpic009.gif" alt="Browse Files">
748 : celek 1.4 </blockquote>
749 : vlad 1.5 <h4>Context Actions</h4>
750 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
751 : vlad 1.6 This section describes the different context actions available in the
752 :     Updates View. </p>
753 : vlad 1.5 <h5>New-&gt;Site Bookmark...</h5>
754 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
755 : vlad 1.6 Creates a new Site bookmark. This opens a Dialog box that presents the
756 :     properties of the Bookmark Site you want to create. The properties of a Bookmark
757 :     Site are the label you want to see in the View as well as the Address of
758 :     the physical site. You have to enter the Site URL. Optionally you can enter
759 :     the Site Name. If you o not enter a Site Name, it will default to the Site
760 :     URL. Click Ok when you have finished and you want to preserve your changes
761 :     or click Cancel if you do not want to create a new Site Bookmark.</p>
762 : vlad 1.5 <h5>New-&gt;Folder</h5>
763 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
764 : vlad 1.6 This action lets you create a new Folder. When you select this action,
765 :     a dialog will open.<br>
766 : celek 1.4 </p>
767 : vlad 1.5 <blockquote>
768 :     <div align="Left"><img border="0" width="438" height="481" id="_x0000_i1034" src="images%5Cpic011.gif" alt="New Folder Dialog">
769 :     <br>
770 :     </div>
771 : celek 1.4 </blockquote>
772 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
773 : vlad 1.6 Type the label of the folder in the 'Name;' entry field.<br>
774 :     Type the name of the parent folder in the 'Create in:' entry field, or
775 :     select it in the 'Existing folders:' tree view. If no parent is selected,
776 :     the newly created folder will appear in the updates view as a root folder.<br>
777 : vlad 1.5 </p>
778 :     <blockquote><img border="0" width="251" height="249" id="_x0000_i1035" src="images%5Cpic010.gif" alt="folders">
779 :     <img border="0" width="32" height="32" id="_x0000_i1036" src="pic010.gif" alt="folders">
780 : celek 1.4 </blockquote>
781 : vlad 1.5 <h5>New-&gt;Search</h5>
782 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
783 : vlad 1.6 This action will create a new Search. It will open a dialog window. Enter
784 :     the name of the search you desire in Name. Select the folder you want the
785 :     Search to appear in by selecting the appropriate folder under the existing
786 :     folders tree or by typing its name in the Create in entry field. Open the
787 :     Category combo box and select the search you want. You can change the category
788 :     of a search after it has been created: see <a href="http://www.eclipse.org">
789 :     Search Preview View</a>
790 :     . Click finish to close the dialog and create the search or click Cancel
791 :     to close the dialog and abort the creation. To know more about the different
792 :     type of search: see <a href="http://www.eclipse.org">Searching New Features</a>
793 :     .</p>
794 : vlad 1.5 <h5>Show Details</h5>
795 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
796 : vlad 1.6 This action opens or refreshes the Preview View with the details of the
797 :     selected element.</p>
798 : vlad 1.5 <h5>Refresh</h5>
799 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
800 : vlad 1.6 This action re-initializes the content of an element &lt;TODO see dejan&gt;</p>
801 : vlad 1.5 <h5>Bookmark Location</h5>
802 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
803 : vlad 1.6 This action lets you create bookmark site for a site found on your local
804 :     file system. This opens a Dialog box that presents the properties of the
805 :     selected site. The properties of a Site are the label you want to see in the
806 :     View as well as the Address of the site. You are able to change the Site Name.
807 : vlad 1.5 Click Ok when you have finished and you want to preserve your changes or
808 :     click Cancel if you do not want to change the properties.</p>
809 :     <h5>Properties</h5>
810 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
811 : vlad 1.6 This action opens a Dialog box that presents the properties of the selected
812 :     site. The properties of a Site are the label you want to see in the View
813 :     as well as the Address of the site. If the element you selected was a bookmark,
814 :     you are able to change both the Site Name and the Site Address of the site.
815 :     If you change the Site Address of a Bookmark Site you will need to 'refresh'
816 :     the Bookmark Site to access its new content. Click Ok when you have finished
817 :     and you want to preserve your changes or click Cancel if you do not want
818 :     to change the properties.</p>
819 : vlad 1.5 <h5>Delete</h5>
820 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
821 : vlad 1.6 This action removes the Bookmark Site from the workbench. This does not
822 :     erase the content of the Site nor the physical remote or local Site itself.</p>
823 : vlad 1.5 <h3>The WebView</h3>
824 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
825 : vlad 1.6 The Web View is &lt;TODO &gt;</p>
826 : vlad 1.5 <h3>The flat concept (see Dejan)</h3>
827 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
828 : vlad 1.6 &lt;TODO&gt;</p>
829 : vlad 1.5 <h3>The Preview View</h3>
830 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
831 : vlad 1.6 The preview shows information about the selected element. The preview
832 :     view is different for each selected element.</p>
833 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
834 : vlad 1.6 You can open the preview view by either selecting an element in the updates
835 :     or Configuration view, by opening a context menu on any element in the Updates
836 :     or Configuration View and selecting Show Details or by open the Preview View
837 :     from the Workbench menu. Select Window-&gt;Show View-&gt;Other to open the
838 :     list of available Views. Expand Update Manager Folder, select Preview and
839 :     Click Ok.</p>
840 : vlad 1.5 <h4>The 'Home' Preview view.</h4>
841 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
842 : vlad 1.6 You can open the 'Home' Preview by clicking on the home in the local tool
843 :     bar menu if the View. This view summarizes the different tasks you can achieve
844 :     through the Install/Update. By using the flat concept you are able to &lt;TODO
845 :     dejan&gt;</p>
846 : vlad 1.5 <p class="MsoNormal" align="Center" style="margin-right: 0.5in; margin-left: 0.5in; text-align: center; "><img border="0" width="507" height="503" id="_x0000_i1037" src="images%5Cpic012.gif" alt="Home Preview">
847 :     </p>
848 :     <h4>The current configuration Preview view</h4>
849 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
850 : vlad 1.6 This Preview shows information about the product you are using. The content
851 :     of the view depends on the product you launched. </p>
852 : vlad 1.5 <p class="MsoNormal" align="Center" style="margin-right: 0.5in; margin-left: 0.5in; text-align: center; "><img border="0" width="507" height="503" id="_x0000_i1038" src="images%5Cpic012b.gif" alt="product preview">
853 :     </p>
854 :     <h4>The Site and Site Bookmark Preview View</h4>
855 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
856 : vlad 1.6 This Preview shows the Site Address of the selected Site or Bookmark Site.</p>
857 : vlad 1.5 <p class="MsoNormal" align="Center" style="margin-right: 0.5in; margin-left: 0.5in; text-align: center; "><img border="0" width="507" height="503" id="_x0000_i1039" src="images%5Cpic012c.gif" alt="Site Preview">
858 :     </p>
859 :     <h4>The Feature Preview View</h4>
860 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
861 : vlad 1.6 This Preview View shows information about a feature.</p>
862 : vlad 1.5 <p class="MsoNormal" align="Center" style="margin-right: 0.5in; margin-left: 0.5in; text-align: center; "><img border="0" width="507" height="669" id="_x0000_i1040" src="images%5Cpic012d.gif" alt="Feature Preview">
863 :     </p>
864 :     <h5>Provider</h5>
865 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
866 : vlad 1.6 The name of the provider of the feature.</p>
867 : vlad 1.5 <h5>Version</h5>
868 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
869 : vlad 1.6 The version of the feature.</p>
870 : vlad 1.5 <h5>Installed Version</h5>
871 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
872 : vlad 1.6 The list of already installed version of this feature or 'Not Installed'
873 :     if no version of this feature has been configured in the current configuration.</p>
874 : vlad 1.5 <h5>Download Size</h5>
875 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
876 : vlad 1.6 The maximum download size for the feature. If the site you will install
877 :     the feature in already contains some of the files the feature require, the
878 :     files will not be installed twice, and thus the downloaded and installed
879 : vlad 1.5 size will be smaller than the maximum one.</p>
880 :     <h5>Supported Platforms</h5>
881 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
882 : vlad 1.6 This expandable category shows the different supported platforms for this
883 :     feature. The categories are Operating Systems, Windowing Systems, Architectures
884 :     and Languages.</p>
885 : vlad 1.5 <ul type="Disc">
886 :     <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
887 :     mso-list:l9 level1 lfo11;tab-stops:list .5in">
888 : vlad 1.6 Operating Systems: the list of supported Operating Systems.</li>
889 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
890 :     mso-list:l9 level1 lfo11;tab-stops:list .5in">
891 : vlad 1.6 Windowing Systems: the list of supported Windowing Systems.</li>
892 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
893 :     mso-list:l9 level1 lfo11;tab-stops:list .5in">
894 : vlad 1.6 Supported Architectures: the list of supported processor architecture.</li>
895 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
896 :     mso-list:l9 level1 lfo11;tab-stops:list .5in">
897 : vlad 1.6 Supported Languages: the list of supported languages.</li>
898 : vlad 1.5 </ul>
899 :     <h5>Description </h5>
900 :     <p class="MsoNormal" style="margin-bottom: 12pt; ">The
901 :     description of the Feature</p>
902 :     <h5>More Info </h5>
903 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
904 : vlad 1.6 Opens a page with more information about the feature. The page may be
905 :     found locally or remotely.</p>
906 : vlad 1.5 <h5>License</h5>
907 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
908 : vlad 1.6 Opens a page with the license of the Feature.</p>
909 : vlad 1.5 <h5>Copyright</h5>
910 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
911 : vlad 1.6 Opens a page with the copyright of the Feature.</p>
912 : vlad 1.5 <h5>Actions</h5>
913 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
914 : vlad 1.6 In the lower left side of the Preview View for a feature you may see one
915 :     or multiple buttons. They provide you with actions you can take on the Feature
916 :     depending of its configuration. If a change is pending for this feature,
917 :     no actions will be available until the workbench is restarted.</p>
918 : vlad 1.5 <ul type="Disc">
919 :     <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
920 :     mso-list:l5 level1 lfo12;tab-stops:list .5in">
921 : vlad 1.6 Install: this launches the Install Wizard for this feature. See <a href="http://www.eclipse.org">
922 :     Installing a Feature</a>
923 :     .</li>
924 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
925 :     mso-list:l5 level1 lfo12;tab-stops:list .5in">
926 : vlad 1.6 Unconfigure: this launches the Unconfigure Wizard for this configured
927 :     feature. See <a href="http://www.eclipse.org">Configuring/Unconfiguring a
928 :     Feature</a>
929 :     .<br>
930 :     Configure: this launches the Configure Wizard for this unconfigured
931 :     feature. See <a href="http://www.eclipse.org">Configuring/Unconfiguring
932 :     a Feature</a>
933 :     .<br>
934 :     Uninstall: this removes the unconfigure feature from the file system.
935 :     See <a href="http://www.eclipse.org">Removing a Feature</a>
936 :     .</li>
937 : vlad 1.5 </ul>
938 :     <h4>The Configuration Preview View</h4>
939 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
940 : vlad 1.6 This preview shows information about the select configuration.</p>
941 : vlad 1.5 <p class="MsoNormal" align="Center" style="margin-right: 0.5in; margin-left: 0.5in; text-align: center; "><img border="0" width="621" height="488" id="_x0000_i1041" src="images%5Cpic013.gif" alt="Configuration Preview">
942 :     </p>
943 :     <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p>
944 :     <h5>Created On</h5>
945 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
946 : vlad 1.6 The date in the current locale, the configuration was created on.</p>
947 : vlad 1.5 <h5>Current Configuration</h5>
948 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
949 : vlad 1.6 If the selected configuration is the active configuration.</p>
950 : vlad 1.5 <h5>Activities</h5>
951 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
952 : vlad 1.6 List of activities that led to the creation of the configuration. For
953 :     more information about the different activities, see <a href="http://www.eclipse.org">
954 :     Activities</a>
955 :     .</p>
956 : vlad 1.5 <h5>Configuration Reversal</h5>
957 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
958 : vlad 1.6 In the lower left side of the Preview View for a configuration you may
959 :     see one button. It provides you with actions you can take on the Configuration
960 :     depending if it is the current configuration or another one. If a change
961 :     is pending for a feature, no actions will be available until the workbench
962 :     is restarted.</p>
963 : vlad 1.5 <ul type="Disc">
964 :     <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
965 :     mso-list:l6 level1 lfo13;tab-stops:list .5in">
966 : vlad 1.6 Restore: this restores the selected configuration. See <a href="http://www.eclipse.org">
967 :     Restore a Configuration/Revert to previous configuration</a>
968 :     .</li>
969 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
970 :     mso-list:l6 level1 lfo13;tab-stops:list .5in">
971 : vlad 1.6 Revert: this revert the current configuration to the previous configuration.
972 :     See <a href="http://www.eclipse.org">Restore a Configuration/Revert to previous
973 :     configuration</a>
974 :     .</li>
975 : vlad 1.5 </ul>
976 :     <h4>The search Preview View</h4>
977 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
978 : vlad 1.6 This view allows you to change the search query, enter the appropriate
979 :     settings for the query, set the scope of the search, run the query and see
980 :     the result of the query. The settings are different for each query.</p>
981 : vlad 1.5 <h5>Change the query</h5>
982 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
983 : vlad 1.6 To change the category of the query, expand Query Settings. Expand the
984 :     Search Category Settings and select the desired search category.</p>
985 : vlad 1.5 <h5>Enter the settings</h5>
986 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
987 : vlad 1.6 Each category has its own settings. For more information about the different
988 :     settings for a category: see <a href="http://www.eclipse.org">Searching New
989 :     Features</a>
990 :     .</p>
991 : vlad 1.5 <h5>Set the scope</h5>
992 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
993 : vlad 1.6 To change the scope of the search, expand Scope Settings. You can select
994 :     to search the local file system, the discovery sites in 'places to visit'
995 :     and/or the bookmarked sites you created. When searching the local file system,
996 :     click Settings to select which root folder will be searched.</p>
997 : vlad 1.5 <h5>Run the query</h5>
998 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
999 : vlad 1.6 Click Search Now to run the query.</p>
1000 : vlad 1.5 <h5>See the results</h5>
1001 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1002 : vlad 1.6 The result will appear at the bottom of the View. Select Show Results
1003 :     in Extended Form to have more information about the features.</p>
1004 : vlad 1.5 <h3>The Install/Update Preference Page</h3>
1005 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1006 : vlad 1.6 You can open the preference page from the Workbench main menu. Click Window-&gt;preferences
1007 :     to open the Preference Dialog. Select Install/Update to reveal the Install/Update
1008 :     preference Page. In this page, you can modify the number of history configuration
1009 :     you want the workbench to manage as well as decide which browser to open.</p>
1010 : vlad 1.5 <h4>Maximum number of 'History' configurations entry field.</h4>
1011 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1012 : vlad 1.6 Enter the number of history configurations you want the Install/Update
1013 :     to keep. See <a href="http://www.eclipse.org">Configuration History</a>
1014 :     for more information.</p>
1015 : vlad 1.5 <h4>Web Links radio buttons.</h4>
1016 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1017 : vlad 1.6 When opening Web links. It allows you to choose between opening the internal
1018 :     WebView and opening an external browser.</p>
1019 : vlad 1.5 <h2>Finding features</h2>
1020 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1021 : vlad 1.6 This section will explain how to find the features to install. There are
1022 :     different way of looking for features; you may know exactly which feature
1023 :     you need and where it is located, or you may want to search for an update
1024 :     of an already installed feature is available, finally you may just decide
1025 :     to browse or search to discover new sites and new features. </p>
1026 : vlad 1.5 <h3>Find a specific feature </h3>
1027 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1028 : vlad 1.6 This section will focus on finding a feature when you know exactly where
1029 :     to find it. To find a feature you may either add the Update Site that contains
1030 :     this feature and browse the site to find the feature, or open the WebView
1031 :     and browse to the Feature WebPage.</p>
1032 : vlad 1.5 <h4>Add a new Update Site </h4>
1033 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1034 : vlad 1.6 To add a new Update site, open the context Menu in the Updates View and
1035 :     select New-&gt;Site Bookmark.... This opens a Dialog box that presents
1036 :     the properties of the Bookmark Site you want to create. The properties of
1037 :     a Bookmark Site are the label you want to see in the View as well as the
1038 :     URL of the physical site. You have to enter the Site URL. Optionally you
1039 :     can enter the Site Name. If you do not enter a Site Name, it will default
1040 :     to the Site URL. Click Ok when you have finished and you want to preserve
1041 :     your changes or click Cancel if you do not want to create a new Site Bookmark.
1042 :     </p>
1043 : vlad 1.5 <h4>Find the feature </h4>
1044 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1045 : vlad 1.6 Expand the site to find the feature you want. You can find the feature
1046 :     by looking at the label or selecting a feature and reading the preview view.
1047 :     To know more about preview view: See <a href="http://www.eclipse.org">Preview
1048 :     View</a>
1049 :     .</p>
1050 : vlad 1.5 <h4>Browse WebPages </h4>
1051 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1052 : vlad 1.6 Open the <a href="http://www.eclipse.org">WebView</a>
1053 :     and enter the URL for the feature web page. Follow the indication of
1054 :     the web page. &lt;TODO web install&gt;</p>
1055 : vlad 1.5 <h3>Update already existing features</h3>
1056 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1057 : vlad 1.6 This section will focus on updating features that are configured in your
1058 :     current configuration. To know how to configure/unconfigure a feature: see:
1059 :     <a href="http://www.eclipse.org">Configuring/Unconfiguring</a>
1060 :     .</p>
1061 : vlad 1.5 <h4>Search for updates</h4>
1062 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1063 : vlad 1.6 To search for available updates, select Available Updates in the Updates
1064 :     View. In the preview view, press Search now. This will search the site the
1065 :     configured feature come from for new version the installed and configured
1066 :     feature. During the search you will see the progress monitor move, indicating
1067 :     the search is in progress. When new version of configured features are found,
1068 :     they will appear under the progress monitor. You can decide to see the result
1069 :     in a short form or an extended form by checking the 'Show results in extended
1070 :     form' box, under the Scope Settings section in the preview view.</p>
1071 : vlad 1.5 <h4>Search the file system</h4>
1072 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1073 : vlad 1.6 You can decide to search the file system for updates by checking the 'Include
1074 :     my computer in the search' box, under the Scope Settings section in the preview
1075 :     view. Click on the Settings... button to customize which part of the file
1076 :     system you want to search.</p>
1077 : vlad 1.5 <h4>Customize Search</h4>
1078 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1079 : vlad 1.6 You can customize the search for updates by creating a new search. To
1080 :     know how to create a new search: see <a href="http://www.eclipse.org">Updates
1081 :     View: Context Action [new-&gt;search]</a>
1082 :     .</p>
1083 : vlad 1.5 <h3>Browse to discover</h3>
1084 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1085 : vlad 1.6 This section will focus on browsing update sites to find the features
1086 :     you want to install. The entire update site appears in the Updates View.
1087 :     There are different places in the view where you can find sites to browse.
1088 :     You may have sites in the folder 'Places to visit' or you may have sites
1089 :     on your file system. You can also add some update site if you know their
1090 :     URL.</p>
1091 : vlad 1.5 <h4>Browse already existing sites</h4>
1092 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1093 : vlad 1.6 If you expand the folder 'Places to visit' you may see some sites. They
1094 :     were automatically added to the folder by the feature you installed. You
1095 : vlad 1.5 can expand the site and browse the features.</p>
1096 :     <h4>Browse the file system</h4>
1097 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1098 : vlad 1.6 To browse the file system, expand 'My Computer'. &lt;TODO what more to
1099 :     say?&gt;</p>
1100 : vlad 1.5 <h4>Add a new Update Site </h4>
1101 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1102 : vlad 1.6 You can add a new update site from the context menu. Select new-&gt;Site
1103 :     Bookmark... This opens a Dialog box that presents the properties of the Bookmark
1104 :     Site you want to create. The properties of a Bookmark Site are the label
1105 :     you want to see in the View as well as the Address of the physical site.
1106 :     You have to enter the Site URL. Optionally you can enter the Site Name. If
1107 :     you do not enter a Site Name, it will default to the Site URL. Click Ok when
1108 :     you have finished and you want to preserve your changes or click Cancel if
1109 :     you do not want to create a new Site Bookmark. Once the site has been created,
1110 :     expand the icon to see the categories and or the available features.</p>
1111 : vlad 1.5 <h4>Add a bookmark of a file system site.</h4>
1112 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1113 : vlad 1.6 When you browse the file system, you can add a file system site as a bookmark.
1114 :     Select the site. Open the context menu. Select 'Bookmark Location'. This
1115 :     action lets you create bookmark site for a site found on your local file
1116 :     system. This opens a Dialog box that presents the properties of the selected
1117 :     site. The properties of a Site are the label you want to see in the View as
1118 :     well as the Address of the site. You are able to change the Site Name. Click
1119 :     Ok when you have finished and you want to preserve your changes or click
1120 :     Cancel if you do not want to change the properties. Once the site has been
1121 :     created, expand the icon to see the categories and or the available features.</p>
1122 : vlad 1.5 <h3>Searching Features</h3>
1123 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1124 : vlad 1.6 This section will explain how to find features by using the search mechanism.
1125 :     It will first focus on finding update of configured features, then it will
1126 :     explain how to search the file system, finally it will expose how to customize
1127 :     a search by presenting the three default search categories.</p>
1128 : vlad 1.5 <h4>Search for updates</h4>
1129 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1130 : vlad 1.6 To search for available updates, select Available Updates in the Updates
1131 :     View. In the preview view, press Search now. This will search the site the
1132 :     configured features come from for new versions. During the search you will
1133 :     see the progress monitor move, indicating the search is in progress. When
1134 :     new version of configured features are found, they will appear under the
1135 :     progress monitor. You can decide to see the result in a short form or an
1136 :     extended form by checking the 'Show results in extended form' box, under the
1137 :     Scope Settings section in the preview view.</p>
1138 : vlad 1.5 <h4>Search the file system</h4>
1139 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1140 : vlad 1.6 You can decide to search the file system for updates by checking the 'Include
1141 :     my computer in the search' box, under the Scope Settings section in the preview
1142 :     view. Click on the Settings... button to customize which part of the file
1143 :     system you want to search.</p>
1144 : vlad 1.5 <h4>Customize Search</h4>
1145 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1146 : vlad 1.6 Three default categories of search are provided: Search for available
1147 :     updates, search features based on regular expression and search features
1148 :     that contain a specific plugin. You may see other categories. Check the
1149 :     user documentation of the features that provide the extra categories to
1150 :     learn more about them.</p>
1151 : vlad 1.5 <h5>Available Updates</h5>
1152 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1153 : vlad 1.6 This search attempts to find update of configured features. There are
1154 :     no special settings to fill when running this query. The query will find
1155 :     all new version of configured features based on the search scope. To know
1156 :     more about the scope of the search: see <a href="http://www.eclipse.org">
1157 :     Search Preview View</a>
1158 :     .</p>
1159 : vlad 1.5 <h5>Regular Expression</h5>
1160 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1161 : vlad 1.6 This search attempts to find features based on a simple regular expression
1162 :     query. You must change the settings of the query before running it. Select
1163 :     the query in the Updates View. In the preview view, expand Query Settings.</p>
1164 : vlad 1.5 <ul type="Disc">
1165 :     <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
1166 :     mso-list:l7 level1 lfo14;tab-stops:list .5in">
1167 : vlad 1.6 Type the string you want to search for in the Expression Entry Field.</li>
1168 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
1169 :     mso-list:l7 level1 lfo14;tab-stops:list .5in">
1170 : vlad 1.6 Check the check box if you want the search to be case sensitive.
1171 :     A case sensitive search will consider Uppercase and Lowercase character
1172 :     as different.</li>
1173 : vlad 1.5 <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
1174 :     mso-list:l7 level1 lfo14;tab-stops:list .5in">
1175 : vlad 1.6 Selection where you want the search to occur by checking Feature
1176 :     Name, Feature Provider and/or Feature Description.</li>
1177 : vlad 1.5 </ul>
1178 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1179 : vlad 1.6 The query will find the features that match the query based on the scope.
1180 :     To know more about the scope of the search: see <a href="http://www.eclipse.org">
1181 :     Search Preview View</a>
1182 :     .</p>
1183 : vlad 1.5 <h5>Plug-ins</h5>
1184 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1185 : vlad 1.6 This search attempts to find feature that contain a specific plug-in.
1186 :     You must change the settings of the query before running it. Select the
1187 :     query in the Updates View. In the preview view, expand Query Settings.</p>
1188 : vlad 1.5 <ul type="Disc">
1189 :     <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
1190 :     mso-list:l8 level1 lfo15;tab-stops:list .5in">
1191 : vlad 1.6 Click New to add a specific plug-in. &lt;TODO doesn't work in 0423&gt;</li>
1192 : vlad 1.5 </ul>
1193 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1194 : vlad 1.6 The query will find the features that match the query based on the scope.
1195 :     To know more about the scope of the search: see <a href="http://www.eclipse.org">
1196 :     Search Preview View</a>
1197 :     .</p>
1198 : vlad 1.5 <h2>Installing a Feature</h2>
1199 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1200 : vlad 1.6 This section will describe the Wizard used to install, configure, unconfigure
1201 :     and remove a feature as well as the verification task that may occur when
1202 :     installing a new feature. The first part will focus on the three tab that
1203 :     are part of the Wizard, while the second part will deal with verification
1204 :     and security issues when installing a feature.</p>
1205 : vlad 1.5 <h3>Install Wizard</h3>
1206 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1207 : vlad 1.6 The Wizard will help you install, configure, unconfigure and remove a
1208 :     feature. It will allow you to review any license agreement and to choose
1209 :     the Site in which you wish to install the feature.</p>
1210 : vlad 1.5 <h4>The Preview Tab</h4>
1211 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1212 : vlad 1.6 This tab summarizes the action you are going to take. </p>
1213 : vlad 1.5 <div align="Center">
1214 : vlad 1.6 <p class="MsoNormal"><img border="0" width="500" height="500" id="_x0000_i1042" src="images%5Cpic002.gif" alt="Install Wizard Preview Tab pic002.gif">
1215 : vlad 1.5 </p>
1216 :     </div>
1217 :     <h4> The License Tab</h4>
1218 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1219 : vlad 1.6 This tab will present you the license you have to agree with to install
1220 :     the product. Click on agree if you agree with the whole license and whish
1221 :     to continue or click cancel to abort the installation</p>
1222 : vlad 1.5 <h4>Site location Tab</h4>
1223 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1224 : vlad 1.6 This tab has three main goals. The first one is to show you the available
1225 :     sites on your local file system, the second is the ability to create a new
1226 :     site if the one proposed are not satisfactory, finally you will be able to
1227 :     see the space left on the selected site and the size in kilobyte of the feature
1228 :     you are about to install.</p>
1229 : vlad 1.5 <h4>Verification </h4>
1230 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1231 : vlad 1.6 Verification is an important part of the install process. It will allow
1232 :     you to verify if the feature you are about to install has been digitally
1233 : vlad 1.5 signed, not digitally signed or tempered with. When a feature or a file has
1234 :     been digitally signed, you will be able to see the certificate used to sign
1235 :     the feature. A certificate will contain information about the entity that
1236 :     signed the feature, and information about the entity that authenticated the
1237 :     first entity. If the entity authenticated itself, you will only see one entity.</p>
1238 :     <h5>Signed</h5>
1239 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1240 : vlad 1.6 A dialog with the following will appear if the feature or one of its files
1241 :     has been signed. A signed feature means the signer has digitally signed the
1242 :     file, and the authenticator has authenticated the signer.</p>
1243 : vlad 1.5 <blockquote>
1244 :     <p class="MsoNormal"><img border="0" width="251" height="85" id="_x0000_i1043" src="images%5Cpic018.gif" alt="Signed Feature">
1245 :     </p>
1246 :     </blockquote>
1247 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1248 : vlad 1.6 The authenticator can be the same entity as the signer, in which case
1249 :     you will see such a dialog. You have to be very careful with self-signed
1250 :     certificate, as the authentication of the signer cannot be verified.</p>
1251 : vlad 1.5 <blockquote>
1252 :     <p class="MsoNormal"><img border="0" width="600" height="189" id="_x0000_i1044" src="images%5Cpic019.gif" alt="Self Sigend Certificate">
1253 :     </p>
1254 :     </blockquote>
1255 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1256 : vlad 1.6 In some cases, the authenticator is a different entity than the signer.<br>
1257 :     If you do not authorize the authenticator, you will see such a dialog.
1258 :     You have to be very careful with signed certificate you didn't authorize,
1259 :     as the authenticator of the certificate is not one of the worldwide known
1260 :     authenticator.</p>
1261 : vlad 1.5 <blockquote>
1262 :     <p class="MsoNormal"><img border="0" width="600" height="234" id="_x0000_i1045" src="images%5Cpic020.gif" alt="Root not trusted">
1263 :     </p>
1264 :     </blockquote>
1265 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1266 : vlad 1.6 If the signature of the authenticator has been authorized before, you
1267 :     will see such a dialog &lt;PICTURE&gt;. You have to be careful with signed
1268 :     certificate you authorized, as the authenticator of the certificate only
1269 :     validates that the signer has been authenticated. It does not provide any
1270 :     guarantee as to the feature you are going to install. Only install if you
1271 :     trust the signer.</p>
1272 : vlad 1.5 <blockquote>
1273 :     <p class="MsoNormal"><img border="0" width="600" height="265" id="_x0000_i1046" src="images%5Cpic021.gif" alt="Root Trusted">
1274 :     </p>
1275 :     </blockquote>
1276 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1277 : vlad 1.6 Click continue or install only if you trust the signer of the feature
1278 :     file and you want to install the feature, or click cancel if you want to
1279 :     abort the installation.<br>
1280 : vlad 1.5 <br>
1281 : vlad 1.6 To learn more about how to authorize an authenticator: see <a href="http://www.eclipse.org">
1282 :     Security and Keystore Management</a>
1283 :     .</p>
1284 : vlad 1.5 <h5>Non Signed</h5>
1285 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1286 : vlad 1.6 A dialog like the following will appear if the feature or one of its files
1287 :     has not been signed.</p>
1288 : vlad 1.5 <blockquote>
1289 :     <p class="MsoNormal"><img border="0" width="289" height="84" id="_x0000_i1047" src="images%5Cpic016.gif" alt="Non Signed Feature">
1290 :     </p>
1291 : celek 1.4 </blockquote>
1292 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1293 : vlad 1.6 When a feature has not been signed, we cannot authenticate the sender
1294 :     of the package, nor can we certify the validity of any of the file. Click
1295 :     continue or install only if you want to install the feature, or click cancel
1296 :     if you want to abort the installation.</p>
1297 : vlad 1.5 <h5>Corrupted </h5>
1298 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1299 : vlad 1.6 If the content of a feature has changed since it has been signed, you
1300 :     will see such a dialog.</p>
1301 : vlad 1.5 <blockquote>
1302 :     <p class="MsoNormal"><img border="0" width="599" height="187" id="_x0000_i1048" src="images%5Cpic017.gif" alt="Corrupted Feature">
1303 :     </p>
1304 :     </blockquote>
1305 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1306 : vlad 1.6 This means the content has been tempered with since the feature has been
1307 :     signed. The content of the feature has been changed since it has been packaged.
1308 :     You should notify the signer of the package. Install/Update will prevent
1309 :     you from installing such a feature. Click cancel if you want to abort the
1310 :     installation and contact the provider of the feature and/or the site. </p>
1311 : vlad 1.5 <h5>Persistence of the answer</h5>
1312 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1313 : vlad 1.6 If click continue or install on a verification dialog, the Install/Update
1314 :     component will remember your action and will not prompt you again if one
1315 :     of the file of the feature is about to show the exact same verification dialog.
1316 :     </p>
1317 : vlad 1.5 <h2>Configuring/Unconfiguring a Feature</h2>
1318 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1319 : vlad 1.6 This section will focus on configuring and unconfiguring the feature you
1320 :     can manage in your current configuration. A configuration is a list of configured
1321 :     and unconfigured features that determine what tool are available for you
1322 :     to use in your workspace. To know more about configuration see: <a href="http://www.eclipse.org">
1323 :     Configuration</a>
1324 :     .</p>
1325 : vlad 1.5 <h3>Checking if a feature is configured or
1326 :     unconfigured.</h3>
1327 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1328 : vlad 1.6 Feature you installed appear in the Configuration View. Expand the Current
1329 :     Configuration to see the configured sites. Expand the site to see the Features.
1330 :     Use the local view toolbar button to switch between configured features and
1331 :     all the features. Unconfigured features appear with such icon <img border="0" width="16" height="16" id="_x0000_i1049" src="images%5Cunconf_feature_obj.gif" alt="unconf_feature_obj.gif Unconfigured Feature">
1332 : vlad 1.5 </p>
1333 :     <h3>Configure/Unconfigure Wizard</h3>
1334 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1335 : vlad 1.6 The Wizard will help you configure or unconfigure a feature. </p>
1336 : vlad 1.5 <h4>Preview Tab</h4>
1337 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1338 : vlad 1.6 This tab summarizes the action you are going to take. </p>
1339 : vlad 1.5 <div align="Center">
1340 : vlad 1.6 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "><img border="0" width="500" height="500" id="_x0000_i1050" src="images%5Cpic003.gif" alt="pic003.gif Configure Wizard Preview Tab">
1341 : vlad 1.5 </p>
1342 :     </div>
1343 :     <h2>Configuration</h2>
1344 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1345 : vlad 1.6 A configuration is a list of configured and unconfigured features that
1346 :     determine what tool are available for you to use in your workspace. A configuration
1347 :     determines what task you can execute. There are three types of configurations:
1348 :     the current configuration, the history configuration and the preserved configuration.</p>
1349 : vlad 1.5 <h3>Current Configuration</h3>
1350 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1351 : vlad 1.6 The current configuration is the configuration currently active.</p>
1352 : vlad 1.5 <h3>Configuration History or Preserved Configuration</h3>
1353 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1354 : vlad 1.6 Configuration History are automatically created by the Install/Update
1355 :     as a snapshot of your current configuration at a certain time, before an
1356 :     activity occurs. Preserved Configuration are configuration in the History
1357 :     Configuration you want to persist.</p>
1358 : vlad 1.5 <h3>Configuration History</h3>
1359 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1360 : vlad 1.6 When you install a feature, the install/update component will copy your
1361 :     current configuration in the history configuration, and then install and
1362 : vlad 1.5 configure the feature in you current configuration. You will end up with
1363 :     two configurations, one without the feature installed and configured and
1364 :     one with the feature installed and configured. The install/update will also
1365 :     copy your current configuration when you install or remove a site, when you
1366 :     configure or unconfigure a feature or when reconciliation is needed. Each
1367 :     activity will be recorded in the configuration. For each configuration selected
1368 :     in the history configuration folder, you can see in the preview view the
1369 :     list of activities that were executed. See <a href="http://www.eclipse.org">
1370 : vlad 1.6 Activities </a>
1371 :     for more information about the different activities.</p>
1372 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1373 : vlad 1.6 The install/update will keep a certain number of configurations in the
1374 :     configuration history folder. After this number has been reached, if a new
1375 :     configuration is created, the oldest configuration inside Configuration History
1376 :     folder will be deleted. </p>
1377 : vlad 1.5 <h4>Renaming an history configuration</h4>
1378 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1379 : vlad 1.6 You can rename any configuration in the Configuration History folder.
1380 :     To change the label of a Configuration, select the configuration, open the
1381 :     context menu and click Properties. This will open a dialog where you can
1382 :     change the label of the selected configuration. Click Ok if you want to save
1383 :     the label or click cancel if you do not want to change the label of the
1384 :     configuration.</p>
1385 : vlad 1.5 <h4>Revert the current configuration to the
1386 : vlad 1.6 previous configuration</h4>
1387 : vlad 1.5 <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1388 : vlad 1.6 You can revert the current configuration to the previous configuration.
1389 :     This action behaves like an 'Undo' where you want to go back to the previous
1390 :     configuration.</p>
1391 : vlad 1.5 <h3> Preserved Configuration</h3>
1392 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1393 : vlad 1.6 Preserved Configurations are configurations of the Configuration History
1394 :     folder you want to Preserved because it represents a set of configured features
1395 :     for a certain task. (I.e. you may want to enable some features for Enterprise
1396 :     Java Bean Development, and have a configuration with some feature for front-end
1397 :     development). If you do not preserved a configuration, it will be deleted
1398 :     from the file system when the history maximum number is reached: see <a href="http://www.eclipse.org">
1399 :     Preference Page</a>
1400 :     . You should add to preserved configuration the configuration you want
1401 :     to quickly restore.</p>
1402 : vlad 1.5 <h4>Add a Configuration in the preserved folder</h4>
1403 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1404 : vlad 1.6 To add a configuration to the list of preserved configurations, select
1405 :     the configuration in the history configuration folder. Open the context menu;
1406 :     click 'add to preserved configuration'. </p>
1407 : vlad 1.5 <h4>Remove a Configuration in the preserved
1408 : vlad 1.6 folder </h4>
1409 : vlad 1.5 <p style="margin-right: 0.5in; margin-left: 0.5in; ">
1410 : vlad 1.6 To remove a preserved configuration from the list, select the preserved
1411 :     configuration. Open the context menu. Click Remove from preserved.</p>
1412 : vlad 1.5 <h4>Rename a Preserved Configuration</h4>
1413 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1414 : vlad 1.6 You can rename any configuration in the Preserved Configurations folder.
1415 :     To change the label of a Configuration, select the configuration, open the
1416 :     context menu and click Properties. This will open a dialog where you can
1417 :     change the label of the selected configuration. Click Ok if you want to save
1418 :     the label or click cancel if you do not want to change the label of the configuration.</p>
1419 : vlad 1.5 <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p>
1420 :     <h3>Restore a Configuration/Revert to previous
1421 : vlad 1.6 configuration</h3>
1422 : vlad 1.5 <p class="MsoNormal"> &lt;TODO&gt;</p>
1423 :     <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p>
1424 :     <h3>The Activities </h3>
1425 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1426 : vlad 1.6 Activities are tasks that are part of a configuration. Activities are
1427 :     the actions that were taken to create the Configuration. You can see activities
1428 :     in the preview view when you select a configuration.<br>
1429 : vlad 1.5 </p>
1430 :     <blockquote><img src="images%5Cpic014.gif" alt="activities" width="594" height="151">
1431 :     <br>
1432 :     </blockquote>
1433 :     <h5>Date</h5>
1434 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1435 : vlad 1.6 The date using the locale format ate which the action took place.</p>
1436 : vlad 1.5 <h5>Target</h5>
1437 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1438 : vlad 1.6 The identifier of the target of the action (see the different type of
1439 :     activities)</p>
1440 : vlad 1.5 <h5>Action</h5>
1441 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1442 : vlad 1.6 The label of the action (see the different types of activities)</p>
1443 : vlad 1.5 <h5>Status</h5>
1444 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1445 : vlad 1.6 The status of the action. Success if the action was successful.</p>
1446 : vlad 1.5 <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1447 : vlad 1.6 There are nine different actions that create an activity in a configuration.</p>
1448 : vlad 1.5 <h4>Feature Installed </h4>
1449 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1450 : vlad 1.6 When a new feature is installed in a configured site.<br>
1451 :     The target in the preview view is the identifier of the installed feature.</p>
1452 : vlad 1.5 <h4>Feature Removed</h4>
1453 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1454 : vlad 1.6 When a new feature is physically removed from a configured site.<br>
1455 :     The target in the preview view is the identifier of the removed feature.</p>
1456 : vlad 1.5 <h4>Site Installed</h4>
1457 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1458 : vlad 1.6 When a Site is added to the current configuration.</p>
1459 : vlad 1.5 <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1460 : vlad 1.6 The target in the preview view is the Address of the site</p>
1461 : vlad 1.5 <h4>Site Removed</h4>
1462 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1463 : vlad 1.6 When a Site is removed from the current configuration.</p>
1464 : vlad 1.5 <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1465 : vlad 1.6 The target in the preview view is the Address of the site</p>
1466 : vlad 1.5 <h4>Feature Configured</h4>
1467 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1468 : vlad 1.6 When a new feature is configured in a configured site.<br>
1469 :     The target in the preview view is the identifier of the configured feature.</p>
1470 : vlad 1.5 <h4>Feature Unconfigured</h4>
1471 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1472 : vlad 1.6 When a new feature is unconfigured in a configured site.<br>
1473 :     The target in the preview view is the identifier of the unconfigured
1474 :     feature.</p>
1475 : vlad 1.5 <h4>Revert to Configuration</h4>
1476 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1477 : vlad 1.6 When the user reverted to a configuration from either the configuration
1478 :     history or the preserved configuration</p>
1479 : vlad 1.5 <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1480 : vlad 1.6 The target in the preview view is the identifier of the configuration
1481 :     we reverted to.</p>
1482 : vlad 1.5 <h4>Reconciliation</h4>
1483 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1484 : vlad 1.6 When the Install/Update detected a changed occurred between the last shutdown
1485 :     and this startup.</p>
1486 : vlad 1.5 <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1487 : vlad 1.6 The URL of the file maintaining the overall configuration.</p>
1488 : vlad 1.5 <h4>Added to Preserved Configuration</h4>
1489 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1490 : vlad 1.6 When a configuration was added to the list of preserved configurations.</p>
1491 : vlad 1.5 <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1492 : vlad 1.6 The target in the preview view is the identifier of the configuration
1493 :     added to the preserved configurations.</p>
1494 : vlad 1.5 <h2>Removing a Feature</h2>
1495 :     <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; ">
1496 : vlad 1.6 This section explains how to physically remove an unconfigured feature
1497 :     from the file system. You can only remove unconfigured features. You know
1498 :     how to unconfigure a feature see: <a href="http://www.eclipse.org">Configure/Unconfigure
1499 :     Features</a>
1500 :     .</p>
1501 : vlad 1.5 <h3>Remove Wizard</h3>
1502 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1503 : vlad 1.6 This Wizard will help you uninstall an unconfigured feature.<br>
1504 :     To launch the wizard, select an unconfigured feature in your current
1505 :     configuration. See <a href="http://www.eclipse.org">Configure/Unconfigure</a>
1506 :     a feature to know how to unconfigure a configured feature, and if a feature
1507 :     is configured or not.</p>
1508 : vlad 1.5 <h4>Preview Tab</h4>
1509 :     <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">
1510 : vlad 1.6 This tab summarizes the action you are going to take.<br>
1511 : vlad 1.5 </p>
1512 :     <div align="Center"><img border="0" width="600" height="500" id="_x0000_i1052" src="images%5Cpic015.gif" alt="uninstall wizard">
1513 :     </div>
1514 :     <h2>Troubleshooting</h2>
1515 :     <p class="MsoNormal"> If the workbench
1516 : vlad 1.6 does not start after you installed a new feature.<br>
1517 :     The Install/Update views do not show anything.<br>
1518 :     I created a Site but nothing shows (verify URL)</p>
1519 : vlad 1.5 <h2>Advanced User</h2>
1520 :     <p class="MsoNormal"> Security and keystore
1521 : vlad 1.6 management.</p>
1522 : vlad 1.5 </div>
1523 :     </body>
1524 :     </html>