--- tinyMOODS v0.99.1 ---

0. SOFWARE REQUIREMENTS

  a. LINUX RedHat 4.2/5.x (tested with 4.2 and 5.1)
  b. pvm 3.3.x (tested with pvm-3.3.11-2.i386.rpm package)
  
1. HOW TO INSTALL tinyMoods

  bash shell is assumed as default.
  
  a. execute where you want to install package:
       tar xzvpf tinyMoods.tar.gz
  b. edit your .bashrc or .bash_profile and add the following lines:

--- CUT HERE ---

# Sets the MOODS root with directory created in your home (tinymoods in example) 
export MOODS_ROOT=<where_tinyMOODS_is> (ex. /home/pippo/tinyMOODS)

# Sets the PVM root and settings
export PVM_ROOT=/home/pvm/pvm3
export PVM_EXPORT=DISPLAY

# Adds PVM and Moods in the PATH
export PATH=$PATH:$PVM_ROOT/lib:$MOODS_ROOT/bin:$MOODS_ROOT/scripts:.

# Sets the enviornment for tinyMOODS
source $MOODS_ROOT/scripts/.moodsrc

--- CUT HERE ---

note: If the file .moodsrc is changed use "source .moodsrc" or ". .moodsrc"
  from the shell to set the new settings.

The .moodsrc file is the following:
----------------------------------------------------------------
#
# file: .moodsrc
#

# MOODS settings:
export LIOO_ERR_DIR=$MOODS_ROOT/errmsg/
export LIOO_LOG_DIR=$MOODS_ROOT/log/
export LIOO_MDS_DIR=$MOODS_ROOT/MDS/
export LIOO_FONT_DIR=$MOODS_ROOT/font/

----------------------------------------------------------------
Where:
 - LIOO_ERR_DIR is the directory where are the .err files.
 - LIOO_LOG_DIR is the directory where the log of errors received from the
   DLIOOs are put.
 - LIOO_MDS_DIR is the directory where are the music files.
 - LIOO_FONT_DIR is the directory where are the music/text fonts.

 
2. HOW TO RUN tinyMoods

a. Set names of worksations where tinyMOODS has to run. 
If you want to run MASE session type: 

  . cfg.tiny.mase <hostname> [displaysize] 
        (ex. . cfg.tiny.mase masehost.dsi.unifi.it)

where displaysize is the optional dimension of MASE display 
in the form <width>x<height> (ex. 800x600).
To run also a DLIOO session use the following command line:

  . cfg.tiny.dlioo <hostname> [parte] [displaysize] 
        (ex. . cfg.tiny.dlioo dlioo.dsi.unifi.it Vln.II)
	
where parte is the name of the score used by the single musician.
Finally configure PVM with command:

  . cfg.tiny

No arguments are required.
To remove from the configuration the MASE or DLIOO use the following commands:

  . cfg.tiny.mase none
  	  to remove MASE

  . cfg.tiny.dlioo none
      to remove DLIOO

Default settings are: 
  - a MASAE
  - no MASE
  - no DLIOO

WARNING: Please note the use of the dot command before name of the script.
It is required because otherwise the settings will not have effects.

b. Run the program typing:

  "go" or "tinyMoods"

  go is a script that shows the current configuration and then runs tinyMoods.

3. FAQ:

  Q:  One of the hosts is not running X when moods is started, the program hungs when
      tries to start tinyMoods on the host.

  A:  Run pvm on a shell and type reset on the pvm console and then quit to terminate 
      the program.
      Start X on the hosts and retry :-)


  Q:  tinyMoods stops with error "host is not in VirtualMachine".

  A:  There is a problem in PVM startup.
      Try to add manually the host from the pvm console typing
      "add <hostname>" if it says "cannot start pvmd":
      CHECK:
        1. if you have .rhosts in your home with the names of the hosts you
           want to use followed by the name of your account.
        2. if the permissions of .rhosts are -rw-r--r-- if not, set it.
        3. rlogin to the host, check if there is in /tmp a file pvmd.<your UID> 
           if so delete it, check if there is a pvmd3 process running if so 
           kill it.

  Q:  tinyMoods stops with error "executable file not found".

  A:
      1. run export CFG_DEBUG=1
      2. run cfg.tiny with the failing configuration.
      3. type pvmstart.tmp created by cfg.tiny in the current dir
      4. chech if the pathnames in ep= or wd= are correct and if in this directory
         there is the executable tinyMoods.

  Q:  All windows appear on MASAE display.

  A:  Execute tinyMoods setting the DISPLAY to :0 to avoid to have all the windows of
      Moods on the same machine if the DISPLAY is set.


4. ADDITIONAL NOTES

Here it is a brief list of environment variables used by tinyMOODS to set the 
configuration.

  TINYMOODS_MASE_HOSTNAME (without MASE if not defined)
  TINYMOODS_MASE_DISPLAY (default 1024x768)
  TINYMOODS_DLIOO_HOSTNAME (without DLIOO if not defined)
  TINYMOODS_DLIOO_DISPLAY (default 800x600)
  TINYMOODS_DLIOO_PARTE (default Vln.I)
