next up previous contents
Next: Common Problems and their Up: Appendices Previous: Appendices

Obtaining and Installing SLIME

 

SLIME is not a part of the normal AIPS distribution because the AIPS compilation tools are not designed to handle large C programs and because SLIME will not run on all systems that can run AIPS.

In order to run SLIME, your system must meet the following requirements.

Note that these conditions are not true for Linux nor for Solaris 2.2 and earlier versions of Sun OS. In addition, SLIME will not run under AIX 3.2.5 on an RS/6000 although this system meets the general requirements listed above (the reasons for this are not yet known). The SLIME installation procedures currently support Solaris 2.3 and later running on SPARC-based CPUs and OSF1 T3.2 running on ALPHA/AXP-based CPUs. If your system has not been named here and meets the requirements listed above, contact me by electronic mail at cflatter@nrao.edu to arrange for SLIME to be ported to your system (this should normally require nothing more than adding a new configuration section to the installation files.

If your system is supported by the installation procedures then you can follow the step-by-step instructions given below. You do not need to have root privilege to do this but you should perform the installation from the AIPS manager's account.

  1. Get the sources for SLIME by anonymous ftp from ftp://ftp.aoc.nrao.edu/pub/cflatter/slime.tar.gz. Make sure that you use binary transfer mode. This file has been compressed using gzip and is about 160k in size. Unpack the sources as follows.
    gunzip < slime.tar.gz | tar xvf -
    This will create a subdirectory named SLIME that contains the sources.
  2.   Get the manual by anonymousftp from ftp://ftp.aoc.nrao.edu/pub/cflatter/slime-man.tar.gz if you wish to install the manual locally. This is recommended but not necessary, since SLIME will access an on-line manual across the network if you can not afford the disk space for a local copy of the manual (about 7 MB). Unpack this in the same way that you unpacked the source archive. This will create a subdirectory containing the LaTeXsource for the manual, a set of encapulated PostScript figures and a PostScript version of the manual. This subdirectory will also contain a further subdirectory (slime) containing a number of HTML documents and GIF images: these are the on-line documentation for SLIME. Create a directory that can be read by any machine that will run SLIME and copy the HTML files and GIF images to this directory.
  3. Make the directory that contains the SLIME sources your current directory and make sure that you have defined a full AIPS environment (you should have run LOGIN.SH or LOGIN.CSH and typed $CDTST or $CDNEW).
  4. If you installed a local copy of the on-line manual, edit Slime.ad. Find the line
    ; Slime.helpPrefix:     file:/home/laphroaig/cflatter/working/slime-manual/slime/
    and remove the semicolon from the beginning of the line and replace
    /home/laphroaig/cflatter/working/slime-manual/slime/
    with the full pathname of the directory into which you installed the on-line documentation. Note that the entire string should begin with :file and end with a slash.
  5. If you use the Common Desktop Environment (CDE) edit Slime.ad and remove the lines that specify colours in the section headed Appearance. This step is optional but will improve the appearance of SLIME under the CDE.
  6. If you have the 15JAN96 release of AIPS, edit Imakefile and uncomment the line
    /* AIPSVERFLAGS = -DAIPS_15JAN96 */
    by deleting the asterisks and slashes. Do not change anything else in Imakefile. In particular you should not enable CCI support since there are serious bugs related to the use of Mosaic as a help viewer that have not been resolved yet.
  7. Type xmkmf to generate a makefile.
  8. Type make depend to generate dependency lists. If you see an error message about ModelEditorWraps.h type make ModelEditorWraps.c and then type make depend again.
  9. Type make to compile and link the program. You should expect to see a number of warning messages, particularly from ModelEditorWraps.c but there should be no fatal errors (contact me if there are).
  10. Type make install. This will copy SLIME.EXE to the load area, copy SLIME.HLP to the help area and create directories containg bitmaps and application defaults under $AIPS_ROOT.
  11. If you are running the 15JAN96 release of AIPS, add the following lines to $AIPS_ROOT/START_AIPS before the comment that says, `Finally, start AIPS'.
    #                                       Environment variables for X11
    #                                       programs started within AIPS
    if [ -z "$XBMLANGPATH" ]
    then XBMLANGPATH=$AIPS_ROOT/bitmaps/%B
    else XMBLANGPATH=$AIPS_ROOT/bitmaps/%B:$XBMLANGPATH
    fi
    if [ -z "$XFILESEARCHPATH" ]
    then XFILESEARCHPATH=$AIPS_ROOT/%T/%N
    else XFILESEARCHPATH=$XFILESEARCHPATH:$AIPS_ROOT/%T/%N
    fi
    export XBMLANGPATH
    export XFILESEARCHPATH
    This ensures that SLIME will be able to find the bitmaps and defaults installed in the previous step. These lines have already been added to the 15OCT96 version of START_AIPS. This completes the installation.


next up previous contents
Next: Common Problems and their Up: Appendices Previous: Appendices

Chris Flatters
Thu Mar 14 16:02:50 MST 1996