If dstool is to be used widely by on your computer system, it is recommended that dstool be installed in the system directory, /usr/local/dstool. By doing so, dstool becomes available to everyone who uses the system. Also, the main dstool libraries are protected from accidental corruption since files in /usr/local/dstool may be read and executed by everyone, but may not be erased or modified by the general user.
Remark: Installing software in certain system directories, like /usr/local, requires special access permissions, called super-user privileges. This means that installing the software, and later maintaining the dstool library files, requires either that you have super-user privileges or that you contact the system manager.
However, the dstool-home directory does not need to be in a special, protected location and there are circumstances that motivate other arrangements:
If a multi-user installation is desired, create a directory for the dstool software in the appropriate location. This directory can have any name; in the examples that follow, we will presume that the program will be installed in a subdirectory of /usr/local called dstool. From now on we assume the person installing the software has the appropriate permissions required to create files in this directory. Then the command to accomplish the creation of the dstool directory is:
mkdir /usr/local/dstool
Two environment variables must be defined. These variables are:
These environment variables can be set in either the user's .login or .cshrc files, and the commands are identical in either case. For the example described above, the appropriate entries would be:
3#3
setenv DSTOOL /usr/local/dstool
setenv DSTOOL_COLOR_DIR $DSTOOL/colormaps
3#3
setenv OPENWINHOME /usr/local/openwin
setenv LD_LIBRARY_PATH $OPENWINHOME/lib
set path = ( 4#4 $DSTOOL/bin )
3#3
Note that UNIX already knows about the variable HOME so that users do not have to type in their home directory explicitly. For emphasis we show that the OPENWINHOME environment variable is defined, and the subdirectory OPENWINHOME/lib is in the path specification for the resolution of library files. It is crucial that OPENWINHOME and LD_LIBRARY_PATH are correctly defined for your system; refer to the OpenWindows Installation and Start-Up Guide for more information or ask your system manager for instructions. In addition, the user's path statement includes an entry for the subdirectory DSTOOL/bin where the dstool executable program is kept along with several utilities; this search path is used to find the program when the user initiates execution, even if the user's current working directory does not contain the executable module. The DSTOOL environment variable and the path variable will not be reinitialized until .login and .cshrc shellscripts are rerun. If you make changes to your .cshrc file, make sure that you type
source 2#2 /.cshrc
before you proceed with the installation, where 2#2 is expanded by UNIX to be the path of your home directory. If you decide to change the .login file instead, the safest way to reinitialize your environment is to terminate your session and log back in again.
The installation of dstool may now proceed according to the instructions contained in Section 0.4. Once the central dstool installation is complete, refer to Section 0.5 on setting up the user-dstool directory for each individual user.