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

From Eclipsepedia

Jump to: navigation, search
(Recent - Galileo (Eclipse 3.5) and beyond)
(14 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 
== Upgrading Existing Eclipse Features ==
 
== Upgrading Existing Eclipse Features ==
  
=== Eclipse 3.5 and beyond ===
+
=== Recent - Galileo (3.5) and beyond ===
To upgrade installed software, do the following:
+
# If upgrading the platform itself to the next full release (for example, from 4.2 to 4.3), you first need to add the new release's repository as follows:
 
+
## Window > Preferences > Install/Update > Available Software Sites
 +
## Click 'Add'
 +
## Enter the URL of the new repository (for example, http://download.eclipse.org/releases/kepler/ for Kepler and Eclipse 4.3)
 +
## Click 'Ok'
 
#Help > Check for Updates
 
#Help > Check for Updates
 
#If updates are found, proceed through the install wizard and click Finish at the end
 
#If updates are found, proceed through the install wizard and click Finish at the end
#If you are upgrading the platform itself, when you are prompted to restart it is strongly recommended to do so. A restart many not be required when updating other features, but always select to restart if you are unsure.
+
#If upgrading the platform itself, when you are prompted to restart it is strongly recommended to do so. A restart may not be required when updating other features, but always select to restart if you are unsure.
 
+
#Check your Available Software Sites for release-specific update sites that may need updating as well, e.g. ''The Eclipse Project Updates'' URL changes with each release (typically release-specific sites hold the SDK/Source features and off-cycle hot fixes and are not required)
 
+
#Help > Install New Software...
+
#Select a site to search, or select 'All Available Sites' from the drop-down menu. Use 'Add Site...' to add additional sites to be searched.
+
#Use the search box to narrow down what you are looking for, select the items to install, and click Next
+
#Continue through the wizard and click Finish at the end
+
  
===Eclipse 3.4 ===
+
===Ganymede (3.4) ===
 
To upgrade installed software, do the following:
 
To upgrade installed software, do the following:
  
 
#Help > Software Updates...
 
#Help > Software Updates...
 
#Switch to the 'Installed Software' pane
 
#Switch to the 'Installed Software' pane
#Select one or more installed items to be upgraded
+
#Select one or more installed items to be upgraded. If nothing is selected, it will search for updates to all installed software
 +
#Select 'Update', and proceed through the wizard if updates are found
  
#Select existing items or use 'Add Site...' to add new features...
+
===Europa (3.3) and below===
 
+
===Eclipse 3.3 and below===
+
  
 
Run the Update Manager, using  
 
Run the Update Manager, using  
Line 32: Line 29:
 
The Update Manager will visit the Update site(s) for all your installed features/plugins and offer updates if any exist.
 
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.  
+
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.
  
 
== Fresh install ==
 
== Fresh install ==
Occasionally you won't be able to upgrade Eclipse or certain features due to incompatible changes in the updte technology. In these cases you will need to download a fresh install.
+
Occasionally you won't be able to upgrade Eclipse or certain features due to incompatible changes in the update technology. In these cases you will need to download a fresh install.
 
Download a new build from the Eclipse download Web site (http://www.eclipse.org/downloads)  and unzip it in a new directory. We strongly recommend against unzipping over your existing Eclipse version as unexpected side effects may occur, including (but not limited to): nausea, vomitting, shortness of breath, corrupt installation.  
 
Download a new build from the Eclipse download Web site (http://www.eclipse.org/downloads)  and unzip it in a new directory. We strongly recommend against unzipping over your existing Eclipse version as unexpected side effects may occur, including (but not limited to): nausea, vomitting, shortness of breath, corrupt installation.  
  
 
Complete upgrade instructions are always included in the Eclipse <tt>readme_eclipse.html</tt> file included with every build in the <tt>readme</tt> directory.
 
Complete upgrade instructions are always included in the Eclipse <tt>readme_eclipse.html</tt> file included with every build in the <tt>readme</tt> directory.
 +
 +
== Windows specifics ==
 +
 +
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...".
  
 
== Upgrading Other Features ==
 
== Upgrading Other Features ==
Line 48: Line 49:
 
* [[FAQ_How_do_I_update_Eclipse%3F]]
 
* [[FAQ_How_do_I_update_Eclipse%3F]]
 
* [[FAQ_What_is_the_Update_Manager%3F]]
 
* [[FAQ_What_is_the_Update_Manager%3F]]
 +
* [http://stackoverflow.com/questions/17337526/how-to-upgrade-eclipse-for-java-ee-developers-from-juno-to-kepler How to upgrade Eclipse for Java EE Developers from Juno to Kepler?]
  
  
  
 
+
{{Template:FAQ_Tagline}}
<hr><font size=-2>This FAQ was originally published in [http://www.eclipsefaq.org Official Eclipse 3.0 FAQs]. Copyright 2004, Pearson Education, Inc. All rights reserved. This text is made available here under the terms of the [http://www.eclipse.org/legal/epl-v10.html Eclipse Public License v1.0].</font>
+
  
 
[[Category:FAQ]]
 
[[Category:FAQ]]

Revision as of 14:46, 1 August 2013

Contents

Upgrading Existing Eclipse Features

Recent - Galileo (3.5) and beyond

  1. If upgrading the platform itself to the next full release (for example, from 4.2 to 4.3), 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/kepler/ for Kepler and Eclipse 4.3)
    4. Click 'Ok'
  2. Help > Check for Updates
  3. If updates are found, proceed through the install wizard and click Finish at the end
  4. If upgrading the platform itself, when you are prompted to restart it is strongly recommended to do so. A restart may not be required when updating other features, but always select to restart if you are unsure.
  5. Check your Available Software Sites for release-specific update sites that may need updating as well, e.g. The Eclipse Project Updates URL changes with each release (typically release-specific sites hold the SDK/Source features and off-cycle hot fixes and are not required)

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

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.

Fresh install

Occasionally you won't be able to upgrade Eclipse or certain features due to incompatible changes in the update technology. In these cases you will need to download a fresh install. Download a new build from the Eclipse download Web site (http://www.eclipse.org/downloads) and unzip it in a new directory. We strongly recommend against unzipping over your existing Eclipse version as unexpected side effects may occur, including (but not limited to): nausea, vomitting, shortness of breath, corrupt installation.

Complete upgrade instructions are always included in the Eclipse readme_eclipse.html file included with every build in the readme directory.

Windows specifics

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...".

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.