platform-update-home/doc/working/documentation/user guide.html
Parent Directory
| 
Revision Log
Revision 1.8 -
(download)
(as text)
(annotate)
Fri Apr 26 18:50:16 2002 UTC (7 years, 7 months ago) by vlad
Branch: MAIN
CVS Tags: v20050526, R3_0, R3_1, v20040514, R2_0, v20040219, HEAD
Changes since 1.7: +405 -405 lines
Fri Apr 26 18:50:16 2002 UTC (7 years, 7 months ago) by vlad
Branch: MAIN
CVS Tags: v20050526, R3_0, R3_1, v20040514, R2_0, v20040219, HEAD
Changes since 1.7: +405 -405 lines
*** empty log message ***
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <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"> <head> <meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> <meta name="ProgId" content="Word.Document"> <meta name="Generator" content="Microsoft Word 9"> <meta name="Originator" content="Microsoft Word 9"> <link rel="File-List" href="./user%20guide_files/filelist.xml"> <link rel="Edit-Time-Data" href="./user%20guide_files/editdata.mso"> <!--[if !mso]> <style> v\:* {behavior:url(#default#VML);} o\:* {behavior:url(#default#VML);} w\:* {behavior:url(#default#VML);} .shape {behavior:url(#default#VML);} </style> <![endif]--><!--[if gte mso 9]><xml> <o:DocumentProperties> <o:Author>Labuser</o:Author> <o:LastAuthor>Labuser</o:LastAuthor> <o:Revision>4</o:Revision> <o:TotalTime>40</o:TotalTime> <o:Created>2002-04-12T13:24:00Z</o:Created> <o:LastSaved>2002-04-26T18:30:00Z</o:LastSaved> <o:Pages>37</o:Pages> <o:Words>7006</o:Words> <o:Characters>39939</o:Characters> <o:Company>IBM Canada Ltd.</o:Company> <o:Lines>332</o:Lines> <o:Paragraphs>79</o:Paragraphs> <o:CharactersWithSpaces>49047</o:CharactersWithSpaces> <o:Version>9.4402</o:Version> </o:DocumentProperties> </xml><![endif]--><!--[if gte mso 9]><xml> <w:WordDocument> <w:View>Normal</w:View> </w:WordDocument> </xml><![endif]--> <style> <!-- /* Font Definitions */ @font-face {font-family:Wingdings; panose-1:5 0 0 0 0 0 0 0 0 0; mso-font-charset:2; mso-generic-font-family:auto; mso-font-pitch:variable; mso-font-signature:0 268435456 0 0 -2147483648 0;} /* Style Definitions */ p.MsoNormal, li.MsoNormal, div.MsoNormal {mso-style-parent:""; margin:0in; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";} a:link, span.MsoHyperlink {color:blue; text-decoration:underline; text-underline:single;} a:visited, span.MsoHyperlinkFollowed {color:blue; text-decoration:underline; text-underline:single;} p {font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";} @page Section1 {size:8.5in 11.0in; margin:1.0in 1.25in 1.0in 1.25in; mso-header-margin:.5in; mso-footer-margin:.5in; mso-paper-source:0;} div.Section1 {page:Section1;} /* List Definitions */ @list l0 {mso-list-id:176500654; mso-list-type:hybrid; mso-list-template-ids:-1610958616 642254348 1802898708 832353870 1508951890 1061685170 -1919385224 2135210068 654506682 1871347928;} @list l0:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l1 {mso-list-id:218640366; mso-list-type:hybrid; mso-list-template-ids:34625782 1879064160 1004709138 377518572 -120535498 2063753912 -2023747948 -1093910570 1169450864 -892324782;} @list l1:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l2 {mso-list-id:352460617; mso-list-type:hybrid; mso-list-template-ids:-162135770 1573412640 -1143561686 -1359181440 -1778846596 -675634294 2040702502 -1798133188 1104082008 -1747005554;} @list l2:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l3 {mso-list-id:605431337; mso-list-type:hybrid; mso-list-template-ids:1882218214 405577580 -2088048828 -620979218 2034551570 -105331346 -1872204942 1960992960 939655452 187189704;} @list l3:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l4 {mso-list-id:616332951; mso-list-type:hybrid; mso-list-template-ids:-2121503670 -938192272 -326495040 1344303574 -1323801064 876136946 30171346 -155432398 -275235212 964169354;} @list l4:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l5 {mso-list-id:866215456; mso-list-type:hybrid; mso-list-template-ids:1920229162 1560599570 1041117306 129912886 -1062160960 708860616 27537738 1767956120 355867502 -862035300;} @list l5:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l6 {mso-list-id:1154100461; mso-list-type:hybrid; mso-list-template-ids:1872510168 -1107939372 1002330802 -109801440 -2066709300 -469189498 -32725494 1094512198 -1131148552 847540354;} @list l6:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l7 {mso-list-id:1187713294; mso-list-type:hybrid; mso-list-template-ids:-774317378 863262924 94686218 777449778 -1792346184 -177564868 -543274984 570163436 -839747324 154972114;} @list l7:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l8 {mso-list-id:1209759940; mso-list-type:hybrid; mso-list-template-ids:-1384239484 12115666 -1522996244 1357256764 -57769864 287099324 -498568288 1039707782 -994642542 2043954892;} @list l8:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l9 {mso-list-id:1236814312; mso-list-type:hybrid; mso-list-template-ids:559448602 -1711787468 1330648572 -883384858 -244786894 -715873546 1211635840 660658588 -744705912 -794755240;} @list l9:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l10 {mso-list-id:1605460185; mso-list-type:hybrid; mso-list-template-ids:974180206 1133525928 367190754 2067152578 447217748 -831647314 -1073024844 -1079202094 1437874260 1908586386;} @list l10:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l11 {mso-list-id:1744404298; mso-list-type:hybrid; mso-list-template-ids:-88457190 -1540190154 -408363358 -2044964954 -285425460 -240244494 1407350808 -1877299018 -358864090 -1172158700;} @list l11:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l12 {mso-list-id:1885405565; mso-list-type:hybrid; mso-list-template-ids:1961771624 327431722 1424228792 1048887018 -866747864 -854166330 1516670514 -1122991992 1998767166 804526810;} @list l12:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l13 {mso-list-id:1904632842; mso-list-type:hybrid; mso-list-template-ids:1140086398 -1191815874 -1132298448 -1085131794 2014741232 -1565625484 -1997398374 1304058260 250103498 912524370;} @list l13:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} @list l14 {mso-list-id:2046173909; mso-list-type:hybrid; mso-list-template-ids:540473568 1821304618 -460709142 -1138166102 1599221368 788721296 -1790257806 141168422 -1446980396 2088423136;} @list l14:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;} ol {margin-bottom:0in;} ul {margin-bottom:0in;} --> </style> <!--[if gte mso 9]><xml> <o:shapedefaults v:ext="edit" spidmax="1027"/> </xml><![endif]--><!--[if gte mso 9]><xml> <o:shapelayout v:ext="edit"> <o:idmap v:ext="edit" data="1"/> </o:shapelayout></xml><![endif]--> </head> <body lang="EN-US" link="blue" vlink="blue" style="tab-interval:.5in"> <div class="Section1"> <h1 align="Center" style="text-align: center; ">Install/Update User Guide</h1> <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p> <h2>Getting Started: Install/Update in three steps</h2> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">This section will teach you how to install a new Feature and how to revert to a previous state in three easy steps. Before you start, make sure you installed the 'mockup' site following the <a href="http://www.eclipse.org">install mockup site</a> instructions.</p> <h3>Find new Feature</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">This section will focus on finding a feature to install. There are different ways of finding a feature. The one we are going to focus in this section is <a href="http://www.eclipse.org"> browsing a site</a> . For more information about other ways of finding a feature, look at the <a href="http://www.eclipse.org">Find Features</a> section.</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">Before browsing a site, we will have to create a site bookmark to access it.</p> <h4>Create a new site bookmark</h4> <ul type="Disc"> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l13 level1 lfo1;tab-stops:list .5in"> Open the Install/Update perspective Help->Update Manager</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l13 level1 lfo1;tab-stops:list .5in"> Select the Updates View.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l13 level1 lfo1;tab-stops:list .5in"> Open the context menu </li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l13 level1 lfo1;tab-stops:list .5in"> Select new->site bookmark...</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l13 level1 lfo1;tab-stops:list .5in"> In the Site Name entry field type: Test Site</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l13 level1 lfo1;tab-stops:list .5in"> In the Site Address entry field type the URL where you installed the mockup site. (i.e. file:c:/eclipse/site)</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l13 level1 lfo1;tab-stops:list .5in"> Click Ok </li> </ul> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The Site should appear on the view. The provider of a feature should give you the URL of their site so you can find their feature. We will now browse the site to discover the features.</p> <h4>Choose Feature</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You can expand the site and the categories to see the Features. In this site you should see one category: Red Dot Versions, and two features: Red Dot Feature 1.0.0 and Red Dot Feature 2.0.0. </p> <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; "> ·<span style="font-family: "Times New Roman"; 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]--> Select Red Dot Feature 1.0.0</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The Preview page should now look like the following picture:</p> <p class="MsoNormal" align="Center" style="text-align: center; "><img border="0" width="678" height="518" id="_x0000_i1025" src="images/pic001.gif" alt="pic001.gif Preview Page of Red Dot 1.0.0"> </p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You may want to check the license and copyright or decide to have more information about the Feature you are about to install. 'Click' on the appropriate link at the bottom of the view to automatically open a browser that will show you the desired page.</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "><TIP the preference page lets you decide if you want to view the HTML page within the workbench or by launching an external browser></p> <h3>Install Feature</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When you are ready to install the feature click on the Install button in the Preview View. This will launch the Install Wizard.</p> <h4>Install Wizard</h4> <ul type="Disc"> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l10 level1 lfo3;tab-stops:list .5in"> The first page of the Wizard summarizes the action you are going to take. Click Next.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l10 level1 lfo3;tab-stops:list .5in"> The second page shows the license you have to accept to install the feature. Click next of you accept the presented license otherwise click cancel.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l10 level1 lfo3;tab-stops:list .5in"> The last page of the Wizard presents the list of Site you can install your feature in. You can create a new site from this page. For more information about creating new Site see:<a href="http://www.eclipse.org"> Site Location Tab</a> .You should see only one site and it should point to the path where the workbench is installed. Click Finish.</li> </ul> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The feature will then be downloaded, verified and installed in the site. You can see the progress monitor showing you the evolution of theses tasks. During verification, you may be prompted to accept the verification. Click 'Ok' when prompted.</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When the feature has been installed you will need to restart the workbench for the changes to take effect. Click 'Ok' on the dialog box.</p> <h4>Verify the feature has been installed</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The feature you installed will add a red button icon to the tool bar when activated. To activate this specific feature customize your perspective and add the Red Dot Set Action Set:</p> <ul type="Disc"> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l11 level1 lfo4;tab-stops:list .5in"> Open the menu Window</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l11 level1 lfo4;tab-stops:list .5in"> Select Customize Perspective</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l11 level1 lfo4;tab-stops:list .5in"> Expand Action Sets</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l11 level1 lfo4;tab-stops:list .5in"> Check Red Dot Set</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l11 level1 lfo4;tab-stops:list .5in"> Click Ok</li> </ul> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You should now se a red button icon on the toolbar. If you click on it the following dialog box should appear, meaning the feature and associated plug-ins have been successfully installed and configured.</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We will now see how to manage your feature in your configuration.</p> <h3>Configure Environment</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">A feature that is installed may be configured or unconfigured for your workspace. A configured feature means that Install/Update will 'suggests' that the runtime configures the feature to be available. An unconfigured feature means that Install/Update will make the feature unavailable to the user.</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">When you installed Red Dot Feature 1.0.0, Install/Update installed and configured the feature for you. You can see that in the Configuration History. For more information about Configuration History see <a href="http:/ww.eclipse.org"> Configuration History</a> .</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">A configuration is a list of configured and unconfigured features that determine what tool you can use.<br> The current configuration is the configuration currently active.</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">For more information about configuration, see <a href="http://www.eclipse.org"> Configuring/Unconfiguring</a> .</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">In this section we will add the current history configuration to the list of preserved configuration. We will unconfigure Red Dot 1.0.0, so the feature will be unavailable. Then we will restore the preserved configuration, which will re-configure the feature.</p> <h4>Add configuration to preserved</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">To add the current configuration, we will first need to find it in the list of configurations and then add it to the list of preserved configurations. The current configuration is the configuration in the configuration history folder with an icon with a running person. It is the last configuration in the list.</p> <ul type="Disc"> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l4 level1 lfo5;tab-stops:list .5in"> Select the current configuration.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l4 level1 lfo5;tab-stops:list .5in"> Open the context menu.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l4 level1 lfo5;tab-stops:list .5in"> Select Add to preserved.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l4 level1 lfo5;tab-stops:list .5in"> The configuration now appears under the Preserved Configurations folder.</li> </ul> <h4>Rename configuration</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We will rename the configuration to give it a meaningful name.</p> <ul type="Disc"> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l2 level1 lfo6;tab-stops:list .5in"> Select the configuration.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l2 level1 lfo6;tab-stops:list .5in"> Open the context menu and click Properties.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l2 level1 lfo6;tab-stops:list .5in"> Change the name of the configuration to: RedDot 1</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l2 level1 lfo6;tab-stops:list .5in"> Click Ok.</li> </ul> <h4>Unconfigure Feature</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We will now unconfigure the feature.</p> <ul type="Disc"> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l0 level1 lfo7;tab-stops:list .5in"> Expand Current Configuration;</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l0 level1 lfo7;tab-stops:list .5in"> Expand the site</li> </ul> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "><img border="0" width="202" height="118" id="_x0000_i1026" src="images/pic004.gif" alt="Expand Current Configuration to reveal the configured Feature."> </p> <ul type="Disc"> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l3 level1 lfo8;tab-stops:list .5in"> Select Red Dot Feature 1.0.0</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l3 level1 lfo8;tab-stops:list .5in"> In the preview view click Unconfigure.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l3 level1 lfo8;tab-stops:list .5in"> When the Dialog opens click Ok.</li> </ul> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">The workspace will shutdown and restart automatically.</p> <h3>Restore Configuration</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">We shall now restore the configuration we added to preserve, so the feature will be configured again.</p> <h4>Verify the Feature is not available</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; ">You should not see the red button icon in the toolbar, meaning the feature was not activated</p> <ul type="Disc"> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l14 level1 lfo9;tab-stops:list .5in"> In the Configuration View, expand Current Configuration.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l14 level1 lfo9;tab-stops:list .5in"> Expand the site.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l14 level1 lfo9;tab-stops:list .5in"> Verify Red Dot Feature 1.0.0 does NOT appear as an icon.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l14 level1 lfo9;tab-stops:list .5in"> Click on the view toolbar button 'show unconfigured features'</li> <li>Verify Red Dot Feature 1.0.0 does appear</li> </ul> <blockquote><img src="images/pic005.gif" alt="Unconfigured feature Revealed" width="257" height="117"> <br> </blockquote> <blockquote></blockquote> <blockquote> <div align="Left">The icon <img border="0" width="16" height="16" id="_x0000_i1028" src="images/unconf_feature_obj.gif" alt="Unconfigured Feature unconf_feature_obj.gif "> means the feature is still installed but not available at this time in your workspace. To be able to use the feature we will need to configure the feature.</div> </blockquote> <h4>Revert to preserved configuration</h4> <p class="MsoNormal"> We will now go back to the configuration we had previously, in which Red Dot Feature 1.0.0 was configured.</p> <ul type="Disc"> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l12 level1 lfo10;tab-stops:list .5in"> Expand Preserved Configurations</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l12 level1 lfo10;tab-stops:list .5in"> Select RedDot 1</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l12 level1 lfo10;tab-stops:list .5in"> In the preview view click Restore</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l12 level1 lfo10;tab-stops:list .5in"> When the Dialog opens click Ok.</li> </ul> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The workspace will shutdown and restart automatically. After the workspace restart, the feature is configured, based on the revert configuration.</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> There are different ways of configuring a feature. To know more about configuring and unconfiguring features see: <a href="http://www.eclipse.org">Configuring/Unconfiguring features</a> .</p> <p class="MsoNormal">In this section you learnt how to find a feature you want to install, how to install a feature, how to unconfigure a feature and how to restore a preserved configuration. The rest of the book will go into more details.</p> <h2>The User Interface</h2> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This section describes in details the User Interface of the Install/Update perspective. The perspective is composed of four different views: The Configuration View to manage the configurations, the Updates View to manage update sites and features as well as searches. The Preview View is used to show the details of the element selected in the previous two views and the Web View, which is used to browse HTML document from either sites or features.</p> <h3>The Configuration View</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The configuration view helps you manage your configurations. A configuration is a list of configured and unconfigured features that determine what tool are available fro you to use in your workspace. <br> </p> <blockquote><img border="0" width="251" height="251" id="_x0000_i1029" src="images/pic006.gif" alt="Configuration View"> </blockquote> <h4>Current Configuration</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The current configuration is the configuration currently active. When you expand the Current Configuration you can see the sites you are connected to. Expanding each site reveals the list of Features you have access to. Some feature may be configured, some may be unconfigured. The configured features are the tools the Install/Update suggested the runtime to activate. To know more about configured/Unconfigured features see: <a href="http://www.eclipse.org"> Configured/Unconfigured</a> .</p> <h4>Configuration History</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The Configuration History folder contains the last <i>n</i> configurations you used. <i>n</i> is a number you can set in the Install/Update preference page. See: <a href="http://www.eclipse.org">Install/Update Preference Page</a> .</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> You can use the history list to see what are the different activities that occurred as well as restoring an old configuration to make it the current one.</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Install/Update creates a new configuration history when one or more activities are performed (i.e. install, configure, unconfigure etc...). When the Install/Update creates a new configuration, it will add it to the list. If you already have n configurations, the framework will automatically delete the oldest configuration from the list. To know when the Install/Update creates new configuration history and what are the Activities see:<a href="http://www.eclipse.org"> Configuration History</a> .</p> <h4>Preserved Configuration</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The Preserved Configurations folder contains history configurations you want to keep. The framework does not automatically delete the configurations in the Preserved Configurations folder; you have to explicitly delete them.</p> <h4>Configured/Unconfigured</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> You can decide to see only the configured features or both configured/unconfigured features by clicking the 'Show Unconfigured Features' toggle button in the view tool bar. To know more about configured/unconfigured features see: <a href="http://www.eclipse.org"> Configured/Unconfigured</a> .</p> <h4>Local View Toolbar Actions</h4> <h5>Show Unconfigured Feature</h5> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> This button allows you to see only the configured features or both configured and unconfigured features. Unconfigured features appear with a red circle around the icon. For more information about configuring/unconfiguring features see: <a href="http://www.eclipse.org">Configuring/Unconfiguring</a> .</p> <h4>Context Actions</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This section describes the different context actions available in the Configuration View.</p> <h5>Go Home</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This action <TODO be consistent with navigator></p> <h5>Go Back</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This action <TODO be consistent with navigator></p> <h5>Go Into</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This action <TODO be consistent with navigator></p> <h5>Show Details</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This action opens or refreshes the Preview View with the details of the selected element.</p> <h5>Properties</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This opens a Dialog box that presents the label of the selected configuration. You are able to change the label of a configuration. Click Ok when you have finished and you want to preserve your changes or click Cancel if you do not want to change the properties.</p> <h5>Add to Preserved</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This action adds the selected configuration in the Configuration History folder to the list of preserved configuration.</p> <h5>Remove from Preserved</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This action removes the selected configuration from the list of preserved configurations. This action will not delete any Site, Site Bookmark or Feature. This action will not delete the configuration it was created from or any other configuration.</p> <h5>Restore</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This action creates a new configuration based on the selected configuration and marks it as current. Install/Update will automatically configure all the features that were configured in the selected configuration you want to restore. To know more about restoring or reverting to a configuration see: <a href="http://www.eclipse.org"> Restore a Configuration/Revert to previous configuration</a> .</p> <h3>The Updates View</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The Updates view allows you to manage the remote sites you can install from to search for features as well as features you can install. <br> </p> <blockquote><img border="0" width="251" height="249" id="_x0000_i1030" src="images/pic007.gif" alt="Updates View"> </blockquote> <h4>My Computer</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> My Computer lets you browse your computer and any mounted local file to discover any site on your file system. You can also search My Computer to discover sites: see <a href="http://www.eclipse.org">Search the file system</a> .</p> <h4>Places to Visit</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Places to visit are sites suggested by the features you installed for you to visit. </p> <h4>Available Updates</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Available Updates will let you search for updates of already installed features. The search occurs in the background so you can still use the workbench while searching for updates. To know more about searching: see <a href="http://www.eclipse.org"> Search</a> .</p> <h4>Sites Bookmark</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> A site is a location that contains features. In the Updates View, the sites contain features you can install. You can browse or search features in Site bookmarks. There are two ways of adding a site bookmark. You can use the context menu and the context action add site bookmarks, or you may browse My Computer and add a site as a site bookmark. See <a href="http://www.eclipse.org"> Context Action</a> for more details. </p> <h4>Search</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> Search is a bookmark for a specific query that will retrieve features from update sites. You can create a new specific query based on a template or execute the query to fetch the features from the desired update sites. You can also query your local file system. The resulting features appear on the same search preview than the query. To know more about how to create your own query: see <a href="http://www.eclipse.org">Context Action [new->Search]</a> . To know how to search the file system: see <a href="http://www.eclipse.org"> Search the file system</a> . To search for available updates: see <a href="http://www.eclipse.org"> Update Already Existing Features</a> . To search for new features: see <a href="http://www.eclipse.org">Finding New Features</a> . To know more about the search Preview View: see <a href="http://www.eclipse.org"> Search Preview View</a> .</p> <h4>Folder</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> Folders are placeholders in the Updates View. They are used to help you categorize and organize the view. Folders can contain folders, update sites and/or searches. You can change the label of a folder. To know more about how to create a folder see: <a href="http://www.eclipse.org">Context Action [new->folder]</a> .</p> <h4>Local View Toolbar Actions</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This section describes the local view toolbar actions of the Updates View.</p> <h5>Show Feature Categories </h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> When this action is selected, you will see the features organized in categories.<br> </p> <blockquote><img border="0" width="253" height="193" id="_x0000_i1054" src="images/pic008.gif" alt="Categories"> <br> </blockquote> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> When this action is not selected, you will see all the features as a list.<br> </p> <blockquote><img border="0" width="253" height="97" id="_x0000_i1032" src="images/pic008b.gif" alt="No Categories"> </blockquote> <h5>Show My Computer Files </h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> When this action is selected, you will be able to browse the files when you expand MyComputer.<br> </p> <blockquote><img border="0" width="251" height="249" id="_x0000_i1033" src="images/pic009.gif" alt="Browse Files"> </blockquote> <h4>Context Actions</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This section describes the different context actions available in the Updates View. </p> <h5>New->Site Bookmark...</h5> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> Creates a new Site bookmark. This opens a Dialog box that presents the properties of the Bookmark Site you want to create. The properties of a Bookmark Site are the label you want to see in the View as well as the Address of the physical site. You have to enter the Site URL. Optionally you can enter the Site Name. If you o not enter a Site Name, it will default to the Site URL. Click Ok when you have finished and you want to preserve your changes or click Cancel if you do not want to create a new Site Bookmark.</p> <h5>New->Folder</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This action lets you create a new Folder. When you select this action, a dialog will open.<br> </p> <blockquote> <div align="Left"><img border="0" width="438" height="481" id="_x0000_i1034" src="images/pic011.gif" alt="New Folder Dialog"> <br> </div> </blockquote> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Type the label of the folder in the 'Name;' entry field.<br> Type the name of the parent folder in the 'Create in:' entry field, or select it in the 'Existing folders:' tree view. If no parent is selected, the newly created folder will appear in the updates view as a root folder.<br> </p> <blockquote><img border="0" width="251" height="249" id="_x0000_i1035" src="images/pic010.gif" alt="folders"> <img border="0" width="32" height="32" id="_x0000_i1036" src="pic010.gif" alt="folders"> </blockquote> <h5>New->Search</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This action will create a new Search. It will open a dialog window. Enter the name of the search you desire in Name. Select the folder you want the Search to appear in by selecting the appropriate folder under the existing folders tree or by typing its name in the Create in entry field. Open the Category combo box and select the search you want. You can change the category of a search after it has been created: see <a href="http://www.eclipse.org"> Search Preview View</a> . Click finish to close the dialog and create the search or click Cancel to close the dialog and abort the creation. To know more about the different type of search: see <a href="http://www.eclipse.org">Searching New Features</a> .</p> <h5>Show Details</h5> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> This action opens or refreshes the Preview View with the details of the selected element.</p> <h5>Refresh</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This action re-initializes the content of an element <TODO see dejan></p> <h5>Bookmark Location</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This action lets you create bookmark site for a site found on your local file system. This opens a Dialog box that presents the properties of the selected site. The properties of a Site are the label you want to see in the View as well as the Address of the site. You are able to change the Site Name. Click Ok when you have finished and you want to preserve your changes or click Cancel if you do not want to change the properties.</p> <h5>Properties</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This action opens a Dialog box that presents the properties of the selected site. The properties of a Site are the label you want to see in the View as well as the Address of the site. If the element you selected was a bookmark, you are able to change both the Site Name and the Site Address of the site. If you change the Site Address of a Bookmark Site you will need to 'refresh' the Bookmark Site to access its new content. Click Ok when you have finished and you want to preserve your changes or click Cancel if you do not want to change the properties.</p> <h5>Delete</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This action removes the Bookmark Site from the workbench. This does not erase the content of the Site nor the physical remote or local Site itself.</p> <h3>The WebView</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The Web View is <TODO ></p> <h3>The flat concept (see Dejan)</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> <TODO></p> <h3>The Preview View</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The preview shows information about the selected element. The preview view is different for each selected element.</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> You can open the preview view by either selecting an element in the updates or Configuration view, by opening a context menu on any element in the Updates or Configuration View and selecting Show Details or by open the Preview View from the Workbench menu. Select Window->Show View->Other to open the list of available Views. Expand Update Manager Folder, select Preview and Click Ok.</p> <h4>The 'Home' Preview view.</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> You can open the 'Home' Preview by clicking on the home in the local tool bar menu if the View. This view summarizes the different tasks you can achieve through the Install/Update. By using the flat concept you are able to <TODO dejan></p> <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/pic012.gif" alt="Home Preview"> </p> <h4>The current configuration Preview view</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This Preview shows information about the product you are using. The content of the view depends on the product you launched. </p> <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/pic012b.gif" alt="product preview"> </p> <h4>The Site and Site Bookmark Preview View</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This Preview shows the Site Address of the selected Site or Bookmark Site.</p> <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/pic012c.gif" alt="Site Preview"> </p> <h4>The Feature Preview View</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This Preview View shows information about a feature.</p> <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/pic012d.gif" alt="Feature Preview"> </p> <h5>Provider</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The name of the provider of the feature.</p> <h5>Version</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The version of the feature.</p> <h5>Installed Version</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The list of already installed version of this feature or 'Not Installed' if no version of this feature has been configured in the current configuration.</p> <h5>Download Size</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The maximum download size for the feature. If the site you will install the feature in already contains some of the files the feature require, the files will not be installed twice, and thus the downloaded and installed size will be smaller than the maximum one.</p> <h5>Supported Platforms</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This expandable category shows the different supported platforms for this feature. The categories are Operating Systems, Windowing Systems, Architectures and Languages.</p> <ul type="Disc"> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l9 level1 lfo11;tab-stops:list .5in"> Operating Systems: the list of supported Operating Systems.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l9 level1 lfo11;tab-stops:list .5in"> Windowing Systems: the list of supported Windowing Systems.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l9 level1 lfo11;tab-stops:list .5in"> Supported Architectures: the list of supported processor architecture.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l9 level1 lfo11;tab-stops:list .5in"> Supported Languages: the list of supported languages.</li> </ul> <h5>Description </h5> <p class="MsoNormal" style="margin-bottom: 12pt; ">The description of the Feature</p> <h5>More Info </h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Opens a page with more information about the feature. The page may be found locally or remotely.</p> <h5>License</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Opens a page with the license of the Feature.</p> <h5>Copyright</h5> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> Opens a page with the copyright of the Feature.</p> <h5>Actions</h5> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> In the lower left side of the Preview View for a feature you may see one or multiple buttons. They provide you with actions you can take on the Feature depending of its configuration. If a change is pending for this feature, no actions will be available until the workbench is restarted.</p> <ul type="Disc"> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l5 level1 lfo12;tab-stops:list .5in"> Install: this launches the Install Wizard for this feature. See <a href="http://www.eclipse.org"> Installing a Feature</a> .</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l5 level1 lfo12;tab-stops:list .5in"> Unconfigure: this launches the Unconfigure Wizard for this configured feature. See <a href="http://www.eclipse.org">Configuring/Unconfiguring a Feature</a> .<br> Configure: this launches the Configure Wizard for this unconfigured feature. See <a href="http://www.eclipse.org">Configuring/Unconfiguring a Feature</a> .<br> Uninstall: this removes the unconfigure feature from the file system. See <a href="http://www.eclipse.org">Removing a Feature</a> .</li> </ul> <h4>The Configuration Preview View</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> This preview shows information about the select configuration.</p> <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/pic013.gif" alt="Configuration Preview"> </p> <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p> <h5>Created On</h5> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> The date in the current locale, the configuration was created on.</p> <h5>Current Configuration</h5> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> If the selected configuration is the active configuration.</p> <h5>Activities</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> List of activities that led to the creation of the configuration. For more information about the different activities, see <a href="http://www.eclipse.org"> Activities</a> .</p> <h5>Configuration Reversal</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> In the lower left side of the Preview View for a configuration you may see one button. It provides you with actions you can take on the Configuration depending if it is the current configuration or another one. If a change is pending for a feature, no actions will be available until the workbench is restarted.</p> <ul type="Disc"> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l6 level1 lfo13;tab-stops:list .5in"> Restore: this restores the selected configuration. See <a href="http://www.eclipse.org"> Restore a Configuration/Revert to previous configuration</a> .</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l6 level1 lfo13;tab-stops:list .5in"> Revert: this revert the current configuration to the previous configuration. See <a href="http://www.eclipse.org">Restore a Configuration/Revert to previous configuration</a> .</li> </ul> <h4>The search Preview View</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This view allows you to change the search query, enter the appropriate settings for the query, set the scope of the search, run the query and see the result of the query. The settings are different for each query.</p> <h5>Change the query</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> To change the category of the query, expand Query Settings. Expand the Search Category Settings and select the desired search category.</p> <h5>Enter the settings</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Each category has its own settings. For more information about the different settings for a category: see <a href="http://www.eclipse.org">Searching New Features</a> .</p> <h5>Set the scope</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> To change the scope of the search, expand Scope Settings. You can select to search the local file system, the discovery sites in 'places to visit' and/or the bookmarked sites you created. When searching the local file system, click Settings to select which root folder will be searched.</p> <h5>Run the query</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Click Search Now to run the query.</p> <h5>See the results</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The result will appear at the bottom of the View. Select Show Results in Extended Form to have more information about the features.</p> <h3>The Install/Update Preference Page</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> You can open the preference page from the Workbench main menu. Click Window->preferences to open the Preference Dialog. Select Install/Update to reveal the Install/Update preference Page. In this page, you can modify the number of history configuration you want the workbench to manage as well as decide which browser to open.</p> <h4>Maximum number of 'History' configurations entry field.</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Enter the number of history configurations you want the Install/Update to keep. See <a href="http://www.eclipse.org">Configuration History</a> for more information.</p> <h4>Web Links radio buttons.</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> When opening Web links. It allows you to choose between opening the internal WebView and opening an external browser.</p> <h2>Finding features</h2> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This section will explain how to find the features to install. There are different way of looking for features; you may know exactly which feature you need and where it is located, or you may want to search for an update of an already installed feature is available, finally you may just decide to browse or search to discover new sites and new features. </p> <h3>Find a specific feature </h3> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> This section will focus on finding a feature when you know exactly where to find it. To find a feature you may either add the Update Site that contains this feature and browse the site to find the feature, or open the WebView and browse to the Feature WebPage.</p> <h4>Add a new Update Site </h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> To add a new Update site, open the context Menu in the Updates View and select New->Site Bookmark.... This opens a Dialog box that presents the properties of the Bookmark Site you want to create. The properties of a Bookmark Site are the label you want to see in the View as well as the URL of the physical site. You have to enter the Site URL. Optionally you can enter the Site Name. If you do not enter a Site Name, it will default to the Site URL. Click Ok when you have finished and you want to preserve your changes or click Cancel if you do not want to create a new Site Bookmark. </p> <h4>Find the feature </h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> Expand the site to find the feature you want. You can find the feature by looking at the label or selecting a feature and reading the preview view. To know more about preview view: See <a href="http://www.eclipse.org">Preview View</a> .</p> <h4>Browse WebPages </h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Open the <a href="http://www.eclipse.org">WebView</a> and enter the URL for the feature web page. Follow the indication of the web page. <TODO web install></p> <h3>Update already existing features</h3> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> This section will focus on updating features that are configured in your current configuration. To know how to configure/unconfigure a feature: see: <a href="http://www.eclipse.org">Configuring/Unconfiguring</a> .</p> <h4>Search for updates</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> To search for available updates, select Available Updates in the Updates View. In the preview view, press Search now. This will search the site the configured feature come from for new version the installed and configured feature. During the search you will see the progress monitor move, indicating the search is in progress. When new version of configured features are found, they will appear under the progress monitor. You can decide to see the result in a short form or an extended form by checking the 'Show results in extended form' box, under the Scope Settings section in the preview view.</p> <h4>Search the file system</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> You can decide to search the file system for updates by checking the 'Include my computer in the search' box, under the Scope Settings section in the preview view. Click on the Settings... button to customize which part of the file system you want to search.</p> <h4>Customize Search</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> You can customize the search for updates by creating a new search. To know how to create a new search: see <a href="http://www.eclipse.org">Updates View: Context Action [new->search]</a> .</p> <h3>Browse to discover</h3> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> This section will focus on browsing update sites to find the features you want to install. The entire update site appears in the Updates View. There are different places in the view where you can find sites to browse. You may have sites in the folder 'Places to visit' or you may have sites on your file system. You can also add some update site if you know their URL.</p> <h4>Browse already existing sites</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> If you expand the folder 'Places to visit' you may see some sites. They were automatically added to the folder by the feature you installed. You can expand the site and browse the features.</p> <h4>Browse the file system</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> To browse the file system, expand 'My Computer'. <TODO what more to say?></p> <h4>Add a new Update Site </h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> You can add a new update site from the context menu. Select new->Site Bookmark... This opens a Dialog box that presents the properties of the Bookmark Site you want to create. The properties of a Bookmark Site are the label you want to see in the View as well as the Address of the physical site. You have to enter the Site URL. Optionally you can enter the Site Name. If you do not enter a Site Name, it will default to the Site URL. Click Ok when you have finished and you want to preserve your changes or click Cancel if you do not want to create a new Site Bookmark. Once the site has been created, expand the icon to see the categories and or the available features.</p> <h4>Add a bookmark of a file system site.</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> When you browse the file system, you can add a file system site as a bookmark. Select the site. Open the context menu. Select 'Bookmark Location'. This action lets you create bookmark site for a site found on your local file system. This opens a Dialog box that presents the properties of the selected site. The properties of a Site are the label you want to see in the View as well as the Address of the site. You are able to change the Site Name. Click Ok when you have finished and you want to preserve your changes or click Cancel if you do not want to change the properties. Once the site has been created, expand the icon to see the categories and or the available features.</p> <h3>Searching Features</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This section will explain how to find features by using the search mechanism. It will first focus on finding update of configured features, then it will explain how to search the file system, finally it will expose how to customize a search by presenting the three default search categories.</p> <h4>Search for updates</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> To search for available updates, select Available Updates in the Updates View. In the preview view, press Search now. This will search the site the configured features come from for new versions. During the search you will see the progress monitor move, indicating the search is in progress. When new version of configured features are found, they will appear under the progress monitor. You can decide to see the result in a short form or an extended form by checking the 'Show results in extended form' box, under the Scope Settings section in the preview view.</p> <h4>Search the file system</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> You can decide to search the file system for updates by checking the 'Include my computer in the search' box, under the Scope Settings section in the preview view. Click on the Settings... button to customize which part of the file system you want to search.</p> <h4>Customize Search</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Three default categories of search are provided: Search for available updates, search features based on regular expression and search features that contain a specific plugin. You may see other categories. Check the user documentation of the features that provide the extra categories to learn more about them.</p> <h5>Available Updates</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This search attempts to find update of configured features. There are no special settings to fill when running this query. The query will find all new version of configured features based on the search scope. To know more about the scope of the search: see <a href="http://www.eclipse.org"> Search Preview View</a> .</p> <h5>Regular Expression</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This search attempts to find features based on a simple regular expression query. You must change the settings of the query before running it. Select the query in the Updates View. In the preview view, expand Query Settings.</p> <ul type="Disc"> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l7 level1 lfo14;tab-stops:list .5in"> Type the string you want to search for in the Expression Entry Field.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l7 level1 lfo14;tab-stops:list .5in"> Check the check box if you want the search to be case sensitive. A case sensitive search will consider Uppercase and Lowercase character as different.</li> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l7 level1 lfo14;tab-stops:list .5in"> Selection where you want the search to occur by checking Feature Name, Feature Provider and/or Feature Description.</li> </ul> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The query will find the features that match the query based on the scope. To know more about the scope of the search: see <a href="http://www.eclipse.org"> Search Preview View</a> .</p> <h5>Plug-ins</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This search attempts to find feature that contain a specific plug-in. You must change the settings of the query before running it. Select the query in the Updates View. In the preview view, expand Query Settings.</p> <ul type="Disc"> <li class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l8 level1 lfo15;tab-stops:list .5in"> Click New to add a specific plug-in. <TODO doesn't work in 0423></li> </ul> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The query will find the features that match the query based on the scope. To know more about the scope of the search: see <a href="http://www.eclipse.org"> Search Preview View</a> .</p> <h2>Installing a Feature</h2> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This section will describe the Wizard used to install, configure, unconfigure and remove a feature as well as the verification task that may occur when installing a new feature. The first part will focus on the three tab that are part of the Wizard, while the second part will deal with verification and security issues when installing a feature.</p> <h3>Install Wizard</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The Wizard will help you install, configure, unconfigure and remove a feature. It will allow you to review any license agreement and to choose the Site in which you wish to install the feature.</p> <h4>The Preview Tab</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This tab summarizes the action you are going to take. </p> <div align="Center"> <p class="MsoNormal"><img border="0" width="500" height="500" id="_x0000_i1042" src="images/pic002.gif" alt="Install Wizard Preview Tab pic002.gif"> </p> </div> <h4> The License Tab</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This tab will present you the license you have to agree with to install the product. Click on agree if you agree with the whole license and whish to continue or click cancel to abort the installation</p> <h4>Site location Tab</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This tab has three main goals. The first one is to show you the available sites on your local file system, the second is the ability to create a new site if the one proposed are not satisfactory, finally you will be able to see the space left on the selected site and the size in kilobyte of the feature you are about to install.</p> <h4>Verification </h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Verification is an important part of the install process. It will allow you to verify if the feature you are about to install has been digitally signed, not digitally signed or tempered with. When a feature or a file has been digitally signed, you will be able to see the certificate used to sign the feature. A certificate will contain information about the entity that signed the feature, and information about the entity that authenticated the first entity. If the entity authenticated itself, you will only see one entity.</p> <h5>Signed</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> A dialog with the following will appear if the feature or one of its files has been signed. A signed feature means the signer has digitally signed the file, and the authenticator has authenticated the signer.</p> <blockquote> <p class="MsoNormal"><img border="0" width="251" height="85" id="_x0000_i1043" src="images/pic018.gif" alt="Signed Feature"> </p> </blockquote> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The authenticator can be the same entity as the signer, in which case you will see such a dialog. You have to be very careful with self-signed certificate, as the authentication of the signer cannot be verified.</p> <blockquote> <p class="MsoNormal"><img border="0" width="600" height="189" id="_x0000_i1044" src="images/pic019.gif" alt="Self Sigend Certificate"> </p> </blockquote> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> In some cases, the authenticator is a different entity than the signer.<br> If you do not authorize the authenticator, you will see such a dialog. You have to be very careful with signed certificate you didn't authorize, as the authenticator of the certificate is not one of the worldwide known authenticator.</p> <blockquote> <p class="MsoNormal"><img border="0" width="600" height="234" id="_x0000_i1045" src="images/pic020.gif" alt="Root not trusted"> </p> </blockquote> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> If the signature of the authenticator has been authorized before, you will see such a dialog <PICTURE>. You have to be careful with signed certificate you authorized, as the authenticator of the certificate only validates that the signer has been authenticated. It does not provide any guarantee as to the feature you are going to install. Only install if you trust the signer.</p> <blockquote> <p class="MsoNormal"><img border="0" width="600" height="265" id="_x0000_i1046" src="images/pic021.gif" alt="Root Trusted"> </p> </blockquote> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Click continue or install only if you trust the signer of the feature file and you want to install the feature, or click cancel if you want to abort the installation.<br> <br> To learn more about how to authorize an authenticator: see <a href="http://www.eclipse.org"> Security and Keystore Management</a> .</p> <h5>Non Signed</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> A dialog like the following will appear if the feature or one of its files has not been signed.</p> <blockquote> <p class="MsoNormal"><img border="0" width="289" height="84" id="_x0000_i1047" src="images/pic016.gif" alt="Non Signed Feature"> </p> </blockquote> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> When a feature has not been signed, we cannot authenticate the sender of the package, nor can we certify the validity of any of the file. Click continue or install only if you want to install the feature, or click cancel if you want to abort the installation.</p> <h5>Corrupted </h5> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> If the content of a feature has changed since it has been signed, you will see such a dialog.</p> <blockquote> <p class="MsoNormal"><img border="0" width="599" height="187" id="_x0000_i1048" src="images/pic017.gif" alt="Corrupted Feature"> </p> </blockquote> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> This means the content has been tempered with since the feature has been signed. The content of the feature has been changed since it has been packaged. You should notify the signer of the package. Install/Update will prevent you from installing such a feature. Click cancel if you want to abort the installation and contact the provider of the feature and/or the site. </p> <h5>Persistence of the answer</h5> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> If click continue or install on a verification dialog, the Install/Update component will remember your action and will not prompt you again if one of the file of the feature is about to show the exact same verification dialog. </p> <h2>Configuring/Unconfiguring a Feature</h2> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This section will focus on configuring and unconfiguring the feature you can manage in your current configuration. A configuration is a list of configured and unconfigured features that determine what tool are available for you to use in your workspace. To know more about configuration see: <a href="http://www.eclipse.org"> Configuration</a> .</p> <h3>Checking if a feature is configured or unconfigured.</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Feature you installed appear in the Configuration View. Expand the Current Configuration to see the configured sites. Expand the site to see the Features. Use the local view toolbar button to switch between configured features and all the features. Unconfigured features appear with such icon <img border="0" width="16" height="16" id="_x0000_i1049" src="images/unconf_feature_obj.gif" alt="unconf_feature_obj.gif Unconfigured Feature"> </p> <h3>Configure/Unconfigure Wizard</h3> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> The Wizard will help you configure or unconfigure a feature. </p> <h4>Preview Tab</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This tab summarizes the action you are going to take. </p> <div align="Center"> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "><img border="0" width="500" height="500" id="_x0000_i1050" src="images/pic003.gif" alt="pic003.gif Configure Wizard Preview Tab"> </p> </div> <h2>Configuration</h2> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> A configuration is a list of configured and unconfigured features that determine what tool are available for you to use in your workspace. A configuration determines what task you can execute. There are three types of configurations: the current configuration, the history configuration and the preserved configuration.</p> <h3>Current Configuration</h3> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> The current configuration is the configuration currently active.</p> <h3>Configuration History or Preserved Configuration</h3> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> Configuration History are automatically created by the Install/Update as a snapshot of your current configuration at a certain time, before an activity occurs. Preserved Configuration are configuration in the History Configuration you want to persist.</p> <h3>Configuration History</h3> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> When you install a feature, the install/update component will copy your current configuration in the history configuration, and then install and configure the feature in you current configuration. You will end up with two configurations, one without the feature installed and configured and one with the feature installed and configured. The install/update will also copy your current configuration when you install or remove a site, when you configure or unconfigure a feature or when reconciliation is needed. Each activity will be recorded in the configuration. For each configuration selected in the history configuration folder, you can see in the preview view the list of activities that were executed. See <a href="http://www.eclipse.org"> Activities </a> for more information about the different activities.</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The install/update will keep a certain number of configurations in the configuration history folder. After this number has been reached, if a new configuration is created, the oldest configuration inside Configuration History folder will be deleted. </p> <h4>Renaming an history configuration</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> You can rename any configuration in the Configuration History folder. To change the label of a Configuration, select the configuration, open the context menu and click Properties. This will open a dialog where you can change the label of the selected configuration. Click Ok if you want to save the label or click cancel if you do not want to change the label of the configuration.</p> <h4>Revert the current configuration to the previous configuration</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> You can revert the current configuration to the previous configuration. This action behaves like an 'Undo' where you want to go back to the previous configuration.</p> <h3> Preserved Configuration</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Preserved Configurations are configurations of the Configuration History folder you want to Preserved because it represents a set of configured features for a certain task. (I.e. you may want to enable some features for Enterprise Java Bean Development, and have a configuration with some feature for front-end development). If you do not preserved a configuration, it will be deleted from the file system when the history maximum number is reached: see <a href="http://www.eclipse.org"> Preference Page</a> . You should add to preserved configuration the configuration you want to quickly restore.</p> <h4>Add a Configuration in the preserved folder</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> To add a configuration to the list of preserved configurations, select the configuration in the history configuration folder. Open the context menu; click 'add to preserved configuration'. </p> <h4>Remove a Configuration in the preserved folder </h4> <p style="margin-right: 0.5in; margin-left: 0.5in; "> To remove a preserved configuration from the list, select the preserved configuration. Open the context menu. Click Remove from preserved.</p> <h4>Rename a Preserved Configuration</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> You can rename any configuration in the Preserved Configurations folder. To change the label of a Configuration, select the configuration, open the context menu and click Properties. This will open a dialog where you can change the label of the selected configuration. Click Ok if you want to save the label or click cancel if you do not want to change the label of the configuration.</p> <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p> <h3>Restore a Configuration/Revert to previous configuration</h3> <p class="MsoNormal"> <TODO></p> <p class="MsoNormal"><!--[if !supportEmptyParas]--><!--[endif]--><o:p></o:p></p> <h3>The Activities </h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> Activities are tasks that are part of a configuration. Activities are the actions that were taken to create the Configuration. You can see activities in the preview view when you select a configuration.<br> </p> <blockquote><img src="images/pic014.gif" alt="activities" width="594" height="151"> <br> </blockquote> <h5>Date</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The date using the locale format ate which the action took place.</p> <h5>Target</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The identifier of the target of the action (see the different type of activities)</p> <h5>Action</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The label of the action (see the different types of activities)</p> <h5>Status</h5> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> The status of the action. Success if the action was successful.</p> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> There are nine different actions that create an activity in a configuration.</p> <h4>Feature Installed </h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> When a new feature is installed in a configured site.<br> The target in the preview view is the identifier of the installed feature.</p> <h4>Feature Removed</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> When a new feature is physically removed from a configured site.<br> The target in the preview view is the identifier of the removed feature.</p> <h4>Site Installed</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> When a Site is added to the current configuration.</p> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> The target in the preview view is the Address of the site</p> <h4>Site Removed</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> When a Site is removed from the current configuration.</p> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> The target in the preview view is the Address of the site</p> <h4>Feature Configured</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> When a new feature is configured in a configured site.<br> The target in the preview view is the identifier of the configured feature.</p> <h4>Feature Unconfigured</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> When a new feature is unconfigured in a configured site.<br> The target in the preview view is the identifier of the unconfigured feature.</p> <h4>Revert to Configuration</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> When the user reverted to a configuration from either the configuration history or the preserved configuration</p> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> The target in the preview view is the identifier of the configuration we reverted to.</p> <h4>Reconciliation</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> When the Install/Update detected a changed occurred between the last shutdown and this startup.</p> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> The URL of the file maintaining the overall configuration.</p> <h4>Added to Preserved Configuration</h4> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> When a configuration was added to the list of preserved configurations.</p> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> The target in the preview view is the identifier of the configuration added to the preserved configurations.</p> <h2>Removing a Feature</h2> <p class="MsoNormal" style="margin-top: 0in; margin-right: 0.5in; margin-left: 0.5in; margin-bottom: 0.0001pt; "> This section explains how to physically remove an unconfigured feature from the file system. You can only remove unconfigured features. You know how to unconfigure a feature see: <a href="http://www.eclipse.org">Configure/Unconfigure Features</a> .</p> <h3>Remove Wizard</h3> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This Wizard will help you uninstall an unconfigured feature.<br> To launch the wizard, select an unconfigured feature in your current configuration. See <a href="http://www.eclipse.org">Configure/Unconfigure</a> a feature to know how to unconfigure a configured feature, and if a feature is configured or not.</p> <h4>Preview Tab</h4> <p class="MsoNormal" style="margin-right: 0.5in; margin-left: 0.5in; "> This tab summarizes the action you are going to take.<br> </p> <div align="Center"><img border="0" width="600" height="500" id="_x0000_i1052" src="images/pic015.gif" alt="uninstall wizard"> </div> <h2>Troubleshooting</h2> <p class="MsoNormal"> If the workbench does not start after you installed a new feature.<br> The Install/Update views do not show anything.<br> I created a Site but nothing shows (verify URL)</p> <h2>Advanced User</h2> <p class="MsoNormal"> Security and keystore management.</p> </div> </body> </html>
| help@eclipse.org | ViewVC Help |
| Powered by ViewVC 1.0.3 |