.lo.SJ "Installation Instructions for the Entropic Signal Processing System (ESPS)".AU "Alan Parker".TM ETM-S-87-29 %I% %G%.*R ETM-S-86-14, Entropic Signal Processing System (ESPS) Programming Guidelines.sh 1 Introduction.ppThis document describes the installation procedure for ESPS Version 3.0.Please read this document completely before attempting theinstallation.    This release is intended for use on Masscomp5000 series computers running RTU 3.0 or greater andSun\-3 workstations running Sun OS 3.4.   The installationscript requires that a number of standard \s-1UNIX\s+1 utilities beavailable and on the standard execution path, such as \fIgrep\fR,\fIcc\fR, \fInroff\fR, \fIsed\fR, \fImake\fR, and \fItest\fR.   While thesystem is primarily written in C, there are several Fortran functions inthe library.  Therefore, the installation script must have theFortran compiler, \fIf77\fR.   If you do not haveFortran, call Entropic and we will supply compiled versions of theseroutines..sh 1 "Overview of Installation Process".ppThe installation is very simple.   The tape or diskettes are read into aclean directory (suggested name is esps).  This directory will becomethe \fIsource\fR directory and can by located anywhere on the filesystem, but it is suggested that it be in the login directory of thelocal ESPS maintainer..ppThe installer may adjust a few installation variables in the script toalter the default choices.   The installation script creates a\fItarget\fR directory and installs all ESPS programs and related filesthere.   If your system is low on file space, then the \fIsource\fRdirectory can be removed.  However, if you can afford the space, havingthe sources online is helpful, since they serve as example programs.For convenience, the \fItarget\fR directory contains a symbolic link backto the \fIsource\fR directory.  No ESPS programs require any of thefiles under the \fIsource\fR directory after the installation script hasbeen properly run..sh 2 "ESPS's Place in the File System"It is not necessary to be super-user while installing ESPS.  It is notnecessary (but it is possible) to put ESPS files into the standard\s-1UNIX\s+1 directories such as /usr/lib, /usr/bin/, and /usr/include.Whether you must have super-user access depends on where you want toinstall ESPS.   The typical location for the \fItarget\fR directory is\fI/usr/esps\fR.   There are two different ways to accomplish this.  Oneis to have a super-user create the directory \fI/usr/esps\fR and thenchange the owner of it to the user-id of the ESPS maintainer (the onewho read in the tape and is going to run the install script).  The otheroption is to make the \fItarget\fR directory a directory in theinstaller's own directory tree.   After ESPS has been installed, thesuper-user can install a symbolic link from \fI/usr/esps\fR to the\fItarget\fR directory.   It is important to understand, however, that\fI/usr/esps\fR is only a convention and you can install ESPS anywherein your file system you desire.   All file paths are determined by theinstallation script.  We suggest that you take option 1 from above andmake \fI/usr/esps\fR the target directory..sh 2 "A Word About Access Modes".ppThere are installation parameters to set the access modes of the fileswhen they are installed.    The default is write access by owner (shouldbe the local ESPS maintainer) and read access by others.If you desire to limit access to ESPS to a particular group, you canreset the access mode installation variables accordingly.There are installation parameters for the mode of the programs, manualpages, and library files..sh 1 "Detailed Instructions".ppESPS for Masscomp systems is available on 9 track tape, ordiskettes.  ESPS for Sun\-3 systems is available on 9 track tape or Suncartridge tapes..sh 2 "File Space Required".ppThis release of ESPS will require 5900 blocks of file space to read inthe distribution media.   An additional 11200 blocks of file space willbe required by the installation script.   After the installation scripthas completed correctly, you can remove the \fIsource\fR directory ifyou are low on file space and do not desire access to the sources..sh 2 "Reading a 9 Track Tape".ppThe tape drive is assigned and the tape (in tar format) is read in. Be sure you are in your home directory, create a directory named\fIesps\fR and then change to it.  The tape will be read into thisdirectory.  The following commands do the trick:.br.ta 4i.ft CW.nf% assign 1600	% cd% mkdir esps% cd esps% tar xvf /dev/rmt0 .ft LR.fi.ppAfter doing this you should have a directory named \fIesps\fR under your homedirectory.   This directory should contain another directory named\fIgeneral\fR and a file named \fIREADME\fR.   Check this \fIREADME\fRfile for any information that did not get put into this note..ppSkip over the next section on reading ESPS in from diskettes..sh 2 "Reading a Set of Diskettes".ppInsert the first diskette into the diskette drive.  Be sure you are inyour home directory, create a directory named \fIesps\fR and then changeto it.  The diskettes will be read into this directory.  The followingcommands do the trick:.ft CW.br.nf% cd% mkdir esps% cd esps% tar xvf /dev/rflp.ft LR.fi.ppAfter \fItar\fR reads a complete diskette, it will print a message like:.br.ft CW.nftar: errno returned 2, Cannot read inputtar: If you want to go on, type "yes" or a new pathname of a device/filename when you are ready.fi.ft LR.ppWhen you get this message, remove the diskette and insert the next inthe set and type .ft CWyes.ft LR (followed by a return).   You should not get this message when reading the lastdiskette in the set..ppAfter this you should have a directory named \fIesps\fR under your homedirectory.   This directory should contain another directory named\fIgeneral\fR and a file named \fIREADME\fR.   Check this \fIREADME\fRfile for any information that did not get put into this note..ppIf you have a problem reading the diskette, check the access mode of/dev/rflp (the diskette drive).   You might need to have a super-user change the access modeof this..sh 2 "Editing the Install Script".ppIt is suggested that for this release, only the location of the\fItarget\fR directory be modified by the user.   The first shellvariable in the script (SPSDIR) should be set to the \fBfull path\fR ofthe target ESPS location.   The default will be \fI$HOME/espsB\fR, which willhave the effect of making a directory named \fIespsB\fR in theinstaller's home directory be the ESPS \fItarget\fR directory..ppNote that the install script is a \fIsh\fR(1) script, and there can beno spaces around the equal sign (=) in variable assignment statements..ppThe other installation variables that might need adjustment are the fileaccess modes.   These default to access by everyone on the system.  Ifyou desire to limit access to to a particular group you can set theaccess mode as desired.   The group used will be that of the installer.(For full access, the last digit of the mode should be the same as thenext to last digit (eg. 0755 or 0644).  To limit access to the group,the last digit should be zero (eg. 0750 or 0640)..ppIn summary, you can run the script as it is.  You do not have to changeanything.  The default action will be to build ESPS under your homedirectory in a directory named \fIespsB\fR..sh 2 "Run the Install Script".ppAfter you have checked and reset any installation variables you simplyrun the script.   It is a good idea to capture the standard error andstandard output from the install script into a log file.It is important to use the -l option the first time ESPS is installed ina new directory.  This option causes the library to be built.The following example assumes that you are using the cshell( \fIcsh\fR)..br.ft CW.nf% cd% cd esps/general% install -l  >& log &.fi.ft LR