The RUBBoS bulletin board benchmark was originally developed by the JMOB project. The homepage of the original implementation can be found here. While the benchmark is well-implemented, no updates have been made since 2005. This has caused some incompatibilities with newer versions of the software which RUBBoS depends on. This repository provides some updates to resolve these incompatibilities. For any questions, contact Michael Mior at michael.mior@gmail.com.
Only the PHP version of this benchmark is being maintained in this codebase.
To install, simply copy the PHP directory somewhere into the path of an Apache web server with PHP support.
The absolute path of this directory should be specified as php_html_path and php_script_path in any rubbos.properties files used to run the benchmark.
Finally, copy config.example.php to config.php and add in your database connection information.
To build the client emulator, change into the Client directory and run make. This will create rubbos_client.jar which will be used to run the benchmark.
The PHP version of the benchmark requires the MySQL database server (or some server which speaks MySQL). No specific MySQL features are used, so any version of MySQL should suffice. To create the database schema, execute database/rubbos.sql. To load the initial data for the benchmark, data files must be downloaded from the JMOB website. Then, database/load.sql in this repository must be updated with the path to these files, then executed to complete the loading.
First, complete the installation procedure to set up the web application and compile the client software. The initial database must then be loaded.
A rubbos.properties file must now be prepared with all parameters required to run the benchmark. Samples are given in the bench subdirectory. The most important configuration options are the hostnames of the database and web servers and the remote client nodes. workload_remote_client_command should be updated with the version of Java which should be used. You may find that connection to remote clients may only work with monitoring_rsh will only work with /usr/bin/ssh.
Each remote client will require installations of Java and sysstat. These machines will also require a copy of the client emulator. The easiest method is to simply copy the entire repository onto each machine. A script such as the one below should suffice. Each remote client will need to allow the host running the benchmark access without password.
#!/bin/bash
# Add all remote client nodes as array elements below
hosts=()
for host in ${hosts[@]}; do
ssh $host rm -rf RUBBoS
scp -rq RUBBoS $host:
done
To produce graphs of the data, the main client will require gnuplot. The simplest way to change the amount of load generated is to change the number of remote clients as well as workload_number_of_clients_per_node. Finally, workload_user_transition_table and workload_author_transition_table can be set to the defaults found in the workload subdirectory.
To execute the benchmark, change into the repository directory and run make emulator. Extensive HTML output will be generated in a subfolder of bench.
The RUBBoS benchmark is licensed under the LGPL.