From btaber@spice.jpl.nasa.govFri Feb 21 12:50:59 1997 Date: Tue, 5 Nov 96 18:22:19 -0700 From: "Bill L. Taber" To: "Ian J. E. Jordan" Subject: Re: spicelib update Hi Ian, Enclosed are instructions for downloading the NAIF Toolkit for a Sun SPARCstation running SunOS via ftp. (Be sure to see the P.S. at the end of this message.) The delivery files are on a Sun SPARCstation that supports anonymous ftp. To obtain your copy of the software, you should follow the scenario described below. Note that your computer may have different prompts and may not have the same implementation of ftp as does our machine. If you have problems with ftp, contact your system administrator. If you still have problems, contact us! * ftp to the NAIF ftp server. ftp naif-sun.jpl.nasa.gov If this address cannot be resolved, try the numeric address for the server. ftp 128.149.126.11 * Login as the user anonymous. ftp> user anonymous (or if you're given a prompt: Username: anonymous or Name (han:naif): anonymous ) * Enter your e-mail address for the password. Password: user@host At this point you should be "connected" to the ftp server. If you are familiar with the workings of ftp, you can simply execute the sequence of steps described in the next section "Short Cut." On the other hand, if the instructions in there don't look familiar, skip over "Short Cut" and follow the "Detailed Instructions." Short Cut. ---------- If your are familiar with the workings of ftp, you can simply execute the sequence of steps described here. On the other hand, if the instructions below look like inscrutable code, skip over this section and begin with the more "Detailed Instructions." ftp> cd pub/naif/toolkit/Sun_SunOS ftp> ascii ftp> get README ftp> get install.csh Next transfer various text files as seem appropriate for your needs ftp> get dscriptn.txt (describes toolkit structure. Included in toolkit ".tar" file.) ftp> get whats.new (describes new features and bug fixes in this and previous editions of the toolkit. Included in the ".tar" file.) ftp> get naif0005.tls (Most recent leapseconds kernel) ftp> get pck00005.tpc (Most recent PCK kernel) Finally, set the transfer mode to binary and copy the archive. ftp> binary ftp> get toolkit.tar.Z You now have everything you need to install the toolkit on your machine. Just follow the instructions in the README file. Detailed Instructions. ---------------------- At this point you should be "connected" to the ftp server. However, you need to move to the directory where the toolkit files for your machine are located. * Change directory to pub/naif/toolkit/Sun_SunOS. ftp> cd pub/naif/toolkit/Sun_SunOS There are several files in this directory that you will need to transfer in order to install the toolkit on your machine. Get the ascii files first. (FTP treats files as either ascii (text) or binary.) * Set the transfer mode to ASCII. ftp> ascii * "get" the README file that describes how to install the toolkit on your computer. ftp> get README If you would like to know the system requirements for the Toolkit before you download it, read this file. If you are on a Unix platform you can do this in your ftp session. Just type the command ftp> get README - to display the contents of the file to your screen. Other systems do not support this option, so it may be necessary to download the file first, then read it on your local platform. * "get" the toolkit installation script ftp> get install.csh * There are two "information" files contained in the same directory. They are: dscriptn.txt describes the structure and contents of the toolkit package. whats.new describes the functional enhancements and "bug" fixes that have been included in this and several previous editions of the toolkit. These two files are included in the toolkit package that you will copy in a moment, but they are also available individually so that you can download and review them prior to getting an entire toolkit package. To "get" these files, type: ftp> get dscriptn.txt ftp> get whats.new * There are two additional data files located in the same directory as the toolkit package. naif0005.tls is a leapseconds kernel. Most SPICE-based applications require such a file. It is used in converting time between Coordinated Universal Time (UTC) and ephemeris time (ET). pck00005.tpc is a Planetary Constants Kernel. It is used in determining the shape and orientation of planets and satellites. These files are described in more detail in the README file you copied earlier. These files are NOT in the toolkit package. If you don't already have them, you should "get" them now. ftp> get naif0005.tls ftp> get pck00005.tpc * Now retrieve the binary component of the toolkit. Set the transfer mode to binary. ftp> binary * "get" the ".tar" file containing the NAIF Toolkit software and documentation. ftp> get toolkit.tar.Z * exit from ftp ftp> quit Once you've successfully downloaded the delivery files, follow the instructions in the README file that you just downloaded. As always, if you have any problems or suggestions, please let NAIF know. Best Regards Bill P.S. Once you've executed the install.csh file, you will need to perform one more task. Set your current working directory to the .../toolkit directory. Type the following command. /bin/csh -f makeall.csh This step is necessary because the library and executables in the toolkit were built under an older version of FORTRAN. As a result, if you try to link against SPICELIB, etc without rebuilding the library you may have unresolved references. By executing the makeall.csh script, you get a version of the toolkit built with your current version of FORTRAN. If you have problems, please let me know. Bill btaber@spice.jpl.nasa.gov Phone (818) 354-4279 FAX (818) 393-6388 JPL MS 301/125L 4800 Oak Grove Drive Pasadena, CA 91109