Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "FAQ How do I upgrade Eclipse IDE?"

m (Upgrading from previous versions to Neon (4.6) is NOT supported)
(Upgrading existing Eclipse IDE and Installed Features to newer release)
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
== Upgrading existing Eclipse IDE and Installed Features to newer release ==
 
== Upgrading existing Eclipse IDE and Installed Features to newer release ==
  
From 4.6, to upgrade Eclipse IDE to the next full release (for example, from 4.6 to 4.7)''
+
To upgrade Eclipse IDE to the next major release
# You first need to [http://help.eclipse.org/oxygen/index.jsp?topic=%2Forg.eclipse.platform.doc.user%2Ftasks%2Ftasks-128.htm add the new release's repository] as follows:
+
# You first need to [http://help.eclipse.org/photon/index.jsp?topic=%2Forg.eclipse.platform.doc.user%2Ftasks%2Ftasks-128.htm add the new release's repository] as follows:
 
## Window > Preferences > Install/Update > Available Software Sites
 
## Window > Preferences > Install/Update > Available Software Sites
 
## Click 'Add'
 
## Click 'Add'
## Enter the URL of the new repository (for example, http://download.eclipse.org/releases/oxygen/ for Oxygen (4.7)). <!-- TODO update when Oxygen is released -->
+
## Enter the URL of the new repository (for example, http://download.eclipse.org/releases/2018-09/ ). <!-- TODO update when Oxygen is released -->
 
<!-- Important: Followup https://bugs.eclipse.org/bugs/show_bug.cgi?id=483786 about URL pattern -->
 
<!-- Important: Followup https://bugs.eclipse.org/bugs/show_bug.cgi?id=483786 about URL pattern -->
 
## Click 'Ok'
 
## Click 'Ok'
# [http://help.eclipse.org/oxygen/index.jsp?topic=%2Forg.eclipse.platform.doc.user%2Ftasks%2Ftasks-120.htm Help > Check for Updates]
+
# [http://help.eclipse.org/photon/index.jsp?topic=%2Forg.eclipse.platform.doc.user%2Ftasks%2Ftasks-120.htm Help > Check for Updates]
 
#If updates are found, proceed through the install wizard and restart the IDE when prompted. Otherwise, read carefully the error message to find out which component is conflicting and establish your resolution strategy.
 
#If updates are found, proceed through the install wizard and restart the IDE when prompted. Otherwise, read carefully the error message to find out which component is conflicting and establish your resolution strategy.
 +
 +
== Always enable major upgrades ==
 +
 +
To always enable major upgrades of your IDE once and for all:
 +
# from the ''Available Software Sites'' preference page
 +
# enable the ''Latest Eclipse release http://download.eclipse.org/releases/latest'' repository by ticking the checkbox.
 +
# Apply and Close
 +
# Check for updates
 +
 +
The similar workflow can be used to hide and disable automatic proposal of major upgrades.
  
 
== Beta-testing milestones and release candidates ==
 
== Beta-testing milestones and release candidates ==

Revision as of 10:48, 20 September 2018

Upgrading existing Eclipse IDE and Installed Features to newer release

To upgrade Eclipse IDE to the next major release

  1. You first need to add the new release's repository as follows:
    1. Window > Preferences > Install/Update > Available Software Sites
    2. Click 'Add'
    3. Enter the URL of the new repository (for example, http://download.eclipse.org/releases/2018-09/ ).
    4. Click 'Ok'
  2. Help > Check for Updates
  3. If updates are found, proceed through the install wizard and restart the IDE when prompted. Otherwise, read carefully the error message to find out which component is conflicting and establish your resolution strategy.

Always enable major upgrades

To always enable major upgrades of your IDE once and for all:

  1. from the Available Software Sites preference page
  2. enable the Latest Eclipse release http://download.eclipse.org/releases/latest repository by ticking the checkbox.
  3. Apply and Close
  4. Check for updates

The similar workflow can be used to hide and disable automatic proposal of major upgrades.

Beta-testing milestones and release candidates

The same process as above can be used to enable update to milestones or release candidates of the Eclipse IDE (which have already been partially tested before being published, but might still contain unknown issues for you to report to Bugzilla). The only difference is that you should add the 2 following URLs as Available sites before running Check for updates in order to let Eclipse IDE locate the milestones/release-candidates:

Note: The sites for the future release are not created immediately upon previous release and are usually produced from M4 (~December)

Fresh install

If you prefer not performing an update (for example because some 3rd-party content isn't ready for the current release of Eclipse IDE so the update reports conflicts), you can still download a fresh install of the Eclipse IDE and install it in another location on your filesystem, and use it together with the previous version.

To do so, download a new build from the Eclipse download Web site (https://www.eclipse.org/downloads/eclipse-packages/) and run the installer or unzip the archive in a new directory. We strongly recommend against installing/unzipping over your existing version of Eclipse IDE as it may corrupt your installation.

When you start a new version of Eclipse IDE, you can use the same existing workspace folder that you were using with older version. The workspace will be migrated to newer version and Eclipse IDE will to reuse all configuration. The workspace is forward compat

Windows specifics

If Eclipse IDE is installed in a restricted directory, upgrades may require administrator privileges to succeed and may fail with error messages claiming "Only one of the following can be installed:" otherwise. Start Eclipse with "Run as administrator...".

Older versions (deprecated)

Upgrading from previous versions to Neon (4.6) is NOT supported

Upgrading from Mars (4.5) and older Eclipse IDE package to Neon (4.6) is NOT supported NOTE: Due to structural changes you cannot update from a Mars (or prior) all-in-one package to a Neon version. If interested in the technical details, see bug 332989 and bug 490515. So to use Eclipse Neon IDE, you have to go for a #Fresh Install. From Neon to Oxygen and later, the usual upgrade process detailed below works.

Upgrading from Ganymede (3.4)

If you're using Ganymede (3.4): To upgrade installed software, do the following:

  1. Help > Software Updates...
  2. Switch to the 'Installed Software' pane
  3. Select one or more installed items to be upgraded. If nothing is selected, it will search for updates to all installed software
  4. Select 'Update', and proceed through the wizard if updates are found

Upgrading from Europa (3.3) and below

If you're using Europa (3.3) and below: Run the Update Manager, using Help > Software Updates > Find and Install... > Search for updates of the currently installed features. The Update Manager will visit the Update site(s) for all your installed features/plugins and offer updates if any exist. However, in Eclipse 3.3 or earlier, it is NOT possible to upgrade the Eclipse platform itself, only its features. So, you could for example upgrade the CVS feature or the PDE feature from 3.2.0 to 3.2.1, but not eclipse.exe itself.

Upgrading Other Features

Upgrading other features (like CDT, PDT, WTP...) can be done without the need to download a new platform binary, but because many projects align very closely (eg., the Eclipse 3.2 / Callisto or Eclipse 3.3 / Europa release trains) you will likely need to upgrade the Eclipse platform as well.

See Also:



This FAQ was originally published in Official Eclipse 3.0 FAQs. Copyright 2004, Pearson Education, Inc. All rights reserved. This text is made available here under the terms of the Eclipse Public License v1.0.

Back to the top