RUBiS - Installation and Configuration

Installation and Configuration

RUBiS Files Structure

The directory tree of RUBiS is organized as follow:

`/RUBiS`	This directory contains the main Makefile/build.xml file and the license agreement.
`/RUBiS/config.mk`	Makefile configuration file (if you use make you should edit this file to match your configuration)
`/RUBiS/build.properties`	Ant build files configuration file (if you use ant you should edit this file to match your configuration)
`/RUBiS/bench`	contains the results of the measurements and the scripts to generate graphs and statistics.
`/RUBiS/Client`	Benchmark client to simulate clients and perform measurements.
`/RUBiS/database`	contains the SQL files among with the lists of regions and categories used to generate the database data.
`/RUBiS/EJB_HTML`	contains the html files for the version of RUBiS that is designed to be used with EJB only.
`/RUBiS/ejb_rubis_web`	contains the html files for the EJB versions of RUBiS structured in war format. The jar file containing the servlets (generated during compilation) should be place in the WEB_INF/lib directory.
`/RUBiS/EJB_DB_id`	EJB version of RUBiS with entity beans Container Managed Persistence and database generated Primary Keys (works only with JOnAS, JBoss does not support this implementation)
`/RUBiS/EJB_EntityBean_id`	EJB version of RUBiS with entity beans CMP and bean generated Primary Keys (works with JOnAS and JBoss)
`/RUBiS/EJB_EntityBean_id_BMP`	EJB version of RUBiS with entity beans BMP and bean generated Primary Keys (works with JOnAS and JBoss)
`/RUBiS/EJB_Session_facade`	EJB version of RUBiS with façade Session beans and entity beans CMP (works with JOnAS and JBoss)
`/RUBiS/EJB_SessionBean`	EJB version of RUBiS with session beans and Bean Managed Persistence (works with JOnAS and JBoss)
`/RUBiS/EJB_locale_remote`	EJB version of RUBiS with façade Session beans and entity beans CMP1.1 using EJB2.0 local interfaces (works with JOnAS and JBoss)
`/RUBiS/MDB`	EJB version of RUBiS with Message Driven Beans (works with JOnAS and JBoss)
`/RUBiS/EJB_locale_remote_CMP2.0`	EJB version of RUBiS with façade Session beans and entity beans CMP2.0 using local interfaces (works with JBoss)
`/RUBiS/PHP`	contains the html files and PHP scripts for the version of RUBiS that is designed to be used with PHP only.
`/RUBiS/Servlets`	The Java Servlets version of RUBiS that is designed to be used with Java servlets only.
`/RUBiS/Servlet_HTML`	contains the html files for the version of RUBiS that is designed to be used with Java servlets only.
`/RUBiS/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 simulates a user who looks for items and categories but also who can sell or put bids on items.

For each EJB version (DB_id, EntityBean_id, Session_facade or SessionBean) the directory tree is as follow:

`/RUBiS/EJB_VersionName`	contains the Makefile, build.xml file for ant, the mysql and jonas properties files and the scripts to start and stop Tomcat and JOnAS.
`/RUBiS/EJB_VersionName/edu/rice/rubis/beans`	contains the source code of the beans.
`/RUBiS/EJB_VersionName/edu/rice/rubis/beans/servlets`	contains the source code of the servlets used to access the beans.
`/RUBiS/EJB_VersionName/edu/META-INF`	contains the deployment descriptors of the EJB server you are currently using (the files are automatically copied in this directory when using the Makefile to compile).
`/RUBiS/EJB_VersionName/edu/META-INF/JBoss`	contains the deployment descriptors for JBoss: ejb-jar.xml, jboss.xml and jaws.xml or jbosscmp-jdbc.xml.
`/RUBiS/EJB_VersionName/edu/META-INF/JOnAS`	contains the deployment descriptors for JOnAS: ejb-jar.xml and jonas-ejb-jar.xml.
`/RUBiS/EJB_VersionName/doc`	contains the code documentation in the javadoc format.

For the Java Servlets version the directory tree is as follow:

`/RUBiS/Servlets`	contains the Makefile, build.xml file for ant and the scripts to start and stop Tomcat.
`/RUBiS/Servlets/edu/rice/rubis/servets`	contains the source code of the servlets.
`/RUBiS/Servlets/doc`	contains the code documentation in javadoc format.