Jinx is a Java application which, in theory at least, should run on most modern computers and operating systems with little or no need for installation or configuration. When you click on the link to run Jinx, you download a small file which your web browser should automatically recognize and cause the appropriate Java "jar" files to be downloaded through Java Web Start. Using this mechanism ensures that you will always be using the most current and up to date version of Jinx without having to keep up with patches, versions, or complicated downloads.

Please see the Notes section below for further information on installation and debugging.

Distribution

Click here to run Jinx in a 512 MB Java Virtual Machine.

Click here to run Jinx in a 1024 MB Java Virtual Machine.

Click here to run Jinx in a 2000 MB Java Virtual Machine.

A larger Java Virutal Machine (JVM) is generally the better choice if you have the available computer memory. If you receive "OutOfMemoryError" messages, try a smaller JVM.

If you have problems with the smallest version of the JVM, this is indicative of a software error of some sort. Please see below to contact the software author/maintainer.

Notes

Java Web Start. You will need Java Web Start and at least Java 1.5 (aka Java 2) in order to run this application. Java Web Start is part of the all the more recent Java distributions and should not need to be separately installed.

Most recent systems should already have this installed. If not, please contact your system administrator and request that this package be installed, or, if you're managing your own system, check here to find a Java installation package. Unless you plan on doing your own Java development, you should only need the Java Runtime Environment (JRE). Installation instructions are provided for Solaris, Windows, and Linux. Apple Macintosh users should click here for information on installing Java 1.5.

Firewall issues. If you receive the following run time error similar to:

[Error] Could not read Ontology: java.lang.RuntimeException: Connection refused. Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections.

this means that your site or computer has a firewall block on the postgres port (port number 5432) and you will need to contact your system administrator or security manager to have this port opened. Without postgres communication, you may be unable to use the ontology.

This should no longer happen using current deployed version of Jinx, since a snapshot of the SAO ontology is included as part of the automatic download.

What to do in case of problems. This is still Beta software and may have bugs or unimplemented features. If you have problems running the program, it crashes, or it produces what you believe to be erroneous results, it is vitally important that these problems be reported.

As an aid to debugging, Jinx produces a log file recording a considerable amount of user and internal interaction which will be written in your "default" directory or folder. The location of this "default" directory or folder varies by operating system.

The log file name will have the date and time embedded in them and will be similar in form to the following:

Jinx.2007.04.18.113621.305.event

A unique identifier will be generated for each session.

If a problem arises, this file should be emailed here along with any pertinent information you might wish to add to aid in debugging the problem. If the program runs successfully, you may safely delete this file.


	About \| Contact \| Research \| Press \| Training \| Software \| Jobs Terms and Conditions \| Credits ©2006 NCMIR Contact: Webmaster Updated July 20, 2006