one.world.rep
Class BenchmarkREP

java.lang.Object
  |
  +--one.world.rep.BenchmarkREP

public final class BenchmarkREP

extends Object

This class performs remote event passing benchmarks. Currently, this class simply dispatches to the appropriate test components in the one.world.rep package.

Two tests can be performed using this class, each requiring two components on different hosts. The latency test consists of the test component itself and an echo server. The throughput test requires a sender and a receiver. Both the latency test component and the throughput receiver allow the number of tests and the number of events sent in each test to be specified.

The various components are run from the one.world shell. For example, to load the event latency test in a new environment named "latency", with the echo server running as "echo" on a machine named "remotehost", with the default number of tests and events per test, type the following in the shell:

mk latency one.world.rep.BenchmarkREP remotehost echo

The command-line arguments for the tests are as follows.

el hostname resourcename [numTests numEvents]

Event Latency. Performs a latency test by timing the total round trip when sending to the echo server at the host and resource name specified. The average and standard deviation of the total time for numEvents round trips are printed when the tests have completed. The number of tests to average over is specified by numTests. See BenchmarkREPLatency for more information.

echo

Echo server for the latency test. Remotely exports itself under its environment name and echos remote events back to the sender. See BenchmarkREPEcho for more information.

ets hostname resourcename

Tuple Throughput as Sender. Measures throughput by sending to a receiver at the specified host and resource name. See BenchmarkREPSender for more information.

etr [numTests numEvents]

Tuple Throughput as Receiver. Exports itself under its environment name and measures throughput by receiving events from a sender started on another machine. The average and standard deviation of the total time for numEvents events to be received are printed when the tests have completed. The number of tests to average over is specified by numTests. See BenchmarkREPReceiver for more information.

Note: Because arguments are dispatched to other classes which can be run independently, error messages may include the aforementioned class names instead of the name of this class.

Version:

$Revision 1.2 $

Constructor Summary

BenchmarkREP()

Method Summary

static void

init(Environment env, Object closure)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BenchmarkREP

public BenchmarkREP()

Method Detail

init

public static void init(Environment env,
                        Object closure)
                 throws Exception