Trouble shooting

Certificate error on applet
When you use JRE6 Update15 (1.6.0_15) or JRE6 Update16 (1.6.0_16) on Windows or Linux, jV applet and applet-launcher fail to start up with the following error.

Error:java.io.IOException:Cannot find certificates for JNLP AppletLauncher class

Please use JRE6 Update17 (1.6.0_17) or later.

JOGL library conflict
If you cannot start jV via Java Web Start or view jV applets due to a failure of locating the JOGL library, try the followings.

clear cached files
On JRE of version 1.6.0_15 and 1.6.0_16, previously cached JOGL files cause a problem even if newer files are placed on the server. JRE of version 1.6.0_17 or later is recommended. On Mac OS X Snow Leopard, however, the latest JRE is of version 1.6.0_15 at the moment. The following steps show how to clear cached files.


 * 1) Open the Java Preferences window
 * Double-click the [Java Preferences] icon, then the Java Preferences window appears. The place of [Java Preferences] depends on the version of Mac OS as following:
 * {|style="border:1px solid gray;border-collapse:collapse"

!style="border:1px solid gray;padding:0 0.5em;background-color:lightyellow"|Max OS X version !style="border:1px solid gray;padding:0 0.5em;background-color:lightyellow"|place
 * style="border:1px solid gray;padding:0 0.5em"|10.4
 * style="border:1px solid gray;padding:0 0.5em"|[Applications]-[Utilities]-[Java]-[J2SE 5.0]
 * style="border:1px solid gray;padding:0 0.5em"|10.5 (before installing Java for Mac OS X 10.5 Update 4)
 * style="border:1px solid gray;padding:0 0.5em"|[Applications]-[Utilities]-[Java]
 * style="border:1px solid gray;padding:0 0.5em"|10.5 (after installing Java for Mac OS X 10.5 Update 4 or later)
 * style="border:1px solid gray;padding:0 0.5em"|[Applications]-[Utilities]
 * style="border:1px solid gray;padding:0 0.5em"|10.6
 * style="border:1px solid gray;padding:0 0.5em"|[Applications]-[Utilities]
 * }
 * The contents of the [Java Preferences] differ for the version of Mac OS. In case 10.4, use the [General] tab, which is default displayed. In case 10.5 or later, click to display [Network] tab.
 * {|style="border:1px solid gray;border-collapse:collapse"
 * style="border:1px solid gray;padding:0 0.5em"|[Applications]-[Utilities]
 * }
 * The contents of the [Java Preferences] differ for the version of Mac OS. In case 10.4, use the [General] tab, which is default displayed. In case 10.5 or later, click to display [Network] tab.
 * {|style="border:1px solid gray;border-collapse:collapse"

!style="border:1px solid gray;padding:0 0.5em;background-color:lightyellow"|Max OS X 10.4 !style="border:1px solid gray;padding:0 0.5em;background-color:lightyellow"|Max OS X 10.5 or later
 * style="border:1px solid gray;padding:0.5ex 0.5em;text-align:center;vertical-align:top"|Javapref_tiger.png
 * style="border:1px solid gray;padding:0.5ex 0.5em;text-align:center;vertical-align:top"|Java_prefs1.png &darr; Java_prefs2.png
 * }
 * }


 * 2) Press 'Delete Files...' button
 * The [Delete Temporary Files] window, which asks which items are to remove, will be opened.


 * [[File:Javacache_del_en.png]]


 * 3) Leave all the checkboxs on and click 'OK' button.


 * 4) In some case, restoring the Java environment to the default may be also required.
 * To do it, click "Restore Defaults" button in the Java Preferences (the following figure is the case of Mac OS X 10.6).
 * [[File:Javapref_general_10_6.png]]

remove local JOGL library
Locally-installed JOGL libraries of different version cause conflicts with Java Web Start technology. JOGL library files are different between operating systems.

Mac OS X

Open the [Macintosh HD]-[Library]-[Java]-[Extensions] folder. If some of the following files


 * jogl.jar
 * gluegen-rt.jar
 * libjogl.jnilib
 * libjogl_awt.jnilib
 * libjogl_cg.jnilib
 * libgluegen-rt.jnilib

exist in the folder, remove them. Here, this operation requires root privilege.

Windows

Files that should be removed are as follows.


 * \lib\ext\jogl.jar
 * \lib\ext\gluegen-rt.jar
 * \bin\jogl.dll
 * \bin\jogl_cg.dll
 * \bin\jogl_awt.dll
 * \bin\gluegen-rt.dll

Here,  denotes the folder that JRE has been installed; typically =C:\Program Files\Java\jre6.

Linux

Files that should be removed are as follows.


 * /lib/ext/jogl.jar
 * /lib/ext/gluegen-rt.jar
 * /lib/ /libjogl.so
 * /lib/ /libjogl_cg.so
 * /lib/ /libjogl_awt.so
 * /lib/ /libjogl_drihack.so
 * /lib/ /libgluegen-rt.so

Here,  denotes the directory that JRE has been installed; typically <JRE>=/usr/java/jdk1.6.0_17/jre, and the processor architecture such as =i386.

jV applet with Internet Explorer
When visiting a web page that contains a jV applet with Internet Explorer, there sometimes occurs trouble in working with native JOGL libraries especially on Windows Vista. Please use Firefox web browser in that case.

Class not found error on applet
When you use JRE6 Update21 (1.6.0_21) with the next-generation Java Plug-in enabled on Windows or Linux, the following error occurs for the combination of jV applet and applet-launcher.

Error: Class not found: org.pdbj.viewer.gui.ViewerApplet

You can avoid this problem by disabling the next-generation Java Plug-in. Here is how to do that for Windows users. On Linux platform, users can manually replace the symbolic link to new plug-in <tt>libnpjp2.so</tt> with the symbolic link to classic plug-in <tt>libjavaplugin_oji.so</tt> (see this page for help). If you are using firefox 3.6 or later, however, you need to downgrade JRE to 1.6.0_20 because firefox of those versions run applets only with the new Java Plug-in. To get JRE 1.6.0_20, see this page.

The jV applet can't be displayed on Mac + Firefox/Safari/Google Chrome
The Mac OS and browser described below can't display jV applets. To display them, please downgrade the browser or use another browser such as Opera, Camino, or Shiira. We are sorry for the inconvenient.
 * OS
 * Mac OS X 10.5 update 4 or later


 * Browser
 * Firefox 6.0 or later
 * Safari 5.1 or later
 * Google Chrome
 * Reason
 * You can specify which Java Plug-in is to use at the Java Preferences. If you select 'In their own process' to use new Java Plug-in, and select 'Within the browser process' to use classic Java Plug-in. But none the less, Firefox 6.0 or later, Safari 5.1 or later and Google Chrome force to use new Java Plug-in. Currently the new Java Plug-in for Mac doesn't support hardware-accelerated technologies like JOGL and Java3D, so the jV applet under these environment can't be displayed.


 * The Windows and Linux users don't affect this problem.
 * The Firefox 5.0 or older can display jV applets even if on Mac OS.
 * The Safari 5.0 or older can display jV applets even if on Mac OS.

Resolved: jV version 4.1 runs on Mac + latest Firefox/Safari/Google Chrome.

The jV applet can't be displayed on Mac with JRE 1.6.0_29
The Mac OS with JRE6 Update29 (1.6.0_29) cannot display jV applets on any browser at the moment. In JRE 1.6.0_29, the classic Java Plug-in has been removed and only new Java Plug-in is available. However, the current version of JOGL library does not work with the new Java Plug-in. The issue will be resolved by the next release of JOGL library. We are sorry for the inconvenience.

Resolved: jV version 4.1 runs on Mac with JRE 1.6.0_29.