JWAVE

Installation

Installing JWAVE Graphic Components Beta Release

• First get the JWAVE Beta SDK zip file

• Unzip this file, which will create a directory called "jwave" which will be populated with directories containing the JWAVE classes, as well as documentation and demonstration applets. If you do not have an unzip utility available, versions for every platform are available on our ftp site

• You will also need a java compiler, such as is provided with various IDE environments like Symantec Cafe or Microsoft Visual J++, or provided from Sun Microsystems with the Java JDK.

• You also need to obtain the Internet Foundation Classes (IFC) from Netscape.

• You can run the JWAVE demos using the PV-WAVE server on our web site (at vrml.boulder.vni.com:9000). You can also create applets of your own which use the supported plot types in the distribution, and still use our server. However is you wish to run PV-WAVE on your own web server, or wish to run PV-WAVE on your own machine for a standalone version, you will need to have an installation of PV-WAVE version 6.05. If you do not have PV-WAVE and would like to demo it, there are two ways to get an evaluation version:

  You can download the PV_WAVE 6.01 release from our ftp site, and then install the 6.05 patch on top of it. You will still have to contact us for a softkey in order to run PV-WAVE.

  Or you could contact us for a CD for version 6.01 and then install the 6.05 patch on top of it. The 6.05 (or the earlier 6.04) version is required because it supports creating GIF files.

• You will need to create a CLASSPATH environment variable to point to the Java JDK, IFC, and JWAVE directories containing Java class files. You also need to include the java compiler and appletviewer in your path environment variable. The installation instructions for the JDK and IFC also explain this in more detail. If you are using an IDE environment instead of the JDK from Sun, follow their instructions. Here are examples of how to do this for the Windows 95/NT and UNIX platforms:

  Windows 95/NT

  Assuming that the Java JDK is installed in C:\Java, and the IFC is installed in C:\ifc10 and JWAVE in C:\jwave, add the following line to your Autoexec.bat file (note that semicolons separate directories):

   
  SET CLASSPATH=C:\java\lib\classes.zip;C:\ifc10\classes;C:\jwave 
  SET PATH=%PATH%;C:\Java\bin 
  

  UNIX

  Assuming that the Java JDK is installed in ~/java, and the IFC is installed in ~/ifc10 and JWAVE in ~/jwave, add the following line to your .cshrc file (note that colons separate directories):

   
  setenv CLASSPATH ~/java/lib/classes.zip:~/ifc10/classes:~/jwave 
  set path = ( $path ~java/bin ) 
  

 
      appletviewer plot.html 
      java plot 

Configuring PV-WAVE Graphic Servers

• Configuring a PV-WAVE based graphic server on a web server machine

  The instructions and scripts below were written for a UNIX machine, see the waveserver.bat file which is similar but for an NT based server.

  You need to copy the entire "waveserver" directory to the machine running the web server, if different than the one you are running on.

  Copy the script called "waveserver" from this directory and place it in the cgi-bin directory for your web server.

  Edit this "waveserver" script and change these lines:

   
  # These three lines are installation dependent: 
  setenv UTILS /usr/local/etc/httpd/htdocs/garage/WaveGraph/waveserver 
  setenv IMAGES /usr/tmp 
  source /export/home1/wave604/wave/bin/wvsetup  
  

  • The UTILS environment variable should point to your waveserver directory.
  • The IMAGES environment variable points to /usr/tmp, and this is the directory that created images are placed. (They are deleted after the applet loads them so will not use a lot of disk space).
  • You must also source the "wvsetup" script (only on UNIX platforms). Edit this path to point to your PV-WAVE installation on the server.

  You can now use this server with the demo JWAVE applets by modifying the HTML files for the applets to point to your server rather than our server at vrml.boulder.vni.com. Just change the "Server" parameter for the <APPLET> tag.

  You could also modify this script to use a PV-WAVE run time license instead of a development license. In this case you do not need the waveserver.com batch file. Email us if you need help with this.

  Note: This CGI based server actually starts a new PV-WAVE process each time you request a plot. We are working on RPC technologies and IIOP/CORBA technologies to allow a persistent graphic server to be run as is done in the local server method below. Stay tuned...

• Configuring a Local PV-WAVE Graphic Server

  You can run a PV-WAVE process on your local machine which will act as a server and use files to communicate with the Java applet or application. In order to set up this local server follow these steps:
  • Edit the file "startserver.bat" (for Windows) or "startserver" (for UNIX) in the waveserver directory and edit these two lines:

     
          cd c:\jwave\waveserver 
          set LocalServer = C:\jwave\waveserver 
    

    Make sure that these paths point to your waveserver directory.
  • Run the "startserver" script, this will start a PV-WAVE process that will run indefinitely and process requests passed to it via a file called tmp.dat in the waveserver directory.
  • You can run the demos locally buy running them as applets, in which case you need to use the HTML files with ".loc", (e.g. plot.loc.html). You may need to edit these files to so that the LocalServer parameter points to where you have the waveserver directory installed. For example to run the "plot" first edit the "LocalServer" parameter in "plot.loc.html" and then enter:

     
          appletviewer plot.loc.html 
    

    You can also run the demos as applications using the "java" command, but in this case since there is no HTML document associated, and because the default server hardcoded into the Java code is our server in Boulder, you will need to edit the source code and recompile each demo. You would change the line:

     
          plot.setServer( "http://vrml.boulder.vni.com.:9000" ); 
    to 
          plot.setLocalServer( "C:\\jwave\\waveserver" ); 
    

    (Note that double backslashes are required in java to represent a backslash in a String. This is not true for forward slashes)

    Then recompile and run the application with commands like these:

     
          javac plot.java 
          java plot 
    

  Note: This local server method currently uses files for communication, but we are intending to replace this with RPC based communications when support for RPC's on Windows platforms becomes available in PV-WAVE. Stay tuned!