Joint Astronomy Centre
Show document only
JAC Home
JCMT
UKIRT
Contact info
JAC Divisions
OMP
Outreach
Seminars
Staff-only Wiki
Weather
Web Cameras
____________________

OMP
JAC Software
Downloading the JCMT Observing Tool

Downloading the JCMT Observing Tool

Note: The ACSIS-ready version of the JCMT Observing Tool has been released. All earlier versions of the OT are redundant and MUST NOT be used to submit MSBs for semester 07B. The current release is 20080115.

Existing users note: The current version is 20080115. You may also need a newer version of Java (JRE) and the Java Advanced Imaging (JAI).

The JCMT Observing tool is a Java application and has been tested on Linux, Solaris, Windows XP and Mac OS X to various degrees - our lead platform is Linux.It is the same package as the UKIRT-OT so if you have the recent version of that you are ready to go

Go to the section describing your operating system.

Linux or Solaris users

You need three things to run the JCMT-OT:
  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 JCMT-OT itself

JRE

To check which version you have installed on your unix machine, type
 % java -version

If the answer is 1.5 or later you know you are ok as far as JRE is concerned. 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 anonymous FTP area at ftp.jach.hawaii.edu/pub/ukirt/ukirtot.

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

 % gunzip jdk-1_5_0_11-solaris-sparcv9.sh.gz
	

or on Linux:

 % gunzip jdk-1_5_0_11-linux-i586.bin.gz
	

This will extract the relevant installer in the current directory, this will need to be run, to install on your system. You can now skip to step 3 (JCMT-OT)

JAI

If you have determined you have java 1.5 installed and want to check if you have JAI, you have to look for a file called jai_core.jar. This file will be in the java installation directory under the subdirectory lib/ext Here's an example of how to do it:
 % which java
 /star/java/jdk/bin/java
This tells us that the java installation directory is /star/java/jdk/. So we would expect JAI to be in:
 % ls /star/java/jdk/jre/lib/ext/jai_core.jar
 /star/java/jdk/jre/lib/ext/jai_core.jar
which it is in this example..

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.

JCMT-OT

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

 % gunzip -c jcmtot_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/jcmtot

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

 % jcmtot

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 XP users

You need three things to run the JCMT-OT:
  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 JCMT-OT itself

JRE

If you have Java installed already you can check the version number by doing Start->Run->Command and then typing java -version at the MS-DOS prompt. If it is 1.5 or newer you are done. If not you can get an appropriate version from our FTP site by retrieving jdk-1_5_0_11-windows-i586-p.exe.

JAI

If you have not installed the JCMT-OT before chances are you won't have JAI. You can get an appropriate version from our FTP site by retrieving jai-1_1_2_01-lib-windows-i586-jre.exe .

JCMT-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
batch icon. If you have a correctly installed JRE the OT will run without any further ado.

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".

MacOS X

The most recent version of the JCMT OT is always available from the JCMT-OT FTP area as JCMT-OT.dmg. Clicking the link will download a disk image containing two files: the JCMT-OT and a README. To run the OT you can double-click the JCMT-OT icon. You may copy this application to any location you desire, and it is not necessary to download and install the JAI for MacOSX 10.4 ( Tiger ) users, 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 JCMT-OT.

Contact: Sam Hart. Updated: Tue Jan 15 11:19:36 HST 2008

Return to top ^