Starlink on OS X Installation Instructions

(As a note, the dates seen in the graphic will be incorrect, as I do not want to go about updating them every time I make a new release of Starlink for OS X.)

	Download the Starlink OS X Beta disk image from http://www.jach.hawaii.edu/~bradc/starlink/StarlinkOSXBeta20040728.dmg.tgz.
	This will download the file StarlinkOSXBeta20040728.dmg, which should open automatically. If not, double-click it.
	After a little while, a new disk icon will appear on your desktop, called "local-star"
	Create a new directory on your hard drive called "local-star" -- you can do this via the Finder or with a Terminal.
	Open two Finder windows, one for the "local-star" on your desktop and one for the "local-star" in your root directory, and select all of the contents of the desktop "local-star".
	Drag the contents of the desktop "local-star" to your hard drive "local-star".
	This process may take a few minutes...

At this point you now have a subset of the Starlink software collection installed in /local-star on your Mac. To get things set up to where you can start using it, you'll need to edit your ~/.cshrc and ~/.login files. In ~/.cshrc, add a line reading "source /local-star/etc/cshrc", and in ~/.login, add a line reading "source /local-star/etc/login".

Now, if you type "source ~/.cshrc ; source ~/.login" in a Terminal, you will be able to run your favourite Starlink commands. Note that for any of the graphical tools to work (GAIA, KAPPA/DISPLAY, ORAC-DR) you will need to have X installed. If you do not have X installed, please visit Apple's X11 pages.

At this point you may be able to run some of the applications, but you will probably need to install extra libraries. Luckily, this is relatively painless. To start off, go to fink's webpage, download the latest release, and install it following their instructions. When you get to the end of that (after step 6, upgrading fink), you will need to install the tcltk, libpng3 and readline packages through fink. This can be done through the Fink Commander application or by typing "fink install tcltk", "fink install libpng3" and "fink install readline" in a Terminal.

Note that you'll have to be running a tcsh shell. New accounts created under 10.3 have bash as their default shell, so this may be what you're running under. If you're getting shell-related errors, try running under tcsh.

Known Issues (as of 20040908)

	Interactive GUIs in CCDPACK do not work.
	ICL does not currently work (but does run up) this has been fixed in development versions, but not on this release
	If you run into a problem with a missing file called "/usr/lib/libdl.0.dylib", create a softlink to /usr/lib/libdl.dylib with `ln -s /usr/lib/libdl.dylib /usr/lib/libdl.0.dylib`. You may need `sudo` priveleges to do this.
	SHOWME and FINDME do not currently work.
	`oracdr_nuke` does not currently work.
	Mosaicking within ORAC-DR appears to be broken, in that object detection and automated shifting does not work. Telescope offsets should work, but reports are that this does not work at all for IRIS2 reduction.

Brad Cavanagh

Last modified: Wed Sep 8 09:20:46 HST 2004