next up previous contents
Next: Adding Users in the Up: Walkthrough Examples Previous: Obtaining dstool Source Code   Contents

Installing a Multi-User Configuration

This example shows the installation of dstool for access by multiple system users. The central copy of the program libraries will be kept in the subdirectory dstool of the system directory /usr/local. To perform this installation, the user must have super-user privileges. The super-user prompt is the character ``#''. The system printer has the name ``sparc'' and, because of disk space considerations, the user chooses to construct a ``small'' build for the central dstool installation. Notice that the user begins by checking the definitions of the DSTOOL and OPENWINHOME variables, verifying the link path contains the OpenWindows libraries and setting the working directory to be DSTOOL/bin.

# pwd
/usr/local/dstool
# setenv
DSTOOL=/usr/local/dstool
DSTOOL_COLOR_DIR=/usr/local/dstool/colormaps      ( only relevant variables
DSTOOL_DATA_DIR=/marcy/guest/dstool                 are shown here )
LD_LIBRARY_PATH=/usr/local/openwin/lib
LOGNAME=guest
OPENWINHOME=/usr/local/openwin
PATH=.: ...... :/usr/local/dstool/bin             ( only /usr/local/dstool/bin
# cd bin                                            is shown here )
# ls -l
total 13
-r-xr-xr-x  1 root         9026 Sep 26 08:25 install_dstool*
-r-xr-xr-x  1 root         4022 Sep 26 08:25 install_dsuser*
# install_dstool
################################################################
                     dstool installation script

                         Cornell University 
                   Center for Applied Mathematics 
################################################################


 
Several steps are involved in installing a copy of dstool onto a Sun
workstation:
 
    1.  Check that the environment variables DSTOOL and OPENWINHOME 
        have been defined and that $DSTOOL/bin has been added to the 
        search path.
    2.  If this is a new installation, extract the source code 
        from the distribution file. 
    3.  Check that the paths defined in step 1 are sufficient to
        build a working program.
    4.  Change program characteristics that are specific to your
        working environment (printer name, etc..).
    5.  Compile and link the dstool executable
 
This installation program automates the installation of dstool, using
responses from the user. 
 
 
The installation directory for dstool is controlled by the
environment variable DSTOOL. You MUST have DSTOOL defined to
proceed with the program installation.
 
Currently, DSTOOL is set to the path:
            /usr/local/dstool
Do you want to proceed to install the dstool program in /usr/local/dstool?:
(yes or no): yes
 
 
During the process of compiling dstool, several files and libraries are required
from the OpenWindows package.  The search for these files is controlled by the
environment variable OPENWINHOME and the addition of: 
                     $OPENWINHOME/lib 
to the library search path.  
 
OPENWINHOME is set to: /usr/local/openwin
 
If this is not correct, please exit and consult the dstool installation document
or the OpenWindows users guides for more information on setting up your Windows
environment.
Continue with the installation (yes or no): yes
Extracting the dstool source...please wait.
x Makefile, 942 bytes, 2 tape blocks
x colormaps/colormap, 1392 bytes, 3 tape blocks
x colormaps/colortable_alt, 421 bytes, 1 tape blocks
x colormaps/colortable_id, 549 bytes, 2 tape blocks
x colormaps/sys_colormap, 64 bytes, 1 tape blocks
x colormaps/colortable_inv, 550 bytes, 2 tape blocks
x site_specific/lib_incl.mk, 196 bytes, 1 tape blocks
x site_specific/Prolog.ps, 4563 bytes, 9 tape blocks
					:
					:  ( many lines of output appear )
					:
x site_specific/cleanup.mk, 227 bytes, 1 tape blocks
x site_specific/targets.mk, 985 bytes, 2 tape blocks
x src/windows/twoD_opt/twoD_opt_hnd.c, 5205 bytes, 11 tape blocks
x src/windows/Makefile, 670 bytes, 2 tape blocks
x src/windows/ui_init.c, 4520 bytes, 9 tape blocks
x src/Makefile, 1757 bytes, 4 tape blocks
x src/dstool.c, 3260 bytes, 7 tape blocks
 
Checking the paths and libraries...please wait.
 
No match.
cd /usr/local/dstool/src/guide ; make guidelib.a
cc -O -I/usr/local/openwin_2.0/include -I/usr/local/dstool/src/windows
  -I/usr/local/dstool/src/include -c gdd.c -o gdd.o
cc -O -I/usr/local/openwin_2.0/include -I/usr/local/dstool/src/windows
  -I/usr/local/dstool/src/include -c gcm.c -o gcm.o
ar rv guidelib.a gdd.o gcm.o
a - gdd.o
a - gcm.o
ar: creating guidelib.a
ranlib guidelib.a
cc -O -I/usr/local/openwin_2.0/include -I/usr/local/dstool/src/windows
  -I/usr/local/dstool/src/include -c libtest.c -o libtest.o
cc -O -I/usr/local/openwin_2.0/include -O -target sun4 libtest.o
  /usr/local/dstool/src/guide/guidelib.a -O -lxview -lolgx 
  -L/usr/local/openwin_2.0/lib -lX -lm -o /usr/local/dstool/install/libtest
[1] 5325
The automatic test of the system library paths is completed.  
Do you want to continue (y/n) ? 
yes
[1]    Killed               libtest
 
The default printer name is currently: lp. Do you want to
use this printer name?
(yes or no): no
Enter new printer name: sparc
 
The default printer name is currently: sparc. Do you want to
use this printer name?
(yes or no): yes
 
Filesystem            kbytes    used   avail capacity  Mounted on
/dev/sd0a               7508    4916    1841    73%    /
/dev/sd0g              74722   65830    1419    98%    /usr
swap                    4720      52    46681%    /tmp
macomb:/usr/local     316674  264813   20193    93%    /usr/local

 
You may select one of the following installation options:
 
   full          Installs all of the dstool source and library files.
                 This option requires approximately 9.5 Mbytes of disk space.
 
   small         Installs only the libraries and essential dstool source 
                 required to add new dynamical systems.
 
Enter installation type (full or small): small
 
Making the dstool executable...
cc -O -I/usr/local/openwin_2.0/include -I/usr/local/dstool/src/windows
  -I/usr/local/dstool/src/include -c /usr/local/dstool/src/dstool.c 
  -o /usr/local/dstool/src/dstool.o
ar rv /usr/local/dstool/src/mainlib.a /usr/local/dstool/src/dstool.o
a - /usr/local/dstool/src/dstool.o
ar: creating /usr/local/dstool/src/mainlib.a
ranlib /usr/local/dstool/src/mainlib.a
					:
					:  ( many lines of output appear )
					:
example.o
ar rv userlib.a user_panels.o mult_proj.o example.o
a - user_panels.o
a - mult_proj.o
a - example.o
ar: creating userlib.a
ranlib userlib.a

cc -O -I/usr/local/openwin_2.0/include -O -target sun4 
  /usr/local/dstool/src/mainlib.a 
  /usr/local/dstool/src/config/configlib.a
  /usr/local/dstool/src/windows/uilib.a 
  /usr/local/dstool/src/windows/cmd/cmdlib.a
  /usr/local/dstool/src/windows/twoD/twoDlib.a 
  /usr/local/dstool/src/windows/defaults/defaultslib.a
  /usr/local/dstool/src/windows/periodic/periodiclib.a 
  /usr/local/dstool/src/windows/save/savelib.a
  /usr/local/dstool/src/windows/load/loadlib.a 
  /usr/local/dstool/src/windows/print/printlib.a
  /usr/local/dstool/src/windows/function/functionlib.a
  /usr/local/dstool/src/windows/mult/multlib.a
  /usr/local/dstool/src/windows/orbit/orbitlib.a 
  /usr/local/dstool/src/windows/prop/proplib.a
  /usr/local/dstool/src/computation/complib/complib.a
  /usr/local/dstool/src/windows/selected/selectlib.a
  /usr/local/dstool/src/computation/fixptlib/fixptlib.a
  /usr/local/dstool/src/computation/eigenlib/eigenlib.a 
  /usr/local/dstool/src/storage/memory/memorylib.a 
  /usr/local/dstool/src/storage/storagelib.a
  /usr/local/dstool/src/utilities/utillib.a 
  /usr/local/dstool/src/guide/guidelib.a
  /usr/local/dstool/src/models/modellib.a  
  /usr/local/dstool/src/userlib/userlib.a
  -O -lxview -lolgx -L/usr/local/openwin_2.0/lib 
  -lX -lm -o /usr/local/dstool/bin/dstool
  
Making the dstool libraries...
cd /usr/local/dstool/src/config ; make configlib.a
`configlib.a' is up to date.
cd /usr/local/dstool/src/windows ; make uilib.a
`uilib.a' is up to date.
cd /usr/local/dstool/src/windows/cmd ; make cmdlib.a
`cmdlib.a' is up to date.
					:
					:  ( many lines of output appear )
					:

cd /usr/local/dstool/src/models ; make modellib.a
`modellib.a' is up to date.
cd /usr/local/dstool/src/userlib ; make userlib.a
`userlib.a' is up to date.
for i in /usr/local/dstool/src/mainlib.a
/usr/local/dstool/src/config/configlib.a
/usr/local/dstool/src/windows/uilib.a
/usr/local/dstool/src/windows/cmd/cmdlib.a
/usr/local/dstool/src/windows/twoD/twoDlib.a
/usr/local/dstool/src/windows/defaults/defaultslib.a 
/usr/local/dstool/src/windows/periodic/periodiclib.a
/usr/local/dstool/src/windows/save/savelib.a 
/usr/local/dstool/src/windows/load/loadlib.a
/usr/local/dstool/src/windows/print/printlib.a 
/usr/local/dstool/src/windows/function/functionlib.a
/usr/local/dstool/src/windows/mult/multlib.a
/usr/local/dstool/src/windows/orbit/orbitlib.a
/usr/local/dstool/src/windows/prop/proplib.a 
/usr/local/dstool/src/computation/complib/complib.a
/usr/local/dstool/src/windows/selected/selectlib.a 
/usr/local/dstool/src/computation/fixptlib/fixptlib.a
/usr/local/dstool/src/computation/eigenlib/eigenlib.a 
/usr/local/dstool/src/storage/memory/memorylib.a
/usr/local/dstool/src/storage/storagelib.a
/usr/local/dstool/src/utilities/utillib.a
/usr/local/dstool/src/guide/guidelib.a
/usr/local/dstool/src/models/modellib.a
/usr/local/dstool/src/userlib/userlib.a;
do \
(cp $i /usr/local/dstool/libraries); \
done
ranlib -t /usr/local/dstool/libraries/*.a
 
 
Installation of dstool is complete.



root
1998-11-02