Installing binary distribution of GRADE
       ---------------------------------------


1. Create the directory where you want to install GRADE, e.g.

   mkdir /usr/local/GRADE

2. Change to that directory, e.g.

   cd /usr/local/GRADE 

3. Unzip and untar the GRADE (binary) package, e.g.

   gzip -cd ~/grade-5.32.18-Irix5.3.tar.gz | tar xvf -

   (supposing  that you are to install GRADE v. 5.32.18 on SGI Irix
    5.3 machine and the zipped tar file is located in your HOME directory.)

4. In the 'grade' script edit the value of 'GRADE_ROOT' variable
   which must be the actual installation directory with full pathname, e.g.

   vi ./grade

5. Copy the architecture dependent 'attacher' program to a directory 
   where PVM can find it to start, e.g.
    
   cp ./bin/SGI5/attacher ~/pvm3/bin/SGI5/

6. The PATH variable defined in the architecture dependent 'deb'
   (e.g. bin/SGI5/deb ) script must contain the directory where 
   'gdb' (GNU debugger) is located.  

7. Modify our sample 'pvmhosts' file that is an ordinary PVM
   hostfile, in order to 
   -  include all hosts you plan to use in your virtual machine
   -  specify where the PVM daemon is located ( 'dx' option) and the 
      full access path of the architecture dependent debugger script 
      in the 'bx' option, e.g.

      * dx=/usr/local/PVM3/lib/pvmd bx=/usr/local/GRADE/bin/SGI5/deb

8. On every host involved in your PVM make the
   installation directory of GRADE accessible (via NFS). Alternativly,
   you can install GRADE binaries on each host.  The full pathname 
   of the installation directory must be the same on all hosts.
  
9. Repeat steps 5-6 on every host involved in your virtual machine.

10. For each host  involved in your PVM, create a text file in the 'bin' 
    sub-directory of GRADE installation directory. The name of the
    file must be the name of the particular host followed by the
    '.arch' extension, e.g. if you have the host 'piglet' then
    you must have the file 'piglet.arch' in the 'bin' sub-directory.
    Each file must contain the actual value of the PVM_ARCH variable
    on the coresponding host, e.g. 'SGI5' in case of an SGI Irix 5.3 
    machine. 
 
11. If you would like to use PROVE (the visualisation tool of GRADE),
    the Tape/PVM monitor software must be installed on each host of
    your virtual machine. Source code of Tape/PVM can be downloaded
    via anonymous ftp from the same directory where GRADE binaries are
    located ('tape.tar.gz'). After installing it, be sure that directory 
    in which Tape prepocessor scripts are located (e.g. 'tapepp') is 
    included in your PATH environment variable. 

12. Download also the file 'BUGS' that contain a list of known bugs
    in GRADE. Please report any other problems with the software to
    <dozsa@sztaki.hu> or <rlovas@sztaki.hu>. I also recommend you
    to visit our WWW pages about GRADE where you can find example 
    programs and the User's Manual of the system. The URL is:
    http://www.lpds.sztaki.hu/projects/grade