Installation Prev | Table of Contents | Next

What's in the installation package:

etc/xviewsdtsrc.first Default run control file
usr/local/bin/xviewsdts XViewSDTS executable
usr/local/bin/invsdts Utility for inventorying SDTS files
usr/local/share/nist/fips55/all FIPS 55 database of civil placenames
usr/local/doc/xviewsdts-0.02/ Directory holding documentation files
var/share/usgs/ Directory holding sample SDTS and GNIS files
install_xviewsdts Installation script
installation.txt Installation instructions
beta_agreement.txt Beta testing agreement

 

Installation Steps

In the following steps, the installation package is assumed to have the name xviewsdts-0.02-1.tar.gz.  If you have a newer package, please substitute its name where appropriate.

As root, perform the following steps to install XViewSDTS:

  1. cd to a directory where you may safely unpack the XViewSDTS package (for instance, /tmp).
  2. Copy the XViewSDTS package (e.g., xviewsdts-0.02-1.tar.gz) to that directory.
  3. tar -xzf xviewsdts-0.02-1.tar.gz
  4. cd xviewsdts-0.02
  5. ./install_xviewsdts
The install_xviewsdts script will copy the files to their appropriate locations.  You should then be able to log on as a regular user and run xviewsdts by going to a terminal window in the X Window System and entering the following command:

    xviewsdts
 
 

Changing the default directory names

The following discussion only applies to you if you have a conflict with the default directory names used by the installation script, or otherwise wish to use directory names other than the defaults.

In the remote chance that (before installing XViewSDTS) you already have a directory named /usr/local/share/nist/ or a directory named /var/share/usgs/ which you use for something other than XViewSDTS, then you may create a new directory with a name of your choice and manually copy the files to it from the usr/local/share/nist/ or var/share/usgs/ directory in the installation package.  Then in /etc/xviewsdts.first you must edit every line which contains the directory name that you have changed; simply replace the original name with the new name you chose.

For instance, if you have chosen to replace /var/share/usgs/ with /var/share/maps/, then in xviewsdtsrc.first you would change the following line

        lookup_24_pathname=/var/share/usgs/dlg24/lookup
to
        lookup_24_pathname=/var/share/maps/dlg24/lookup

Other lines would also need to have the same change made.

Please note that the above discussion won't apply to most users.  Most users won't have a /usr/local/share/nist/ or /var/share/usgs/ directory until they install XViewSDTS.  If you are like most users, but are reading this because you already have both of those directories, it is likely that someone has previously installed XViewSDTS in your filesystem.  Compare those directories with the directories in the installation package to see if this is the case before going through the trouble of creating new directories.
 
 

Viewing your own collection of SDTS files

As installed, xviewsdts is configured for viewing the sample files.  You may, of course, follow the convention used for the sample files and place your SDTS files in the appropriate subdirectories under /var/share/usgs/.  But you may already have SDTS files that are happily residing elsewhere in your file system.  If so, you may edit /etc/xviewsdtsrc.first so that the dlg_directory item points to the location of your files.  Depending upon the depth of the directory subtree in which your SDTS files live, you may also need to increase the value of the recursive_depth item.  (See Editing Run Control FIles.)  (It's a good idea to test xviewsdts with the sample files before editing the run control file.)

If you have only a few SDTS files, their location is not critical: xviewsdts should be able to search for and find them.  However, if you have many SDTS files, you may want to take advantage of the added speed gained by using lookup files, which eliminates the need for xviewsdts to search through your directory tree.  If so, you should place your files such that each map series (1:2,000,000, 1:100,000, and 1:24,000) lives under its own directory.  Actually, this is not a restriction of xviewsdts, but of the utility, invsdts, which builds the lookup files.  (See Creating Lookup Files.)
 

Copyright © 2002 by Dapper Mapper

Installation Prev | Table of Contents | Next