First, create the directory where you want 2.11 Toolbox program code installed. This is not necessarily where you will be storing the ArcInfo coverages and other program data -- only the program code. This will be referred to as your installation directory. The directory where you actually run the program and store the data will be called your working directory.

First, copy the distribution archive, toolbox.tar.Z, to your install directory. Then uncompress and extract the files from the archive:

$ uncompress toolbox.tar.Z
$ tar xvf toolbox.tar

A listing of the directory should look like this:

$ ls -a
./               .toolbox.profiles            toolbox/
../              .toolbox.system_settings     
.toolbox.cfg     arc.aml                      

$ ls toolbox
./ ../ amls/ docs/ help/ misc/

Set ArcInfo Parameters

Next, you need to ensure that the ArcInfo parameters amlpath and menupath both point to the directory $TOOLBOX/amls. The simplest way to do this is to copy the file arc.aml to your working directory. If the file already exists, add the following two lines to your copy instead of overwriting it:

&amlpath $TOOLBOX/amls
&menupath $TOOLBOX/amls

Copy the three .toolbox* files to your login directory. If there will be more than one login using the Toolbox, then copy these files to each directory.

Environment Variables

The 2.11 Toolbox makes use of several environment variables, which need to be set as follows:

• $TOOLBOX should contain the full pathname of the toolbox/ subdirectory of your Toolbox installation directory.

• $HOME should contain the full pathname of your home directory.

• $PATH needs to include the directory $TOOLBOX/misc. Be sure to set the variable $TOOLBOX before you add it to your path.

Tip: Under Korn or Bourne shells and their derivatives, environment variables need to be exported, using the UNIX export command. Under C shell, they are automatically exported.

Tip: Define these variables in your .cshrc, .profile, or other initialization file, so that they will be set automatically when you start a UNIX session.

If you have any questions about how to set environment variables in UNIX, please see your System Administrator.

Set the System Configuration

The next step is to modify the configuration file .toolbox.cfg. Although most of the settings should be correct, you may need to change some of them. Items of particular importance are:

• .perl: Pathname to your Perl interpreter (Typically /usr/bin/perl)
• .awk: Pathname to your awk interpreter (Typically/ usr/bin/nawk)
• .sed: Pathname to your sed interpreter (Typically /usr/bin/sed)
• .editor: Name and path of your text editor (Try /usr/bin/vi)
• .display_type: Default ArcInfo display type (Typically 9999)
• .term_type: Default ArcInfo terminal type (Typically 9999)

Also, check the file $TOOLBOX/misc/import. The first line needs to be checked to ensure that the path where Perl is stored is correct for your system.

See you system administrator if you have any questions about any of these settings.

Finally, run the 2.11 Toolbox Configuration Program.

To Add a New Toolbox User to an Existing Installation

The procedure is similar to that for installing the 2.11 Toolbox:

1. Copy the three .toolbox* files into the new user's login directory. These can be copies of the distribution files, or can be copies of an existing user's customized versions.

2. If the new user will be working a new working directory, create the directory, and copy the file arc.aml to the new working directory, or modify an existing copy as specified above. You may also need to copy any coverages and files that the new user will need into their new working directory.

3. Modify the new user's login to set the environment variables $TOOLBOX, $PATH and $HOME as specified above.

4. Run the 2.11 Toolbox Configuration Program.

More information on the Toolbox directory structure