Difference between revisions of "FAQ I unzipped Eclipse, but it won't start. Why?"

From Eclipsepedia

Jump to: navigation, search
 
m (Formatted)
Line 1: Line 1:
Invariably, with several hundred thousand downloads of Eclipse every month,  
+
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.
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
+
* ''Cannot find a VM''.
and does not
+
  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>
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
+
* ''Bad VM''.
at least a JDK 1.3 VM.  Eclipse 3.0 requires a 1.4 VM.  The Sun 1.4.0 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>
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  
+
* ''Unsupported platform''.
the architecture and the operating
+
  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>
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
+
* ''Lack of appropriate native widget toolkit''.
example, the GTK version of Eclipse, then you need to make sure
+
  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>
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
+
* ''Incorrectly unzipped''.
reports start-up failure: The user has unzipped Eclipse without selecting the  
+
  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>
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
+
* ''New Eclipse unzipped on top of older Eclipse''.
install Eclipse in a brand new directory or use the Eclipse Update Manager
+
  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>
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
+
* ''Buggy build''.
even the odd stable build, will have start-up problems under certain
+
  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 &#147;least buggy&#148; 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>
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 &#147;least buggy&#148; 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  
+
* ''Xerces problem''.
for parsing XML files, but certain distributions of 1.4 JVMs included a  
+
  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>
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
+
* ''Disk full or out of memory''.
not always gracefully report disk-full errors or out-of-memory errors.
+
  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>
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
+
* ''None of the preceding''.
newsgroup.  Be extremely specific about what operating system, VM,
+
  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, &#147;Eclipse will not start.&#148; If a well-described newsgroup post does not get any response, enter a bug report.</li>
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, &#147;Eclipse will not start.&#148;
+
If a well-described newsgroup post does not get any response, enter  
+
a bug report.</li>
+
  
  

Revision as of 05:33, 28 October 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’t_Eclipse_play_well_with_Xerces?