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.
Difference between pages "FAQ How is Eclipse licensed?" and "FAQ I unzipped Eclipse, but it won't start. Why?"
| Line 1: | Line 1: | ||
| − | + | Invariably, with several hundred thousand downloads of Eclipse every month, | |
| − | + | Eclipse does not start at all for a few users . These failures | |
| − | + | typically stem from software configuration problems on the host machine | |
| − | + | or an unusual hardware configuration. If you are already a power Eclipse | |
| − | + | user, you might be tempted to skip this question. However, even the most | |
| − | you | + | advanced Eclipse user will occasionally have problems starting an Eclipse |
| − | + | build. So, with a nod to David Letterman, here | |
| + | is a “top ten” list of the most common start-up problems, along | ||
| + | with suggestions for solutions. | ||
| + | * ''Cannot find a VM''. Eclipse requires a JVM to run | ||
| + | and does not | ||
| + | include one in the download. You need to grab a VM yourself; the | ||
| + | Eclipse downloads page has pointers to where you can get one. | ||
| + | You may have a VM, but Eclipse cannot find it. To avoid possible | ||
| + | conflicts, always specify the VM you are using with the <tt>-vm</tt> | ||
| + | command-line argument.</li> | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| + | * ''Bad VM''. All versions of the Eclipse Platform require | ||
| + | at least a JDK 1.3 VM. Eclipse 3.0 requires a 1.4 VM. The Sun 1.4.0 VM | ||
| + | is known to be flaky, so you are best off with a recent 1.4.2 VM. | ||
| + | Also, you may not get much sympathy from Eclipse if you are using a home-grown | ||
| + | or experimental JVM. Use a reputable VM. If you run into trouble, | ||
| + | always try a VM from a major distributor and see whether the problem goes away. | ||
| + | </li> | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| + | * ''Unsupported platform''. Make sure that | ||
| + | the architecture and the operating | ||
| + | system of your machine match one of the supported systems | ||
| + | described in the file <tt>readme_eclipse.html</tt>. Eclipse will not run on Windows 95 or | ||
| + | Commodore 64, for example. If your machine does not match one | ||
| + | of the configurations | ||
| + | described in the readme, it may still run, but you are on your own!</li> | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| + | * ''Lack of appropriate native widget toolkit''. If you download, for | ||
| + | example, the GTK version of Eclipse, then you need to make sure | ||
| + | that you have GTK (GTK+ 2.1.1 or higher) on your computer and that it is | ||
| + | correctly installed.</li> | ||
| − | + | * ''Incorrectly unzipped''. Believe it or not, about once a month, a user | |
| + | reports start-up failure: The user has unzipped Eclipse without selecting the | ||
| + | use folder names option. Make sure that the result of unzipping | ||
| + | is an install tree with an <tt>eclipse</tt> directory at its root. | ||
| + | The Ark unzip utility in KDE is known to mangle Eclipse zips, so use | ||
| + | a different unzip program to install there.</li> | ||
| − | |||
| − | |||
| − | + | ||
| + | * ''New Eclipse unzipped on top of older Eclipse''. Do not do this. Either | ||
| + | install Eclipse in a brand new directory or use the Eclipse Update Manager | ||
| + | to upgrade an older Eclipse. You can still keep your old workspace. Look | ||
| + | in the Eclipse <tt>readme</tt> file for more details.</li> | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | * ''Buggy build''. It is not always user error. Some integration builds, and | ||
| + | even the odd stable build, will have start-up problems under certain | ||
| + | configurations that were not well tested. For example, build 3.0M6 | ||
| + | would fail to start up if you restarted with an old workspace after | ||
| + | unzipping new plug-ins into the <tt>plugins</tt> directory. | ||
| + | If you are a new user, | ||
| + | always start with the most recent official Eclipse release to be sure | ||
| + | you are using the “least buggy” version possible. | ||
| + | For more advanced users willing to accept less stable builds, | ||
| + | consult Bugzilla to see if your particular start-up problem has | ||
| + | already been reported. </li> | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | * ''Xerces problem''. Prior to Eclipse 3.0, Eclipse used a version of Xerces | ||
| + | for parsing XML files, but certain distributions of 1.4 JVMs included a | ||
| + | different version of Xerces with the same package names. This | ||
| + | should not be a problem with Eclipse 3.0 or higher. See | ||
| + | FAQ 108 for more details.</li> | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | * ''Disk full or out of memory''. Eclipse, especially 2.1 and earlier, does | ||
| + | not always gracefully report disk-full errors or out-of-memory errors. | ||
| + | Make sure that you have adequate disk space and that you are giving | ||
| + | the Java VM enough heap space. See FAQ 26 for details.</li> | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | * ''None of the preceding''. When all else fails, try asking on the eclipse.platform | ||
| + | newsgroup. Be extremely specific about what operating system, VM, | ||
| + | Eclipse build, hardware, and so on, you are running. Attach any error details | ||
| + | that you have found in the Eclipse error log. You will find, especially on | ||
| + | Linux and Mac, where configuration can be a lot more complicated, that | ||
| + | the community is fairly helpful in getting new users going and will | ||
| + | generally make an effort in proportion to the effort they perceive | ||
| + | that you have made. You are almost guaranteed | ||
| + | to get no response if you simply say, “Eclipse will not start.” | ||
| + | If a well-described newsgroup post does not get any response, enter | ||
| + | a bug report.</li> | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | == See Also: == | ||
| + | |||
| + | |||
| + | [[FAQ_How_do_I_increase_the_heap_size_available_to_Eclipse%3F]] | ||
| − | + | [[FAQ_Why_doesn%26%23146%3Bt_Eclipse_play_well_with_Xerces%3F]] | |
Revision as of 14:36, 14 March 2006
Invariably, with several hundred thousand downloads of Eclipse every month, Eclipse does not start at all for a few users . These failures typically stem from software configuration problems on the host machine or an unusual hardware configuration. If you are already a power Eclipse user, you might be tempted to skip this question. However, even the most advanced Eclipse user will occasionally have problems starting an Eclipse build. So, with a nod to David Letterman, here is a “top ten” list of the most common start-up problems, along with suggestions for solutions.
- Cannot find a VM. Eclipse requires a JVM to run
and does not include one in the download. You need to grab a VM yourself; the Eclipse downloads page has pointers to where you can get one. You may have a VM, but Eclipse cannot find it. To avoid possible conflicts, always specify the VM you are using with the -vm command-line argument.</li>
- Bad VM. All versions of the Eclipse Platform require
at least a JDK 1.3 VM. Eclipse 3.0 requires a 1.4 VM. The Sun 1.4.0 VM is known to be flaky, so you are best off with a recent 1.4.2 VM. Also, you may not get much sympathy from Eclipse if you are using a home-grown or experimental JVM. Use a reputable VM. If you run into trouble, always try a VM from a major distributor and see whether the problem goes away. </li>
- Unsupported platform. Make sure that
the architecture and the operating system of your machine match one of the supported systems described in the file readme_eclipse.html. Eclipse will not run on Windows 95 or Commodore 64, for example. If your machine does not match one of the configurations described in the readme, it may still run, but you are on your own!</li>
- Lack of appropriate native widget toolkit. If you download, for
example, the GTK version of Eclipse, then you need to make sure that you have GTK (GTK+ 2.1.1 or higher) on your computer and that it is correctly installed.</li>
- Incorrectly unzipped. Believe it or not, about once a month, a user
reports start-up failure: The user has unzipped Eclipse without selecting the use folder names option. Make sure that the result of unzipping is an install tree with an eclipse directory at its root. The Ark unzip utility in KDE is known to mangle Eclipse zips, so use a different unzip program to install there.</li>
- New Eclipse unzipped on top of older Eclipse. Do not do this. Either
install Eclipse in a brand new directory or use the Eclipse Update Manager to upgrade an older Eclipse. You can still keep your old workspace. Look in the Eclipse readme file for more details.</li>
- Buggy build. It is not always user error. Some integration builds, and
even the odd stable build, will have start-up problems under certain configurations that were not well tested. For example, build 3.0M6 would fail to start up if you restarted with an old workspace after unzipping new plug-ins into the plugins directory. If you are a new user, always start with the most recent official Eclipse release to be sure you are using the “least buggy” version possible. For more advanced users willing to accept less stable builds, consult Bugzilla to see if your particular start-up problem has already been reported. </li>
- Xerces problem. Prior to Eclipse 3.0, Eclipse used a version of Xerces
for parsing XML files, but certain distributions of 1.4 JVMs included a different version of Xerces with the same package names. This should not be a problem with Eclipse 3.0 or higher. See FAQ 108 for more details.</li>
- Disk full or out of memory. Eclipse, especially 2.1 and earlier, does
not always gracefully report disk-full errors or out-of-memory errors. Make sure that you have adequate disk space and that you are giving the Java VM enough heap space. See FAQ 26 for details.</li>
- None of the preceding. When all else fails, try asking on the eclipse.platform
newsgroup. Be extremely specific about what operating system, VM, Eclipse build, hardware, and so on, you are running. Attach any error details that you have found in the Eclipse error log. You will find, especially on Linux and Mac, where configuration can be a lot more complicated, that the community is fairly helpful in getting new users going and will generally make an effort in proportion to the effort they perceive that you have made. You are almost guaranteed to get no response if you simply say, “Eclipse will not start.” If a well-described newsgroup post does not get any response, enter a bug report.</li>
See Also:
FAQ_How_do_I_increase_the_heap_size_available_to_Eclipse?
[[FAQ_Why_doesn%26%23146%3Bt_Eclipse_play_well_with_Xerces%3F]]