| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| <HTML> |
| <HEAD> |
| |
| <meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." > |
| |
| <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1"> |
| <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> |
| <LINK REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css"> |
| <title>Installing new features with the update manager</title> |
| <script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"> </script> |
| </HEAD> |
| |
| <BODY BGCOLOR="#ffffff"> |
| <H1>Installing new features with the update manager</H1> |
| |
| <p>To locate and install a new feature into a product (ordinarily requires web |
| access): |
| </p> |
| |
| <ol> |
| <li>Open the Install Wizard by clicking |
| <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.update.findAndInstallUpdates")'> |
| <img src="PLUGINS_ROOT/org.eclipse.help/command_link.png"> |
| <b>Help > Software Updates > Find and Install...</b></a>. |
| This opens the wizard. </li> |
| <li>Select the second button, "<b>Search for new features to install</b>" and |
| click <b>Next</b>.</li> |
| <li>Create a bookmark for an update site where Eclipse features and plug-ins |
| are published. In the sites to search list, select <b>Add Update Site</b> to |
| add a remote site, or <b>Add Local Site</b> if the site is available on a local drive |
| (including a CD), or <b>Add Archived Site</b>, when the site is available locally |
| but is packaged as a jar or zip file.</li> |
| <li>In the add site dialog, give the site a name such as |
| "CompanyA" and enter the URL such as |
| "http://companyA.example.com/eclipseupdates".</li> |
| <li>After adding the site, expand it to the |
| categories of feature versions available at that update site. This will |
| contact the web site to discover what features are available.</li> |
| <li>Select the categories you want to search and click <b>Next</b>.</li> |
| <li>Wait for the search to finish and selecting the features to be added. You |
| can view the description or more detailed properties for any feature by |
| selecting the feature and pressing the "Properties" button.</li> |
| <li>Once you're decided which features to install, click <b>Next</b>.</li> |
| <li>Carefully review the license agreements for the features. If the |
| terms of all these licenses are acceptable, check "I accept the terms |
| in the license agreements". Do not proceed to download the features if |
| the license terms are not acceptable.</li> |
| <li>If a feature selected for install include optional features, a page will |
| show up allowing you to select whether you want them installed or not. |
| Optional features typically carry functionality that is not essential for |
| proper functioning of the main feature.</li> |
| <li>The Install Location page controls where the new feature's files are to be |
| installed on the local computer. Select the directory into which the product |
| is installed and hit <b>Next</b>. (If the product is installed in a |
| directory to which you do not have write access, you should contact your |
| system administrator and get them to install this feature so that it will be |
| generally available. The other option is to click <b>Add</b> and point to a |
| directory to which you do have write access.</li> |
| <li><p>Feature versions can be digitally signed by the company that provides |
| them. This allows you to verify more easily that the features and |
| plug-ins that are about to be downloaded and installed are coming from a |
| trusted supplier.</p><br><p><b>Warning:</b> Because of the possibility of harmful or even |
| malicious plug-ins, you should only download features from parties that |
| you trust.</p><br> <p>Click <b>Install</b> to allow the downloading and installing |
| to proceed.</p></li> |
| <li>Once the new feature and plug-ins have been downloaded successfully and |
| their files installed into the product on the local computer, a new |
| configuration that incorporates these features and plug-ins will be |
| formulated. Click <b>Yes</b> when asked to exit and restart the workbench for the |
| changes to take effect. To add other new features at the same time before |
| restarting, click <b>No</b> and repeat. If this was a new feature and can be |
| dynamically installed into the current configuration, you will also be |
| presented with a <b>"Apply Now"</b> button. This will not restart the |
| platform, but configures the feature and the plug-ins into the current |
| configuration.</li> |
| </ol> |
| |
| <P><img border="0" src="../images/ngrelc.png" alt="Related concepts" ><br> |
| <a href="../concepts/concepts-25.htm">Features</a> |
| </P> |
| |
| <P> |
| <img border="0" src="../images/ngrelt.png" alt="Related tasks" ><br> |
| <a href="tasks-33.htm">Inspecting the current configuration</a><br> |
| <a href="tasks-36.htm">Updating features with the update manager</a><br> |
| <a href="tasks-38.htm">Restoring a saved configuration</a> |
| </P> |
| |
| |
| |
| </BODY> |
| </HTML> |