next up previous contents
Next: After Installing dstool Up: Installation Procedure Previous: Reading from the Distribution   Contents


The Installation Script install_dstool

This section gives step-by-step instructions for installing the dstool program with the help of the shellscript install_dstool. During the installation process, messages are printed on the screen which provide progress information and query the user for input. When the installation program poses a question and provides a list of possible responses, the first response is always the default and may be selected merely by hitting the 6#6 key. If at any time the user wishes to abort the execution of the script, hitting the 7#7 key will terminate the installation process.


Refer to Section 0.6 for a screen output of an example session.

1.
First, make sure that DSTOOL and OPENWINHOME environment variables are properly set as instructed in the previous section. Check that the default library path includes OPENWINHOME/lib.

2.
Change the working directory to the DSTOOL binaries file by typing:

cd $DSTOOL/bin

Check that this subdirectory includes the shellscript install_dstool.

3.
Type install_dstool to start the installation.

The installation program will perform the following sequence of steps:

Step 1 The installation program checks to make sure the DSTOOL environment variable is defined, and that is set to a valid directory on the system. If it detects an error, it will provide the user with the opportunity to terminate execution of the program or reset DSTOOL to a correct choice. See Section 0.3 for more information on setting the DSTOOL environment variable.

Step 2 The OPENWINHOME environment variable is checked to insure it has been properly defined and is set to a valid system directory. If these conditions are not met, the script prints an error message and terminates. Refer to Section 0.3 and the OpenWindows document Installation and Start-Up Guide for more information.

Step 3 The source and utility files which comprise the dstool program are extracted from the archive file and the remainder of the file hierarchy is built. If the source already exists in DSTOOL, say in the event that install_dstool is run to change or upgrade the program, the installation script will ask whether the user wants to overwrite the existing file system.

Step 4 Since the construction of the dstool executable requires a considerable investment of computer time compiling the source code, the installation script first builds a small demonstration test program using the current settings of DSTOOL and OPENWINHOME. If this step is successful, it is very likely that the remaining installation of dstool will proceed without error. If, instead, an error is encountered at this step the messages which result should be helpful in correcting the problem. Once the compilation of the test code libtest is error-free, a banner will be displayed on the console screen; this banner is shown in Figure 1.

Step 5 Since the identification of printers connected to the computer system is site-specific, the correct choice for the default printer name must be installed in dstool. The shellscript will use the printer name lp unless informed to do otherwise; consult your system manager for more information about the local choices for your workstation.

Step 6 In this final step, the user is given an option of making dstool. Two options exist at this stage: the user may choose to make a full or small build. In the full build, all the source code and resulting object files remain in the filesystem after the dstool libraries are assembled. In the small build, most of these files are deleted to conserve space. In both cases, construction of the libraries is automatic. The shellscript uses the UNIX make facility to compile and link dstool. All the instructions for making the dstool executables are stored in the Makefile files in the directory DSTOOL/src and its subdirectories.

4.
If installation is successful, the dstool executable should have been created in the directory DSTOOL/bin. Check to see if it is present. If so, type dstool to run the program. The basic dstool interface should appear. After the simple testing is done, quit the program and proceed with the remaining installation procedures.

If installation is not successful, go back to the previous steps, make sure all system parameters are properly set, and reinstall dstool. In case of persistent problems, please send e-mail to

dstool_bugs@macomb.tn.cornell.edu

with a complete description of the problem.

5.
If this is to be a multi-user installation, for others to use the dstool program, you must change permission on the files and subdirectories of dstool. The correct command to accomplish this would be:

chmod -R 555 $DSTOOL


next up previous contents
Next: After Installing dstool Up: Installation Procedure Previous: Reading from the Distribution   Contents
root
1998-11-02