Troubleshooting the Applet

When the applet fails to start:
  1. Make sure that your web browser really runs the next generation Java plug-in and not the legacy Java plug-in.

    For Windows and OS X the procedure is straight forward. Some steps are given below for installing the Java plug-in on Linux.

    Manual Installation and Registration of Java Plugin for Linux: http://www.oracle.com/technetwork/java/javase/manual-plugin-install-linux-136395.html

  2. Refresh the web page.
  3. Remove the Java Webstart cache from the local drive and try again.
    • On Windows this folder is located in: %APPDATA%\LocalLow\Sun\Java\Deployment\cache.
    • On OS X this folder is located in: /Users/user_name/Library/Caches/Java/cache.
    • On Linux this folder is located in: /home/user/.java/deployment/cache.
  4. Remove the Author Component framework cache from the local drive and try again:
    • On Windows Vista/7/8/10 this folder is located in: %APPDATA%\Roaming\com.oxygenxml.author.component.
    • On Windows XP this folder is located in: %APPDATA%\com.oxygenxml.author.component.
    • On OS X this folder is located in: /Users/user_name/Library/Preferences/com.oxygenxml.author.component.
    • On Linux this folder is located in: /home/user/.com.oxygenxml.author.component.
  5. Problems sometimes occur after upgrading the web browser and/or the JavaTM runtime. Redeploy the applet on the server by running Ant in your Author Component project. However, doing this does not always fix the problem, which often lies in the web browser and/or in the Java plug-in itself.
  6. Sometimes when the HTTP connection is slow on first time uses the JVM would simply shut down while the jars were being pushed to the local cache (for example, first time uses). This shut down typically occurs while handling oxygen.jar. One of the reasons could be that some browsers (Firefox for example) implement some form of "Plugin hang detector" See https://developer.mozilla.org/en/Plugins/Out_of_process_plugins/The_plugin_hang_detector.
  7. If you are running the Applet using Safari on OS X and it has problems writing to disk or fails to start, do the following:
    • In Safari, go to Safari->Preferences->Security.
    • Select Manage Website Settings.
    • Then select Java and for the oxygenxml.com entry, choose the Run in Unsafe mode option.
Enable JavaWebstart logging on your computer to get additional debug information:
  1. Open a console and run javaws -viewer.
  2. In the Advanced tab, expand the Debugging category and select all boxes.
  3. Expand the Java console category and choose Show console.
  4. Save settings.
  5. After running the applet, you will find the log files in:
    • On Windows this folder is located in: %APPDATA%\LocalLow\Sun\Java\Deployment\log.
    • On OS X this folder is located in: /Users/user_name/Library/Caches/Java/log.
    • On Linux this folder is located in: /home/user/.java/deployment/log.
  1. Avoiding Resource Caching
Parent topic: Web Deployment
Previous topic: Communication between the Web Page and Java Applet
Next topic: Avoiding Resource Caching