BINARIES INSTALLATION

JCGrid requires:

  1. Java Runtime 1.4.2 (or better). Available from Sun.

  2. POVRay support requires POVRay 3.6 (or better). Available from POVRay. "povray" commands must be in your execution path. NOTE: POVRay 3.5 under Linux gives a coredump if the env. variable DISPLAY is not defined even if you use the "-D" option.

  3. JCGrid binaries: jcgrid-server.tgz, jcgrid-worker.tgz, jcgrid-client.tgz

  4. Running a worker with the POVRay support under Windows requires a command line version of POVRay. You can use the pvengine.exe included in the official release (default script behaviour) or download Christoph's POV-Ray 3.5 for Cygwin available here (in this case remove the "-v" option from the worker scripts).

NOTE: The current version of JCGrid is developed under Java 1.5.0beta2, POVRay 3.6 and Linux.

UNIX (including Linux and Mac OS X)

Binaries installation steps for the JCGrid Server:

  1. Untar the jcgrid-server.tgz archive in a directory;

  2. Open the povray-server-go.sh shell script with an editor. Set the env. variable JAVA_HOME to the path where you have installed the Java Runtime;

  3. Execute "sh povray-server-go.sh&";

  4. Check if there are errors in the jcgrid-server.log file;

  5. Your server is up and running.

Binaries installation steps for the JCGrid Worker. For each host (note: you can install multiple worker on the same host if you want take advantage of SMP or use the "-c" command line option):

  1. Untar the jcgrid-worker.tgz archive in a directory;

  2. Open the povray-worker-go.sh shell script with an editor. Set the env. variable JAVA_HOME with the path where you have installed the Java Runtime. Set the env. variable JCGRID_SERVER_NAME with the hostname or IP address where is running the JCGrid Server. Set the env. variable JCGRID_WORKER_NAME with a unique name (note: you can not have multiple worker with the same name);

  3. Execute "sh povray-worker-go.sh&";

  4. Check if there are errors in the jcgrid-worker.log file;

  5. Your worker is up and running.

Binaries installation steps for the JCGrid Client:

  1. Untar the jcgrid-client.tgz archive in a directory;

  2. Open the povray-clietn-go.sh shell script with an editor. Set the env. variable JAVA_HOME with the path where you have installed the Java Runtime. Set the env. variable JCGRID_SERVER_NAME with the hostname or IP address where is running the JCGrid Server. Set the env. variable JCGRID_CLIENT_NAME with a unique name (note: you can not have multiple client with the same name);

  3. Execute "sh povray-client-go.sh cornell demos/povray/cornell 320 240 64";

  4. Check if there are errors in the jcgrid-worker.log file and if the jcgrid-output.png image is ok;

  5. Your client is up and running.

  6. If you want to render an animation, you have to execute: "sh povray-client-go.sh spiral demos/povray/anim-spiral 320 240 320 -b 1 -h 64".

WINDOWS

Binaries installation steps for the JCGrid Server:

  1. Untar (WinZIP works fine) the jcgrid-server.tgz archive in a directory;

  2. Open the povray-server-go.bat script with an editor. Set the env. variable JAVA_HOME to the path where you have installed the Java Runtime;

  3. Execute povray-server-go.bat;

  4. Check if there are errors in the jcgrid-server.log file;

  5. Your server is up and running.

Binaries installation steps for the JCGrid Worker. For each host (note: you can install multiple worker on the same host if you want take advantage of SMP or use the "-c" command line option):

  1. Untar the (WinZIP works fine) jcgrid-worker.tgz archive in a directory;

  2. Open the povray-worker-go.bat shell script with an editor. Set the env. variable JAVA_HOME with the path where you have installed the Java Runtime. Set the env. variable JCGRID_SERVER_NAME with the hostname or IP address where is running the JCGrid Server. Set the env. variable JCGRID_WORKER_NAME with a unique name (note: you can not have multiple worker with the same name). Set PATH with the directory where you have installed pvengine.exe (included in POVRay standard Windows distribution) or Christoph's POV-Ray 3.5 for Cygwin executable (in this case remove the "-v" option from the worker scripts);

  3. Execute povray-worker-go.bat;

  4. Check if there are errors in the jcgrid-worker.log file;

  5. Your worker is up and running.

Binaries installation steps for the JCGrid Client:

  1. Untar (WinZIP works fine) the jcgrid-client.tgz archive in a directory;

  2. Open the povray-clietn-go.bat shell script with an editor. Set the env. variable JAVA_HOME with the path where you have installed the Java Runtime. Set the env. variable JCGRID_SERVER_NAME with the hostname or IP address where is running the JCGrid Server. Set the env. variable JCGRID_CLIENT_NAME with a unique name (note: you can not have multiple client with the same name);

  3. Execute povray-client-go-cornell.bat;

  4. Check if there are errors in the jcgrid-worker.log file and if the jcgrid-output.png image is ok;

  5. Your client is up and running.