Downloading the UKIRT Observing Tool

The UKIRT Observing tool is a Java application and has been tested on Linux, Solaris, Windows 2000 and Mac OS X to various degrees - our lead platform is Linux.

Go to the section describing your operating system.

• Linux or Solaris
• Windows 2000
• Mac OS X

Linux or Solaris users

1. The Java Runtime environment (JRE) version 1.5 or newer
2. The Java Advanced Imaging extension (JAI) version 1.1.2 or newer
3. The UKIRT-OT itself

JRE

 % java -version

If the answer is 1.5 or later you know you are ok as far as JRE is concerned. If you have a suitable version, skip to the next step (JAI). If you get an older version or "command not found" you need to install JRE and JAI. To simplify the hassle of installing both the JRE and JAI we distribute tar files containing the combined JRE and JAI packages. Versions are available for both Linux and Solaris from the OT FTP area. If you wish to use a proper FTP client (rather than going through a web browser) you can download the OT from the FTP area at ftp.jach.hawaii.edu/pub/ukirt/ukirtot.

This distribution can be installed simply by gunzipping and untarring it. On Solaris:

% gunzip -c jdk-1_5_0_11-solaris-sparcv9.sh.gz 
% chmod +x jdk-1_5_0_11-solaris-sparcv9.sh
% ./jdk-1_5_0_11-solaris-sparcv9.sh

or on Linux:

% gunzip jdk-1_5_0_11-linux-i586.bin.gz
% chmod +x jdk-1_5_0_11-linux-i586.bin
% ./jdk-1_5_0_11-linux-i586.bin

This will will run an install script that will create a directory jdk-1_5_0_11 in the current directory. This is all that is required to install it. You can now skip to step 3 (UKIRT-OT)

JAI

 % which java
 /star/java/jre-1.5.0_06/bin/java

 % ls /star/java/jre-1.5.0_06/lib/ext/jai_core.jar
 /star/java/jre-1.5.0_06/lib/ext/jai_core.jar

If it is not, you can get it directly from Sun's JAI site. Some compatibility problems exist between the position editor and the latest JAI release. We recommend using JAI 1.1.2.

UKIRT-OT

The most recent version of the OT is always available from the UKIRT-OT FTP area as ot_latest.tar.gz. The first step is simply to download it and untar the distribution [it will take up ~35MB of disk space, but this distribution also includes the UKIRT-OT]. It can be untarred using:

 % gunzip -c ot_latest.tar.gz | tar xvf -

This will create a directory called ompot. The installation is almost complete. If you have a java executable in your path you should now be able to run up the OT:

 % ompot/bin/ukirtot

or add the directory ompot/bin to your PATH environment variable and then type:

 % ukirtot

If the location of your Java executable is not present in the path then you will need to edit the startup script so that it knows which Java runtime environment to use (this is also useful if you want to force a site wide version). You do this by editing the file ompot/bin/ot and changing the line that says:

set JAVA = `which java`

to (for example)

set JAVA = /star/java/jre/bin/java

if you are going to use the Starlink JRE. Note that the value used includes the full path to the Java executable, not a directory specification.

The OT should now be runnable as described above.

Windows 2000 users

1. The Java Runtime environment (JRE) version 1.5 or newer
2. The Java Advanced Imaging extension (JAI) version 1.1.2 or newer
3. The UKIRT-OT itself

JRE

JAI

UKIRT-OT

If you are running the OT on windows the distribution is available in both .zip and .tar.gz format, you can just uncompress it using, for example, Winzip. Once it has been uncompressed go into the directory ompot\bin\ and click on the

ot.bat

You can get a desktop shortcut as follows: go into the directory ompot\bin\, right click on the ot.bat batch icon, and select "copy" from the resulting menu; then right-click on the desktop and select "paste shortcut". optionally rename the shortcut by right-clicking on it and selecting "rename".

Mac OS X

The most recent version of the OT is always available from the UKIRT-OT FTP area as UKIRT-OT.dmg. Clicking the link will download a disk image containing two files: the UKIRT-OT and a README. To run the OT you can double-click the UKIRT-OT icon. You may copy this application to any location you desire, and it is not necessary to download and install the JAI for users of MacOSX 10.4 ( Tiger ) and later, as these libraries are included with the OS.

Due to the upgrade to Java 1.5, users of MacOS X prior to 10.4 will be unable to run the UKIRT-OT.