Java Web Start Troubleshooting

Java Web Start Requirements
To securely run the Affinity Data Bank you need to have Java 8 Update 60 or later installed. You can install Java for free from:

Can’t start the application
Most probably your browser is not set up in a way so it knows to send the Java Web Start file (.jnlp) to the Web Start application.

  • Make sure you have Java installed
  • Update your Java to the latest version.

If troubles persist, check some of the operating system specific tips from below.

My browser displays the .jnlp file as text
Your browser or system is not set up correctly to send .jnlp files to Java Web Start.

  • Make sure you have Java installed.
  • Linux
    • In Firefox click on “Tool” and then “Options”.
    • Click on the “Application” tabs.
    • Scroll down the list until you find content type: JNLP File. Then select the action Use Java Web Start Launcher.
  • OSX
    • Download the .jnlp file
    • Display the file in Finder
    • right click on the file and then select “Get Info”
    • Open With should show Java Web Start. If not, please select it and also click “change all”
    • If you can’t find Java Web Start on your system, depending on your Java version it is either in
           /System/Library/CoreServices/Java Web


           /Applications/Utilities/Java/Java Web Start

Java Web Start will launch, but returns an error or runs poorly
Our 3D viewers require 3D graphics support. Out-of-date or missing video card drivers will prevent the applications from starting or running correctly. To resolve this simply update your video card drivers.

The ADB application wants unrestricted access to my system
The ADB downloads required genomic, protein, affinity model, and other annotation information onto your computer. This is technically only possible if you give the application permission to access your system resources. We guarantee that the ADB Java Web Start application signed by the “University of Massachusetts Boston” digital signature and downloaded from our web site:

  • Is not doing anything harmful or hidden on your system.
  • Has been compiled by our developmental team.
  • Is available as open source so you can check the source code.

Opening .jnlp window is displayed
When you try to start the ADB application, a window pops up. Your browsers asks you what to do with the file.

  • In the window, click on “Open with“, select the javaws executable ( depending on your operating system, the name can be different) and press “OK”.
  • If the “Open with” option does not display the Java Web Start executable, you must map the .jnlp file to Java Web Start manually.
    • Open the Firefox preferences, go to the “Applications” tab.
    • Map the mime-type “application/x-java-jnlp-file” to the javaws executable.

I am using a Proxy for internet connection. Will it work?
Java Web Start should pick up the proxy setting from your browser automatically. Depending on your operating system, your Java Web Start application can contain configuration for proxies as well. Make sure your browser and Web Start are using the same settings. To launch the Java Web Start user interface, type javaws.

Learn more on Java Web Start
In order to learn more about Java Web Start please go to the Tutorial provided by Oracle.