-----------------------------------------------------------------------------
Distributed Maple
INSTALL file

(c) 1998-2003, RISC-Linz, see file COPYRIGHT
http://www.risc.uni-linz.ac.at/software/distmaple
$Id: INSTALL,v 1.2 2003/03/28 12:44:44 schreine Exp $
-----------------------------------------------------------------------------

0) General
----------
The installation constists of the following steps

1) Install Maple
2) Install Java
3) Install Distributed Maple
4) Setup your working directory

1) Install Maple
----------------
Install Maple V.5 or higher on every machine to be used, see

  http://www.maplesoft.com

The command 

  maple

must work (or an equivalent command by which Maple can be invoked).

2) Install Java
---------------
Install Java 1.3 or higher on every machine to be used, see

  http://www.javasoft.com

The command

  java

must work (or an equivalent command by which Java can be invoked).

3) Install Distributed Maple
----------------------------
Download the Distributed Maple package from

  http://www.risc.uni-linz.ac.at/software/distmaple

uncompress and untar it in a global network directory that can be seen by
every machine (or, alternatively, install a duplicate on every machine that
has not access to the global network directory).

Let DISTMAPLE be the name of this directory, i.e., if you have created 
a directory

  /home/info/www/software/distmaple
    dist.systems
    dist.maple
    dist/*.class
    ...

then DISTMAPLE is "/home/info/www/software/distmaple".

4) Setup your working directory
-------------------------------
Go to the directory from where the parallel computation is to be started.

a) Create a symbolic link to the Distributed Maple installation:

     ln -s DISTMAPLE/dist dist
     ln -s DISTMAPLE/dist.maple dist.maple

   You must see the files "dist/*.class" and "dist.maple". Check whether

     ls dist/*.class
     more dist.maple

   work.

b) Copy "dist.systems" from DISTMAPLE to your working directory

     cp DISTMAPLE/dist.systems .

   and adapt it to your network. For each different type of machine
   create an entry like

     KEY
     rsh
     java -classpath <paths>:DISTMAPLE dist.Scheduler
     maple -q
     `dist/isclient` := true: read `DISTMAPLE/dist.maple`:
     14
     0
     0

  as described in the manual of the Distributed Maple installation:

  - KEY is an arbitrary string by which the kind of machine is identified.

  - "rsh" is a command by which you can start a process on that machine,
    check whether

      rsh <machine-name> ls

    works.

  - "java -classpath <paths>:DISTMAPLE dist.Scheduler" is a command by which 
    the Java program "dist.Scheduler" is started on the machine. You
    have to add in the "-classpath" option the DISTMAPLE directory and
    all other directories on which the Java installation depends.

    Check whether on the denoted machine

      java -classpath <paths>:DISTMAPLE dist.Scheduler

    works and gives an output starting with the line

      options: [-b] [-n] arguments [ <tracefile> ] 
      ...

    If you have different Java or Distributed Maple installations on
    different machines, you have to make for each an entry in "dist.systems"
    with the corresponding settings for <paths> and DISTMAPLE.

  - "maple -q" is the command that invokes Maple in quiet mode.

    Check whether on the denoted machine

      maple -q

    works. This command does not give any output, type
 
      quit;

    to terminate the program.

    If you have different Maple installations on different machines,
    you have to make for each an entry in "dist.systems"
    with the corresponding setting for DISTMAPLE.

  - "`dist/isclient` := true: read `DISTMAPLE/dist.maple`:"

    Insert the appropriate value for DISTMAPLE.

    If you have different Maple installations on different machines,
    you have to make for each an entry in "dist.systems"
    with the corresponding setting for DISTMAPLE.

  - "14": a speed parameter, higher values means faster machine.

    Create one entry for each kind of machine, machines with
    higher numbers will be preferred for execution.

   - "0 0": use this (see the Distributed Maple manual for further info).

-----------------------------------------------------------------------------
$Id: INSTALL,v 1.2 2003/03/28 12:44:44 schreine Exp $
-----------------------------------------------------------------------------