A.3  Installation for Ptiny Ptolemy

Ptolemy is a large software system that relies on a properly
configured software environment. There are a few things that can go
wrong in getting Ptolemy running. There is some minimal
configuration required by each user in order to use the graphical
interface. The information for doing this is given in "Setup" on
page 3-1. Here we give the basic information required to get from an
FTP archive or distribution tape to being able to run the system.

Note that this information may change after this manual is
printed. Thus, the most up-to-date instructions are included in
ASCII form with the distribution.


A.3.1  Basic Ptolemy installation

Note, in order to install Ptiny Ptolemy you will need 12 
Megabytes of disk space.

First change directories to the place you will put Ptolemy. If you
have the tar files from the FTP site, move them to this
directory. If you have Ptolemy on tape, do the following commands
(change the device name if your tape drive has a different name):
   
   a. mt -f /dev/nrst8 rewind
   
   b. tar xf /dev/nrst8

Now, there should be two tar files in your current directory.  The
Ptiny Ptolemy tar file was compressed with gzip. Thus, you will need
the program gzcat to uncompress it. If you do not have gzcat on your
system, don't worry. We have provided a gzcat binary with the Ptiny
Ptolemy distribution. Do the following:
   
   a. zcat gzcat.ARCH.tar.Z | tar xf -

Where ARCH is sun4 if you have Sun Sparc machine, mips if you have a
DEC Station, and hppa if you have an HP precision architecture
machine.  

Now that you have gzcat, you can use it to untar Ptiny Ptolemy:

   b. If you are running the DEC Station (MIPS) version of Ptolemy:
      gzcat ptiny0.5.mips.tar.gz | tar xf -
      
      If you are running the Sun 4 (Sparc, IPC, IPX, etc.) version:
      gzcat ptiny0.5.sun4.tar.gz | tar xf -

      If you are running the HP Precision Architecture (HP PA) version:
      gzcat ptiny0.5.hppa.tar.gz | tar xf -

Note that is possible to install binaries for multiple platforms on
the same file system because different directories are used for each
set of binaries. Just execute whichever of the above commands apply.


A.3.2  Special considerations for use under Open Windows

Ptolemy was developed using the X11R4 or X11R5 distributions from
MIT. Although Ptolemy runs fine under Open Windows 2, there are
problems with running the Ptolemy graphical interface with Open
Windows version 3.0. Some users have had no problems at all, but
others have had intermittent problems such as "bad match" errors. We
believe this may be a problem with the X-server supplied with the
Open Windows 3.0, but the error is elusive and we have not yet
tracked it down.

In order for all utilities included with this distribution to work
under Open Windows (either version), you must install the shared
libraries for the Athena widgets (the freely redistributable widget
set from the MIT X11 distribution), which are provided with this
distribution under the ptiny/athena.sun4 directory. To install them,
become root and copy all files in that directory into
/usr/openwin/lib (or, if you have installed Open Windows in a
non-standard place, into $OPENWINHOME/lib). If you do not wish to do
this, you could leave them in place and have every Ptolemy user
change their LD_LIBRARY_PATH environment variable to search the
ptiny/athena.sun4 directory before /usr/openwin/lib. Consult the
Unix manual entry for the ld program to learn more about
LD_LIBRARY_PATH.

After installation, the ptolemy account will contain several scripts
for starting up X11R5 (Xrun), Open Windows with olwm (Xrun.ow), or
Open Windows with twm (Xrun.ow.twm).

Some users have reported problems with running xedit under Open
Windows after setting their LD_LIBRARY_PATH. One workaround is to
set the PT_DISPLAY environment variable to use an editor other than
xedit, such as vi.


A.3.3  Testing the Installation

After starting up X or openwin, do the following:

  a.  setenv PTOLEMY your_new_ptiny_dir 
      where your_new_ptiny_dir is the new ptiny directory that you 
      created when you untarred Ptiny Ptolemy.

  b.  cd $PTOLEMY

  c.  set path = ($PTOLEMY/bin $path)

  d.  cd demo

  e.  pigi

Follow instructions in "Starting Ptolemy" on page 3-2.  The dot
files (.cshrc, .login etc. ) in the home directory are set up
according to the tastes of the Ptolemy authors, and according the
standard use of windowing software in the Ptolemy development
group. You may want to use these files as guide as you customize
your own installation.