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) Double-click the [Macintosh HD]-[Applications]-[Utilities]-[Java Preferences] icon, then the Java Preferences window appears.



2) Choose 'Network' tab.



3) Press 'Delete Files...' button and click 'OK' on the subsequent confirmation dialog.

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.