next up previous contents
Next: Multi-User Environment Up: Choosing a dstool Configuration Previous: Choosing a dstool Configuration   Contents

Single User Environment

Single-user installation of dstool usually means that the program and all of its source, object and utility files is contained in a subdirectory of a user's home directory. There are several situations where such a configuration might be appropriate:

If a single-user installation is desired, create a directory for the dstool software in the appropriate location. This directory can have any name; in the example that follows, we will use the name mydstool and create it in the user's home directory. The commands to accomplish this are:


		 cd 2#2

mkdir mydstool

Three 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 $HOME/mydstool
setenv DSTOOL_COLOR_DIR $DSTOOL/colormaps
setenv DSTOOL_DATA_DIR $DSTOOL/data
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.


next up previous contents
Next: Multi-User Environment Up: Choosing a dstool Configuration Previous: Choosing a dstool Configuration   Contents
root
1998-11-02