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.
SDK Known Issues
Contents
Installing
I downloaded and extracted the ZIP file - how do I install Eclipse?
You don't need to install Eclipse. In the extracted folder, simply double-click the eclipse.exe executable file.
Windows issues
I am prompted for a password when extracting the ZIP file
This is a known issue with the Windows extraction utility. Try using a third-party extraction tool:
Extracting the ZIP file fails
This could be caused by the the Windows built-in extraction utility (as with the password problem above). Try using a third-party extraction tool as described above.
If still get errors such as the "The filename is too long" or similar wording, it is most likely because you are trying to extract Eclipse into a root directory that has a lengthy path, for example c:\JavaDevelopment\Eclipse\3.4. The Eclipse packages have some deeply nested paths in them, and when combined with a long root installation path, the resulting final path for some files can exceed limits set by Windows' file system. To avoid this problem, try extracting the ZIP file to a shorter root location, such as c:\Eclipse.
Bug 166597 has a lengthy discussion about this issue.
Linux issues
Eclipse using GCJ
Most Linux distributions ship with the GNU Compiler for Java (GCJ). Although Eclipse is known to run on GCJ, it is not a reference platform for Eclipse, and therefore it is not tested. It is recommended that a Sun, IBM, or BEA JVM be used instead. See also the Eclipse platform 3.3 reference platforms list.
See also Eclipse.ini for instructions on how to specify a particular JVM (because on many Linux systems gcj is picked up as the default JVM even when Sun's is installed).
Eclipse on Gentoo Linux
If you are running Gentoo Linux, you may see the following error message when you start Eclipse:
* run-java-tool is not available for sun-jdk-1.6 on i686 * IMPORTANT: some Java tools are not available on some VMs on some architectures
This is a known bug, please see here and bug 176021.