Installing and configuring

Software requirements

For the bulletin bord: For the client:

RUBBoS files structure

The directory tree of RUBBoS is organized as follow:
 
/RUBBoS contains configuration files for mysql (mysql.properties) and RUBiS (rubis.properties) and shell scripts for starting or stoping Jonas and Tomcat. This directoty also contains the makefile.
/RUBBoS/doc contains the RUBBoS documentation.
/RUBBoS/database contains the files with the lists of regions and categories used to generate the database data.
/RUBBoS/PHP contains the html files and PHP scripts for the version of RUBiS that is designed to be used with PHP only.
/RUBBoS/workload contains the files that describes the workload of the bidding system. We designed various patterns of request distribution. The browse_only_transition pattern simulate user's behavior that only generate read requests from the database.
The default_transition pattern is a mix of read and write requests. It simulate a user who looks for items and categories but also who can sell or put bids on items.
/RUBBoS/bench
/RUBBoS/edu/rice/rubbos/client edu.rice.rubis.client package contains the files used in the benchmark to simulate clients and perform measurements.

 

Configuration

Setting up the Makefile for the client

Various environment variables are defined in the makefile. You have to set them to correspond to your installation directories :
JAVA = path to the program execution tool (java)
JAVAC = path to the java compiler (javac or jikes)
RMIC = path to the stub generator (rmic)
CLASSPATH = your classpath including path to j2ee.jar and servlet.jar.
 

Compiling and running

Client emulator
 
make client compile the client
make emulator run the client

API documentation
 
make javadoc  generate the javadoc documentation

Setting up rubbos.properties

This files contains information about the http server : name, port, paths for html pages and scripts for each version of RUBBoS. The version of RUBBoS and the transition table (workload pattern) currently used and are also defined in this file
 

 RUBBoS (C) 2001 - Rice University/INRIA