bininstall.tme

来自「speech signal process tools」· TME 代码 · 共 616 行 · 第 1/2 页

.lo
.ce 2
.b
Installation Instructions for the ESPS Binary Release
.he 'ESPS Binary Installation Instructions''page %'
.sp
Document version: 1.10 9/19/91
.sh 1 "Introduction"
.pp
This document describes how to install the Entropic Signal Processing
System (ESPS) binary distribution.   If you ordered the \fIwaves+\fR
product at the same time as this product, then it will already be
installed into this distribution.
.sh 1 "Floating License System"
.pp
ESPS uses floating license technology, which allows you to install the
actual files at any location on your network you choose.   A license
manager daemon must be run on a particular host on your network, but
ESPS and \fIwaves+\fR can be run on any machine (of the correct
architecture type) on your network, as long as it can connect to the
host with the daemon.
.pp
After you have installed the tape contents as described below, you will
run a program on the host where the license daemon will be run; the
program will return a unique server code.  Call Entropic with this
code and your sales order number (our number assigned to your order)
to request your license key.  For customers outside of North America,
it might be better to request the key via FAX.  Details for getting
your key are given below.
.sh 1 "Tape Contents"
.pp
The enclosed tape is a Unix  \fItar\fR tape with one or more tar files
containing an entire ESPS binary directory tree.  Use the installation
software (see below) to extract the files from the tape.  

The following table shows the size of the various products:
.TS
box, center, tab(;);
c c c c
l l l d.
Machine;Size (MB)
_
Mac II;26
Sun 3 (OS 4.X);40
Sun 3 (OS 3.X);40
Sun 4 (Any Sparc);65
Sun 386i;30
Masscomp (RTU 5.X);42
Masscomp (RTU 4.X);31
Convex;48
DEC DS3100;60
HP300;46
HP800;57
Apollo (68K);47
Stardent (1500/3000);68
IBM RS6000;68
.TE
.pp
If you also ordered the DSP32 support kit, then the tape will
contain one or more directories called
\fIdsp32.sun3_OS3\fR, \fIdsp32.sun3_OS4\fR, \fIdsp32.sun3x\fR, 
or \fIdsp32.sun4\fR 
.sh 1 "Installation"
.sh 2 "Installation Requirements"
.np
A Sun/Sparc workstation
.np
SunOS 4.0.3 or greater
.np
75 megabytes of diskspace (on one filesystem)
.sh 2 "Installation Steps"
.sh 3 "Extract the Installation Software from the tape."

.ip
First you should change  directory  to  /tmp  (or  just
about  anywhere)  and tar in the installation programs.  They will
reside in a directory called install_erl. 
.ip
You will need write permission in this directory, and the directory
which you choose to install ESPS/waves+ into. You may have to be the root
user (see section below.

.sp 2
.nf
             % cd /tmp
             % tar xvf /dev/rst8
             install_erl/
             install_erl/RUNME
             install_erl/chkdefs
             install_erl/chkhost
             install_erl/erl_admin
             install_erl/sf
             install_erl/install_erl
             install_erl/erldefs
             install_erl/rextract
             install_erl/tc_inst_keys
             install_erl/tc_install
.nf
.sh 3 "Run the Installation Script"
.ip
Then you should cd into /tmp/install_erl  (or  wherever you put it)
and type  RUNME. 
.sp 2
.nf
          %cd /tmp/install_erl
          %RUNME
.fi
.ip
RUNME is the installation shell script.  It will pop up
an  installation form, that you can fill out.  You move
about the form with the tab , return, and  arrow  keys.
Certain  fields  are  options  that you toggle with the
spacebar. Hitting Control-C will  abort  the  installation. 
Hit Control-X to execute the installation.  The fields
on the form are explained on the following page of these instructions. For
help on moving about the form hit Control-D.
.ip
If the termcap tool won't work for you (it has been tested but
could be susceptible to stty settings that differ from our site), then
use the command:
.nf

       %RUNME ask

.fi
.ip
This runs a version of the install that prompts you for the installation
settings and then proceeds with the installation as 
normal. The installation settings are stored in the file erldefs, which is a
Unix shell script (/bin/sh).  The following section describes the fields in the
installation form, they match the variables you can set in the using the 
editor.  The preferred installation method is using the form.
.sh 3 "Installation Form Field Definitions"
.nr $p 0
.np 
Destination
.ip
where would you like to put  the  ESPS/waves+  binaries
and support files.  You should have enough space on the
disk. The directory will be created for you and overwriting an
existing directory not allowed.
.np
Create link
.ip
this is a toggle field that asks if you want to  create
a  link  from  /usr/esps  to the destination directory.
The default is NO, and we DISCOURAGE setting it to yes.
.ip
Another advantage of not creating this link is that without it
it is possible to leave an old version of ESPS in place and operating.
.np
Old Installation
.ip
Enter the location of your  old  ESPS/waves+  installation. If you
don't have one, make it empty (the default is /usr/esps). 
.np
Tape Device
.ip
the tape device.  On BSD Unix it might be /dev/rst8. On IBM AIX it
might be /dev/rmt0.1.  This must be given.
.np
Non rewinding Tape device
.ip
the device name for the tape device that doesn't rewind.  On BSD Unix
it might be something like /dev/nrst8. On IBM AIX it might be /dev/rmt0.1.
This must be given.
.np
Tape Host
.ip
the hostname of the workstation with  the  tape  drive.
Leave  empty  if  the  tape drive is on the workstation
that you are logged into.

.np
Log Installation
.ip
a toggle field that allows you to  log
the installation to stdout, a Unix file or both.  It is
handy to log it to both.
.np
 Log file
.ip
the name of the logfile (if both or file is selected in
the log installation field).
.nr $p 0

.sh 1 "What you will need to start running ESPS/waves+"
.np
$ESPS_BASE/bin will have to be on your path (ahead of any older versions
of ESPS/waves+  that you have installed.  See below
for an explanation of ESPS_BASE.  You can verify the path by using the
command "which testsd", which should find ESPS program testsd in $ESPS_BASE/bin.
.sp 2
.nf
          example: setenv PATH $ESPS_BASE/bin:$PATH
		   rehash
		   which testsd
.fi
.sp 2
.np
The Sun shared XView libraries  must  be  on  the  path
specified by LD_LIBRARY_PATH (see below).
.np
Remove or rename \fB.wave_pro\f files in your user's home directories.
Old \fB.wave_pro\f files will not use some of the new features.  The
best approach for most users is to use the \fB.wave_pro\f in
$ESPS_BASE/lib/waves .  If you need to customize your environment, copy the
 \fB.wave_pro\f in $ESPS_BASE/lib to your home directory and edit as needed.
.np
Start the licence manager, checkout a license, and run the demos.
How to get and use a license are described in the next section and
in Entropic Technical note "Living with the ESPS/waves+ License Manager".


.sh 1 "Getting Your Key"
.pp
In order to get a license key you must run \fIelmadmin -c\fR to generate a
server code and to store your key.   Run \fIelmadmin\fR on the host that
you will be running the license manager daemon on.   The key will only
work if the daemon is run on the same host that the key was generated
for.   Two pieces of information are required for us to assign you your
key(s): (1) your server code from \fIelmadmin -c\fR and (2) the
sales order number (from a sticker on the media).   An Entropic Key Request
form should accompany your shipment.  Using the form will make getting keys
easier and less error prone.
.pp
You can get your keys either by voice telehone or by FAX.   Keep the
fact that we are located in the Eastern US time zone in mind when trying
to call.   For customers outside of North America it might be best to
FAX your request for your key (keys) to us at 202 546-6648.  We'll FAX
the keys right back along with instructions for installing the key.   
To avoid errors in the server code, it would be
best to send the actual output of the \fIelmadmin -c\fR command if
possible (see the Unix \fIscript\fR command).
.pp
If you want to get your keys via voice telephone
it would be best if you can call us while you are at a terminal.  That
way we can give you the keys, wait while you enter them and be sure that
everything is working correctly.   If that is not possible then you will
have to carefully write down the server code that \fIelmadmin -c\fR
produces.  
.pp
If you can call when sitting at a terminal, 
then do so when you are ready.   Call
Entropic at  202 547-1420, and tell the person that answers that you are
calling for a "license key".   If possible, you will be given to
someone who can help you.  If that person is not available, then your
number will be taken and we will call you back.
.pp
If you cannot call from a terminal, run the following command, write
down the server code and then kill the command when it asks for the key.
When you copy the server code, watch out for the letter l vs the digit
1, etc.  Run the following command:
.nf
.ft CW
% elmadmin -c
Your server code is:   XXX   <- record this code
Please enter your key: <control>C    <- kill the program now
.ft R
.fi
.pp
Call Entropic at the above number and request a license key.  
We will need that server code and your sales order number to give you a key.
.pp
After you get your keys
you will use \fIelmadmin\fR to store them.  The command is:
.nf
.ft CW
% elmadmin -c
Your server code is:   XXX   <- this should be the same as earlier
Please enter your key: XXX   <- enter the first key given to you
\fI<some information will be printed about the key>
.ft CW
% elmadmin -c
Your server code is:   XXX   <- this should be the same as earlier
Please enter your key: XXX   <- enter the second key given to you
\fI<some information will be printed about the key>
.ft R
.fi
.sh 1 "Starting the License Manager"
.pp
Before you can run \fIwaves+\fR or any of the ESPS programs,
you must start the license manager daemon and allow it time to
initialize.    To start the daemon, simply type the command:
.nf
.ft CW
% elmd
.ft R
.fi
.pp
This will spawn a background process and exit.   If you prefer, you can
put this command into your
\fI/etc/rc.local\fR, so that it will be executed 
each time your machine boots.  (If you do this, you will have to give the
full path as \fI$ESPS_BASE/bin/elmd\fR).  
.pp
After you start the license manager daemon, you have to wait about four
minutes before it will respond to a request for a license.   You can verify
that elmd is running by running \fBecheckout(ESPS-1)\f .  It will tell you
that elmd is initializing and how long it will be until a key can be checked
out.
.pp
The license manager daemon makes entries in the file
\fI$ESPS_BASE/lib/elm.log\fR.    If you have trouble getting our programs
to work correctly, we may ask you to look in this file and tell us what
is in there.   This file will grow by a line each time a license is
checked in and out.    If you want, you can zero the file with the
command: