Last Update: 2004-12-22

The distribution of SAS 6.1.0 is built on Mac OS X 10.2 (Jaguar or Darwin 6.8) but can be used without change on Mac OS X 10.3.X (Panther or Darwin 7.X.0).

It has been tested to work successfully as well on a PowerMac G5 running Mac OS X 10.3.6 (Darwin 7.6.0).

The SAS Graphical User Interfaces (GUIs) provided in this release (sas, xmmselect, calview, odfbrowser, etc) are based on Qt/X11 from Fink and not on Qt/Mac that is the native implementation of Qt on Mac OS X. We think this is the natural way of working with SAS in spite of X11 being a secondaryˆà òÀÜwindowingòÀÝ environment on Mac OS X systems.

 

Installation

Download the following four tar.gz archives,

ˆ§         xmmsas_20041122_1832-common-config.tar.gz

ˆ§         xmmsas_20041122_1832-common-doc.tar.gz

ˆ§         xmmsas_20041122_1832-powerpc-apple-darwin6.8-bin.tar.gz

ˆ§         xmmsas_20041122_1832-powerpc-apple-darwin6.8-libextra.tar.gz

Move them to the directory of your election and unpack them, e.g. under /top_dir. The resulting directory xmmsas_20041122_1832 will contain the complete SAS software. Now proceed as follows:

sh/bash:

ˆ§         export SAS_DIR=/top_dir/xmmsas_20041122_1832

ˆ§         export SAS_PATH=$SAS_DIR

ˆ§         . $SAS_DIR/sas-setup.sh

ˆ§         export DYLD_LIBRARY_PATH=$SAS_DIR/libextra:$DYLD_LIBRARY_PATH

csh/tcsh:

ˆ§         setenv SAS_DIR /top_dir/xmmsas_20041122_1832

ˆ§         setenv SAS_PATH $SAS_DIR

ˆ§         source $SAS_DIR/sas-setup.csh

ˆ§         setenv DYLD_LIBRARY_PATH $SAS_DIR/libextra:$DYLD_LIBRARY_PATH

To complete your configuration and start working with data, you must define the SAS_CCFPATH, SAS_CCF and SAS_ODF environment variables according to your specific needs (look here for details).

 

Required software

X11

To work with this release of SAS on any Mac OS X version, the òÀÜX Windows softwareòÀÝ or X11 (a.k.a X11R6) for Mac Os X must be installed.

Althought this software is provided by Apple for each specific Mac OS X version, as far as we have experienced, the Apple implementation of X11 for Mac OS X 10.2 is incomplete and can not be used.ˆà

However, that is not the case for Mac OS X 10.3.X, where the Apple provided X11 software works fine.

Therefore for Mac OS X 10.2, the only alternative is to install Xfree86 on Mac OS X as provided by Fink. But you may choose to install Xfree86 for Mac OS X 10.3.X as well.

We have tested this release of SAS with two versions of X11 on two Mac OS X versions :

ˆ§         Xfree86 4.2.1.1-16 (Mac OS X 10.2)

ˆ§         Xfree86 4.3.99.16-2 (Mac OS X 10.3.4)

The installation of the above mentioned versions of Xfree86 requires the deinstallation of the X11 from Apple or at least to rename /usr/X11R6.ˆà Look here for details.

The tests made on a PowerMac G5 running Mac OS X 10.3.6 used the default installation of Apple X11 for that OS version.

 

Qt

There should not be any need to install Qt/X11 for Mac OS X since that SAS 6.1.0 distribution provides already a Qt library (libqt-mt.3.2.2.dylib) within the libextra tar.gz archive. Unfortunately this library can not be used on Mac OS X 10.3.X.

Then, if you install SAS 6.1.0 on a Mac OS X 10.2 system, you do not need any additional installation of the Qt/X11 software.

However, for Mac OS X 10.3.X you must install Qt/X11 version 3.2.2-12. This software will place the Qt/X11 library libqt-mt.3.2.2.dylib (and softlinks) in /sw/lib.

For your SAS 6.1.0 binaries to take this library and not the already installed in $SAS_DIR/libextra, you need to modify the DYLD_LIBRARY_PATH variable as follows:

sh/bash:

ˆ§         export DYLD_LIBRARY_PATH=/sw/lib:$DYLD_LIBRARY_PATH

csh/tcsh:

ˆ§         setenv DYLD_LIBRARY_PATH /sw/lib:$DYLD_LIBRARY_PATH

 

DS9, Grace, HEASOFT and Perl

1.      DS9 (3.0 or later) with XPA (2.1.5 or later)

2.      Grace (xmgrace) 5.1.14 or later.

3.      LHEASOFT 5.3 (includes FTOOLS).

4.      Perl must be available as /usr/local/bin/perl (can be a soft link to the real one).

Binaries for Grace are available throught Fink as well.

 

Shell process limits

At difference of other operating systems (e.g. Linux), Mac OS X shells (bash, tcsh, etc) come with very low default values for certain shell process limits.

To avoid having problems with data processing limits, you must increase all them up to their maximum values using the respective command, ulimit for sh/bash shells and limit for tcsh/csh shells. It should be sufficient with the following commands

sh/bash:

ˆ§         ulimit òÀÓd unlimited

ˆ§         ulimit òÀÓs 65536

csh/tcsh:

ˆ§         limit datasize unlimited

ˆ§         limit stacksize 65536

To list all the current limits use ulimit òÀÓa for the sh/bash and limit for the csh/tcsh shells.

 

What does not work

ˆ§         The odfbrowser GUI does not show properly the processing icons.

ˆ§         The HTML SAS Help is only available on Mac OS X desktops via the native Mac OS X (non-X11) implementations of Web browsers, e.gˆà Safari, Internet Explorer or Mozilla.

 

Reporting problems

If you think something does not work, please submit a bug report in

ˆàhttp://xmm.vilspa.esa.es./external/xmm_user_support/helpdesk.shtml