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)