jdk/test/java/rmi/reliability/README
author xdono
Wed, 02 Jul 2008 12:55:45 -0700
changeset 715 f16baef3a20e
parent 2 90ce3da70b43
permissions -rw-r--r--
6719955: Update copyright year Summary: Update copyright year for files that have been modified in 2008 Reviewed-by: ohair, tbell
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     1
This directory contains the juicer and two benchmark tests.  
90ce3da70b43 Initial load
duke
parents:
diff changeset
     2
Taken together, these tests form the RMI reliability 
90ce3da70b43 Initial load
duke
parents:
diff changeset
     3
suite.  These three tests each function in two modes:
90ce3da70b43 Initial load
duke
parents:
diff changeset
     4
90ce3da70b43 Initial load
duke
parents:
diff changeset
     5
  1) as short running JTREG regression tests
90ce3da70b43 Initial load
duke
parents:
diff changeset
     6
90ce3da70b43 Initial load
duke
parents:
diff changeset
     7
  2) as long running RMI reliability tests
90ce3da70b43 Initial load
duke
parents:
diff changeset
     8
90ce3da70b43 Initial load
duke
parents:
diff changeset
     9
In addition, the two benchmark tests serves a third role:
90ce3da70b43 Initial load
duke
parents:
diff changeset
    10
90ce3da70b43 Initial load
duke
parents:
diff changeset
    11
  3) as RMI and Serialization Performance tests run by
90ce3da70b43 Initial load
duke
parents:
diff changeset
    12
     the Performance Group (http://perfwww.ireland/)
90ce3da70b43 Initial load
duke
parents:
diff changeset
    13
90ce3da70b43 Initial load
duke
parents:
diff changeset
    14
All of the ksh scripts under this directory are used 
90ce3da70b43 Initial load
duke
parents:
diff changeset
    15
to run the RMI reliability suite and are not used
90ce3da70b43 Initial load
duke
parents:
diff changeset
    16
to run the JTREG regression tests.  The one exception
90ce3da70b43 Initial load
duke
parents:
diff changeset
    17
to this is the scripts/create_benchmark_jars.ksh
90ce3da70b43 Initial load
duke
parents:
diff changeset
    18
script which creates the JAR files for the benchmarks
90ce3da70b43 Initial load
duke
parents:
diff changeset
    19
that are transfered to the Performance Group.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    20
90ce3da70b43 Initial load
duke
parents:
diff changeset
    21
------------------------------------------------------
90ce3da70b43 Initial load
duke
parents:
diff changeset
    22
90ce3da70b43 Initial load
duke
parents:
diff changeset
    23
The remainder of this file describes how to run the 
90ce3da70b43 Initial load
duke
parents:
diff changeset
    24
RMI reliability suite:
90ce3da70b43 Initial load
duke
parents:
diff changeset
    25
90ce3da70b43 Initial load
duke
parents:
diff changeset
    26
The launch_reliability.ksh script will build the
90ce3da70b43 Initial load
duke
parents:
diff changeset
    27
reliability suite, execute it, and clean up after itself.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    28
It can be run from any directory with the proper 
90ce3da70b43 Initial load
duke
parents:
diff changeset
    29
command line args. 
90ce3da70b43 Initial load
duke
parents:
diff changeset
    30
90ce3da70b43 Initial load
duke
parents:
diff changeset
    31
For example, to run for 72 hours:
90ce3da70b43 Initial load
duke
parents:
diff changeset
    32
90ce3da70b43 Initial load
duke
parents:
diff changeset
    33
export SUITE_DIR=<path to this directory>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    34
export JDK_DIR=<path to JDK being tested>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    35
export RES_DIR=<path to results dir for this run>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    36
export WORK_DIR=<path to temp working dir for this run>
90ce3da70b43 Initial load
duke
parents:
diff changeset
    37
export VMOPTS="-server -showversion"
90ce3da70b43 Initial load
duke
parents:
diff changeset
    38
90ce3da70b43 Initial load
duke
parents:
diff changeset
    39
rm -rf $RES_DIR $WORK_DIR
90ce3da70b43 Initial load
duke
parents:
diff changeset
    40
mkdir -p $RES_DIR $WORK_DIR
90ce3da70b43 Initial load
duke
parents:
diff changeset
    41
90ce3da70b43 Initial load
duke
parents:
diff changeset
    42
${SUITE_DIR}/launch_reliability.ksh \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    43
        $JDK_DIR \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    44
        $WORK_DIR \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    45
        $RES_DIR \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    46
        ksh \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    47
        $SUITE_DIR \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    48
        72 \
90ce3da70b43 Initial load
duke
parents:
diff changeset
    49
        $VMOPTS >> $RES_DIR/launch_reliability.log 2>&1 &
90ce3da70b43 Initial load
duke
parents:
diff changeset
    50