SIF Installation

NOTE TO CS285 CLASS MEMBERS:

If you are using the instructional machines in 347 and 349 then you are NOT a member of the UNIGRAFI GROUP. In which case do not follow the instructions which are for UNIGRAFI GROUP MEMBERS ONLY. This will make things much smoother. Thanks.

Installation Instructions

• Setting up your Environment

  • Create a projects directory in your account, i.e. mkdir ~/projects
  • Add the following lines to your .cshrc file

    ########################################
    # SIF Stuff
    
    # Environment Variables
    set os = `uname`
    setenv SYSTEM SYSTEM/$os
    setenv CVSROOT /project/cs/sequin/caffe/cvsroot
    setenv SIFHOME $HOME/projects/sif 
    setenv SIFLOCAL $HOME/projects
    setenv SIFSHARED /project/cs/sequin/caffe
    setenv MAKEPATH $SIFHOME/makefiles
    umask 022
    
    if ( $os == IRIX ) then
      setenv TCL_LIBRARY /usr/sww/lib/tcl8.0/
      setenv TK_LIBRARY /usr/sww/lib/tk8.0/
    endif
    
    # Path
    set path = (. $SIFHOME/bin $SIFHOME/bin/$SYSTEM $SIFSHARED/sif/bin $SIFSHARED/sif/bin/$SYSTEM /usr/sww/bin $path)
    
    
    # Aliases
    alias gmake 'mkdir $SYSTEM/.makefiles > & /dev/null; touch $SYSTEM/.force; echo "start: updating libraries"; \gmake QUIET=no PASS=1; echo "done: updating libraries"; echo "start: updating program"; echo -n "checking dependencies"; \gmake -s QUIET=no PASS=2 empty; echo "done"; \gmake QUIET=yes PASS=2 \!*'
    
    alias gdb gdb -d $SIFHOME/lib/genlib/ -d $SIFHOME/lib/mathlib/ -d $SIFHOME/lib/boundlib/ -d $SIFHOME/lib/datalib/ -d $SIFHOME/lib/geomlib/ -d $SIFHOME/lib/langlib/ -d $SIFHOME/lib/parselib/ -d $SIFHOME/lib/applib/ -d $SIFHOME/lib/appgllib/ -d $SIFHOME/lib/curvelib/ -d $SIFHOME/lib/beadlib/ -d $SIFHOME/lib/wormlib/ -d ..
    
    # SIF Stuff
    ##########################################
    

• *** START: UNIGRAFI GROUP MEMBERS ONLY ***

• CVS

  • cd ~/projects -- This is where the sif source tree will be located
  • mkdir sif
  • chgrp unigrafi sif
  • chmod 755 sif
  • chmod g+s sif
  • Run cvs checkout sif. This will fill the sif directory you created with all the assorted source tree and code below it.

• Install Links

  • cd sif
  • Run RUN_INSTALL -- This will create symbolic links within the source tree becaus CVS does not deal with symbolic links.
  • If you are a CLIENT, i.e. NOT UG then run RUN_INSTALL_CLIENT -- This will create links to large necessary directories, like mesa. It will also release all of your local copies of the sif libraries and replace the directories with links to the library source trees in the shared UG area. This will save space and time by not forcing everyone to maintain copies of the libraries.

• Using CVS

  • A general note is that all of these commands must be run in the directory where the file in question exists
  • cvs update (file) will update a file with the newer version from the repository
  • cvs update -d will update pwd and all of its subtree
  • cvs update -d (dir) will update dir and all of its subtree

• Sharing Libraries

  • Sara has written two scripts which help CVS users checkout local copies of the libraries.
  • sif/bin/rellibs takes a list of libraries and performs a cvs release -d (lib) on each library, and then creates a symbolic link to the shared library. This happens to all of the libraries when RUN_INSTALL_CLIENT is called.
  • sif/bin/editlibs takes a list of libraries first removes the symbolic link and then performs a cvs update -d (lib) on each library. This will give you a local editable copy of the library.

• *** END: UNIGRAFI GROUP MEMBERS ONLY ***

• *** START: INSTRUCTIONAL CS285 MEMBERS ONLY ***

• Installing

  • cd ~/projects -- This is where the sif source tree will be located
  • cp /project/cs/sequin/caffe/sifclient/sif.tar .
  • tar -xvf sif.tar
  • That is all you need to do to start. DO NOT run the INSTALL scripts, I have already done that for you.

• Sharing Libraries

  All libraries start out as being shared. The sif.tar only has symbolic link place holders. For each library that you want to work on and modify do the following

  • Go to the Makefile of the program you are working on like $SIFLOCAL/sif/worm/Make.
  • Move the library and all libraries to the left of it from the SYSLIBS line up to the MYLIBS line of the Makefile.
  • For each library (libname) that you moved to the MYLIBS line of the Makefile do:
    • cd $SIFLOCAL/sif/lib -- This is your copy of course.
    • rm (libname)
    • cd /project/cs/sequin/caffe/sif/lib
    • tar -cvf $SIFLOCAL/sif/lib/(libname).tar (libname)
    • cd $SIFLOCAL/sif/lib
    • tar -xvf (libname).tar
    • Now you have a local copy of the library in question
  • Now you can cd $SIFLOCAL/sif/(program)
  • and gmake -- this should consistently compile your program and all the altered libraries.

• *** END: INSTRUCTIONAL CS285 MEMBERS ONLY ***