Rebecca V2.0 User's Guide

Rebeccca v2.0 is a sophisticated multiuser testing environment written in Java.  It is based on the methodology and architecture presented in my dissertation "A Testing Methodology and Architecture for Computer Supported Cooperative Work Software."

Installation

Rebecca requires the following:

Quick User's Guide

1) Install jre jre-1.2.2_008 from java.sun.com

2) Set your path variable to grab this java executable first:

set path=c:\program files\javasoft\jre\1.2\bin;%path%

3) Install rebecca.jar in some directory
(e.g. c:\research\rebeccaj)

4) cd to the rebecca.jar directory use jar -xvf to extract the two files Rebecca.properties and SessionManager.properties to the same directory as the rebecca.jar file:

jar -xvf rebecca.jar Rebecca.properties SessionManager.properties

5) Set your classpath, include one entry for the directory where the .properties files are located
and one entry for the rebecca.jar file:

set classpath=c:\program files\javasoft\jre\1.2\lib\classes.zip; c:\research\rebeccaj\rebecca.jar;c:\research\rebeccaj;

6) Run rmiregistry

(e.g. rmiregistry)

7)Run dugan.remote.sesssion.SessionManager:

(e.g. java dugan.remote.session.SessionManager)

8) Run the rebecca server:

(e.g. java rebecca.server.Rebecca)

9) Run two of the following sample programs (AgentTester, SliderTest, WidgetTester):

java rebecca.examples.AgentTester
java rebecca.examples.WidgetTester

10) In the "Rebecca: Trigger Manager" window, click Add to add a new trigger.

11) Select an Agent listener, the drop down list should give you two choices: (e.g. rebecca.agent.RebeccaAgentImpl0)

12) Select a triggering event (e.g. mouse clicked on JButton1 of AgentTester).

13) Select an Agent player, the drop down list should give you two choices (e.g. rebecca.agent.RebeccaAgentImpl1)

14) Click on the recorder and record some user activity (e.g. press JButton1 in the WidgetTester, then clear the pop up dialog by selecting OK)

15) Fire the trigger (e.g. click on JButton1 in AgentTester to cause the trigger to fire)

16) If you want to run RebeccaJ on one machine and your CSCW application on another then goto
the machine running the CSCW application and:

17) For more details on how to use RebeccaJ with your own CSCW application, read Chapters 6 and 7 of my thesis.

Distribution

Rebbecca may be copied and distributed freely as long as credit is given to the author and no profit is made from the distribution.

Feedback

This software was funded in part by a grant National Science Foundation under awards CDA-9634485 and CCR-9527151.

As long as it doesn't interfere with my thesis work too much, I'll try my best to fix serious bugs and incorporate suggestions into later releases of Rebecca.  I welcome your comments and suggestions.  Send email to: dugan@cs.rpi.edu 

Known Problems