Aktualizując starszą wersję platformy Eclipse, należy wykonać kilka prostych czynności w celu przeprowadzenia migracji obszaru roboczego do nowszej wersji. Obszar roboczy to katalog na dysku z wszystkimi plikami projektów oraz metadanymi, takimi jak dostosowane preferencje. Czynności do wykonania zależą od tego, czy podczas uruchamiania platformy Eclipse określono argument wiersza komend "-data". Użycie argumentu "-data" jest zalecane, ponieważ pozwala na jednoznaczne określenie położenia obszaru roboczego.
Wskazówka: Przed aktualizacją zaleca się wykonanie kopii zapasowej obszaru roboczego. Po zaktualizowaniu obszaru roboczego nie będzie możliwe jego ponowne użycie ze starszą wersją platformy Eclipse. Do przywrócenia "poprzedniej" wersji niezbędna będzie kopia zapasowa.
Okno dialogowe wyboru obszaru roboczego pozwala wybrać położenie obszaru roboczego. Jest ono wyświetlane przy pierwszym uruchamianiu w przypadku, gdy nie został użyty argument -data. Domyślnym położeniem wyświetlanym w tym oknie dialogowym jest podkatalog głównego katalogu użytkownika o nazwie "workspace" (na przykład C:\Documents and Settings\Nazwa użytkownika\workspace).
Nowi użytkownicy wersji 3.1 mogą pozostawić domyślne lub podać inne położenie, jednak nie powinni oni umieszczać tego katalogu w katalogu instalacyjnym środowiska Eclipse. Nie powinno się także kopiować obszaru roboczego, ponieważ może on zawierać metadane z bezwzględnymi ścieżkami w systemie plików, które staną się niepoprawne po skopiowaniu obszaru roboczego w inne miejsce.
W środowisku Eclipse w wersji 3.0 i wcześniejszych domyślnym położeniem dla katalogu obszaru roboczego był podkatalog katalogu platformy Eclipse. Jeśli na przykład plik eclipse.exe znajdował się w katalogu D:\eclipse-SDK-3.0.1\eclipse, domyślnym położeniem katalogu obszaru roboczego był katalog D:\eclipse-SDK-3.0.1\eclipse\workspace.
Aby załadować obszar roboczy utworzony przy użyciu wersji 3.0 lub wcześniejszej, wystarczy w oknie dialogowym wyboru obszaru roboczego wskazać stary katalog obszaru roboczego, niezależnie od położenia tego katalogu.
Jeśli argument "-data" był używany do uruchamiania platformy Eclipse, aktualizacja jest dużo prostsza:
Patrz przykład w poprzedniej sekcji.
Jeśli w środowisku Eclipse zainstalowano inne moduły dodatkowe, należy je dodawać do każdej nowej wersji lub podwersji instalowanej platformy Eclipse. Przed wykonaniem tej czynności należy zapoznać się z dokumentacją modułów dodatkowych, aby sprawdzić, czy są one zgodne z wersją platformy Eclipse, do której są przenoszone. Moduły dodatkowe można dodać do nowej instalacji Eclipse na kilka sposobów: