You are here: myurc.org > tools & prototypes > urcsimenv > Trace URC Simulation Environment - Installation Instructions

Installation Instructions

urcsimenv-applets.zip

1. Extract urcsimenv-applets.zip.  We will assume you are extracting to C:\urcsimenv
2. Download the latest version of the Java Development Kit 1.5 from http://java.sun.com/j2se/1.5.0/download.jsp
3. Copy plugin.jar from the JRE\lib folder into the c:\urcsimenv\bin\applets. This is needed to run the TV target.
4. Download Java Media Framework from http://java.sun.com/products/java-media/jmf/2.1.1/download.html and install. JMF is required to run the TV target.
5. You may run the target/client jar files by opening C:\urcsimenv\bin\applets\index.html in Mozilla Firefox and clicking on the target/client images.

urcsimenv-applications.zip

1. Extract urcsimenv-applications.zip.  We will assume you are extracting to C:\urcsimenv
2. Download the latest version of the Java Development Kit 1.5 from http://java.sun.com/j2se/1.5.0/download.jsp
3. Copy plugin.jar from the JRE\lib folder into the c:\urcsimenv\bin\applications\tv. This is needed to run the TV target.
4. Download Java Media Framework from http://java.sun.com/products/java-media/jmf/2.1.1/download.html and install. JMF is required to run the TV target.
5. You may run each of the targets/clients from the batch file in each directory under C:\urcsimenv\bin\applications.

urcsimenv-src.zip

1. Extract urcsimenv-src.zip.  We will assume you are extracting to C:\urcsimenv
2. Download the latest version of the Java Development Kit 1.5 from http://java.sun.com/j2se/1.5.0/download.jsp
3. Copy plugin.jar from the JRE\lib folder into the c:\urcsimenv\dev\lib\ext\javascript folder. This is needed to run the TV target.
4. Download Java Media Framework from http://java.sun.com/products/java-media/jmf/2.1.1/download.html and install. JMF is required to run the TV target.
5. Javadoc files are included at C:\urcsimenv\doc

Run Java Applications (URCs and Targets)

The simplest way to run the Java applications is to download urcsimenv-applications.zip, go to the bin/applications directory and run the batch files in each of the directories here. Alternatively, you can generate the bin/applications directory from the sources using Ant (as described below). If you modify the source code, two options for rebuilding and running the applications are given below.

To Run with Ant

1. Download and install Ant from http://ant.apache.org
2. Run ant lightswitch_application to build the light switch target as an application. Here is a list of possible ant build targets:
   • alarmclock_applet (builds the alarm clock target as an applet)
   • alarmclock_application (builds the alarm clock target as an application)
   • lightswitch_applet (builds the light switch target as an applet)
   • lightswitch_application (builds the light switch target as an application)
   • swingclient_applet (builds the swing client as an applet)
   • swingclient_application (builds the swing client as an application)
   • textclient_application (builds the text client as an application)
   • tv_applet (builds the TV target as an applet)
   • tv_application (builds the TV target as an application)
   • vcr_applet (builds the VCR target as an applet)
   • vcr_application (builds the VCR target as an application)
   • elevator_application (builds the elevator as an application)
3. Run the batch file in bin/applications/<Target/URC name>

To Run with Eclipse

1. Download and install Eclipse from http://www.eclipse.org/downloads/
2. To create a new project:
   • File > New > Project
   • Select Java Project
   • Select 'Create project from existing source' and load C:\urcsimenv. Click 'Finish''.
   • Select 'Allow output folders for source folders'
   • Change the default output folder to UrcSimEnv/dev/src.
3. Highlight the class ending in 'Launcher' of target or client you would like to run. Go to Run > Run As and select 'Java Application' or 'Java Applet'. The paths of the available targets and clients launcher classes are:
   • dev/src/edu/wisc/trace/targetsamples/alarmclock/AlarmClockLauncher.java
   • dev/src/edu/wisc/trace/targetsamples/lightswitch/LightSwitchLauncher.java
   • dev/src/edu/wisc/trace/targetsamples/tv/TVLauncher.java
   • dev/src/edu/wisc/trace/targetsamples/vcr/VCRLauncher.java
   • dev/src/edu/wisc/trace/urcsamples/swingclient/SwingClientLauncher.java
   • dev/src/edu/wisc/trace/urcsamples/textclient/TextClientLauncher.java

---

Last update: Gottfried Zimmermann, 2006-10-20