NRAO
 

Astronomical Image Processing System
Special MacIntosh OS X instructions

[AIPS]

The 31DEC16 version of AIPS is available as our active development version. It is likely to change on a daily, weekly, and monthly basis. The older 31DEC15 version is "frozen" although some patches for it may be made. They both contain ports to the MacIntosh OS X (Darwin) operating system for PPC and Intel cpus. These ports are no longer new and the code and instructions below have become stable.. Binary installations, where possible, are recommended and have become fairly routine. Users doing a text installation will need to install the full set of GNU compilers and readline from GNU-provided source code. The binary installation provides load modules and run-time libraries build by the (somewhat expensive) IBM xlf or Intel ifort compilers. These executables appear to run up to 50% faster than those produced by the GNU compilers. Most Mac users run the binary version of AIPS and update with the "Midnight Job". The instructions below may well not be current. Ignore them and simply follow A Guide to the Install Wizard unless you have to compile the code yourself.

The new Mac OS versions have caused some issues. Yosemite and El Capitan both appear to delete some (not all) of the XWindows libraries. See http://xquartz.macosforge.org/landing. to re-install X11. El Capitan also limits the use of run-time libraries. You may need to link (ln -s) the libraries in the $LIBR/INTELCMP directory into /usr/local/lib to get AIPS to run. A script called fix_aips_elcap.sh has been written to assist with this. The install.pl script copies this script to your home and $SYSLOCAL directories and pauses at an appropriate time to allow you to run the script. It must be run under bash with sudo privilege.

The code maintenance software cvs also does not come with Mac OS/x any more. NRAO gets this from macports. See https://www.macports.org/ports.php?by=name&substr=cvs for information. The MNJ in 31DEC16 has been changed so that cvs is no longer required for binary installations; it is still used for text installations. Note that macports does require Xcode developer tools (v7+ for 10.11). Apple still lists a *free* developer membership, that just requires an Apple ID on their membership comparison page https://developer.apple.com/support/compare-memberships/ which gives access to the developer tools download(s).

When your installation (perl install.pl -n) has finished there will still be two things to do.

  1. When the installation has finished, copy /etc/services to some area you own and edit it, adding the lines
    sssin           5000/tcp        SSSIN      # AIPS TV server
    ssslock         5002/tcp        SSSLOCK    # AIPS TV Lock
    msgserv         5008/tcp        MSGSERV    # AIPS Message Server
    tekserv         5009/tcp        TEKSERV    # AIPS TekServer
    aipsmt0         5010/tcp        AIPSMT0    # AIPS remote FITS disk access
    aipsmt1         5011/tcp        AIPSMT1    # AIPS remote tape 1
    aipsmt2         5012/tcp        AIPSMT2    # AIPS remote tape 2
    

    You may have to comment out some conflicting services, all of which we believe are obsolete. Then
    sudo cp services /etc
    and enter your password when required.

  2. On the latest "leopard", "snow leopard", "lion", "mountain lion", "yosemite" and "El Capitan" (X 10.5-10.11) systems, /etc/rc is gone and creating it will have no effect. You need to create an /etc/sysctl.conf file and put these values in it,
           kern.sysv.shmmax=10485760
           kern.sysv.shmmin=1
           kern.sysv.shmmni=32
           kern.sysv.shmseg=8
           kern.sysv.shmall=4096
    
    Note: You will need to reboot the system for the change in shared memory to take place. You can check if the shared memory changes happened by typing sysctl kern.sysv in a terminal or xterm window. Look for the kern.sysv.shm* values. If the values have not changed, make sure you haven't inadvertently left in sysctl -w in the /etc/sysctl.conf file or mis-typed one of the values. If the /etc/sysctl.conf file is not properly formatted, or shmmax is not an integer multiple of shmall, the shared memory will not be adjusted after the reboot.

  3. On recent systems you must not set the DISPLAY environment variable. Max OS/X sets it to some strange string which works.

  4. To run the midnight-job ("MNJ") you will need rsync and, for versions 31DEC15 and before, cvs (Concurrent Versions System).

PROBABLY OBSOLETE INFORMATION FOLLOWS WHICH MAY BE OF HELP FOR TEXT INSTALLATIONS

Table of Contents

Many thanks to Kristy Dyer and Michael Rupen of NRAO who loaned an iBook computer for this development and who provided much need help and encouragement in the process. Boyd Waters (NRAO) and Miguel F. Morales (MIT) also provided considerable advice. Juan Cabanela (St. Cloud State University) was at the forefront in dealing with problems that arose therafter. A number of other Mac owners have also contributed time and effort. Wes Young, formerly of the NRAO AIPS Group, was instrumental in developing the binary installation process and debugging OS/X issues.


Basic downloads required

Binary installations of AIPS will need the basic tools "cvs" and "XWindows" in non-developer form. If you are doing a text installation, i.e. are compiling the code yourself, then you will need Fortran and C compilers and a variety of software developers tools including those for XWindows.
  1. Mac OS X Developer Tools: You will need the basic software developers' kit from Apple. It contains the C compiler and lots of other goodies, and is available for free. The developers' kit may be available in "/Applicatons/Installers/Developer Tools". Use the finder to see if it's there, click on Applications, then Installers, then Developer Tools. If it exists then double click on the package icon and install the compiler. If the Developers' Tools are not available on your hard drive, they may be available from CD if you bought your OS/X version. If you have the CD's locate the Developers' Tools CD (Xcode disk) and install the "Developers' Tools" package from disk. One final place to get the "Developers' Tools" is from the Apple Developer Connection (ADC). Details on the ADC are (or were) available at the ADC membership page, while details of the Developer Tools are available at the tools page. Once you're a member, you can go to http://connect.apple.com site log in and snag the software.

  2. You will need XWindows for either a binary or a text installation. See http://xquartz.macosforge.org/landing/ to re-install X11.

  3. For a text installation, you also need the XWindows software developers kit which contains the C include files needed to compile XAS. This should be available in the xquartz installation.

Installing the GNU compilers and readline: text installations only

  1. Download the GNU tar balls from GNU. gfortran version 5.3.0 appears to work under Linux and so should work on Mac OS/X as well.

  2. Disable the line
             source /sw/bin/init.csh; rehash
    from your account's .tcshrc, .cshrc, or .bashrc file if present. Note that this may have dire consequences for other Fink-supplied utilities and is probably not needed any more. The default Fink gcc has also been of an acceptabloe flavor of late.

  3. Follow instructions to install the compilers. Old instructions which used to work are
             ./configure --prefix=/usr/local/gnu
             gnumake bootstrap
             sudo gnumake install

  4. Install readline using
    	 export CC=/usr/local/gnu/bin/gcc 
    	     or
    	 setenv CC /usr/local/gnu/bin/gcc
             ./configure --prefix=/usr/local/gnu --with-curses --disable-shared
             gnumake
             sudo gnumake install

File systems

  1. The file systems that you use for AIPS should be fully modern ones. Please use "MACos extended, with lower-case support" file systems. The "FAT32" file system does not allow, among other things, the rename system operation which AIPS requires.

Now install AIPS

  1. Following the instructions for installing the 31DEC16 version of AIPS. After install.pl has been downloaded, it will need to be made executable. Run it with the command perl install.pl or edit it to set /usr/bin/perl rather than /usr/local/bin/perl in its first line. (The command perl install.pl -n is used for the binary installation.)

  2. Make sure on screen 10 that readline points to the /usr/local/gnu/libreadline.a version.

  3. When the installation has finished, copy /etc/services to some area you own and edit it, adding the lines
    sssin           5000/tcp        SSSIN      # AIPS TV server
    ssslock         5002/tcp        SSSLOCK    # AIPS TV Lock
    msgserv         5008/tcp        MSGSERV    # AIPS Message Server
    tekserv         5009/tcp        TEKSERV    # AIPS TekServer
    aipsmt0         5010/tcp        AIPSMT0    # AIPS remote FITS disk access
    aipsmt1         5011/tcp        AIPSMT1    # AIPS remote tape 1
    aipsmt2         5012/tcp        AIPSMT2    # AIPS remote tape 2
    

    You will have to comment out some conflicting services, all of which we believe are obsolete. Then
    sudo cp services /etc
    and enter your password when required.

Now run AIPS

  1. Start up /Applications/X11.ap/Contents/MacOS/X11.

  2. In the xterm that this creates, type the aips command line and begin your aips session.

But there are problems

  1. If things do not work properly, e.g. the TV does not start, see the AIPS Manager FAQ for suggestions. On modern systems, you MUST NOT set the DISPLAY environment variable.

  2. The default Mac system limits shared memory pages to 4 Mbytes. When XAS starts it tells you that it is making a screen x pixels by y pixels. The memory you will need is at least 4 x y bytes. For the new large screens this is more than 8 Mbytes. See instruction 2 in the initial section at thetop of this page.

You WILL want a Midnight Job!

If your site has a need for the current version of AIPS with updates via the Internet and the so-called midnight job, Read this information. It has additional information and instructions. Or contact Eric Greisen for further information.

Since releases of AIPS are planned to be only on an annual basis, the midnight job (now with easier setup and NO ssh) will be the only way for AIPS users outside of NRAO to avail themselves in a timely fashion of whatever enhancements, changes, or new functionality we add to Classic AIPS.


Modified on $Date: 2016/02/04 21:42:21 $
[Eric W. Greisen]