PDS_VERSION_ID = PDS3
RECORD_TYPE = STREAM
OBJECT = TEXT
PUBLICATION_DATE = 1995-03-13
NOTE = "NAIF Toolkit Installation Instructions
for the Sun. Structure, contents, and
installation for other platforms will be
similar; see TK_FTP.TXT for information
on obtaining other versions. Compiled
from notes provided by Hester Neilan."
END_OBJECT = TEXT
END
NAIF Toolkit Installation Instructions for the Sun
===========================================================================
This document includes several sections that describe system
requirements, installation of the NAIF Toolkit on your machine, and
conversion of the transfer format data files to binary format. Because
this document contains important information pertaining to the
installation, please read it before you install the software.
After you have completed the installation, you should read the
document ``NAIF Toolkit Directory Structure and Contents for the
Sun''. It contains diagrams of the directory tree structure and lists
the files contained in the directories.
Installation Concerns
--------------------------------------------------------
Disk Space and Time
To perform the installation, you need approximately 25 MB of space for
the Toolkit. If you are receiving a compressed tar file delivery, you
will need an additional 25 MB of space temporarily; you may delete the
compressed tar file once the files have been successfully extracted.
The amount of time required to perform the installation varies, but on
a Sun SparcStation 2 it took approximately 20 minutes.
WARNING
If you are using the new Sun OS TMPFS filesystem (included in Sun OS
4.1 and higher), you may run into problems. There is a bug in the
TMPFS that causes the Fortran compiler to incorrectly compile DATA
statements when the TMPFS filesystem is mounted on /tmp. (Fortran
creates intermediate compilation files in /tmp.)
The solution to this problem is to create the intermediate compilation
files in another directory. The compiler option ``-temp=(alternate tmp
directory path)'' does this. Because the vanilla Fortran 1.3.1 does
not support this option, you need to obtain a patched version of
``f77pass1'' (first pass of the Fortran compiler). Contact your Sun
representative to obtain the patched version. The Patch-ID number is
100507-04.
Directory Names Used in the Instructions
--------------------------------------------------------
For the sake of example, let the directory under which you want to
install the NAIF Toolkit be /u/home/JPL. The rest of this document
will refer to directory names using this example name. Remember to
substitute your directory name for ``/u/home/JPL'' in all of the
commands!
Unloading the Delivery Files
--------------------------------------------------------
Compressed Tar File Delivery
Your delivery file, toolkit.tar.Z, was created using tar to archive
the Toolkit files, and then it was compressed. You need to uncompress
it before extracting the Toolkit files.
First, move the tar file to the installation directory. The files will
be installed in a subdirectory of your current directory called
``naif''. For example, if you want the NAIF Toolkit files to be under
the directory /u/home/JPL/naif, change your present working directory
to /u/home/JPL and move the tar file to that directory. Then, extract
the files from the tar file. Remember to substitute ``/u/home/JPL''
with your directory name.
Type the following command to uncompress the tar file:
% cd /u/home/JPL
% uncompress toolkit.tar
Once the tar file is uncompressed, execute the following commands to
extract the files:
% cd /u/home/JPL
% mkdir naif
% tar xvf toolkit.tar ./naif
60Mb Cartridge Tape Delivery
Your 1/4 inch 60Mb cartridge tape was written in tar format. To
extract the files, you need to change your present working directory
to the installation directory. The files will be installed in a
subdirectory of your current directory called ``naif''. For example,
if you want the NAIF Toolkit files to be under the directory
/u/home/JPL/naif, change your present working directory to
/u/home/JPL. Then, extract the files from the tar tape. Remember to
substitute ``/u/home/JPL'' with your directory name.
% cd /u/home/JPL
% mkdir naif
% tar xvf /dev/rst8 ./naif
Exabyte Tape Delivery
Your 8mm exabyte tape was written in tar format. To extract the files,
you need to change your present working directory to the installation
directory. The files will be installed in a subdirectory of your
current directory called ``naif''. For example, if you want the NAIF
Toolkit files to be under the directory /u/home/JPL/naif, change your
present working directory to /u/home/JPL. Then, extract the files from
the tar tape. Remember to substitute ``/u/home/JPL'' with your
directory name.
% cd /u/home/JPL
% mkdir naif
% tar xvf /dev/rst1 ./naif
Creating the Object Libraries and Executables
--------------------------------------------------------
Can You Use the Files Included in Your Delivery?
Once the files have been loaded onto your machine you need to
determine if you must rebuild the object libraries and executables.
To determine this, first change directory to the directory containing
the TOOLKIT object libraries (/u/home/JPL/naif/toolkit/lib) and try to
list the contents of the SPICELIB object library, spicelib.a. Remember
to substitute ``/u/home/JPL'' with your directory name.
% cd /u/home/JPL/naif/toolkit/lib
% ar tv spicelib.a
If this was not successful, you must rebuild the object libraries and
executables. Instructions are given in the next section.
If this was successful, you need to determine if you can run an
executable successfully. To do this, change directory to the directory
containing the executables (/u/home/JPL/naif/toolkit/exe). Try to run
the executable sptest.
Do not enter anything in response to the prompts. Just interrupt the
execution by typing Ctrl-C. We're only interested in determining if we
can run it from the operating system standpoint, not if we can run it
through a full execution! Remember to substitute ``/u/home/JPL'' with
your directory name.
% cd /u/home/JPL/naif/toolkit/exe
% sptest
If anything looks abnormal, you need to rebuild the files. For
example, if you see the following message,
ld.so: libF77.so.1: not found
you need to rebuild the object libraries and executables because the
operating system cannot find the FORTRAN libraries that our executable
linked with. Your libraries may be more up to date, or they may reside
in a different location. So, the best thing to do is recreate the
object libraries and executables.
Rebuilding the Object Libraries and Executables
To rebuild the object libraries and executables, change directory to
the /u/home/JPL/naif/toolkit subdirectory and execute the script
make_toolkit.csh. Redirect standard output and standard error to the
file make.results so that we can help you if there's a problem.
Remember to substitute ``/u/home/JPL'' with your directory name.
% cd /u/home/JPL/naif/toolkit
% csh make_toolkit.csh ❯&! make.results
When make_toolkit.csh is done executing, check the file make.results
to see if everything compiled and linked successfully.
If you need help or have problems see the section ``How to Contact
NAIF'' for instructions on contacting NAIF.
After the Installation
--------------------------------------------------------
After the software has been installed successfully, there are a few
things you you must do: convert the example SPK and CK files from
transfer format to binary format, and verify that the SPK software is
working properly. The next sections explain how to do these things.
Converting SPK and CK Files from Transfer to Binary Format
After the installation, you need to convert all of the transfer format
ephemeris (S- and P- kernel) and pointing (C- kernel) files to binary
format. The files that NAIF delivers to you in the Toolkit are example
files. To find them, look in /u/home/JPL/naif/toolkit/example_data
(substituting ``/u/home/JPL'' with your directory name). The files
with the extensions .tsp and .tc need to be converted to binary
format. Please use the extensions .bsp for binary SPK files, and .bc
for binary CK files.
The SPICELIB readers and all of the NAIF Toolkit programs that read
ephemeris and pointing files require the files to be in binary format.
Consult the SPACIT User's Guide (spacit.ug) in the directory
/u/home/JPL/naif/toolkit/doc for information about running SPACIT, the
program that converts and summarizes S- and P- kernel and C- kernel
files.
Verifying that Ephemeris Readers are Working Correctly
The NAIF Toolkit program SPTEST tests the installation of the SPK
(ephemeris) file readers, and indirectly tests much of the SPICELIB
library. Before running SPTEST, the test transfer format ephemeris
file
/u/home/JPL/naif/toolkit/example_data/sptest.tsp
must be converted to the binary ephemeris file
/u/home/JPL/naif/toolkit/example_data/sptest.bsp
To run SPTEST, consult the SPTEST User's Guide (sptest.ug) in the
directory /u/home/JPL/naif/toolkit/doc.
Remember to substitute ``/u/home/JPL'' with your directory in the
filenames listed above.
How to Contact NAIF
--------------------------------------------------------
If you have problems or suggestions you can contact NAIF via U.S.
Mail, electronic mail or phone as specified below.
U.S. Mail address:
Hester Neilan
Jet Propulsion Laboratory
Navigation Ancillary Information Facility
4800 Oak Grove Drive
Mail Stop 301-125L
Pasadena, CA 91109
Electronic mail address:
Decnet: NAIF::HAN (14338::HAN)
Internet: han@naif.jpl.nasa.gov (han@128.149.126.12)
Internet: hneilan@spice.jpl.nasa.gov (hneilan@128.149.126.2)
Phone number:
(818) 354-2504 (Hester Neilan)
|