Updating with the Update Manager

Installing new features

To locate and install a new feature into a product (ordinarily requires web access):

  • Open the Install Wizard by clicking Help > Software Updates > Find and Install. This opens the wizard.
  • Select the second button, "Search for new features to install" and click Next.
  • Create a bookmark for an update site where EclipseTrader features and plug-ins are published. In the sites to search list, select Add Update Site to add a remote site, or Add Local Site if the site is available on a local drive (including a CD), or Add Archived Site, when the site is available locally but is packaged as a jar or zip file.
  • In the add site dialog, give the site a name such as CompanyA and enter the URL such as http://companyA.example.com/eclipseupdates .
  • 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.
  • Select the categories you want to search and click Next.
  • 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.
  • Once you're decided which features to install, click Next.
  • 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.
  • 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.
  • 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 Next. (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 Add and point to a directory to which you do have write access.
  • 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. Warning: Because of the possibility of harmful or even malicious plug-ins, you should only download features from parties that you trust. Click Install to allow the downloading and installing to proceed.
  • 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 Yes 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 No and repeat. If this was a new feature and can be dynamically installed into the current configuration, you will also be presented with a Apply Now button. This will not restart the platform, but configures the feature and the plug-ins into the current configuration.

Update existing features

To check to see whether there are updates for a product's existing features (requires Internet access):

  • Click Help > Software Updates > Find and Install and select the first choice (search for updates). This will contact the Web sites associated with the product's features to discover what versions of those features are available. The potential upgrades are presented in on the next page.
  • Select the feature versions that you wish to upgrade, and click Next.
  • Carefully review the license agreements for the upgraded 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.
  • Feature versions can be digitally signed by the company that provides them. This allows the user to verify more easily that the features and plug-ins that are about to be downloaded and installed are coming from a trusted supplier. Warning: Because of the possibility of harmful or even malicious plug-ins, you should only download features from parties that you trust. Click Install to allow the downloading and installing to proceed.
  • Once all the features 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 Yes when asked to exit and restart the Workbench for the changes to take effect.

Enable, disable, or uninstall a feature

Current configuration can be browsed, but it can also be operated on to enable/disable/uninstall features, to revert to previous configurations, etc. Open the configuration manager by clicking Help > Software Updates > Manage Configuration.

Disable a feature

Select the feature and click on the "Disable" feature action in the right pane of the dialog or in the context menu. The action is available only when the feature is currently enabled, and the feature is either an optional feature or a root feature (not included by other features).

Enable a feature

Turn on disabled features filtering from the dialog toolbar, then select a disabled optional or root feature and click on the "Enable" feature action in the right pane of the dialog or in the context menu.

Uninstall a feature

Features installed by you using the update manager can be uninstalled, provided they are already disabled, or that they are optional or root features. If the feature is disabled, make sure you turn on the disabled features filtering from the dialog toolbar. Select the feature and click on the "Uninstall" feature action in the right page of the dialog or in the context menu.