[comp.sys.isis] ISIS installation notes

ken@gvax.cs.cornell.edu (Ken Birman) (08/16/90)

Below are installation notes contributed by a user who found that the 
notes in the manual werte out of date in certain places and required
too much page-flipping during installation...

Thanks! -- KB

--------------------------------- cut here -------------------------------------
LOCAL INSTALATION NOTES, RPC Rodgers, K. Fiebig, 14 Aug 1990

These notes summarize what should be the actual steps for successful local
installation (not tested in this sequence):

--------------------------------------------------------------------------------

ON SERVER:

1)  Create sites

2)  Create isis.rc

3)  Edit /etc/services (redundant, as sites provides same information)

4)  If using Yellow Pages:

       cd /var/yp
       make services

5)  Create /site/spool/isis, move into it:

       sites
       isis.rc

6)  cd .../SUN4

7)  Edit makefile (uncomment MCHDEP line) to enable bypass comm. mode.

8)  Install ISIS:

       make all
       make install

9)  Add following lines to /etc/rc.local:

       if [ -f /site/spool/isis/bin/isis ]; then
          /site/spool/isis/bin/isis > /dev/console 2>&1 &
          (echo 'starting ISIS system')                 >/dev/console
       fi

10) Create a script named /site/bin/startisis, which is automatically invoked
    by isis applications if isis is not running::

       #! /bin/sh 
       # 
       (cd /site/spool/isis; ./bin/isis > /dev/console  2>&1 &) 
       if [ "$?" -eq 0 ]
       then
          echo "ISIS application restarting (dead) ISIS system" > /dev/console
       fi 
       # 
       # end of script

    then enable script:

       chmod 755 /site/bin/startisis

11) Create the required links:

       ln -s /site/subsys/ISIS_2.0.dir/isisv2.0/SUN4/bin /site/spool/isis/bin
       ln -s /site/subsys/ISIS_2.0.dir/isisv2.0/SUN4/lib /usr/lib/isis
       ln -s /site/subsys/ISIS_2.0.dir/isisv2.0/include /usr/include/isis
       ln -s /site/bin/startisis /usr/bin/startisis

12) Modify MANPATH to include (at end): /site/subsys/ISIS_2.0.dir/isisv2.0/man

13) In /site/spool/isis:

       ./bin/isis

    to test startup.

14) Edit the several required demo files to get them to find the X11 libraries
    which come with Sun OpenWindows, which are not in standard locations.

15) Read about demos in Appendix D of the ISIS manual, "Twenty questions and
    other demo software," and the files isis/demos/XXXXX.blurb, then try a few,
    as in:

       cd .../run_demos
       ./sun_grid

--------------------------------------------------------------------------------

ON CLIENTS:

1)  If NOT Using YP, edit /etc/services
       (redundant, as sites provides same information)

2)  In /site/spool/isis:

       ./bin/isis

    to test startup.

3)  Add following lines to /etc/rc.local:

       if [ -f /site/spool/isis/bin/isis ]; then
          /site/spool/isis/bin/isis > /dev/console 2>&1 &
          (echo 'starting ISIS system')                 >/dev/console
       fi

--------------------------------------------------------------------------------