Visualizer launching problems and other Java related issues
Posted by David Eby on Wednesday, July 17, 2013 at 11:23AM
We have recently been getting many reports from users having trouble launching GenePattern visualizers - HeatMapViewer, HierarchicalClusteringViewer, PCAViewer and so on - especially on Mac computers. There have also been reports of issues with running the GenePattern installer and using the File Uploader. If you are experiencing any of these problems the following suggestions might help you. These components use the Java platform and the problems all seem to trace to a recent set of Java updates from Oracle and Apple. In particular, many problem reports come from users with Java 7 Update 25 on Mac OS X 10.7 and above or Java 6 Update 51 on OS X 10.6. Issues have been reported with other combinations, but less frequently.
These are the latest updates of Java available for these platforms and came out within the last several weeks, so you may or may not have already applied this change depending on the update policies of your organization and the settings on your own computer. Java 7 update 25 may also be known as:
Java SE 7 Update 25
Java 7u25, JRE 7u25 or JDK 7u25
JRE 1.7.0_25 or JDK 1.7.0_25
Java 6 update 51 may also be known as:
Java SE 6 Update 51
Java 6u51, JRE 6u51 or JDK 6u51
JRE 1.6.0_51 or JDK 1.6.0_51
Java for Mac OS X 10.6 Update 16
While it is unclear exactly what is causing the problems, simply re-installing the update has solved the problem for a number of users. This worked even though Java had reported that it was up to date on the users' system. We suspect that the issue is not with the Java update itself, but rather with the way that it was installed by the Java or Apple auto-update process. To re-install, we recommend taking the following steps:
Download the update package in question from either Oracle or Apple:
Uninstall any existing copy of Java 7. Instructions are here.
Exit all web browsers and any other programs which rely on Java.
Re-install Java from the downloaded package.
Restart the computer.
If this does not solve your visualizer issues, please consult our FAQ for some other known issues regarding visualizers and ComparativeMarkerSelectionViewer. This earlier blog posting deals with some issues in earlier versions of Java 6 and Java 7. Note also that we are currently in the process of updating our visualizers to be compatible with Java 7. Most have been updated, but Multiplot in particular is still being tested. We anticipate a Beta release shortly.
On the Mac platform, the Java 7 plug-in is not compatible with the Chrome web browser. This is a general issue with Java 7 and Chrome on Mac OS X and not specific to GenePattern. Details are here. We recommend Firefox or Safari to use visualizers on Mac OS X, though special steps are required for Safari to work.
The latest updates to Java and Safari have automatically disabled Java applets on web pages. On any page with an applet, Safari will display a message asking if you wish to allow it and walk you through the
steps permitting you to re-enable applets for the site. Unfortunately, a bug in our visualizer pages is preventing these messages from being displayed. As a work-around, you can instead enable applets through the File Uploader component; doing so will enable all applets on the GenePattern web site.
First, enable Java in the Safari preferences (Safari menu -> Preferences -> Security).
Click the Uploads tab in the top right corner, then click the context menu button next to the "uploads" folder, choosing the Upload Files menu selection.
This will launch the File Uploader component. Safari will prompt whether you wish to Block or Allow it. Click 'Allow'.
Safari will respond with a security warning dialog. Check the box labeled "I accept the risk and want to run this application". Clicking "Show Options" gives you the additional option to always allow apps from this location; checking this box will allow all applets from the GenePattern web site. Doing so should allow the visualizers to work as well. Click "Run" to apply these changes.
After these steps are complete, the File Uploader component should be open and enabled.
Feel free to close this and try visualizers from your Job Results. When you close the window, Safari may bring up an additonal Security Warning, again prompting you whether or not to Block this applet. Click "Don't Block" at this point. After this, visualizers and other components should be enabled for you on the GenePattern web site.