Systems Engineering Software

Updating the manually installed software

Warning

This page describes how to update our tooling, Eclipse, and Java, in case you installed them manually. These instructions do not apply to the bundled IDE releases, which are our default and recommended releases.

Usually, when updating the software, it is enough to update the toolsets. However, sometimes new versions of the toolsets change the supported Java versions and/or Eclipse releases, and thus require updating Eclipse and/or updating Java. Whenever a new version of the toolsets changes the supported Java versions and/or Eclipse releases, this will be mentioned in the changelog. Make sure you always follow the upgrade instructions from the changelog. If you don’t, you may run into dependency conflicts, and the problem that the installed toolsets are no longer available.

Besides updating the toolsets, it is also possible to downgrade toolsets.

Updating the toolsets

As stated above, before updating the toolsets, make sure the new release is compatible with your current Java version and Eclipse release.

To check for updates for the toolsets, in Eclipse, click Help menu ‣ Check for Updates. Follow the onscreen instructions. If you run into dependency conflicts while updating, see Resolving dependency conflicts.

If Eclipse indicates that no updates are available, while you are sure that an updated version has been released, please restart Eclipse. Similarly, if Eclipse indicates that an update site could not be found, simply restart Eclipse. Restarting Eclipse reinitializes the update system, and may for instance make updates available that have been released since you last started Eclipse.

Downgrading the toolsets

If you updated the toolsets in the past, you can downgrade to a previous version, as follows:

  • Open the Help menu of Eclipse, and choose About Eclipse, to open the About Eclipse window.
  • Click the Installation Details button, to open the Eclipse Installation Details window.
  • Switch to the Installation History tab.
  • From the Previous configurations list, select the previous configuration (collection of installed plugins) to which you want to downgrade.
  • Click the Revert button to revert (downgrade) to the selected configuration.
  • When the Revert Software Configuration dialog appears, to ask whether it is OK to restart the workbench, click Yes to proceed.
  • Wait for dependency resolving to complete. In case of dependency conflicts, Eclipse will try to compute a solution, and show the Install Remediation Page. Choose one of the suggested solutions. Click Next to continue with the modified installation request. For information on how to prevent dependency conflicts, as well as alternate ways to resolve them, see Resolving dependency conflicts.
  • Wait for the revert operation to complete.
  • When you get a ‘Security Warning’ with a message Warning: You are installing software that contains unsigned content..., you may ignore it. Just click OK to continue.
  • When asked to restart, click Yes.

Alternatively, if you have not previously updated the toolsets to newer versions, and still wish to downgrade to an older version, you can remove all your newer toolsets, and install the older versions afterward.

In order to downgrade to an older version, that version must still be available on the update site. Furthermore, all toolsets of our software must have the same version, in order to co-exist in your Eclipse installation. When trying to downgrade some toolsets, while keeping newer versions of the remaining toolsets, you are likely to run into dependency conflicts.

Updating Eclipse

To update Eclipse, simply update the toolsets. If a new version of Eclipse is available, it will be offered as an update as well. If for some reason an in-place update fails, you can try removing Eclipse, followed by installing the new version.

For both new major releases (generally released at the end of June), as well as new minor releases (generally released at the end of September and the end of February), you should be able to keep your current workspace. If however you run into trouble, you can try to remove your workspaces, and starting with a fresh one.

Updating Java

To update Java, follow these instructions: