Hvis du har en eldre versjon av Eclipse som du vil oppdatere til en nyere versjon, må du følge noen enkle trinn for å migrere arbeidsområdet til den nye versjonen. Arbeidsområdet er katalogen på disken som inneholder alle prosjektfilene og metadataene, for eksempel tilpassede preferanser. Hvilke oppgraderingstrinn som skal utføres, avhenger av om du bruker kommandolinjeargumentet "-data" når du starter Eclipse. Argumentet "-data" anbefales fordi det tydelig angir plasseringen av arbeidsområdet.
Tips: Sikkerhetskopier arbeidsområdet før du oppgraderer. Et arbeidsområde som er oppgradert, vil ikke kunne brukes med eldre versjoner av Eclipse. Du vil trenge sikkerhetskopien hvis du vil gå "tilbake" til en tidligere versjon.
I dialogboksen for arbeidsområdevelgeren kan du velge plassering for arbeidsområdet. Denne dialogboksen blir vist ved første oppstarting dersom argumentet -data ikke finnes. Standardplasseringen i denne dialogboksen er en "workspace-katalog" som er underordnet hjemmekatalogen (for eksempel C:\Documents and Settings\Brukernavn\workspace.)
Med mindre du har et eksisterende arbeidsområde fra en tidligere Eclipse-versjon, kan du beholde denne standarden eller velge en annen plassering. Du bør ikke plassere arbeidsområdet inne i Eclipse-installeringskatalogen, for det vil gjøre det vanskeligere å oppgradere til en nyere versjon av Eclipse. Du bør ikke kopiere eller flytte arbeidsområdekatalogen, for den kan inneholder metadata med absolutte filbaner, som vil være ugyldige hvis arbeidsområdet kopieres til et annet sted.
I Eclipse 3.0 og tidligere var Eclipse-standardplasseringen arbeidsområdet i Eclipse-katalogen. Hvis for eksempel eclipse.exe var plassert i banen D:\eclipse-SDK-3.0.1\eclipse, var standard arbeidsområdeplassering D:\eclipse-SDK-3.0.1\eclipse\workspace.
Hvis du vil laste inn arbeidsområder som ble opprettet i 3.0 eller tidligere versjoner, bør du peke på den gamle arbeidsområdekatalogen ved hjelp av arbeidsområdevelgeren, enten den ligger i den gamle installeringskatalogen eller et annet sted.
Hvis du har brukt argumentet "-data" til å starte Eclipse, er oppgraderingstrinnene mye enklere:
Dette illustreres i eksempelet i et av avsnittene ovenfor.
Hvis du har installert ekstra plugin-moduler i Eclipse-miljøet, må du legge til disse nye plugin-modulene i hvert nytt bygg eller versjon som du installerer av Eclipse. Før du kan gjøre dette, må du lese dokumentasjonen for disse plugin-modulene for å forsikre deg om at de er kompatible med den versjonen av Eclipse som du migrerer til. Du kan legge til disse ekstra plugin-modulene i den nye Eclipse-installasjonen på flere måter: