WebWinds is a scientific visualization and analysis package, written
as a Java application, which is designed to be an easy to use, multi-disciplinary
tool. This version has both client and server
capabilities.
This page addresses the following topics for users of platforms other than Unix, Linux, Macintosh and Windows:
Unix, Linux and Macintosh users should read their own page, and Windows users should read their own page.
Operating Environment
For all platforms, we recommend a processor speed of at least 200 MHz and at least 128 Mb of memory. With these minimum requirements you will be limited in the size of data sets that you can examine and the response times will be slow. The package requires about 25 Mb of disk space including documentation.
WebWinds has been designed around the Java 1.2 or 1.3 API and may not run with version 1.1 of the Virtual Machine (VM).
In order to use the 3D displays, you must have OpenGL version 1.1 or later on your machine. In some cases, these installations must be done by someone with root privileges. In addition, you will need a compiled version of our C library containing Java wrappers to OpenGL.
Documentation
Documentation is built into WebWinds in the form of a context sensitive
html help system. You can also browse the documentation using the online
version.
Installation
Installation requires acquisition of the Java Development Kit (JDK). Contact
us or your operating system vendor for more details. After installing the
JDK, the user must obtain WebWinds software from the WebWinds
download
page. The choices are: WebWinds client software, WebWinds server
software and sample data. Documentation is now included in the software
packages and is not accessible except within WebWinds and via the Web.
The user must create scripts for either the client (wwclient) or server
(wwserver), depending on which package has been downloaded. Contact us
for more details.
OS/2
Several users have reported some success using OS/2 Warp 4 with either
Fixpack 6 or 7 and the JDK from IBM. There may be some Java Virtual Machine
problems using the 08.01.1999 version of the JDK.
The installation requires acquisition of the Java Development Kit (JDK).
WebWinds software, documentation and data are downloaded separately from
the WebWinds page, after filling out the license agreement. The JDK is
downloaded from IBM.
The installation process will produce scripts for either the client
(wwclient) or server (wwserver), depending on which package has been downloaded.
Here is a summary of the installation process:
Summary:
- Delete any previous installed version of Java and WebWinds, keeping only text files which you have modified.
- Download and install Java and WebWinds.
- Configure Java and WebWinds for your environment.
Detailed instructions:
- If you have previously installed WebWinds, or Java,
it is wise (but not necessary) to delete the old files. This can be done
by deleting the earlier JDK directories as well as the directories (and
all directories contained in them) in your old WebWinds directory. Be sure
to modify and save any text files that you altered in the WebWinds directory.
Be sure to read the discussion of the
datamanager.txt
and config.sys files if you have an old
version of WebWinds and would like to preserve its configuration.
Other files that you may want to save and modify include paths.txt, dataobject.txt,
overlays.txt
and config.txt.
-
- If you already have the latest version of the JDK, skip to step b. Otherwise, install install version 1.3 of the JDK from IBM. Make a note of where you install the JDK directory. You can download the JDK documentation if you wish but it is not required.
- Create a directory (e.g. e:\webwinds on drive e: ) for the WebWinds
application. In order for WebWinds to execute properly, the directory
must be called 'WebWinds' (case insensitive). Download the file WWclient.jar
or WWserver.jar file to this directory. Do the same for the data file,
WWdat.jar. Next, you can run the following commands:
e:
cd \webwinds
d:\jdk1.3\bin\jar -xvf WWclient.jar (or WWserver.jar for the server)
d:\jdk1.3\bin\jar -xvf WWdat.jar
This command list assumes that your WebWinds directory is on disk drive
e: and is called webwinds. It also assumes that you have installed the
JDK at d:\jdk1.3. Change these locations to fit your own situation.
-
- First you must let WebWinds know where to find things like your
data files. See the discussion of the 'paths.txt'
file.
- Create a script command file (wwclient.cmd) with the following in
your webwinds (root) directory:
e:
cd \webwinds
PATH=d:\jdk1.3\bin;e:\webwinds\lib
SET JFILE=e:\webwinds\jar\pSlang.jar
java -cp %JFILE% -Djava.security.policy=java.policy -mx256m -jar %JFILE% ww.slang %1 %2
If you would prefer to use the Java Runtime Environment (JRE) your command
file would look the same except java -cp
would be replaced by
jre -cp
Similarly, a server script command file (wwserver.cmd)
would contain:
e:
cd \webwinds
PATH=d:\jdk1.3\bin;e:\webwinds\
SET JFILE=e:\webwinds\jar\pSlang.jar
java -cp %JFILE% -Djava.security.policy=java.policy -mx256m -jar %JFILE% wwserver.slang %1 %2
Again, this command file assumes that your root webwinds directory
is specified as e:\webwinds and that your root JDK directory is found at
d:\jdk1.3. Change the file to reflect your situation.
- Finally, be sure to move any .txt files from earlier releases into
your webwinds directory.
Executing WebWinds
OS/2
To run WebWinds, run the appropriate command file.