Installing SURF
Up: SURF
Installing SURF
SURF is distributed in binary form using a Starlink distribution
makefile. It can be installed using the following steps:
- Download the relevant distribution from the ftp
site.
- Create a directory (usually in the /star tree but it doesn't matter where
it goes) and unpack the archive into this directory. Note that you
will need about 5Mb of disk space for SURF.
% cd /star
% mkdir surf
% cd surf
% tar zxvf surf_latest_<SYSTEM>.tar.gz (if you are using Gnu tar)
or
% zcat surf_latest_<SYSTEM>.tar.Z | tar xvf - (using a standard tar)
where <SYSTEM> is one of sun4_Solaris, alpha_OSF1 or ix86_Linux.
- Set the environment variable SYSTEM to the system you are using
% setenv SYSTEM sun4_Solaris (for Sun Solaris 2.5 for Sparc)
% setenv SYSTEM alpha_OSF1 (for Alpha Digital Unix 4.0)
% setenv SYSTEM ix86_Linux (for Intel Linux (ELF format))
- Set the INSTALL environment variable to correspond to the location in
which the software should be installed (this is the directory in which
the bin, docs, help and dates
directories are created. Usually this is /star:
% setenv INSTALL /star
$INSTALL defaults to the users home directory if it is left unset.
- Install the built software:
% ./mk install
This will install the monolith into $INSTALL/bin the help library
into $INSTALL/help and the documentation into
$INSTALL/docs. The final part of the installation may fail if
you are not on a Starlink system (since the hlink package
will not be available to cross-reference the hypertext documentation)
but this is okay. The documentation can be found as latex (in
$INSTALL/docs/sun216.tex and HTML $INSTALL/docs/sun216.htx/sun216.html.
- Once the system is installed it is now necessary to setup the environment
for use. Usually this is performed during the Starlink software initialisation
in /star/etc/login and /star/etc/cshrc but the
entries can be placed in a system wide initialisation file or in the
individual users .cshrc and .login just as easily.
The .login file (ie user .login, system login or Starlink login)
must contain:
if (-e $install/bin/surf/surf.csh) then
setenv SURF_DIR $install/bin/surf
setenv SURF_HELP $install/help/surf/surf
endif
and the .cshrc file must contain:
if ( -e $install/bin/surf/surf.csh ) then
alias surf source $install/bin/surf/surf.csh
else
alias surf echo SURF is not available
endif
Where $install is the root directory used for the installation (ie
put the value of $INSTALL into the file and not $install.)
- If necessary the NDFPERL module should also be installed (see below).
Installing NDFPERL
In most cases it will also be necessary to install the ndfperl software. For Linux or Solaris the module can be installed in the
same way as any perl module but assumes that the Starlink development
libraries are available:
% perl Makefile.PL
% make
% make test
% make install
This will install the NDF module into the standard module location on your
system. On Digital Unix the NDF library must be compiled to only use
32-bit memory addresses and so it is not possible to use the default perl
on alpha systems. In this case a new statically linked perl needs to be
built:
% perl Makefile.PL
% make ndfperl
% make test_static
% make -f Makefile.aperl inst_perl MAP_TARGET=ndfperl
This will install a new perl binary called ndfperl into /star/bin.
These instructions are included with the distribution.
Binary distributions will be made available shortly.
SURF assumes that a perl binary with access to the NDF module exists in
/star/bin/ndfperl. This can be either a perl with the NDF libraries
statically linked (the only option with alpha_OSF1) or a normal perl (or a
soft link to a normal perl) with access to a dynamically linked NDF module.
If /star/bin/ndfperl is not available then the perl programs need to
be changed to point to the actual location. This would involve the editing of
scuquick, sculog, qdraw and sigclip
(although the final two are only necessary if Kappa is also installed).
Tim Jenness
Last modified: Tue Jul 15 09:27:26 HST 1997
|
