Using the GUI to Start the Ray-Tracing Example

Please Note: The GUI provided with this example is not a supported product. It is a tool to assist you in the successful execution of this example by limiting the amount of typing you have to do. This GUI may or may not be included in future releases.

Before Starting

• rmid
  The RMI activation daemon. rmid is required for activatable objects, like the transaction manager.

• rmiregistry
  The RMI registry service. The book buyer clients use the RMI registry to locate one another, and optionally, other services.

• Jini^TM Lookup service
  A Jini registry service. The book buyer clients can use Jini Lookup services to locate a transaction manager and a space.

• Transaction Manager
  A Jini service that manages transactions.

• JavaSpaces^TM service
  An implementation of JavaSpaces technology. You will need the name of the JavaSpaces service that the clients should contact.

For instructions on how to start these services, please refer to:

• Starting Services   To start these services from the command line
  or
• Starting Services GUI    To start these services using a GUI interface

[ Back To Top ]

• For the ray-tracing applet:
  

  /files/jini1_0/example/raytrace/trace.html

• For the worker applet:
  

  /files/jini1_0/example/genericWorker/worker.html

Where /files was the directory into which you extracted the Jini system software and the Outrigger software distributions. In both of the HTML files, replace the value of the host param with the name of the system on which you will run the example. For instance, if your system is named myhost.sun.com, replace value="cocolat.east" with myhost.sun.com.

[ Back To Top ]

Starting the GUI

% java -cp /files/jini1_0/lib/space-examples.jar  com.sun.jini.example.raytrace.StartRayTrace

Where /files was the directory into which you extracted the Jini system software and the Outrigger software distributions. The -cp option to the java command specifies a class path to search for class files. For more information on options to the java command, click here.

[ Back To Top ]

Tabbed Panels in Brief

• Registry Services - This panel allows you to configure the registry port and lookup group(s) you'll use to locate services and clients.

• Data - This panel allows you to specify for the clients: a policy file to use, the path to the necessary jar files, the http server to use, the name of the space to use, and the location of the html files for the ray-tracing example applets.

• Run it All! - This panel allows you to start and stop worker and rendering applets.

[ Back To Top ]

Details on Tabbed Panels

Registry Services Tabbed Panel

• RMI Registry - This button must be selected to use the RMI registry.
  • Registry Port - This field allows you to specify the port that should be used for RMI registry lookup requests. If no port is specified, the value defaults to 1099.

• Lookup Services - This button must be selected to use Jini Lookup services.
  • Lookup Groups - This field allows you to specify one or more lookup groups for the client(s) to join. The default value is "public".

• NONE - This button allows you to deselect RMI registry or Jini Lookup services.

Data Tabbed Panel

• Location of Spaces Policy File - This field must be modified to contain the absolute path to a security policy file.

• RayTrace Jar File - This field must be modified to contain the absolute path to the space-examples.jar file where the example classes exist.

• RayTrace Client Jar File URL - This field must be modified to contain the URL to classes that will be downloaded from the examples to the space.

• JavaSpaces Name - This field must contain the name of the JavaSpaces service that was started from either the command line or the supplied GUI.

• Location of trace.html file - This field must be modified to contain the file URL to the trace.html file.

• Location of worker.html file - This field must be modified to contain the file URL to the worker.html file.

Run It All! Tabbed Panel

• Start Raytrace and Stop Raytrace - These buttons allow you start or stop an applet that generates tasks and renders results.

• Start Worker and Stop Worker - These buttons allow you start or stop a worker applet.
  

[ Back To Top ]

Running the Example

The runnable applets are:

• Raytrace - This applet generates the rendering tasks that are put into the space, and then looks for completed tasks.
• Worker - This applet takes a task posted by the ray-tracing applet, performs the rendering, marks it as complete, and places the task back into the space.

[ Back To Top ]