Difference between revisions of "Windows Launching Issues"
| Line 1: | Line 1: | ||
<p> | <p> | ||
| − | Recent updates by Oracle, Microsoft and browser vendors have affected | + | Recent updates by Oracle, Microsoft and browser vendors have affected some of our Windows users, preventing them from launching the GSEA Desktop. After some research, we have some possible solutions that should help if you're having trouble. Note that these apply as of the writing of this page (June 22, 2015) but that further updates may affect them in the future. We will try to update the page should new issues come up. |
</p> | </p> | ||
<p> | <p> | ||
| − | Rather than deal with the how and why of those updates and their low-level details, | + | Rather than deal with the how and why of those updates and their low-level details, this page will focus on possible fixes. We will touch on some of the details towards the end for those users that need them. The short summary is that the issues are likely related to the use of 32-bit instead of 64-bit Java. |
</p> | </p> | ||
<p> | <p> | ||
| − | For completeness, it should be noted here that we are still evaluating Java 8 versus Java 7 at this time and do not yet officially support Java 8. We realize that | + | For completeness, it should be noted here that we are still evaluating Java 8 versus Java 7 at this time and do not yet officially support Java 8. We realize that many users may choose - or be forced - to upgrade to Java 8, however, so we are working towards supporting it as well. This page applies to both versions, though more than likely you'll receive Java 8 if you are using any automatic download features. |
</p> | </p> | ||
<p> | <p> | ||
| − | Note that these will progress from the <span style="font-weight: bold;">simplest</span> to the <span style="font-weight: bold;">most complex</span>. | + | Note that these solutions will progress from the <span style="font-weight: bold;">simplest</span> to the <span style="font-weight: bold;">most complex</span>. |
</p> | </p> | ||
<h2>Launch with 1 GB</h2> | <h2>Launch with 1 GB</h2> | ||
<p> | <p> | ||
| − | First, try launching from our [http://www.broadinstitute.org/gsea/downloads.jsp Downloads] page using the <span style="font-weight: bold;">1 GB</span>. | + | First, try launching from our [http://www.broadinstitute.org/gsea/downloads.jsp Downloads] page using the <span style="font-weight: bold;">1 GB</span>. That particular setting should be fine for use with small datasets and also is no issue with 32-bit Java. If you are having trouble launching GSEA, try this fix first, even if you have a large dataset. This will let you confirm that the issue is with 32-bit Java and not something else. |
</p> | </p> | ||
<p> | <p> | ||
| Line 20: | Line 20: | ||
<h2>Download the JAR file</h2> | <h2>Download the JAR file</h2> | ||
<p> | <p> | ||
| − | We make the GSEA Desktop available from the [http://www.broadinstitute.org/gsea/downloads.jsp Downloads] page primarily for users that have data connectivity issues, but it should allow you to | + | We make the GSEA Desktop available from the [http://www.broadinstitute.org/gsea/downloads.jsp Downloads] page primarily for users that have data connectivity issues, but it should also allow you to avoid this issue. More details are available in [http://www.broadinstitute.org/cancer/software/gsea/wiki/index.php/FAQ#Do_I_have_to_be_connected_to_the_internet_to_run_GSEA_software.3F This FAQ entry]. |
</p> | </p> | ||
<p> | <p> | ||
| − | You should be aware that there are a couple of downsides to this approach. First, you will not automatically get updates when you launch GSEA so you will need to periodically check for these on your own. | + | You should be aware that there are a couple of downsides to this approach. First, you will not automatically get updates when you launch GSEA so you will need to periodically check for these on your own. Second, 64-bit Java is still required if you are working with large datasets and need to run with more memory. If this is your situation then see the next section. |
</p> | </p> | ||
| − | <h2>Install | + | <h2>Install 64-bit Java</h2> |
<p> | <p> | ||
| − | If you have 32-bit Windows, this option is not available. Use one of the options above instead. Likewise, if you have | + | If you have 32-bit Windows, this option is not available. Use one of the options above instead. Likewise, if you have small datasets then don't worry about this option. |
</p> | </p> | ||
<p> | <p> | ||
| − | For 64-bit Windows users, it's possible to install | + | For 64-bit Windows users, it's possible to install 64-bit Java to allow analysis of larger datasets. While you may be thinking that you already have 64-bit Java, there is a good chance that you do not, due to recent browser changes: Mozilla Firefox, Google Chrome, and Internet Explorer are all affected, though in different ways. See [#Notes on browsers], below, for more details. |
</p> | </p> | ||
<p> | <p> | ||
| − | We recommend that you | + | We recommend that you first remove 32-bit Java and then install 64-bit Java using an offline installer. This should resolve the issues for most users with the least amount of hassle. Be <span style="font-weight: bold;">very careful</span> here; if you are uncomfortable uninstalling programs then you may wish to consult your IT staff or a more technically-inclined colleague for help. |
</p> | </p> | ||
| − | |||
<p> | <p> | ||
| − | Oracle | + | The Oracle website provides [https://java.com/en/download/help/uninstall_java.xml a help page on uninstalling Java from Windows]; go through those steps to remove any 32-bit versions of Java from your system. |
</p> | </p> | ||
<p> | <p> | ||
| − | + | The offline 64-bit Java installer is available from Oracle at [https://java.com/en/download/manual.jsp this page]. Download the file from there and follow their instructions. <span style="font-weight: bold;">Do not use Oracle's 'Download Java' page</span>; it will generally install 32-bit Java, which is how you got to this position in the first place. An offline Java installer will download the entire Java package up-front before installation, so you can be sure to have the correct installer. | |
</p> | </p> | ||
<p> | <p> | ||
| − | + | Note that Oracle makes it possible to have both 32-bit and 64-bit Java installed on your computer at the same time and in fact will default to 32-bit Java for many cases, so installing 64-bit Java is not enough to switch over. Most users will not need both; those that do should consult the [#More Technical Details] section below for further information. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
</p> | </p> | ||
<h2>More Technical Details</h2> | <h2>More Technical Details</h2> | ||
Revision as of 01:20, 24 June 2015
Recent updates by Oracle, Microsoft and browser vendors have affected some of our Windows users, preventing them from launching the GSEA Desktop. After some research, we have some possible solutions that should help if you're having trouble. Note that these apply as of the writing of this page (June 22, 2015) but that further updates may affect them in the future. We will try to update the page should new issues come up.
Rather than deal with the how and why of those updates and their low-level details, this page will focus on possible fixes. We will touch on some of the details towards the end for those users that need them. The short summary is that the issues are likely related to the use of 32-bit instead of 64-bit Java.
For completeness, it should be noted here that we are still evaluating Java 8 versus Java 7 at this time and do not yet officially support Java 8. We realize that many users may choose - or be forced - to upgrade to Java 8, however, so we are working towards supporting it as well. This page applies to both versions, though more than likely you'll receive Java 8 if you are using any automatic download features.
Note that these solutions will progress from the simplest to the most complex.
Contents
Launch with 1 GB
First, try launching from our Downloads page using the 1 GB. That particular setting should be fine for use with small datasets and also is no issue with 32-bit Java. If you are having trouble launching GSEA, try this fix first, even if you have a large dataset. This will let you confirm that the issue is with 32-bit Java and not something else.
Note: if you are having trouble launching GSEA, we recommend that you use the above Download page link rather than using any previously installed shortcut.
Download the JAR file
We make the GSEA Desktop available from the Downloads page primarily for users that have data connectivity issues, but it should also allow you to avoid this issue. More details are available in This FAQ entry.
You should be aware that there are a couple of downsides to this approach. First, you will not automatically get updates when you launch GSEA so you will need to periodically check for these on your own. Second, 64-bit Java is still required if you are working with large datasets and need to run with more memory. If this is your situation then see the next section.
Install 64-bit Java
If you have 32-bit Windows, this option is not available. Use one of the options above instead. Likewise, if you have small datasets then don't worry about this option.
For 64-bit Windows users, it's possible to install 64-bit Java to allow analysis of larger datasets. While you may be thinking that you already have 64-bit Java, there is a good chance that you do not, due to recent browser changes: Mozilla Firefox, Google Chrome, and Internet Explorer are all affected, though in different ways. See [#Notes on browsers], below, for more details.
We recommend that you first remove 32-bit Java and then install 64-bit Java using an offline installer. This should resolve the issues for most users with the least amount of hassle. Be very careful here; if you are uncomfortable uninstalling programs then you may wish to consult your IT staff or a more technically-inclined colleague for help.
The Oracle website provides a help page on uninstalling Java from Windows; go through those steps to remove any 32-bit versions of Java from your system.
The offline 64-bit Java installer is available from Oracle at this page. Download the file from there and follow their instructions. Do not use Oracle's 'Download Java' page; it will generally install 32-bit Java, which is how you got to this position in the first place. An offline Java installer will download the entire Java package up-front before installation, so you can be sure to have the correct installer.
Note that Oracle makes it possible to have both 32-bit and 64-bit Java installed on your computer at the same time and in fact will default to 32-bit Java for many cases, so installing 64-bit Java is not enough to switch over. Most users will not need both; those that do should consult the [#More Technical Details] section below for further information.
More Technical Details
Due to these recent browser changes, you either have to use an offline Java installer or reconfigure your browser. The first is the easiest option; see below.
Even if you do have 64-bit Java, it is also quite possible that Windows is configured to prefer 32-bit Java regardless. You can either uninstall 32-bit Java or reconfigure Windows to prefer 64-bit. The first is by far the easier option; see [#Uninstalling 32-bit Java] below. In fact, while information from Oracle says that it's possible to reverse this preference, in our tests we found that only complete removal of 32-bit Java would resolve the launching issues. See the [#More Technical Details] section below if you want to pursue this.
