|Deletions are marked like this.||Additions are marked like this.|
|Line 3:||Line 3:|
|[[http://starlink.jach.hawaii.edu/starlink/Hawaiki|Hawaiki release notes]]||[[Hawaiki|Hawaiki release notes]]|
Starlink Software Collection - Download and Install Hawaiki
Five distributions of the Hawaiki release of the Starlink Software Collection are available:
32-bit Linux (734MB .tar.gz, md5sum: b38518f21ae7051c882e899f862a61d4)
64-bit Linux (723MB .tar.gz, md5sum: 19d5dc167478c995a9c1f093b531445e)
PPC OS X 10.5 (Leopard) (499MB .tar.gz, md5sum: 034ae1a53e68a3bd3615f8b2895c05e6)
32-bit Intel OS X 10.5 (Leopard) (486MB .tar.gz, md5sum: 7f4f1caeb8cc7ad452086ee85795e094)
64-bit Intel OS X 10.5 (Leopard) (489MB .tar.gz, md5sum: cfa4ea08cc9c92664dffa00162f715d9)
64-bit Intel OS X 10.6 (Snow Leopard) (544MB, md5sum: 62b625f78669f30724bfc8633181ab1a)
The above Linux distributions are built on glibc 2.5. Older versions of glibc will not work and are currently not supported. To check your glibc version, type "rpm -qi glibc" on RedHat-related distributions.
To check the MD5 checksum of your downloaded file, run either the md5sum, md5, or md5deep command, depending on which you have installed.
Parties interested in releases for other platforms (i.e. Solaris) can email <stardev AT SPAMFREE jach DOT hawaii DOT edu>. Please note that the Joint Astronomy Centre only runs Linux operationally and can only devote time and resources to Linux builds; all others (including those not listed here) are supported on a best-efforts basis.
The tar file will unzip into a star-hawaiki/ directory in the directory where you downloaded the tar file. This release can be placed anywhere. When using the software, set the STARLINK_DIR environment variable to the location of the star-hawaiki/ directory, i.e. if I had unzipped it into a /home/bradc/software directory, then the STARLINK_DIR environment variable would be set to /home/bradc/software/star-hawaiki.
On some systems you may need the libg2c.so library. On Fedora Core (and presumably all Red Hat-derivative systems) this can be found in the compat-gcc-32 RPM. On Ubuntu (and presumably all Debian-derivative systems) this can be found in the libg2c0 package.
The 64-bit release requires glibc 2.5 and fairly recent versions of the X11 libraries (7.1 or higher). An up-to-date Gentoo, Fedora Core 6, or SUSE 10.1 are distributions that are known to work.
An older version of libexpat is required. For the 64-bit release, download this file. For the 32-bit release, download this file. In both cases, rename the downloaded file to libexpat.so.0 and place it in the $STARLINK_DIR/lib directory.
The tar file will unzip into a star/ directory in the directory where you downloaded the tar file. This should be copied to a /star directory, or have a /star softlink pointing to the installation location.
The Apple X11 distribution must be installed.
The OS X builds were done using HPC gfortran, and as such a gfortran library is needed. To get this library, download and install HPC gfortran.
Leopard 64-bit distribution
The 64-bit distribution requires that you are using a 64-bit Java. You may need to run the Java Preferences tool to switch your default Java from v1.5 32-bit to v1.6 64-bit.
If you have not installed the OS X SDK, you will need to install it to obtain the ncurses library. It is located on the Tiger installation DVD, or Disc 1 of your hardware's installation CDs (open the "Xcode Tools" folder, then double-click the "XcodeTools.mpkg" package). This will also install X11, which is needed for the various graphical Starlink programs like GAIA or KAPPA/DISPLAY.
Note: The PPC keoe and hokulei releases installed into a local-star/ directory. This has changed to standardise on a star/ installation location.
Snow Leopard 64-bit distribution
After the initial hawaiki release it became clear that some software built on Leopard did not work on Snow Leopard. In particular GAIA fails to run up because of a malloc error. The 64-bit listed above for Snow Leopard is a unofficial build made a couple of weeks after hawaiki. In particular the oracdr installation may not function properly (the starperl implementation is older than hawaiki) and the starjava part of the distribution is for nanahope. The release has been made as a stop gap to get Snow Leopard users up and running. gfortran is still required as for the official Leopard release.
To set up your environment for use with the Starlink Software Collection, first set the STARLINK_DIR environment variable to the location of the star-hawaiki/ directory (or the star/ directory for the OS X releases). For example, if you downloaded the tarball to /home/bradc/software and unzipped it there, the STARLINK_DIR environment variable to /home/bradc/software/star-hawaiki (or /home/bradc/software/star for the OS X releases). It is recommended that you edit the star-hawaiki/etc/login, star-hawaiki/etc/cshrc and star-hawaiki/etc/profile files to set this environment variable at the top of each file.
To use the Starlink Software Collection on csh and related shells (like tcsh), source $STARLINK_DIR/etc/login and $STARLINK_DIR/etc/cshrc. On sh and related shells (like bash), source $STARLINK_DIR/etc/profile.
ORAC-DR for WFCAM
Because of the large size of WFCAM calibration files, they have been split off from the main download tarballs, as not everybody will be reducing WFCAM data using ORAC-DR. These calibrations can be downloaded here (901MB .tar.gz). The tar file will unzip into a wfcam/ directory in the directory you downloaded the tar file to. To install these calibration files, copy the directory into the $STARLINK_DIR/bin/oracdr/cal/ directory, thus creating the $STARLINK_DIR/bin/oracdr/cal/wfcam/ directory containing the calibration files.
This file has not changed for the hawaiki release, so if you downloaded it for the lehuakona or nanahope releases, you need not download it again.