Mac OS X 10.5 & 10.6 Installation Instructions

 [Credits:  Mike Nowak, Peter Polko, Sera Markoff, Salomé Dibi, Montserrat Armas Padilla]

Throughout this writeup "$" signifies a terminal prompt!

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

X-ray install stuff

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

The following is a set of instructions for building HEASOFT 6.9, gnu redline 6.1,

S-lang 2.2.2, and ISIS 1.6.0-3 and slirp 1.9.8 on a Apple OS X 10.5 or 10.6

system. Building on Apple systems is *definitely* trickier than

building on a Linux system.  Isn't Apple OS X just the same as Linux?

No, it's not!  It's 95% the same, but 5% of the time it's something

subtly different that causes all sorts of problems.

For that reason, we ask that you follow the instructions *exactly* as

you see them here.  Please, no improvising!  If everyone starts from

the same point, this will minimize the number of variations on

problems that we have to track down and fix.

All the steps below should take about two hours.  If it's taking

substantially longer than that, there's probably some problems, so

contact us!

First line of help for Xray related software *only* = Mike Nowak ( This e-mail address is being protected from spambots. You need JavaScript enabled to view it ), please CC This e-mail address is being protected from spambots. You need JavaScript enabled to view it as well.

****************************************************************************

Usually one would not download and build everything into /usr/local/src but we have found that doing it this way seems to avoid some of the library/communication problems.  So please stick to this even if it seems weird to you!

1)  Download all the necessary source code into /usr/local/src (create the "src" directory as root if it does not exist):

$ cd /usr/local

$ sudo mkdir src

--HEAsoft 6.9 (http://heasarc.gsfc.nasa.gov/lheasoft/download.html)

In step 1 select "Source code distribution". Then select the right platform (for example "Mac Intel - Darwin 9.x (OS X 10.5.x)" but check the "Hardware" tab in your System Profile if you are unsure).

In step 2 select "All" and click the "Submit button". The full download is about 700 MB.

--gcc & gfortran binary tarballs from http://hpc.sourceforge.net/

(this is new:  only the Leopard compilers seem to work on Snow Leopard to correctly compile Heasoft6.9!!) 

Leopard PPC: http://prdownloads.sourceforge.net/hpc/gcc-leopard-ppc-bin.tar.gz?download

Leopard Intel: http://prdownloads.sourceforge.net/hpc/gcc-leopard-intel-bin.tar.gz?download

**note:  even if you have gcc/gfortran from another source, you need the above versions!!

--GNU readline 6.1 from http://tiswww.case.edu/php/chet/readline/rltop.html

Direct link: ftp://ftp.cwru.edu/pub/bash/readline-6.1.tar.gz

--S-Lang 2.2.2 from http://www.s-lang.org/download.html

Direct link: ftp://ftp.fu-berlin.de/pub/unix/misc/slang/v2.2/slang-2.2.2.tar.gz

-ISIS 1.6.0-12, download isis-1.6.0-12.tar.gz from: http://www.mit.edu/~houck/isis/

--SLIRP 1.9.8 from http://space.mit.edu/cxc/software/slang/modules/slirp/

Direct link: ftp://space.mit.edu/pub/mnoble/slirp/slirp-1.9.8.tar.gz

--S-Lang statistic module from http://space.mit.edu/cxc/software/slang/modules/stats/

Direct link:  http://space.mit.edu/cxc/software/slang/modules/stats/src/slstats-1.0.2.tar.gz 

2) Upgrade to the newest Xcode version 

(if Xcode is not already installed on your computer, install Xcode off the Mac OS X disk you got with your laptop)

Then run Software Update (possibly repeatedly) until all software is up to date.  On your Mac, this is done by going to the "Apple" sign at the upper left of your top menu bar and selecting Software Update.  Once you do this once, often requiring restart, you should try again until the program tells you there are no further updates to install.

3)  Using compatible, recent and stable compilers is crucial.   For Heasoft6.8 I had used Macports to install the gcc/gfortran compilers, so if you have done the same, the first thing you need to do is:

$ sudo port uninstall gcc44

And just to be safe I moved /opt to /opt_hide.  

4)  Start a new session as root to do the important stuff, make sure once you do this command you perform all the following tasks in this window

 $ sudo tcsh   

(for cshell…most of these instructions are assuming cshell but can be adapted for bash).  

In some cases if you have problems you may need to do:

 $ sudo -E tcsh

or 

 $ sudo -E bash   

For all of the following steps you must be working in this terminal, with root access.  You can always check who you are by typing

$ whoami

and the answer should be "root" if all is well.

4.5)  Remove any existing builds of these programs below that you have (in whatever directories) to avoid conflicts 

5) Install gcc and gfortran in the top directory, it will unpack everything properly into the /usr subdirectories.  The binaries themselves will be in /usr/local/bin

$ cd /

$ mv /gcc-leopard-intel-bin.tar.gz  .

$ gunzip gcc….tar.gz

$ tar xvf gcc….tar

6)  The most important step for *all* following processes is to make sure that all installations are performed using the new compilers.  This means that you need to make 100% sure that the $PATH variable, which tells your computer where to look for things, is set up correctly.  

type:

$ echo $PATH

Normally this will look like:

".:..:/bin:/sbin:" etc, with a long list of directories.  What you want to do is make sure that /usr/local/bin appears in that list after /bin and /sbin but before everything else like /sw/bin or /opt/local/bin, which are the top level directories that programs like Fink and Macports set up to put software in.   The point is that those programs may have given you versions of gcc/gfortran, but it's important that you get select from /usr/local/bin first!!

So you may need to hand-edit .cshrc or .bashrc so the path looks like:

".:..:/bin:/sbin:/usr/local/bin:"….the rest of the path after this

Keep in mind that your $PATH may not look like the next person's $PATH, this is something that is customizable and depends also what programs you have used to install things, if at all.   So no matter what is in there, just make sure /usr/local/bin is one of the first places it looks!

7)  Now that the path is correct, edit your .cshrc  to set the compiler environments that Heasoft will use:

setenv FC "/usr/local/bin/gfortran"    

setenv CC "/usr/local/bin/gcc"           

setenv CXX "/usr/local/bin/g++"        

setenv GCC "/usr/local/bin/gcc"        

(or equivalent in .bashrc):

(Direct link:  ftp://ftp.aoc.nrao.edu/pub/software/aips/31DEC10/install.pl) 

where you can find detailed instructions beyond this.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

 
And one more....DS9 for imaging data:

All platform binaries downloadable from:  http://hea-www.harvard.edu/RD/ds9/
Direct downloads for the X11 versions:

for OS version 10.6 (Snow Leopard): http://hea-www.harvard.edu/saord/download/ds9/darwinsnowleopard/ds9.darwinsnowleopard.6.1.tar.gz
for OS version 10.5 (Leopard): http://hea-www.harvard.edu/saord/download/ds9/darwinleopard/ds9.darwinleopard.6.1.tar.gz

Untar the archives to find two files: a binary executable ds9 and a ZIP file ds9.zip. Keep these two files together!

To make sure this is on the path for Heasoft to find, take one more step: you need to put both files in a directory already in your path (like /usr/local/bin), or add the directory wherever those two files are to your path.  For instance:

$ cd ds9.darwinsnowleopard.6.1
$ sudo cp ds9 ds9.zip /usr/local/bin

or add to your .bashrc:

PATH="$PATH:/Users//ds9.darwinsnowleopard.6.1"; export PATH

or .cshrc:

setenv    PATH    "$PATH:/Users//ds9.darwinsnowleopard.6.1"