
	$Id: README,v 1.3 2000/07/02 14:29:39 yamauchi Exp $
    R^2mark : A practical benchmark suite for C++ and Java 
	      parallel processing 

	Copyright (C) 2000 YAMAUCHI Hitoshi  

This directory contains script files for running R^2mark for C++ and
Java. First, you must build R^2mark executable, that is 

	C++  version : 
		parallel : `mpi2' under R2mark-1.0/C++/mpi/
		serial   : `mpi21PE' under R2mark-1.0/C++/1PE/

	Java version : PACKAGE=jp/ac/tohoku/is/archi
		parallel : `Mpi2MPI' under R2mark-1.0/Java/${PACKAGE}/host
		serial   : `Mpi21PE' under R2mark-1.0/Java/${PACKAGE}/host

Quick Start :
	
	If you want to run the parallel version, just type, 
		cd paralell; ./run_benchmarks.sh
	
	or the serial version, just type, 
		cd serial; ./run_benchmarks.sh

	These scripts run the all benchmarks. 
	(However, this will take a very long time.)
	Results are stored in each script directory as belows.

Directory Structure : 

    ----+ parallel ----+ C++  ---+---- conf
        |              |         +---- office
        |              |         +---- soda
        |              |
        |              + Java ---+---- conf
        |                        +---- office
        |                        +---- soda
        + serial   ----+ C++ 
                       |
                       + Java

If you want to run the C++ version and you want to run it with conf
data set, 

	(now you are the directory which has this README.)
	cd parallel;
	make copyexec;		   # copy the benchmark executable to here.
	cd C++/conf;		   # goto script directory
	ln -s ../proc_r2mark.sh .  # 
	./proc_r2mark.sh conf test # run the benchmark
				   # (test, inaccurate, or accurate)

I want to change these scripts more easy way at next release.

----- NOTICE -----

Java version sometimes fail because of OutOfMemoryError.  Please take
care the log.* files.

In this case you must change max heap size in the file

    R2mark-1.0/benchscript/parallel/Java/*/proc_r2mark.sh (parallel)
    R2mark-1.0/benchscript/serial/Java/proc_r2mark.sh 	  (serial).

There is a line `#----- expand maximum heap size', and you can change
near this line. Sorry such a inconvenient way...
