Joint Astronomy Centre Observing Tools.
SURVEY DEFINITION TOOL DOCUMENTATION AND DOWNLOAD LINK AVAILABLE
The Observing Tool is a Java based application for creating Science Programs in preparation for observing at JCMT or UKIRT. While Linux based operating systems are our lead platform, testing has been performed to varying degrees on Solaris, Windows and Mac OS X.
As of July 2009 the Observing Tool for both telescopes is now distributed via Java Web Start.
To acquire and run the Observing Tool requires having a version of the Java Runtime Environment greater or equal to 1.6. If you are unsure wether or not you have Java installed and in your path, or which version of Java you have, open a console ( Windows users can run a console by going to
'Start -> Programs -> Accessories -> Command Prompt', Mac OS X users can run a console by going to
'/Applications/Utilities/Terminal.app', Gnome users
'Applications -> Accessories -> Terminal' ) and type the following :
, KDE users 'K Menu -> System Tools -> Terminal'
$ java -version
Responses such as
"command not found" indicate that either Java has not been installed or is not in your path.
It is recommended that you obtain the latest Java Runtime Environment from Oracle or your operating system vendor.
Installation via Java Web Start is relatively easy, first if your web browser supports Java Web Start
and the correct content handler is assigned, you can click on the following link :
JAC Observing Tool
If that fails to run Java Web Start, and the browser requests to download the file, or should you prefer to run it from the console you can type :
$ javaws http://ftp.jach.hawaii.edu/ot/jac-ot.jnlp
Installation may create a shortcut icon on your desktop, or an entry in your start menu, so that the Observing Tool can be run again in the future. While an active internet connection is required for initial installation, it is not required for running the Observing Tool on a day-to-day basis, and thus can be used in the absense of an internet connection. If a desktop icon is not created, you can check the status of, and run the Observing Tool, from Java Web Start by opening a console and typing :
$ javaws -viewer
In order for the Observing Tool to run a certificate must be accepted, you will be presented with this when the application is run, it should be signed by the current maintainer at the Joint Astronomy Centre. The certificate is not signed by a recognised certificate authority, and you should be warned of this when running the software, if in doubt contact us.
Due to the nature of Java Web Start, upgrades of the Observing Tool happen automatically whenever the code is updated providing you have an active internet connection, so there is no worry about running the correct version. Should for any reason an upgrade fails due to a cached item, or if you wish to remove the Observing Tool, it can be uninstalled by opening a console and typing the following :
$ javaws -uninstall
Questions, bug reports or praise ( or indeed very very carefully worded criticism ;) should be emailed to the appropraite address :
email@example.com or firstname.lastname@example.org removing the 'remove.' from the email address first.
Please note the operating system release and the Java version in your email as you will be asked.
Java Web Start specific issues.
NetX, which is bundled as a replacement Web Start with OpenJDK in the IcedTea distribution is not known to work. Oracle's Java Web Start and Apple's, which is based on Oracle's, are both known to work.
The help pages do not appear to work correctly on MacOS X Tiger ( 10.4 )
They are available online at http://www.jach.hawaii.edu/software/ukirtot/