HPMV: Running the Standalone Client

The human protein mutation viewer can be run as standalone program/client. To run the standalone program/client either

Detailed instructions are included below. A Unix-style environment is assumed - adapt as necessary for other operating systems. The first approach (running as a standalone application) is most likely to succeed but perhaps a bit less elegant.

Running as Standalone Application

If you've already got a recent version of Java (8+) properly installed on your computer then you can just do:

$ wget --content-disposition http://hpmv.bii.a-star.edu.sg/GetJar
$ java -jar hpmv.jar

If not, then you can download the latest version of Java to a local directory and try it, without doing a full system-wide install, by doing something like:

$ mkdir tmpdir
$ cd tmpdir
$ firefox http://www.oracle.com/technetwork/java/javase/downloads/index.html
$ tar xvzf jre-8u60-linux-x64.tar.gz
$ wget --content-disposition http://hpmv.bii.a-star.edu.sg/GetJar
$ ./jre1.8.0_60/bin/java -jar hpmv.jar

Running with Web Start

If you're lucky, clicking the button will just work.

If not, then you'll have to delve into black magic of getting Java WebStart (javaws) properly configured on your computer. There's no simple recipe with guaranteed success but I've included some ideas below.

A key idea is that you'll need Java version 8+ to run the HPMV client. You can test if your version of javaws is adequate just from the command line:

$ javaws http://hpmv.bii.a-star.edu.sg/client/hpmv-webstart.jnlp

which, if successful, will start the HPMV client.

In Firefox, the version of javaws that is delegated to handle WebStart/JNLP files can be set using:

Edit -> Preferences -> Applications

On Ubuntu Linux, you can select a more recent version of javaws using:

$ sudo update-alternative --config javaws

On MacOS, after you've clicked the "Launch" button, you may need to control-click on the jnlp file in the downloads list. And even then you may get a complaint about an "unidentified developer" (that the developer is not registered with Apple). This can be solved using:

System Preferences... -> Security & Privacy -> Allow apps downloaded from: