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 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.
You need three things to run the JCMT-OT:
- The Java Runtime environment (JRE) version 1.5 or newer
- The Java Advanced Imaging extension (JAI) version 1.1.2 or newer
- 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.
You need three things to run the JCMT-OT:
- The Java Runtime environment (JRE) version 1.5 or newer
- The Java Advanced Imaging extension (JAI) version 1.1.2 or newer
- 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".
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.
|